From 75e64f77acfa0a08ca1d28904f134dc88071ecbc Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Sat, 23 May 2026 19:33:42 -0700 Subject: [PATCH 1/4] remove .net fw remarks --- .../XamlLoadPermission.xml | 78 +- xml/System.Xaml/XamlObjectWriter.xml | 2 +- xml/System.Xaml/XamlObjectWriterSettings.xml | 9 +- xml/System.Xaml/XamlSchemaContext.xml | 7 - .../XmlPreloadedResolver.xml | 4 +- xml/System.Xml.Schema/XmlSchema.xml | 26 +- xml/System.Xml.Schema/XmlSchemaAttribute.xml | 12 +- xml/System.Xml.Schema/XmlSchemaCollection.xml | 256 +---- xml/System.Xml.Schema/XmlSchemaElement.xml | 14 +- xml/System.Xml.Schema/XmlTypeCode.xml | 20 +- .../CodeIdentifier.xml | 2 +- .../IXmlSerializable.xml | 8 +- .../XmlMemberMapping.xml | 4 +- .../XmlMembersMapping.xml | 6 +- .../XmlReflectionImporter.xml | 8 +- .../XmlReflectionMember.xml | 6 +- .../XmlSchemaImporter.xml | 2 +- xml/System.Xml.Serialization/XmlSchemas.xml | 2 +- ...mlSerializationCollectionFixupCallback.xml | 18 +- .../XmlSerializationFixupCallback.xml | 22 +- .../XmlSerializationReadCallback.xml | 2 +- ...XmlSerializationReader+CollectionFixup.xml | 2 +- .../XmlSerializationReader+Fixup.xml | 4 +- .../XmlSerializationReader.xml | 156 +-- .../XmlSerializationWriteCallback.xml | 2 +- .../XmlSerializationWriter.xml | 182 +-- .../XmlSerializerAssemblyAttribute.xml | 60 +- .../XmlSerializerVersionAttribute.xml | 24 +- xml/System.Xml.Xsl/XslCompiledTransform.xml | 16 +- xml/System.Xml.Xsl/XslTransform.xml | 805 ++++--------- .../IApplicationResourceStreamResolver.xml | 8 +- xml/System.Xml/ValidationType.xml | 10 +- xml/System.Xml/XmlConvert.xml | 21 +- xml/System.Xml/XmlDocument.xml | 24 +- xml/System.Xml/XmlNodeReader.xml | 4 +- xml/System.Xml/XmlReader.xml | 42 +- xml/System.Xml/XmlReaderSettings.xml | 49 +- xml/System.Xml/XmlSecureResolver.xml | 70 +- xml/System.Xml/XmlTextReader.xml | 45 +- xml/System.Xml/XmlUrlResolver.xml | 7 +- xml/System.Xml/XmlValidatingReader.xml | 1012 ++--------------- xml/System.Xml/XmlWriter.xml | 6 +- 42 files changed, 676 insertions(+), 2381 deletions(-) diff --git a/xml/System.Xaml.Permissions/XamlLoadPermission.xml b/xml/System.Xaml.Permissions/XamlLoadPermission.xml index 383dca1e593..de1f21fd3ab 100644 --- a/xml/System.Xaml.Permissions/XamlLoadPermission.xml +++ b/xml/System.Xaml.Permissions/XamlLoadPermission.xml @@ -55,8 +55,6 @@ [!INCLUDE[cas-deprecated](~/includes/cas-deprecated.md)] - is relevant for scenarios such as whether internal types are permitted to load under partial trust. - ]]> @@ -100,14 +98,7 @@ An enumerable set of specific values. Initializes a new instance of the class, using an enumerable set of specific values. - - collection with each `allowedAccess` entry as an item, and sets the return for to `false` in the created instance. - - ]]> - + To be added. is . @@ -144,14 +135,7 @@ A enumeration value. Initializes a new instance of the class, using existing permissions. - - sets the return for to `true` in the created instance. Any call to this constructor sets the collection to `null` because it is not relevant if permissions are being reported rather than . - - ]]> - + To be added. @@ -184,14 +168,7 @@ The defining value. Initializes a new instance of the class, using a single value. - - collection with `allowedAccess` as the only item, and sets the return for to `false` in the created instance. - - ]]> - + To be added. is . @@ -232,14 +209,7 @@ Gets the list of all values that this represents. A read-only list of values, or . - - is initialized such that is `true`, may be `null`. - - ]]> - + To be added. @@ -273,14 +243,7 @@ Creates and returns an identical copy of the current . A copy of the current . - - this value is in the signature but can be cast to . - - ]]> - + To be added. @@ -484,14 +447,7 @@ A to intersect with the current . Can be . Creates and returns a that is the intersection of the current and the specified permission. A new permission that represents the intersection of the current and the specified . This new permission is if the intersection is empty. - - is checked first, and might return a result based solely on that check. Next, is checked. - - ]]> - + To be added. is not or is not a . @@ -531,16 +487,7 @@ Determines whether the current is a subset of the specified permission. if the current is a subset of the specified permission; otherwise, . - - is checked first, and might return a result based solely on that check. Next, is checked. - - If `target` is `null` and the current is both `false` and has an empty list, this method returns `true`. - - ]]> - + To be added. is not or is not a . @@ -651,16 +598,7 @@ A to combine with the current . Can be . Creates a permission that is the union of the current and the specified permission. A new that represents the union of the current and the specified . - - is checked first, and might return a result based solely on that check. Next, is checked. - - If `other` is `null`, the current is returned. - - ]]> - + To be added. is not or is not a . diff --git a/xml/System.Xaml/XamlObjectWriter.xml b/xml/System.Xaml/XamlObjectWriter.xml index 6e8b0638a83..30f006b957c 100644 --- a/xml/System.Xaml/XamlObjectWriter.xml +++ b/xml/System.Xaml/XamlObjectWriter.xml @@ -461,7 +461,7 @@ diff --git a/xml/System.Xaml/XamlObjectWriterSettings.xml b/xml/System.Xaml/XamlObjectWriterSettings.xml index 36dc73812a7..12aa1c58e70 100644 --- a/xml/System.Xaml/XamlObjectWriterSettings.xml +++ b/xml/System.Xaml/XamlObjectWriterSettings.xml @@ -122,14 +122,7 @@ Gets or sets permissions that the XAML writer observes. The permissions. - - - + To be added. diff --git a/xml/System.Xaml/XamlSchemaContext.xml b/xml/System.Xaml/XamlSchemaContext.xml index 0558784d973..4b9d2dcb358 100644 --- a/xml/System.Xaml/XamlSchemaContext.xml +++ b/xml/System.Xaml/XamlSchemaContext.xml @@ -30,13 +30,6 @@ ]]> - - In an , a can be shared between multiple callers, which include both full and partial trust callers. This situation exists in frameworks such as WPF, which provide partial-trust access to XAML loading for portions of the WPF application model. The default implementation provides safeguards in this scenario by keeping all its properties and settings immutable. Derived implementations should also consider following this model of immutability for properties and settings of a XAML schema context. - - The base class is designed so that lookups have no externally observable side effects. The types that are referenced by APIs in the base class, such as or , also produce no side effects from lookups. All data that is needed to make a schema determination should be available from the construction and settings of the . Notice that no lookup APIs rely on explicitly passed-in services; their input relies on string input only. - - The base class, and and are all thread safe in their base implementations. If you derive from or derive XAML type system classes such as and , you can choose whether your classes will behave as thread safe. - diff --git a/xml/System.Xml.Resolvers/XmlPreloadedResolver.xml b/xml/System.Xml.Resolvers/XmlPreloadedResolver.xml index 1f01e798c39..150cc434a4d 100644 --- a/xml/System.Xml.Resolvers/XmlPreloadedResolver.xml +++ b/xml/System.Xml.Resolvers/XmlPreloadedResolver.xml @@ -585,7 +585,7 @@ 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. + 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. Maps a URI to an object that contains the actual resource. A or object that corresponds to the actual source. @@ -662,7 +662,7 @@ 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. + 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. Asynchronously maps a URI to an object that contains the actual resource. A or object that corresponds to the actual source. diff --git a/xml/System.Xml.Schema/XmlSchema.xml b/xml/System.Xml.Schema/XmlSchema.xml index 8af9a92d391..3074be6c83e 100644 --- a/xml/System.Xml.Schema/XmlSchema.xml +++ b/xml/System.Xml.Schema/XmlSchema.xml @@ -446,16 +446,7 @@ 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. - - [!IMPORTANT] -> The method is obsolete in the Microsoft .NET Framework version 2.0 and has been replaced by the method. - - ]]> - + To be added. @@ -517,20 +508,7 @@ The validation event handler that receives information about the XML Schema validation errors. The used to resolve namespaces referenced in and elements. 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. - - [!IMPORTANT] -> The method is obsolete in the Microsoft .NET Framework version 2.0 and has been replaced by the method. - -> [!IMPORTANT] -> The method uses the class to resolve external schemas referenced in include, import, or redefine elements by default. You can disable resolution of external schemas by passing null as the parameter. - - ]]> - + To be added. diff --git a/xml/System.Xml.Schema/XmlSchemaAttribute.xml b/xml/System.Xml.Schema/XmlSchemaAttribute.xml index 437e614c295..39a7fdda69b 100644 --- a/xml/System.Xml.Schema/XmlSchemaAttribute.xml +++ b/xml/System.Xml.Schema/XmlSchemaAttribute.xml @@ -224,17 +224,7 @@ Gets the common language runtime (CLR) object based on the or of the attribute that holds the post-compilation value of the property. The common runtime library (CLR) object that holds the post-compilation value of the property. - - if the attribute has a built-in XML Schema type or if the attribute has a user-defined type. This property is a post-schema-validation infoset property. - -> [!IMPORTANT] -> The property is obsolete in the 2.0 version of the .NET Framework and has been replaced by the property. - - ]]> - + To be added. diff --git a/xml/System.Xml.Schema/XmlSchemaCollection.xml b/xml/System.Xml.Schema/XmlSchemaCollection.xml index 5fba706b396..b9ced0792b3 100644 --- a/xml/System.Xml.Schema/XmlSchemaCollection.xml +++ b/xml/System.Xml.Schema/XmlSchemaCollection.xml @@ -74,23 +74,7 @@ Contains a cache of XML Schema definition language (XSD) and XML-Data Reduced (XDR) schemas. The class is obsolete. Use instead. - - method, at which time the schema is associated with a namespace Uniform Resource Identifier (URI). For XML Schemas, this will typically be the `targetNamespace` property of the schema. - - Although this class stores both XML Schemas and XDR schemas, any method and property that takes or returns an applies to XML Schemas only. - - This version of the product supports the World Wide Web Consortium (W3C) XML Schema recommendation located at [XML Schema Part 1: Structures](https://www.w3.org/TR/xmlschema-1/) and [XML Schema Part 2: Datatypes](https://www.w3.org/TR/xmlschema-2/). An XML Schema must reference the W3C Schema namespace `http://www.w3.org/2001/XMLSchema` in its schema element. See the method for an example. - - `XmlSchemaCollection` can be used by for efficient data validation. - -> [!IMPORTANT] -> The class is obsolete in the Microsoft .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. @@ -101,16 +85,7 @@ Initializes a new instance of the class. - - [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. @@ -148,16 +123,7 @@ Initializes a new instance of the class. - - [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. @@ -210,16 +176,7 @@ Adds the given schema into the schema collection. - - [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. @@ -272,26 +229,7 @@ The to add to the collection. Adds the to the collection. The object. - - was always used). - - `Fully trusted code:` A default `XmlUrlResolver` with no user credentials is used to resolve any external resources. The schemas for these other namespaces are loaded for validation purposes only. Unlike the original schema, these other schemas are not explicitly added to the schema collection. As a result, they are not accessible using any of the collection methods or properties. If these external resources are located on a network resource that requires authentication, use an overload that takes an as one of its arguments and specify an `XmlResolver` with the necessary credentials. - - `Semi-trusted code:` External references are not resolved. - -> [!NOTE] -> If the `XmlSchemaCollection` is being accessed using the property, the `Add` method uses the `XmlResolver` specified by the property. - -> [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. @@ -337,24 +275,7 @@ The you want to add to this collection. Adds all the namespaces defined in the given collection (including their associated schemas) to this collection. - - was always used). - - `Fully trusted code:` A default `XmlUrlResolver` with no user credentials is used to resolve any external resources. The schemas for these other namespaces are loaded for validation purposes only. Unlike the original schema, these other schemas are not explicitly added to the schema collection. As a result, they are not accessible using any of the collection methods or properties. If these external resources are located on a network resource that requires authentication, use an overload that takes an as one of its arguments and specify an `XmlResolver` with the necessary credentials. - - `Semi-trusted code:` External references are not resolved. - -> [!NOTE] -> If the `XmlSchemaCollection` is being accessed using the property, the `Add` method uses the `XmlResolver` specified by the property. - -> [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. @@ -414,31 +335,7 @@ The URL that specifies the schema to load. Adds the schema located by the given URL into the schema collection. The added to the schema collection; if the schema being added is an XDR schema or if there are compilation errors in the schema. - - was always used). - - `Fully trusted code:` A default `XmlUrlResolver` with no user credentials is used to resolve any external resources. The schemas for these other namespaces are loaded for validation purposes only. Unlike the original schema, these other schemas are not explicitly added to the schema collection. As a result, they are not accessible using any of the collection methods or properties. If these external resources are located on a network resource that requires authentication, use an overload that takes an as one of its arguments and specify an `XmlResolver` with the necessary credentials. - - `Semi-trusted code:` External references are not resolved. - -> [!NOTE] -> If the `XmlSchemaCollection` is being accessed using the property, the `Add` method uses the `XmlResolver` specified by the property. - -> [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. The schema is not a valid schema. @@ -496,28 +393,7 @@ schemaColl.Add("urn:author", "names.xsd"); containing the schema to add. Adds the schema contained in the to the schema collection. The added to the schema collection; if the schema being added is an XDR schema or if there are compilation errors in the schema. - - was always used). - - `Fully trusted code:` A default `XmlUrlResolver` with no user credentials is used to resolve any external resources. The schemas for these other namespaces are loaded for validation purposes only. Unlike the original schema, these other schemas are not explicitly added to the schema collection. As a result, they are not accessible using any of the collection methods or properties. If these external resources are located on a network resource that requires authentication, use an overload that takes an as one of its arguments and specify an `XmlResolver` with the necessary credentials. - - `Semi-trusted code:` External references are not resolved. - -> [!NOTE] -> If the `XmlSchemaCollection` is being accessed using the property, the `Add` method uses the `XmlResolver` specified by the property. - -> [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. The schema is not a valid schema. @@ -649,21 +525,7 @@ schemaColl.Add("urn:author", "names.xsd"); The used to resolve namespaces referenced in and elements or attribute (XDR schemas). If this is , external references are not resolved. Adds the schema contained in the to the schema collection. The specified is used to resolve any external resources. The added to the schema collection; if the schema being added is an XDR schema or if there are compilation errors in the schema. - - [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. The schema is not a valid schema. @@ -678,16 +540,7 @@ schemaColl.Add("urn:author", "names.xsd"); Gets a value indicating whether a schema with the specified namespace is in the collection. - - [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. @@ -735,16 +588,7 @@ schemaColl.Add("urn:author", "names.xsd"); Gets a value indicating whether a schema with the specified namespace is in the collection. if a schema with the specified namespace is in the collection; otherwise, . - - [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. @@ -791,16 +635,7 @@ schemaColl.Add("urn:author", "names.xsd"); Gets a value indicating whether the of the specified is in the collection. if there is a schema in the collection with the same ; otherwise, . - - [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. @@ -847,16 +682,7 @@ schemaColl.Add("urn:author", "names.xsd"); The array to copy the objects to. The index in where copying will begin. Copies all the objects from this collection into the given array starting at the given index. - - [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. @@ -898,16 +724,7 @@ schemaColl.Add("urn:author", "names.xsd"); Gets the number of namespaces defined in this collection. The number of namespaces defined in this collection. - - [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. @@ -950,16 +767,7 @@ schemaColl.Add("urn:author", "names.xsd"); Provides support for the "for each" style iteration over the collection of schemas. An enumerator for iterating over all schemas in the current collection. - - [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. @@ -1013,16 +821,7 @@ schemaColl.Add("urn:author", "names.xsd"); The namespace URI associated with the schema you want to return. This will typically be the of the schema. Gets the associated with the given namespace URI. The associated with the namespace URI; if there is no loaded schema associated with the given namespace or if the namespace is associated with an XDR schema. - - [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. @@ -1064,16 +863,7 @@ schemaColl.Add("urn:author", "names.xsd"); Gets the default used by the when loading new schemas. An . - - [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. @@ -1378,17 +1168,7 @@ schemaColl.Add("urn:author", "names.xsd"); Sets an event handler for receiving information about the XDR and XML schema validation errors. - - is thrown on any validation errors where the is `XmlSeverityType.Error`. To specify an event handler, define a callback function and add it to the `ValidationEventHandler`. - -> [!IMPORTANT] -> The class is obsolete in .NET Framework version 2.0 and has been replaced by the class. - - ]]> - + To be added. diff --git a/xml/System.Xml.Schema/XmlSchemaElement.xml b/xml/System.Xml.Schema/XmlSchemaElement.xml index fd6048f9565..411f532984e 100644 --- a/xml/System.Xml.Schema/XmlSchemaElement.xml +++ b/xml/System.Xml.Schema/XmlSchemaElement.xml @@ -490,19 +490,7 @@ Gets a common language runtime (CLR) object based on the or of the element, which holds the post-compilation value of the property. The common language runtime object. The post-compilation value of the property. - - if the element has a built-in XML Schema type or if the element has a user-defined type. - - This property is a post-schema-validation infoset property. - -> [!IMPORTANT] -> The property is obsolete in the 2.0 version of the .NET Framework and has been replaced by the property. - - ]]> - + To be added. diff --git a/xml/System.Xml.Schema/XmlTypeCode.xml b/xml/System.Xml.Schema/XmlTypeCode.xml index 3d5c4f131a5..7707c2a04ee 100644 --- a/xml/System.Xml.Schema/XmlTypeCode.xml +++ b/xml/System.Xml.Schema/XmlTypeCode.xml @@ -163,7 +163,7 @@ 5 - This value supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This value supports the .NET infrastructure and is not intended to be used directly from your code. @@ -323,7 +323,7 @@ 8 - This value supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This value supports the .NET infrastructure and is not intended to be used directly from your code. @@ -443,7 +443,7 @@ 54 - This value supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This value supports the .NET infrastructure and is not intended to be used directly from your code. @@ -523,7 +523,7 @@ 3 - This value supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This value supports the .NET infrastructure and is not intended to be used directly from your code. @@ -643,7 +643,7 @@ 4 - This value supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This value supports the .NET infrastructure and is not intended to be used directly from your code. @@ -1323,7 +1323,7 @@ 6 - This value supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This value supports the .NET infrastructure and is not intended to be used directly from your code. @@ -1483,7 +1483,7 @@ 2 - This value supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This value supports the .NET infrastructure and is not intended to be used directly from your code. @@ -1763,7 +1763,7 @@ 7 - This value supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This value supports the .NET infrastructure and is not intended to be used directly from your code. @@ -1923,7 +1923,7 @@ 9 - This value supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This value supports the .NET infrastructure and is not intended to be used directly from your code. @@ -2243,7 +2243,7 @@ 53 - This value supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This value supports the .NET infrastructure and is not intended to be used directly from your code. diff --git a/xml/System.Xml.Serialization/CodeIdentifier.xml b/xml/System.Xml.Serialization/CodeIdentifier.xml index c4b7abec185..b5efe7c0d82 100644 --- a/xml/System.Xml.Serialization/CodeIdentifier.xml +++ b/xml/System.Xml.Serialization/CodeIdentifier.xml @@ -57,7 +57,7 @@ ## Remarks The methods of the class are used by the XML serialization infrastructure while producing .NET types from XML element and data type definitions. XML element or attribute names typically provide the methods' input text. - You do not need to call the methods of the class directly from your code. Instead, use the various tools and APIs provided by the .NET Framework for XML serialization, such as the , or the [XML Schema Definition Tool (Xsd.exe)](/dotnet/standard/serialization/xml-schema-definition-tool-xsd-exe) tool. + You do not need to call the methods of the class directly from your code. Instead, use the various tools and APIs provided by .NET for XML serialization, such as or the [XML Schema Definition Tool (Xsd.exe)](/dotnet/standard/serialization/xml-schema-definition-tool-xsd-exe) tool. ]]> diff --git a/xml/System.Xml.Serialization/IXmlSerializable.xml b/xml/System.Xml.Serialization/IXmlSerializable.xml index 5f6ea0484b9..b139ab50134 100644 --- a/xml/System.Xml.Serialization/IXmlSerializable.xml +++ b/xml/System.Xml.Serialization/IXmlSerializable.xml @@ -200,12 +200,10 @@ ## Remarks The method must reconstitute your object using the information that was written by the method. - When this method is called, the reader is positioned on the start tag that wraps the information for your type. That is, directly on the start tag that indicates the beginning of a serialized object. When this method returns, it must have read the entire element from beginning to end, including all of its contents. Unlike the method, the framework does not handle the wrapper element automatically. Your implementation must do so. Failing to observe these positioning rules may cause code to generate unexpected runtime exceptions or corrupt data. + When this method is called, the reader is positioned on the start tag that wraps the information for your type. That is, directly on the start tag that indicates the beginning of a serialized object. When this method returns, it must have read the entire element from beginning to end, including all of its contents. Unlike the method, .NET does not handle the wrapper element automatically; your implementation must do so. Failing to observe these positioning rules might cause code to generate unexpected runtime exceptions or corrupt data. When implementing this method, you should consider the possibility that a malicious user might provide a well-formed but invalid XML representation in order to disable or otherwise alter the behavior of your application. - - ## Examples The following example illustrates an implementation of the method. @@ -270,14 +268,12 @@ implementation you provide should write out the XML representation of the object. The framework writes a wrapper element and positions the XML writer after its start. Your implementation may write its contents, including child elements. The framework then closes the wrapper element. + The implementation you provide should write out the XML representation of the object. .NET writes a wrapper element and positions the XML writer after its start. Your implementation may write its contents, including child elements. .NET then closes the wrapper element. Write sufficient information to the stream to allow the method to reconstitute your object. For example, if your object state includes an array variable, be sure to write the length of the array, or use a parent element to contain the elements that describe the array values, so that you know how many values to read when the object is reconstituted. - - ## Examples The following example illustrates an implementation of the method. diff --git a/xml/System.Xml.Serialization/XmlMemberMapping.xml b/xml/System.Xml.Serialization/XmlMemberMapping.xml index 773834e8821..cd1d2192efd 100644 --- a/xml/System.Xml.Serialization/XmlMemberMapping.xml +++ b/xml/System.Xml.Serialization/XmlMemberMapping.xml @@ -175,7 +175,7 @@ property checks whether such a `bool` field exists. + In the XML Schema, an element declared with a `minOccurs="0"` attribute value indicates that the element is optional. An attribute can be declared with a `use="optional"` attribute. .NET, using the [XML Schema Definition Tool (Xsd.exe)](/dotnet/standard/serialization/xml-schema-definition-tool-xsd-exe), maps either of these constructs to a public field or property that is accompanied by a public field of type `bool` whose name is the first field's name with "Specified" appended. The property checks whether such a `bool` field exists. ]]> @@ -270,7 +270,7 @@ ## Remarks The Web service method member can be an input parameter, output parameter, return type, input header, or output header. - See the class for cases when a member corresponds to a `` element defined in a Web Services Description Language (WSDL) document. Note, however, that with a wrapped binding between a WSDL operation and a .NET Framework method, (indicated by the enumeration member), the method parameters and return value do not appear in the WSDL document. + See the class for cases when a member corresponds to a `` element defined in a Web Services Description Language (WSDL) document. Note, however, that with a wrapped binding between a WSDL operation and a .NET method, (indicated by the enumeration member), the method parameters and return value do not appear in the WSDL document. When a Web service class is being reflected into a object, the return type's property becomes the method name (made unique from other member names, if necessary) with "Result" appended. This convention also is used, in some circumstances, while importing Web service classes from objects generated from WSDL documents. diff --git a/xml/System.Xml.Serialization/XmlMembersMapping.xml b/xml/System.Xml.Serialization/XmlMembersMapping.xml index 86fb568b55d..de7d3d7b035 100644 --- a/xml/System.Xml.Serialization/XmlMembersMapping.xml +++ b/xml/System.Xml.Serialization/XmlMembersMapping.xml @@ -59,7 +59,7 @@ - By the Wsdl.exe tool, or the class, while generating client proxy classes or abstract server classes from a WSDL document. The WSDL document specifies use of the SOAP protocol. -- To initialize objects while the .NET Framework is initializing a SOAP Web service or client. +- To initialize objects while .NET is initializing a SOAP Web service or client. - By the class while creating objects from classes that are identified as SOAP Web services. @@ -75,9 +75,9 @@ Specifically, the class represents mappings for a WSDL message definition, according to the following choices: -- For a Web service method that uses SOAP encoding: The top-level and properties pertain to a parent, wrapper element; the message parts are represented by array members. However, in the rare case when the Web service operation uses document style combined with a wrapped binding to a .NET Framework method plus SOAP encoding, the top-level and properties pertain to the single **part** element that appears in a generated WSDL document. +- For a Web service method that uses SOAP encoding: The top-level and properties pertain to a parent, wrapper element; the message parts are represented by array members. However, in the rare case when the Web service operation uses document style combined with a wrapped binding to a .NET method plus SOAP encoding, the top-level and properties pertain to the single **part** element that appears in a generated WSDL document. -- For a Web service method that makes literal use of XML Schema definitions: If a Web service message or operation uses a wrapped binding to a .NET Framework method or merely defines a single message part, the top-level and properties pertain to the part. If there are multiple parts (the atypical case), the top-level and properties pertain to a parent, wrapper element; the parts are represented by the and indexed array access properties. In addition, the XSD `any` element receives special treatment. +- For a Web service method that makes literal use of XML Schema definitions: If a Web service message or operation uses a wrapped binding to a .NET method or merely defines a single message part, the top-level and properties pertain to the part. If there are multiple parts (the atypical case), the top-level and properties pertain to a parent, wrapper element; the parts are represented by the and indexed array access properties. In addition, the XSD `any` element receives special treatment. ]]> diff --git a/xml/System.Xml.Serialization/XmlReflectionImporter.xml b/xml/System.Xml.Serialization/XmlReflectionImporter.xml index c3e57222d2c..de5d5ee1d06 100644 --- a/xml/System.Xml.Serialization/XmlReflectionImporter.xml +++ b/xml/System.Xml.Serialization/XmlReflectionImporter.xml @@ -369,7 +369,7 @@ An XML element name produced from the Web service method. An XML element namespace produced from the Web service method. - An array of objects that contain .NET Framework code entities that belong to a Web service method. + An array of objects that contain .NET code entities that belong to a Web service method. if elements that correspond to Web Services Description Language (WSDL) message parts should be enclosed in an extra wrapper element in a SOAP message; otherwise, . Generates internal type mappings for information from a Web service method. @@ -465,7 +465,7 @@ An XML element name produced from the Web service method. An XML element namespace produced from the Web service method. - An array of objects that contain .NET Framework code entities that belong to a Web service method. + An array of objects that contain .NET code entities that belong to a Web service method. if elements that correspond to Web Services Description Language (WSDL) message parts should be enclosed in an extra wrapper element in a SOAP message; otherwise, . @@ -547,7 +547,7 @@ An XML element name produced from the Web service method. An XML element namespace produced from the Web service method. - An array of objects that contain .NET Framework code entities that belong to a Web service method. + An array of objects that contain .NET code entities that belong to a Web service method. if elements that correspond to Web Services Description Language (WSDL) message parts should be enclosed in an extra wrapper element in a SOAP message; otherwise, . @@ -632,7 +632,7 @@ An XML element name produced from the Web service method. An XML element namespace produced from the Web service method. - An array of objects that contain .NET Framework code entities that belong to a Web service method. + An array of objects that contain .NET code entities that belong to a Web service method. if elements that correspond to Web Services Description Language (WSDL) message parts should be enclosed in an extra wrapper element in a SOAP message; otherwise, . diff --git a/xml/System.Xml.Serialization/XmlReflectionMember.xml b/xml/System.Xml.Serialization/XmlReflectionMember.xml index b658176af5b..b69f6e042ac 100644 --- a/xml/System.Xml.Serialization/XmlReflectionMember.xml +++ b/xml/System.Xml.Serialization/XmlReflectionMember.xml @@ -57,7 +57,7 @@ ## Remarks The class is not used directly. Instead, it is used: -- To initialize objects while the .NET Framework is initializing a SOAP Web service or client. +- To initialize objects while .NET is initializing a SOAP Web service or client. - By the class while creates objects from classes that are identified as SOAP Web services. @@ -219,7 +219,7 @@ You do not need to use the class and its properties directly. - See the class for the cases when a member corresponds to a `` element defined in a Web Services Description Language (WSDL) document. Note, however, that with a wrapped binding between a WSDL operation and a .NET Framework method (indicated by the enumeration member), the method parameters and return value do not appear in the WSDL document. + See the class for the cases when a member corresponds to a `` element defined in a Web Services Description Language (WSDL) document. Note, however, that with a wrapped binding between a WSDL operation and a .NET method (indicated by the enumeration member), the method parameters and return value do not appear in the WSDL document. When a Web service method is being reflected, the return type's property becomes the method name (made unique from other member names, if necessary) with "Result" appended. @@ -282,7 +282,7 @@ You do not need to use the class and its properties directly. - See the class for the cases when a member corresponds to a part element defined in a Web Services Description Language (WSDL) document. Note, however, that with a wrapped binding between a WSDL operation and a .NET Framework method (indicated by the enumeration member), the method parameters and return value do not appear in the WSDL document. + See the class for the cases when a member corresponds to a part element defined in a Web Services Description Language (WSDL) document. Note, however, that with a wrapped binding between a WSDL operation and a .NET method (indicated by the enumeration member), the method parameters and return value do not appear in the WSDL document. ]]> diff --git a/xml/System.Xml.Serialization/XmlSchemaImporter.xml b/xml/System.Xml.Serialization/XmlSchemaImporter.xml index ff8ca7fd208..ad9fe064891 100644 --- a/xml/System.Xml.Serialization/XmlSchemaImporter.xml +++ b/xml/System.Xml.Serialization/XmlSchemaImporter.xml @@ -66,7 +66,7 @@ The class has methods to generate internal mappings to .NET types for elements defined in an XSD document or as parts in a WSDL document. The following list shows when the class is used by Wsdl.exe: - A WSDL document specifies literal use, where the content of SOAP message parameters and return values (or request and response documents) is literally specified with XML schema definitions. -- A WSDL document specifies the .NET Framework's non-SOAP implementations of Web services via the HTTP-GET and HTTP-POST operations. +- A WSDL document specifies .NET's non-SOAP implementations of Web services via the HTTP-GET and HTTP-POST operations. ]]> diff --git a/xml/System.Xml.Serialization/XmlSchemas.xml b/xml/System.Xml.Serialization/XmlSchemas.xml index d11705af82a..291de39d5e4 100644 --- a/xml/System.Xml.Serialization/XmlSchemas.xml +++ b/xml/System.Xml.Serialization/XmlSchemas.xml @@ -845,7 +845,7 @@ ## Remarks The `IsDataSet` attribute comes from the namespace `urn:schemas-microsoft-com:xml-msdata`. - The method is called by the .NET Framework's XML serialization infrastructure and does not need to be called directly. + The method is called by .NET's XML serialization infrastructure and does not need to be called directly. ]]> diff --git a/xml/System.Xml.Serialization/XmlSerializationCollectionFixupCallback.xml b/xml/System.Xml.Serialization/XmlSerializationCollectionFixupCallback.xml index 50ff014f3ab..26ed99c020c 100644 --- a/xml/System.Xml.Serialization/XmlSerializationCollectionFixupCallback.xml +++ b/xml/System.Xml.Serialization/XmlSerializationCollectionFixupCallback.xml @@ -55,15 +55,15 @@ An array of items to be copied into the object collection. Delegate used by the class for deserialization of SOAP-encoded XML data types that map to collections or enumerations. - class. During this process, the .NET Framework generates collection fix-up methods that use the delegate. This occurs for SOAP-encoded arrays or SOAP-encoded, multi-reference elements whose data types, in either case, map to .NET Framework collections or enumerations. As necessary, the collection fix-up method is called during deserialization. - - You should not directly instantiate . - - SOAP encoding is described in Section 5 of the SOAP 1.1 specification. - + class. During this process, .NET generates collection fix-up methods that use the delegate. This occurs for SOAP-encoded arrays or SOAP-encoded, multi-reference elements whose data types, in either case, map to .NET collections or enumerations. As necessary, the collection fix-up method is called during deserialization. + + You should not directly instantiate . + + SOAP encoding is described in Section 5 of the SOAP 1.1 specification. + ]]> diff --git a/xml/System.Xml.Serialization/XmlSerializationFixupCallback.xml b/xml/System.Xml.Serialization/XmlSerializationFixupCallback.xml index 0b6d1c38b1d..b579b368b4f 100644 --- a/xml/System.Xml.Serialization/XmlSerializationFixupCallback.xml +++ b/xml/System.Xml.Serialization/XmlSerializationFixupCallback.xml @@ -52,17 +52,17 @@ An instance of the class that contains the object to be fixed and the array of string identifiers for the items to fill in. Delegate used by the class for deserialization of SOAP-encoded XML data. - delegate. The infrastructure does so for SOAP-encoded arrays whose data types map to .NET Framework reference types. Then, as necessary, a fix-up method is called to fill in the objects in the array. - - In addition, during initialization, the .NET Framework XML serialization infrastructure dynamically generates and compiles a temporary class for deserialization derived from the class. During this process, the infrastructure generates methods for SOAP-encoded, multi-referenced XML data. The methods are then invoked during deserialization. - - Do not directly create an instance of the class. - - SOAP encoding is described in Section 5 of the SOAP 1.1 specification. - + delegate. The infrastructure does so for SOAP-encoded arrays whose data types map to .NET reference types. Then, as necessary, a fix-up method is called to fill in the objects in the array. + + In addition, during initialization, the .NET XML serialization infrastructure dynamically generates and compiles a temporary class for deserialization derived from the class. During this process, the infrastructure generates methods for SOAP-encoded, multi-referenced XML data. The methods are then invoked during deserialization. + + Do not directly create an instance of the class. + + SOAP encoding is described in Section 5 of the SOAP 1.1 specification. + ]]> diff --git a/xml/System.Xml.Serialization/XmlSerializationReadCallback.xml b/xml/System.Xml.Serialization/XmlSerializationReadCallback.xml index 93db2455535..903cc3501de 100644 --- a/xml/System.Xml.Serialization/XmlSerializationReadCallback.xml +++ b/xml/System.Xml.Serialization/XmlSerializationReadCallback.xml @@ -54,7 +54,7 @@ class. During this process, the .NET Framework generates read methods that implement the delegate. It does so for certain mappings between .NET types and XML data types that are serialized through SOAP-encoded XML and are not root elements. Then, as necessary, a read method is called during deserialization. + During initialization, the .NET XML serialization infrastructure dynamically generates and compiles a temporary class for deserialization derived from the class. During this process, the .NET XML serialization infrastructure generates read methods that implement the delegate. It does so for certain mappings between .NET types and XML data types that are serialized through SOAP-encoded XML and are not root elements. Then, as necessary, a read method is called during deserialization. Do not directly create instances of the class. diff --git a/xml/System.Xml.Serialization/XmlSerializationReader+CollectionFixup.xml b/xml/System.Xml.Serialization/XmlSerializationReader+CollectionFixup.xml index d58935d8e59..4502f730712 100644 --- a/xml/System.Xml.Serialization/XmlSerializationReader+CollectionFixup.xml +++ b/xml/System.Xml.Serialization/XmlSerializationReader+CollectionFixup.xml @@ -54,7 +54,7 @@ class. During this process, the infrastructure generates methods that implement the delegate. Additionally, it instantiates class objects to store the fix-up methods along with their inputs. The infrastructure does so for SOAP-encoded arrays or SOAP-encoded, multireferenced elements whose data types, in either case, map to .NET Framework collections or enumerations. Then, as necessary, the methods are invoked during deserialization to fill in array items or multireferenced objects. + During initialization, the .NET XML serialization infrastructure dynamically generates and compiles a temporary class for deserialization derived from the class. During this process, the infrastructure generates methods that implement the delegate. Additionally, it instantiates class objects to store the fix-up methods along with their inputs. The infrastructure does so for SOAP-encoded arrays or SOAP-encoded, multireferenced elements whose data types, in either case, map to .NET collections or enumerations. Then, as necessary, the methods are invoked during deserialization to fill in array items or multireferenced objects. Do not directly instantiate or . diff --git a/xml/System.Xml.Serialization/XmlSerializationReader+Fixup.xml b/xml/System.Xml.Serialization/XmlSerializationReader+Fixup.xml index 3eb803a9a8f..dabb8e9b152 100644 --- a/xml/System.Xml.Serialization/XmlSerializationReader+Fixup.xml +++ b/xml/System.Xml.Serialization/XmlSerializationReader+Fixup.xml @@ -54,9 +54,9 @@ delegate; plus, it instantiates class objects to store the fix-up methods along with their inputs. The infrastructure does so for SOAP-encoded arrays whose data types map to .NET Framework reference types. Then, as necessary, a fix-up method is called to fill in the objects in the array. + While deserializing XML documents into .NET objects, the .NET XML serialization infrastructure dynamically instantiates fix-up methods that implement the delegate; plus, it instantiates class objects to store the fix-up methods along with their inputs. The infrastructure does so for SOAP-encoded arrays whose data types map to .NET reference types. Then, as necessary, a fix-up method is called to fill in the objects in the array. - In addition, during initialization, the .NET Framework XML serialization infrastructure dynamically generates and compiles a temporary class for deserialization derived from the class. During this process, the infrastructure generates properties plus class objects for SOAP-encoded, multireferenced XML data. The methods are then invoked during deserialization. + In addition, during initialization, the .NET XML serialization infrastructure dynamically generates and compiles a temporary class for deserialization derived from the class. During this process, the infrastructure generates properties plus class objects for SOAP-encoded, multireferenced XML data. The methods are then invoked during deserialization. Do not directly create an instance of the or class. diff --git a/xml/System.Xml.Serialization/XmlSerializationReader.xml b/xml/System.Xml.Serialization/XmlSerializationReader.xml index ca8a99a964c..107765236d0 100644 --- a/xml/System.Xml.Serialization/XmlSerializationReader.xml +++ b/xml/System.Xml.Serialization/XmlSerializationReader.xml @@ -55,7 +55,7 @@ class. is also implemented within the .NET Framework for deserialization of XML documents into and objects. + During initialization, the .NET XML serialization infrastructure dynamically generates and compiles a temporary class for deserialization that is derived from the abstract class. is also implemented within the .NET XML serialization infrastructure for deserialization of XML documents into and objects. You should not derive classes from . Instead, call one of the methods. @@ -112,12 +112,12 @@ 4.0.0.0 - Stores an object that contains a callback method to subsequently be called, as necessary, to fill in .NET Framework collections or enumerations that map to SOAP-encoded arrays or SOAP-encoded, multi-referenced elements. + Stores an object that contains a callback method to subsequently be called, as necessary, to fill in .NET collections or enumerations that map to SOAP-encoded arrays or SOAP-encoded, multi-referenced elements. are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -228,11 +228,11 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. - While deserializing XML documents into .NET Framework objects, the .NET Framework XML serialization infrastructure dynamically creates instances of fix-up methods that implement the delegate and creates instances of the class to store the fix-up methods and their input data. The infrastructure does so for SOAP-encoded arrays whose data types map to .NET Framework reference types. Next, as necessary, a fix-up method is called to fill in the objects in the array. + While deserializing XML documents into .NET objects, the .NET XML serialization infrastructure dynamically creates instances of fix-up methods that implement the delegate and creates instances of the class to store the fix-up methods and their input data. The infrastructure does so for SOAP-encoded arrays whose data types map to .NET reference types. Next, as necessary, a fix-up method is called to fill in the objects in the array. - In addition, during initialization, the .NET Framework XML serialization infrastructure dynamically generates and compiles a temporary class for deserialization that derives from . During this process, the infrastructure generates methods and objects for SOAP-encoded, multi-referenced XML data. The methods are then invoked during deserialization. + In addition, during initialization, the .NET XML serialization infrastructure dynamically generates and compiles a temporary class for deserialization that derives from . During this process, the infrastructure generates methods and objects for SOAP-encoded, multi-referenced XML data. The methods are then invoked during deserialization. You should not directly create instances of the or classes. @@ -293,9 +293,9 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. - During initialization, the .NET Framework XML serialization infrastructure dynamically generates and compiles a temporary class for deserialization that derives from . During this process, the .NET Framework generates read methods that implement the delegate. It does so for certain mappings between .NET types and XML data types that are serialized through SOAP-encoded XML and are not root elements. Next, as necessary, a read method is called during deserialization. + During initialization, the .NET XML serialization infrastructure dynamically generates and compiles a temporary class for deserialization that derives from . During this process, the .NET XML serialization infrastructure generates read methods that implement the delegate. It does so for certain mappings between .NET types and XML data types that are serialized through SOAP-encoded XML and are not root elements. Next, as necessary, a read method is called during deserialization. You should not directly create an instance of the class. @@ -353,7 +353,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `multiRef` element identified by an `id` attribute. The `id` value can be referenced multiple times by `ref` attributes (or `href` attributes in SOAP 1.1) in substitute elements. @@ -474,7 +474,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -531,14 +531,14 @@ The name of the abstract type. - The .NET Framework namespace of the abstract type. + The .NET namespace of the abstract type. Creates an that indicates that an object being deserialized should be abstract. An exception. are intended only for use by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended only for use by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -608,7 +608,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -662,7 +662,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -716,7 +716,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -735,7 +735,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -798,7 +798,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -870,7 +870,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -927,14 +927,14 @@ The local name of the XML Schema data type that is mapped to the unavailable derived type. The namespace of the XML Schema data type that is mapped to the unavailable derived type. - The full name of the .NET Framework base type for which a derived type cannot be located. + The full name of the .NET base type for which a derived type cannot be located. Creates an that indicates that a derived type that is mapped to an XML Schema data type cannot be located. An exception. are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -988,7 +988,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -1052,7 +1052,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -1103,7 +1103,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -1157,7 +1157,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -1257,7 +1257,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -1329,7 +1329,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -1444,7 +1444,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method applies to the `arrayType` attribute that is used with SOAP encoding and specified with the namespace "". @@ -1498,7 +1498,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -1552,7 +1552,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `multiRef` element identified by an `id` attribute. The `id` value can be referenced multiple times using `href` attributes (or `ref` attributes in SOAP 1.2) in substitute elements. SOAP encoding is described in Section 5 of the SOAP 1.1 specification. @@ -1606,7 +1606,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The `type` attribute from the instance of the XML Schema namespace explicitly specifies the data type of an XML element. @@ -1668,9 +1668,9 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. - During initialization, the .NET Framework XML serialization infrastructure dynamically generates and compiles a temporary class for deserialization that is derived from . During this process, the .NET Framework generates read methods that implement the delegate. It does so for certain mappings between .NET types and XML data types that are serialized through SOAP-encoded XML and are not root elements. Next, as necessary, a read method is called during deserialization. + During initialization, the .NET XML serialization infrastructure dynamically generates and compiles a temporary class for deserialization that is derived from . During this process, .NET generates read methods that implement the delegate. It does so for certain mappings between .NET types and XML data types that are serialized through SOAP-encoded XML and are not root elements. Next, as necessary, a read method is called during deserialization. The abstract method is where the temporary derived class creates an instance of and initializes read callback methods. @@ -1726,7 +1726,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is abstract. @@ -1779,7 +1779,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -1834,7 +1834,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. An attribute name indicates an XML namespace if it takes the form `xmlns:key`, where "key" is the namespace name. @@ -1889,7 +1889,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. WSDL uses the namespace "". @@ -1942,7 +1942,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -1992,7 +1992,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2042,7 +2042,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2145,7 +2145,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2197,7 +2197,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2249,7 +2249,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2312,7 +2312,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The opening `#` symbol is stripped from the `href` attribute value. @@ -2337,7 +2337,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2398,7 +2398,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method obtains the XML Schema data type by reading the `xsi:type` attribute of the `multiRef` element. The prefix `xsi` refers to the instance of the XML Schema namespace. @@ -2471,7 +2471,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. This signature of the method obtains the XML Schema data type of the `multiRef` element from the method parameters rather than by reading the `xsi:type` attribute. The prefix `xsi` refers to the instance of the XML Schema namespace. @@ -2537,7 +2537,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `multiRef` element identified by an `id` attribute. The `id` value can be referenced multiple times using `href` attributes (or `ref` attributes in SOAP 1.2) in substitute elements. @@ -2560,7 +2560,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2624,7 +2624,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `multiRef` element identified by an `id` attribute. The `id` value can be referenced multiple times using `href` attributes (or `ref` attributes in SOAP 1.2) in substitute elements. @@ -2697,7 +2697,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `multiRef` element identified by an `id` attribute. The `id` value can be referenced multiple times using `href` attributes (or `ref` attributes in SOAP 1.2) in substitute elements. @@ -2773,7 +2773,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `multiRef` element identified by an `id` attribute. The `id` value can be referenced multiple times using `href` attributes (or `ref` attributes in SOAP 1.2) in substitute elements. @@ -2841,7 +2841,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2890,7 +2890,7 @@ An IXmlSerializable object that corresponds to the current position of the XMLReader. Specifies whether the serializable object is wrapped. - This method supports the .NET Framework infrastructure and is not intended to be used directly from your code. + This method supports the .NET infrastructure and is not intended to be used directly from your code. An object that implements the IXmlSerializable interface with its members populated from the location of the XmlReader. To be added. @@ -2960,7 +2960,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3125,12 +3125,12 @@ The that represents the simple data type for the current location of the . Gets the value of the XML node at which the is currently positioned. - The value of the node as a .NET Framework value type, if the value is a simple XML Schema data type. + The value of the node as a .NET value type, if the value is a simple XML Schema data type. are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3186,7 +3186,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3242,7 +3242,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3296,7 +3296,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `multiRef` element identified by an `id` attribute. The `id` value can be referenced multiple times using `href` attributes (or `ref` attributes in SOAP 1.2) in substitute elements. @@ -3360,7 +3360,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -3437,7 +3437,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3456,7 +3456,7 @@ are intended for use by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3511,7 +3511,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3572,7 +3572,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -3640,7 +3640,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3701,7 +3701,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -3757,7 +3757,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -3813,7 +3813,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -3898,7 +3898,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -3958,7 +3958,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -4014,7 +4014,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -4135,7 +4135,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -4200,7 +4200,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -4265,7 +4265,7 @@ are only intended for use by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are only intended for use by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -4330,7 +4330,7 @@ are intended for use by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -4396,7 +4396,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. If a prefix is present, the method looks up the associated namespace for the current XML document and places the value in the object. @@ -4471,7 +4471,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. Add a handler method to the method to handle unknown attributes while the is executing its method. @@ -4814,7 +4814,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding, as specified in Section 5 of the SOAP 1.1 specification, allows for elements referenced multiple times in a SOAP message (or optionally, just once) to be referred by an `href` attribute in the main message. An event occurs when such an element appears, but there is no `href` reference to it. diff --git a/xml/System.Xml.Serialization/XmlSerializationWriteCallback.xml b/xml/System.Xml.Serialization/XmlSerializationWriteCallback.xml index 159110d9a48..609b0c3ba56 100644 --- a/xml/System.Xml.Serialization/XmlSerializationWriteCallback.xml +++ b/xml/System.Xml.Serialization/XmlSerializationWriteCallback.xml @@ -55,7 +55,7 @@ class. During this process, the .NET Framework generates write methods that implement the class delegate. It does so for certain mappings between .NET types and XML data types that are serialized through SOAP-encoded XML and are not root elements. Then, as necessary, a write method is called during serialization. + During initialization, the .NET XML serialization infrastructure dynamically generates and compiles a temporary class for serialization derived from the class. During this process, the .NET XML serialization infrastructure generates write methods that implement the class delegate. It does so for certain mappings between .NET types and XML data types that are serialized through SOAP-encoded XML and are not root elements. Then, as necessary, a write method is called during serialization. You should not directly instantiate . diff --git a/xml/System.Xml.Serialization/XmlSerializationWriter.xml b/xml/System.Xml.Serialization/XmlSerializationWriter.xml index 15b9753af15..772c917d731 100644 --- a/xml/System.Xml.Serialization/XmlSerializationWriter.xml +++ b/xml/System.Xml.Serialization/XmlSerializationWriter.xml @@ -55,7 +55,7 @@ class. is also implemented within the .NET Framework for serialization of and objects into XML documents. + During initialization, the .NET XML serialization infrastructure dynamically generates and compiles a temporary class for serialization that is derived from the abstract class. is also implemented within .NET for serialization of and objects into XML documents. You should not derive classes from . Instead, call the method. @@ -165,9 +165,9 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. - During initialization, the .NET Framework XML serialization infrastructure dynamically generates and compiles a temporary class for serialization that is derived from . During this process, the .NET Framework generates write methods that implement the delegate. It does so for certain mappings between .NET types and XML data types that are serialized via SOAP-encoded XML and are not root elements. Then, as necessary, a write method is called during serialization. + During initialization, the .NET XML serialization infrastructure dynamically generates and compiles a temporary class for serialization that is derived from . During this process, .NET generates write methods that implement the delegate. It does so for certain mappings between .NET types and XML data types that are serialized via SOAP-encoded XML and are not root elements. Then, as necessary, a write method is called during serialization. You should not directly create an instance of . @@ -231,7 +231,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -389,7 +389,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -495,7 +495,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -551,7 +551,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -621,7 +621,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -681,7 +681,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -785,7 +785,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. Rather than return a string as other similar "from" methods, the static method returns the original `byte[]` object to improve performance and conserve memory. @@ -848,7 +848,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -904,7 +904,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -960,7 +960,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -1045,7 +1045,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -1066,7 +1066,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -1123,7 +1123,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -1184,7 +1184,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -1238,7 +1238,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -1359,7 +1359,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -1422,7 +1422,7 @@ class are intended for use by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of the class are intended for use by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -1485,7 +1485,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -1548,7 +1548,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -1615,7 +1615,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -1721,9 +1721,9 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. - During initialization, the .NET Framework XML serialization infrastructure dynamically generates and compiles a temporary class for serialization that is derived from . During this process, the .NET Framework generates write methods that implement the delegate. It does so for certain mappings between .NET types and XML data types that are serialized using SOAP-encoded XML and are not root elements. Then, as necessary, a write method is called during serialization. + During initialization, the .NET XML serialization infrastructure dynamically generates and compiles a temporary class for serialization that is derived from . During this process, .NET generates write methods that implement the delegate. It does so for certain mappings between .NET types and XML data types that are serialized using SOAP-encoded XML and are not root elements. Then, as necessary, a write method is called during serialization. The abstract method is where the temporary derived class creates an instance of and initializes write callback methods. @@ -1780,7 +1780,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -1840,7 +1840,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is static. @@ -1892,7 +1892,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `multiRef` element and to be referenced any number of times by substitute elements. The method helps keep track of the objects that can be serialized as `multiRef` elements. @@ -1969,7 +1969,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2032,7 +2032,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2097,7 +2097,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2162,7 +2162,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2229,7 +2229,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2300,7 +2300,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is called only when writing SOAP-encoded XML, as described in Section 5 of the SOAP 1.1 specification. @@ -2373,7 +2373,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The method is called only when writing literal XML that can be defined in an XML Schema document. @@ -2448,7 +2448,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2513,7 +2513,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2578,7 +2578,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2645,7 +2645,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2718,7 +2718,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2783,7 +2783,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2848,7 +2848,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2915,7 +2915,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -2988,7 +2988,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3051,7 +3051,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3116,7 +3116,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3181,7 +3181,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3246,7 +3246,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3311,7 +3311,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3378,7 +3378,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3445,7 +3445,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3509,7 +3509,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3565,7 +3565,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3625,7 +3625,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3679,7 +3679,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3732,7 +3732,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `multiRef` element identified by an `id` attribute. The `id` value can be referenced multiple times by `href` attributes (or `ref` attributes in SOAP 1.2) in substitute elements. @@ -3790,7 +3790,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -3857,7 +3857,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. When set to `true`, the `nil` attribute from the XML Schema instance namespace (abbreviated `xsi`) indicates a null value. @@ -3926,7 +3926,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. When set to `true`, the `nil` attribute from the XML Schema instance namespace (abbreviated `xsi`) indicates a null value. @@ -3997,7 +3997,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. When set to `true`, the `nil` attribute from the XML Schema instance namespace (abbreviated `xsi`) indicates a null value. @@ -4078,7 +4078,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. When set to `true`, the `nil` attribute from the XML Schema instance namespace (abbreviated `xsi`) indicates a null value. @@ -4149,7 +4149,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. When set to `true`, the `nil` attribute from the XML Schema instance namespace (abbreviated `xsi`) indicates a null value. @@ -4218,7 +4218,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. When set to `true`, the `nil` attribute from the XML Schema instance namespace (abbreviated `xsi`) indicates a null value. @@ -4297,7 +4297,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. When set to `true`, the `nil` attribute from the XML Schema instance namespace (abbreviated `xsi`) indicates a null value. @@ -4366,7 +4366,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. When set to `true`, the `nil` attribute from the XML Schema instance namespace (abbreviated `xsi`) indicates a null value. @@ -4434,7 +4434,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. When set to `true`, the `nil` attribute from the XML Schema instance namespace (abbreviated `xsi`) indicates a null value. @@ -4494,7 +4494,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. When set to `true`, the `nil` attribute from the XML Schema instance namespace (abbreviated `xsi`) indicates a null value. @@ -4562,7 +4562,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. When set to `true`, the `nil` attribute from the XML Schema instance namespace (abbreviated `xsi`) indicates a null value. @@ -4622,7 +4622,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. When set to `true`, the `nil` attribute from the XML Schema instance namespace (abbreviated `xsi`) indicates a null value. @@ -4700,7 +4700,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `` element identified by an `id` attribute. The `id` value can be referenced multiple times using `href` attributes (or `ref` attributes in SOAP 1.2) in substitute elements. @@ -4770,7 +4770,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `` element identified by an `id` attribute. The `id` value can be referenced multiple times using `href` attributes (or `ref` attributes in SOAP 1.2) in substitute elements. @@ -4850,7 +4850,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `multiRef` element identified by an `id` attribute. The `id` value can be referenced multiple times using `href` attributes (or `ref` attributes in SOAP 1.2) in substitute elements. @@ -4926,7 +4926,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `multiRef` element identified by an `id` attribute. The `id` value can be referenced multiple times using `href` attributes (or `ref` attributes in SOAP 1.2) in substitute elements. @@ -4986,7 +4986,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -5042,7 +5042,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `multiRef` element identified by an `id` attribute. The `id` value can be referenced multiple times using `href` attributes (or `ref` attributes in SOAP 1.2) in substitute elements. @@ -5121,7 +5121,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `multiRef` element identified by an `id` attribute. The `id` value can be referenced multiple times using `href` attributes (or `ref` attributes in SOAP 1.2) in substitute elements. @@ -5193,7 +5193,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. SOAP encoding allows a unique XML element to appear once within a SOAP message as a `multiRef` element identified by an `id` attribute. The `id` value can be referenced multiple times using `href` attributes (or `ref` attributes in SOAP 1.2) in substitute elements. @@ -5260,7 +5260,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The `result` element is defined in the namespace "http://www.w3.org/2002/12/soap-rpc". @@ -5340,7 +5340,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -5453,7 +5453,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -5516,7 +5516,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -5579,7 +5579,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -5645,7 +5645,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -5710,7 +5710,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -5778,7 +5778,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -5914,7 +5914,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The `xsi:type` attribute explicitly indicates the XML Schema data type. The prefix `xsi` refers to the XML Schema instance namespace. @@ -5980,7 +5980,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -6034,7 +6034,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -6097,7 +6097,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -6160,7 +6160,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. ]]> @@ -6223,7 +6223,7 @@ are intended for use only by derived classes that are used internally within the .NET Framework XML serialization infrastructure. + The protected members of are intended for use only by derived classes that are used internally within the .NET XML serialization infrastructure. The `xsi:type` attribute explicitly indicates the XML Schema data type. The prefix `xsi` refers to the XML Schema instance namespace. diff --git a/xml/System.Xml.Serialization/XmlSerializerAssemblyAttribute.xml b/xml/System.Xml.Serialization/XmlSerializerAssemblyAttribute.xml index 79b79c9e7e8..6ac336df0da 100644 --- a/xml/System.Xml.Serialization/XmlSerializerAssemblyAttribute.xml +++ b/xml/System.Xml.Serialization/XmlSerializerAssemblyAttribute.xml @@ -54,65 +54,7 @@ Applied to a Web service client proxy, enables you to specify an assembly that contains custom-made serializers. - - to increase the performance of a Web service client application. - - A typical method of using this attribute is as follows: - -1. Create a client proxy for a Web service. - -2. Open the machine.config file. - -3. Under the system.diagnostics element, add a value under the `` element to keep the compiled files: - - ``` - - - - - - ``` - -4. Compile the proxy. - -5. Run the proxy application. - -6. Open a command window and navigate to the \Temp directory used by the to cache files. - - ``` - cd %temp% - ``` - -7. Find the last file created using the **dir** command with the **/OD** switch. - - ``` - dir *.vb /OD - ``` - -8. Compile the file into an assembly. Name the assembly. - -9. Edit the original proxy code by applying the to the class. Specify the assembly name, as shown in the following C# code. - - ```csharp - [XmlSerializerAssemblyAttribute(AssemblyName="hello.serializer")] - public class Hello: System.Web.Services.Protocols.SoapHttpClientProtocol { - // Proxy code not shown. - } - ``` - -```vb - _ -Public Class Hello -Implements System.Web.Services.Protocols.SoapHttpClientProtocol - ' Proxy code not shown. -End Class -``` - - ]]> - + To be added. diff --git a/xml/System.Xml.Serialization/XmlSerializerVersionAttribute.xml b/xml/System.Xml.Serialization/XmlSerializerVersionAttribute.xml index 63e8ad547b4..75ccbcfe0b8 100644 --- a/xml/System.Xml.Serialization/XmlSerializerVersionAttribute.xml +++ b/xml/System.Xml.Serialization/XmlSerializerVersionAttribute.xml @@ -55,13 +55,13 @@ Signifies that the code was generated by the serialization infrastructure and can be reused for increased performance, when this attribute is applied to an assembly. - that are optimized to serialize user-defined types. The serializers are stored in assemblies that can be reused for efficient serialization. - - The attribute stores version information about the parent assembly for which a set of serializers is generated. Later, when the constructor is called, the infrastructure attempts to locate the pre-generated assembly. If the infrastructure finds an assembly with a matching name, the assembly is loaded and the infrastructure checks for a match between the found assembly's version and the current version of the parent assembly. If the version does not match, the found assembly is not used. Instead, a temporary assembly is generated for the serialization. - + that are optimized to serialize user-defined types. The serializers are stored in assemblies that can be reused for efficient serialization. + + The attribute stores version information about the parent assembly for which a set of serializers is generated. Later, when the constructor is called, the infrastructure attempts to locate the pre-generated assembly. If the infrastructure finds an assembly with a matching name, the assembly is loaded and the infrastructure checks for a match between the found assembly's version and the current version of the parent assembly. If the version does not match, the found assembly is not used. Instead, a temporary assembly is generated for the serialization. + ]]> @@ -237,11 +237,11 @@ Gets or sets the identity of the parent assembly. The version of the parent assembly. - diff --git a/xml/System.Xml.Xsl/XslCompiledTransform.xml b/xml/System.Xml.Xsl/XslCompiledTransform.xml index 495e5665228..9ba33c8231c 100644 --- a/xml/System.Xml.Xsl/XslCompiledTransform.xml +++ b/xml/System.Xml.Xsl/XslCompiledTransform.xml @@ -496,7 +496,7 @@ xslt.Load(typeof(bookOrders)); - An object implementing the interface. In the Microsoft .NET Framework, this can be either an (typically an ), or an containing the style sheet. + An object implementing the interface. In .NET, this can be either an (typically an ), or an containing the style sheet. Compiles the style sheet contained in the object. with no user credentials is used to process any `xsl:import` or `xsl:include` elements. - - The `document()` function is disabled. - - Embedded scripts are not supported. You can use the overload to specify an with the necessary authentication credentials, or to specify different XSLT settings. - - ## Examples The following example loads a style sheet contained in an object. @@ -823,7 +819,7 @@ xslt.Load(typeof(bookOrders)); - An object implementing the interface. In the Microsoft .NET Framework, this can be either an (typically an ), or an containing the style sheet. + An object implementing the interface. In .NET, this can be either an (typically an ), or an containing the style sheet. The to apply to the style sheet. If this is , the setting is applied. The used to resolve any style sheets referenced in XSLT import and include elements. If this is , external resources are not resolved. Compiles the XSLT style sheet contained in the . The resolves any XSLT import or include elements and the XSLT settings determine the permissions for the style sheet. @@ -1212,7 +1208,7 @@ xslt.Load(typeof(bookOrders)); - 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 object implementing the interface. In .NET, 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. @@ -1754,7 +1750,7 @@ xslt.Load(typeof(bookOrders)); - 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 object implementing the interface. In .NET, 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 stream to which you want to output. Executes the transform using the input document specified by the object and outputs the results to a stream. The provides additional runtime arguments. @@ -1838,7 +1834,7 @@ xslt.Load(typeof(bookOrders)); - 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 object implementing the interface. In .NET, 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. Executes the transform using the input document specified by the object and outputs the results to an . The provides additional run-time arguments. @@ -1914,7 +1910,7 @@ xslt.Load(typeof(bookOrders)); - 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 object implementing the interface. In .NET, 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. diff --git a/xml/System.Xml.Xsl/XslTransform.xml b/xml/System.Xml.Xsl/XslTransform.xml index 731a6f241f0..4758606b08b 100644 --- a/xml/System.Xml.Xsl/XslTransform.xml +++ b/xml/System.Xml.Xsl/XslTransform.xml @@ -55,97 +55,7 @@ Transforms XML data using an Extensible Stylesheet Language for Transformations (XSLT) style sheet. - - [!NOTE] -> The class is obsolete in the Microsoft .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must use the namespace `http://www.w3.org/1999/XSL/Transform`. - - Additional arguments can also be added to the style sheet using the class. This class contains input parameters for the style sheet and extension objects which can be called from the style sheet. - - To transform XML data: - -1. Create an object. - -2. Use the method to load the style sheet for the transformation. This method has several overloads and can load a style sheet using an , , , or a URL with the location of the file. - -3. Use the method to transform the XML data. This method has several overloads and can handle different types of input and output. You can also specify an containing additional arguments to use as input during the transformation. - - **Security Considerations** - - When creating an application that uses the class, you should be aware of the following items and their implications: - -- Extension objects are enabled by default. If an object containing extension objects is passed to the method, they are utilized. - -- XSLT style sheets can include references to other files and embedded script blocks. A malicious user can exploit this by supplying you with data or style sheets that when executed will cause your system to process until the computer runs low on resources. - -- XSLT applications that run in a mixed trust environment can result in style sheet spoofing. For example, a malicious user can load an object with a harmful style sheet and hand it off to another user who subsequently calls the method and executes the transformation. - - These security issues can be mitigated by not accepting objects, XSLT style sheets, or XML source data from untrusted sources. - - **Scripting Support** - - This class supports embedded scripting using the `msxsl:script` element. - - In version 1.1 of the .NET Framework, the evidence of the style sheet determines what permissions are given to embedded scripts. - -- If the style sheet was loaded from a Uniform Resource Identifier (URI), the URI is used to create the evidence. This evidence includes the URI along with its site and zone. - -- If the style sheet was loaded using another source, you can provide evidence by passing a object to the method. Otherwise, the script assembly has full trust. - - Semi-trusted callers: `UnmanagedCode` permission is required to compile the embedded script. `ControlEvidence` permission is required to provide to the method. A is thrown if the caller does not have the necessary permissions. See and for more information. - - The `msxsl:script` element has the following requirements: - -- The `msxsl:script` element belongs to the `urn:schemas-microsoft-com:xslt` namespace. The style sheet must include the namespace declaration `xmlns:msxsl=urn:schemas-microsoft-com:xslt`. - -- The `msxsl:script` element can include a `language` attribute that specifies the scripting language to use. The value of the `language` attribute must be one of the following: C#, CSharp, VB, VisualBasic, JScript, or JavaScript. Because the language name is not case-sensitive, JavaScript and javascript are both valid. If a `language` attribute is not specified, it defaults to JScript. - -- The `msxsl:script` element must include an `implements-prefix` attribute that contains the prefix representing the namespace associated with the script block. This namespace must be defined within the style sheet. A style sheet can include multiple script blocks which are grouped by namespace. You cannot have script blocks with multiple languages within the same namespace. Script blocks can call a function defined in another script block, provided the script blocks reside within the same namespace. The contents of a script block are parsed according to the rules and syntax of the scripting language (supplied by the `language` attribute). For example, if you had a C# script block, comments would be prefixed by the `//` characters. The comments must be valid XML content. - -> [!NOTE] -> It is recommended that you wrap script blocks in a CDATA section. - - [!INCLUDE [xsltransform-script](~/includes/xsltransform-script.md)] - - Functions can be declared within the `msxsl:script` element. The following table shows the namespaces that are supported by default. - -|Supported Namespaces|Description| -|--------------------------|-----------------| -|`System`|System classes.| -|`System.Collection`|Collection classes.| -|`System.Text`|Text handling classes.| -|`System.Xml`|Core XML classes.| -|`System.Xml.Xsl`|XSLT classes.| -|`System.Xml.XPath`|XML Path Language (XPath) classes.| - - The supplied arguments and return values defined by the script functions must be one of the World Wide Web Consortium (W3C) types listed below. The following table details the mapping between the W3C types, either XPath or XSLT, and the corresponding .NET Framework classes. - -|W3C Type|Equivalent .NET class| -|--------------|---------------------------| -|String (XPath)|`System.String`| -|Boolean (XPath)|`System.Boolean`| -|Number (XPath)|`System.Double`| -|Result Tree Fragment (XSLT)|`System.Xml.XPath.XPathNavigator`| -|Node Set (XPath)|`System.Xml.XPath.XPathNodeIterator`| - - If the script function utilizes one of the following numeric types: Int16, UInt16, Int32, UInt32, Int64, UInt64, Single, or Decimal, these types are coerced to Double, which maps to the W3C XPath type number. - - An exception is thrown when a function is called that cannot convert the argument result to one of the required types. - -> [!NOTE] -> `msxsl:script` and `msxsl:node-list` are the only functions from the `urn:schemas-microsoft-com:xslt` namespace that are supported by the class. - - has the ability to utilize common language runtime (CLR) code as an extension mechanism. This is accomplished by passing an instance of a class to the class and calling its public methods within an XSLT style sheet. Methods that are defined with the `params` keyword, which allows an unspecified number of parameters to be passed, do not work correctly in this scenario. See [params](/dotnet/csharp/language-reference/keywords/method-parameters) for more details. - - For more information see [XSLT Transformations with the XslTransform Class](/dotnet/standard/data/xml/xslt-transformations-with-the-xsltransform-class). - - ]]> - + To be added. objects are only thread-safe for transform operations. Other operations are not guaranteed to be thread-safe. You must ensure that no other methods are called on the object during load operations. @@ -196,16 +106,7 @@ Loads the XSLT style sheet, including style sheets referenced in and elements. - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - ]]> - + To be added. @@ -257,25 +158,7 @@ The URL that specifies the XSLT style sheet to load. Loads the XSLT style sheet specified by a URL. - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl="http://www.w3.org/1999/XSL/Transform"`. - - This method loads the XSLT style sheet, including any style sheets referenced in `xsl:include` and `xsl:import` elements. External resources are resolved using an with no user credentials. If the style sheet(s) are located on a network resource that requires authentication, use the overload that takes an as one of its arguments and specify an with the necessary credentials. - - If the style sheet contains embedded scripting, the script is compiled to an assembly. The URI of the style sheet is used to create evidence, which is applied to the assembly. - -> [!NOTE] -> If the caller does not have `UnmanagedCode` permission, the embedded script is not compiled and a is thrown. See and for more information. - - ]]> - + To be added. The loaded resource is not a valid style sheet. The style sheet contains embedded script, and the caller does not have permission. @@ -322,29 +205,7 @@ An object that contains the XSLT style sheet. Loads the XSLT style sheet contained in the . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - This method loads the XSLT style sheet, including any style sheets referenced in `xsl:include` and `xsl:import` elements. External resources are resolved using an with no user credentials. If the style sheet(s) are located on a network resource that requires authentication, use the overload that takes an as one of its arguments and specify an with the necessary credentials. - - The style sheet loads from the current node of the through all its children. This enables you to use a portion of a document as the style sheet. After the method returns, the is positioned on the next node after the end of the style sheet. If the end of the document is reached, the is positioned at the end of file (EOF). - - If the style sheet contains entities, you should specify an that can resolve entities ( returns `true`). In this case, an can be used. - - If the style sheet contains embedded scripting, the script is compiled to an assembly. The assembly has full trust. The recommended practice is to provide evidence using the method. - -> [!NOTE] -> If the caller does not have `UnmanagedCode` permission, the embedded script is not compiled and a is thrown. See and for more information. - - ]]> - + To be added. The current node does not conform to a valid style sheet. The style sheet contains embedded scripts, and the caller does not have permission. @@ -389,27 +250,9 @@ - An object implementing the interface. In the .NET Framework, this can be either an (typically an ), or an containing the XSLT style sheet. + An object implementing the interface. In .NET, this can be either an (typically an ), or an containing the XSLT style sheet. Loads the XSLT style sheet contained in the . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - This method loads the XSLT style sheet, including any style sheets referenced in `xsl:include` and `xsl:import` elements. External resources are resolved using an with no user credentials. If the style sheet(s) are located on a network resource that requires authentication, use the overload that takes an as one of its arguments and specify an with the necessary credentials. - - If the style sheet contains embedded scripting, the script is compiled to an assembly. The assembly has full trust. The recommended practice is to provide evidence using the method. - -> [!NOTE] -> If the caller does not have `UnmanagedCode` permission, the embedded script is not compiled and a is thrown. See and for more information. - - ]]> - + To be added. The loaded resource is not a valid style sheet. The style sheet contains embedded scripts, and the caller does not have permission. @@ -456,27 +299,7 @@ An object that contains the XSLT style sheet. Loads the XSLT style sheet contained in the . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - This method loads the XSLT style sheet, including any style sheets referenced in `xsl:include` and `xsl:import` elements. External resources are resolved using an with no user credentials. If the style sheet(s) are located on a network resource that requires authentication, use the overload that takes an as one of its arguments and specify an with the necessary credentials. - - The style sheet is loaded from the current position of the . To use just a portion of the loaded document as the style sheet, navigate to the node corresponding to the beginning of the style sheet. After the method returns, the is positioned at the beginning of the style sheet (on the `xsl:style sheet` node). - - If the style sheet contains embedded scripting, the script is compiled to an assembly. The assembly has full trust. The recommended practice is to provide evidence using the method. - -> [!NOTE] -> If the caller does not have `UnmanagedCode` permission, the embedded script is not compiled and a is thrown. See and for more information. - - ]]> - + To be added. The current node does not conform to a valid style sheet. The style sheet contains embedded scripts, and the caller does not have permission. @@ -544,23 +367,7 @@ The is not cached after the method completes. Loads the XSLT style sheet specified by a URL. - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - If the style sheet contains embedded scripting, the script is compiled to an assembly. The URI of the style sheet is used to create evidence, which is applied to the assembly. - -> [!NOTE] -> If the caller does not have `UnmanagedCode` permission, the embedded script is not compiled and a is thrown. See and for more information. - - ]]> - + To be added. The loaded resource is not a valid style sheet. The style sheet contains embedded script, and the caller does not have permission. @@ -623,29 +430,7 @@ The is not cached after the method completes. Loads the XSLT style sheet contained in the . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - This method loads the XSLT style sheet, including any style sheets referenced in `xsl:include` and `xsl:import` elements. The style sheet loads from the current node of the through all its children. This enables you to use a portion of a document as the style sheet. - - After the method returns, the is positioned on the next node after the end of the style sheet. If the end of the document is reached, the is positioned at the end of file (EOF). - - If the style sheet contains entities, you should specify an that can resolve entities ( returns `true`). In this case, an can be used. - - If the style sheet contains embedded scripting, the script is compiled to an assembly. The assembly has full trust. The recommended practice is to provide evidence using the method. - -> [!NOTE] -> If the caller does not have `UnmanagedCode` permission, the embedded script is not compiled and a is thrown. See and for more information. - - ]]> - + To be added. The current node does not conform to a valid style sheet. The style sheet contains embedded scripts, and the caller does not have permission. @@ -702,28 +487,12 @@ - An object implementing the interface. In the .NET Framework, this can be either an (typically an ), or an containing the XSLT style sheet. + An object implementing the interface. In .NET, 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. Loads the XSLT style sheet contained in the . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - If the style sheet contains embedded scripting, the script is compiled to an assembly. The assembly has full trust. The recommended practice is to provide evidence using the method. - -> [!NOTE] -> If the caller does not have `UnmanagedCode` permission, the embedded script is not compiled and a is thrown. See and for more information. - - ]]> - + To be added. The loaded resource is not a valid style sheet. The style sheet contains embedded scripts, and the caller does not have permission. @@ -785,32 +554,170 @@ The is not cached after the method completes. Loads the XSLT style sheet contained in the . - - To be added. + The current node does not conform to a valid style sheet. + The style sheet contains embedded scripts, and the caller does not have permission. + + + + + +<<<<<<< HEAD + + + + + + + + Method + + System.Xml + 1.0.5000.0 + 2.0.0.0 + 4.0.0.0 + + + System.Xml.ReaderWriter + + + netstandard + + + System.Void + + + + + + + + An object containing the style sheet to load. + The used to load any style sheets referenced in xsl:import and xsl:include elements. If this is , external resources are not resolved. -## Remarks + The is not cached after the method completes. + The set on the assembly generated for the script block in the XSLT style sheet. -> [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). + If this is , script blocks are not processed, the XSLT document() function is not supported, and privileged extension objects are disallowed. - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. + The caller must have permission in order to supply evidence for the script assembly. Semi-trusted callers can set this parameter to . + Loads the XSLT style sheet contained in the . This method allows you to limit the permissions of the style sheet by specifying evidence. + To be added. + The current node does not conform to a valid style sheet. + The referenced style sheet requires functionality that is not allowed by the evidence provided. - The style sheet is loaded from the current position of the . To use a portion of the loaded document as the style sheet, navigate to the node corresponding to the beginning of the style sheet. After the method returns, the is positioned at the beginning of the style sheet (on the `xsl:style sheet` node). + The caller tries to supply evidence and does not have permission. + + + + + + + + + + + + + + + Method + + System.Xml + 1.0.5000.0 + 2.0.0.0 + 4.0.0.0 + + + System.Xml.ReaderWriter + + + netstandard + + + System.Void + + + + + + + + An object implementing the interface. In .NET, 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. - If the style sheet contains embedded scripting, the script is compiled to an assembly. The assembly has full trust. The recommended practice is to provide evidence using the . + The is not cached after the method completes. + The set on the assembly generated for the script block in the XSLT style sheet. -> [!NOTE] -> If the caller does not have `UnmanagedCode` permission, the embedded script is not compiled and a is thrown. See and for more information. + If this is , script blocks are not processed, the XSLT document() function is not supported, and privileged extension objects are disallowed. - ]]> - - The current node does not conform to a valid style sheet. - The style sheet contains embedded scripts, and the caller does not have permission. + The caller must have permission in order to supply evidence for the script assembly. Semi-trusted callers can set this parameter to . + Loads the XSLT style sheet contained in the . This method allows you to limit the permissions of the style sheet by specifying evidence. + To be added. + The loaded resource is not a valid style sheet. + The referenced style sheet requires functionality that is not allowed by the evidence provided. + + The caller tries to supply evidence and does not have permission. + + + + + + + + + + + + + Method + + System.Xml + 1.0.5000.0 + 2.0.0.0 + 4.0.0.0 + + + System.Xml.ReaderWriter + + + netstandard + + + System.Void + + + + + + + + An object containing the style sheet to load. + 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 set on the assembly generated for the script block in the XSLT style sheet. + + If this is , script blocks are not processed, the XSLT document() function is not supported, and privileged extension objects are disallowed. + + The caller must have permission in order to supply evidence for the script assembly. Semi-trusted callers can set this parameter to . + Loads the XSLT style sheet contained in the . This method allows you to limit the permissions of the style sheet by specifying evidence. + To be added. + The current node does not conform to a valid style sheet. + The referenced style sheet requires functionality that is not allowed by the evidence provided. + + The caller tries to supply evidence and does not have permission. + + + + +======= +>>>>>>> a616b87eb03a89aa522fa6635e20af8ab7093d32 System.Xml @@ -819,16 +726,7 @@ Transforms the XML data using the loaded XSLT style sheet. - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - ]]> - + To be added. @@ -875,21 +773,7 @@ The URL of the source document to be transformed. The URL of the output file. Transforms the XML data in the input file and outputs the result to an output file. - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - -> [!NOTE] -> This method is obsolete in version 1.1 of the .NET Framework. The setting of the property determines how the XSLT `document()` function is resolved. The recommended practice is to use the method that takes an object as one of its arguments. - - ]]> - + To be added. @@ -941,31 +825,11 @@ - 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 object implementing the interface. In .NET, 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. Transforms the XML data in the using the specified and outputs the result to an . An containing the results of the transformation. - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - -> [!NOTE] -> This method is now obsolete. The setting of the property determines how the XSLT `document()` function is resolved. The recommended practice is to use the method that takes an object as one of its arguments. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. The `xsl:output` element is not supported when outputting to an (the `xsl:output` element is ignored). See [Outputs from an XslTransform](/dotnet/standard/data/xml/outputs-from-an-xsltransform) for more information. - - This method enables you to do an asynchronous transformation of the source document. - - Transformations apply to the document as a whole. In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. To transform a node fragment, you must create an containing just the node fragment and pass that to the method. - - ]]> - + To be added. @@ -1021,27 +885,7 @@ An containing the namespace-qualified arguments used as input to the transformation. Transforms the XML data in the using the specified and outputs the result to an . An containing the results of the transformation. - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. The transformation selections apply to the document as a whole. In other words, if the current node is set on a node tree other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. After the transformation has been performed, the remains in its original state. This means that the node, which is current before the transformation process, remains the current node after the method has been called. - - Because provides read-only output, the `xsl:output` element is ignored. See [Outputs from an XslTransform](/dotnet/standard/data/xml/outputs-from-an-xsltransform) for more information. - - This method enables you to do an asynchronous transformation of the source document. - -> [!NOTE] -> This method is obsolete. The setting of the property determines how the XSLT document() function is resolved. The recommended practice is to use the method that takes an object as one of its arguments. - - ]]> - + To be added. There was an error processing the XSLT transformation.. @@ -1101,18 +945,7 @@ The is not cached after the method completes. Transforms the XML data in the input file and outputs the result to an output file. - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - ]]> - + To be added. @@ -1168,29 +1001,11 @@ - 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 object implementing the interface. In .NET, 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. Transforms the XML data in the using the specified and outputs the result to a . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - -> [!NOTE] -> This method is now obsolete. The setting of the property determines how the XSLT `document()` function is resolved. The recommended practice is to use the method that takes an object as one of its arguments. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. - - Transformations apply to the document as a whole. In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. To transform a node fragment, you must create an containing just the node fragment and pass that to the method. - - ]]> - + To be added. There was an error processing the XSLT transformation.. @@ -1244,31 +1059,11 @@ - 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 object implementing the interface. In .NET, 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. Transforms the XML data in the using the specified and outputs the result to a . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - -> [!NOTE] -> This method is now obsolete. The setting of the property determines how the XSLT `document()` function is resolved. The recommended practice is to use the method that takes an object as one of its arguments. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. - - The encoding attribute on an `xsl:output` element is not supported when outputting to a . See [Outputs from an XslTransform](/dotnet/standard/data/xml/outputs-from-an-xsltransform) for specifics on which `xsl:output` attributes are supported. - - Transformations apply to the document as a whole. In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. To transform a node fragment, you must create an containing just the node fragment, and pass that to the method. - - ]]> - + To be added. There was an error processing the XSLT transformation. @@ -1329,31 +1124,14 @@ - 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 object implementing the interface. In .NET, 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. Transforms the XML data in the using the specified and outputs the result to an . An containing the results of the transformation. - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. The `xsl:output` element is not supported when outputting to an (the `xsl:output` element is ignored). See [Outputs from an XslTransform](/dotnet/standard/data/xml/outputs-from-an-xsltransform) for more information. - - This method enables you to do an asynchronous transformation of the source document. - - Transformations apply to the document as a whole. In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. To transform a node fragment, you must create an containing just the node fragment, and pass that to the method. - - ]]> - + To be added. @@ -1407,29 +1185,11 @@ - 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 object implementing the interface. In .NET, 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. Transforms the XML data in the using the specified and outputs the result to an . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - -> [!NOTE] -> This method is now obsolete. The setting of the property determines how the XSLT `document()` function is resolved. The recommended practice is to use the method that takes an object as one of its arguments. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. The `xsl:output` element is not supported when outputting to an (`xsl:output` is ignored). See [Outputs from an XslTransform](/dotnet/standard/data/xml/outputs-from-an-xsltransform) for more information. - - Transformations apply to the document as a whole. In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. To transform a node fragment, you must create an containing just the node fragment and pass that to the method. - - ]]> - + To be added. There was an error processing the XSLT transformation. @@ -1487,25 +1247,7 @@ An containing the namespace-qualified arguments used as input to the transformation. The stream to which you want to output. Transforms the XML data in the using the specified and outputs the result to a . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. The transformation selections apply to the document as a whole. In other words, if the current node is set on a node tree other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. After the transformation has been performed, the remains in its original state. This means that the node, which is current before the transformation process, remains the current node after the method has been called. - - See [Outputs from an XslTransform](/dotnet/standard/data/xml/outputs-from-an-xsltransform) for specifics on which `xsl:output` attributes are supported. - -> [!NOTE] -> This method is now obsolete. The setting of the property determines how the XSLT `document()` function is resolved. The recommended practice is to use the method that takes an object as one of its arguments. - - ]]> - + To be added. There was an error processing the XSLT transformation.. @@ -1564,25 +1306,7 @@ An containing the namespace-qualified arguments used as input to the transformation. The to which you want to output. Transforms the XML data in the using the specified and outputs the result to a . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. The transformation selections apply to the document as a whole. In other words, if the current node is set on a node tree other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. After the transformation is performed, the remains in its original state. This means that the node, which is current before the transformation process, remains the current node after the method has been called. - - The encoding attribute on an `xsl:output` element is not supported when outputting to a . See [Outputs from an XslTransform](/dotnet/standard/data/xml/outputs-from-an-xsltransform) for specifics on which `xsl:output` attributes are supported. - -> [!NOTE] -> This method is now obsolete. The setting of the property determines how the XSLT `document()` function is resolved. The recommended practice is to use the method that takes an object as one of its arguments. - - ]]> - + To be added. There was an error processing the XSLT transformation.. @@ -1651,24 +1375,7 @@ The is not cached after the method completes. Transforms the XML data in the using the specified and outputs the result to an . An containing the results of the transformation. - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. The transformation selections apply to the document as a whole. In other words, if the current node is set on a node tree other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. After the transformation has been performed, the remains in its original state. This means that the node, which is current before the transformation process, remains the current node after the method has been called. - - Because provides read-only output, the `xsl:output` element is ignored. See [Outputs from an XslTransform](/dotnet/standard/data/xml/outputs-from-an-xsltransform) for more information. - - This method enables you to do an asynchronous transformation of the source document. - - ]]> - + To be added. There was an error processing the XSLT transformation.. @@ -1727,25 +1434,7 @@ An containing the namespace-qualified arguments used as input to the transformation. The to which you want to output. Transforms the XML data in the using the specified args and outputs the result to an . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. The transformation selections apply to the document as a whole. In other words, if the current node is set on a node tree other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. After the transformation is performed, the remains in its original state. This means that the node, that is current before the transformation process, remains the current node after the method has been called. - - The `xsl:output` element is not supported when outputting to an (`xsl:output` is ignored). See [Outputs from an XslTransform](/dotnet/standard/data/xml/outputs-from-an-xsltransform) for more information. - -> [!NOTE] -> This method is now obsolete. The setting of the property determines how the XSLT `document()` function is resolved. The recommended practice is to use the method that takes an object as one of its arguments. - - ]]> - + To be added. There was an error processing the XSLT transformation.. @@ -1808,29 +1497,14 @@ - 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 object implementing the interface. In .NET, 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. Transforms the XML data in the using the specified and outputs the result to a . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. - - Transformations apply to the document as a whole. In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. To transform a node fragment, you must create an containing just the node fragment and pass that to the method. - - ]]> - + To be added. There was an error processing the XSLT transformation. @@ -1894,31 +1568,14 @@ - 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 object implementing the interface. In .NET, 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. Transforms the XML data in the using the specified and outputs the result to a . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. - - The encoding attribute on an `xsl:output` element is not supported when outputting to a . See [Outputs from an XslTransform](/dotnet/standard/data/xml/outputs-from-an-xsltransform) for specifics on which `xsl:output` attributes are supported. - - Transformations apply to the document as a whole. In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. To transform a node fragment, you must create an containing just the node fragment and pass that to the method. - - ]]> - + To be added. There was an error processing the XSLT transformation. @@ -1982,29 +1639,14 @@ - 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 object implementing the interface. In .NET, 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. Transforms the XML data in the using the specified and outputs the result to an . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. The `xsl:output` element is not supported when outputting to an (`xsl:output` is ignored). See [Outputs from an XslTransform](/dotnet/standard/data/xml/outputs-from-an-xsltransform) for more information. - - Transformations apply to the document as a whole. In other words, if you pass in a node other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. To transform a node fragment, you must create an containing just the node fragment and pass that to the method. - - ]]> - + To be added. There was an error processing the XSLT transformation. @@ -2075,22 +1717,7 @@ The is not cached after the method completes. Transforms the XML data in the using the specified and outputs the result to a . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. The transformation selections apply to the document as a whole. In other words, if the current node is set on a node tree other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. After the transformation has been performed, the remains in its original state. This means that the node, which is current before the transformation process, remains the current node after the method has been called. - - See [Outputs from an XslTransform](/dotnet/standard/data/xml/outputs-from-an-xsltransform) for specifics on which `xsl:output` attributes are supported. - - ]]> - + To be added. There was an error processing the XSLT transformation. @@ -2162,22 +1789,7 @@ The is not cached after the method completes. Transforms the XML data in the using the specified and outputs the result to a . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. The transformation selections apply to the document as a whole. In other words, if the current node is set on a node tree other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. After the transformation is performed, the remains in its original state. This means that the node, which is current before the transformation process, remains the current node after the method has been called. - - The encoding attribute on an `xsl:output` element is not supported when outputting to a . See [Outputs from an XslTransform](/dotnet/standard/data/xml/outputs-from-an-xsltransform) for specifics on which `xsl:output` attributes are supported. - - ]]> - + To be added. There was an error processing the XSLT transformation.. @@ -2249,22 +1861,7 @@ The is not cached after the method completes. Transforms the XML data in the using the specified args and outputs the result to an . - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - supports the XSLT 1.0 syntax. The XSLT style sheet must include the namespace declaration `xmlns:xsl= http://www.w3.org/1999/XSL/Transform`. - - The `args` are matched with the `xsl:param` elements defined in the style sheet. The transformation selections apply to the document as a whole. In other words, if the current node is set on a node tree other than the document root node, this does not prevent the transformation process from accessing all nodes in the loaded document. After the transformation is performed, the remains in its original state. This means that the node, that is current before the transformation process, remains the current node after the method has been called. - - The `xsl:output` element is not supported when outputting to an (`xsl:output` is ignored). See [Outputs from an XslTransform](/dotnet/standard/data/xml/outputs-from-an-xsltransform) for more information. - - ]]> - + To be added. There was an error processing the XSLT transformation.. @@ -2317,27 +1914,7 @@ Sets the used to resolve external resources when the method is called. The to use during transformation. If set to , the XSLT document() function is not resolved. - - [!NOTE] -> The class is obsolete in the .NET Framework version 2.0. The class is the new XSLT processor. For more information, see [Using the XslCompiledTransform Class](/dotnet/standard/data/xml/using-the-xslcompiledtransform-class) and [Migrating From the XslTransform Class](/dotnet/standard/data/xml/migrating-from-the-xsltransform-class). - - In version 1.1 of the .NET Framework, the trust level of the application determines the default behavior: - - `Fully trusted code:` A default with no user credentials is used to resolve the `document()` function. If authentication is required to access the external resource, use this property to specify an with the necessary credentials. - - `Semi-trusted code:` The property is set to `null`, which means the `document()` function is not resolved. Because full trust is required to specify an , this property also cannot be set. - - This resolver is used when the XSLT `document()` function is invoked. It is not used to resolve `xsl:import` and `xsl:include` elements referenced in the style sheet. To specify an to use to resolve `xsl:import` and `xsl:include` elements referenced in the style sheet, use the overload, which takes an as one of its arguments. - -> [!NOTE] -> This property is obsolete in version 1.1 of the .NET Framework. Specifying an using the method is the recommended practice. In this case, the is not cached after the method completes. - - ]]> - + To be added. diff --git a/xml/System.Xml/IApplicationResourceStreamResolver.xml b/xml/System.Xml/IApplicationResourceStreamResolver.xml index de0f13eac70..df67f580d6f 100644 --- a/xml/System.Xml/IApplicationResourceStreamResolver.xml +++ b/xml/System.Xml/IApplicationResourceStreamResolver.xml @@ -31,8 +31,8 @@ [<System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)>] - [System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)] - [<System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)>] + [System.Obsolete("This API supports the .NET infrastructure and is not intended to be used directly from your code.", true)] + [<System.Obsolete("This API supports the .NET infrastructure and is not intended to be used directly from your code.", true)>] @@ -72,8 +72,8 @@ [<System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)>] - [System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)] - [<System.Obsolete("This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.", true)>] + [System.Obsolete("This API supports the .NET infrastructure and is not intended to be used directly from your code.", true)] + [<System.Obsolete("This API supports the .NET infrastructure and is not intended to be used directly from your code.", true)>] diff --git a/xml/System.Xml/ValidationType.xml b/xml/System.Xml/ValidationType.xml index fbe1670c9a2..3a4b8c1688b 100644 --- a/xml/System.Xml/ValidationType.xml +++ b/xml/System.Xml/ValidationType.xml @@ -105,10 +105,7 @@ 1 - 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. - + Validates if DTD or schema information is found. @@ -284,10 +281,7 @@ Calls to report default attr 3 - 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. - + Validate according to XML-Data Reduced (XDR) schemas, including inline XDR schemas. XDR schemas are recognized using the namespace prefix or the property. diff --git a/xml/System.Xml/XmlConvert.xml b/xml/System.Xml/XmlConvert.xml index e19a0d4d623..8ee8482400f 100644 --- a/xml/System.Xml/XmlConvert.xml +++ b/xml/System.Xml/XmlConvert.xml @@ -914,14 +914,7 @@ The string to convert. Converts the to a equivalent. A equivalent of the string. - - [!NOTE] -> The method is obsolete in the 2.0 version of the .NET Framework and has been replaced by the method. - - ]]> - + To be added. is . @@ -2055,17 +2048,7 @@ The value to convert. Converts the to a . A string representation of the in the format yyyy-MM-ddTHH:mm:ss where 'T' is a constant literal. - - [!NOTE] -> The method is obsolete in the 2.0 version of the .NET Framework and has been replaced with the method. -> The suggested mode is . If an exact match is expected, please use with the format string `yyyy-MM-ddTHH:mm:ss.fffffffzzzzzz`. - - ]]> - + To be added. diff --git a/xml/System.Xml/XmlDocument.xml b/xml/System.Xml/XmlDocument.xml index c8532361557..cad8cffb886 100644 --- a/xml/System.Xml/XmlDocument.xml +++ b/xml/System.Xml/XmlDocument.xml @@ -927,7 +927,7 @@ The following example adds new nodes to an XML document. - Name of the document type. + The name of the document type. The public identifier of the document type or . You can specify a public URI and also a system identifier to identify the location of the external DTD subset. The system identifier of the document type or . Specifies the URL of the file location for the external DTD subset. The DTD internal subset of the document type or . @@ -953,11 +953,6 @@ The following example creates a DocumentType node and adds it to an XML document ]]> - - This method has an inheritance demand. Full trust is required to override the method. - - This method is a Microsoft extension to the Document Object Model (DOM). - @@ -4213,11 +4208,6 @@ The example uses the file, `cd.xml`, as input. ]]> The reader is positioned on a node type that does not translate to a valid DOM node (for example, EndElement or EndEntity). - - This method has an inheritance demand. Full trust is required to override the method. - - This method is a Microsoft extension to the Document Object Model (DOM). - @@ -4990,9 +4980,7 @@ The following example displays the document. 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 . + The to use. [!NOTE] > If the `XmlDocument` is loaded using an that had an `XmlResolver` set to it, the `XmlResolver` on the `XmlReader` is not cached by the `XmlDocument` after completes. - In version 1.1 of the.NET Framework, if this property is not set, the trust level of the application determines the default behavior. - - `Fully trusted code:` The document uses a default with no user credentials. If authentication is required to access a network resource, use the `XmlResolver` property to specify an `XmlResolver` with the necessary credentials. - - `Semi-trusted code:` The `XmlResolver` property is set to `null`. External resources are not resolved. - - For more information on security and the `XmlResolver` property, see [Resolving External Resources](/dotnet/standard/data/xml/resolving-external-resources). - This property is a Microsoft extension to the Document Object Model (DOM). ## Examples diff --git a/xml/System.Xml/XmlNodeReader.xml b/xml/System.Xml/XmlNodeReader.xml index f29d5b1c565..a8b09f66845 100644 --- a/xml/System.Xml/XmlNodeReader.xml +++ b/xml/System.Xml/XmlNodeReader.xml @@ -1464,9 +1464,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); ## Remarks > [!NOTE] -> To take advantage of newer features, the recommended practice is to create instances using the class and the method. This allows you to take full advantage of all the new features introduced in the .NET FrameworkFor more information, see the Remarks section in the reference page. - - +> To take advantage of newer features, the recommended practice is to create instances using the class and the method. ## Examples The following example gets the value of the first attribute of the root node. diff --git a/xml/System.Xml/XmlReader.xml b/xml/System.Xml/XmlReader.xml index f54cf0d4cc6..c5f089a8028 100644 --- a/xml/System.Xml/XmlReader.xml +++ b/xml/System.Xml/XmlReader.xml @@ -282,7 +282,7 @@ The following example code shows how to use the asynchronous API to parse XML. ## Remarks The binary content read methods include the , , , and methods. If this property returns `false` a is returned when any of the binary read methods is called. - All Microsoft .NET Framework implementations of the class return `true` for this property. + All .NET implementations of the class return `true` for this property. ]]> @@ -334,7 +334,7 @@ The following example code shows how to use the asynchronous API to parse XML. objects that were created from the static method always return `true`. All other Microsoft .NET Framework implementations of the class, including the class, return `false`. + Text parsing objects that were created from the static method always return `true`. All other .NET implementations of the class, including the class, return `false`. If this property returns `false` a is returned when the method is called. @@ -513,14 +513,12 @@ The following example code shows how to use the asynchronous API to parse XML. A default with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on. > [!IMPORTANT] -> Starting with the .NET Framework 4.5.2, no default is provided. If your solution targets the .NET Framework 4.5.2 or later versions, specify an using the property. +> No default is provided. Specify an using the property. If the external resource is located on a network resource that requires authentication, specify an with the necessary credentials using the property. The created object expands entity references and performs XML normalization of new line characters. - - ## Examples The following example creates an object that reads from a . @@ -586,7 +584,7 @@ The following example code shows how to use the asynchronous API to parse XML. A default with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on. > [!IMPORTANT] -> Starting with the .NET Framework 4.5.2, no default is provided. If your solution targets the .NET Framework 4.5.2 or later versions, specify an using the property. +> No default is provided. Specify an using the property. If the external resource is located on a network resource that requires authentication, specify an with the necessary credentials using the property. @@ -658,7 +656,7 @@ The following example code shows how to use the asynchronous API to parse XML. A default with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on. > [!IMPORTANT] -> Starting with the .NET Framework 4.5.2, no default is provided. If your solution targets the .NET Framework 4.5.2 or later versions, specify an using the property. +> No default is provided. Specify an using the property. If the external resource is located on a network resource that requires authentication, specify an with the necessary credentials using the property. @@ -743,7 +741,7 @@ The following example code shows how to use the asynchronous API to parse XML. By default an with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on. > [!IMPORTANT] -> Starting with the .NET Framework 4.5.2, no default is provided. If your solution targets the .NET Framework 4.5.2 or later versions, specify an using the property. +> No default is provided. Specify an using the property. If the external resource is located on a network resource that requires authentication, use the property to specify an with the necessary credentials. @@ -824,7 +822,7 @@ The following example code shows how to use the asynchronous API to parse XML. By default an with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on. > [!IMPORTANT] -> Starting with the .NET Framework 4.5.2, no default is provided. If your solution targets the .NET Framework 4.5.2 or later versions, specify an using the property. +> No default is provided. Specify an using the property. If the external resource is located on a network resource that requires authentication, use the property to specify an with the necessary credentials. @@ -905,7 +903,7 @@ The following example code shows how to use the asynchronous API to parse XML. By default an with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on. > [!IMPORTANT] -> Starting with the .NET Framework 4.5.2, no default is provided. If your solution targets the .NET Framework 4.5.2 or later versions, specify an using the property. +> No default is provided. Specify an using the property. This means that the can access any locations that does not require authentication. If the external resource is located on a network resource that requires authentication, use the property to specify an with the necessary credentials. @@ -994,7 +992,7 @@ The following example code shows how to use the asynchronous API to parse XML. A default with no credentials is used to access any external resources such as a schema. > [!IMPORTANT] -> Starting with the .NET Framework 4.5.2, no default is provided. If your solution targets the .NET Framework 4.5.2 or later versions, specify an using the property. +> No default is provided. Specify an using the property. If the external resource is located on a network resource that requires authentication, specify an with the necessary credentials using the property. @@ -1099,7 +1097,7 @@ The following example code shows how to use the asynchronous API to parse XML. By default an with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on. > [!IMPORTANT] -> Starting with the .NET Framework 4.5.2, no default is provided. If your solution targets the .NET Framework 4.5.2 or later versions, specify an using the property. +> No default is provided. Specify an using the property. If the external resource is located on a network resource that requires authentication, use the property to specify an with the necessary credentials. @@ -1193,7 +1191,7 @@ The following example code shows how to use the asynchronous API to parse XML. By default an with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on. > [!IMPORTANT] -> Starting with the .NET Framework 4.5.2, no default is provided. If your solution targets the .NET Framework 4.5.2 or later versions, specify an using the property. +> No default is provided. Specify an using the property. If the external resource is located on a network resource that requires authentication, use the property to specify an with the necessary credentials. @@ -1283,7 +1281,7 @@ The following example code shows how to use the asynchronous API to parse XML. By default an with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on. > [!IMPORTANT] -> Starting with the .NET Framework 4.5.2, no default is provided. If your solution targets the .NET Framework 4.5.2 or later versions, specify an using the property. +> No default is provided. Specify an using the property. If the external resource is located on a network resource that requires authentication, use the property to specify an with the necessary credentials. @@ -1375,7 +1373,7 @@ The following example code shows how to use the asynchronous API to parse XML. By default an with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on. > [!IMPORTANT] -> Starting with the .NET Framework 4.5.2, no default is provided. If your solution targets the .NET Framework 4.5.2 or later versions, specify an using the property. +> No default is provided. Specify an using the property. If the external resource is located on a network resource that requires authentication, use the property to specify an with the necessary credentials. @@ -1474,7 +1472,7 @@ The following example code shows how to use the asynchronous API to parse XML. By default an with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on. > [!IMPORTANT] -> Starting with the .NET Framework 4.5.2, no default is provided. If your solution targets the .NET Framework 4.5.2 or later versions, specify an using the property. +> No default is provided. Specify an using the property. This means that the can access any locations that does not require authentication. If the external resource is located on a network resource that requires authentication, use the property to specify an with the necessary credentials. @@ -4124,9 +4122,7 @@ An asynchronous method was called without - 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. The value can 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 . @@ -5430,9 +5426,7 @@ An asynchronous method was called without - 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. The value can be the type. An object that is used to resolve any namespace prefixes related to type conversion. Reads the element content as the requested type. The element content converted to the requested typed object. @@ -5518,9 +5512,7 @@ An method was called before a previous asy - 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. The value can 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. diff --git a/xml/System.Xml/XmlReaderSettings.xml b/xml/System.Xml/XmlReaderSettings.xml index 04d27e21e6e..8db4746cecd 100644 --- a/xml/System.Xml/XmlReaderSettings.xml +++ b/xml/System.Xml/XmlReaderSettings.xml @@ -154,6 +154,48 @@ The following example creates an that uses an +<<<<<<< HEAD + + + + + + + + Constructor + + System.Xml + 4.0.0.0 + + + System.Xml.ReaderWriter + + + netstandard + + + + [System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)] + [<System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)>] + + + [System.Obsolete("This API supports the .NET infrastructure and is not intended to be used directly from your code.", true)] + [<System.Obsolete("This API supports the .NET infrastructure and is not intended to be used directly from your code.", true)>] + + + + + + + The XML resolver. + Initializes a new instance of the class. + To be added. + + + + +======= +>>>>>>> a616b87eb03a89aa522fa6635e20af8ab7093d32 @@ -1452,17 +1494,12 @@ The output is as follows: ## Remarks The following table describes the values. -> [!NOTE] -> The and enumeration values are obsolete in .NET Framework version 2.0. - |ValidationType|Description| |--------------------|-----------------| |`DTD`|Validation is performed using a document type definition (DTD). **Note:** The property must also be set to .| |`None`|The does not validate data, or perform any type assignment.| |`Schema`|Validation and type assignment is performed using an XML Schema definition language (XSD) schema. The reader accesses the XML Schema using the following:

- Uses the property to access the object associated with this reader.
- Uses the in-line schema contained in the XML instance document. (The option must be enabled.)
- Uses the XML Schema specified by schema location hints (`xsi:schemaLocation` or `xsi:noNamespaceSchemaLocation` attribute) found in the XML instance document. (The option must be enabled.)| - - ## Examples The following example validates using a schema stored in the . @@ -1530,7 +1567,7 @@ The output is as follows: Sets the used to access external documents. - An used to access external documents. If set to , an is thrown when the tries to access an external resource. The default is a new with no credentials. Starting with the .NET Framework 4.5.2, this setting has a default value of . + An used to access external documents. If set to , an is thrown when the tries to access an external resource. The default is a new with no credentials. This setting has a default value of . Helps to secure another implementation of by wrapping the object and restricting the resources that the underlying has access to. For more information about this API, see Supplemental API remarks for XmlSecureResolver. - - This class has an inheritance demand. Full trust is required to inherit from the class. - @@ -69,23 +66,7 @@ Initializes a new instance of the class. - - constructor restricts access by using a URL. - -- The constructor restricts access by using a permission set. - -- The constructor restricts access by using evidence. - -See the constructor reference topics for examples of these types of restrictions. - - ]]> - + To be added. @@ -137,24 +118,7 @@ See the constructor reference topics for examples of these types of restrictions 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 . Initializes a new instance of the class with the and URL provided. - - [!IMPORTANT] -> There are differences in the security infrastructure for code running on the .NET Framework common language runtime (CLR) and for code running on the CLR that is integrated within Microsoft SQL Server 2005. This can lead to cases where code developed for the .NET Framework CLR operates differently when used on the SQL Server integrated CLR. One of these differences affects the class when you have evidence that is based on a URL (that is, when you use the method or the constructor). The policy resolution mechanism of the SQL Server integrated CLR does not use the or information. Instead, it grants permissions based on the GUID that the server adds when assemblies are loaded. When you use the in the SQL Server integrated CLR, provide any required evidence directly by using a specified . - - - -## Examples - This example uses the constructor to create an object that is allowed to access your local intranet site only. - - :::code language="csharp" source="~/snippets/csharp/System.Xml/XmlSecureResolver/Overview/XmlSecureResolver_ex.cs" id="Snippet3"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Data/XmlSecureResolver_Samples/VB/XmlSecureResolver_ex.vb" id="Snippet3"::: - - ]]> - + To be added. @@ -196,17 +160,7 @@ See the constructor reference topics for examples of these types of restrictions 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. - - with default credentials to resolve and open network resources needed by the . - - :::code language="csharp" source="~/snippets/csharp/System.Xml/XmlSecureResolver/Credentials/secresolver2.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Data/XmlSecureResolver.Credentials/VB/secresolver2.vb" id="Snippet1"::: - - ]]> - + To be added. @@ -267,22 +221,8 @@ See the constructor reference topics for examples of these types of restrictions The type of object to return. The current version only returns objects. 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 stream returned by calling on the underlying . If a type other than is specified, the method returns . - - [!IMPORTANT] -> Your application can mitigate memory denial of service threats to the method by implementing an that limits the number of bytes read. This helps guard against situations where malicious code attempts to pass an infinite stream of bytes to the method. - - ]]> - - - is neither nor a type. - --or- - -.NET 7 and later versions: In all cases. + To be added. + In all cases. The specified URI is not an absolute URI. is . diff --git a/xml/System.Xml/XmlTextReader.xml b/xml/System.Xml/XmlTextReader.xml index bad645b2603..4c6f62a46ab 100644 --- a/xml/System.Xml/XmlTextReader.xml +++ b/xml/System.Xml/XmlTextReader.xml @@ -65,9 +65,6 @@ We recommend that you use the class instead. For more information about this API, see Supplemental API remarks for XmlTextReader. - - This class has an inheritance demand. Full trust is required to inherit from . - XML Documents and Data @@ -304,9 +301,6 @@ If the file is located on a resource that requires access credentials, use the property to specify the necessary credentials. -> [!NOTE] -> In version 1.1 of the .NET Framework, partially trusted code cannot set the `XmlResolver` property. The workaround is to create an with the necessary credentials, pass the URI to the method, and then construct the `XmlTextReader` using the resulting object. The workaround is described in the following C# code. - ```csharp // Create a resolver with the necessary credentials. XmlUrlResolver resolver = new XmlUrlResolver(); @@ -319,8 +313,6 @@ Stream s=(Stream)resolver.GetEntity(myUri, null, typeof(Stream)); XmlTextReader reader = new XmlTextReader(s); ``` - - ## Examples The following example reads an XML file and displays each of the nodes. @@ -3967,7 +3959,7 @@ abc - This method returns the actual character content. There is no attempt to resolve entities, CDATA, or any other markup encountered. `ReadChars` returns everything between the start tag and the end tag, including markup. -- `ReadChars` ignores XML markup that is not well-formed. For example, when reading the following XML string `12`, `ReadChars` returns `12`. (It returns markup from the matching element pair and ignores others.) +- `ReadChars` ignores XML markup that is not well-formed. For example, when reading the following XML string `12`, `ReadChars` returns `12`. (It returns markup from the matching element pair and ignores others.) - This method does not do any normalization. @@ -4084,11 +4076,11 @@ if (XmlNodeType.Element == reader.NodeType && "thing" == reader.Name) This method has the following behavior: -- returns the value 0 when it has reached the end of the byte stream it was operating on. The reader is positioned on the first non-content node. +- returns the value 0 when it has reached the end of the byte stream it was operating on. The reader is positioned on the first non-content node. - If you ask for fewer, or the exact number, of bytes than are left in the stream the reader remains in its current position. -- is not supported on the following XML node types: `Element`, `XmlDeclaration`, `None`, `Document`, `DocumentType`, `Notation`, `Entity`, `DocumentFragment`. +- is not supported on the following XML node types: `Element`, `XmlDeclaration`, `None`, `Document`, `DocumentType`, `Notation`, `Entity`, `DocumentFragment`. ]]> @@ -4162,11 +4154,11 @@ if (XmlNodeType.Element == reader.NodeType && "thing" == reader.Name) This method has the following behavior: -- returns the value 0 when it has reached the end of the byte stream it was operating on. The reader is positioned on the first non-content node. +- returns the value 0 when it has reached the end of the byte stream it was operating on. The reader is positioned on the first non-content node. - If you ask for fewer, or the exact number, of bytes than are left in the stream the reader remains in its current position. -- is not supported on the following XML node types: `Element`, `XmlDeclaration`, `None`, `Document`, `DocumentType`, `Notation`, `Entity`, `DocumentFragment`. +- is not supported on the following XML node types: `Element`, `XmlDeclaration`, `None`, `Document`, `DocumentType`, `Notation`, `Entity`, `DocumentFragment`. ]]> @@ -4515,19 +4507,14 @@ if (XmlNodeType.Element == reader.NodeType && "thing" == reader.Name) This method enables you to parse multiple XML documents in a single stream. When you reach the end of an XML document, you can call `ResetState` to reset the state of the reader in preparation for the next XML document. > [!IMPORTANT] -> The documents in the stream must share the same encoding. If this is not the case, when `ResetState` is called an is thrown. (This is a change in behavior from .NET Framework version 1.1 and earlier). +> The documents in the stream must share the same encoding. If this is not the case, when `ResetState` is called an is thrown. The following properties are not affected by `ResetState`. -- - -- - -- - -- - - +- +- +- +- ## Examples The following example parses two XML documents in a single stream. @@ -5095,9 +5082,7 @@ if (XmlNodeType.Element == reader.NodeType && "thing" == reader.Name) 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. with no user credentials. If authentication is required to access a network resource, use the `XmlResolver` property to specify an `XmlResolver` with the necessary credentials. - - `Semi-trusted code:` The `XmlResolver` property is set to `null`. External resources are not resolved. - - - ## Examples The following example uses the `XmlResolver` property to specify the credentials necessary to access the networked file. diff --git a/xml/System.Xml/XmlUrlResolver.xml b/xml/System.Xml/XmlUrlResolver.xml index bcd7cf99fd8..b954cd2fc8b 100644 --- a/xml/System.Xml/XmlUrlResolver.xml +++ b/xml/System.Xml/XmlUrlResolver.xml @@ -84,9 +84,7 @@ An instance of the `XmlCachingResolver` class is created with the `Boolean` `enableHttpCaching`. When this value is set to `true`, the instance resolves a resource from the default cache if possible. When `enableHttpCaching` is set to `false`, the instance uses the default behavior and resolves resources from their source. > [!NOTE] -> This example leverages the extensibility of the XML classes in the .NET Framework. Other classes can be extended and customized to suit the needs of a particular application. - - +> This example leverages the extensibility of the XML classes in .NET. Other classes can be extended and customized to suit the needs of a particular application. ## Examples The following example creates an that uses an with default credentials. @@ -516,9 +514,6 @@ resolver.Credentials = myCache; is or is . - - This method has an inheritance demand. Full trust is required to override the method. - diff --git a/xml/System.Xml/XmlValidatingReader.xml b/xml/System.Xml/XmlValidatingReader.xml index 577a5432850..de78f47e9bf 100644 --- a/xml/System.Xml/XmlValidatingReader.xml +++ b/xml/System.Xml/XmlValidatingReader.xml @@ -69,25 +69,8 @@ - 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. We recommend that you use the class and the method to create a validating XML reader. - - class and provides support for data validation. Use the property to have the reader validate by using schema files that are cached in an . The property specifies what type of validation the reader should perform. Setting the property to ValidationType.None creates a non-validating reader. - - throws an on XML parse errors. After an exception is thrown the state of the reader is not predictable. For example, the reported node type may be different than the actual node type of the current node. Use the property to check whether a reader is in error state. - -> [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - - - This class has an inheritance demand. Full trust is required to inherit from . - + Represents a reader that provides document type definition (DTD), XML-Data Reduced (XDR) schema, and XML Schema definition language (XSD) validation. + To be added. @@ -140,20 +123,7 @@ The to read from while validating. The current implementation supports only . Initializes a new instance of the class that validates the content returned from the given . - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - All nodes returned from the given `XmlReader` are also returned from this validating reader, so there is no information loss in the process. New nodes not returned from the underlying reader may be added by this reader (for example, default attributes and the children of an entity reference). Any properties set on the given `XmlTextReader` also apply to this validating reader. For example, if the supplied reader had WhitespaceHandling.None set, this validating reader also ignores white space. - - When external document type definitions (DTDs) or schemas are needed for validation, the property sets the object to use for resolving external resources. - - ]]> - + To be added. The reader specified is not an . @@ -202,41 +172,7 @@ The of the XML fragment. This determines what the fragment can contain (see table below). The in which the XML fragment is to be parsed. This includes the to use, encoding, namespace scope, current , and scope. Initializes a new instance of the class with the specified values. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This constructor parses the given string as a fragment of XML. If the XML fragment is an element or attribute, you can bypass the root level rules for well-formed XML documents. - - The following table lists valid values for `fragType` and how the reader parses each of the different node types. - -|XmlNodeType|Fragment May Contain| -|-----------------|--------------------------| -|Element|Any valid element content (for example, any combination of elements, comments, processing instructions, cdata, text, and entity references).| -|Attribute|The value of an attribute (the part inside the quotes).| -|Document|The contents of an entire XML document; this enforces document level rules.| - - The reader uses the following steps to determine the encoding of the stream: - -1. Checks the property to determine the encoding. - -2. If the `Encoding` property is `null`, the reader checks for a byte-order mark at the beginning of the stream. - -3. If the `Encoding` property is `null`, and no byte-order mark is found, the reader assumes the stream is encoded in UTF-8. - - If this reader will be validating using document type definition (DTD) (that is, is set to ValidationType.DTD or ValidationType.Auto), the `XmlParserContext` specified in the constructor must supply all the necessary DocumentType information. - -> [!NOTE] -> It is not possible to validate a fragment by using a DTD. By definition a DTD requires an entire document to be loaded for validation. - - If this reader will be validating by using XML-Data Reduced (XDR) or XML Schema definition language (XSD) schemas, use the property to specify the that contains the schemas (that is, the `XmlParserContext` does not need to supply the DocumentType information). - - ]]> - + To be added. is not one of the node types listed in the table below. @@ -292,33 +228,7 @@ The of the XML fragment. This also determines what the fragment string can contain (see table below). The in which the XML fragment is to be parsed. This includes the to use, encoding, namespace scope, current xml:lang, and xml:space scope. Initializes a new instance of the class with the specified values. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This constructor parses the given string as a fragment of XML. If the XML fragment is an element or attribute, you can bypass the root level rules for well-formed XML documents. This constructor can handle strings returned from . - - The following table lists valid values for `fragType` and how the reader parses each of the different node types. - -|XmlNodeType|Fragment May Contain| -|-----------------|--------------------------| -|Element|Any valid element content (for example, any combination of elements, comments, processing instructions, cdata, text, and entity references).| -|Attribute|The value of an attribute (the part inside the quotes).| -|Document|The contents of an entire XML document; this enforces document level rules.| - - If this reader will be validating by using document type definition (DTD) (that is, is set to ValidationType.DTD or ValidationType.Auto), the `XmlParserContext` specified in the constructor must supply all the necessary DocumentType information. - -> [!NOTE] -> It is not possible to validate a fragment by using DTD. By definition DTD requires an entire document to be loaded for validation. - - If this reader will be validating by using XML-Data Reduced (XDR) or XML Schema definition language (XSD) schemas, use the property to specify the that contains the schemas (the `XmlParserContext` does not need to supply the DocumentType information). - - ]]> - + To be added. is not one of the node types listed in the table below. @@ -363,18 +273,7 @@ Gets the number of attributes on the current node. The number of attributes on the current node. This number includes default attributes. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This property is relevant to `Element`, `DocumentType`, and `XmlDeclaration` nodes only. (Other node types do not have attributes.) - - ]]> - + To be added. @@ -418,18 +317,7 @@ Gets the base URI of the current node. The base URI of the current node. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - A networked XML document is comprised of chunks of data aggregated by using various World Wide Web Consortium (W3C) standard inclusion mechanisms and therefore contains nodes that come from different places. document type definition (DTD) entities are an example of this, but this is not limited to DTDs. The base URI tells you where these nodes came from. If there is no base URI for the nodes being returned (for example, they were parsed from an in-memory string), String.Empty is returned. - - ]]> - + To be added. @@ -472,18 +360,7 @@ Gets a value indicating whether the implements the binary content read methods. if the binary content read methods are implemented; otherwise . The class returns . - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - The binary content read methods include the , , , and methods. - - ]]> - + To be added. @@ -527,16 +404,7 @@ Gets a value indicating whether this reader can parse and resolve entities. if the reader can parse and resolve entities; otherwise, . always returns . - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. @@ -579,20 +447,7 @@ Changes the to Closed. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This method also releases any resources held while reading. If this reader was constructed by using an , this method also calls `Close` on the underlying reader. If this reader was constructed by using a stream, this method also calls `Close` on the underlying stream. - - If `Close` has already been called, no action is performed. - - ]]> - + To be added. @@ -635,16 +490,7 @@ Gets the depth of the current node in the XML document. The depth of the current node in the XML document. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. @@ -695,20 +541,7 @@ 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. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - When any external reference is read (such as expanding an entity in a document type definition (DTD) file or reading a schema file) the encoding property is set to the encoding value of the external reference. If encoding is not specified in the external reference, and there is no byte-order mark, this defaults to UTF-8. - - All the encoding standards that the underlying operating system supports are supported. - - ]]> - + To be added. @@ -751,41 +584,7 @@ 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. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This property can be changed and takes effect after the next call. - - When `EntityHandling` is set to `ExpandCharEntities`, attribute values are only partially normalized. The reader normalizes each individual text node independently from the content of adjacent entity reference nodes. - - To illustrate the difference between the entity handling modes consider the following XML: - -```xml -]> - A # -``` - - When `EntityHandling` is set to `ExpandEntities` the "doc" element node contains one text node with the expanded entity text: - -| Depth | NodeType | Name | Value | -|-------|----------|------|-------| -| 1 | Text | | A 123 | - - When `EntityHandling` is set to `ExpandCharEntities`, and is set to Significant or All, the "doc" element expands the character entity and returns the general entity as a node: - -| Depth | NodeType | Name | Value | -|-------|-----------------------|------|-------| -| 1 | Text | | A | -| 1 | EntityReference | num | | -| 1 | SignificantWhitespace | | | - - ]]> - + To be added. Invalid value was specified. @@ -830,16 +629,7 @@ 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, . - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. @@ -896,17 +686,7 @@ The index of the attribute. The index is zero-based. (The first attribute has index 0.) Gets the value of the attribute with the specified index. The value of the specified attribute. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. The parameter is less than 0 or greater than or equal to . @@ -961,20 +741,7 @@ The qualified name of the attribute. Gets the value of the attribute with the specified name. The value of the specified attribute. If the attribute is not found, is returned. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This method does not move the reader. - - If the reader is positioned on a `DocumentType` node, this method can be used to get the PUBLIC and SYSTEM literals, for example, `reader.GetAttribute("PUBLIC")` - - ]]> - + To be added. @@ -1031,38 +798,7 @@ The namespace URI of the attribute. Gets the value of the attribute with the specified local name and namespace Uniform Resource Identifier (URI). The value of the specified attribute. If the attribute is not found, is returned. This method does not move the reader. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - The following XML contains an attribute in a specific namespace: - -```xml - -``` - - You can look up the `dt:type` attribute by using one argument (prefix and local name) or two arguments (local name and namespace URI): - -```csharp -String dt = reader.GetAttribute("dt:type"); -String dt2 = reader.GetAttribute("type","urn:datatypes"); -``` - - To look up the `xmlns:dt` attribute, use one of the following arguments: - -```csharp -String dt3 = reader.GetAttribute("xmlns:dt"); -String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); -``` - - You can also get this information by using the property. - - ]]> - + To be added. @@ -1109,16 +845,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Gets a value indicating whether the class can return line information. if the class can return line information; otherwise, . - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. @@ -1162,30 +889,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); 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, . - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - The following table lists node types that have a value to return. - -|Node Type|Value| -|---------------|-----------| -|`Attribute`|The value of the attribute.| -|`CDATA`|The content of the CDATA section.| -|`Comment`|The content of the comment.| -|`DocumentType`|The internal subset.| -|`ProcessingInstruction`|The entire content, excluding the target.| -|`SignificantWhitespace`|The white space between markup in a mixed content model.| -|`Text`|The content of the text node.| -|`Whitespace`|The white space between markup.| -|`XmlDeclaration`|The content of the declaration.| - - ]]> - + To be added. @@ -1229,17 +933,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); 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. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. @@ -1283,26 +977,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); 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, . - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This property enables you to determine the difference between the following: - - `` (`IsEmptyElement` is `true`). - - `` (`IsEmptyElement` is `false`, although element content is empty). - - A corresponding `EndElement` node is not generated for empty elements. - - If default content has been added to an element due to schema validation, `IsEmptyElement` still returns `true`. It has no bearing on whether or not the element has a default value. In other words, `IsEmptyElement` simply reports whether or not the element in the source document had an end element tag. - - ]]> - + To be added. @@ -1347,18 +1022,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Gets the current line number. The current line number. The starting value for this property is 1. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This property is most commonly used for error reporting, but can be called at any time. The starting value for this property is 1. Combined with , a value of 1,1 indicates the start of the document. - - ]]> - + To be added. @@ -1403,30 +1067,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Gets the current line position. The current line position. The starting value for this property is 1. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This property is most commonly used for error reporting, but can be called at any time. The starting value for this property is `1`. - - The position indicated is the first character of text in the markup. - -```xml - - abc - -``` - - On the first line of the preceding XML text, a `LinePosition` of `2` corresponds to the character `r`; on the second line, a `LinePosition` of `5` corresponds to the character `t`; and on the third line, a `LinePosition` of `3` corresponds to the character `r`. - - Combined with , a value of `1,1` indicates the start of the document. - - ]]> - + To be added. @@ -1471,16 +1112,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); 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. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. @@ -1534,26 +1166,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); The prefix whose namespace Uniform Resource Identifier (URI) you want to resolve. To match the default namespace, pass an empty string. Resolves a namespace prefix in the current element's scope. The namespace URI to which the prefix maps or if no matching prefix is found. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - In the following XML string, if the reader is positioned on the `href` attribute, the prefix `a` is resolved by calling `reader.LookupNamespace("a", true)`. The returned string is `urn:456`. - -```xml - - - - - -``` - - ]]> - + To be added. @@ -1609,16 +1222,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); The index of the attribute. Moves to the attribute with the specified index. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. The parameter is less than 0 or greater than or equal to . @@ -1667,18 +1271,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Moves to the attribute with the specified name. if the attribute is found; otherwise, . If , the position of the reader does not change. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - After calling this method, the , , and properties reflect the properties of that attribute. - - ]]> - + To be added. @@ -1736,18 +1329,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Moves to the attribute with the specified local name and namespace Uniform Resource Identifier (URI). if the attribute is found; otherwise, . If , the position of the reader does not change. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - After calling this method, the , , and properties reflect the properties of that attribute. - - ]]> - + To be added. @@ -1792,18 +1374,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Moves to the element that contains the current attribute node. 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). - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - Use this method to return to an element after navigating through its attributes. This method moves the reader to one of the following node types: `Element`, `DocumentType`, or `XmlDeclaration`. - - ]]> - + To be added. @@ -1848,16 +1419,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Moves to the first attribute. if an attribute exists (the reader moves to the first attribute); otherwise, (the position of the reader does not change). - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. @@ -1902,18 +1464,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Moves to the next attribute. if there is a next attribute; if there are no more attributes. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - If the current node is an element node, this method is equivalent to . If `MoveToNextAttribute` returns `true`, the reader moves to the next attribute; otherwise, the position of the reader does not change. - - ]]> - + To be added. @@ -1976,16 +1527,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); The literal string . - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. @@ -2029,16 +1571,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Gets or sets a value indicating whether to do namespace support. to do namespace support; otherwise, . The default is . - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. @@ -2081,17 +1614,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Gets the namespace Uniform Resource Identifier (URI) (as defined in the World Wide Web Consortium (W3C) Namespace specification) of the node on which the reader is positioned. The namespace URI of the current node; otherwise an empty string. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. @@ -2135,18 +1658,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Gets the associated with this implementation. that enables you to get the atomized version of a string within the node. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - All node and attribute names returned from are atomized by using the `NameTable`. When the same name is returned multiple times (for example, `Customer`), the same `String` object will be returned for that name. This makes it possible for you to write efficient code that does object comparisons on these strings instead of expensive string comparisons. - - ]]> - + To be added. @@ -2190,18 +1702,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Gets the type of the current node. One of the values representing the type of the current node. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This property never returns the following `XmlNodeType` types: `Document`, `DocumentFragment`, `Entity`, or `Notation`. - - ]]> - + To be added. @@ -2244,16 +1745,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Gets the namespace prefix associated with the current node. The namespace prefix associated with the current node. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. @@ -2296,17 +1788,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); 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. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. @@ -2351,18 +1833,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Reads the next node from the stream. if the next node was read successfully; if there are no more nodes to read. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - When a reader is first created and initialized, there is no information available. You must call `Read` to read the first node. - - ]]> - + To be added. @@ -2411,18 +1882,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); 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. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - Use this method after calling to read through the text or entity reference nodes that make up the attribute value. The of the attribute value nodes is one plus the depth of the attribute node. The `Depth` increments and decrements by one when you step into and out of general entity references. - - ]]> - + To be added. @@ -2472,29 +1932,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. Reads the content and returns the Base64 decoded binary bytes. The number of bytes written to the buffer. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This method streams the content, decodes the Base64 content, and returns the decoded binary bytes (for example, an inline Base64 encoded GIF image) into the buffer. This method can be called successively to read large streams of embedded text. For more information, see RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies". You can obtain RFCs from the [Request for Comments Web site](https://www.rfc-editor.org). - -> [!NOTE] -> You should not access any of the reader properties between calls to the method until the method returns the value 0. - - This method has the following behavior: - -- returns the value 0 when it has reached the end of the byte stream it was operating on. The reader is positioned on the first non-content node. - -- If you ask for fewer, or the exact number, of bytes than are left in the stream, the reader remains in its current position. - -- is not supported on the following XML node types: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, and DocumentFragment. - - ]]> - + To be added. The value is . is not supported on the current node. @@ -2550,29 +1988,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. Reads the content and returns the BinHex decoded binary bytes. The number of bytes written to the buffer. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This method streams the content, decodes the BinHex content, and returns the decoded binary bytes (for example, an inline BinHex encoded GIF image) into the buffer. This method can be called successively to read large streams of embedded text. - -> [!NOTE] -> You should not access any of the reader properties between calls to the method until the method returns the value 0. - - This method has the following behavior: - -- returns the value 0 when it has reached the end of the byte stream it was operating on. The reader is positioned on the first non-content node. - -- If you ask for fewer, or the exact number, of bytes than are left in the stream, the reader remains in its current position. - -- is not supported on the following XML node types: Element, XmlDeclaration, None, Document, DocumentType, Notation, Entity, and DocumentFragment. - - ]]> - + To be added. The value is . is not supported on the current node. @@ -2629,26 +2045,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. Reads the element and decodes the Base64 content. The number of bytes written to the buffer. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This method reads the element content, decodes it using Base64 encoding, and returns the decoded binary bytes (for example, an inline Base64 encoded GIF image) into the buffer. For more information, see RFC 1521, "MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms for Specifying and Describing the Format of Internet Message Bodies". You can obtain RFCs from the [Request for Comments Web site](https://www.rfc-editor.org). - - This method can read only simple-content elements. The element can contain text, white space, significant white space, CDATA sections, comments, and processing instructions. It can also contain entity references, which are automatically expanded. The element cannot have child elements. - - This method is very similar to the method except that it can be called only on element node types. - - If the `count` value is higher than the number of bytes in the document, or if it is equal to the number of bytes in the document, the reads all the remaining bytes in the document and returns the number of bytes read. The next method call returns a zero and moves the reader to the node following the . - - If you call before all of the element content is consumed, the reader may behave as if the first content was consumed and then the method was called. This means that the reader will read all the text until the end element is encountered. It will then read the end tag node, read the next node, and then position itself on the next subsequent node. - - ]]> - + To be added. 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. @@ -2705,26 +2102,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); The maximum number of bytes to copy into the buffer. The actual number of bytes copied is returned from this method. Reads the element and decodes the BinHex content. The number of bytes written to the buffer. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This method reads the element content, decodes it using BinHex encoding, and returns the decoded binary bytes (for example, an inline BinHex encoded GIF image) into the buffer. - - This method can read only simple-content elements. The element can contain text, white space, significant white space, CDATA sections, comments, and processing instructions. It can also contain entity references, which are automatically expanded. The element cannot have child elements. - - This method is very similar to the method except that it can be called only on element node types. - - If the `count` value is higher than the number of bytes in the document, or if it is equal to the number of bytes in the document, the reads all the remaining bytes in the document and returns the number of bytes read. The next method call returns a zero and moves the reader to the node following the . - - If you call before all of the element content is consumed, the reader may behave as if the first content was consumed and then the method was called. This means that the reader will read all the text until the end element is encountered. It will then read the end tag node, read the next node, and then position itself on the next subsequent node. - - ]]> - + To be added. 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. @@ -2774,20 +2152,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Gets the used to construct this . The specified in the constructor. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This property allows the user to access properties specific to the supplied reader. It returns a typed `XmlReader`. The user should query for the type before casting. - - Changing the state of the returned reader (for example, calling one of the read methods) can lead to unpredictable results. - - ]]> - + To be added. @@ -2830,16 +2195,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); Gets the state of the reader. One of the values. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. @@ -2883,29 +2239,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); 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. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - If positioned on an element, `ReadString` concatenates all text, significant white space, white space, and CDATA section node types together and returns the concatenated data as the element content. The reader stops when any markup is encountered, including comments and processing instructions. This could occur in a mixed content model, or when an element end tag is read. - - If positioned on a text node, `ReadString` performs the same concatenation from the text node to the element end tag. If the reader is positioned on an attribute text node, `ReadString` has the same functionality as if the reader were position on the element start tag. It returns all the concatenated element text nodes. - - The property determines how `ReadString` works as follows: - -|Value|Description| -|-----------|-----------------| -|ExpandEntities|Returns expanded character and general entities. This is the default.| -|ExpandCharEntities|Returns the text content up to but not including a general entity reference. This means a general entity causes ReadString to stop. You must call `Read` to step over the entity reference.| - - ]]> - + To be added. @@ -2950,26 +2284,7 @@ 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. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - For example, if the schema type is defined as `xsd:int`, the runtime type `int32` is returned for the object. This can be tested using the method and cast accordingly. The method always returns a type that is derived from the class. It never returns the type. - - If the reader is positioned on an attribute, this method returns the runtime typed object, but does not change the position of the reader. If the reader is positioned on an element, `ReadTypedValue` reads any CDATA, text, white space, significant white space, and comment nodes, returns the runtime typed object and positions the reader on the end tag. Any types that do not have a direct mapping, for example `NMTOKENS`, are returned as strings. - -> [!NOTE] -> If has been set to ValidationType.None, data type information is not provided from either schemas or document type definitions (DTDs). - -> [!CAUTION] -> After calling , `ReadTypedValue` will return `null`. - - ]]> - + To be added. @@ -3012,21 +2327,7 @@ The text node can be either an element or an attribute text node. Resolves the entity reference for nodes. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - If the reader is positioned on an `EntityReference` node (`XmlNodeType.EntityReference`), if is called after calling this method, the entity replacement text is parsed. After the entity replacement text is finished, an `EndEntity` node is returned to close the entity reference scope. - -> [!NOTE] -> After calling this method, if the entity is part of an attribute value, you must call to step into the entity. - - ]]> - + To be added. The reader is not positioned on an node. @@ -3071,25 +2372,7 @@ The text node can be either an element or an attribute text node. Gets a to use for validation. The to use for validation. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - The `XmlSchemaCollection` holds pre-loaded XML-Data Reduced (XDR) and XML Schema definition language (XSD) schemas. This property gives the reader access to the cache of schemas and allows it to validate without having to re-load schemas every time. The reader does not add anything to the `XmlSchemaCollection`. - - If the `XmlSchemaCollection` includes an XML schema (XSD) that contains `include` or `import` elements that reference other namespaces, the schemas for these other namespaces are loaded for validation purposes only. Unless these schemas were explicitly added to the schema collection, they will not be accessible using any of the collection methods or properties. For example, if the collection contains the schema file `a.xsd`, which contains a reference to the schema file `b.xsd`, you must add `b.xsd` to the schema collection before you can access it using any of the collection methods or properties. - - When the `XmlSchemaCollection` is accessed using the `Schemas` property, the method uses the specified by the property. - -> [!NOTE] -> The schemas must be added to the `XmlSchemaCollection` before the first `Read` call. - - ]]> - + To be added. @@ -3140,35 +2423,73 @@ The text node can be either an element or an attribute text node. Gets a schema type object. , , 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. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - The user needs to test for the returned type. - - If XML Schema validation is being performed, the `XmlSchemaType` or `XmlSchemaDatatype` corresponds to the current element being read. If document type definition (DTD validation) is being performed, this property returns `null`. - - `XmlSchemaDatatype` is returned if the current element, or attribute, is a simple type that can specify special validation constraints on the simple types, like min and max. - - `XmlSchemaSimpleType` is returned if the current element, or attribute, is a user defined simpleType. - - `XmlSchemaComplexType` is returned if the current element is a user defined complexType. This type cannot be returned by attributes. - -> [!NOTE] -> If has been set to ValidationType.None, no data type information is provided from either schemas or DTDs. - -> [!CAUTION] -> After calling , SchemaType will return Null. - - ]]> - + To be added. +<<<<<<< HEAD + + + + + + + + Property + + System.Xml + 2.0.0.0 + + + System.Xml.ReaderWriter + + + netstandard + + + System.Xml.XmlReaderSettings + + + Gets the object that was used to create this instance. + + because objects are not instantiated using the class and the method. + To be added. + + + + + + + + + + Method + + M:System.Xml.IXmlLineInfo.HasLineInfo + + + System.Xml + 1.0.5000.0 + + + System.Xml.ReaderWriter + + + netstandard + + + System.Boolean + + + + Gets a value indicating whether the class can return line information. + + if and can be provided; otherwise, . + To be added. + + +======= +>>>>>>> a616b87eb03a89aa522fa6635e20af8ab7093d32 @@ -3372,25 +2693,7 @@ The text node can be either an element or an attribute text node. 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. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - These events occur during and only if a of DTD, XDR, Schema, or Auto is specified. - - If no event handler is provided, an is thrown on the first validation error (Severity is equal to XmlSeverityType.Error). - -> [!NOTE] -> If an element reports a validation error, the rest of the content model for that element is not validated, however, its children are validated. The reader only reports the first error for a given element. - - The callback handler can use the property to guarantee that an XML instance document is validated against a schema. The `Severity` property allows you to distinguish between validation errors (Severity is equal to XmlSeverityType.Error) that indicate a fatal error, and validation warnings (Severity is equal to XmlSeverityType.Warning) that indicate that no schema information is available. - - ]]> - + To be added. @@ -3434,20 +2737,7 @@ The text node can be either an element or an attribute text node. Gets or sets a value indicating the type of validation to perform. One of the values. If this property is not set, it defaults to ValidationType.Auto. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This property must be set before the first call to . Setting this property to ValidationType.None creates a non-validating reader. - - If external document type definitions (DTDs) or schemas are needed for validation, the is used. - - ]]> - + To be added. Setting the property after a Read has been called. @@ -3515,16 +2805,7 @@ The text node can be either an element or an attribute text node. The content of the declaration. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. @@ -3567,26 +2848,7 @@ The text node can be either an element or an attribute text node. Gets the current scope. The current scope. - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - This property represents the xml:lang scope within which the current node resides. For example, here is an XML fragment with `xml:lang` set to U.S. English in the root element: - -```xml - -Fred - -``` - - When the reader is positioned on the `name` element, you can use this property to find that it is in the scope of a U.S. English `xml:lang` attribute. - - ]]> - + To be added. @@ -3628,31 +2890,8 @@ The text node can be either an element or an attribute text node. 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 . - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - The `XmlResolver` is used to load any DTDs, entities, or schemas needed to complete the validation process. - - This property can be set at any time and takes affect after the next call. If this property is set to `null`, the reader assumes the user is not interested in resolving external references. In this case, the reader only validates against internal resources, if the resource is present. - - In version 1.1 of .NET Framework , if this property is not set, the trust level of the application determines the default behavior. - - `Fully trusted code:` The reader uses a default with no user credentials. If authentication is required to access a network resource, use the `XmlResolver` property to specify an `XmlResolver` with the necessary credentials. - - `Semi-trusted code:` The `XmlResolver` property is set to `null`. External resources are not resolved. - - When validating using schemas, you can avoid the expensive load process by providing an using the property. - - ]]> - + The to use. If set to , external resources are not resolved. + To be added. @@ -3699,16 +2938,7 @@ The text node can be either an element or an attribute text node. Gets the current scope. One of the values. If no scope exists, this property defaults to . - - [!NOTE] -> The class is obsolete in .NET Framework 2.0. You can create a validating instance by using the class and the method. For more information, see the Remarks section of the reference page. - - ]]> - + To be added. diff --git a/xml/System.Xml/XmlWriter.xml b/xml/System.Xml/XmlWriter.xml index a2a6eb7f50f..a5bc5ca0c13 100644 --- a/xml/System.Xml/XmlWriter.xml +++ b/xml/System.Xml/XmlWriter.xml @@ -240,7 +240,7 @@ An method was called before a previous asy ||`true`| > [!NOTE] -> Although the .NET Framework includes the class, which is a concrete implementation of the class, we recommend that you create instances by using the method. +> Although .NET provides the class, which is a concrete implementation of the class, we recommend that you create instances by using the method. ]]> @@ -6926,9 +6926,7 @@ An asynchronous method was called without - 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. Writes the object value. Date: Sat, 23 May 2026 19:51:27 -0700 Subject: [PATCH 2/4] clean up old merge conflicts --- xml/System.Xml.Xsl/XslTransform.xml | 156 ------------------------- xml/System.Xml/XmlReaderSettings.xml | 42 ------- xml/System.Xml/XmlValidatingReader.xml | 63 ---------- 3 files changed, 261 deletions(-) diff --git a/xml/System.Xml.Xsl/XslTransform.xml b/xml/System.Xml.Xsl/XslTransform.xml index 4758606b08b..ceae4f4f071 100644 --- a/xml/System.Xml.Xsl/XslTransform.xml +++ b/xml/System.Xml.Xsl/XslTransform.xml @@ -562,162 +562,6 @@ -<<<<<<< HEAD - - - - - - - - Method - - System.Xml - 1.0.5000.0 - 2.0.0.0 - 4.0.0.0 - - - System.Xml.ReaderWriter - - - netstandard - - - System.Void - - - - - - - - An object containing the style sheet to load. - 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 set on the assembly generated for the script block in the XSLT style sheet. - - If this is , script blocks are not processed, the XSLT document() function is not supported, and privileged extension objects are disallowed. - - The caller must have permission in order to supply evidence for the script assembly. Semi-trusted callers can set this parameter to . - Loads the XSLT style sheet contained in the . This method allows you to limit the permissions of the style sheet by specifying evidence. - To be added. - The current node does not conform to a valid style sheet. - The referenced style sheet requires functionality that is not allowed by the evidence provided. - - The caller tries to supply evidence and does not have permission. - - - - - - - - - - - - - - - Method - - System.Xml - 1.0.5000.0 - 2.0.0.0 - 4.0.0.0 - - - System.Xml.ReaderWriter - - - netstandard - - - System.Void - - - - - - - - An object implementing the interface. In .NET, 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 set on the assembly generated for the script block in the XSLT style sheet. - - If this is , script blocks are not processed, the XSLT document() function is not supported, and privileged extension objects are disallowed. - - The caller must have permission in order to supply evidence for the script assembly. Semi-trusted callers can set this parameter to . - Loads the XSLT style sheet contained in the . This method allows you to limit the permissions of the style sheet by specifying evidence. - To be added. - The loaded resource is not a valid style sheet. - The referenced style sheet requires functionality that is not allowed by the evidence provided. - - The caller tries to supply evidence and does not have permission. - - - - - - - - - - - - - - - Method - - System.Xml - 1.0.5000.0 - 2.0.0.0 - 4.0.0.0 - - - System.Xml.ReaderWriter - - - netstandard - - - System.Void - - - - - - - - An object containing the style sheet to load. - 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 set on the assembly generated for the script block in the XSLT style sheet. - - If this is , script blocks are not processed, the XSLT document() function is not supported, and privileged extension objects are disallowed. - - The caller must have permission in order to supply evidence for the script assembly. Semi-trusted callers can set this parameter to . - Loads the XSLT style sheet contained in the . This method allows you to limit the permissions of the style sheet by specifying evidence. - To be added. - The current node does not conform to a valid style sheet. - The referenced style sheet requires functionality that is not allowed by the evidence provided. - - The caller tries to supply evidence and does not have permission. - - - - - - - -======= ->>>>>>> a616b87eb03a89aa522fa6635e20af8ab7093d32 System.Xml diff --git a/xml/System.Xml/XmlReaderSettings.xml b/xml/System.Xml/XmlReaderSettings.xml index 8db4746cecd..805d0326ec4 100644 --- a/xml/System.Xml/XmlReaderSettings.xml +++ b/xml/System.Xml/XmlReaderSettings.xml @@ -154,48 +154,6 @@ The following example creates an that uses an -<<<<<<< HEAD - - - - - - - - Constructor - - System.Xml - 4.0.0.0 - - - System.Xml.ReaderWriter - - - netstandard - - - - [System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)] - [<System.ComponentModel.EditorBrowsable(System.ComponentModel.EditorBrowsableState.Never)>] - - - [System.Obsolete("This API supports the .NET infrastructure and is not intended to be used directly from your code.", true)] - [<System.Obsolete("This API supports the .NET infrastructure and is not intended to be used directly from your code.", true)>] - - - - - - - The XML resolver. - Initializes a new instance of the class. - To be added. - - - - -======= ->>>>>>> a616b87eb03a89aa522fa6635e20af8ab7093d32 diff --git a/xml/System.Xml/XmlValidatingReader.xml b/xml/System.Xml/XmlValidatingReader.xml index de78f47e9bf..24ff9f5d6d1 100644 --- a/xml/System.Xml/XmlValidatingReader.xml +++ b/xml/System.Xml/XmlValidatingReader.xml @@ -2427,69 +2427,6 @@ -<<<<<<< HEAD - - - - - - - - Property - - System.Xml - 2.0.0.0 - - - System.Xml.ReaderWriter - - - netstandard - - - System.Xml.XmlReaderSettings - - - Gets the object that was used to create this instance. - - because objects are not instantiated using the class and the method. - To be added. - - - - - - - - - - Method - - M:System.Xml.IXmlLineInfo.HasLineInfo - - - System.Xml - 1.0.5000.0 - - - System.Xml.ReaderWriter - - - netstandard - - - System.Boolean - - - - Gets a value indicating whether the class can return line information. - - if and can be provided; otherwise, . - To be added. - - -======= ->>>>>>> a616b87eb03a89aa522fa6635e20af8ab7093d32 From 83aaa2fae7aa67ee619e79486460cf01ceb8d114 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Wed, 27 May 2026 15:27:53 -0700 Subject: [PATCH 3/4] Apply suggestions from code review Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> --- xml/System.Xaml/XamlObjectWriter.xml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/xml/System.Xaml/XamlObjectWriter.xml b/xml/System.Xaml/XamlObjectWriter.xml index 30f006b957c..c655e473cd0 100644 --- a/xml/System.Xaml/XamlObjectWriter.xml +++ b/xml/System.Xaml/XamlObjectWriter.xml @@ -461,7 +461,7 @@ From f5722f094f095ca49c1f278b43ad0eb0c6a2b888 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Wed, 27 May 2026 15:32:00 -0700 Subject: [PATCH 4/4] respond to feedback --- xml/System.Xml/XmlReaderSettings.xml | 4 +--- xml/System.Xml/XmlWriter.xml | 2 +- 2 files changed, 2 insertions(+), 4 deletions(-) diff --git a/xml/System.Xml/XmlReaderSettings.xml b/xml/System.Xml/XmlReaderSettings.xml index 805d0326ec4..3969af9ea8e 100644 --- a/xml/System.Xml/XmlReaderSettings.xml +++ b/xml/System.Xml/XmlReaderSettings.xml @@ -1525,7 +1525,7 @@ The output is as follows: Sets the used to access external documents. - An used to access external documents. If set to , an is thrown when the tries to access an external resource. The default is a new with no credentials. This setting has a default value of . + An used to access external documents. If set to , an is thrown when the tries to access an external resource. The default value is . > Schemas added during validation add new types and can change the validation outcome of the document being validated. As a result, external schemas should only be resolved from trusted sources. - - ## Examples The following example creates an that uses an with default credentials. diff --git a/xml/System.Xml/XmlWriter.xml b/xml/System.Xml/XmlWriter.xml index a5bc5ca0c13..6b636262345 100644 --- a/xml/System.Xml/XmlWriter.xml +++ b/xml/System.Xml/XmlWriter.xml @@ -6926,7 +6926,7 @@ An asynchronous method was called without - The object value to write. + The object value to write. This method accepts values. Writes the object value.