SetData
Description
Sets the raw data for the PBDOM_PROCESSINGINSTRUCTION
object.
Syntax
|
1 |
pbdom_pi_name.SetData(string strData) |
|
Argument |
Description |
|---|---|
|
pbdom_pi_name |
The name of a PBDOM_PROCESSINGINSTRUCTION |
|
strData |
New data for the PBDOM_PROCESSINGINSTRUCTION |
Return value
PBDOM_PROCESSINGINSTRUCTION. The PBDOM_PROCESSINGINSTRUCTION
object modified with the new data.
Throws
EXCEPTION_INVALID_STRING — The input data is invalid. This can
happen in the following circumstances:
-
The input data contains the sub-string “?>”. This violates
the requirements for the data of a processing instruction. -
If the processing instruction target name is xml, making this
PBDOM_PROCESSINGINSTRUCTION object an XML declaration processing
instruction, this exception is thrown if the input data string does
not conform to the following criteria:-
The data must contain a name/value pair for the name
version. -
The data can contain a name/value pair for the name
encoding. -
The data can contain a name/value pair for the name
standalone. If it does, the value for standalone must either be
yes or no. -
The data must not contain any other data in the form of
name/value pairs or in any other form.
-
Lowercase
The strings xml, version, encoding, standalone, yes, and no are
all case sensitive and must be in lowercase.
Examples
Suppose there is a PBDOM_PROCESSINGINSTRUCTION object as
follows:
|
1 |
<?xml-stylesheet href="simple-ie5.xsl" type="text/xsl" ?> |
Then, SetData(“href=new.xsl”) results in the
PBDOM_PROCESSINGINSTRUCTION object being transformed into the
following:
|
1 |
<?xml-stylesheet href=new.xsl" ?> |
The entire data for the PBDOM_PROCESSINGINSTRUCTION object is now
reset.
Usage
Special processing is performed when the name of the processing
instruction’s target is xml, which indicates that it is an XML
declaration. The valid instructions allowed in the input Data as part of
the name in the name/value pairs are version, encoding, and standalone.
The version instruction is mandatory before the processing instruction
can be added to a document.
The XML specification expects the instructions to be in the
specific order version , encoding , standalone. This function reorders
the input data to conform to the specification, for example:
|
1 |
<? xml version="1.0" encoding="utf-8" standalone="yes"?> |