X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;ds=sidebyside;f=pkg%2FTizen.NET.API11%2Fbuild%2Ftizen11.0%2Fref%2FSystem.Xml.ReaderWriter.xml;h=613be0199337ec224683ba97a5e59faa78665214;hb=9584dd2849d1846527f6d076ae3992d7b14e5e8d;hp=4f40ed95f49fc4a591f54f7feeff6de3c2e54110;hpb=46d64418e623f18e2ae0189b44a281cd32024632;p=platform%2Fcore%2Fcsapi%2Ftizenfx.git diff --git a/pkg/Tizen.NET.API11/build/tizen11.0/ref/System.Xml.ReaderWriter.xml b/pkg/Tizen.NET.API11/build/tizen11.0/ref/System.Xml.ReaderWriter.xml index 4f40ed9..613be01 100755 --- a/pkg/Tizen.NET.API11/build/tizen11.0/ref/System.Xml.ReaderWriter.xml +++ b/pkg/Tizen.NET.API11/build/tizen11.0/ref/System.Xml.ReaderWriter.xml @@ -8,9 +8,8 @@ Specifies the amount of input or output checking that and objects perform. - The or object automatically detects whether document-level or fragment-level checking should be performed, and does the appropriate checking. If you're wrapping another or object, the outer object doesn't do any additional conformance checking. Conformance checking is left up to the underlying object. - - See the and properties for details on how the compliance level is determined. + The or object automatically detects whether document-level or fragment-level checking should be performed, and does the appropriate checking. If you're wrapping another or object, the outer object doesn't do any additional conformance checking. Conformance checking is left up to the underlying object. +See the and properties for details on how the compliance level is determined. The XML data complies with the rules for a well-formed XML 1.0 document, as defined by the W3C. This level of checking ensures that the stream being read or written can be consumed by any processor as an XML 1.0 document. @@ -34,15 +33,12 @@ Specifies how the or handle entities. - Expands character entities and returns general entities as nodes. - -You must call to see what the general entities expand to. This enables you to optimize entity handling by only expanding the entity the first time it is used. - + Expands character entities and returns general entities as nodes. +You must call to see what the general entities expand to. This enables you to optimize entity handling by only expanding the entity the first time it is used. When set to , a reader call to the method expands all entities (both general and character entities). Expands all entities and returns the expanded nodes. - nodes are not returned. The entity text is expanded in place of the entity references. @@ -50,7 +46,6 @@ When set to , a reader call to the Causes child elements to be indented according to the and settings. - This option indents element content only; mixed content is not affected. For the XML 1.0 definitions of these terms, see the World Wide Web Consortium (W3C) documentation Element Content and Mixed Content. @@ -125,54 +120,44 @@ This option indents element content only; mixed content is not affected. For the The character array containing the string to add. The zero-based index into the array specifying the first character of the string. The number of characters in the string. - 0 > - - -or- - - >= .Length - - -or- - - >= .Length - - The above conditions do not cause an exception to be thrown if =0. + The atomized string or the existing string if one already exists in the . If is zero, String.Empty is returned. + 0 > +-or- + >= .Length +-or- + >= .Length +The above conditions do not cause an exception to be thrown if =0. < 0. - The atomized string or the existing string if one already exists in the . If is zero, String.Empty is returned. Atomizes the specified string and adds it to the . The string to add. + The atomized string or the existing string if it already exists in the . is . - The atomized string or the existing string if it already exists in the . Gets the atomized string containing the same characters as the specified range of characters in the given array. The character array containing the name to find. The zero-based index into the array specifying the first character of the name. The number of characters in the name. - 0 > - - -or- - - >= .Length - - -or- - - >= .Length - - The above conditions do not cause an exception to be thrown if =0. + The atomized string or if the string has not already been atomized. If is zero, String.Empty is returned. + 0 > +-or- + >= .Length +-or- + >= .Length +The above conditions do not cause an exception to be thrown if =0. < 0. - The atomized string or if the string has not already been atomized. If is zero, String.Empty is returned. Gets the atomized string with the specified value. The name to find. + The atomized string object or if the string has not already been atomized. is . - The atomized string object or if the string has not already been atomized. Specifies how to handle line breaks. @@ -260,11 +245,9 @@ This option indents element content only; mixed content is not affected. For the or is . - or is less than 0. - - -or- - - The length of the minus is less than . + or is less than 0. +-or- +The length of the minus is less than Adds a to the store and maps it to a URI. If the store already contains a mapping for the same URI, the existing mapping is overridden. @@ -280,19 +263,21 @@ This option indents element content only; mixed content is not affected. For the or is . + + Sets the credentials that are used to authenticate the underlying . + The credentials that are used to authenticate the underlying web request. + Maps a URI to an object that contains the actual resource. The URI returned from . The current version of the .NET Framework for Silverlight does not use this parameter when resolving URIs. This parameter is provided for future extensibility purposes. For example, this parameter can be mapped to the xlink:role and used as an implementation-specific argument in other scenarios. The type of object to return. The supports objects and objects for URIs that were added as . If the requested type is not supported by the resolver, an exception will be thrown. Use the method to determine whether a certain is supported by this resolver. + A or object that corresponds to the actual source. is . - Cannot resolve URI passed in . - - -or- - - is not of a supported type. - A or object that corresponds to the actual source. + Cannot resolve URI passed in . +-or- + is not of a supported type. Asynchronously maps a URI to an object that contains the actual resource. @@ -301,6 +286,10 @@ This option indents element content only; mixed content is not affected. For the The type of object to return. The supports objects and objects for URIs that were added as . If the requested type is not supported by the resolver, an exception will be thrown. Use the method to determine whether a certain is supported by this resolver. A or object that corresponds to the actual source. + + Gets a collection of preloaded URIs. + The collection of preloaded URIs. + Removes the data that corresponds to the URI from the . The URI of the data that should be removed from the store. @@ -311,26 +300,18 @@ This option indents element content only; mixed content is not affected. For the Resolves the absolute URI from the base and relative URIs. The base URI used to resolve the relative URI. The URI to resolve. The URI can be absolute or relative. If absolute, this value effectively replaces the value. If relative, it combines with the to make an absolute URI. + The representing the absolute URI or if the relative URI cannot be resolved. is . - The representing the absolute URI or if the relative URI cannot be resolved. Determines whether the resolver supports other s than just . The absolute URI to check. The to return. - - is . if the is supported; otherwise, . - - - Sets the credentials that are used to authenticate the underlying . - The credentials that are used to authenticate the underlying web request. - - - Gets a collection of preloaded URIs. - The collection of preloaded URIs. + + is . Defines the post-schema-validation infoset of a validated XML node. @@ -382,9 +363,8 @@ This option indents element content only; mixed content is not affected. For the Represents the callback method that will handle XML schema validation events and the . - The source of the event. - - Note Determine the type of a sender before using it in your code. You cannot assume that the sender is an instance of a particular type. The sender is also not guaranteed to not be null. Always surround your casts with failure handling logic. + The source of the event. +Note Determine the type of a sender before using it in your code. You cannot assume that the sender is an instance of a particular type. The sender is also not guaranteed to not be null. Always surround your casts with failure handling logic. The event data. @@ -394,6 +374,11 @@ This option indents element content only; mixed content is not affected. For the Returns a copy of this object. An object copy of this object. + + Gets a value indicating whether the validated XML element or attribute is an XPath node or an atomic value. + + if the validated XML element or attribute is an XPath node; if the validated XML element or attribute is an atomic value. + For a description of this member, see . A copy of this object. @@ -402,64 +387,59 @@ This option indents element content only; mixed content is not affected. For the Gets the value of the validated XML element or attribute. The value of the validated XML element or attribute. + + Gets the current validated XML element or attribute as a boxed object of the most appropriate Microsoft .NET Framework type according to its schema type. + The current validated XML element or attribute as a boxed object of the most appropriate .NET Framework type. + + + Gets the value of the validated XML element or attribute. + The value of the validated XML element or attribute. + Returns the validated XML element or attribute's value as the type specified using the object specified to resolve namespace prefixes. The type to return the validated XML element or attribute's value as. The object used to resolve namespace prefixes. + The value of the validated XML element or attribute as the type requested. The validated XML element or attribute's value is not in the correct format for the target type. The attempted cast is not valid. The attempted cast resulted in an overflow. - The value of the validated XML element or attribute as the type requested. - - - Gets a value indicating whether the validated XML element or attribute is an XPath node or an atomic value. - - if the validated XML element or attribute is an XPath node; if the validated XML element or attribute is an atomic value. - - - Gets the current validated XML element or attribute as a boxed object of the most appropriate .NET type according to its schema type. - The current validated XML element or attribute as a boxed object of the most appropriate .NET type. - - - Gets the value of the validated XML element or attribute. - The value of the validated XML element or attribute. Gets the validated XML element or attribute's value as a . + The validated XML element or attribute's value as a . The validated XML element or attribute's value is not in the correct format for the type. The attempted cast to is not valid. - The validated XML element or attribute's value as a . Gets the validated XML element or attribute's value as a . + The validated XML element or attribute's value as a . The validated XML element or attribute's value is not in the correct format for the type. The attempted cast to is not valid. - The validated XML element or attribute's value as a . Gets the validated XML element or attribute's value as a . + The validated XML element or attribute's value as a . The validated XML element or attribute's value is not in the correct format for the type. The attempted cast to is not valid. The attempted cast resulted in an overflow. - The validated XML element or attribute's value as a . Gets the validated XML element or attribute's value as an . + The validated XML element or attribute's value as an . The validated XML element or attribute's value is not in the correct format for the type. The attempted cast to is not valid. The attempted cast resulted in an overflow. - The validated XML element or attribute's value as an . Gets the validated XML element or attribute's value as an . + The validated XML element or attribute's value as an . The validated XML element or attribute's value is not in the correct format for the type. The attempted cast to is not valid. The attempted cast resulted in an overflow. - The validated XML element or attribute's value as an . - Gets the .NET type of the validated XML element or attribute. - The .NET type of the validated XML element or attribute. The default value is . + Gets the Microsoft .NET Framework type of the validated XML element or attribute. + The .NET Framework type of the validated XML element or attribute. The default value is . Gets the for the validated XML element or attribute. @@ -468,73 +448,9 @@ This option indents element content only; mixed content is not affected. For the An in-memory representation of an XML Schema, as specified in the World Wide Web Consortium (W3C) XML Schema Part 1: Structures and XML Schema Part 2: Datatypes]. - - The XML schema instance namespace. This field is constant. - - - The XML schema namespace. This field is constant. - Initializes a new instance of the class. - - Compiles the XML Schema Object Model (SOM) into schema information for validation. Used to check the syntactic and semantic structure of the programmatically built SOM. Semantic validation checking is performed during compilation. - The validation event handler that receives information about XML Schema validation errors. - - - Compiles the XML Schema Object Model (SOM) into schema information for validation. Used to check the syntactic and semantic structure of the programmatically built SOM. Semantic validation checking is performed during compilation. - The validation event handler that receives information about the XML Schema validation errors. - The used to resolve namespaces referenced in and elements. - - - Reads an XML Schema from the supplied stream. - The supplied data stream. - The validation event handler that receives information about XML Schema syntax errors. - An is raised if no is specified. - The object representing the XML Schema. - - - Reads an XML Schema from the supplied . - The containing the XML Schema to read. - The validation event handler that receives information about the XML Schema syntax errors. - An is raised if no is specified. - The object representing the XML Schema. - - - Reads an XML Schema from the supplied . - The containing the XML Schema to read. - The validation event handler that receives information about the XML Schema syntax errors. - An is raised if no is specified. - The object representing the XML Schema. - - - Writes the XML Schema to the supplied data stream. - The supplied data stream. - - - Writes the XML Schema to the supplied using the specified. - The supplied data stream. - The . - - - Writes the XML Schema to the supplied . - The to write to. - - - Writes the XML Schema to the supplied . - The to write to. - The . - - - Writes the XML Schema to the supplied . - The to write to. - The parameter is null. - - - Writes the XML Schema to the supplied . - The to write to. - The . - Gets or sets the form for attributes declared in the target namespace of the schema. The value that indicates if attributes from the target namespace are required to be qualified with the namespace prefix. The default is . @@ -551,6 +467,15 @@ This option indents element content only; mixed content is not affected. For the Gets or sets the attribute which sets the default value of the attribute on element and complex types in the of the schema. An value representing the different methods for preventing derivation. The default value is . + + Compiles the XML Schema Object Model (SOM) into schema information for validation. Used to check the syntactic and semantic structure of the programmatically built SOM. Semantic validation checking is performed during compilation. + The validation event handler that receives information about XML Schema validation errors. + + + Compiles the XML Schema Object Model (SOM) into schema information for validation. Used to check the syntactic and semantic structure of the programmatically built SOM. Semantic validation checking is performed during compilation. + The validation event handler that receives information about the XML Schema validation errors. + The used to resolve namespaces referenced in and elements. + Gets or sets the form for elements declared in the target namespace of the schema. The value that indicates if elements from the target namespace are required to be qualified with the namespace prefix. The default is . @@ -575,6 +500,9 @@ This option indents element content only; mixed content is not affected. For the Gets the collection of included and imported schemas. An of the included and imported schemas. + + The XML schema instance namespace. This field is constant. + Indicates if the schema has been compiled. @@ -584,10 +512,34 @@ This option indents element content only; mixed content is not affected. For the Gets the collection of schema elements in the schema and is used to add new element types at the element level. An of schema elements in the schema. + + The XML schema namespace. This field is constant. + Gets the post-schema-compilation value for all notations in the schema. An collection of all notations in the schema. + + Reads an XML Schema from the supplied stream. + The supplied data stream. + The validation event handler that receives information about XML Schema syntax errors. + The object representing the XML Schema. + An is raised if no is specified. + + + Reads an XML Schema from the supplied . + The containing the XML Schema to read. + The validation event handler that receives information about the XML Schema syntax errors. + The object representing the XML Schema. + An is raised if no is specified. + + + Reads an XML Schema from the supplied . + The containing the XML Schema to read. + The validation event handler that receives information about the XML Schema syntax errors. + The object representing the XML Schema. + An is raised if no is specified. + Gets the post-schema-compilation value of all schema types in the schema. An of all schema types in the schema. @@ -604,6 +556,34 @@ This option indents element content only; mixed content is not affected. For the Gets or sets the version of the schema. The version of the schema. The default value is . + + Writes the XML Schema to the supplied data stream. + The supplied data stream. + + + Writes the XML Schema to the supplied using the specified. + The supplied data stream. + The . + + + Writes the XML Schema to the supplied . + The to write to. + + + Writes the XML Schema to the supplied . + The to write to. + The . + + + Writes the XML Schema to the supplied . + The to write to. + The parameter is null. + + + Writes the XML Schema to the supplied . + The to write to. + The . + Represents the World Wide Web Consortium (W3C) element (compositor). @@ -791,9 +771,6 @@ This option indents element content only; mixed content is not affected. For the Contains a cache of XML Schema definition language (XSD) and XML-Data Reduced (XDR) schemas. The class is obsolete. Use instead. - - Sets an event handler for receiving information about the XDR and XML schema validation errors. - Initializes a new instance of the class. @@ -805,16 +782,16 @@ This option indents element content only; mixed content is not affected. For the Adds the schema located by the given URL into the schema collection. The namespace URI associated with the schema. For XML Schemas, this will typically be the . The URL that specifies the schema to load. - The schema is not a valid schema. The added to the schema collection; if the schema being added is an XDR schema or if there are compilation errors in the schema. + The schema is not a valid schema. Adds the schema contained in the to the schema collection. The namespace URI associated with the schema. For XML Schemas, this will typically be the . containing the schema to add. - The schema is not a valid schema. The added to the schema collection; if the schema being added is an XDR schema or if there are compilation errors in the schema. + The schema is not a valid schema. Adds the schema contained in the to the schema collection. The specified is used to resolve any external resources. @@ -822,8 +799,8 @@ This option indents element content only; mixed content is not affected. For the containing the schema to add. The used to resolve namespaces referenced in and elements or attribute (XDR schemas). If this is , external references are not resolved. - The schema is not a valid schema. The added to the schema collection; if the schema being added is an XDR schema or if there are compilation errors in the schema. + The schema is not a valid schema. Adds the to the collection. @@ -834,8 +811,8 @@ This option indents element content only; mixed content is not affected. For the Adds the to the collection. The specified is used to resolve any external references. The to add to the collection. The used to resolve namespaces referenced in and elements. If this is , external references are not resolved. - The schema is not a valid schema. The added to the schema collection. + The schema is not a valid schema. Adds all the namespaces defined in the given collection (including their associated schemas) to this collection. @@ -858,23 +835,14 @@ This option indents element content only; mixed content is not affected. For the The array to copy the objects to. The index in where copying will begin. - - Provides support for the "for each" style iteration over the collection of schemas. - An enumerator for iterating over all schemas in the current collection. - - - For a description of this member, see . - The array to copy the objects to. - The index in where copying will begin. - - - For a description of this member, see . - The for the collection. - Gets the number of namespaces defined in this collection. The number of namespaces defined in this collection. + + Provides support for the "for each" style iteration over the collection of schemas. + An enumerator for iterating over all schemas in the current collection. + Gets the associated with the given namespace URI. The namespace URI associated with the schema you want to return. This will typically be the of the schema. @@ -884,6 +852,11 @@ This option indents element content only; mixed content is not affected. For the Gets the default used by the when loading new schemas. An . + + For a description of this member, see . + The array to copy the objects to. + The index in where copying will begin. + For a description of this member, see . The count of the items in the collection. @@ -897,14 +870,29 @@ This option indents element content only; mixed content is not affected. For the For a description of this member, see . A object that can be used to synchronize access to the collection. - - Supports a simple iteration over a collection. This class cannot be inherited. + + For a description of this member, see . + The for the collection. + + + Sets an event handler for receiving information about the XDR and XML schema validation errors. + + + Supports a simple iteration over a collection. This class cannot be inherited. + + + Gets the current in the collection. + The current in the collection. Advances the enumerator to the next schema in the collection. if the move was successful; if the enumerator has passed the end of the collection. + + For a description of this member, see . + The current node. + For a description of this member, see . The next node. @@ -912,14 +900,6 @@ This option indents element content only; mixed content is not affected. For the For a description of this member, see . - - Gets the current in the collection. - The current in the collection. - - - For a description of this member, see . - The current node. - Provides schema compilation options for the class This class cannot be inherited. @@ -1065,7 +1045,6 @@ This option indents element content only; mixed content is not affected. For the If the associated schema is found, the document items will be validated. No errors will be thrown otherwise. - If the item is not validated, the XML processor attempts to notify the client through a validation event handler with = . If a validation event handler has not been set up, no information is returned when the warning is produced. @@ -1073,12 +1052,10 @@ If the item is not validated, the XML processor attempts to notify the client th Document items must consist of well-formed XML and are not validated by the schema. - The XML processor attempts to notify the client through a validation event handler with = that no validation took place for the given item. If a validation event handler has not been set up, no information is returned when the warning is produced. The schema processor must find a schema associated with the indicated namespace to validate the document items. - If the processor cannot find a schema or if the items are not valid, the XML processor attempts to notify the client through a validation event handler with = . If a validation error occurs and a validation event handler is not provided, an exception is thrown. @@ -1103,18 +1080,18 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Converts the value specified, whose type is one of the valid Common Language Runtime (CLR) representations of the XML schema type represented by the , to the CLR type specified. The input value to convert to the specified type. The target type to convert the input value to. + The converted input value. The or parameter is . The type represented by the does not support a conversion from type of the value specified to the type specified. - The converted input value. Converts the value specified, whose type is one of the valid Common Language Runtime (CLR) representations of the XML schema type represented by the , to the CLR type specified using the if the represents the xs:QName type or a type derived from it. The input value to convert to the specified type. The target type to convert the input value to. An used for resolving namespace prefixes. This is only of use if the represents the xs:QName type or a type derived from it. + The converted input value. The or parameter is . The type represented by the does not support a conversion from type of the value specified to the type specified. - The converted input value. The method always returns . @@ -1126,9 +1103,9 @@ If the processor cannot find a schema or if the items are not valid, the XML pro The to validate against the simple type. The to use for atomization while parsing the if this object represents the xs:NCName type. The object to use while parsing the if this object represents the xs:QName type. + An that can be cast safely to the type returned by the property. The input value is not a valid instance of this W3C XML Schema type. The value to parse cannot be . - An that can be cast safely to the type returned by the property. When overridden in a derived class, gets the type for the as specified in the World Wide Web Consortium (W3C) XML 1.0 specification. @@ -1306,12 +1283,12 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Initializes a new instance of the class with the exception message and original object that caused this exception specified. A description of the error condition. - The original object that caused this exception. + The original T:System.Exception object that caused this exception. Initializes a new instance of the class with the exception message specified, and the original object, line number, and line position of the XML that cause this exception specified. A description of the error condition. - The original object that caused this exception. + The original T:System.Exception object that caused this exception. The line number of the XML that caused this exception. The line position of the XML that caused this exception. @@ -1485,20 +1462,29 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Initializes a new instance of the class. + + Affects occurrence and type information inferred by the class for elements and attributes in an XML document. + + + Indicates that a less restrictive schema declaration should be inferred for a particular element or attribute. + + + Indicates that a more restrictive schema declaration should be inferred for a particular element or attribute. + Infers an XML Schema Definition Language (XSD) schema from the XML document contained in the object specified. An object containing the XML document to infer a schema from. + An object containing the inferred schemas. The XML document is not well-formed. The object is not positioned on the root node or on an element. An error occurs during the schema inference process. - An object containing the inferred schemas. Infers an XML Schema Definition Language (XSD) schema from the XML document contained in the object specified, and refines the inferred schema using an existing schema in the object specified with the same target namespace. An object containing the XML document to infer a schema from. An object containing an existing schema used to refine the inferred schema. + An object containing the inferred schemas. The XML document is not well-formed. The object is not positioned on the root node or on an element. An error occurs during the schema inference process. - An object containing the inferred schemas. Gets or sets the value that affects schema occurrence declarations inferred from the XML document. @@ -1508,15 +1494,6 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Gets or sets the value that affects types inferred from the XML document. An object. - - Affects occurrence and type information inferred by the class for elements and attributes in an XML document. - - - Indicates that a less restrictive schema declaration should be inferred for a particular element or attribute. - - - Indicates that a more restrictive schema declaration should be inferred for a particular element or attribute. - Returns information about errors encountered by the class while inferring a schema from an XML document. @@ -1664,7 +1641,7 @@ If the processor cannot find a schema or if the items are not valid, the XML pro The identifier. The value must be a valid URI. - Abstract class for defining facets. This class is the base class for numeric facet classes such as . + Abstract class for defining facets. This class is the base class for numeric facet classes such as Initializes a new instance of the class. @@ -1708,14 +1685,12 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Adds an to the . The . + The index at which the item has been added. - is less than zero. - - -or- - - is greater than . + is less than zero. +-or- + is greater than . The parameter specified is not of type or its derived types , , and . - The index at which the item has been added. Indicates if the specified is in the . @@ -1732,15 +1707,11 @@ If the processor cannot find a schema or if the items are not valid, the XML pro is less than zero. - is multi-dimensional. - + is multi-dimensional. -or- - - is equal to or greater than the length of . - + is equal to or greater than the length of . -or- - - The number of elements in the source is greater than the available space from index to the end of the destination array. +The number of elements in the source is greater than the available space from index to the end of the destination array. The type of the source cannot be cast automatically to the type of the destination array. @@ -1757,11 +1728,14 @@ If the processor cannot find a schema or if the items are not valid, the XML pro The zero-based index at which an item should be inserted. The to insert. - is less than zero. - - -or- - - is greater than . + is less than zero. +-or- + is greater than . + + + Gets the at the specified index. + The index of the . + The at the specified index. @@ -1790,14 +1764,13 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Removes an from the . The to remove. - - Gets the at the specified index. - The index of the . - The at the specified index. - Represents the enumerator for the . + + Gets the current in the collection. + The current . + Moves to the next item in the collection. @@ -1806,6 +1779,10 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Resets the enumerator to the start of the collection. + + For a description of this member, see . + The current . + For a description of this member, see . The next . @@ -1813,14 +1790,6 @@ If the processor cannot find a schema or if the items are not valid, the XML pro For a description of this member, see . - - Gets the current in the collection. - The current . - - - For a description of this member, see . - The current . - Provides the collections for contained elements in the class (for example, Attributes, AttributeGroups, Elements, and so on). @@ -1830,14 +1799,14 @@ If the processor cannot find a schema or if the items are not valid, the XML pro if the qualified name specified exists in the collection; otherwise, . - - Returns an enumerator that can iterate through the . - An that can iterate through . - Gets the number of items contained in the . The number of items contained in the . + + Returns an enumerator that can iterate through the . + An that can iterate through . + Returns the element in the specified by qualified name. The of the element to return. @@ -1914,9 +1883,6 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Contains a cache of XML Schema definition language (XSD) schemas. - - Specifies an event handler for receiving information about XML Schema definition language (XSD) schema validation errors. - Initializes a new instance of the class. @@ -1929,24 +1895,24 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Adds the XML Schema definition language (XSD) schema at the URL specified to the . The schema property, or to use the specified in the schema. The URL that specifies the schema to load. + An object if the schema is valid. If the schema is not valid and a is specified, then is returned and the appropriate validation event is raised. Otherwise, an is thrown. The schema is not valid. The URL passed as a parameter is or . - An object if the schema is valid. If the schema is not valid and a is specified, then is returned and the appropriate validation event is raised. Otherwise, an is thrown. Adds the XML Schema definition language (XSD) schema contained in the to the . The schema property, or to use the specified in the schema. The object. + An object if the schema is valid. If the schema is not valid and a is specified, then is returned and the appropriate validation event is raised. Otherwise, an is thrown. The schema is not valid. The object passed as a parameter is . - An object if the schema is valid. If the schema is not valid and a is specified, then is returned and the appropriate validation event is raised. Otherwise, an is thrown. Adds the given to the . The object to add to the . + An object if the schema is valid. If the schema is not valid and a is specified, then is returned and the appropriate validation event is raised. Otherwise, an is thrown. The schema is not valid. The object passed as a parameter is . - An object if the schema is valid. If the schema is not valid and a is specified, then is returned and the appropriate validation event is raised. Otherwise, an is thrown. Adds all the XML Schema definition language (XSD) schemas in the given to the . @@ -1954,6 +1920,10 @@ If the processor cannot find a schema or if the items are not valid, the XML pro A schema in the is not valid. The object passed as a parameter is . + + Gets or sets the for the . + The for the . The default is an instance with the property set to . + Compiles the XML Schema definition language (XSD) schemas added to the into one logical schema. An error occurred when validating and compiling the schemas in the . @@ -1967,36 +1937,61 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Indicates whether the specified XML Schema definition language (XSD) object is in the . The object. - The passed as a parameter is . if the object is in the ; otherwise, . + The passed as a parameter is . Copies all the objects from the to the given array, starting at the given index. The array to copy the objects to. The index in the array where copying will begin. + + Gets the number of logical XML Schema definition language (XSD) schemas in the . + The number of logical schemas in the . + + + Gets all the global attributes in all the XML Schema definition language (XSD) schemas in the . + The collection of global attributes. + + + Gets all the global elements in all the XML Schema definition language (XSD) schemas in the . + The collection of global elements. + + + Gets all of the global simple and complex types in all the XML Schema definition language (XSD) schemas in the . + The collection of global simple and complex types. + + + Gets a value that indicates whether the XML Schema definition language (XSD) schemas in the have been compiled. + + if the schemas in the have been compiled since the last time a schema was added or removed from the ; otherwise, . + + + Gets the default used by the when loading new XML Schema definition language (XSD) schemas. + A table of atomized string objects. + Removes the specified XML Schema definition language (XSD) schema from the . The object to remove from the . + The object removed from the or if the schema was not found in the . The schema is not a valid schema. The passed as a parameter is . - The object removed from the or if the schema was not found in the . Removes the specified XML Schema definition language (XSD) schema and all the schemas it imports from the . The object to remove from the . - The passed as a parameter is . if the object and all its imports were successfully removed; otherwise, . + The passed as a parameter is . Reprocesses an XML Schema definition language (XSD) schema that already exists in the . The schema to reprocess. + An object if the schema is a valid schema. If the schema is not valid and a is specified, is returned and the appropriate validation event is raised. Otherwise, an is thrown. The schema is not valid. The object passed as a parameter is . The object passed as a parameter does not already exist in the . - An object if the schema is a valid schema. If the schema is not valid and a is specified, is returned and the appropriate validation event is raised. Otherwise, an is thrown. Returns a collection of all the XML Schema definition language (XSD) schemas in the . @@ -2007,34 +2002,8 @@ If the processor cannot find a schema or if the items are not valid, the XML pro The schema property. An object containing all the schemas that have been added to the that belong to the given namespace. If no schemas have been added to the , an empty object is returned. - - Gets or sets the for the . - The for the . The default is an instance with the property set to . - - - Gets the number of logical XML Schema definition language (XSD) schemas in the . - The number of logical schemas in the . - - - Gets all the global attributes in all the XML Schema definition language (XSD) schemas in the . - The collection of global attributes. - - - Gets all the global elements in all the XML Schema definition language (XSD) schemas in the . - The collection of global elements. - - - Gets all of the global simple and complex types in all the XML Schema definition language (XSD) schemas in the . - The collection of global simple and complex types. - - - Gets a value that indicates whether the XML Schema definition language (XSD) schemas in the have been compiled. - - if the schemas in the have been compiled since the last time a schema was added or removed from the ; otherwise, . - - - Gets the default used by the when loading new XML Schema definition language (XSD) schemas. - A table of atomized string objects. + + Specifies an event handler for receiving information about XML Schema definition language (XSD) schema validation errors. Sets the used to resolve namespaces or locations referenced in include and import elements of a schema. @@ -2092,9 +2061,8 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Gets or sets an Xml Schema facet. - One of the following facet classes: - - , , , , , , , , , , , . + One of the following facet classes: +, , , , , , , , , , , . Represents the element for simple content from XML Schema as specified by the World Wide Web Consortium (W3C). This class defines a simple type. Simple types can specify information and constraints for the value of attributes or elements with text-only content. @@ -2146,9 +2114,8 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Gets or sets an Xml Schema facet. - One of the following facet classes: - - , , , , , , , , , , , . + One of the following facet classes: +, , , , , , , , , , , . Represents the element for simple types from XML Schema as specified by the World Wide Web Consortium (W3C). A datatype can be used to specify the content of a . The value of the element must be any one of a set of alternative datatypes specified in the union. Union types are always derived types and must comprise at least two alternative datatypes. @@ -2180,6 +2147,30 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Initializes a new instance of the class. + + Gets the post-compilation object type or the built-in XML Schema Definition Language (XSD) data type, simpleType element, or complexType element. This is a post-schema-compilation infoset property. + The built-in XSD data type, simpleType element, or complexType element. + + + Gets the post-compilation value for the base type of this schema type. + An object representing the base type of this schema type. + + + Gets the post-compilation value for the data type of the complex type. + The post-schema-compilation value. + + + Gets the post-compilation information on how this element was derived from its base type. + One of the valid values. + + + Gets or sets the final attribute of the type derivation that indicates if further derivations are allowed. + One of the valid values. The default is . + + + Gets the post-compilation value of the property. + The post-compilation value of the property. The default is the attribute value of the element. + Returns an that represents the built-in complex type of the complex type specified. One of the values representing the complex type. @@ -2188,8 +2179,8 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Returns an that represents the built-in complex type of the complex type specified by qualified name. The of the complex type. - The parameter is . The that represents the built-in complex type. + The parameter is . Returns an that represents the built-in simple type of the specified simple type. @@ -2199,8 +2190,8 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Returns an that represents the built-in simple type of the simple type that is specified by the qualified name. The of the simple type. - The parameter is . The that represents the built-in simple type. + The parameter is . Returns a value indicating if the derived schema type specified is derived from the base schema type specified. @@ -2210,30 +2201,6 @@ If the processor cannot find a schema or if the items are not valid, the XML pro if the derived type is derived from the base type; otherwise, . - - Gets the post-compilation object type or the built-in XML Schema Definition Language (XSD) data type, simpleType element, or complexType element. This is a post-schema-compilation infoset property. - The built-in XSD data type, simpleType element, or complexType element. - - - Gets the post-compilation value for the base type of this schema type. - An object representing the base type of this schema type. - - - Gets the post-compilation value for the data type of the complex type. - The post-schema-compilation value. - - - Gets the post-compilation information on how this element was derived from its base type. - One of the valid values. - - - Gets or sets the final attribute of the type derivation that indicates if further derivations are allowed. - One of the valid values. The default is . - - - Gets the post-compilation value of the property. - The post-compilation value of the property. The default is the attribute value of the element. - Gets or sets a value indicating if this type has a mixed content model. This property is only valid in a complex type. @@ -2340,9 +2307,6 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Represents an XML Schema Definition Language (XSD) Schema validation engine. The class cannot be inherited. - - The that receives schema validation warnings and errors encountered during schema validation. - Initializes a new instance of the class. An object containing element and attribute names as atomized strings. @@ -2386,21 +2350,29 @@ If the processor cannot find a schema or if the items are not valid, the XML pro The parameter is not an , , or object. The parameter cannot be . + + Gets or sets the line number information for the XML node being validated. + An object. + Skips validation of the current element content and prepares the object to validate content in the parent element's context. An object whose properties are set if the current element content is successfully skipped. This parameter can be . The method was not called in the correct sequence. For example, calling after calling . + + Gets or sets the source URI for the XML node being validated. + A object representing the source URI for the XML node being validated; the default is . + Validates the attribute name, namespace URI, and value in the current element context. The local name of the attribute to validate. The namespace URI of the attribute to validate. The value of the attribute to validate. An object whose properties are set on successful validation of the attribute. This parameter can be . + The validated attribute's value. The attribute is not valid in the current element context. The method was not called in the correct sequence. For example, calling after calling . One or more of the parameters specified are . - The validated attribute's value. Validates the attribute name, namespace URI, and value in the current element context. @@ -2408,10 +2380,10 @@ If the processor cannot find a schema or if the items are not valid, the XML pro The namespace URI of the attribute to validate. An used to pass the attribute's value as a Common Language Runtime (CLR) type compatible with the XML Schema Definition Language (XSD) type of the attribute. An object whose properties are set on successful validation of the attribute. This parameter and can be . + The validated attribute's value. The attribute is not valid in the current element context. The method was not called in the correct sequence. For example, calling after calling . One or more of the parameters specified are . - The validated attribute's value. Validates the element in the current context. @@ -2436,18 +2408,18 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Verifies if the text content of the element is valid according to its data type for elements with simple content, and verifies if the content of the current element is complete for elements with complex content. An object whose properties are set on successful validation of the element. This parameter can be . + The parsed, typed text value of the element if the element has simple content. The element's content is not valid. The method was not called in the correct sequence. For example, if the method is called after calling . - The parsed, typed text value of the element if the element has simple content. Verifies if the text content of the element specified is valid according to its data type. An object whose properties are set on successful validation of the text content of the element. This parameter can be . The typed text content of the element. + The parsed, typed simple content of the element. The element's text content is not valid. The method was not called in the correct sequence (for example, if the method is called after calling ), calls to the method have been previously made, or the element has complex content. The typed text content parameter cannot be . - The parsed, typed simple content of the element. Verifies whether all the required attributes in the element context are present and prepares the object to validate the child content of the element. @@ -2482,13 +2454,8 @@ If the processor cannot find a schema or if the items are not valid, the XML pro White space is not allowed in the current element context. The method was not called in the correct sequence. For example, if the method is called after calling . - - Gets or sets the line number information for the XML node being validated. - An object. - - - Gets or sets the source URI for the XML node being validated. - A object representing the source URI for the XML node being validated; the default is . + + The that receives schema validation warnings and errors encountered during schema validation. Gets or sets the object sent as the sender object of a validation event. @@ -2745,8 +2712,8 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Gets or sets the XML element name. - The element name of an array member does not match the element name specified by the property. The name of the XML element. + The element name of an array member does not match the element name specified by the property. Gets or sets the XML namespace generated in the XML document. @@ -2816,8 +2783,8 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Gets or sets the XML Schema definition (XSD) data type of the XML element generated by the . - The XML Schema data type you have specified cannot be mapped to the.NET data type. An XML Schema data type. + The XML Schema data type you have specified cannot be mapped to the.NET data type. Gets or sets the name of the generated XML element. @@ -2932,14 +2899,14 @@ If the processor cannot find a schema or if the items are not valid, the XML pro The prefix associated with an XML namespace. An XML namespace. - - Gets the array of prefix and namespace pairs in an object. - An array of objects that are used as qualified names in an XML document. - Gets the number of prefix and namespace pairs in the collection. The number of prefix and namespace pairs in the collection. + + Gets the array of prefix and namespace pairs in an object. + An array of objects that are used as qualified names in an XML document. + Indicates to the that the member must be treated as XML text when the class that contains it is serialized or deserialized. @@ -2952,9 +2919,9 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Gets or sets the XML Schema definition language (XSD) data type of the text generated by the . + An XML Schema (XSD) data type. The XML Schema data type you have specified cannot be mapped to the .NET data type. The XML Schema data type you have specified is invalid for the property and cannot be converted to the member type. - An XML Schema (XSD) data type. Gets or sets the type of the member. @@ -2964,8 +2931,7 @@ If the processor cannot find a schema or if the items are not valid, the XML pro Specifies the type of validation to perform. - Validates if DTD or schema information is found. - + Validates if DTD or schema information is found. Starting with .NET Framework 2.0, this field is obsolete. It applies only to the obsolete class. @@ -2973,7 +2939,6 @@ Starting with .NET Framework 2.0, this field is obsolete. It applies only to the No validation is performed, and no validation errors are thrown. This setting creates an XML 1.0 compliant non-validating parser. - Calls to report default attributes and resolve general entities. The DOCTYPE is not used for validation purposes. @@ -2981,7 +2946,6 @@ Calls to report default attr Validate according to XML-Data Reduced (XDR) schemas, including inline XDR schemas. XDR schemas are recognized using the namespace prefix or the property. - Starting with .NET Framework 2.0, this field is obsolete. It applies only to the obsolete class. @@ -3013,7 +2977,6 @@ Starting with .NET Framework 2.0, this field is obsolete. It applies only to the An exception has been thrown, which has left the in an invalid state. You can call the method to put the in the state. Any other method calls results in an . - This field was added in .NET Framework 2.0. @@ -3035,99 +2998,52 @@ This field was added in .NET Framework 2.0. Adds the specified node to the end of the list of child nodes, of this node. The to add. - This node is of a type that does not allow child nodes of the type of the node. - - The is an ancestor of this node. - The was created from a different document than the one that created this node. - - This node is read-only. The added. + This node is of a type that does not allow child nodes of the type of the node. +The is an ancestor of this node. + The was created from a different document than the one that created this node. +This node is read-only. + + + Gets the base Uniform Resource Identifier (URI) of the node. + The location from which the node was loaded or String.Empty if the node has no base URI. Attribute nodes have the same base URI as their owner element. If an attribute node does not have an owner element, returns String.Empty. Creates a duplicate of this node. - to recursively clone the subtree under the specified node; to clone only the node itself. + to recursively clone the subtree under the specified node; to clone only the node itself The duplicate node. + + Sets the concatenated values of the node and all its children. + The concatenated values of the node and all its children. For attribute nodes, this property has the same functionality as the property. + + + Sets the value of the attribute. + The attribute value. + The XML specified when setting this property is not well-formed. + Inserts the specified node immediately after the specified reference node. The to insert. The that is the reference node. The is placed after the . - This node is of a type that does not allow child nodes of the type of the node. - - The is an ancestor of this node. - The was created from a different document than the one that created this node. - - The is not a child of this node. - - This node is read-only. The inserted. + This node is of a type that does not allow child nodes of the type of the node. +The is an ancestor of this node. + The was created from a different document than the one that created this node. +The is not a child of this node. +This node is read-only. Inserts the specified node immediately before the specified reference node. The to insert. The that is the reference node. The is placed before this node. - The current node is of a type that does not allow child nodes of the type of the node. - - The is an ancestor of this node. - The was created from a different document than the one that created this node. - - The is not a child of this node. - - This node is read-only. The inserted. - - - Adds the specified node to the beginning of the list of child nodes for this node. - The to add. If it is an , the entire contents of the document fragment are moved into the child list of this node. - This node is of a type that does not allow child nodes of the type of the node. - - The is an ancestor of this node. - The was created from a different document than the one that created this node. - - This node is read-only. - The added. - - - Removes the specified child node. - The to remove. - The is not a child of this node. Or this node is read-only. - The removed. - - - Replaces the child node specified with the new child node specified. - The new child . - The to replace. - This node is of a type that does not allow child nodes of the type of the node. - - The is an ancestor of this node. - The was created from a different document than the one that created this node. - - This node is read-only. - - The is not a child of this node. - The replaced. - - - Saves all the children of the node to the specified . - The to which you want to save. - - - Saves the node to the specified . - The to which you want to save. - - - Gets the base Uniform Resource Identifier (URI) of the node. - The location from which the node was loaded or String.Empty if the node has no base URI. Attribute nodes have the same base URI as their owner element. If an attribute node does not have an owner element, returns String.Empty. - - - Sets the concatenated values of the node and all its children. - The concatenated values of the node and all its children. For attribute nodes, this property has the same functionality as the property. - - - Sets the value of the attribute. - The XML specified when setting this property is not well-formed. - The attribute value. + The current node is of a type that does not allow child nodes of the type of the node. +The is an ancestor of this node. + The was created from a different document than the one that created this node. +The is not a child of this node. +This node is read-only. Gets the local name of the node. @@ -3159,19 +3075,40 @@ This field was added in .NET Framework 2.0. Gets or sets the namespace prefix of this node. - This node is read-only. - The specified prefix contains an invalid character. - - The specified prefix is malformed. - - The namespaceURI of this node is . - - The specified prefix is "xml", and the namespaceURI of this node is different from "http://www.w3.org/XML/1998/namespace". - - This node is an attribute, the specified prefix is "xmlns", and the namespaceURI of this node is different from "http://www.w3.org/2000/xmlns/". - - This node is an attribute, and the qualifiedName of this node is "xmlns" [Namespaces]. The namespace prefix of this node. If there is no prefix, this property returns String.Empty. + This node is read-only. + The specified prefix contains an invalid character. +The specified prefix is malformed. +The namespaceURI of this node is . +The specified prefix is "xml", and the namespaceURI of this node is different from "http://www.w3.org/XML/1998/namespace". +This node is an attribute, the specified prefix is "xmlns", and the namespaceURI of this node is different from "http://www.w3.org/2000/xmlns/". +This node is an attribute, and the qualifiedName of this node is "xmlns" [Namespaces]. + + + Adds the specified node to the beginning of the list of child nodes for this node. + The to add. If it is an , the entire contents of the document fragment are moved into the child list of this node. + The added. + This node is of a type that does not allow child nodes of the type of the node. +The is an ancestor of this node. + The was created from a different document than the one that created this node. +This node is read-only. + + + Removes the specified child node. + The to remove. + The removed. + The is not a child of this node. Or this node is read-only. + + + Replaces the child node specified with the new child node specified. + The new child . + The to replace. + The replaced. + This node is of a type that does not allow child nodes of the type of the node. +The is an ancestor of this node. + The was created from a different document than the one that created this node. +This node is read-only. +The is not a child of this node. Gets the post-schema-validation-infoset that has been assigned to this node as a result of schema validation. @@ -3184,8 +3121,16 @@ This field was added in .NET Framework 2.0. Gets or sets the value of the node. - The node is read-only and a set operation is called. The value returned depends on the of the node. For nodes, this property is the value of attribute. + The node is read-only and a set operation is called. + + + Saves all the children of the node to the specified . + The to which you want to save. + + + Saves the node to the specified . + The to which you want to save. Represents a collection of attributes that can be accessed by name or index. @@ -3193,9 +3138,9 @@ This field was added in .NET Framework 2.0. Inserts the specified attribute as the last node in the collection. The attribute to insert. + The to append to the collection. was created from a document different from the one that created this collection. - The to append to the collection. Copies all the objects from this collection into the given array. @@ -3206,15 +3151,32 @@ This field was added in .NET Framework 2.0. Inserts the specified attribute immediately after the specified reference attribute. The attribute to insert. The reference attribute. is placed after the . - The was created from a document different from the one that created this collection. Or the is not a member of this collection. The to insert into the collection. + The was created from a document different from the one that created this collection. Or the is not a member of this collection. Inserts the specified attribute immediately before the specified reference attribute. The attribute to insert. The reference attribute. is placed before the . - The was created from a document different from the one that created this collection. Or the is not a member of this collection. The to insert into the collection. + The was created from a document different from the one that created this collection. Or the is not a member of this collection. + + + Gets the attribute with the specified index. + The index of the attribute. + The attribute at the specified index. + The index being passed in is out of range. + + + Gets the attribute with the specified name. + The qualified name of the attribute. + The attribute with the specified name. If the attribute does not exist, this property returns . + + + Gets the attribute with the specified local name and namespace Uniform Resource Identifier (URI). + The local name of the attribute. + The namespace URI of the attribute. + The attribute with the specified local name and namespace URI. If the attribute does not exist, this property returns . Inserts the specified attribute as the first node in the collection. @@ -3237,36 +3199,18 @@ This field was added in .NET Framework 2.0. Adds a using its property. An attribute node to store in this collection. The node will later be accessible using the name of the node. If a node with that name is already present in the collection, it is replaced by the new one; otherwise, the node is appended to the end of the collection. + If the replaces an existing node with the same name, the old node is returned; otherwise, the added node is returned. - was created from a different than the one that created this collection. - - This is read-only. + was created from a different than the one that created this collection. +This is read-only. is an that is already an attribute of another object. To re-use attributes in other elements, you must clone the objects you want to re-use. - If the replaces an existing node with the same name, the old node is returned; otherwise, the added node is returned. For a description of this member, see . The array that is the destination of the objects copied from this collection. The index in the array where copying begins. - - Gets the attribute with the specified index. - The index of the attribute. - The index being passed in is out of range. - The attribute at the specified index. - - - Gets the attribute with the specified name. - The qualified name of the attribute. - The attribute with the specified name. If the attribute does not exist, this property returns . - - - Gets the attribute with the specified local name and namespace Uniform Resource Identifier (URI). - The local name of the attribute. - The namespace URI of the attribute. - The attribute with the specified local name and namespace URI. If the attribute does not exist, this property returns . - For a description of this member, see . An that contains the count of the attributes. @@ -3296,14 +3240,6 @@ This field was added in .NET Framework 2.0. to recursively clone the subtree under the specified node; to clone only the node itself. Because CDATA nodes do not have children, regardless of the parameter setting, the cloned node will always include the data content. The cloned node. - - Saves the children of the node to the specified . - The to which you want to save. - - - Saves the node to the specified . - The to which you want to save. - Gets the local name of the node. For CDATA nodes, the local name is . @@ -3324,6 +3260,14 @@ This field was added in .NET Framework 2.0. Gets the text node that immediately precedes this node. Returns . + + Saves the children of the node to the specified . + The to which you want to save. + + + Saves the node to the specified . + The to which you want to save. + Provides text manipulation methods that are used by several classes. @@ -3337,16 +3281,28 @@ This field was added in .NET Framework 2.0. Appends the specified string to the end of the character data of the node. The string to insert into the existing string. + + Contains the data of the node. + The data of the node. + Removes a range of characters from the node. The position within the string to start deleting. The number of characters to delete. + + Gets or sets the concatenated values of the node and all the children of the node. + The concatenated values of the node and all the children of the node. + Inserts the specified string at the specified character offset. The position within the string to insert the supplied string data. The string data that is to be inserted into the existing string. + + Gets the length of the data, in characters. + The length, in characters, of the string in the property. The length may be zero; that is, CharacterData nodes can be empty. + Replaces the specified number of characters starting at the specified offset with the specified string. The position within the string to start replacing. @@ -3359,22 +3315,10 @@ This field was added in .NET Framework 2.0. The number of characters to retrieve. The substring corresponding to the specified range. - - Contains the data of the node. - The data of the node. - - - Gets or sets the concatenated values of the node and all the children of the node. - The concatenated values of the node and all the children of the node. - - - Gets the length of the data, in characters. - The length, in characters, of the string in the property. The length may be zero; that is, CharacterData nodes can be empty. - Gets or sets the value of the node. - Node is read-only. The value of the node. + Node is read-only. Represents the content of an XML comment. @@ -3390,14 +3334,6 @@ This field was added in .NET Framework 2.0. to recursively clone the subtree under the specified node; to clone only the node itself. Because comment nodes do not have children, the cloned node always includes the text content, regardless of the parameter setting. The cloned node. - - Saves all the children of the node to the specified . Because comment nodes do not have children, this method has no effect. - The to which you want to save. - - - Saves the node to the specified . - The to which you want to save. - Gets the local name of the node. For comment nodes, the value is . @@ -3410,6 +3346,14 @@ This field was added in .NET Framework 2.0. Gets the type of the current node. For comment nodes, the value is XmlNodeType.Comment. + + Saves all the children of the node to the specified . Because comment nodes do not have children, this method has no effect. + The to which you want to save. + + + Saves the node to the specified . + The to which you want to save. + Encodes and decodes XML names, and provides methods for converting between common language runtime types and XML Schema definition language (XSD) types. When converting data types, the values returned are locale-independent. @@ -3476,97 +3420,94 @@ This field was added in .NET Framework 2.0. Converts the to a equivalent. The string to convert. + A value, that is, or . is . does not represent a value. - A value, that is, or . Converts the to a equivalent. The string to convert. + A equivalent of the string. is . is not in the correct format. represents a number less than or greater than . - A equivalent of the string. Converts the to a equivalent. The string containing a single character to convert. + A representing the single character. The value of the parameter is . The parameter contains more than one character. - A representing the single character. Converts the to a equivalent. The string to convert. + A equivalent of the string. is . is an empty string or is not in the correct format. - A equivalent of the string. Converts the to a equivalent. The string to convert. The format structure to apply to the converted . Valid formats include "yyyy-MM-ddTHH:mm:sszzzzzz" and its subsets. The string is validated against this format. + A equivalent of the string. is . - or is String.Empty - - -or- - - does not contain a date and time that corresponds to . - A equivalent of the string. + or is String.Empty +-or- + does not contain a date and time that corresponds to . Converts the to a equivalent. The string to convert. An array containing the format structures to apply to the converted . Valid formats include "yyyy-MM-ddTHH:mm:sszzzzzz" and its subsets. + A equivalent of the string. is . - or an element of is String.Empty - - -or- - - does not contain a date and time that corresponds to any of the elements of . - A equivalent of the string. + or an element of is String.Empty +-or- + does not contain a date and time that corresponds to any of the elements of . Converts the to a using the specified. The value to convert. One of the enumeration values that specify whether the date should be converted to local time or preserved as Coordinated Universal Time (UTC), if it is a UTC date. + A equivalent of the . is . is . is an empty string or is not in a valid format. - A equivalent of the . Converts the supplied to a equivalent. - The string to convert. The string must conform to a subset of the W3C Recommendation for the XML dateTime type. For more information, see the dateTime section of the XML Schema specification. + The string to convert. +Note The string must conform to a subset of the W3C Recommendation for the XML dateTime type. For more information, see the dateTime section of the XML Schema specification.. + The equivalent of the supplied string. is . The argument passed to this method is outside the range of allowable values. For information about allowable values, see . The argument passed to this method does not conform to a subset of the W3C Recommendations for the XML dateTime type. For more information, see the dateTime section of the XML Schema specification. - The equivalent of the supplied string. Converts the supplied to a equivalent. The string to convert. The format from which is converted. The format parameter can be any subset of the W3C Recommendation for the XML dateTime type. (For more information, see the dateTime section of the XML Schema specification..) The string is validated against this format. + The equivalent of the supplied string. is . or is an empty string or is not in the specified format. - The equivalent of the supplied string. Converts the supplied to a equivalent. @@ -3577,24 +3518,24 @@ This field was added in .NET Framework 2.0. Converts the to a equivalent. The string to convert. + A equivalent of the string. is . is not in the correct format. represents a number less than or greater than . - A equivalent of the string. Converts the to a equivalent. The string to convert. + A equivalent of the string. is . is not in the correct format. represents a number less than or greater than . - A equivalent of the string. Converts the to a equivalent. @@ -3604,57 +3545,57 @@ This field was added in .NET Framework 2.0. Converts the to a equivalent. The string to convert. + An equivalent of the string. is . is not in the correct format. represents a number less than or greater than . - An equivalent of the string. Converts the to a equivalent. The string to convert. + An equivalent of the string. is . is not in the correct format. represents a number less than or greater than . - An equivalent of the string. Converts the to a equivalent. The string to convert. + An equivalent of the string. is . is not in the correct format. represents a number less than or greater than . - An equivalent of the string. Converts the to a equivalent. The string to convert. + An equivalent of the string. is . is not in the correct format. represents a number less than or greater than . - An equivalent of the string. Converts the to a equivalent. The string to convert. + A equivalent of the string. is . is not in the correct format. represents a number less than or greater than . - A equivalent of the string. Converts the to a . @@ -3686,9 +3627,9 @@ This field was added in .NET Framework 2.0. Converts the to a using the specified. The value to convert. One of the values that specify how to treat the value. + A equivalent of the . The value is not valid. The or value is . - A equivalent of the . Converts the supplied to a . @@ -3709,7 +3650,7 @@ This field was added in .NET Framework 2.0. Converts the to a . The value to convert. - A string representation of the . + A string representation of the . Converts the to a . @@ -3719,17 +3660,17 @@ This field was added in .NET Framework 2.0. Converts the to a . The value to convert. - A string representation of the . + A string representation of the . Converts the to a . The value to convert. - A string representation of the . + A string representation of the . Converts the to a . The value to convert. - A string representation of the . + A string representation of the . Converts the to a . @@ -3739,7 +3680,7 @@ This field was added in .NET Framework 2.0. Converts the to a . The value to convert. - A string representation of the . + A string representation of the . Converts the to a . @@ -3749,83 +3690,83 @@ This field was added in .NET Framework 2.0. Converts the to a . The value to convert. - A string representation of the . + A string representation of the . Converts the to a . The value to convert. - A string representation of the . + A string representation of the . Converts the to a . The value to convert. - A string representation of the . + A string representation of the . Converts the to a equivalent. The string to convert. The string format must conform to the W3C XML Schema Part 2: Datatypes recommendation for duration. + A equivalent of the string. is not in correct format to represent a value. - A equivalent of the string. Converts the to a equivalent. The string to convert. + A equivalent of the string. is . is not in the correct format. represents a number less than or greater than . - A equivalent of the string. Converts the to a equivalent. The string to convert. + A equivalent of the string. is . is not in the correct format. represents a number less than or greater than . - A equivalent of the string. Converts the to a equivalent. The string to convert. + A equivalent of the string. is . is not in the correct format. represents a number less than or greater than . - A equivalent of the string. Verifies that the name is a valid name according to the W3C Extended Markup Language recommendation. The name to verify. + The name, if it is a valid XML name. is not a valid XML name. is or String.Empty. - The name, if it is a valid XML name. Verifies that the name is a valid according to the W3C Extended Markup Language recommendation. An is a name that cannot contain a colon. The name to verify. + The name, if it is a valid NCName. - is or . + is or String.Empty. is not a valid non-colon name. - The name, if it is a valid NCName. Verifies that the string is a valid NMTOKEN according to the W3C XML Schema Part2: Datatypes recommendation. The string you wish to verify. + The name token, if it is a valid NMTOKEN. The string is not a valid name token. is . - The name token, if it is a valid NMTOKEN. Returns the passed in string instance if all the characters in the string argument are valid public id characters. @@ -3836,8 +3777,8 @@ This field was added in .NET Framework 2.0. Verifies that the string is a valid token according to the W3C XML Schema Part2: Datatypes recommendation. The string value you wish to verify. - The string value is not a valid token. The token, if it is a valid token. + The string value is not a valid token. Returns the passed-in string instance if all the characters in the string argument are valid whitespace characters. @@ -3882,23 +3823,32 @@ This field was added in .NET Framework 2.0. to recursively clone the subtree under the specified node; to clone only the node itself. Because nodes do not have children, the cloned node always includes the data value, regardless of the parameter setting. The cloned node. - - Saves the children of the node to the specified . Because nodes do not have children, this method has no effect. - The to which you want to save. - - - Saves the node to the specified . - The to which you want to save. - Gets or sets the encoding level of the XML document. - The valid character encoding name. The most commonly supported character encoding names for XML are the following: + The valid character encoding name. The most commonly supported character encoding names for XML are the following: + Category - Category Encoding Names Unicode UTF-8, UTF-16 ISO 10646 ISO-10646-UCS-2, ISO-10646-UCS-4 ISO 8859 ISO-8859-n (where "n" is a digit from 1 to 9) JIS X-0208-1997 ISO-2022-JP, Shift_JIS, EUC-JP - - This value is optional. If a value is not set, this property returns String.Empty. + Encoding Names + + Unicode + + UTF-8, UTF-16 + + ISO 10646 + + ISO-10646-UCS-2, ISO-10646-UCS-4 + + ISO 8859 + + ISO-8859-n (where "n" is a digit from 1 to 9) + + JIS X-0208-1997 - If an encoding attribute is not included, UTF-8 encoding is assumed when the document is written or saved out. + ISO-2022-JP, Shift_JIS, EUC-JP + + +This value is optional. If a value is not set, this property returns String.Empty. +If an encoding attribute is not included, UTF-8 encoding is assumed when the document is written or saved out. Gets or sets the concatenated values of the . @@ -3928,26 +3878,16 @@ This field was added in .NET Framework 2.0. Gets the XML version of the document. The value is always . - - Represents an XML document. You can use this class to load, validate, edit, add, and position XML in a document. - - - Occurs when the of a node belonging to this document has been changed. - - - Occurs when the of a node belonging to this document is about to be changed. - - - Occurs when a node belonging to this document has been inserted into another node. - - - Occurs when a node belonging to this document is about to be inserted into another node. + + Saves the children of the node to the specified . Because nodes do not have children, this method has no effect. + The to which you want to save. - - Occurs when a node belonging to this document has been removed from its parent. + + Saves the node to the specified . + The to which you want to save. - - Occurs when a node belonging to this document is about to be removed from the document. + + Represents an XML document. You can use this class to load, validate, edit, add, and position XML in a document. Initializes a new instance of the class. @@ -3960,6 +3900,10 @@ This field was added in .NET Framework 2.0. Initializes a new instance of the class with the specified . The to use. + + Gets the base URI of the current node. + The location from which the node was loaded. + Creates a duplicate of this node. @@ -4034,8 +3978,8 @@ This field was added in .NET Framework 2.0. Creates an with the specified name. The name of the entity reference. - The name is invalid (for example, names starting with'#' are invalid.) The new . + The name is invalid (for example, names starting with'#' are invalid.) Creates a new object for navigating this document. @@ -4051,16 +3995,16 @@ This field was added in .NET Framework 2.0. String version of the of the new node. This parameter must be one of the values listed in the table below. The qualified name of the new node. If the name contains a colon, it is parsed into and components. The namespace URI of the new node. - The name was not provided and the requires a name; or is not one of the strings listed below. The new . + The name was not provided and the requires a name; or is not one of the strings listed below. Creates an with the specified , , and . The of the new node. The qualified name of the new node. If the name contains a colon then it is parsed into and components. The namespace URI of the new node. - The name was not provided and the requires a name. The new . + The name was not provided and the requires a name. Creates a with the specified , , , and . @@ -4068,8 +4012,8 @@ This field was added in .NET Framework 2.0. The prefix of the new node. The local name of the new node. The namespace URI of the new node. - The name was not provided and the requires a name. The new . + The name was not provided and the requires a name. Creates an with the specified name and data. @@ -4079,7 +4023,7 @@ This field was added in .NET Framework 2.0. Creates an node. - The string must contain only the following characters &#20; &#10; &#13; and &#9;. + The string must contain only the following characters &#20; &#10; &#13; and &#9; A new node. @@ -4089,18 +4033,25 @@ This field was added in .NET Framework 2.0. Creates an node. - The string must contain only the following characters &#20; &#10; &#13; and &#9;. + The string must contain only the following characters &#20; &#10; &#13; and &#9; A new node. Creates an node with the specified values. The version must be "1.0". - The value of the encoding attribute. This is the encoding that is used when you save the to a file or a stream; therefore, it must be set to a string supported by the class, otherwise fails. If this is or String.Empty, the method does not write an encoding attribute on the XML declaration and therefore the default encoding, UTF-8, is used. - - Note: If the is saved to either a or an , this encoding value is discarded. Instead, the encoding of the or the is used. This ensures that the XML written out can be read back using the correct encoding. + The value of the encoding attribute. This is the encoding that is used when you save the to a file or a stream; therefore, it must be set to a string supported by the class, otherwise fails. If this is or String.Empty, the method does not write an encoding attribute on the XML declaration and therefore the default encoding, UTF-8, is used. +Note: If the is saved to either a or an , this encoding value is discarded. Instead, the encoding of the or the is used. This ensures that the XML written out can be read back using the correct encoding. The value must be either "yes" or "no". If this is or String.Empty, the method does not write a standalone attribute on the XML declaration. - The values of or are something other than the ones specified above. The new node. + The values of or are something other than the ones specified above. + + + Gets the root for the document. + The that represents the root of the XML document tree. If no root exists, is returned. + + + Gets the node containing the DOCTYPE declaration. + The containing the DocumentType (DOCTYPE declaration). Gets the with the specified ID. @@ -4118,13 +4069,32 @@ This field was added in .NET Framework 2.0. NamespaceURI to match. An containing a list of all matching nodes. If no nodes match the specified and , the returned collection will be empty. + + Gets the object for the current document. + The object for the current document. + Imports a node from another document to the current document. The node being imported. to perform a deep clone; otherwise, . - Calling this method on a node type which cannot be imported. The imported . + Calling this method on a node type which cannot be imported. + + + Throws an in all cases. + The values of the node and all its child nodes. + In all cases. + + + Gets or sets the markup representing the children of the current node. + The markup of the children of the current node. + The XML specified when setting this property is not well-formed. + + + Gets a value indicating whether the current node is read-only. + + if the current node is read-only; otherwise . nodes always return . Loads the XML document from the specified stream. @@ -4148,19 +4118,13 @@ This field was added in .NET Framework 2.0. The specified path is invalid (for example, it is on an unmapped drive). An I/O error occurred while opening the file. - specified a file that is read-only. - - -or- - - This operation is not supported on the current platform. - - -or- - - specified a directory. - - -or- - - The caller does not have the required permission. + specified a file that is read-only. +-or- +This operation is not supported on the current platform. +-or- + specified a directory. +-or- +The caller does not have the required permission. The file specified in was not found. is in an invalid format. @@ -4176,11 +4140,58 @@ This field was added in .NET Framework 2.0. String containing the XML document to load. There is a load or parse error in the XML. In this case, the document remains empty. + + Gets the local name of the node. + For nodes, the local name is #document. + + + Gets the qualified name of the node. + For nodes, the name is #document. + + + Gets the associated with this implementation. + An enabling you to get the atomized version of a string within the document. + + + Occurs when the of a node belonging to this document has been changed. + + + Occurs when the of a node belonging to this document is about to be changed. + + + Occurs when a node belonging to this document has been inserted into another node. + + + Occurs when a node belonging to this document is about to be inserted into another node. + + + Occurs when a node belonging to this document has been removed from its parent. + + + Occurs when a node belonging to this document is about to be removed from the document. + + + Gets the type of the current node. + The node type. For nodes, this value is XmlNodeType.Document. + + + Gets the to which the current node belongs. + For nodes ( equals XmlNodeType.Document), this property always returns . + + + Gets the parent node of this node (for nodes that can have parents). + Always returns . + + + Gets or sets a value indicating whether to preserve white space in element content. + + to preserve white space; otherwise . The default is . + Creates an object based on the information in the . The reader must be positioned on a node or attribute. - The XML source. - The reader is positioned on a node type that does not translate to a valid DOM node (for example, EndElement or EndEntity). + The XML source The new or if no more nodes exist. + The reader is positioned on a node type that does not translate to a valid DOM node (for example, EndElement or EndEntity). Saves the XML document to the specified stream. @@ -4202,6 +4213,14 @@ This field was added in .NET Framework 2.0. The to which you want to save. The operation would not result in a well formed XML document (for example, no document element or duplicate XML declarations). + + Returns the Post-Schema-Validation-Infoset (PSVI) of the node. + The object representing the PSVI of the node. + + + Gets or sets the object associated with this . + An object containing the XML Schema Definition Language (XSD) schemas associated with this ; otherwise, an empty object. + Validates the against the XML Schema Definition Language (XSD) schemas contained in the property. The object that receives information about schema validation warnings and errors. @@ -4223,80 +4242,11 @@ This field was added in .NET Framework 2.0. Saves the node to the specified . The to which you want to save. - - Gets the base URI of the current node. - The location from which the node was loaded. - - - Gets the root for the document. - The that represents the root of the XML document tree. If no root exists, is returned. - - - Gets the node containing the DOCTYPE declaration. - The containing the DocumentType (DOCTYPE declaration). - - - Gets the object for the current document. - The object for the current document. - - - Throws an in all cases. - In all cases. - The values of the node and all its child nodes. - - - Gets or sets the markup representing the children of the current node. - The XML specified when setting this property is not well-formed. - The markup of the children of the current node. - - - Gets a value indicating whether the current node is read-only. - - if the current node is read-only; otherwise . nodes always return . - - - Gets the local name of the node. - For nodes, the local name is #document. - - - Gets the qualified name of the node. - For nodes, the name is #document. - - - Gets the associated with this implementation. - An enabling you to get the atomized version of a string within the document. - - - Gets the type of the current node. - The node type. For nodes, this value is XmlNodeType.Document. - - - Gets the to which the current node belongs. - For nodes ( equals XmlNodeType.Document), this property always returns . - - - Gets the parent node of this node (for nodes that can have parents). - Always returns . - - - Gets or sets a value indicating whether to preserve white space in element content. - - to preserve white space; otherwise . The default is . - - - Returns the Post-Schema-Validation-Infoset (PSVI) of the node. - The object representing the PSVI of the node. - - - Gets or sets the object associated with this . - An object containing the XML Schema Definition Language (XSD) schemas associated with this ; otherwise, an empty object. - Sets the to use for resolving external resources. + The to use. +In version 1.1 of the.NET Framework, the caller must be fully trusted in order to specify an . This property is set to and an external DTD or entity is encountered. - The to use. - - In version 1.1 of the.NET Framework, the caller must be fully trusted in order to specify an . Represents a lightweight object that is useful for tree insert operations. @@ -4311,18 +4261,10 @@ This field was added in .NET Framework 2.0. to recursively clone the subtree under the specified node; to clone only the node itself. The cloned node. - - Saves all the children of the node to the specified . - The to which you want to save. - - - Saves the node to the specified . - The to which you want to save. - Gets or sets the markup representing the children of this node. - The XML specified when setting this property is not well-formed. The markup of the children of this node. + The XML specified when setting this property is not well-formed. Gets the local name of the node. @@ -4342,9 +4284,16 @@ This field was added in .NET Framework 2.0. Gets the parent of this node (for nodes that can have parents). - The parent of this node. - - For nodes, this property is always . + The parent of this node. +For nodes, this property is always . + + + Saves all the children of the node to the specified . + The to which you want to save. + + + Saves the node to the specified . + The to which you want to save. Represents the document type declaration. @@ -4363,14 +4312,6 @@ This field was added in .NET Framework 2.0. to recursively clone the subtree under the specified node; to clone only the node itself. For document type nodes, the cloned node always includes the subtree, regardless of the parameter setting. The cloned node. - - Saves all the children of the node to the specified . For nodes, this method has no effect. - The to which you want to save. - - - Saves the node to the specified . - The to which you want to save. - Gets the collection of nodes declared in the document type declaration. An containing the nodes. The returned is read-only. @@ -4382,9 +4323,8 @@ This field was added in .NET Framework 2.0. Gets a value indicating whether the node is read-only. - if the node is read-only; otherwise, . - - Because DocumentType nodes are read-only, this property always returns . + if the node is read-only; otherwise, . +Because DocumentType nodes are read-only, this property always returns . Gets the local name of the node. @@ -4410,16 +4350,29 @@ This field was added in .NET Framework 2.0. Gets the value of the system identifier on the DOCTYPE declaration. The system identifier on the DOCTYPE. If there is no system identifier, is returned. - - Represents an element. + + Saves all the children of the node to the specified . For nodes, this method has no effect. + The to which you want to save. - + + Saves the node to the specified . + The to which you want to save. + + + Represents an element. + + Initializes a new instance of the class. The namespace prefix; see the property. The local name; see the property. The namespace URI; see the property. The parent XML document. + + Gets an containing the list of attributes for this node. + + containing the list of attributes for this node. + Creates a duplicate of this node. @@ -4472,6 +4425,64 @@ This field was added in .NET Framework 2.0. if the current node has the specified attribute; otherwise, . + + Gets a value indicating whether the current node has any attributes. + + if the current node has attributes; otherwise, . + + + Gets or sets the concatenated values of the node and all its children. + The concatenated values of the node and all its children. + + + Gets or sets the markup representing just the children of this node. + The markup of the children of this node. + The XML specified when setting this property is not well-formed. + + + Gets or sets the tag format of the element. + + if the element is to be serialized in the short tag format "<item/>"; for the long format "<item></item>". +When setting this property, if set to , the children of the element are removed and the element is serialized in the short tag format. If set to , the value of the property is changed (regardless of whether or not the element has content); if the element is empty, it is serialized in the long format. +This property is a Microsoft extension to the Document Object Model (DOM). + + + Gets the local name of the current node. + The name of the current node with the prefix removed. For example, is book for the element <bk:book>. + + + Gets the qualified name of the node. + The qualified name of the node. For nodes, this is the tag name of the element. + + + Gets the namespace URI of this node. + The namespace URI of this node. If there is no namespace URI, this property returns String.Empty. + + + Gets the immediately following this element. + The immediately following this element. + + + Gets the type of the current node. + The node type. For nodes, this value is XmlNodeType.Element. + + + Gets the to which this node belongs. + The to which this element belongs. + + + Gets the parent of this node (for nodes that can have parents). + The that is the parent of the current node. If a node has just been created and not yet added to the tree, or if it has been removed from the tree, the parent is . For all other nodes, the value returned depends on the of the node. The following table describes the possible return values for the property. + + + Gets or sets the namespace prefix of this node. + The namespace prefix of this node. If there is no prefix, this property returns String.Empty. + This node is read-only + The specified prefix contains an invalid character. +The specified prefix is malformed. +The namespaceURI of this node is . +The specified prefix is "xml" and the namespaceURI of this node is different from http://www.w3.org/XML/1998/namespace. + Removes all specified attributes and children of the current node. Default attributes are not removed. @@ -4480,7 +4491,7 @@ This field was added in .NET Framework 2.0. Removes an attribute by name. - The name of the attribute to remove. This is a qualified name. It is matched against the property of the matching node. + The name of the attribute to remove.This is a qualified name. It is matched against the property of the matching node. The node is read-only. @@ -4498,14 +4509,18 @@ This field was added in .NET Framework 2.0. Removes the specified by the local name and namespace URI. (If the removed attribute has a default value, it is immediately replaced). The local name of the attribute. The namespace URI of the attribute. - This node is read-only. The removed or if the does not have a matching attribute node. + This node is read-only. Removes the specified . The node to remove. If the removed attribute has a default value, it is immediately replaced. - This node is read-only. The removed or if is not an attribute node of the . + This node is read-only. + + + Gets the post schema validation infoset that has been assigned to this node as a result of schema validation. + An object containing the post schema validation infoset of this node. Sets the value of the attribute with the specified name. @@ -4530,9 +4545,9 @@ This field was added in .NET Framework 2.0. Adds the specified . The node to add to the attribute collection for this element. + If the attribute replaces an existing attribute with the same name, the old is returned; otherwise, is returned. The was created from a different document than the one that created this node. Or this node is read-only. The is already an attribute of another object. You must explicitly clone nodes to re-use them in other objects. - If the attribute replaces an existing attribute with the same name, the old is returned; otherwise, is returned. Saves all the children of the node to the specified . @@ -4542,116 +4557,35 @@ This field was added in .NET Framework 2.0. Saves the current node to the specified . The to which you want to save. - - Gets an containing the list of attributes for this node. - - containing the list of attributes for this node. - - - Gets a value indicating whether the current node has any attributes. - - if the current node has attributes; otherwise, . - - - Gets or sets the concatenated values of the node and all its children. - The concatenated values of the node and all its children. - - - Gets or sets the markup representing just the children of this node. - The XML specified when setting this property is not well-formed. - The markup of the children of this node. - - - Gets or sets the tag format of the element. - - if the element is to be serialized in the short tag format "<item/>"; for the long format "<item></item>". - - When setting this property, if set to , the children of the element are removed and the element is serialized in the short tag format. If set to , the value of the property is changed (regardless of whether or not the element has content); if the element is empty, it is serialized in the long format. - - This property is a Microsoft extension to the Document Object Model (DOM). - - - Gets the local name of the current node. - The name of the current node with the prefix removed. For example, is book for the element <bk:book>. - - - Gets the qualified name of the node. - The qualified name of the node. For nodes, this is the tag name of the element. - - - Gets the namespace URI of this node. - The namespace URI of this node. If there is no namespace URI, this property returns String.Empty. - - - Gets the immediately following this element. - The immediately following this element. - - - Gets the type of the current node. - The node type. For nodes, this value is XmlNodeType.Element. - - - Gets the to which this node belongs. - The to which this element belongs. - - - Gets the parent of this node (for nodes that can have parents). - The that is the parent of the current node. If a node has just been created and not yet added to the tree, or if it has been removed from the tree, the parent is . For all other nodes, the value returned depends on the of the node. The following table describes the possible return values for the property. - - - Gets or sets the namespace prefix of this node. - This node is read-only. - The specified prefix contains an invalid character. - - The specified prefix is malformed. - - The namespaceURI of this node is . - - The specified prefix is "xml" and the namespaceURI of this node is different from http://www.w3.org/XML/1998/namespace. - The namespace prefix of this node. If there is no prefix, this property returns String.Empty. - - - Gets the post schema validation infoset that has been assigned to this node as a result of schema validation. - An object containing the post schema validation infoset of this node. - Represents an entity declaration, such as <!ENTITY... >. + + Gets the base Uniform Resource Identifier (URI) of the current node. + The location from which the node was loaded. + Creates a duplicate of this node. Entity nodes cannot be cloned. Calling this method on an object throws an exception. to recursively clone the subtree under the specified node; to clone only the node itself. - Entity nodes cannot be cloned. Calling this method on an object throws an exception. A copy of the from which the method is called. - - - Saves all the children of the node to the specified . For nodes, this method has no effect. - The to which you want to save. - - - Saves the node to the specified . For nodes, this method has no effect. - The to which you want to save. - - - Gets the base Uniform Resource Identifier (URI) of the current node. - The location from which the node was loaded. + Entity nodes cannot be cloned. Calling this method on an object throws an exception. Gets the concatenated values of the entity node and all its children. - Attempting to set the property. The concatenated values of the node and all its children. + Attempting to set the property. Gets the markup representing the children of this node. - Attempting to set the property. For nodes, String.Empty is returned. + Attempting to set the property. Gets a value indicating whether the node is read-only. - if the node is read-only; otherwise, . - - Because nodes are read-only, this property always returns . + if the node is read-only; otherwise, . +Because nodes are read-only, this property always returns . Gets the name of the node without the namespace prefix. @@ -4681,6 +4615,14 @@ This field was added in .NET Framework 2.0. Gets the value of the system identifier on the entity declaration. The system identifier on the entity. If there is no system identifier, is returned. + + Saves all the children of the node to the specified . For nodes, this method has no effect. + The to which you want to save. + + + Saves the node to the specified . For nodes, this method has no effect. + The to which you want to save. + Represents an entity reference node. @@ -4689,30 +4631,21 @@ This field was added in .NET Framework 2.0. The name of the entity reference; see the property. The parent XML document. + + Gets the base Uniform Resource Identifier (URI) of the current node. + The location from which the node was loaded. + Creates a duplicate of this node. to recursively clone the subtree under the specified node; to clone only the node itself. For nodes, this method always returns an entity reference node with no children. The replacement text is set when the node is inserted into a parent. The cloned node. - - Saves all the children of the node to the specified . - The to which you want to save. - - - Saves the node to the specified . - The to which you want to save. - - - Gets the base Uniform Resource Identifier (URI) of the current node. - The location from which the node was loaded. - Gets a value indicating whether the node is read-only. - if the node is read-only; otherwise . - - Because nodes are read-only, this property always returns . + if the node is read-only; otherwise . +Because nodes are read-only, this property always returns . Gets the local name of the node. @@ -4728,9 +4661,17 @@ This field was added in .NET Framework 2.0. Gets or sets the value of the node. + The value of the node. For nodes, this property returns . Node is read-only. Setting the property. - The value of the node. For nodes, this property returns . + + + Saves all the children of the node to the specified . + The to which you want to save. + + + Saves the node to the specified . + The to which you want to save. Returns detailed information about the last exception. @@ -4765,11 +4706,11 @@ This field was added in .NET Framework 2.0. The object. - Gets the line number indicating where the error occurred. Line numbers start at 1. + Gets the line number indicating where the error occurred. The line number indicating where the error occurred. - Gets the line position indicating where the error occurred. Line position starts at 1. + Gets the line position indicating where the error occurred. The line position indicating where the error occurred. @@ -4799,11 +4740,19 @@ This field was added in .NET Framework 2.0. The package name of the feature to test. This name is not case-sensitive. This is the version number of the package name to test. If the version is not specified (), supporting any version of the feature causes the method to return . - if the feature is implemented in the specified version; otherwise, . - - The following table shows the combinations that cause to return . - - strFeature strVersion XML 1.0 XML 2.0 + if the feature is implemented in the specified version; otherwise, . +The following table shows the combinations that cause to return . + strFeature + + strVersion + + XML + + 1.0 + + XML + + 2.0 Gets the node immediately preceding or following this node. @@ -4819,6 +4768,10 @@ This field was added in .NET Framework 2.0. Represents a collection of nodes that can be accessed by name or index. + + Gets the number of nodes in the . + The number of nodes. + Provides support for the "foreach" style iteration over the collection of nodes in the . An enumerator object. @@ -4853,12 +4806,8 @@ This field was added in .NET Framework 2.0. Adds an using its property. An to store in the . If a node with that name is already present in the map, it is replaced by the new one. - The was created from a different than the one that created the ; or the is read-only. If the replaces an existing node with the same name, the old node is returned; otherwise, is returned. - - - Gets the number of nodes in the . - The number of nodes. + The was created from a different than the one that created the ; or the is read-only. Resolves, adds, and removes namespaces to a collection and provides scope management for these namespaces. @@ -4867,17 +4816,20 @@ This field was added in .NET Framework 2.0. Initializes a new instance of the class with the specified . The to use. - is passed to the constructor. + is passed to the constructor Adds the given namespace to the collection. - The prefix to associate with the namespace being added. Use String.Empty to add a default namespace. - - Note If the will be used for resolving namespaces in an XML Path Language (XPath) expression, a prefix must be specified. If an XPath expression does not include a prefix, it is assumed that the namespace Uniform Resource Identifier (URI) is the empty namespace. For more information about XPath expressions and the , refer to the and methods. + The prefix to associate with the namespace being added. Use String.Empty to add a default namespace. +NoteIf the will be used for resolving namespaces in an XML Path Language (XPath) expression, a prefix must be specified. If an XPath expression does not include a prefix, it is assumed that the namespace Uniform Resource Identifier (URI) is the empty namespace. For more information about XPath expressions and the , refer to the and methods. The namespace to add. The value for is "xml" or "xmlns". The value for or is . + + Gets the namespace URI for the default namespace. + The namespace URI for the default namespace, or an empty string if there is no default namespace. + Returns an enumerator to use to iterate through the namespaces in the . An containing the prefixes stored by the . @@ -4896,15 +4848,18 @@ This field was added in .NET Framework 2.0. Gets the namespace URI for the specified prefix. The prefix whose namespace URI you want to resolve. To match the default namespace, pass String.Empty. - The namespace URI for or if there is no mapped namespace. The returned string is atomized. - - For more information on atomized strings, see the class. + The namespace URI for or if there is no mapped namespace. The returned string is atomized. +For more information on atomized strings, see the class. Finds the prefix declared for the given namespace URI. The namespace to resolve for the prefix. The matching prefix. If there is no mapped prefix, the method returns String.Empty. If a null value is supplied, then is returned. + + Gets the associated with this object. + The used by this object. + Pops a namespace scope off the stack. @@ -4915,18 +4870,10 @@ This field was added in .NET Framework 2.0. Removes the given namespace for the given prefix. - The prefix for the namespace. + The prefix for the namespace The namespace to remove for the given prefix. The namespace removed is from the current namespace scope. Namespaces outside the current scope are ignored. The value of or is . - - Gets the namespace URI for the default namespace. - The namespace URI for the default namespace, or an empty string if there is no default namespace. - - - Gets the associated with this object. - The used by this object. - Defines the namespace scope. @@ -4950,54 +4897,44 @@ This field was added in .NET Framework 2.0. The character array containing the name to add. Zero-based index into the array specifying the first character of the name. The number of characters in the name. - 0 > - - -or- - - >= .Length - - -or- - - > .Length - - The above conditions do not cause an exception to be thrown if =0. + The new atomized string or the existing one if it already exists. If length is zero, String.Empty is returned. + 0 > +-or- + >= .Length +-or- + > .Length +The above conditions do not cause an exception to be thrown if =0. < 0. - The new atomized string or the existing one if it already exists. If length is zero, String.Empty is returned. When overridden in a derived class, atomizes the specified string and adds it to the . The name to add. + The new atomized string or the existing one if it already exists. is . - The new atomized string or the existing one if it already exists. When overridden in a derived class, gets the atomized string containing the same characters as the specified range of characters in the given array. The character array containing the name to look up. The zero-based index into the array specifying the first character of the name. The number of characters in the name. - 0 > - - -or- - - >= .Length - - -or- - - > .Length - - The above conditions do not cause an exception to be thrown if =0. + The atomized string or if the string has not already been atomized. If is zero, String.Empty is returned. + 0 > +-or- + >= .Length +-or- + > .Length +The above conditions do not cause an exception to be thrown if =0. < 0. - The atomized string or if the string has not already been atomized. If is zero, String.Empty is returned. When overridden in a derived class, gets the atomized string containing the same value as the specified string. The name to look up. + The atomized string or if the string has not already been atomized. is . - The atomized string or if the string has not already been atomized. Represents a single node in the XML document. @@ -5005,29 +4942,45 @@ This field was added in .NET Framework 2.0. Adds the specified node to the end of the list of child nodes, of this node. The node to add. All the contents of the node to be added are moved into the specified location. - This node is of a type that does not allow child nodes of the type of the node. - - The is an ancestor of this node. - The was created from a different document than the one that created this node. - - This node is read-only. The node added. + This node is of a type that does not allow child nodes of the type of the node. +The is an ancestor of this node. + The was created from a different document than the one that created this node. +This node is read-only. + + + Gets an containing the attributes of this node. + An containing the attributes of the node. +If the node is of type XmlNodeType.Element, the attributes of the node are returned. Otherwise, this property returns . + + + Gets the base URI of the current node. + The location from which the node was loaded or String.Empty if the node has no base URI. + + + Gets all the child nodes of the node. + An object that contains all the child nodes of the node. +If there are no child nodes, this property returns an empty . + + + Creates a duplicate of this node. + The cloned node. - - Creates a duplicate of this node. - The cloned node. - Creates a duplicate of the node, when overridden in a derived class. to recursively clone the subtree under the specified node; to clone only the node itself. - Calling this method on a node type that cannot be cloned. The cloned node. + Calling this method on a node type that cannot be cloned. Creates an for navigating this object. An object used to navigate the node. The is positioned on the node from which the method was called. It is not positioned on the root of the document. + + Gets the first child of the node. + The first child of the node. If there is no such node, is returned. + Gets an enumerator that iterates through the child nodes in the current node. An object that can be used to iterate through the child nodes in the current node. @@ -5042,47 +4995,289 @@ This field was added in .NET Framework 2.0. The namespace URI whose prefix you want to find. The prefix for the specified namespace URI. + + Gets a value indicating whether this node has any child nodes. + + if the node has child nodes; otherwise, . + + + Gets or sets the concatenated values of the node and all its child nodes. + The concatenated values of the node and all its child nodes. + + + Gets or sets the markup representing only the child nodes of this node. + The markup of the child nodes of this node. + does not return default attributes. + Setting this property on a node that cannot have child nodes. + The XML specified when setting this property is not well-formed. + Inserts the specified node immediately after the specified reference node. The node to insert. The reference node. is placed after . - This node is of a type that does not allow child nodes of the type of the node. - - The is an ancestor of this node. - The was created from a different document than the one that created this node. - - The is not a child of this node. - - This node is read-only. The node being inserted. + This node is of a type that does not allow child nodes of the type of the node. +The is an ancestor of this node. + The was created from a different document than the one that created this node. +The is not a child of this node. +This node is read-only. Inserts the specified node immediately before the specified reference node. The node to insert. The reference node. is placed before this node. - The current node is of a type that does not allow child nodes of the type of the node. + The node being inserted. + The current node is of a type that does not allow child nodes of the type of the node. +The is an ancestor of this node. + The was created from a different document than the one that created this node. +The is not a child of this node. +This node is read-only. + + + Gets a value indicating whether the node is read-only. + + if the node is read-only; otherwise, . + + + Gets the first child element with the specified . + The qualified name of the element to retrieve. + The first that matches the specified name. It returns a null reference ( in Visual Basic) if there is no match. + + + Gets the first child element with the specified and . + The local name of the element. + The namespace URI of the element. + The first with the matching and . . It returns a null reference ( in Visual Basic) if there is no match. + + + Gets the last child of the node. + The last child of the node. If there is no such node, is returned. + + + Gets the local name of the node, when overridden in a derived class. + The name of the node with the prefix removed. For example, is book for the element <bk:book>. +The name returned is dependent on the of the node: + Type - The is an ancestor of this node. - The was created from a different document than the one that created this node. + Name - The is not a child of this node. + Attribute - This node is read-only. - The node being inserted. + The local name of the attribute. + + CDATA + + #cdata-section + + Comment + + #comment + + Document + + #document + + DocumentFragment + + #document-fragment + + DocumentType + + The document type name. + + Element + + The local name of the element. + + Entity + + The name of the entity. + + EntityReference + + The name of the entity referenced. + + Notation + + The notation name. + + ProcessingInstruction + + The target of the processing instruction. + + Text + + #text + + Whitespace + + #whitespace + + SignificantWhitespace + + #significant-whitespace + + XmlDeclaration + + #xml-declaration + + + Gets the qualified name of the node, when overridden in a derived class. + The qualified name of the node. The name returned is dependent on the of the node: + Type + + Name + + Attribute + + The qualified name of the attribute. + + CDATA + + #cdata-section + + Comment + + #comment + + Document + + #document + + DocumentFragment + + #document-fragment + + DocumentType + + The document type name. + + Element + + The qualified name of the element. + + Entity + + The name of the entity. + + EntityReference + + The name of the entity referenced. + + Notation + + The notation name. + + ProcessingInstruction + + The target of the processing instruction. + + Text + + #text + + Whitespace + + #whitespace + + SignificantWhitespace + + #significant-whitespace + + XmlDeclaration + + #xml-declaration + + + Gets the namespace URI of this node. + The namespace URI of this node. If there is no namespace URI, this property returns String.Empty. + + + Gets the node immediately following this node. + The next . If there is no next node, is returned. + + + Gets the type of the current node, when overridden in a derived class. + One of the values. Puts all XmlText nodes in the full depth of the sub-tree underneath this XmlNode into a "normal" form where only markup (that is, tags, comments, processing instructions, CDATA sections, and entity references) separates XmlText nodes, that is, there are no adjacent XmlText nodes. + + Gets the markup containing this node and all its child nodes. + The markup containing this node and all its child nodes. + does not return default attributes. + + + Gets the to which this node belongs. + The to which this node belongs. +If the node is an (NodeType equals XmlNodeType.Document), this property returns . + + + Gets the parent of this node (for nodes that can have parents). + The that is the parent of the current node. If a node has just been created and not yet added to the tree, or if it has been removed from the tree, the parent is . For all other nodes, the value returned depends on the of the node. The following table describes the possible return values for the property. + NodeType + + Return Value of ParentNode + + Attribute, Document, DocumentFragment, Entity, Notation + + Returns ; these nodes do not have parents. + + CDATA + + Returns the element or entity reference containing the CDATA section. + + Comment + + Returns the element, entity reference, document type, or document containing the comment. + + DocumentType + + Returns the document node. + + Element + + Returns the parent node of the element. If the element is the root node in the tree, the parent is the document node. + + EntityReference + + Returns the element, attribute, or entity reference containing the entity reference. + + ProcessingInstruction + + Returns the document, element, document type, or entity reference containing the processing instruction. + + Text + + Returns the parent element, attribute, or entity reference containing the text node. + + + Gets or sets the namespace prefix of this node. + The namespace prefix of this node. For example, is bk for the element <bk:book>. If there is no prefix, this property returns String.Empty. + This node is read-only. + The specified prefix contains an invalid character. +The specified prefix is malformed. +The specified prefix is "xml" and the namespaceURI of this node is different from "http://www.w3.org/XML/1998/namespace". +This node is an attribute and the specified prefix is "xmlns" and the namespaceURI of this node is different from "http://www.w3.org/2000/xmlns/ ". +This node is an attribute and the qualifiedName of this node is "xmlns". + Adds the specified node to the beginning of the list of child nodes for this node. The node to add. All the contents of the node to be added are moved into the specified location. - This node is of a type that does not allow child nodes of the type of the node. - - The is an ancestor of this node. - The was created from a different document than the one that created this node. - - This node is read-only. The node added. + This node is of a type that does not allow child nodes of the type of the node. +The is an ancestor of this node. + The was created from a different document than the one that created this node. +This node is read-only. + + + Gets the node immediately preceding this node. + The preceding . If there is no preceding node, is returned. + + + Gets the text node that immediately precedes this node. + Returns . Removes all the child nodes and/or attributes of the current node. @@ -5090,57 +5285,67 @@ This field was added in .NET Framework 2.0. Removes specified child node. The node being removed. - The is not a child of this node. Or this node is read-only. The node removed. + The is not a child of this node. Or this node is read-only. Replaces the child node with node. The new node to put in the child list. The node being replaced in the list. - This node is of a type that does not allow child nodes of the type of the node. - - The is an ancestor of this node. - The was created from a different document than the one that created this node. - - This node is read-only. - - The is not a child of this node. The node replaced. + This node is of a type that does not allow child nodes of the type of the node. +The is an ancestor of this node. + The was created from a different document than the one that created this node. +This node is read-only. +The is not a child of this node. + + + Gets the post schema validation infoset that has been assigned to this node as a result of schema validation. + An object containing the post schema validation infoset of this node. Selects a list of nodes matching the XPath expression. The XPath expression. - The XPath expression contains a prefix. See XPath Examples. An containing a collection of nodes matching the XPath query. + The XPath expression contains a prefix. See XPath Examples. Selects a list of nodes matching the XPath expression. Any prefixes found in the XPath expression are resolved using the supplied . The XPath expression. See XPath Examples. An to use for resolving namespaces for prefixes in the XPath expression. - The XPath expression contains a prefix which is not defined in the . An containing a collection of nodes matching the XPath query. + The XPath expression contains a prefix which is not defined in the . Selects the first that matches the XPath expression. The XPath expression. See XPath Examples. - The XPath expression contains a prefix. The first that matches the XPath query or if no matching node is found. + The XPath expression contains a prefix. Selects the first that matches the XPath expression. Any prefixes found in the XPath expression are resolved using the supplied . The XPath expression. See XPath Examples. An to use for resolving namespaces for prefixes in the XPath expression. - The XPath expression contains a prefix which is not defined in the . The first that matches the XPath query or if no matching node is found. + The XPath expression contains a prefix which is not defined in the . Tests if the DOM implementation implements a specific feature. The package name of the feature to test. This name is not case-sensitive. The version number of the package name to test. If the version is not specified (null), supporting any version of the feature causes the method to return true. - if the feature is implemented in the specified version; otherwise, . The following table describes the combinations that return . - - Feature Version XML 1.0 XML 2.0 + if the feature is implemented in the specified version; otherwise, . The following table describes the combinations that return . + Feature + + Version + + XML + + 1.0 + + XML + + 2.0 For a description of this member, see . @@ -5150,144 +5355,82 @@ This field was added in .NET Framework 2.0. For a description of this member, see . A copy of the node from which it is called. - - Saves all the child nodes of the node to the specified , when overridden in a derived class. - The to which you want to save. - - - Saves the current node to the specified , when overridden in a derived class. - The to which you want to save. - - - Gets an containing the attributes of this node. - An containing the attributes of the node. + + Gets or sets the value of the node. + The value returned depends on the of the node: + Type - If the node is of type XmlNodeType.Element, the attributes of the node are returned. Otherwise, this property returns . - - - Gets the base URI of the current node. - The location from which the node was loaded or String.Empty if the node has no base URI. - - - Gets all the child nodes of the node. - An object that contains all the child nodes of the node. + Value - If there are no child nodes, this property returns an empty . - - - Gets the first child of the node. - The first child of the node. If there is no such node, is returned. - - - Gets a value indicating whether this node has any child nodes. - - if the node has child nodes; otherwise, . - - - Gets or sets the concatenated values of the node and all its child nodes. - The concatenated values of the node and all its child nodes. - - - Gets or sets the markup representing only the child nodes of this node. - Setting this property on a node that cannot have child nodes. - The XML specified when setting this property is not well-formed. - The markup of the child nodes of this node, not including default attributes. - - - Gets a value indicating whether the node is read-only. - - if the node is read-only; otherwise, . - - - Gets the first child element with the specified . - The qualified name of the element to retrieve. - The first that matches the specified name. It returns a null reference ( in Visual Basic) if there is no match. - - - Gets the first child element with the specified and . - The local name of the element. - The namespace URI of the element. - The first with the matching and . It returns a null reference ( in Visual Basic) if there is no match. - - - Gets the last child of the node. - The last child of the node. If there is no such node, is returned. - - - Gets the local name of the node, when overridden in a derived class. - The name of the node with the prefix removed. For example, is book for the element <bk:book>. + Attribute - The name returned is dependent on the of the node: + The value of the attribute. - Type Name Attribute The local name of the attribute. CDATA #cdata-section Comment #comment Document #document DocumentFragment #document-fragment DocumentType The document type name. Element The local name of the element. Entity The name of the entity. EntityReference The name of the entity referenced. Notation The notation name. ProcessingInstruction The target of the processing instruction. Text #text Whitespace #whitespace SignificantWhitespace #significant-whitespace XmlDeclaration #xml-declaration - - - Gets the qualified name of the node, when overridden in a derived class. - The qualified name of the node. The name returned is dependent on the of the node: + CDATASection - Type Name Attribute The qualified name of the attribute. CDATA #cdata-section Comment #comment Document #document DocumentFragment #document-fragment DocumentType The document type name. Element The qualified name of the element. Entity The name of the entity. EntityReference The name of the entity referenced. Notation The notation name. ProcessingInstruction The target of the processing instruction. Text #text Whitespace #whitespace SignificantWhitespace #significant-whitespace XmlDeclaration #xml-declaration - - - Gets the namespace URI of this node. - The namespace URI of this node. If there is no namespace URI, this property returns String.Empty. - - - Gets the node immediately following this node. - The next . If there is no next node, is returned. - - - Gets the type of the current node, when overridden in a derived class. - One of the values. - - - Gets the markup containing this node and all its child nodes. - The markup containing this node and all its child nodes, not including default attributes. - - - Gets the to which this node belongs. - The to which this node belongs. + The content of the CDATA Section. + + Comment + + The content of the comment. + + Document + + . + + DocumentFragment + + . + + DocumentType + + . + + Element + + . You can use the or properties to access the value of the element node. + + Entity + + . + + EntityReference + + . + + Notation + + . + + ProcessingInstruction - If the node is an (NodeType equals XmlNodeType.Document), this property returns . - - - Gets the parent of this node (for nodes that can have parents). - The that is the parent of the current node. If a node has just been created and not yet added to the tree, or if it has been removed from the tree, the parent is . For all other nodes, the value returned depends on the of the node. The following table describes the possible return values for the property. + The entire content excluding the target. - NodeType Return Value of ParentNode Attribute, Document, DocumentFragment, Entity, Notation Returns ; these nodes do not have parents. CDATA Returns the element or entity reference containing the CDATA section. Comment Returns the element, entity reference, document type, or document containing the comment. DocumentType Returns the document node. Element Returns the parent node of the element. If the element is the root node in the tree, the parent is the document node. EntityReference Returns the element, attribute, or entity reference containing the entity reference. ProcessingInstruction Returns the document, element, document type, or entity reference containing the processing instruction. Text Returns the parent element, attribute, or entity reference containing the text node. - - - Gets or sets the namespace prefix of this node. - This node is read-only. - The specified prefix contains an invalid character. + Text - The specified prefix is malformed. + The content of the text node. - The specified prefix is "xml" and the namespaceURI of this node is different from "http://www.w3.org/XML/1998/namespace". + SignificantWhitespace - This node is an attribute and the specified prefix is "xmlns" and the namespaceURI of this node is different from "http://www.w3.org/2000/xmlns/ ". + The white space characters. White space can consist of one or more space characters, carriage returns, line feeds, or tabs. - This node is an attribute and the qualifiedName of this node is "xmlns". - The namespace prefix of this node. For example, is bk for the element <bk:book>. If there is no prefix, this property returns String.Empty. - - - Gets the node immediately preceding this node. - The preceding . If there is no preceding node, is returned. - - - Gets the text node that immediately precedes this node. - Returns . - - - Gets the post schema validation infoset that has been assigned to this node as a result of schema validation. - An object containing the post schema validation infoset of this node. - - - Gets or sets the value of the node. + Whitespace + + The white space characters. White space can consist of one or more space characters, carriage returns, line feeds, or tabs. + + XmlDeclaration + + The content of the declaration (that is, everything between <?xml and ?>). Setting the value of a node that is read-only. Setting the value of a node that is not supposed to have a value (for example, an Element node). - The value returned depends on the of the node: - - Type Value Attribute The value of the attribute. CDATASection The content of the CDATA Section. Comment The content of the comment. Document. DocumentFragment. DocumentType. Element. You can use the or properties to access the value of the element node. Entity. EntityReference. Notation. ProcessingInstruction The entire content excluding the target. Text The content of the text node. SignificantWhitespace The white space characters. White space can consist of one or more space characters, carriage returns, line feeds, or tabs. Whitespace The white space characters. White space can consist of one or more space characters, carriage returns, line feeds, or tabs. XmlDeclaration The content of the declaration (that is, everything between <?xml and ?>). + + + Saves all the child nodes of the node to the specified , when overridden in a derived class. + The to which you want to save. + + + Saves the current node to the specified , when overridden in a derived class. + The to which you want to save. Specifies the type of node change. @@ -5319,13 +5462,14 @@ This field was added in .NET Framework 2.0. Gets the value of the after the operation completes. - The value of the after the operation completes. This property returns if the node is being removed. For attribute nodes, this property returns the . + The value of the after the operation completes. This property returns if the node is being removed. + +For attribute nodes this property returns the . Gets the new value of the node. - The new value of the node. This property returns if the node is neither an attribute nor a text node, or if the node is being removed. - - If called in a event, returns the value of the node if the change is successful. If called in a event, returns the current value of the node. + The new value of the node. This property returns if the node is neither an attribute nor a text node, or if the node is being removed. +If called in a event, returns the value of the node if the change is successful. If called in a event, returns the current value of the node. Gets the that is being added, removed or changed. @@ -5333,13 +5477,14 @@ This field was added in .NET Framework 2.0. Gets the value of the before the operation began. - The value of the before the operation began. This property returns if the node did not have a parent. For attribute nodes, this property returns the . + The value of the before the operation began. This property returns if the node did not have a parent. + +For attribute nodes this property returns the . Gets the original value of the node. - The original value of the node. This property returns if the node is neither an attribute nor a text node, or if the node is being inserted. - - If called in a event, returns the current value of the node that will be replaced if the change is successful. If called in a event, returns the value of node prior to the change. + The original value of the node. This property returns if the node is neither an attribute nor a text node, or if the node is being inserted. +If called in a event, returns the current value of the node that will be replaced if the change is successful. If called in a event, returns the value of node prior to the change. Represents the method that handles , , , , and events. @@ -5352,6 +5497,10 @@ This field was added in .NET Framework 2.0. Initializes a new instance of the class. + + Gets the number of nodes in the . + The number of nodes in the . + Gets an enumerator that iterates through the collection of nodes. An enumerator used to iterate through the collection of nodes. @@ -5361,21 +5510,17 @@ This field was added in .NET Framework 2.0. The zero-based index into the list of nodes. The with the specified index in the collection. If is greater than or equal to the number of nodes in the list, this returns . + + Gets a node at the given index. + The zero-based index into the list of nodes. + The with the specified index in the collection. If index is greater than or equal to the number of nodes in the list, this returns . + Disposes resources in the node list privately. Releases all resources used by the class. - - Gets the number of nodes in the . - The number of nodes in the . - - - Gets a node at the given index. - The zero-based index into the list of nodes. - The with the specified index in the collection. If index is greater than or equal to the number of nodes in the list, this returns . - Describes the document order of a node compared to a second node. @@ -5398,14 +5543,41 @@ This field was added in .NET Framework 2.0. Creates an instance of the class using the specified . The you want to read. + + Gets the number of attributes on the current node. + The number of attributes on the current node. This number includes default attributes. + + + Gets the base URI of the current node. + The base URI of the current node. + + + Gets a value indicating whether the implements the binary content read methods. + + if the binary content read methods are implemented; otherwise . The class always returns . + + + Gets a value indicating whether this reader can parse and resolve entities. + + if the reader can parse and resolve entities; otherwise, . always returns . + Changes the to . + + Gets the depth of the current node in the XML document. + The depth of the current node in the XML document. + + + Gets a value indicating whether the reader is positioned at the end of the stream. + + if the reader is positioned at the end of the stream; otherwise, . + Gets the value of the attribute with the specified index. The index of the attribute. The index is zero-based. (The first attribute has index 0.) - The parameter is less than 0 or greater than or equal to . The value of the specified attribute. + The parameter is less than 0 or greater than or equal to . Gets the value of the attribute with the specified name. @@ -5418,6 +5590,31 @@ This field was added in .NET Framework 2.0. The namespace URI of the attribute. The value of the specified attribute. If the attribute is not found, is returned. + + Gets a value indicating whether the current node has any attributes. + + if the current node has attributes; otherwise, . + + + Gets a value indicating whether the current node can have a . + + if the node on which the reader is currently positioned can have a ; otherwise, . + + + Gets a value indicating whether the current node is an attribute that was generated from the default value defined in the document type definition (DTD) or schema. + + if the current node is an attribute whose value was generated from the default value defined in the DTD or schema; if the attribute value was explicitly set. + + + Gets a value indicating whether the current node is an empty element (for example, <MyElement/>). + + if the current node is an element ( equals ) and it ends with />; otherwise, . + + + Gets the local name of the current node. + The name of the current node with the prefix removed. For example, is for the element <bk:book>. +For node types that do not have a name (like , , and so on), this property returns String.Empty. + Resolves a namespace prefix in the current element's scope. The prefix whose namespace URI you want to resolve. To match the default namespace, pass an empty string. This string does not have to be atomized. @@ -5456,6 +5653,42 @@ This field was added in .NET Framework 2.0. if there is a next attribute; if there are no more attributes. + + Gets the qualified name of the current node. + The qualified name of the current node. For example, is for the element <bk:book>. +The name returned is dependent on the of the node. The following node types return the listed values. All other node types return an empty string. + Node Type + + Name + + The name of the attribute. + + The document type name. + + The tag name. + + The name of the entity referenced. + + The target of the processing instruction. + + The literal string . + + + Gets the namespace URI (as defined in the W3C Namespace specification) of the node on which the reader is positioned. + The namespace URI of the current node; otherwise an empty string. + + + Gets the associated with this implementation. + The enabling you to get the atomized version of a string within the node. + + + Gets the type of the current node. + One of the values representing the type of the current node. + + + Gets the namespace prefix associated with the current node. + The namespace prefix associated with the current node. + Reads the next node from the stream. @@ -5464,182 +5697,121 @@ This field was added in .NET Framework 2.0. Parses the attribute value into one or more , , or nodes. - if there are nodes to return. - - if the reader is not positioned on an attribute node when the initial call is made or if all the attribute values have been read. - - An empty attribute, such as, misc="", returns with a single node with a value of String.Empty. + if there are nodes to return. + if the reader is not positioned on an attribute node when the initial call is made or if all the attribute values have been read. +An empty attribute, such as, misc="", returns with a single node with a value of String.Empty. Reads the content and returns the Base64 decoded binary bytes. The buffer into which to copy the resulting text. This value cannot be . The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. The value is . is not supported on the current node. The index into the buffer or index + count is larger than the allocated buffer size. - The number of bytes written to the buffer. Reads the content and returns the BinHex decoded binary bytes. The buffer into which to copy the resulting text. This value cannot be . The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. The value is . is not supported on the current node. The index into the buffer or index + count is larger than the allocated buffer size. - The number of bytes written to the buffer. Reads the element and decodes the Base64 content. The buffer into which to copy the resulting text. This value cannot be . The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. - The value is . - The current node is not an element node. - The index into the buffer or index + count is larger than the allocated buffer size. - The element contains mixed content. - The content cannot be converted to the requested type. The number of bytes written to the buffer. - - - Reads the element and decodes the BinHex content. - The buffer into which to copy the resulting text. This value cannot be . - The offset into the buffer where to start copying the result. - The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. The value is . The current node is not an element node. - The index into the buffer or index + count is larger than the allocated buffer size. - The element contains mixed content. - The content cannot be converted to the requested type. - The number of bytes written to the buffer. - - - Reads the contents of an element or text node as a string. - The contents of the element or text-like node (This can include CDATA, Text nodes, and so on). This can be an empty string if the reader is positioned on something other than an element or text node, or if there is no more text content to return in the current context. - - The text node can be either an element or an attribute text node. - - - Resolves the entity reference for nodes. - The reader is not positioned on an node. - - - Skips the children of the current node. - - - For a description of this member, see . - - object. - - object that contains the namespaces that are in scope. - - - For a description of this member, see . - - that contains the namespace prefix. - - that contains the namespace name. - - - For a description of this member, see . - - object that identifies the namespace. - - object that contains the namespace prefix. - - - Gets the number of attributes on the current node. - The number of attributes on the current node. This number includes default attributes. - - - Gets the base URI of the current node. - The base URI of the current node. - - - Gets a value indicating whether the implements the binary content read methods. - - if the binary content read methods are implemented; otherwise . The class always returns . - - - Gets a value indicating whether this reader can parse and resolve entities. - - if the reader can parse and resolve entities; otherwise, . always returns . - - - Gets the depth of the current node in the XML document. - The depth of the current node in the XML document. - - - Gets a value indicating whether the reader is positioned at the end of the stream. - - if the reader is positioned at the end of the stream; otherwise, . - - - Gets a value indicating whether the current node has any attributes. - - if the current node has attributes; otherwise, . - - - Gets a value indicating whether the current node can have a . - - if the node on which the reader is currently positioned can have a ; otherwise, . - - - Gets a value indicating whether the current node is an attribute that was generated from the default value defined in the document type definition (DTD) or schema. - - if the current node is an attribute whose value was generated from the default value defined in the DTD or schema; if the attribute value was explicitly set. - - - Gets a value indicating whether the current node is an empty element (for example, <MyElement/>). - - if the current node is an element ( equals ) and it ends with />; otherwise, . - - - Gets the local name of the current node. - The name of the current node with the prefix removed. For example, is for the element <bk:book>. - - For node types that do not have a name (like , , and so on), this property returns String.Empty. - - - Gets the qualified name of the current node. - The qualified name of the current node. For example, is for the element <bk:book>. - - The name returned is dependent on the of the node. The following node types return the listed values. All other node types return an empty string. - - Node Type Name The name of the attribute. The document type name. The tag name. The name of the entity referenced. The target of the processing instruction. The literal string . - - - Gets the namespace URI (as defined in the W3C Namespace specification) of the node on which the reader is positioned. - The namespace URI of the current node; otherwise an empty string. - - - Gets the associated with this implementation. - The enabling you to get the atomized version of a string within the node. - - - Gets the type of the current node. - One of the values representing the type of the current node. + The index into the buffer or index + count is larger than the allocated buffer size. + The element contains mixed content. + The content cannot be converted to the requested type. - - Gets the namespace prefix associated with the current node. - The namespace prefix associated with the current node. + + Reads the element and decodes the BinHex content. + The buffer into which to copy the resulting text. This value cannot be . + The offset into the buffer where to start copying the result. + The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. + The value is . + The current node is not an element node. + The index into the buffer or index + count is larger than the allocated buffer size. + The element contains mixed content. + The content cannot be converted to the requested type. Gets the state of the reader. One of the values. + + Reads the contents of an element or text node as a string. + The contents of the element or text-like node (This can include CDATA, Text nodes, and so on). This can be an empty string if the reader is positioned on something other than an element or text node, or if there is no more text content to return in the current context. + The text node can be either an element or an attribute text node. + + + Resolves the entity reference for nodes. + The reader is not positioned on an node. + Gets the schema information that has been assigned to the current node. An object containing the schema information for the current node. + + Skips the children of the current node. + + + For a description of this member, see . + + object. + + object that contains the namespaces that are in scope. + + + For a description of this member, see . + + that contains the namespace prefix. + + that contains the namespace name. + + + For a description of this member, see . + + object that identifies the namespace. + + object that contains the namespace prefix. + Gets the text value of the current node. - The value returned depends on the of the node. The following table lists node types that have a value to return. All other node types return String.Empty. + The value returned depends on the of the node. The following table lists node types that have a value to return. All other node types return String.Empty. + Node Type - Node Type Value The value of the attribute. The content of the CDATA section. The content of the comment. The internal subset. The entire content, excluding the target. The white space between markup in a mixed content model. The content of the text node. The white space between markup. The content of the declaration. + Value + + The value of the attribute. + + The content of the CDATA section. + + The content of the comment. + + The internal subset. + + The entire content, excluding the target. + + The white space between markup in a mixed content model. + + The content of the text node. + + The white space between markup. + + The content of the declaration. Gets the current scope. @@ -5698,19 +5870,13 @@ This field was added in .NET Framework 2.0. White space between markup in a mixed content model or white space within the xml:space="preserve" scope. - - The text content of a node. - A node cannot have any child nodes. It can appear as the child node of the , , , and nodes. - + The text content of a node. White space between markup. - - The XML declaration (for example, <?xml version='1.0'?> ). - The node must be the first node in the document. It cannot have children. It is a child of the node. It can have attributes that provide version and encoding information. - + The XML declaration (for example, <?xml version='1.0'?> ). Represents a notation declaration, such as <!NOTATION... >. @@ -5719,28 +5885,19 @@ This field was added in .NET Framework 2.0. Creates a duplicate of this node. Notation nodes cannot be cloned. Calling this method on an object throws an exception. to recursively clone the subtree under the specified node; to clone only the node itself. - Notation nodes cannot be cloned. Calling this method on an object throws an exception. A copy of the node from which the method is called. - - - Saves the children of the node to the specified . This method has no effect on nodes. - The to which you want to save. - - - Saves the node to the specified . This method has no effect on nodes. - The to which you want to save. + Notation nodes cannot be cloned. Calling this method on an object throws an exception. Gets the markup representing the children of this node. - Attempting to set the property. For nodes, String.Empty is returned. + Attempting to set the property. Gets a value indicating whether the node is read-only. - if the node is read-only; otherwise, . - - Because nodes are read-only, this property always returns . + if the node is read-only; otherwise, . +Because nodes are read-only, this property always returns . Gets the name of the current node without the namespace prefix. @@ -5766,6 +5923,14 @@ This field was added in .NET Framework 2.0. Gets the value of the system identifier on the notation declaration. The system identifier on the notation. If there is no system identifier, is returned. + + Saves the children of the node to the specified . This method has no effect on nodes. + The to which you want to save. + + + Saves the node to the specified . This method has no effect on nodes. + The to which you want to save. + Specifies the method used to serialize the output. @@ -5887,14 +6052,6 @@ This field was added in .NET Framework 2.0. to recursively clone the subtree under the specified node; to clone only the node itself. The duplicate node. - - Saves all the children of the node to the specified . Because ProcessingInstruction nodes do not have children, this method has no effect. - The to which you want to save. - - - Saves the node to the specified . - The to which you want to save. - Gets or sets the content of the processing instruction, excluding the target. The content of the processing instruction, excluding the target. @@ -5921,15 +6078,20 @@ This field was added in .NET Framework 2.0. Gets or sets the value of the node. - Node is read-only. The entire content of the processing instruction, excluding the target. + Node is read-only. + + + Saves all the children of the node to the specified . Because ProcessingInstruction nodes do not have children, this method has no effect. + The to which you want to save. + + + Saves the node to the specified . + The to which you want to save. Represents an XML qualified name. - - Provides an empty . - Initializes a new instance of the class. @@ -5942,6 +6104,9 @@ This field was added in .NET Framework 2.0. The local name to use as the name of the object. The namespace for the object. + + Provides an empty . + Determines whether the specified object is equal to the current object. The to compare. @@ -5952,6 +6117,19 @@ This field was added in .NET Framework 2.0. Returns the hash code for the . A hash code for this object. + + Gets a value indicating whether the is empty. + + if name and namespace are empty strings; otherwise, . + + + Gets a string representation of the qualified name of the . + A string representation of the qualified name or String.Empty if a name is not defined for the object. + + + Gets a string representation of the namespace of the . + A string representation of the namespace or String.Empty if a namespace is not defined for the object. + Compares two objects. An to compare. @@ -5976,154 +6154,168 @@ This field was added in .NET Framework 2.0. The namespace of the object. The string value of the in the format of . If the object does not have a namespace defined, this method returns just the local name. - - Gets a value indicating whether the is empty. - - if name and namespace are empty strings; otherwise, . - - - Gets a string representation of the qualified name of the . - A string representation of the qualified name or String.Empty if a name is not defined for the object. - - - Gets a string representation of the namespace of the . - A string representation of the namespace or String.Empty if a namespace is not defined for the object. - Represents a reader that provides fast, noncached, forward-only access to XML data. Initializes a new instance of the class. + + When overridden in a derived class, gets the number of attributes on the current node. + The number of attributes on the current node. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + When overridden in a derived class, gets the base URI of the current node. + The base URI of the current node. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + Gets a value indicating whether the implements the binary content read methods. + + if the binary content read methods are implemented; otherwise . + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + Gets a value indicating whether the implements the method. + + if the implements the method; otherwise . + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + Gets a value indicating whether this reader can parse and resolve entities. + + if the reader can parse and resolve entities; otherwise, . + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + When overridden in a derived class, changes the to . An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Creates a new instance using the specified stream with default settings. - The stream that contains the XML data. - - The scans the first bytes of the stream looking for a byte order mark or other sign of encoding. When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters. + The stream that contains the XML data. +The scans the first bytes of the stream looking for a byte order mark or other sign of encoding. When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters. + An object that is used to read the XML data in the stream. The value is . The does not have sufficient permissions to access the location of the XML data. - An object that is used to read the XML data in the stream. Creates a new instance with the specified stream and settings. - The stream that contains the XML data. - - The scans the first bytes of the stream looking for a byte order mark or other sign of encoding. When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters. + The stream that contains the XML data. +The scans the first bytes of the stream looking for a byte order mark or other sign of encoding. When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters. The settings for the new instance. This value can be . - The value is . An object that is used to read the XML data in the stream. + The value is . Creates a new instance using the specified stream, base URI, and settings. - The stream that contains the XML data. - - The scans the first bytes of the stream looking for a byte order mark or other sign of encoding. When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters. + The stream that contains the XML data. +The scans the first bytes of the stream looking for a byte order mark or other sign of encoding. When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters. The settings for the new instance. This value can be . - The base URI for the entity or document being read. This value can be . - - Security Note The base URI is used to resolve the relative URI of the XML document. Do not use a base URI from an untrusted source. - The value is . + The base URI for the entity or document being read. This value can be . +Security Note The base URI is used to resolve the relative URI of the XML document. Do not use a base URI from an untrusted source. An object that is used to read the XML data in the stream. + The value is . Creates a new instance using the specified stream, settings, and context information for parsing. - The stream that contains the XML data. - - The scans the first bytes of the stream looking for a byte order mark or other sign of encoding. When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters. + The stream that contains the XML data. +The scans the first bytes of the stream looking for a byte order mark or other sign of encoding. When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters. The settings for the new instance. This value can be . - The context information required to parse the XML fragment. The context information can include the to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition. - - This value can be . - The value is . + The context information required to parse the XML fragment. The context information can include the to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition. +This value can be . An object that is used to read the XML data in the stream. + The value is . Creates a new instance by using the specified text reader. The text reader from which to read the XML data. A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration is not used by the XML reader to decode the data stream. - The value is . An object that is used to read the XML data in the stream. + The value is . Creates a new instance by using the specified text reader and settings. The text reader from which to read the XML data. A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XML reader to decode the data stream. The settings for the new . This value can be . - The value is . An object that is used to read the XML data in the stream. + The value is . Creates a new instance by using the specified text reader, settings, and base URI. The text reader from which to read the XML data. A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the to decode the data stream. The settings for the new instance. This value can be . - The base URI for the entity or document being read. This value can be . - - Security Note The base URI is used to resolve the relative URI of the XML document. Do not use a base URI from an untrusted source. - The value is . + The base URI for the entity or document being read. This value can be . +Security Note The base URI is used to resolve the relative URI of the XML document. Do not use a base URI from an untrusted source. An object that is used to read the XML data in the stream. + The value is . Creates a new instance by using the specified text reader, settings, and context information for parsing. The text reader from which to read the XML data. A text reader returns a stream of Unicode characters, so the encoding specified in the XML declaration isn't used by the XML reader to decode the data stream. The settings for the new instance. This value can be . - The context information required to parse the XML fragment. The context information can include the to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition. - - This value can be . + The context information required to parse the XML fragment. The context information can include the to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition. +This value can be . + An object that is used to read the XML data in the stream. The value is . The and properties both contain values. (Only one of these properties can be set and used). - An object that is used to read the XML data in the stream. Creates a new instance with specified URI. The URI for the file that contains the XML data. The class is used to convert the path to a canonical data representation. + An object that is used to read the XML data in the stream. The value is . The does not have sufficient permissions to access the location of the XML data. The file identified by the URI does not exist. - The URI format is not correct. + In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, , instead. + -Note: In .NET for Windows Store apps or the Portable Class Library, catch the base class exception, , instead. - An object that is used to read the XML data in the stream. + + + The URI format is not correct. Creates a new instance by using the specified URI and settings. The URI for the file containing the XML data. The object on the object is used to convert the path to a canonical data representation. If is , a new object is used. The settings for the new instance. This value can be . + An object that is used to read the XML data in the stream. The value is . The file specified by the URI cannot be found. - The URI format is not correct. + In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, , instead. + -Note: In .NET for Windows Store apps or the Portable Class Library, catch the base class exception, , instead. - An object that is used to read the XML data in the stream. + + + The URI format is not correct. Creates a new instance by using the specified URI, settings, and context information for parsing. The URI for the file containing the XML data. The object on the object is used to convert the path to a canonical data representation. If is , a new object is used. The settings for the new instance. This value can be . - The context information required to parse the XML fragment. The context information can include the to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition. - - This value can be . + The context information required to parse the XML fragment. The context information can include the to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition. +This value can be . + An object that is used to read the XML data in the stream. The value is . The does not have sufficient permissions to access the location of the XML data. The and properties both contain values. (Only one of these properties can be set and used). The file specified by the URI cannot be found. The URI format is not correct. - An object that is used to read the XML data in the stream. Creates a new instance by using the specified XML reader and settings. The object that you want to use as the underlying XML reader. - The settings for the new instance. - - The conformance level of the object must either match the conformance level of the underlying reader, or it must be set to . - The value is . - If the object specifies a conformance level that is not consistent with conformance level of the underlying reader. - - -or- - - The underlying is in an or state. + The settings for the new instance. +The conformance level of the object must either match the conformance level of the underlying reader, or it must be set to . An object that is wrapped around the specified object. + The value is . + If the object specifies a conformance level that is not consistent with conformance level of the underlying reader. +-or- +The underlying is in an or state. + + + When overridden in a derived class, gets the depth of the current node in the XML document. + The depth of the current node in the XML document. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Releases all resources used by the current instance of the class. @@ -6135,83 +6327,136 @@ Note: In .NET for Windows Store apps or the Portable Class Library, catch the ba to release both managed and unmanaged resources; to release only unmanaged resources. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + When overridden in a derived class, gets a value indicating whether the reader is positioned at the end of the stream. + + if the reader is positioned at the end of the stream; otherwise, . + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + When overridden in a derived class, gets the value of the attribute with the specified index. The index of the attribute. The index is zero-based. (The first attribute has index 0.) + The value of the specified attribute. This method does not move the reader. is out of range. It must be non-negative and less than the size of the attribute collection. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The value of the specified attribute. This method does not move the reader. When overridden in a derived class, gets the value of the attribute with the specified . The qualified name of the attribute. + The value of the specified attribute. If the attribute is not found or the value is , is returned. is . An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The value of the specified attribute. If the attribute is not found or the value is , is returned. When overridden in a derived class, gets the value of the attribute with the specified and . The local name of the attribute. The namespace URI of the attribute. + The value of the specified attribute. If the attribute is not found or the value is , is returned. This method does not move the reader. is . An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The value of the specified attribute. If the attribute is not found or the value is , is returned. This method does not move the reader. Asynchronously gets the value of the current node. + The value of the current node. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress". - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - The value of the current node. + + + Gets a value indicating whether the current node has any attributes. + + if the current node has attributes; otherwise, . + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + When overridden in a derived class, gets a value indicating whether the current node can have a . + + if the node on which the reader is currently positioned can have a ; otherwise, . If , the node has a value of . + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + When overridden in a derived class, gets a value indicating whether the current node is an attribute that was generated from the default value defined in the DTD or schema. + + if the current node is an attribute whose value was generated from the default value defined in the DTD or schema; if the attribute value was explicitly set. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + When overridden in a derived class, gets a value indicating whether the current node is an empty element (for example, <MyElement/>). + + if the current node is an element ( equals ) that ends with />; otherwise, . + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Returns a value indicating whether the string argument is a valid XML name. The name to validate. - The value is . if the name is valid; otherwise, . + The value is . Returns a value indicating whether or not the string argument is a valid XML name token. The name token to validate. - The value is . if it is a valid name token; otherwise . + The value is . Calls and tests if the current content node is a start tag or empty element tag. - Incorrect XML is encountered in the input stream. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." if finds a start tag or empty element tag; if a node type other than was found. + Incorrect XML is encountered in the input stream. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Calls and tests if the current content node is a start tag or empty element tag and if the property of the element found matches the given argument. The string matched against the property of the element found. - Incorrect XML is encountered in the input stream. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." if the resulting node is an element and the property matches the specified string. if a node type other than was found or if the element property does not match the specified string. + Incorrect XML is encountered in the input stream. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Calls and tests if the current content node is a start tag or empty element tag and if the and properties of the element found match the given strings. The string to match against the property of the element found. The string to match against the property of the element found. - Incorrect XML is encountered in the input stream. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." if the resulting node is an element. if a node type other than was found or if the and properties of the element do not match the specified strings. + Incorrect XML is encountered in the input stream. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + When overridden in a derived class, gets the value of the attribute with the specified index. + The index of the attribute. + The value of the specified attribute. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + When overridden in a derived class, gets the value of the attribute with the specified . + The qualified name of the attribute. + The value of the specified attribute. If the attribute is not found, is returned. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + When overridden in a derived class, gets the value of the attribute with the specified and . + The local name of the attribute. + The namespace URI of the attribute. + The value of the specified attribute. If the attribute is not found, is returned. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + When overridden in a derived class, gets the local name of the current node. + The name of the current node with the prefix removed. For example, is for the element <bk:book>. +For node types that do not have a name (like , , and so on), this property returns . + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." When overridden in a derived class, resolves a namespace prefix in the current element's scope. The prefix whose namespace URI you want to resolve. To match the default namespace, pass an empty string. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The namespace URI to which the prefix maps or if no matching prefix is found. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." When overridden in a derived class, moves to the attribute with the specified index. @@ -6222,693 +6467,622 @@ An asynchronous method was called without When overridden in a derived class, moves to the attribute with the specified . The qualified name of the attribute. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The parameter is an empty string. if the attribute is found; otherwise, . If , the reader's position does not change. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + The parameter is an empty string. When overridden in a derived class, moves to the attribute with the specified and . The local name of the attribute. The namespace URI of the attribute. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - Both parameter values are . if the attribute is found; otherwise, . If , the reader's position does not change. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + Both parameter values are . Checks whether the current node is a content (non-white space text, , , , , or ) node. If the node is not a content node, the reader skips ahead to the next content node or end of file. It skips over nodes of the following type: , , , , or . + The of the current node found by the method or if the reader has reached the end of the input stream. Incorrect XML encountered in the input stream. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The of the current node found by the method or if the reader has reached the end of the input stream. Asynchronously checks whether the current node is a content node. If the node is not a content node, the reader skips ahead to the next content node or end of file. + The of the current node found by the method or if the reader has reached the end of the input stream. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - The of the current node found by the method or if the reader has reached the end of the input stream. When overridden in a derived class, moves to the element that contains the current attribute node. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." if the reader is positioned on an attribute (the reader moves to the element that owns the attribute); if the reader is not positioned on an attribute (the position of the reader does not change). + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." When overridden in a derived class, moves to the first attribute. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." if an attribute exists (the reader moves to the first attribute); otherwise, (the position of the reader does not change). + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." When overridden in a derived class, moves to the next attribute. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." if there is a next attribute; if there are no more attributes. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + When overridden in a derived class, gets the qualified name of the current node. + The qualified name of the current node. For example, is for the element <bk:book>. +The name returned is dependent on the of the node. The following node types return the listed values. All other node types return an empty string. + Node type + + Name + + The name of the attribute. + + The document type name. + + The tag name. + + The name of the entity referenced. + + The target of the processing instruction. + + The literal string . + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + When overridden in a derived class, gets the namespace URI (as defined in the W3C Namespace specification) of the node on which the reader is positioned. + The namespace URI of the current node; otherwise an empty string. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + When overridden in a derived class, gets the associated with this implementation. + The enabling you to get the atomized version of a string within the node. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + When overridden in a derived class, gets the type of the current node. + One of the enumeration values that specify the type of the current node. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + When overridden in a derived class, gets the namespace prefix associated with the current node. + The namespace prefix associated with the current node. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + When overridden in a derived class, gets the quotation mark character used to enclose the value of an attribute node. + The quotation mark character (" or ') used to enclose the value of an attribute node. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." When overridden in a derived class, reads the next node from the stream. - An error occurred while parsing the XML. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." if the next node was read successfully; otherwise, . + An error occurred while parsing the XML. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Asynchronously reads the next node from the stream. + + if the next node was read successfully; if there are no more nodes to read. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - - if the next node was read successfully; if there are no more nodes to read. When overridden in a derived class, parses the attribute value into one or more , , or nodes. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - if there are nodes to return. - - if the reader is not positioned on an attribute node when the initial call is made or if all the attribute values have been read. - - An empty attribute, such as, misc="", returns with a single node with a value of . + if there are nodes to return. + if the reader is not positioned on an attribute node when the initial call is made or if all the attribute values have been read. +An empty attribute, such as, misc="", returns with a single node with a value of . + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Reads the content as an object of the type specified. - The type of the value to be returned. - - Note With the release of the .NET Framework 3.5, the value of the parameter can now be the type. - An object that is used to resolve any namespace prefixes related to type conversion. For example, this can be used when converting an object to an xs:string. - - This value can be . + The type of the value to be returned. +Note With the release of the .NET Framework 3.5, the value of the parameter can now be the type. + An object that is used to resolve any namespace prefixes related to type conversion. For example, this can be used when converting an object to an xs:string. +This value can be . + The concatenated text content or attribute value converted to the requested type. The content is not in the correct format for the target type. The attempted cast is not valid. The value is . The current node is not a supported node type. See the table below for details. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Read . - The concatenated text content or attribute value converted to the requested type. Asynchronously reads the content as an object of the type specified. The type of the value to be returned. An object that is used to resolve any namespace prefixes related to type conversion. + The concatenated text content or attribute value converted to the requested type. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - The concatenated text content or attribute value converted to the requested type. Reads the content and returns the Base64 decoded binary bytes. The buffer into which to copy the resulting text. This value cannot be . The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. The value is . is not supported on the current node. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The index into the buffer or index + count is larger than the allocated buffer size. The implementation does not support this method. - The number of bytes written to the buffer. Asynchronously reads the content and returns the Base64 decoded binary bytes. The buffer into which to copy the resulting text. This value cannot be . The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - The number of bytes written to the buffer. Reads the content and returns the decoded binary bytes. The buffer into which to copy the resulting text. This value cannot be . The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. The value is . is not supported on the current node. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The index into the buffer or index + count is larger than the allocated buffer size. The implementation does not support this method. - The number of bytes written to the buffer. Asynchronously reads the content and returns the decoded binary bytes. The buffer into which to copy the resulting text. This value cannot be . The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - The number of bytes written to the buffer. Reads the text content at the current position as a . + The text content as a object. The attempted cast is not valid. The string format is not valid. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The text content as a object. Reads the text content at the current position as a object. + The text content as a object. The attempted cast is not valid. The string format is not valid. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The text content as a object. Reads the text content at the current position as a object. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The text content as a object. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Reads the text content at the current position as a object. + The text content at the current position as a object. The attempted cast is not valid. The string format is not valid. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The text content at the current position as a object. Reads the text content at the current position as a double-precision floating-point number. + The text content as a double-precision floating-point number. The attempted cast is not valid. The string format is not valid. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The text content as a double-precision floating-point number. Reads the text content at the current position as a single-precision floating point number. + The text content at the current position as a single-precision floating point number. The attempted cast is not valid. The string format is not valid. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The text content at the current position as a single-precision floating point number. Reads the text content at the current position as a 32-bit signed integer. + The text content as a 32-bit signed integer. The attempted cast is not valid. The string format is not valid. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The text content as a 32-bit signed integer. Reads the text content at the current position as a 64-bit signed integer. + The text content as a 64-bit signed integer. The attempted cast is not valid. The string format is not valid. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The text content as a 64-bit signed integer. Reads the text content at the current position as an . + The text content as the most appropriate common language runtime (CLR) object. The attempted cast is not valid. The string format is not valid. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The text content as the most appropriate common language runtime (CLR) object. Asynchronously reads the text content at the current position as an . + The text content as the most appropriate common language runtime (CLR) object. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - The text content as the most appropriate common language runtime (CLR) object. Reads the text content at the current position as a object. + The text content as a object. The attempted cast is not valid. The string format is not valid. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The text content as a object. Asynchronously reads the text content at the current position as a object. + The text content as a object. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - The text content as a object. Reads the element content as the requested type. - The type of the value to be returned. - - Note With the release of the .NET Framework 3.5, the value of the parameter can now be the type. + The type of the value to be returned. +Note With the release of the .NET Framework 3.5, the value of the parameter can now be the type. An object that is used to resolve any namespace prefixes related to type conversion. + The element content converted to the requested typed object. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to the requested type. + The current element contains child elements. +-or- +The element content cannot be converted to the requested type. The method is called with arguments. Read . - The element content converted to the requested typed object. Checks that the specified local name and namespace URI matches that of the current element, then reads the element content as the requested type. - The type of the value to be returned. - - Note With the release of the .NET Framework 3.5, the value of the parameter can now be the type. + The type of the value to be returned. +Note With the release of the .NET Framework 3.5, the value of the parameter can now be the type. An object that is used to resolve any namespace prefixes related to type conversion. The local name of the element. The namespace URI of the element. + The element content converted to the requested typed object. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to the requested type. + The current element contains child elements. +-or- +The element content cannot be converted to the requested type. The method is called with arguments. The specified local name and namespace URI do not match that of the current element being read. Read . - The element content converted to the requested typed object. Asynchronously reads the element content as the requested type. The type of the value to be returned. An object that is used to resolve any namespace prefixes related to type conversion. + The element content converted to the requested typed object. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - The element content converted to the requested typed object. Reads the element and decodes the content. The buffer into which to copy the resulting text. This value cannot be . The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. The value is . The current node is not an element node. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The index into the buffer or index + count is larger than the allocated buffer size. The implementation does not support this method. The element contains mixed-content. The content cannot be converted to the requested type. - The number of bytes written to the buffer. Asynchronously reads the element and decodes the content. The buffer into which to copy the resulting text. This value cannot be . The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - The number of bytes written to the buffer. Reads the element and decodes the content. The buffer into which to copy the resulting text. This value cannot be . The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. The value is . The current node is not an element node. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The index into the buffer or index + count is larger than the allocated buffer size. The implementation does not support this method. The element contains mixed-content. The content cannot be converted to the requested type. - The number of bytes written to the buffer. Asynchronously reads the element and decodes the content. The buffer into which to copy the resulting text. This value cannot be . The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - The number of bytes written to the buffer. Reads the current element and returns the contents as a object. + The element content as a object. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to a object. + The current element contains child elements. +-or- +The element content cannot be converted to a object. The method is called with arguments. - The element content as a object. Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a object. The local name of the element. The namespace URI of the element. + The element content as a object. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to the requested type. + The current element contains child elements. +-or- +The element content cannot be converted to the requested type. The method is called with arguments. The specified local name and namespace URI do not match that of the current element being read. - The element content as a object. Reads the current element and returns the contents as a object. + The element content as a object. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to a object. + The current element contains child elements. +-or- +The element content cannot be converted to a object. The method is called with arguments. - The element content as a object. Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a object. The local name of the element. The namespace URI of the element. + The element contents as a object. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to the requested type. + The current element contains child elements. +-or- +The element content cannot be converted to the requested type. The method is called with arguments. The specified local name and namespace URI do not match that of the current element being read. - The element contents as a object. Reads the current element and returns the contents as a object. + The element content as a object. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to a . + The current element contains child elements. +-or- +The element content cannot be converted to a . The method is called with arguments. - The element content as a object. Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a object. The local name of the element. The namespace URI of the element. + The element content as a object. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to a . + The current element contains child elements. +-or- +The element content cannot be converted to a . The method is called with arguments. The specified local name and namespace URI do not match that of the current element being read. - The element content as a object. Reads the current element and returns the contents as a double-precision floating-point number. + The element content as a double-precision floating-point number. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to a double-precision floating-point number. + The current element contains child elements. +-or- +The element content cannot be converted to a double-precision floating-point number. The method is called with arguments. - The element content as a double-precision floating-point number. Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a double-precision floating-point number. The local name of the element. The namespace URI of the element. + The element content as a double-precision floating-point number. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to the requested type. + The current element contains child elements. +-or- +The element content cannot be converted to the requested type. The method is called with arguments. The specified local name and namespace URI do not match that of the current element being read. - The element content as a double-precision floating-point number. Reads the current element and returns the contents as single-precision floating-point number. + The element content as a single-precision floating point number. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to a single-precision floating-point number. + The current element contains child elements. +-or- +The element content cannot be converted to a single-precision floating-point number. The method is called with arguments. - The element content as a single-precision floating point number. Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a single-precision floating-point number. The local name of the element. The namespace URI of the element. + The element content as a single-precision floating point number. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to a single-precision floating-point number. + The current element contains child elements. +-or- +The element content cannot be converted to a single-precision floating-point number. The method is called with arguments. The specified local name and namespace URI do not match that of the current element being read. - The element content as a single-precision floating point number. Reads the current element and returns the contents as a 32-bit signed integer. + The element content as a 32-bit signed integer. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to a 32-bit signed integer. - The element content as a 32-bit signed integer. + The current element contains child elements. +-or- +The element content cannot be converted to a 32-bit signed integer. Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a 32-bit signed integer. The local name of the element. The namespace URI of the element. + The element content as a 32-bit signed integer. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to a 32-bit signed integer. + The current element contains child elements. +-or- +The element content cannot be converted to a 32-bit signed integer. The method is called with arguments. The specified local name and namespace URI do not match that of the current element being read. - The element content as a 32-bit signed integer. Reads the current element and returns the contents as a 64-bit signed integer. + The element content as a 64-bit signed integer. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to a 64-bit signed integer. + The current element contains child elements. +-or- +The element content cannot be converted to a 64-bit signed integer. The method is called with arguments. - The element content as a 64-bit signed integer. Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a 64-bit signed integer. The local name of the element. The namespace URI of the element. + The element content as a 64-bit signed integer. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to a 64-bit signed integer. + The current element contains child elements. +-or- +The element content cannot be converted to a 64-bit signed integer. The method is called with arguments. The specified local name and namespace URI do not match that of the current element being read. - The element content as a 64-bit signed integer. Reads the current element and returns the contents as an . + A boxed common language runtime (CLR) object of the most appropriate type. The property determines the appropriate CLR type. If the content is typed as a list type, this method returns an array of boxed objects of the appropriate type. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to the requested type + The current element contains child elements. +-or- +The element content cannot be converted to the requested type The method is called with arguments. - A boxed common language runtime (CLR) object of the most appropriate type. The property determines the appropriate CLR type. If the content is typed as a list type, this method returns an array of boxed objects of the appropriate type. Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as an . The local name of the element. The namespace URI of the element. + A boxed common language runtime (CLR) object of the most appropriate type. The property determines the appropriate CLR type. If the content is typed as a list type, this method returns an array of boxed objects of the appropriate type. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to the requested type. + The current element contains child elements. +-or- +The element content cannot be converted to the requested type. The method is called with arguments. The specified local name and namespace URI do not match that of the current element being read. - A boxed common language runtime (CLR) object of the most appropriate type. The property determines the appropriate CLR type. If the content is typed as a list type, this method returns an array of boxed objects of the appropriate type. Asynchronously reads the current element and returns the contents as an . + A boxed common language runtime (CLR) object of the most appropriate type. The property determines the appropriate CLR type. If the content is typed as a list type, this method returns an array of boxed objects of the appropriate type. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - A boxed common language runtime (CLR) object of the most appropriate type. The property determines the appropriate CLR type. If the content is typed as a list type, this method returns an array of boxed objects of the appropriate type. Reads the current element and returns the contents as a object. + The element content as a object. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to a object. + The current element contains child elements. +-or- +The element content cannot be converted to a object. The method is called with arguments. - The element content as a object. Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a object. The local name of the element. The namespace URI of the element. + The element content as a object. The is not positioned on an element. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The current element contains child elements. - - -or- - - The element content cannot be converted to a object. + The current element contains child elements. +-or- +The element content cannot be converted to a object. The method is called with arguments. The specified local name and namespace URI do not match that of the current element being read. - The element content as a object. Asynchronously reads the current element and returns the contents as a object. - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." The element content as a object. + An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." Reads a text-only element. However, we recommend that you use the method instead, because it provides a more straightforward way to handle this operation. + The text contained in the element that was read. An empty string if the element is empty. The next content node is not a start tag; or the element found does not contain a simple text value. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The text contained in the element that was read. An empty string if the element is empty. Checks that the property of the element found matches the given string before reading a text-only element. However, we recommend that you use the method instead, because it provides a more straightforward way to handle this operation. The name to check. + The text contained in the element that was read. An empty string if the element is empty. If the next content node is not a start tag; if the element does not match the given argument; or if the element found does not contain a simple text value. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The text contained in the element that was read. An empty string if the element is empty. Checks that the and properties of the element found matches the given strings before reading a text-only element. However, we recommend that you use the method instead, because it provides a more straightforward way to handle this operation. The local name to check. The namespace URI to check. + The text contained in the element that was read. An empty string if the element is empty. If the next content node is not a start tag; if the element or do not match the given arguments; or if the element found does not contain a simple text value. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The text contained in the element that was read. An empty string if the element is empty. Checks that the current content node is an end tag and advances the reader to the next node. @@ -6917,31 +7091,28 @@ An method was called before a previous asy When overridden in a derived class, reads all the content, including markup, as a string. + All the XML content, including markup, in the current node. If the current node has no children, an empty string is returned. +If the current node is neither an element nor attribute, an empty string is returned. The XML was not well-formed, or an error occurred while parsing the XML. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - All the XML content, including markup, in the current node. If the current node has no children, an empty string is returned. - - If the current node is neither an element nor attribute, an empty string is returned. Asynchronously reads all the content, including markup, as a string. + All the XML content, including markup, in the current node. If the current node has no children, an empty string is returned. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - All the XML content, including markup, in the current node. If the current node has no children, an empty string is returned. When overridden in a derived class, reads the content, including markup, representing this node and all its children. + If the reader is positioned on an element or an attribute node, this method returns all the XML content, including markup, of the current node and all its children; otherwise, it returns an empty string. The XML was not well-formed, or an error occurred while parsing the XML. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - If the reader is positioned on an element or an attribute node, this method returns all the XML content, including markup, of the current node and all its children; otherwise, it returns an empty string. Asynchronously reads the content, including markup, representing this node and all its children. - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." If the reader is positioned on an element or an attribute node, this method returns all the XML content, including markup, of the current node and all its children; otherwise, it returns an empty string. + An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." Checks that the current node is an element and advances the reader to the next node. @@ -6951,322 +7122,193 @@ An asynchronous method was called without Checks that the current content node is an element with the given and advances the reader to the next node. The qualified name of the element. - Incorrect XML was encountered in the input stream. - - -or- - - The of the element does not match the given . + Incorrect XML was encountered in the input stream. +-or- +The of the element does not match the given . An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Checks that the current content node is an element with the given and and advances the reader to the next node. The local name of the element. The namespace URI of the element. - Incorrect XML was encountered in the input stream. - - -or- - - The and properties of the element found do not match the given arguments. + Incorrect XML was encountered in the input stream. +-or- +The and properties of the element found do not match the given arguments. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + When overridden in a derived class, gets the state of the reader. + One of the enumeration values that specifies the state of the reader. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." When overridden in a derived class, reads the contents of an element or text node as a string. However, we recommend that you use the method instead, because it provides a more straightforward way to handle this operation. + The contents of the element or an empty string. An error occurred while parsing the XML. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The contents of the element or an empty string. Returns a new instance that can be used to read the current node, and all its descendants. + A new XML reader instance set to . Calling the method positions the new reader on the node that was current before the call to the method. The XML reader isn't positioned on an element when this method is called. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - A new XML reader instance set to . Calling the method positions the new reader on the node that was current before the call to the method. Advances the to the next descendant element with the specified qualified name. The qualified name of the element you wish to move to. + + if a matching descendant element is found; otherwise . If a matching child element is not found, the is positioned on the end tag ( is ) of the element. +If the is not positioned on an element when was called, this method returns and the position of the is not changed. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The parameter is an empty string. - - if a matching descendant element is found; otherwise . If a matching child element is not found, the is positioned on the end tag ( is ) of the element. - - If the is not positioned on an element when was called, this method returns and the position of the is not changed. Advances the to the next descendant element with the specified local name and namespace URI. The local name of the element you wish to move to. The namespace URI of the element you wish to move to. + + if a matching descendant element is found; otherwise . If a matching child element is not found, the is positioned on the end tag ( is ) of the element. +If the is not positioned on an element when was called, this method returns and the position of the is not changed. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Both parameter values are . - - if a matching descendant element is found; otherwise . If a matching child element is not found, the is positioned on the end tag ( is ) of the element. - - If the is not positioned on an element when was called, this method returns and the position of the is not changed. Reads until an element with the specified qualified name is found. The qualified name of the element. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The parameter is an empty string. if a matching element is found; otherwise and the is in an end of file state. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + The parameter is an empty string. Reads until an element with the specified local name and namespace URI is found. The local name of the element. The namespace URI of the element. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - Both parameter values are . if a matching element is found; otherwise and the is in an end of file state. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + Both parameter values are . Advances the to the next sibling element with the specified qualified name. The qualified name of the sibling element you wish to move to. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The parameter is an empty string. if a matching sibling element is found; otherwise . If a matching sibling element is not found, the is positioned on the end tag ( is ) of the parent element. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + The parameter is an empty string. Advances the to the next sibling element with the specified local name and namespace URI. The local name of the sibling element you wish to move to. The namespace URI of the sibling element you wish to move to. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - Both parameter values are . if a matching sibling element is found; otherwise, . If a matching sibling element is not found, the is positioned on the end tag ( is ) of the parent element. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + Both parameter values are . Reads large streams of text embedded in an XML document. The array of characters that serves as the buffer to which the text contents are written. This value cannot be . The offset within the buffer where the can start to copy the results. The maximum number of characters to copy into the buffer. The actual number of characters copied is returned from this method. + The number of characters read into the buffer. The value zero is returned when there is no more text content. The current node does not have a value ( is ). - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The value is . The index into the buffer, or index + count is larger than the allocated buffer size. The implementation does not support this method. The XML data is not well-formed. - The number of characters read into the buffer. The value zero is returned when there is no more text content. Asynchronously reads large streams of text embedded in an XML document. The array of characters that serves as the buffer to which the text contents are written. This value cannot be . The offset within the buffer where the can start to copy the results. The maximum number of characters to copy into the buffer. The actual number of characters copied is returned from this method. + The number of characters read into the buffer. The value zero is returned when there is no more text content. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - The number of characters read into the buffer. The value zero is returned when there is no more text content. When overridden in a derived class, resolves the entity reference for nodes. The reader is not positioned on an node; this implementation of the reader cannot resolve entities ( returns ). - --or- - -An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - - - Skips the children of the current node. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - - - Asynchronously skips the children of the current node. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - -An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - The current node. - - - When overridden in a derived class, gets the number of attributes on the current node. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The number of attributes on the current node. - - - When overridden in a derived class, gets the base URI of the current node. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The base URI of the current node. - - - Gets a value indicating whether the implements the binary content read methods. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - - if the binary content read methods are implemented; otherwise . - - - Gets a value indicating whether the implements the method. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - - if the implements the method; otherwise . - - - Gets a value indicating whether this reader can parse and resolve entities. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - - if the reader can parse and resolve entities; otherwise, . - - - When overridden in a derived class, gets the depth of the current node in the XML document. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The depth of the current node in the XML document. - - - When overridden in a derived class, gets a value indicating whether the reader is positioned at the end of the stream. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - - if the reader is positioned at the end of the stream; otherwise, . - - - Gets a value indicating whether the current node has any attributes. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - - if the current node has attributes; otherwise, . - - - When overridden in a derived class, gets a value indicating whether the current node can have a . - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - - if the node on which the reader is currently positioned can have a ; otherwise, . If , the node has a value of . - - - When overridden in a derived class, gets a value indicating whether the current node is an attribute that was generated from the default value defined in the DTD or schema. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - - if the current node is an attribute whose value was generated from the default value defined in the DTD or schema; if the attribute value was explicitly set. - - - When overridden in a derived class, gets a value indicating whether the current node is an empty element (for example, <MyElement/>). - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - - if the current node is an element ( equals ) that ends with />; otherwise, . - - - When overridden in a derived class, gets the value of the attribute with the specified index. - The index of the attribute. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The value of the specified attribute. - - - When overridden in a derived class, gets the value of the attribute with the specified . - The qualified name of the attribute. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The value of the specified attribute. If the attribute is not found, is returned. - - - When overridden in a derived class, gets the value of the attribute with the specified and . - The local name of the attribute. - The namespace URI of the attribute. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The value of the specified attribute. If the attribute is not found, is returned. - - - When overridden in a derived class, gets the local name of the current node. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The name of the current node with the prefix removed. For example, is for the element <bk:book>. - - For node types that do not have a name (like , , and so on), this property returns . - - - When overridden in a derived class, gets the qualified name of the current node. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The qualified name of the current node. For example, is for the element <bk:book>. - - The name returned is dependent on the of the node. The following node types return the listed values. All other node types return an empty string. - - Node type Name The name of the attribute. The document type name. The tag name. The name of the entity referenced. The target of the processing instruction. The literal string . - - - When overridden in a derived class, gets the namespace URI (as defined in the W3C Namespace specification) of the node on which the reader is positioned. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The namespace URI of the current node; otherwise an empty string. - - - When overridden in a derived class, gets the associated with this implementation. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The enabling you to get the atomized version of a string within the node. - - - When overridden in a derived class, gets the type of the current node. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - One of the enumeration values that specify the type of the current node. - - - When overridden in a derived class, gets the namespace prefix associated with the current node. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The namespace prefix associated with the current node. - - - When overridden in a derived class, gets the quotation mark character used to enclose the value of an attribute node. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The quotation mark character (" or ') used to enclose the value of an attribute node. - - - When overridden in a derived class, gets the state of the reader. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - One of the enumeration values that specifies the state of the reader. +An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Gets the schema information that has been assigned to the current node as a result of schema validation. + An object containing the schema information for the current node. Schema information can be set on elements, attributes, or on text nodes with a non-null (typed values). +If the current node is not one of the above node types, or if the instance does not report schema information, this property returns . +If this property is called from an or an object, this property always returns . These implementations do not expose schema information through the property. + +If you have to get the post-schema-validation information set (PSVI) for an element, position the reader on the end tag of the element, rather than on the start tag. You get the PSVI through the property of a reader. The validating reader that is created through with the property set to has complete PSVI for an element only when the reader is positioned on the end tag of an element. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - An object containing the schema information for the current node. Schema information can be set on elements, attributes, or on text nodes with a non-null (typed values). - - If the current node is not one of the above node types, or if the instance does not report schema information, this property returns . - - If this property is called from an or an object, this property always returns . These implementations do not expose schema information through the property. Gets the object used to create this instance. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The object used to create this reader instance. If this reader was not created using the method, this property returns . + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + Skips the children of the current node. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." + + + Asynchronously skips the children of the current node. + The current node. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." +-or- +An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." When overridden in a derived class, gets the text value of the current node. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The value returned depends on the of the node. The following table lists node types that have a value to return. All other node types return . + The value returned depends on the of the node. The following table lists node types that have a value to return. All other node types return . + Node type + + Value + + The value of the attribute. + + The content of the CDATA section. + + The content of the comment. + + The internal subset. + + The entire content, excluding the target. - Node type Value The value of the attribute. The content of the CDATA section. The content of the comment. The internal subset. The entire content, excluding the target. The white space between markup in a mixed content model. The content of the text node. The white space between markup. The content of the declaration. + The white space between markup in a mixed content model. + + The content of the text node. + + The white space between markup. + + The content of the declaration. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Gets The Common Language Runtime (CLR) type for the current node. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The CLR type that corresponds to the typed value of the node. The default is . + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." When overridden in a derived class, gets the current scope. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The current scope. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." When overridden in a derived class, gets the current scope. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." One of the values. If no scope exists, this property defaults to . + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Specifies a set of features to support on the object created by the method. - - Occurs when the reader encounters validation errors. - Initializes a new instance of the class. - - Creates a copy of the instance. - The cloned object. - - - Resets the members of the settings class to their default values. - Gets or sets whether asynchronous methods can be used on a particular instance. @@ -7275,7 +7317,13 @@ An asynchronous method was called without Gets or sets a value indicating whether to do character checking. - to do character checking; otherwise . The default is . + to do character checking; otherwise . The default is . + +If the is processing text data, it always checks that the XML names and text content are valid, regardless of the property setting. Setting to turns off character checking for character entity references. + + + Creates a copy of the instance. + The cloned object. Gets or sets a value indicating whether the underlying stream or should be closed when the reader is closed. @@ -7323,19 +7371,24 @@ An asynchronous method was called without Gets or sets the used for atomized string comparisons. - The that stores all the atomized strings used by all instances created using this object. - - The default is . The created instance will use a new empty if this value is . + The that stores all the atomized strings used by all instances created using this object. +The default is . The created instance will use a new empty if this value is . Gets or sets a value indicating whether to prohibit document type definition (DTD) processing. This property is obsolete. Use instead. to prohibit DTD processing; otherwise . The default is . + + Resets the members of the settings class to their default values. + Gets or sets the to use when performing schema validation. The to use when performing schema validation. The default is an empty object. + + Occurs when the reader encounters validation errors. + Gets or sets a value indicating the schema validation settings. This setting applies to objects that validate schemas ( property set to ). A bitwise combination of enumeration values that specify validation options. and are enabled by default. , , and are disabled by default. @@ -7354,18 +7407,22 @@ An asynchronous method was called without Initializes a new instance of the class. + + When overridden in a derived class, sets the credentials used to authenticate web requests. + The credentials to be used to authenticate web requests. If this property is not set, the value defaults to ; that is, the has no user credentials. + When overridden in a derived class, maps a URI to an object that contains the actual resource. The URI returned from . Currently not used. The type of object to return. The current version only returns System.IO.Stream objects. + A stream object or if a type other than stream is specified. is not a type. The specified URI is not an absolute URI. is . There is a runtime error (for example, an interrupted server connection). - A stream object or if a type other than stream is specified. Asynchronously maps a URI to an object that contains the actual resource. @@ -7378,9 +7435,9 @@ An asynchronous method was called without When overridden in a derived class, resolves the absolute URI from the base and relative URIs. The base URI used to resolve the relative URI. The URI to resolve. The URI can be absolute or relative. If absolute, this value effectively replaces the value. If relative, it combines with the to make an absolute URI. + The absolute URI or if the relative URI cannot be resolved. is . - The absolute URI or if the relative URI cannot be resolved. Enables the resolver to return types other than . @@ -7389,10 +7446,6 @@ An asynchronous method was called without if the is supported; otherwise, . - - When overridden in a derived class, sets the credentials used to authenticate web requests. - The credentials to be used to authenticate web requests. If this property is not set, the value defaults to ; that is, the has no user credentials. - Helps to secure another implementation of by wrapping the object and restricting the resources that the underlying has access to. @@ -7401,18 +7454,22 @@ An asynchronous method was called without The XML resolver that is wrapped by the . The URL used to create the that will be applied to the underlying . The calls on the created before calling on the underlying . + + Sets credentials used to authenticate web requests. + The credentials to be used to authenticate web requests. The sets the given credentials on the underlying . If this property is not set, the value defaults to ; that is, the has no user credentials. + Maps a URI to an object that contains the actual resource. This method temporarily sets the created in the constructor by calling before calling on the underlying to open the resource. The URI that is returned from . Currently not used. The type of object to return. The current version only returns objects. + The stream returned by calling on the underlying . If a type other than is specified, the method returns . is neither nor a type. The specified URI is not an absolute URI. is . There is a runtime error (for example, an interrupted server connection). - The stream returned by calling on the underlying . If a type other than is specified, the method returns . Asynchronously maps a URI to an object that contains the actual resource. @@ -7425,13 +7482,9 @@ An asynchronous method was called without Resolves the absolute URI from the base and relative URIs by calling on the underlying . The base URI used to resolve the relative URI. The URI to resolve. The URI can be absolute or relative. If absolute, this value effectively replaces the value. If relative, it combines with the to make an absolute URI. + The absolute URI or if the relative URI cannot be resolved (returned by calling on the underlying ). is . - The absolute URI or if the relative URI cannot be resolved (returned by calling on the underlying ). - - - Sets credentials used to authenticate web requests. - The credentials to be used to authenticate web requests. The sets the given credentials on the underlying . If this property is not set, the value defaults to ; that is, the has no user credentials. Represents white space between markup in a mixed content node or white space within an xml:space= 'preserve' scope. This is also referred to as significant white space. @@ -7447,14 +7500,6 @@ An asynchronous method was called without to recursively clone the subtree under the specified node; to clone only the node itself. For significant white space nodes, the cloned node always includes the data value, regardless of the parameter setting. The cloned node. - - Saves all the children of the node to the specified . - The to which you want to save. - - - Saves the node to the specified . - The to which you want to save. - Gets the local name of the node. For nodes, this property returns . @@ -7477,8 +7522,16 @@ An asynchronous method was called without Gets or sets the value of the node. - Setting to invalid white space characters. The white space characters found in the node. + Setting to invalid white space characters. + + + Saves all the children of the node to the specified . + The to which you want to save. + + + Saves the node to the specified . + The to which you want to save. Specifies the current scope. @@ -7506,19 +7559,6 @@ An asynchronous method was called without to recursively clone the subtree under the specified node; to clone only the node itself. The cloned node. - - Splits the node into two nodes at the specified offset, keeping both in the tree as siblings. - The offset at which to split the node. - The new node. - - - Saves all the children of the node to the specified . nodes do not have children, so this method has no effect. - The to which you want to save. - - - Saves the node to the specified . - The to which you want to save. - Gets the local name of the node. For text nodes, this property returns . @@ -7539,14 +7579,26 @@ An asynchronous method was called without Gets the text node that immediately precedes this node. Returns . + + Splits the node into two nodes at the specified offset, keeping both in the tree as siblings. + The offset at which to split the node. + The new node. + Gets or sets the value of the node. The content of the text node. + + Saves all the children of the node to the specified . nodes do not have children, so this method has no effect. + The to which you want to save. + + + Saves the node to the specified . + The to which you want to save. + - Represents a reader that provides fast, non-cached, forward-only access to XML data. - - Starting with the .NET Framework 2.0, we recommend that you use the class instead. + Represents a reader that provides fast, non-cached, forward-only access to XML data. +Starting with the .NET Framework 2.0, we recommend that you use the class instead. Initializes a new instance of the . @@ -7590,11 +7642,9 @@ An asynchronous method was called without Part of the filename or directory cannot be found. is an empty string. - The remote filename cannot be resolved. - - -or- - - An error occurred while processing the request. + The remote filename cannot be resolved. +-or- +An error occurred while processing the request. is not a valid URI. @@ -7633,11 +7683,9 @@ An asynchronous method was called without Part of the filename or directory cannot be found. is an empty string. - The remote filename cannot be resolved. - - -or- - - An error occurred while processing the request. + The remote filename cannot be resolved. +-or- +An error occurred while processing the request. is not a valid URI. @@ -7655,14 +7703,58 @@ An asynchronous method was called without Initializes a new instance of the class with the specified . The to use. + + Gets the number of attributes on the current node. + The number of attributes on the current node. + + + Gets the base URI of the current node. + The base URI of the current node. + + + Gets a value indicating whether the implements the binary content read methods. + + if the binary content read methods are implemented; otherwise . The class always returns . + + + Gets a value indicating whether the implements the method. + + if the implements the method; otherwise . The class always returns . + + + Gets a value indicating whether this reader can parse and resolve entities. + + if the reader can parse and resolve entities; otherwise, . The class always returns . + Changes the to . + + Gets the depth of the current node in the XML document. + The depth of the current node in the XML document. + + + Gets or sets the enumeration. + The enumeration. + + + Gets the encoding of the document. + The encoding value. If no encoding attribute exists, and there is no byte-order mark, this defaults to UTF-8. + + + Gets or sets a value that specifies how the reader handles entities. + One of the values. If no is specified, it defaults to . + + + Gets a value indicating whether the reader is positioned at the end of the stream. + + if the reader is positioned at the end of the stream; otherwise, . + Gets the value of the attribute with the specified index. The index of the attribute. The index is zero-based. (The first attribute has index 0.) - The parameter is less than 0 or greater than or equal to . The value of the specified attribute. + The parameter is less than 0 or greater than or equal to . Gets the value of the attribute with the specified name. @@ -7689,11 +7781,38 @@ An asynchronous method was called without if the class can return line information; otherwise, . + + Gets a value indicating whether the current node can have a other than . + + if the node on which the reader is currently positioned can have a ; otherwise, . + + + Gets a value indicating whether the current node is an attribute that was generated from the default value defined in the DTD or schema. + This property always returns . ( does not expand default attributes.) + + + Gets a value indicating whether the current node is an empty element (for example, <MyElement/>). + + if the current node is an element ( equals ) that ends with />; otherwise, . + + + Gets the current line number. + The current line number. + + + Gets the current line position. + The current line position. + + + Gets the local name of the current node. + The name of the current node with the prefix removed. For example, is for the element <bk:book>. +For node types that do not have a name (like , , and so on), this property returns . + Resolves a namespace prefix in the current element's scope. The prefix whose namespace URI you want to resolve. To match the default namespace, pass an empty string. This string does not have to be atomized. - The property is set to and the value is . The namespace URI to which the prefix maps or if no matching prefix is found. + The property is set to and the value is . Moves to the attribute with the specified index. @@ -7728,112 +7847,170 @@ An asynchronous method was called without if there is a next attribute; if there are no more attributes. + + Gets the qualified name of the current node. + The qualified name of the current node. For example, is for the element <bk:book>. +The name returned is dependent on the of the node. The following node types return the listed values. All other node types return an empty string. + Node Type + + Name + + The name of the attribute. + + The document type name. + + The tag name. + + The name of the entity referenced. + + The target of the processing instruction. + + The literal string . + + + Gets or sets a value indicating whether to do namespace support. + + to do namespace support; otherwise, . The default is . + Setting this property after a read operation has occurred ( is not ). + + + Gets the namespace URI (as defined in the W3C Namespace specification) of the node on which the reader is positioned. + The namespace URI of the current node; otherwise an empty string. + + + Gets the associated with this implementation. + The enabling you to get the atomized version of a string within the node. + + + Gets the type of the current node. + One of the values representing the type of the current node. + + + Gets or sets a value indicating whether to normalize white space and attribute values. + + to normalize; otherwise, . The default is . + Setting this property when the reader is closed ( is ). + + + Gets the namespace prefix associated with the current node. + The namespace prefix associated with the current node. + + + Gets or sets a value indicating whether to allow DTD processing. This property is obsolete. Use instead. + + to disallow DTD processing; otherwise . The default is . + + + Gets the quotation mark character used to enclose the value of an attribute node. + The quotation mark character (" or ') used to enclose the value of an attribute node. + Reads the next node from the stream. - An error occurred while parsing the XML. if the next node was read successfully; if there are no more nodes to read. + An error occurred while parsing the XML. Parses the attribute value into one or more , , or nodes. - - if there are nodes to return. - - if the reader is not positioned on an attribute node when the initial call is made or if all the attribute values have been read. - - An empty attribute, such as, misc="", returns with a single node with a value of . + + if there are nodes to return. + if the reader is not positioned on an attribute node when the initial call is made or if all the attribute values have been read. +An empty attribute, such as, misc="", returns with a single node with a value of . Decodes Base64 and returns the decoded binary bytes. The array of characters that serves as the buffer to which the text contents are written. The zero-based index into the array specifying where the method can begin to write to the buffer. The number of bytes to write into the buffer. + The number of bytes written to the buffer. The Base64 sequence is not valid. The value of is . < 0, or < 0, or > .Length- . - The number of bytes written to the buffer. Decodes and returns the decoded binary bytes. The byte array that serves as the buffer to which the decoded binary bytes are written. The zero-based index into the array specifying where the method can begin to write to the buffer. The number of bytes to write into the buffer. + The number of bytes written to your buffer. The sequence is not valid. The value of is . < 0, or < 0, or > .Length- . - The number of bytes written to your buffer. Reads the text contents of an element into a character buffer. This method is designed to read large streams of embedded text by calling it successively. The array of characters that serves as the buffer to which the text contents are written. The position within where the method can begin writing text contents. The number of characters to write into . + The number of characters read. This can be if the reader is not positioned on an element or if there is no more text content to return in the current context. is greater than the space specified in the (buffer size - ). The value is . or . - The number of characters read. This can be if the reader is not positioned on an element or if there is no more text content to return in the current context. Reads the content and returns the decoded binary bytes. The buffer into which to copy the resulting text. This value cannot be . The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. The value is . is not supported in the current node. The index into the buffer or index + count is larger than the allocated buffer size. - The number of bytes written to the buffer. Reads the content and returns the decoded binary bytes. The buffer into which to copy the resulting text. This value cannot be . The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. The value is . is not supported on the current node. The index into the buffer or index + count is larger than the allocated buffer size. The implementation does not support this method. - The number of bytes written to the buffer. Reads the element and decodes the Base64 content. The buffer into which to copy the resulting text. This value cannot be . The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. The value is . The current node is not an element node. The index into the buffer or index + count is larger than the allocated buffer size. The implementation does not support this method. The element contains mixed-content. The content cannot be converted to the requested type. - The number of bytes written to the buffer. Reads the element and decodes the content. The buffer into which to copy the resulting text. This value cannot be . The offset into the buffer where to start copying the result. The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. The value is . The current node is not an element node. The index into the buffer or index + count is larger than the allocated buffer size. The implementation does not support this method. The element contains mixed-content. The content cannot be converted to the requested type. - The number of bytes written to the buffer. + + + Gets the state of the reader. + One of the values. Reads the contents of an element or a text node as a string. + The contents of the element or text node. This can be an empty string if the reader is positioned on something other than an element or text node, or if there is no more text content to return in the current context. + The text node can be either an element or an attribute text node. An error occurred while parsing the XML. An invalid operation was attempted. - The contents of the element or text node. This can be an empty string if the reader is positioned on something other than an element or text node, or if there is no more text content to return in the current context. - - The text node can be either an element or an attribute text node. Resets the state of the reader to ReadState.Initial. @@ -7861,138 +8038,36 @@ An asynchronous method was called without The namespace URI whose prefix you wish to find. The prefix that is mapped to the namespace URI; if the namespace URI is not mapped to a prefix. - - Gets the number of attributes on the current node. - The number of attributes on the current node. - - - Gets the base URI of the current node. - The base URI of the current node. - - - Gets a value indicating whether the implements the binary content read methods. - - if the binary content read methods are implemented; otherwise . The class always returns . - - - Gets a value indicating whether the implements the method. - - if the implements the method; otherwise . The class always returns . - - - Gets a value indicating whether this reader can parse and resolve entities. - - if the reader can parse and resolve entities; otherwise, . The class always returns . - - - Gets the depth of the current node in the XML document. - The depth of the current node in the XML document. - - - Gets or sets the enumeration. - The enumeration. - - - Gets the encoding of the document. - The encoding value. If no encoding attribute exists, and there is no byte-order mark, this defaults to UTF-8. - - - Gets or sets a value that specifies how the reader handles entities. - One of the values. If no is specified, it defaults to . - - - Gets a value indicating whether the reader is positioned at the end of the stream. - - if the reader is positioned at the end of the stream; otherwise, . - - - Gets a value indicating whether the current node can have a other than . - - if the node on which the reader is currently positioned can have a ; otherwise, . - - - Gets a value indicating whether the current node is an attribute that was generated from the default value defined in the DTD or schema. - This property always returns . ( does not expand default attributes.) - - - Gets a value indicating whether the current node is an empty element (for example, <MyElement/>). - - if the current node is an element ( equals ) that ends with />; otherwise, . - - - Gets the current line number. - The current line number. - - - Gets the current line position. - The current line position. - - - Gets the local name of the current node. - The name of the current node with the prefix removed. For example, is for the element <bk:book>. + + Gets the text value of the current node. + The value returned depends on the of the node. The following table lists node types that have a value to return. All other node types return . + Node Type - For node types that do not have a name (like , , and so on), this property returns . - - - Gets the qualified name of the current node. - The qualified name of the current node. For example, is for the element <bk:book>. + Value - The name returned is dependent on the of the node. The following node types return the listed values. All other node types return an empty string. + The value of the attribute. - Node Type Name The name of the attribute. The document type name. The tag name. The name of the entity referenced. The target of the processing instruction. The literal string . - - - Gets or sets a value indicating whether to do namespace support. - Setting this property after a read operation has occurred ( is not ). - - to do namespace support; otherwise, . The default is . - - - Gets the namespace URI (as defined in the W3C Namespace specification) of the node on which the reader is positioned. - The namespace URI of the current node; otherwise an empty string. - - - Gets the associated with this implementation. - The enabling you to get the atomized version of a string within the node. - - - Gets the type of the current node. - One of the values representing the type of the current node. - - - Gets or sets a value indicating whether to normalize white space and attribute values. - Setting this property when the reader is closed ( is ). - - to normalize; otherwise, . The default is . - - - Gets the namespace prefix associated with the current node. - The namespace prefix associated with the current node. - - - Gets or sets a value indicating whether to allow DTD processing. This property is obsolete. Use instead. - - to disallow DTD processing; otherwise . The default is . - - - Gets the quotation mark character used to enclose the value of an attribute node. - The quotation mark character (" or ') used to enclose the value of an attribute node. - - - Gets the state of the reader. - One of the values. - - - Gets the text value of the current node. - The value returned depends on the of the node. The following table lists node types that have a value to return. All other node types return . + The content of the CDATA section. + + The content of the comment. + + The internal subset. + + The entire content, excluding the target. - Node Type Value The value of the attribute. The content of the CDATA section. The content of the comment. The internal subset. The entire content, excluding the target. The white space within an = 'preserve' scope. The content of the text node. The white space between markup. The content of the declaration. + The white space within an = 'preserve' scope. + + The content of the text node. + + The white space between markup. + + The content of the declaration. Gets or sets a value that specifies how white space is handled. + One of the values. The default is (returns and nodes). Invalid value specified. Setting this property when the reader is closed ( is ). - One of the values. The default is (returns and nodes). Gets the current scope. @@ -8000,18 +8075,16 @@ An asynchronous method was called without Sets the used for resolving DTD references. - The to use. If set to , external resources are not resolved. - - In version 1.1 of the .NET Framework, the caller must be fully trusted in order to specify an . + The to use. If set to , external resources are not resolved. +In version 1.1 of the .NET Framework, the caller must be fully trusted in order to specify an . Gets the current scope. One of the values. If no scope exists, this property defaults to . - Represents a writer that provides a fast, non-cached, forward-only way of generating streams or files containing XML data that conforms to the W3C Extensible Markup Language (XML) 1.0 and the Namespaces in XML recommendations. - - Starting with the .NET Framework 2.0, we recommend that you use the class instead. + Represents a writer that provides a fast, non-cached, forward-only way of generating streams or files containing XML data that conforms to the W3C Extensible Markup Language (XML) 1.0 and the Namespaces in XML recommendations. +Starting with the .NET Framework 2.0, we recommend that you use the class instead. Creates an instance of the class using the specified stream and encoding. @@ -8036,18 +8109,49 @@ An asynchronous method was called without The filename includes an incorrect or invalid syntax for file name, directory name, or volume label syntax. The caller does not have the required permission. + + Gets the underlying stream object. + The stream to which the is writing or if the was constructed using a that does not inherit from the class. + Closes this stream and the underlying stream. Flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + + Indicates how the output is formatted. + One of the values. The default is (no special formatting). + + + Gets or sets how many IndentChars to write for each level in the hierarchy when is set to . + Number of for each level. The default is 2. + Setting this property to a negative value. + + + Gets or sets which character to use for indenting when is set to . + The character to use for indenting. The default is space. + +The allows you to set this property to any character. To ensure valid XML, you must specify a valid white space character, 0x9, 0x10, 0x13 or 0x20. + Returns the closest prefix defined in the current namespace scope for the namespace URI. Namespace URI whose prefix you want to find. + The matching prefix. Or if no matching namespace URI is found in the current scope. is either or . - The matching prefix. Or if no matching namespace URI is found in the current scope. + + + Gets or sets a value indicating whether to do namespace support. + + to support namespaces; otherwise, . +The default is . + You can only change this property when in the state. + + + Gets or sets which character to use to quote attribute values. + The character to use to quote attribute values. This must be a single quote (&#39;) or a double quote (&#34;). The default is a double quote. + Setting this property to something other than either a single or double quote. Encodes the specified binary bytes as base64 and writes out the resulting text. @@ -8093,17 +8197,15 @@ An asynchronous method was called without is . - or is less than zero. - - -or- - - The buffer length minus is less than ; the call results in surrogate pair characters being split or an invalid surrogate pair being written. + or is less than zero. +-or- +The buffer length minus is less than ; the call results in surrogate pair characters being split or an invalid surrogate pair being written. The is Closed. Writes out a comment <!--...--> containing the specified text. Text to place inside the comment. - The text would result in a non-well formed XML document. + The text would result in a non-well formed XML document The is . @@ -8114,11 +8216,9 @@ An asynchronous method was called without If non-null it writes [subset] where subset is replaced with the value of this argument. This method was called outside the prolog (after the root element). - is or - - -or- - - the value for would result in invalid XML. + is or +-or- +the value for would result in invalid XML. Closes the previous call. @@ -8154,20 +8254,17 @@ An asynchronous method was called without Writes out a processing instruction with a space between the name and text as follows: <?name text?>. Name of the processing instruction. Text to include in the processing instruction. - The text would result in a non-well formed XML document. - - is either or . - - This method is being used to create an XML declaration after has already been called. + The text would result in a non-well formed XML document. + is either or . +This method is being used to create an XML declaration after has already been called. Writes out the namespace-qualified name. This method looks up the prefix that is in scope for the given namespace. The local name to write. The namespace URI to associate with the name. - is either or . - - is not a valid name according to the W3C Namespaces spec. + is either or . + is not a valid name according to the W3C Namespaces spec. Writes raw markup manually from a character buffer. @@ -8177,11 +8274,9 @@ An asynchronous method was called without is . - or is less than zero. - - -or- - - The buffer length minus is less than . + or is less than zero. +-or- +The buffer length minus is less than . Writes raw markup manually from a string. @@ -8194,7 +8289,7 @@ An asynchronous method was called without of the attribute. - of the attribute. + of the attribute is either or . @@ -8214,6 +8309,10 @@ An asynchronous method was called without The namespace URI to associate with the element. If this namespace is already in scope and has an associated prefix then the writer automatically writes that prefix also. The writer is closed. + + Gets the state of the writer. + One of the values. + Writes the given text content. Text to write. @@ -8230,49 +8329,28 @@ An asynchronous method was called without The string of white space characters. The string contains non-white space characters. - - Gets the underlying stream object. - The stream to which the is writing or if the was constructed using a that does not inherit from the class. - - - Indicates how the output is formatted. - One of the values. The default is (no special formatting). - - - Gets or sets how many IndentChars to write for each level in the hierarchy when is set to . - Setting this property to a negative value. - Number of for each level. The default is 2. - - - Gets or sets which character to use for indenting when is set to . - The character to use for indenting. The default is space. - - - Gets or sets a value indicating whether to do namespace support. - You can only change this property when in the state. - - to support namespaces; otherwise, . - - The default is . - - - Gets or sets which character to use to quote attribute values. - Setting this property to something other than either a single or double quote. - The character to use to quote attribute values. This must be a single quote (&#39;) or a double quote (&#34;). The default is a double quote. - - - Gets the state of the writer. - One of the values. - Gets the current scope. The current or if there is no in the current scope. Gets an representing the current scope. - An representing the current scope. + An representing the current scope. + Value - Value Meaning None This is the default if no scope exists. Default The current scope is ="default". Preserve The current scope is ="preserve". + Meaning + + None + + This is the default if no scope exists. + + Default + + The current scope is ="default". + + Preserve + + The current scope is ="preserve". Represents the XML type for the string. This allows the string to be read as a particular XML type, for example a CDATA section type. @@ -8322,18 +8400,26 @@ An asynchronous method was called without Initializes a new instance of the class. + + Gets or sets the cache policy for the underlying object. + The cache policy for the underlying web request. + + + Sets credentials used to authenticate web requests. + The credentials to be used to authenticate web requests. If this property is not set, the value defaults to ; that is, the has no user credentials. + Maps a URI to an object that contains the actual resource. The URI returned from . Currently not used. The type of object to return. The current implementation only returns objects. + A stream object or if a type other than stream is specified. is neither nor a type. The specified URI is not an absolute URI. is . There is a runtime error (for example, an interrupted server connection). - A stream object or if a type other than stream is specified. Asynchronously maps a URI to an object that contains the actual resource. @@ -8342,33 +8428,21 @@ An asynchronous method was called without The type of object to return. The current implementation only returns objects. A stream object or if a type other than stream is specified. - - Resolves the absolute URI from the base and relative URIs. - The base URI used to resolve the relative URI. - The URI to resolve. The URI can be absolute or relative. If absolute, this value effectively replaces the value. If relative, it combines with the to make an absolute URI. - - is or is . - The absolute URI, or if the relative URI cannot be resolved. - - - Gets or sets the cache policy for the underlying object. - The cache policy for the underlying web request. - - - Sets credentials used to authenticate web requests. - The credentials to be used to authenticate web requests. If this property is not set, the value defaults to ; that is, the has no user credentials. - Gets or sets the network proxy for the underlying object. The to use to access the Internet resource. - - Represents a reader that provides document type definition (DTD), XML-Data Reduced (XDR) schema, and XML Schema definition language (XSD) validation. - - This class is obsolete. Starting with the .NET Framework 2.0, we recommend that you use the class and the method to create a validating XML reader. + + Resolves the absolute URI from the base and relative URIs. + The base URI used to resolve the relative URI. + The URI to resolve. The URI can be absolute or relative. If absolute, this value effectively replaces the value. If relative, it combines with the to make an absolute URI. + The absolute URI, or if the relative URI cannot be resolved. + + is or is . - - Sets an event handler for receiving information about document type definition (DTD), XML-Data Reduced (XDR) schema, and XML Schema definition language (XSD) schema validation errors. + + Represents a reader that provides document type definition (DTD), XML-Data Reduced (XDR) schema, and XML Schema definition language (XSD) validation. +This class is obsolete. Starting with the .NET Framework 2.0, we recommend that you use the class and the method to create a validating XML reader. Initializes a new instance of the class with the specified values. @@ -8391,14 +8465,50 @@ An asynchronous method was called without The to read from while validating. The current implementation supports only . The reader specified is not an . + + Gets the number of attributes on the current node. + The number of attributes on the current node. This number includes default attributes. + + + Gets the base URI of the current node. + The base URI of the current node. + + + Gets a value indicating whether the implements the binary content read methods. + + if the binary content read methods are implemented; otherwise . The class returns . + + + Gets a value indicating whether this reader can parse and resolve entities. + + if the reader can parse and resolve entities; otherwise, . always returns . + Changes the to Closed. + + Gets the depth of the current node in the XML document. + The depth of the current node in the XML document. + + + Gets the encoding attribute for the document. + The encoding value. If no encoding attribute exists, and there is not byte-order mark, this defaults to UTF-8. + + + Gets or sets a value that specifies how the reader handles entities. + One of the values. If no is specified, it defaults to EntityHandling.ExpandEntities. + Invalid value was specified. + + + Gets a value indicating whether the reader is positioned at the end of the stream. + + if the reader is positioned at the end of the stream; otherwise, . + Gets the value of the attribute with the specified index. The index of the attribute. The index is zero-based. (The first attribute has index 0.) - The parameter is less than 0 or greater than or equal to . The value of the specified attribute. + The parameter is less than 0 or greater than or equal to . Gets the value of the attribute with the specified name. @@ -8416,6 +8526,34 @@ An asynchronous method was called without if the class can return line information; otherwise, . + + Gets a value indicating whether the current node can have a other than String.Empty. + + if the node on which the reader is currently positioned can have a ; otherwise, . + + + Gets a value indicating whether the current node is an attribute that was generated from the default value defined in the document type definition (DTD) or schema. + + if the current node is an attribute whose value was generated from the default value defined in the DTD or schema; if the attribute value was explicitly set. + + + Gets a value indicating whether the current node is an empty element (for example, <MyElement/>). + + if the current node is an element ( equals ) that ends with />; otherwise, . + + + Gets the current line number. + The current line number. The starting value for this property is 1. + + + Gets the current line position. + The current line position. The starting value for this property is 1. + + + Gets the local name of the current node. + The name of the current node with the prefix removed. For example, is for the element <bk:book>. +For node types that do not have a name (like , , and so on), this property returns String.Empty. + Resolves a namespace prefix in the current element's scope. The prefix whose namespace Uniform Resource Identifier (URI) you want to resolve. To match the default namespace, pass an empty string. @@ -8454,168 +8592,25 @@ An asynchronous method was called without if there is a next attribute; if there are no more attributes. - - Reads the next node from the stream. - - if the next node was read successfully; if there are no more nodes to read. - - - Parses the attribute value into one or more , , or nodes. - - if there are nodes to return. + + Gets the qualified name of the current node. + The qualified name of the current node. For example, is for the element <bk:book>. +The name returned is dependent on the of the node. The following node types return the listed values. All other node types return an empty string. + Node Type - if the reader is not positioned on an attribute node when the initial call is made or if all the attribute values have been read. + Name - An empty attribute, such as, misc="", returns with a single node with a value of String.Empty. - - - Reads the content and returns the Base64 decoded binary bytes. - The buffer into which to copy the resulting text. This value cannot be . - The offset into the buffer where to start copying the result. - The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. - The value is . - - is not supported on the current node. - The index into the buffer or index + count is larger than the allocated buffer size. - The number of bytes written to the buffer. - - - Reads the content and returns the BinHex decoded binary bytes. - The buffer into which to copy the resulting text. This value cannot be . - The offset into the buffer where to start copying the result. - The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. - The value is . - - is not supported on the current node. - The index into the buffer or index + count is larger than the allocated buffer size. - The implementation does not support this method. - The number of bytes written to the buffer. - - - Reads the element and decodes the Base64 content. - The buffer into which to copy the resulting text. This value cannot be . - The offset into the buffer where to start copying the result. - The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. - The value is . - The current node is not an element node. - The index into the buffer or index + count is larger than the allocated buffer size. - The implementation does not support this method. - The element contains mixed-content. - The content cannot be converted to the requested type. - The number of bytes written to the buffer. - - - Reads the element and decodes the BinHex content. - The buffer into which to copy the resulting text. This value cannot be . - The offset into the buffer where to start copying the result. - The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. - The value is . - The current node is not an element node. - The index into the buffer or index + count is larger than the allocated buffer size. - The implementation does not support this method. - The element contains mixed-content. - The content cannot be converted to the requested type. - The number of bytes written to the buffer. - - - Reads the contents of an element or text node as a string. - The contents of the element or text node. This can be an empty string if the reader is positioned on something other than an element or text node, or if there is no more text content to return in the current context. - - - Gets the common language runtime type for the specified XML Schema definition language (XSD) type. - The common language runtime type for the specified XML Schema type. - - - Resolves the entity reference for nodes. - The reader is not positioned on an node. - - - For a description of this member, see . - An object that identifies the scope of the reader. - An object that identifies the namespaces in scope. - - - For a description of this member, see . - The namespace prefix. - A string value that contains the namespace Uri that is associated with the prefix. - - - For a description of this member, see . - The namespace that is associated with the prefix. - A string value that contains the namespace prefix that is associated with the . - - - Gets the number of attributes on the current node. - The number of attributes on the current node. This number includes default attributes. - - - Gets the base URI of the current node. - The base URI of the current node. - - - Gets a value indicating whether the implements the binary content read methods. - - if the binary content read methods are implemented; otherwise . The class returns . - - - Gets a value indicating whether this reader can parse and resolve entities. - - if the reader can parse and resolve entities; otherwise, . always returns . - - - Gets the depth of the current node in the XML document. - The depth of the current node in the XML document. - - - Gets the encoding attribute for the document. - The encoding value. If no encoding attribute exists, and there is not byte-order mark, this defaults to UTF-8. - - - Gets or sets a value that specifies how the reader handles entities. - Invalid value was specified. - One of the values. If no is specified, it defaults to EntityHandling.ExpandEntities. - - - Gets a value indicating whether the reader is positioned at the end of the stream. - - if the reader is positioned at the end of the stream; otherwise, . - - - Gets a value indicating whether the current node can have a other than String.Empty. - - if the node on which the reader is currently positioned can have a ; otherwise, . - - - Gets a value indicating whether the current node is an attribute that was generated from the default value defined in the document type definition (DTD) or schema. - - if the current node is an attribute whose value was generated from the default value defined in the DTD or schema; if the attribute value was explicitly set. - - - Gets a value indicating whether the current node is an empty element (for example, <MyElement/>). - - if the current node is an element ( equals ) that ends with />; otherwise, . - - - Gets the current line number. - The current line number. The starting value for this property is 1. - - - Gets the current line position. - The current line position. The starting value for this property is 1. - - - Gets the local name of the current node. - The name of the current node with the prefix removed. For example, is for the element <bk:book>. + The name of the attribute. - For node types that do not have a name (like , , and so on), this property returns String.Empty. - - - Gets the qualified name of the current node. - The qualified name of the current node. For example, is for the element <bk:book>. + The document type name. + + The tag name. - The name returned is dependent on the of the node. The following node types return the listed values. All other node types return an empty string. + The name of the entity referenced. - Node Type Name The name of the attribute. The document type name. The tag name. The name of the entity referenced. The target of the processing instruction. The literal string . + The target of the processing instruction. + + The literal string . Gets or sets a value indicating whether to do namespace support. @@ -8631,17 +8626,78 @@ An asynchronous method was called without that enables you to get the atomized version of a string within the node. - - Gets the type of the current node. - One of the values representing the type of the current node. + + Gets the type of the current node. + One of the values representing the type of the current node. + + + Gets the namespace prefix associated with the current node. + The namespace prefix associated with the current node. + + + Gets the quotation mark character used to enclose the value of an attribute node. + The quotation mark character (" or ') used to enclose the value of an attribute node. + + + Reads the next node from the stream. + + if the next node was read successfully; if there are no more nodes to read. + + + Parses the attribute value into one or more , , or nodes. + + if there are nodes to return. + if the reader is not positioned on an attribute node when the initial call is made or if all the attribute values have been read. +An empty attribute, such as, misc="", returns with a single node with a value of String.Empty. + + + Reads the content and returns the Base64 decoded binary bytes. + The buffer into which to copy the resulting text. This value cannot be . + The offset into the buffer where to start copying the result. + The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. + The value is . + + is not supported on the current node. + The index into the buffer or index + count is larger than the allocated buffer size. + + + Reads the content and returns the BinHex decoded binary bytes. + The buffer into which to copy the resulting text. This value cannot be . + The offset into the buffer where to start copying the result. + The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. + The value is . + + is not supported on the current node. + The index into the buffer or index + count is larger than the allocated buffer size. + The implementation does not support this method. - - Gets the namespace prefix associated with the current node. - The namespace prefix associated with the current node. + + Reads the element and decodes the Base64 content. + The buffer into which to copy the resulting text. This value cannot be . + The offset into the buffer where to start copying the result. + The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. + The value is . + The current node is not an element node. + The index into the buffer or index + count is larger than the allocated buffer size. + The implementation does not support this method. + The element contains mixed-content. + The content cannot be converted to the requested type. - - Gets the quotation mark character used to enclose the value of an attribute node. - The quotation mark character (" or ') used to enclose the value of an attribute node. + + Reads the element and decodes the BinHex content. + The buffer into which to copy the resulting text. This value cannot be . + The offset into the buffer where to start copying the result. + The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. + The number of bytes written to the buffer. + The value is . + The current node is not an element node. + The index into the buffer or index + count is larger than the allocated buffer size. + The implementation does not support this method. + The element contains mixed-content. + The content cannot be converted to the requested type. Gets the used to construct this . @@ -8651,6 +8707,20 @@ An asynchronous method was called without Gets the state of the reader. One of the values. + + Reads the contents of an element or text node as a string. + The contents of the element or text node. This can be an empty string if the reader is positioned on something other than an element or text node, or if there is no more text content to return in the current context. + +The text node can be either an element or an attribute text node. + + + Gets the common language runtime type for the specified XML Schema definition language (XSD) type. + The common language runtime type for the specified XML Schema type. + + + Resolves the entity reference for nodes. + The reader is not positioned on an node. + Gets a to use for validation. The to use for validation. @@ -8660,16 +8730,53 @@ An asynchronous method was called without , , or depending whether the node value is a built in XML Schema definition language (XSD) type or a user defined simpleType or complexType; if the current node has no schema type. + + For a description of this member, see . + An object that identifies the scope of the reader. + An T:System.Collections.IDictionary object that identifies the namespaces in scope. + + + For a description of this member, see . + The namespace prefix. + A string value that contains the namespace Uri that is associated with the prefix. + + + For a description of this member, see . + The namespace that is associated with the prefix. + A string value that contains the namespace prefix that is associated with the . + + + Sets an event handler for receiving information about document type definition (DTD), XML-Data Reduced (XDR) schema, and XML Schema definition language (XSD) schema validation errors. + Gets or sets a value indicating the type of validation to perform. - Setting the property after a Read has been called. One of the values. If this property is not set, it defaults to ValidationType.Auto. + Setting the property after a Read has been called. Gets the text value of the current node. - The value returned depends on the of the node. The following table lists node types that have a value to return. All other node types return String.Empty. + The value returned depends on the of the node. The following table lists node types that have a value to return. All other node types return String.Empty. + Node Type + + Value + + The value of the attribute. - Node Type Value The value of the attribute. The content of the CDATA section. The content of the comment. The internal subset. The entire content, excluding the target. The white space between markup in a mixed content model. The content of the text node. The white space between markup. The content of the declaration. + The content of the CDATA section. + + The content of the comment. + + The internal subset. + + The entire content, excluding the target. + + The white space between markup in a mixed content model. + + The content of the text node. + + The white space between markup. + + The content of the declaration. Gets the current scope. @@ -8677,9 +8784,8 @@ An asynchronous method was called without Sets the used for resolving external document type definition (DTD) and schema location references. The is also used to handle any import or include elements found in XML Schema definition language (XSD) schemas. - The to use. If set to , external resources are not resolved. - - In version 1.1 of the .NET Framework, the caller must be fully trusted to specify an . + The to use. If set to , external resources are not resolved. +In version 1.1 of the .NET Framework, the caller must be fully trusted to specify an . Gets the current scope. @@ -8699,14 +8805,6 @@ An asynchronous method was called without to recursively clone the subtree under the specified node; to clone only the node itself. For white space nodes, the cloned node always includes the data value, regardless of the parameter setting. The cloned node. - - Saves all the children of the node to the specified . - The to which you want to save. - - - Saves the node to the specified . - The to which you want to save. - Gets the local name of the node. For nodes, this property returns . @@ -8729,8 +8827,16 @@ An asynchronous method was called without Gets or sets the value of the node. - Setting to invalid white space characters. The white space characters found in the node. + Setting to invalid white space characters. + + + Saves all the children of the node to the specified . + The to which you want to save. + + + Saves the node to the specified . + The to which you want to save. Represents a writer that provides a fast, non-cached, forward-only way to generate streams or files that contain XML data. @@ -8741,85 +8847,78 @@ An asynchronous method was called without When overridden in a derived class, closes this stream and the underlying stream. A call is made to write more output after has been called or the result of this call is an invalid XML document. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Creates a new instance using the specified stream. The stream to which you want to write. The writes XML 1.0 text syntax and appends it to the specified stream. - The value is . An object. + The value is . Creates a new instance using the stream and object. The stream to which you want to write. The writes XML 1.0 text syntax and appends it to the specified stream. - The object used to configure the new instance. If this is , a with default settings is used. - - If the is being used with the method, you should use the property to obtain an object with the correct settings. This ensures that the created object has the correct output settings. - The value is . + The object used to configure the new instance. If this is , a with default settings is used. +If the is being used with the method, you should use the property to obtain an object with the correct settings. This ensures that the created object has the correct output settings. An object. + The value is . Creates a new instance using the specified . The to which you want to write. The writes XML 1.0 text syntax and appends it to the specified . - The value is . An object. + The value is . Creates a new instance using the and objects. The to which you want to write. The writes XML 1.0 text syntax and appends it to the specified . - The object used to configure the new instance. If this is , a with default settings is used. - - If the is being used with the method, you should use the property to obtain an object with the correct settings. This ensures that the created object has the correct output settings. - The value is . + The object used to configure the new instance. If this is , a with default settings is used. +If the is being used with the method, you should use the property to obtain an object with the correct settings. This ensures that the created object has the correct output settings. An object. + The value is . Creates a new instance using the specified filename. The file to which you want to write. The creates a file at the specified path and writes to it in XML 1.0 text syntax. The must be a file system path. - The value is . An object. + The value is . Creates a new instance using the filename and object. The file to which you want to write. The creates a file at the specified path and writes to it in XML 1.0 text syntax. The must be a file system path. - The object used to configure the new instance. If this is , a with default settings is used. - - If the is being used with the method, you should use the property to obtain an object with the correct settings. This ensures that the created object has the correct output settings. - The value is . + The object used to configure the new instance. If this is , a with default settings is used. +If the is being used with the method, you should use the property to obtain an object with the correct settings. This ensures that the created object has the correct output settings. An object. + The value is . Creates a new instance using the specified . The to which to write to. Content written by the is appended to the . - The value is . An object. + The value is . Creates a new instance using the and objects. The to which to write to. Content written by the is appended to the . - The object used to configure the new instance. If this is , a with default settings is used. - - If the is being used with the method, you should use the property to obtain an object with the correct settings. This ensures that the created object has the correct output settings. - The value is . + The object used to configure the new instance. If this is , a with default settings is used. +If the is being used with the method, you should use the property to obtain an object with the correct settings. This ensures that the created object has the correct output settings. An object. + The value is . Creates a new instance using the specified object. The object that you want to use as the underlying writer. - The value is . An object that is wrapped around the specified object. + The value is . Creates a new instance using the specified and objects. The object that you want to use as the underlying writer. - The object used to configure the new instance. If this is , a with default settings is used. - - If the is being used with the method, you should use the property to obtain an object with the correct settings. This ensures that the created object has the correct output settings. - The value is . + The object used to configure the new instance. If this is , a with default settings is used. +If the is being used with the method, you should use the property to obtain an object with the correct settings. This ensures that the created object has the correct output settings. An object that is wrapped around the specified object. + The value is . Releases all resources used by the current instance of the class. @@ -8831,34 +8930,29 @@ An method was called before a previous asy to release both managed and unmanaged resources; to release only unmanaged resources. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - - Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously. - A task that represents the asynchronous dispose operation. - - - Performs application-defined tasks associated with freeing, releasing, or resetting managed resources asynchronously. - A task that represents the asynchronous dispose operation. - When overridden in a derived class, flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Asynchronously flushes whatever is in the buffer to the underlying streams and also flushes the underlying stream. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, returns the closest prefix defined in the current namespace scope for the namespace URI. The namespace URI whose prefix you want to find. + The matching prefix or if no matching namespace URI is found in the current scope. is either or . An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The matching prefix or if no matching namespace URI is found in the current scope. + + + Gets the object used to create this instance. + The object used to create this writer instance. If this writer was not created using the method, this property returns . + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." When overridden in a derived class, writes out all the attributes found at the current position in the . @@ -8875,21 +8969,17 @@ An asynchronous method was called without The from which to copy the attributes. to copy the default attributes from the ; otherwise, . + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, writes out the attribute with the specified local name and value. The local name of the attribute. The value of the attribute. The state of writer is not or writer is closed. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The or attribute value is invalid. @@ -8899,9 +8989,7 @@ An method was called before a previous asy The namespace URI to associate with the attribute. The value of the attribute. The state of writer is not or writer is closed. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The or attribute value is invalid. @@ -8912,9 +9000,7 @@ An method was called before a previous asy The namespace URI of the attribute. The value of the attribute. The state of writer is not or writer is closed. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The or attribute value is invalid. The or is . @@ -8925,12 +9011,10 @@ An method was called before a previous asy The local name of the attribute. The namespace URI of the attribute. The value of the attribute. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, encodes the specified binary bytes as Base64 and writes out the resulting text. @@ -8940,11 +9024,9 @@ An asynchronous method was called without is . - or is less than zero. - - -or- - - The buffer length minus is less than . + or is less than zero. +-or- +The buffer length minus is less than . An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -8952,12 +9034,10 @@ An asynchronous method was called without Byte array to encode. The position in the buffer indicating the start of the bytes to write. The number of bytes to write. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, encodes the specified binary bytes as and writes out the resulting text. @@ -8968,26 +9048,21 @@ An asynchronous method was called without is . The writer is closed or in error state. -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - or is less than zero. - - -or- - - The buffer length minus is less than . + or is less than zero. +-or- +The buffer length minus is less than . Asynchronously encodes the specified binary bytes as and writes out the resulting text. Byte array to encode. The position in the buffer indicating the start of the bytes to write. The number of bytes to write. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, writes out a <![CDATA[...]]> block containing the specified text. @@ -8998,12 +9073,10 @@ An asynchronous method was called without Asynchronously writes out a <![CDATA[...]]> block containing the specified text. The text to place inside the CDATA block. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, forces the generation of a character entity for the specified Unicode character value. @@ -9014,12 +9087,10 @@ An asynchronous method was called without Asynchronously forces the generation of a character entity for the specified Unicode character value. The Unicode character for which to generate a character entity. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, writes text one buffer at a time. @@ -9029,11 +9100,9 @@ An asynchronous method was called without is . - or is less than zero. - - -or- - - The buffer length minus is less than ; the call results in surrogate pair characters being split or an invalid surrogate pair being written. + or is less than zero. +-or- +The buffer length minus is less than ; the call results in surrogate pair characters being split or an invalid surrogate pair being written. The parameter value is not valid. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -9042,12 +9111,10 @@ An asynchronous method was called without Character array containing the text to write. The position in the buffer indicating the start of the text to write. The number of characters to write. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, writes out a comment <!--...--> containing the specified text. @@ -9058,12 +9125,10 @@ An asynchronous method was called without Asynchronously writes out a comment <!--...--> containing the specified text. Text to place inside the comment. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, writes the DOCTYPE declaration with the specified name and optional attributes. @@ -9072,9 +9137,7 @@ An asynchronous method was called without If is and is non-null it writes SYSTEM "sysid" where is replaced with the value of this argument. If non-null it writes [subset] where subset is replaced with the value of this argument. This method was called outside the prolog (after the root element). - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The value for would result in invalid XML. @@ -9084,22 +9147,18 @@ An method was called before a previous asy If non-null it also writes PUBLIC "pubid" "sysid" where and are replaced with the value of the given arguments. If is and is non-null it writes SYSTEM "sysid" where is replaced with the value of this argument. If non-null it writes [subset] where subset is replaced with the value of this argument. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. Writes an element with the specified local name and value. The local name of the element. The value of the element. - The value is or an empty string. - - -or- - - The parameter values are not valid. + The value is or an empty string. +-or- +The parameter values are not valid. There is a character in the buffer that is a valid XML character but is not valid for the output encoding. For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -9108,11 +9167,9 @@ An asynchronous method was called without The local name of the element. The namespace URI to associate with the element. The value of the element. - The value is or an empty string. - - -or- - - The parameter values are not valid. + The value is or an empty string. +-or- +The parameter values are not valid. There is a character in the buffer that is a valid XML character but is not valid for the output encoding. For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -9122,11 +9179,9 @@ An asynchronous method was called without The local name of the element. The namespace URI of the element. The value of the element. - The value is or an empty string. - - -or- - - The parameter values are not valid. + The value is or an empty string. +-or- +The parameter values are not valid. There is a character in the buffer that is a valid XML character but is not valid for the output encoding. For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -9136,12 +9191,10 @@ An asynchronous method was called without The local name of the element. The namespace URI of the element. The value of the element. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, closes the previous call. @@ -9149,12 +9202,10 @@ An asynchronous method was called without Asynchronously closes the previous call. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, closes any open elements or attributes and puts the writer back in the Start state. @@ -9163,29 +9214,23 @@ An asynchronous method was called without Asynchronously closes any open elements or attributes and puts the writer back in the Start state. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, closes one element and pops the corresponding namespace scope. This results in an invalid XML document. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Asynchronously closes one element and pops the corresponding namespace scope. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, writes out an entity reference as . @@ -9197,12 +9242,10 @@ An asynchronous method was called without Asynchronously writes out an entity reference as . The name of the entity reference. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, closes one element and pops the corresponding namespace scope. @@ -9210,12 +9253,10 @@ An asynchronous method was called without Asynchronously closes one element and pops the corresponding namespace scope. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name). @@ -9227,12 +9268,10 @@ An asynchronous method was called without Asynchronously writes out the specified name, ensuring it is a valid name according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name). The name to write. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name). @@ -9244,12 +9283,10 @@ An asynchronous method was called without Asynchronously writes out the specified name, ensuring it is a valid NmToken according to the W3C XML 1.0 recommendation (https://www.w3.org/TR/1998/REC-xml-19980210#NT-Name). The name to write. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, copies everything from the reader to the writer and moves the reader to the start of the next sibling. @@ -9276,67 +9313,56 @@ An asynchronous method was called without The to read from. to copy the default attributes from the ; otherwise, . + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. Asynchronously copies everything from the object to the writer. The position of the remains unchanged. The to copy from. to copy the default attributes; otherwise, . + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, writes out a processing instruction with a space between the name and text as follows: <?name text?>. The name of the processing instruction. The text to include in the processing instruction. - The text would result in a non-well formed XML document. - - is either or . - - This method is being used to create an XML declaration after has already been called. + The text would result in a non-well formed XML document. + is either or . +This method is being used to create an XML declaration after has already been called. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Asynchronously writes out a processing instruction with a space between the name and text as follows: <?name text?>. The name of the processing instruction. The text to include in the processing instruction. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, writes out the namespace-qualified name. This method looks up the prefix that is in scope for the given namespace. The local name to write. The namespace URI for the name. - is either or . - - is not a valid name. + is either or . + is not a valid name. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Asynchronously writes out the namespace-qualified name. This method looks up the prefix that is in scope for the given namespace. The local name to write. The namespace URI for the name. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, writes raw markup manually from a character buffer. @@ -9346,11 +9372,9 @@ An asynchronous method was called without is . - or is less than zero. - - -or- - - The buffer length minus is less than . + or is less than zero. +-or- +The buffer length minus is less than . An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -9365,30 +9389,24 @@ An asynchronous method was called without Character array containing the text to write. The position within the buffer indicating the start of the text to write. The number of characters to write. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. Asynchronously writes raw markup manually from a string. String containing the text to write. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. Writes the start of an attribute with the specified local name. The local name of the attribute. The writer is closed. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." There is a character in the buffer that is a valid XML character but is not valid for the output encoding. For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections. @@ -9412,56 +9430,44 @@ An method was called before a previous asy The namespace prefix of the attribute. The local name of the attribute. The namespace URI for the attribute. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, writes the XML declaration with the version "1.0". This is not the first write method called after the constructor. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." When overridden in a derived class, writes the XML declaration with the version "1.0" and the standalone attribute. If , it writes "standalone=yes"; if , it writes "standalone=no". This is not the first write method called after the constructor. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Asynchronously writes the XML declaration with the version "1.0". + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. Asynchronously writes the XML declaration with the version "1.0" and the standalone attribute. If , it writes "standalone=yes"; if , it writes "standalone=no". + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, writes out a start tag with the specified local name. The local name of the element. The writer is closed. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." There is a character in the buffer that is a valid XML character but is not valid for the output encoding. For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections. @@ -9470,9 +9476,7 @@ An method was called before a previous asy The local name of the element. The namespace URI to associate with the element. If this namespace is already in scope and has an associated prefix, the writer automatically writes that prefix also. The writer is closed. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." There is a character in the buffer that is a valid XML character but is not valid for the output encoding. For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections. @@ -9482,9 +9486,7 @@ An method was called before a previous asy The local name of the element. The namespace URI to associate with the element. The writer is closed. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." There is a character in the buffer that is a valid XML character but is not valid for the output encoding. For example, if the output encoding is ASCII, you should only use characters from the range of 0 to 127 for element and attribute names. The invalid character might be in the argument of this method or in an argument of previous methods that were writing to the buffer. Such characters are escaped by character entity references when possible (for example, in text nodes or attribute values). However, the character entity reference is not allowed in element and attribute names, comments, processing instructions, or CDATA sections. @@ -9493,12 +9495,15 @@ An method was called before a previous asy The namespace prefix of the element. The local name of the element. The namespace URI to associate with the element. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. + + + When overridden in a derived class, gets the state of the writer. + One of the values. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." When overridden in a derived class, writes the given text content. @@ -9509,12 +9514,10 @@ An asynchronous method was called without Asynchronously writes the given text content. The text to write. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. When overridden in a derived class, generates and writes the surrogate character entity for the surrogate character pair. @@ -9527,12 +9530,10 @@ An asynchronous method was called without Asynchronously generates and writes the surrogate character entity for the surrogate character pair. The low surrogate. This must be a value between 0xDC00 and 0xDFFF. The high surrogate. This must be a value between 0xD800 and 0xDBFF. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. Writes a value. @@ -9577,15 +9578,12 @@ An asynchronous method was called without Writes the object value. - The object value to write. - - Note With the release of the .NET Framework 3.5, this method accepts as a parameter. + The object value to write. +Note With the release of the .NET Framework 3.5, this method accepts as a parameter. An invalid value was specified. The is . The writer is closed or in error state. - -or- - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -9609,34 +9607,29 @@ An method was called before a previous asy Asynchronously writes out the given white space. The string of white space characters. + The task that represents the asynchronous operation. An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - -or- - An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - The task that represents the asynchronous operation. - - - Gets the object used to create this instance. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - The object used to create this writer instance. If this writer was not created using the method, this property returns . - - - When overridden in a derived class, gets the state of the writer. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - One of the values. When overridden in a derived class, gets the current scope. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." The current scope. + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." When overridden in a derived class, gets an representing the current scope. - An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." - An representing the current scope. + An representing the current scope. + Value + + Meaning - Value Meaning This is the default if no scope exists. The current scope is ="default". The current scope is ="preserve". + This is the default if no scope exists. + + The current scope is ="default". + + The current scope is ="preserve". + An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." Specifies a set of features to support on the object created by the method. @@ -9644,13 +9637,6 @@ An asynchronous method was called without Initializes a new instance of the class. - - Creates a copy of the instance. - The cloned object. - - - Resets the members of the settings class to their default values. - Gets or sets a value that indicates whether asynchronous methods can be used on a particular instance. @@ -9661,6 +9647,10 @@ An asynchronous method was called without to do character checking; otherwise, . The default is . + + Creates a copy of the instance. + The cloned object. + Gets or sets a value indicating whether the should also close the underlying stream or when the method is called. @@ -9686,8 +9676,8 @@ An asynchronous method was called without Gets or sets the character string to use when indenting. This setting is used when the property is set to . - The value assigned to the is . The character string to use when indenting. This can be set to any string value. However, to ensure valid XML, you should specify only valid white space characters, such as space characters, tabs, carriage returns, or line feeds. The default is two spaces. + The value assigned to the is . Gets or sets a value that indicates whether the should remove duplicate namespace declarations when writing XML content. The default behavior is for the writer to output all namespace declarations that are present in the writer's namespace resolver. @@ -9695,8 +9685,8 @@ An asynchronous method was called without Gets or sets the character string to use for line breaks. - The value assigned to the is . The character string to use for line breaks. This can be set to any string value. However, to ensure valid XML, you should specify only valid white space characters, such as space characters, tabs, carriage returns, or line feeds. The default is \r\n (carriage return, new line). + The value assigned to the is . Gets or sets a value indicating whether to normalize line breaks in the output. @@ -9705,7 +9695,12 @@ An asynchronous method was called without Gets or sets a value indicating whether to write attributes on a new line. - to write attributes on individual lines; otherwise, . The default is . + to write attributes on individual lines; otherwise, . The default is . + +This setting has no effect when the property value is . + + + When is set to , each attribute is pre-pended with a new line and one extra level of indentation. Gets or sets a value indicating whether to omit an XML declaration. @@ -9716,6 +9711,9 @@ An asynchronous method was called without Gets the method used to serialize the output. One of the values. The default is . + + Resets the members of the settings class to their default values. + Gets or sets a value that indicates whether the will add closing tags to all unclosed element tags when the method is called. @@ -9783,17 +9781,25 @@ An asynchronous method was called without Compiles the XPath expression specified and returns an object representing the XPath expression. An XPath expression. + An object. The XPath expression parameter is not a valid XPath expression. The XPath expression is not valid. - An object. Compiles the specified XPath expression, with the object specified for namespace resolution, and returns an object that represents the XPath expression. An XPath expression. An object that implements the interface for namespace resolution. + An object. The XPath expression parameter is not a valid XPath expression. The XPath expression is not valid. - An object. + + + When overridden in a derived class, gets a representation of the . + A representation of the . + + + When overridden in a derived class, gets the result type of the XPath expression. + An value representing the result type of the XPath expression. When overridden in a derived class, specifies the object to use for namespace resolution. @@ -9805,82 +9811,74 @@ An asynchronous method was called without An object to use for namespace resolution. The object parameter is not derived from the class. - - When overridden in a derived class, gets a representation of the . - A representation of the . - - - When overridden in a derived class, gets the result type of the XPath expression. - An value representing the result type of the XPath expression. - Represents an item in the XQuery 1.0 and XPath 2.0 Data Model. Initializes a new instance of the class. + + When overridden in a derived class, gets a value indicating whether the item represents an XPath node or an atomic value. + + if the item represents an XPath node; if the item represents an atomic value. + + + When overridden in a derived class, gets the current item as a boxed object of the most appropriate .NET Framework 2.0 type according to its schema type. + The current item as a boxed object of the most appropriate .NET Framework type. + + + When overridden in a derived class, gets the value of the item. + The value of the item. + Returns the item's value as the specified type. The type to return the item value as. + The value of the item as the type requested. The item's value is not in the correct format for the target type. The attempted cast is not valid. The attempted cast resulted in an overflow. - The value of the item as the type requested. When overridden in a derived class, returns the item's value as the type specified using the object specified to resolve namespace prefixes. The type to return the item's value as. The object used to resolve namespace prefixes. + The value of the item as the type requested. The item's value is not in the correct format for the target type. The attempted cast is not valid. The attempted cast resulted in an overflow. - The value of the item as the type requested. - - - When overridden in a derived class, gets a value indicating whether the item represents an XPath node or an atomic value. - - if the item represents an XPath node; if the item represents an atomic value. - - - When overridden in a derived class, gets the current item as a boxed object of the most appropriate .NET Framework 2.0 type according to its schema type. - The current item as a boxed object of the most appropriate .NET Framework type. - - - When overridden in a derived class, gets the value of the item. - The value of the item. When overridden in a derived class, gets the item's value as a . + The item's value as a . The item's value is not in the correct format for the type. The attempted cast to is not valid. - The item's value as a . When overridden in a derived class, gets the item's value as a . + The item's value as a . The item's value is not in the correct format for the type. The attempted cast to is not valid. - The item's value as a . When overridden in a derived class, gets the item's value as a . + The item's value as a . The item's value is not in the correct format for the type. The attempted cast to is not valid. The attempted cast resulted in an overflow. - The item's value as a . When overridden in a derived class, gets the item's value as an . + The item's value as an . The item's value is not in the correct format for the type. The attempted cast to is not valid. The attempted cast resulted in an overflow. - The item's value as an . When overridden in a derived class, gets the item's value as an . + The item's value as an . The item's value is not in the correct format for the type. The attempted cast to is not valid. The attempted cast resulted in an overflow. - The item's value as an . When overridden in a derived class, gets the .NET Framework 2.0 type of the item. @@ -9910,9 +9908,9 @@ An asynchronous method was called without Returns an object used to create one or more new child nodes at the end of the list of child nodes of the current node. + An object used to create new child nodes at the end of the list of child nodes of the current node. The current node the is positioned on is not the root node or an element node. The does not support editing. - An object used to create new child nodes at the end of the list of child nodes of the current node. Creates a new child node at the end of the list of child nodes of the current node using the XML data string specified. @@ -9947,15 +9945,24 @@ An asynchronous method was called without The current node the is positioned on is not the root node or an element node. The does not support editing. + + When overridden in a derived class, gets the base URI for the current node. + The location from which the node was loaded, or if there is no value. + + + Gets a value that indicates whether the can edit the underlying XML data. + + if the can edit the underlying XML data; otherwise, . + Verifies that the XML data in the conforms to the XML Schema definition language (XSD) schema provided. The containing the schemas used to validate the XML data contained in the . The that receives information about schema validation warnings and errors. + + if no schema validation errors occurred; otherwise, . A schema validation error occurred, and no was specified to handle validation errors. The is positioned on a node that is not an element, attribute, or the root node or there is not type information to perform validation. The method was called with an parameter when the was not positioned on the root node of the XML data. - - if no schema validation errors occurred; otherwise, . When overridden in a derived class, creates a new positioned at the same node as this . @@ -9969,9 +9976,9 @@ An asynchronous method was called without Compiles a string representing an XPath expression and returns an object. A string representing an XPath expression. + An object representing the XPath expression. The parameter contains an XPath expression that is not valid. The XPath expression is not valid. - An object representing the XPath expression. Creates an attribute node on the current element node using the namespace prefix, local name and namespace URI specified with the value specified. @@ -9984,9 +9991,9 @@ An asynchronous method was called without Returns an object used to create new attributes on the current element. + An object used to create new attributes on the current element. The is not positioned on an element node. The does not support editing. - An object used to create new attributes on the current element. Returns a copy of the . @@ -10007,32 +10014,32 @@ An asynchronous method was called without Evaluates the specified XPath expression and returns the typed result. A string representing an XPath expression that can be evaluated. + The result of the expression (Boolean, number, string, or node set). This maps to , , , or objects respectively. The return type of the XPath expression is a node set. The XPath expression is not valid. - The result of the expression (Boolean, number, string, or node set). This maps to , , , or objects respectively. Evaluates the specified XPath expression and returns the typed result, using the object specified to resolve namespace prefixes in the XPath expression. A string representing an XPath expression that can be evaluated. The object used to resolve namespace prefixes in the XPath expression. + The result of the expression (Boolean, number, string, or node set). This maps to , , , or objects respectively. The return type of the XPath expression is a node set. The XPath expression is not valid. - The result of the expression (Boolean, number, string, or node set). This maps to , , , or objects respectively. Evaluates the and returns the typed result. An that can be evaluated. + The result of the expression (Boolean, number, string, or node set). This maps to , , , or objects respectively. The return type of the XPath expression is a node set. The XPath expression is not valid. - The result of the expression (Boolean, number, string, or node set). This maps to , , , or objects respectively. Uses the supplied context to evaluate the , and returns the typed result. An that can be evaluated. An that points to the selected node set that the evaluation is to be performed on. + The result of the expression (Boolean, number, string, or node set). This maps to , , , or objects respectively. The return type of the XPath expression is a node set. The XPath expression is not valid. - The result of the expression (Boolean, number, string, or node set). This maps to , , , or objects respectively. Gets the value of the attribute with the specified local name and namespace URI. @@ -10050,11 +10057,26 @@ An asynchronous method was called without An value specifying the namespaces to return. An collection of namespace names keyed by prefix. + + Gets a value that indicates whether the current node has any attributes. + + if the current node has attributes; returns if the current node has no attributes, or if the is not positioned on an element node. + + + Gets a value that indicates whether the current node has any child nodes. + + if the current node has any child nodes; otherwise, . + + + Gets or sets the markup representing the child nodes of the current node. + A that contains the markup of the child nodes of the current node. + The property cannot be set. + Returns an object used to create a new sibling node after the currently selected node. + An object used to create a new sibling node after the currently selected node. The position of the does not allow a new sibling node to be inserted after the current node. The does not support editing. - An object used to create a new sibling node after the currently selected node. Creates a new sibling node after the currently selected node using the XML string specified. @@ -10082,9 +10104,9 @@ An asynchronous method was called without Returns an object used to create a new sibling node before the currently selected node. + An object used to create a new sibling node before the currently selected node. The position of the does not allow a new sibling node to be inserted before the current node. The does not support editing. - An object used to create a new sibling node before the currently selected node. Creates a new sibling node before the currently selected node using the XML string specified. @@ -10134,12 +10156,25 @@ An asynchronous method was called without if the specified is a descendant of the current ; otherwise, . + + When overridden in a derived class, gets a value that indicates whether the current node is an empty element without an end element tag. + + if the current node is an empty element; otherwise, . + + + Gets a value that indicates if the current node represents an XPath node. + Always returns . + When overridden in a derived class, determines whether the current is at the same position as the specified . The to compare to this . if the two objects have the same position; otherwise, . + + When overridden in a derived class, gets the of the current node without any namespace prefix. + A that contains the local name of the current node, or if the current node does not have a name (for example, text or comment nodes). + Gets the namespace URI for the specified prefix. The prefix whose namespace URI you want to resolve. To match the default namespace, pass . @@ -10153,18 +10188,18 @@ An asynchronous method was called without Determines whether the current node matches the specified XPath expression. The XPath expression. - The XPath expression cannot be evaluated. - The XPath expression is not valid. if the current node matches the specified XPath expression; otherwise, . + The XPath expression cannot be evaluated. + The XPath expression is not valid. Determines whether the current node matches the specified . An object containing the compiled XPath expression. - The XPath expression cannot be evaluated. - The XPath expression is not valid. if the current node matches the ; otherwise, . + The XPath expression cannot be evaluated. + The XPath expression is not valid. When overridden in a derived class, moves the to the same position as the specified . @@ -10195,9 +10230,8 @@ An asynchronous method was called without Moves the to the first sibling node of the current node. - if the is successful moving to the first sibling node of the current node; if there is no first sibling, or if the is currently positioned on an attribute node. If the is already positioned on the first sibling, will return and will not move its position. - - If returns because there is no first sibling, or if is currently positioned on an attribute, the position of the is unchanged. + if the is successful moving to the first sibling node of the current node; if there is no first sibling, or if the is currently positioned on an attribute node. If the is already positioned on the first sibling, will return and will not move its position. +If returns because there is no first sibling, or if is currently positioned on an attribute, the position of the is unchanged. When overridden in a derived class, moves the to the first attribute of the current node. @@ -10294,24 +10328,52 @@ An asynchronous method was called without if the is successful moving to the next namespace node; otherwise, . If , the position of the is unchanged. - - When overridden in a derived class, moves the to the parent node of the current node. - - if the is successful moving to the parent node of the current node; otherwise, . If , the position of the is unchanged. + + When overridden in a derived class, moves the to the parent node of the current node. + + if the is successful moving to the parent node of the current node; otherwise, . If , the position of the is unchanged. + + + When overridden in a derived class, moves the to the previous sibling node of the current node. + + if the is successful moving to the previous sibling node; otherwise, if there is no previous sibling node or if the is currently positioned on an attribute node. If , the position of the is unchanged. + + + Moves the to the root node that the current node belongs to. + + + When overridden in a derived class, gets the qualified name of the current node. + A that contains the qualified of the current node, or if the current node does not have a name (for example, text or comment nodes). + + + When overridden in a derived class, gets the namespace URI of the current node. + A that contains the namespace URI of the current node, or if the current node has no namespace URI. + + + When overridden in a derived class, gets the of the . + An object enabling you to get the atomized version of a within the XML document. + + + Gets an used for equality comparison of objects. + An used for equality comparison of objects. + + + When overridden in a derived class, gets the of the current node. + One of the values representing the current node. - - When overridden in a derived class, moves the to the previous sibling node of the current node. - - if the is successful moving to the previous sibling node; otherwise, if there is no previous sibling node or if the is currently positioned on an attribute node. If , the position of the is unchanged. + + Gets or sets the markup representing the opening and closing tags of the current node and its child nodes. + A that contains the markup representing the opening and closing tags of the current node and its child nodes. - - Moves the to the root node that the current node belongs to. + + When overridden in a derived class, gets the namespace prefix associated with the current node. + A that contains the namespace prefix associated with the current node. Returns an object used to create a new child node at the beginning of the list of child nodes of the current node. + An object used to create a new child node at the beginning of the list of child nodes of the current node. The current node the is positioned on does not allow a new child node to be prepended. The does not support editing. - An object used to create a new child node at the beginning of the list of child nodes of the current node. Creates a new child node at the beginning of the list of child nodes of the current node using the XML string specified. @@ -10348,16 +10410,16 @@ An asynchronous method was called without Returns an object that contains the current node and its child nodes. - The is not positioned on an element node or the root node. An object that contains the current node and its child nodes. + The is not positioned on an element node or the root node. Replaces a range of sibling nodes from the current node to the node specified. An positioned on the last sibling node in the range to replace. + An object used to specify the replacement range. The specified is . The does not support editing. The last node to replace specified is not a valid sibling node of the current node. - An object used to specify the replacement range. Replaces the current node with the content of the string specified. @@ -10384,36 +10446,40 @@ An asynchronous method was called without The does not support editing. The XML contents of the object parameter is not well-formed. + + Gets the schema information that has been assigned to the current node as a result of schema validation. + An object that contains the schema information for the current node. + Selects a node set, using the specified XPath expression. A representing an XPath expression. + An pointing to the selected node set. The XPath expression contains an error or its return type is not a node set. The XPath expression is not valid. - An pointing to the selected node set. Selects a node set using the specified XPath expression with the object specified to resolve namespace prefixes. A representing an XPath expression. The object used to resolve namespace prefixes. + An that points to the selected node set. The XPath expression contains an error or its return type is not a node set. The XPath expression is not valid. - An that points to the selected node set. Selects a node set using the specified . An object containing the compiled XPath query. + An that points to the selected node set. The XPath expression contains an error or its return type is not a node set. The XPath expression is not valid. - An that points to the selected node set. Selects all the ancestor nodes of the current node that have the specified local name and namespace URI. The local name of the ancestor nodes. The namespace URI of the ancestor nodes. To include the context node in the selection, ; otherwise, . + An that contains the selected nodes. The returned nodes are in reverse document order. cannot be passed as a parameter. - An that contains the selected nodes. The returned nodes are in reverse document order. Selects all the ancestor nodes of the current node that have a matching . @@ -10425,9 +10491,9 @@ An asynchronous method was called without Selects all the child nodes of the current node that have the local name and namespace URI specified. The local name of the child nodes. The namespace URI of the child nodes. + An that contains the selected nodes. cannot be passed as a parameter. - An that contains the selected nodes. Selects all the child nodes of the current node that have the matching . @@ -10440,9 +10506,9 @@ An asynchronous method was called without The namespace URI of the descendant nodes. to include the context node in the selection; otherwise, . + An that contains the selected nodes. cannot be passed as a parameter. - An that contains the selected nodes. Selects all the descendant nodes of the current node that have a matching . @@ -10454,24 +10520,24 @@ An asynchronous method was called without Selects a single node in the using the specified XPath query. A representing an XPath expression. + An object that contains the first matching node for the XPath query specified; otherwise, if there are no query results. An error was encountered in the XPath query or the return type of the XPath expression is not a node. The XPath query is not valid. - An object that contains the first matching node for the XPath query specified; otherwise, if there are no query results. Selects a single node in the object using the specified XPath query with the object specified to resolve namespace prefixes. A representing an XPath expression. The object used to resolve namespace prefixes in the XPath query. + An object that contains the first matching node for the XPath query specified; otherwise if there are no query results. An error was encountered in the XPath query or the return type of the XPath expression is not a node. The XPath query is not valid. - An object that contains the first matching node for the XPath query specified; otherwise if there are no query results. Selects a single node in the using the specified object. An object containing the compiled XPath query. + An object that contains the first matching node for the XPath query specified; otherwise if there are no query results. An error was encountered in the XPath query or the return type of the XPath expression is not a node. The XPath query is not valid. - An object that contains the first matching node for the XPath query specified; otherwise if there are no query results. Sets the typed value of the current node. @@ -10496,128 +10562,59 @@ An asynchronous method was called without Gets the text value of the current node. A that contains the text value of the current node. + + Gets the current node as a boxed object of the most appropriate .NET Framework type. + The current node as a boxed object of the most appropriate .NET Framework type. + + + Used by implementations which provide a "virtualized" XML view over a store, to provide access to underlying objects. + The default is . + Gets the current node's value as the specified, using the object specified to resolve namespace prefixes. The to return the current node's value as. The object used to resolve namespace prefixes. + The value of the current node as the requested. The current node's value is not in the correct format for the target type. The attempted cast is not valid. - The value of the current node as the requested. - - - Streams the current node and its child nodes to the object specified. - The object to stream to. - - - When overridden in a derived class, gets the base URI for the current node. - The location from which the node was loaded, or if there is no value. - - - Gets a value that indicates whether the can edit the underlying XML data. - - if the can edit the underlying XML data; otherwise, . - - - Gets a value that indicates whether the current node has any attributes. - - if the current node has attributes; returns if the current node has no attributes, or if the is not positioned on an element node. - - - Gets a value that indicates whether the current node has any child nodes. - - if the current node has any child nodes; otherwise, . - - - Gets or sets the markup representing the child nodes of the current node. - The property cannot be set. - A that contains the markup of the child nodes of the current node. - - - When overridden in a derived class, gets a value that indicates whether the current node is an empty element without an end element tag. - - if the current node is an empty element; otherwise, . - - - Gets a value that indicates if the current node represents an XPath node. - Always returns . - - - When overridden in a derived class, gets the of the current node without any namespace prefix. - A that contains the local name of the current node, or if the current node does not have a name (for example, text or comment nodes). - - - When overridden in a derived class, gets the qualified name of the current node. - A that contains the qualified of the current node, or if the current node does not have a name (for example, text or comment nodes). - - - When overridden in a derived class, gets the namespace URI of the current node. - A that contains the namespace URI of the current node, or if the current node has no namespace URI. - - - When overridden in a derived class, gets the of the . - An object enabling you to get the atomized version of a within the XML document. - - - Gets an used for equality comparison of objects. - An used for equality comparison of objects. - - - When overridden in a derived class, gets the of the current node. - One of the values representing the current node. - - - Gets or sets the markup representing the opening and closing tags of the current node and its child nodes. - A that contains the markup representing the opening and closing tags of the current node and its child nodes. - - - When overridden in a derived class, gets the namespace prefix associated with the current node. - A that contains the namespace prefix associated with the current node. - - - Gets the schema information that has been assigned to the current node as a result of schema validation. - An object that contains the schema information for the current node. - - - Gets the current node as a boxed object of the most appropriate .NET type. - The current node as a boxed object of the most appropriate .NET type. - - - Used by implementations which provide a "virtualized" XML view over a store, to provide access to underlying objects. - The default is . Gets the current node's value as a . + The current node's value as a . The current node's string value cannot be converted to a . The attempted cast to is not valid. - The current node's value as a . Gets the current node's value as a . + The current node's value as a . The current node's string value cannot be converted to a . The attempted cast to is not valid. - The current node's value as a . Gets the current node's value as a . + The current node's value as a . The current node's string value cannot be converted to a . The attempted cast to is not valid. - The current node's value as a . Gets the current node's value as an . + The current node's value as an . The current node's string value cannot be converted to a . The attempted cast to is not valid. - The current node's value as an . Gets the current node's value as an . + The current node's value as an . The current node's string value cannot be converted to a . The attempted cast to is not valid. - The current node's value as an . - Gets the .NET of the current node. - The .NET of the current node. The default value is . + Gets the .NET Framework of the current node. + The .NET Framework of the current node. The default value is . + + + Streams the current node and its child nodes to the object specified. + The object to stream to. Gets the xml:lang scope for the current node. @@ -10637,6 +10634,18 @@ An asynchronous method was called without When overridden in a derived class, returns a clone of this object. A new object clone of this object. + + Gets the index of the last node in the selected set of nodes. + The index of the last node in the selected set of nodes, or 0 if there are no selected nodes. + + + When overridden in a derived class, gets the object for this , positioned on the current context node. + An object positioned on the context node from which the node set was selected. The method must be called to move the to the first node in the selected set. + + + When overridden in a derived class, gets the index of the current position in the selected set of nodes. + The index of the current position. + Returns an object to iterate through the selected node set. An object to iterate through the selected node set. @@ -10650,18 +10659,6 @@ An asynchronous method was called without Creates a new object that is a copy of the current instance. A new object that is a copy of this instance. - - Gets the index of the last node in the selected set of nodes. - The index of the last node in the selected set of nodes, or 0 if there are no selected nodes. - - - When overridden in a derived class, gets the object for this , positioned on the current context node. - An object positioned on the context node from which the node set was selected. The method must be called to move the to the first node in the selected set. - - - When overridden in a derived class, gets the index of the current position in the selected set of nodes. - The index of the current position. - Defines the XPath node types that can be returned from the class. @@ -10672,7 +10669,7 @@ An asynchronous method was called without An attribute, such as id='123'. - A comment, such as <!-- my comment -->. + A comment, such as <!-- my comment --> An element, such as <element>. @@ -10722,6 +10719,10 @@ An asynchronous method was called without Provides an interface to a given function defined in the Extensible Stylesheet Language for Transformations (XSLT) style sheet during runtime execution. + + Gets the supplied XML Path Language (XPath) types for the function's argument list. This information can be used to discover the signature of the function which allows you to differentiate between overloaded functions. + An array of representing the types for the function's argument list. + Provides the method to invoke the function with the given arguments in the given context. The XSLT context for the function call. @@ -10729,10 +10730,6 @@ An asynchronous method was called without The context node for the function call. An representing the return value of the function. - - Gets the supplied XML Path Language (XPath) types for the function's argument list. This information can be used to discover the signature of the function which allows you to differentiate between overloaded functions. - An array of representing the types for the function's argument list. - Gets the maximum number of arguments for the function. This enables the user to differentiate between overloaded functions. The maximum number of arguments for the function. @@ -10743,7 +10740,7 @@ An asynchronous method was called without Gets the representing the XPath type returned by the function. - An representing the XPath type returned by the function. + An representing the XPath type returned by the function Provides an interface to a given variable that is defined in the style sheet during runtime execution. @@ -10791,11 +10788,9 @@ An asynchronous method was called without The style sheet contains an error. The style sheet cannot be found. The value includes a filename or directory that cannot be found. - The value cannot be resolved. - - -or- - - An error occurred while processing the request. + The value cannot be resolved. +-or- +An error occurred while processing the request. is not a valid URI. There was a parsing error loading the style sheet. @@ -10809,20 +10804,17 @@ An asynchronous method was called without The style sheet contains an error. The style sheet cannot be found. The value includes a filename or directory that cannot be found. - The value cannot be resolved. - - -or- - - An error occurred while processing the request. + The value cannot be resolved. +-or- +An error occurred while processing the request. is not a valid URI. There was a parsing error loading the style sheet. Loads the compiled style sheet that was created using the XSLT Compiler (xsltc.exe). - The name of the class that contains the compiled style sheet. - - This is usually the name of the style sheet. Unless otherwise specified, the xsltc.exe tool uses the name of the style sheet for the class and assembly names. + The name of the class that contains the compiled style sheet. +This is usually the name of the style sheet. Unless otherwise specified, the xsltc.exe tool uses the name of the style sheet for the class and assembly names. Compiles the style sheet contained in the . @@ -10852,6 +10844,10 @@ An asynchronous method was called without The value is . The style sheet contains an error. + + Gets an object that contains the output information derived from the xsl:output element of the style sheet. + A read-only object that contains the output information derived from the xsl:output element of the style sheet. This value can be . + Executes the transform using the input document specified by the URI and outputs the results to a file. The URI of the input document. @@ -10860,11 +10856,9 @@ An asynchronous method was called without There was an error executing the XSLT transform. The input document cannot be found. The or value includes a filename or directory cannot be found. - The or value cannot be resolved. - - -or- - - An error occurred while processing the request. + The or value cannot be resolved. +-or- +An error occurred while processing the request or is not a valid URI. There was a parsing error loading the input document. @@ -10872,17 +10866,14 @@ An asynchronous method was called without Executes the transform using the input document specified by the URI and outputs the results to an . The URI of the input document. - The to which you want to output. - - If the style sheet contains an xsl:output element, you should create the using the object returned from the property. This ensures that the has the correct output settings. + The to which you want to output. +If the style sheet contains an xsl:output element, you should create the using the object returned from the property. This ensures that the has the correct output settings. The or value is . There was an error executing the XSLT transform. The value includes a filename or directory cannot be found. - The value cannot be resolved. - - -or- - - An error occurred while processing the request. + The value cannot be resolved. +-or- +An error occurred while processing the request. is not a valid URI. There was a parsing error loading the input document. @@ -10895,11 +10886,9 @@ An asynchronous method was called without The or value is . There was an error executing the XSLT transform. The value includes a filename or directory cannot be found. - The value cannot be resolved. - - -or- - - An error occurred while processing the request. + The value cannot be resolved. +-or- +An error occurred while processing the request is not a valid URI. There was a parsing error loading the input document. @@ -10912,11 +10901,9 @@ An asynchronous method was called without The or value is . There was an error executing the XSLT transform. The value includes a filename or directory cannot be found. - The value cannot be resolved. - - -or- - - An error occurred while processing the request. + The value cannot be resolved. +-or- +An error occurred while processing the request is not a valid URI. There was a parsing error loading the input document. @@ -10925,17 +10912,14 @@ An asynchronous method was called without Executes the transform using the input document specified by the URI and outputs the results to an . The provides additional run-time arguments. The URI of the input document. An containing the namespace-qualified arguments used as input to the transform. This value can be . - The to which you want to output. - - If the style sheet contains an xsl:output element, you should create the using the object returned from the property. This ensures that the has the correct output settings. + The to which you want to output. +If the style sheet contains an xsl:output element, you should create the using the object returned from the property. This ensures that the has the correct output settings. The or value is . There was an error executing the XSLT transform. The value includes a filename or directory cannot be found. - The value cannot be resolved. - - -or- - - An error occurred while processing the request. + The value cannot be resolved. +-or- +An error occurred while processing the request. is not a valid URI. There was a parsing error loading the input document. @@ -10943,9 +10927,8 @@ An asynchronous method was called without Executes the transform using the input document specified by the object and outputs the results to an . The containing the input document. - The to which you want to output. - - If the style sheet contains an xsl:output element, you should create the using the object returned from the property. This ensures that the has the correct output settings. + The to which you want to output. +If the style sheet contains an xsl:output element, you should create the using the object returned from the property. This ensures that the has the correct output settings. The or value is . There was an error executing the XSLT transform. @@ -10969,9 +10952,8 @@ An asynchronous method was called without Executes the transform using the input document specified by the object and outputs the results to an . The provides additional run-time arguments. An containing the input document. An containing the namespace-qualified arguments used as input to the transform. This value can be . - The to which you want to output. - - If the style sheet contains an xsl:output element, you should create the using the object returned from the property. This ensures that the has the correct output settings. + The to which you want to output. +If the style sheet contains an xsl:output element, you should create the using the object returned from the property. This ensures that the has the correct output settings. The or value is . There was an error executing the XSLT transform. @@ -10979,9 +10961,8 @@ An asynchronous method was called without Executes the transform using the input document specified by the object and outputs the results to an . The provides additional run-time arguments and the XmlResolver resolves the XSLT document() function. An containing the input document. An containing the namespace-qualified arguments used as input to the transform. This value can be . - The to which you want to output. - - If the style sheet contains an xsl:output element, you should create the using the object returned from the property. This ensures that the has the correct output settings. + The to which you want to output. +If the style sheet contains an xsl:output element, you should create the using the object returned from the property. This ensures that the has the correct output settings. The used to resolve the XSLT document() function. If this is , the document() function is not resolved. The or value is . There was an error executing the XSLT transform. @@ -10989,9 +10970,8 @@ An asynchronous method was called without Executes the transform using the input document specified by the object and outputs the results to an . An object implementing the interface. In the Microsoft .NET Framework, this can be either an (typically an ), or an containing the data to be transformed. - The to which you want to output. - - If the style sheet contains an xsl:output element, you should create the using the object returned from the property. This ensures that the has the correct output settings. + The to which you want to output. +If the style sheet contains an xsl:output element, you should create the using the object returned from the property. This ensures that the has the correct output settings. The or value is . There was an error executing the XSLT transform. @@ -11015,9 +10995,8 @@ An asynchronous method was called without Executes the transform using the input document specified by the object and outputs the results to an . The provides additional run-time arguments. An object implementing the interface. In the Microsoft .NET Framework, this can be either an (typically an ), or an containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transform. This value can be . - The to which you want to output. - - If the style sheet contains an xsl:output element, you should create the using the object returned from the property. This ensures that the has the correct output settings. + The to which you want to output. +If the style sheet contains an xsl:output element, you should create the using the object returned from the property. This ensures that the has the correct output settings. The or value is . There was an error executing the XSLT transform. @@ -11025,21 +11004,13 @@ An asynchronous method was called without Executes the transform by using the input document that is specified by the object and outputs the results to an . The provides additional run-time arguments and the resolves the XSLT function. The document to transform that is specified by the object. Argument list as . - The to which you want to output. - - If the style sheet contains an element, you should create the by using the object that is returned from the property. This ensures that the has the correct output settings. + The to which you want to output. +If the style sheet contains an element, you should create the by using the object that is returned from the property. This ensures that the has the correct output settings. The used to resolve the XSLT function. If this is , the function is not resolved. - - Gets an object that contains the output information derived from the xsl:output element of the style sheet. - A read-only object that contains the output information derived from the xsl:output element of the style sheet. This value can be . - Contains a variable number of arguments which are either XSLT parameters or extension objects. - - Occurs when a message is specified in the style sheet by the xsl:message element. - Implements a new instance of the . @@ -11047,9 +11018,8 @@ An asynchronous method was called without Adds a new object to the and associates it with the namespace URI. The namespace URI to associate with the object. To use the default namespace, specify an empty string. The object to add to the list. - The is either or http://www.w3.org/1999/XSL/Transform - - The already has an extension object associated with it. + The is either or http://www.w3.org/1999/XSL/Transform +The already has an extension object associated with it. The caller does not have sufficient permissions to call this method. @@ -11057,11 +11027,9 @@ An asynchronous method was called without The name to associate with the parameter. The namespace URI to associate with the parameter. To use the default namespace, specify an empty string. The parameter value or object to add to the list. - The is either or http://www.w3.org/1999/XSL/Transform. - - The is not a valid name according to the W3C XML specification. - - The already has a parameter associated with it. + The is either or http://www.w3.org/1999/XSL/Transform. +The is not a valid name according to the W3C XML specification. +The already has a parameter associated with it. Removes all parameters and extension objects from the . @@ -11088,6 +11056,9 @@ An asynchronous method was called without The namespace URI of the parameter to remove. The parameter object or if one was not found. + + Occurs when a message is specified in the style sheet by the xsl:message element. + The exception that is thrown by the Load method when an error is found in the XSLT style sheet. @@ -11231,11 +11202,9 @@ An asynchronous method was called without Loads the XSLT style sheet specified by a URL. The URL that specifies the XSLT style sheet to load. - The to use to load the style sheet and any style sheet(s) referenced in xsl:import and xsl:include elements. - - If this is , a default with no user credentials is used to open the style sheet. The default is not used to resolve any external resources in the style sheet, so xsl:import and xsl:include elements are not resolved. - - The is not cached after the method completes. + The to use to load the style sheet and any style sheet(s) referenced in xsl:import and xsl:include elements. +If this is , a default with no user credentials is used to open the style sheet. The default is not used to resolve any external resources in the style sheet, so xsl:import and xsl:include elements are not resolved. +The is not cached after the method completes. The loaded resource is not a valid style sheet. The style sheet contains embedded script, and the caller does not have permission. @@ -11248,9 +11217,8 @@ An asynchronous method was called without Loads the XSLT style sheet contained in the . An object that contains the XSLT style sheet. - The used to load any style sheets referenced in xsl:import and xsl:include elements. If this is , external resources are not resolved. - - The is not cached after the method completes. + The used to load any style sheets referenced in xsl:import and xsl:include elements. If this is , external resources are not resolved. +The is not cached after the method completes. The current node does not conform to a valid style sheet. The style sheet contains embedded scripts, and the caller does not have permission. @@ -11263,9 +11231,8 @@ An asynchronous method was called without Loads the XSLT style sheet contained in the . An object implementing the interface. In the .NET Framework, this can be either an (typically an ), or an containing the XSLT style sheet. - The used to load any style sheets referenced in xsl:import and xsl:include elements. If this is , external resources are not resolved. - - The is not cached after the method completes. + The used to load any style sheets referenced in xsl:import and xsl:include elements. If this is , external resources are not resolved. +The is not cached after the method completes. The loaded resource is not a valid style sheet. The style sheet contains embedded scripts, and the caller does not have permission. @@ -11278,9 +11245,8 @@ An asynchronous method was called without Loads the XSLT style sheet contained in the . An object that contains the XSLT style sheet. - The used to load any style sheets referenced in xsl:import and xsl:include elements. If this is , external resources are not resolved. - - The is not cached after the method completes. + The used to load any style sheets referenced in xsl:import and xsl:include elements. If this is , external resources are not resolved. +The is not cached after the method completes. The current node does not conform to a valid style sheet. The style sheet contains embedded scripts, and the caller does not have permission. @@ -11293,9 +11259,8 @@ An asynchronous method was called without Transforms the XML data in the input file and outputs the result to an output file. The URL of the source document to be transformed. The URL of the output file. - The used to resolve the XSLT document() function. If this is , the document() function is not resolved. - - The is not cached after the method completes. + The used to resolve the XSLT document() function. If this is , the document() function is not resolved. +The is not cached after the method completes. Transforms the XML data in the using the specified and outputs the result to an . @@ -11308,50 +11273,43 @@ An asynchronous method was called without An object implementing the interface. In the .NET Framework, this can be either an (typically an ), or an containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transformation. The stream to which you want to output. - There was an error processing the XSLT transformation. - - Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. + There was an error processing the XSLT transformation. +Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. Transforms the XML data in the using the specified and outputs the result to a . An object implementing the interface. In the .NET Framework, this can be either an (typically an ), or an containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transformation. The stream to which you want to output. - The used to resolve the XSLT document() function. If this is , the document() function is not resolved. - - The is not cached after the method completes. - There was an error processing the XSLT transformation. - - Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. + The used to resolve the XSLT document() function. If this is , the document() function is not resolved. +The is not cached after the method completes. + There was an error processing the XSLT transformation. +Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. Transforms the XML data in the using the specified and outputs the result to a . An object implementing the interface. In the .NET Framework, this can be either an (typically an ), or an containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transformation. The to which you want to output. - There was an error processing the XSLT transformation. - - Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. + There was an error processing the XSLT transformation. +Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. Transforms the XML data in the using the specified and outputs the result to a . An object implementing the interface. In the .NET Framework, this can be either an (typically an ), or an containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transformation. The to which you want to output. - The used to resolve the XSLT document() function. If this is , the document() function is not resolved. - - The is not cached after the method completes. - There was an error processing the XSLT transformation. - - Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. + The used to resolve the XSLT document() function. If this is , the document() function is not resolved. +The is not cached after the method completes. + There was an error processing the XSLT transformation. +Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. Transforms the XML data in the using the specified and outputs the result to an . An object implementing the interface. In the .NET Framework, this can be either an (typically an ), or an containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transformation. - The used to resolve the XSLT document() function. If this is , the document() function is not resolved. - - The is not cached after the method completes. + The used to resolve the XSLT document() function. If this is , the document() function is not resolved. +The is not cached after the method completes. An containing the results of the transformation. @@ -11359,105 +11317,90 @@ An asynchronous method was called without An object implementing the interface. In the .NET Framework, this can be either an (typically an ), or an containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transformation. The to which you want to output. - There was an error processing the XSLT transformation. - - Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. + There was an error processing the XSLT transformation. +Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. Transforms the XML data in the using the specified and outputs the result to an . An object implementing the interface. In the .NET Framework, this can be either an (typically an ), or an containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transformation. The to which you want to output. - The used to resolve the XSLT document() function. If this is , the document() function is not resolved. - - The is not cached after the method completes. - There was an error processing the XSLT transformation. - - Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. + The used to resolve the XSLT document() function. If this is , the document() function is not resolved. +The is not cached after the method completes. + There was an error processing the XSLT transformation. +Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. Transforms the XML data in the using the specified and outputs the result to an . An containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transformation. - There was an error processing the XSLT transformation. - - Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. An containing the results of the transformation. + There was an error processing the XSLT transformation. +Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. Transforms the XML data in the using the specified and outputs the result to a . An containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transformation. The stream to which you want to output. - There was an error processing the XSLT transformation. - - Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. + There was an error processing the XSLT transformation. +Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. Transforms the XML data in the using the specified and outputs the result to a . An containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transformation. The stream to which you want to output. - The used to resolve the XSLT document() function. If this is , the document() function is not resolved. - - The is not cached after the method completes. - There was an error processing the XSLT transformation. - - Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. + The used to resolve the XSLT document() function. If this is , the document() function is not resolved. +The is not cached after the method completes. + There was an error processing the XSLT transformation. +Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. Transforms the XML data in the using the specified and outputs the result to a . An containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transformation. The to which you want to output. - There was an error processing the XSLT transformation. - - Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. + There was an error processing the XSLT transformation. +Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. Transforms the XML data in the using the specified and outputs the result to a . An containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transformation. The to which you want to output. - The used to resolve the XSLT document() function. If this is , the document() function is not resolved. - - The is not cached after the method completes. - There was an error processing the XSLT transformation. - - Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. + The used to resolve the XSLT document() function. If this is , the document() function is not resolved. +The is not cached after the method completes. + There was an error processing the XSLT transformation. +Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. Transforms the XML data in the using the specified and outputs the result to an . An containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transformation. - The used to resolve the XSLT document() function. If this is , the document() function is not resolved. - - The is not cached after the method completes. - There was an error processing the XSLT transformation. - - Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. + The used to resolve the XSLT document() function. If this is , the document() function is not resolved. +The is not cached after the method completes. An containing the results of the transformation. + There was an error processing the XSLT transformation. +Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. Transforms the XML data in the using the specified args and outputs the result to an . An containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transformation. The to which you want to output. - There was an error processing the XSLT transformation. - - Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. + There was an error processing the XSLT transformation. +Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. Transforms the XML data in the using the specified args and outputs the result to an . An containing the data to be transformed. An containing the namespace-qualified arguments used as input to the transformation. The to which you want to output. - The used to resolve the XSLT document() function. If this is , the document() function is not resolved. - - The is not cached after the method completes. - There was an error processing the XSLT transformation. - - Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. + The used to resolve the XSLT document() function. If this is , the document() function is not resolved. +The is not cached after the method completes. + There was an error processing the XSLT transformation. +Note: This is a change in behavior from earlier versions. An is thrown if you are using Microsoft .NET Framework version 1.1 or earlier. Sets the used to resolve external resources when the method is called.