diff --git a/xml/System.Collections.Generic/List`1.xml b/xml/System.Collections.Generic/List`1.xml index 6cfa4f009ac..903f638ada3 100644 --- a/xml/System.Collections.Generic/List`1.xml +++ b/xml/System.Collections.Generic/List`1.xml @@ -1512,7 +1512,7 @@ :::code language="csharp" source="~/samples/snippets/csharp/VS_Snippets_CLR_System/system.collections.generic.list.containsexists/cs/program.cs" interactive="try-dotnet" id="Snippet1"::: :::code language="vb" source="~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.collections.generic.list.containsexists/vb/module1.vb" id="Snippet1"::: - The following example demonstrates the find methods for the class. The example for the class contains `book` objects, of class `Book`, using the data from the [Sample XML File: Books (LINQ to XML)](https://msdn.microsoft.com/library/94252daf-6097-4625-afc2-0eb778958d4f). The `FillList` method in the example uses [LINQ to XML](https://msdn.microsoft.com/library/f0fe21e9-ee43-4a55-b91a-0800e5782c13) to parse the values from the XML to property values of the `book` objects. + The following example demonstrates the find methods for the class. The example for the class contains `book` objects, of class `Book`, using the data from the [Sample XML File: Books (LINQ to XML)](/dotnet/standard/linq/sample-xml-file-books). The `FillList` method in the example uses [LINQ to XML](/dotnet/standard/linq/linq-xml-overview) to parse the values from the XML to property values of the `book` objects. The following table describes the examples provided for the find methods. @@ -1591,7 +1591,7 @@ This method performs a linear search; therefore, this method is an O(*n*) operation, where *n* is . ## Examples - The following example demonstrates the find methods for the class. The example for the class contains `book` objects, of class `Book`, using the data from the [Sample XML File: Books (LINQ to XML)](https://msdn.microsoft.com/library/94252daf-6097-4625-afc2-0eb778958d4f). The `FillList` method in the example uses [LINQ to XML](https://msdn.microsoft.com/library/f0fe21e9-ee43-4a55-b91a-0800e5782c13) to parse the values from the XML to property values of the `book` objects. + The following example demonstrates the find methods for the class. The example for the class contains `book` objects, of class `Book`, using the data from the [Sample XML File: Books (LINQ to XML)](/dotnet/standard/linq/sample-xml-file-books). The `FillList` method in the example uses [LINQ to XML](/dotnet/standard/linq/linq-xml-overview) to parse the values from the XML to property values of the `book` objects. The following table describes the examples provided for the find methods. @@ -1963,7 +1963,7 @@ Public Function StartsWith(e As Employee) As Boolean This method performs a linear search; therefore, this method is an O(*n*) operation, where *n* is . ## Examples - The following example demonstrates the find methods for the class. The example for the class contains `book` objects, of class `Book`, using the data from the [Sample XML File: Books (LINQ to XML)](https://msdn.microsoft.com/library/94252daf-6097-4625-afc2-0eb778958d4f). The `FillList` method in the example uses [LINQ to XML](https://msdn.microsoft.com/library/f0fe21e9-ee43-4a55-b91a-0800e5782c13) to parse the values from the XML to property values of the `book` objects. + The following example demonstrates the find methods for the class. The example for the class contains `book` objects, of class `Book`, using the data from the [Sample XML File: Books (LINQ to XML)](/dotnet/standard/linq/sample-xml-file-books). The `FillList` method in the example uses [LINQ to XML](/dotnet/standard/linq/linq-xml-overview) to parse the values from the XML to property values of the `book` objects. The following table describes the examples provided for the find methods. @@ -2055,7 +2055,7 @@ Public Function StartsWith(e As Employee) As Boolean This method performs a linear search; therefore, this method is an O(*n*) operation, where *n* is . ## Examples - The following example demonstrates the find methods for the class. The example for the class contains `book` objects, of class `Book`, using the data from the [Sample XML File: Books (LINQ to XML)](https://msdn.microsoft.com/library/94252daf-6097-4625-afc2-0eb778958d4f). The `FillList` method in the example uses [LINQ to XML](https://msdn.microsoft.com/library/f0fe21e9-ee43-4a55-b91a-0800e5782c13) to parse the values from the XML to property values of the `book` objects. + The following example demonstrates the find methods for the class. The example for the class contains `book` objects, of class `Book`, using the data from the [Sample XML File: Books (LINQ to XML)](/dotnet/standard/linq/sample-xml-file-books). The `FillList` method in the example uses [LINQ to XML](/dotnet/standard/linq/linq-xml-overview) to parse the values from the XML to property values of the `book` objects. The following table describes the examples provided for the find methods. @@ -2207,7 +2207,7 @@ Public Function StartsWith(e As Employee) As Boolean This method performs a linear search; therefore, this method is an O(*n*) operation, where *n* is `count`. ## Examples - The following example demonstrates the find methods for the class. The example for the class contains `book` objects, of class `Book`, using the data from the [Sample XML File: Books (LINQ to XML)](https://msdn.microsoft.com/library/94252daf-6097-4625-afc2-0eb778958d4f). The `FillList` method in the example uses [LINQ to XML](https://msdn.microsoft.com/library/f0fe21e9-ee43-4a55-b91a-0800e5782c13) to parse the values from the XML to property values of the `book` objects. + The following example demonstrates the find methods for the class. The example for the class contains `book` objects, of class `Book`, using the data from the [Sample XML File: Books (LINQ to XML)](/dotnet/standard/linq/sample-xml-file-books). The `FillList` method in the example uses [LINQ to XML](/dotnet/standard/linq/linq-xml-overview) to parse the values from the XML to property values of the `book` objects. The following table describes the examples provided for the find methods. diff --git a/xml/System.Xml.Linq/Extensions.xml b/xml/System.Xml.Linq/Extensions.xml index b39c36a32d7..49ee3ea7e98 100644 --- a/xml/System.Xml.Linq/Extensions.xml +++ b/xml/System.Xml.Linq/Extensions.xml @@ -49,10 +49,10 @@ ]]> - LINQ to XML - LINQ to XML Axes - Removing Elements, Attributes, and Nodes from an XML Tree - Extension Methods (C# Programming Guide) + LINQ to XML overview + LINQ to XML axes overview + Remove elements, attributes, and nodes from an XML tree + Extension Methods (C# Programming Guide) @@ -228,7 +228,7 @@ GrandChild2 Child2 ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -333,7 +333,7 @@ Ancestors - LINQ to XML + LINQ to XML overview @@ -483,7 +483,7 @@ Ancestors Child1 ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -585,7 +585,7 @@ Ancestors - LINQ to XML + LINQ to XML overview @@ -611,7 +611,7 @@ Ancestors - LINQ to XML + LINQ to XML overview @@ -757,7 +757,7 @@ GrandChild2 Child2 ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -865,7 +865,7 @@ Ancestors and Self - LINQ to XML + LINQ to XML overview @@ -1007,7 +1007,7 @@ Ancestors and Self GreatGrandChild1 ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -1109,7 +1109,7 @@ Ancestors and Self - LINQ to XML + LINQ to XML overview @@ -1132,7 +1132,7 @@ Ancestors and Self - LINQ to XML + LINQ to XML overview @@ -1251,7 +1251,7 @@ Att1="content5" Att2="content6" ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). Note that the namespace attribute is included in the returned collection. + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). Note that the namespace attribute is included in the returned collection. ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -1325,7 +1325,7 @@ aw:Att2="content6" - LINQ to XML + LINQ to XML overview @@ -1431,7 +1431,7 @@ Att1="content5" - LINQ to XML + LINQ to XML overview @@ -1570,7 +1570,7 @@ Text: Text Text: ddd ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -1663,7 +1663,7 @@ Text: ddd - LINQ to XML + LINQ to XML overview @@ -1722,7 +1722,7 @@ Text: ddd - LINQ to XML + LINQ to XML overview @@ -1870,7 +1870,7 @@ Next This is a second sentence. ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -1948,7 +1948,7 @@ End Module - LINQ to XML + LINQ to XML overview @@ -2003,7 +2003,7 @@ End Module - LINQ to XML + LINQ to XML overview @@ -2174,7 +2174,7 @@ This is some text where all of the text nodes must be concatenated. This is a se - LINQ to XML + LINQ to XML overview @@ -2232,7 +2232,7 @@ This is some text where all of the text nodes must be concatenated. This is a se - LINQ to XML + LINQ to XML overview @@ -2292,7 +2292,7 @@ This is some text where all of the text nodes must be concatenated. This is a se - LINQ to XML + LINQ to XML overview @@ -2439,7 +2439,7 @@ Next 6 ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -2518,7 +2518,7 @@ End Module - LINQ to XML + LINQ to XML overview @@ -2641,7 +2641,7 @@ Next 4 ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -2716,7 +2716,7 @@ End Module - LINQ to XML + LINQ to XML overview @@ -2849,7 +2849,7 @@ Next ]]> - LINQ to XML + LINQ to XML overview @@ -2977,7 +2977,7 @@ Text: ddd - LINQ to XML + LINQ to XML overview @@ -3021,7 +3021,7 @@ Text: ddd before disconnecting them from their parents. This is required to avoid issues with mixed imperative/declarative code. For more information, see [Mixed Declarative Code/Imperative Code Bugs (LINQ to XML)](https://msdn.microsoft.com/library/d9a5c404-2b0e-46cd-a358-0e78773b3094). + This method uses snapshot semantics - that is, it copies the attributes in the source collection to a before disconnecting them from their parents. This is required to avoid issues with mixed imperative/declarative code. For more information, see [Mixed Declarative Code/Imperative Code Bugs (LINQ to XML)](/dotnet/standard/linq/mixed-declarative-imperative-code-bugs). @@ -3072,7 +3072,7 @@ Console.WriteLine(root) - LINQ to XML + LINQ to XML overview @@ -3124,7 +3124,7 @@ Console.WriteLine(root) ` before disconnecting them from their parents. This is required to avoid issues with mixed imperative/declarative code. For more information, see [Mixed Declarative Code/Imperative Code Bugs (LINQ to XML)](https://msdn.microsoft.com/library/d9a5c404-2b0e-46cd-a358-0e78773b3094). + This method uses snapshot semantics - that is, it copies the attributes in the source collection to a `List` before disconnecting them from their parents. This is required to avoid issues with mixed imperative/declarative code. For more information, see [Mixed Declarative Code/Imperative Code Bugs (LINQ to XML)](/dotnet/standard/linq/mixed-declarative-imperative-code-bugs). @@ -3185,7 +3185,7 @@ Console.WriteLine(root) - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/LoadOptions.xml b/xml/System.Xml.Linq/LoadOptions.xml index 5ba31fe4378..a18876b34a1 100644 --- a/xml/System.Xml.Linq/LoadOptions.xml +++ b/xml/System.Xml.Linq/LoadOptions.xml @@ -52,7 +52,7 @@ If the underlying does not have base URI or line information, setting the SetBaseUri and the SetLineInfo flags will have no effect. - This type allows you to control how LINQ to XML handles white space when loading or parsing. For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + This type allows you to control how LINQ to XML handles white space when loading or parsing. For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). @@ -153,8 +153,8 @@ Root 1 2 ]]> - LINQ to XML - Programming with Nodes + LINQ to XML overview + Programming with nodes diff --git a/xml/System.Xml.Linq/SaveOptions.xml b/xml/System.Xml.Linq/SaveOptions.xml index 98fac730719..3d1a9b4f6b8 100644 --- a/xml/System.Xml.Linq/SaveOptions.xml +++ b/xml/System.Xml.Linq/SaveOptions.xml @@ -46,7 +46,7 @@ ## Remarks If you disable formatting when serializing, all insignificant white space in the XML tree is serialized as is. If you do not disable formatting, then all insignificant white space in the XML tree is discarded, and the XML is formatted (indented) as it is serialized. - This type allows you to control how LINQ to XML handles white space when serializing. For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + This type allows you to control how LINQ to XML handles white space when serializing. For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). @@ -98,8 +98,8 @@ Console.WriteLine(str) ]]> - LINQ to XML - Programming with Nodes + LINQ to XML overview + Programming with nodes diff --git a/xml/System.Xml.Linq/XAttribute.xml b/xml/System.Xml.Linq/XAttribute.xml index 42c1e5b934b..d40cdb16fb0 100644 --- a/xml/System.Xml.Linq/XAttribute.xml +++ b/xml/System.Xml.Linq/XAttribute.xml @@ -59,15 +59,15 @@ The class derives from . You can add annotations to attributes, and observe events for them. - Some methods can be used from XAML. For more information, see [LINQ to XML Dynamic Properties](https://msdn.microsoft.com/library/0455f47c-4a68-4f2e-a3f8-dd1d85b99012). + Some methods can be used from XAML. For more information, see [LINQ to XML Dynamic Properties](/dotnet/desktop/wpf/data/linq-to-xml-dynamic-properties). ]]> - LINQ to XML - XAttribute Class Overview - LINQ to XML Dynamic Properties + LINQ to XML overview + XAttribute Class Overview + LINQ to XML Dynamic Properties @@ -82,8 +82,8 @@ - LINQ to XML - XAttribute Class Overview + LINQ to XML overview + XAttribute Class Overview @@ -165,8 +165,8 @@ Creating a deep copy created a new attribute from the original. - LINQ to XML - XAttribute Class Overview + LINQ to XML overview + XAttribute Class Overview @@ -226,7 +226,7 @@ XElement root = new XElement(aw + "Root", ); ``` - For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). These same approaches will work for Visual Basic, however XML literals provide a better approach for creating XML trees. @@ -294,8 +294,8 @@ Console.WriteLine(root) - LINQ to XML - XAttribute Class Overview + LINQ to XML overview + XAttribute Class Overview @@ -342,7 +342,7 @@ Console.WriteLine(root) - LINQ to XML + LINQ to XML overview @@ -429,7 +429,7 @@ Next ]]> - LINQ to XML + LINQ to XML overview @@ -543,7 +543,7 @@ Att2=new content - LINQ to XML + LINQ to XML overview @@ -630,7 +630,7 @@ Att4="4" ]]> - LINQ to XML + LINQ to XML overview @@ -704,7 +704,7 @@ Attribute - LINQ to XML + LINQ to XML overview @@ -785,7 +785,7 @@ Console.WriteLine("(bool)BoolValue={0}", bv) The attribute does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -903,7 +903,7 @@ OrderDate=10/6/2006 The attribute does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -993,7 +993,7 @@ dt=10/6/2006 12:30:00 PM -07:00 The attribute does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -1069,7 +1069,7 @@ value=79228162514264337593543950335 The attribute does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -1145,7 +1145,7 @@ value=1.79769313486231E+308 The attribute does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -1221,7 +1221,7 @@ value=3c1cc55b-baff-4b7a-9d17-077af3aa5730 The attribute does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -1297,7 +1297,7 @@ value=2147483647 The attribute does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -1373,7 +1373,7 @@ value=9223372036854775807 The attribute does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -1459,7 +1459,7 @@ Nullable boolean: BoolValue2=False The attribute does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -1543,7 +1543,7 @@ Nullable DateTime: value=10/6/2006 12:30:00 PM The attribute does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -1698,7 +1698,7 @@ Nullable decimal: value=79228162514264337593543950335 The attribute does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -1773,7 +1773,7 @@ Nullable double: value=1.79769313486231E+308 The attribute does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -1848,7 +1848,7 @@ Nullable Guid: value=3c1cc55b-baff-4b7a-9d17-077af3aa5730 The attribute does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -1922,7 +1922,7 @@ Nullable int: value=2147483647 ]]> - LINQ to XML + LINQ to XML overview @@ -1997,7 +1997,7 @@ Nullable long: value=9223372036854775807 The attribute does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -2072,7 +2072,7 @@ Nullable Single: value=3.402823E+38 The attribute does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -2154,7 +2154,7 @@ Nullable TimeSpan: value=01:05:30 The attribute does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -2229,7 +2229,7 @@ Nullable uint: value=4294967295 The attribute does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -2304,7 +2304,7 @@ Nullable ulong: value=9223372036854775807 The attribute does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -2380,7 +2380,7 @@ value=3.402823E+38 The attribute does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -2456,7 +2456,7 @@ Console.WriteLine("(string)att={0}", str) ]]> - LINQ to XML + LINQ to XML overview @@ -2539,7 +2539,7 @@ value=01:05:30 The attribute does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -2615,7 +2615,7 @@ value=4294967295 The attribute does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -2691,7 +2691,7 @@ value=1844674407370955161 The attribute does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -2779,7 +2779,7 @@ Att1="1" ]]> - LINQ to XML + LINQ to XML overview @@ -2822,7 +2822,7 @@ Att1="1" ## Remarks You can use this method to modify an XML tree. This method will cause events to occur. - There are many scenarios in which you might want to remove a set of attributes. In [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] programming, you should not manipulate or modify a set of nodes while you are querying for nodes in that set. In practical terms, this means that you should not iterate over a set of attributes and remove them. Instead, you should materialize them into a using the extension method. Then you can iterate over the list, removing the attributes. For more information, see [Mixed Declarative Code/Imperative Code Bugs (LINQ to XML)](https://msdn.microsoft.com/library/d9a5c404-2b0e-46cd-a358-0e78773b3094). + There are many scenarios in which you might want to remove a set of attributes. In [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] programming, you should not manipulate or modify a set of nodes while you are querying for nodes in that set. In practical terms, this means that you should not iterate over a set of attributes and remove them. Instead, you should materialize them into a using the extension method. Then you can iterate over the list, removing the attributes. For more information, see [Mixed Declarative Code/Imperative Code Bugs (LINQ to XML)](/dotnet/standard/linq/mixed-declarative-imperative-code-bugs). Alternatively, if you want to remove a set of attributes, it is recommended that you use the method. This method copies the attributes to a list, then iterates over the list, removing the attributes. @@ -2858,7 +2858,7 @@ Console.WriteLine(root) ]]> The parent element is . - LINQ to XML + LINQ to XML overview @@ -2945,7 +2945,7 @@ Console.WriteLine(root) - LINQ to XML + LINQ to XML overview @@ -3024,7 +3024,7 @@ Att2="content2" - LINQ to XML + LINQ to XML overview @@ -3253,7 +3253,7 @@ v4:attribute does not exist - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XCData.xml b/xml/System.Xml.Linq/XCData.xml index 2e405996be6..23f8b6ec5b4 100644 --- a/xml/System.Xml.Linq/XCData.xml +++ b/xml/System.Xml.Linq/XCData.xml @@ -45,7 +45,7 @@ ]]> - LINQ to XML + LINQ to XML overview @@ -57,7 +57,7 @@ Initializes a new instance of the class. - LINQ to XML + LINQ to XML overview @@ -128,7 +128,7 @@ Console.WriteLine(root) ]]> - LINQ to XML + LINQ to XML overview @@ -179,7 +179,7 @@ Console.WriteLine(root) ]]> - LINQ to XML + LINQ to XML overview @@ -293,7 +293,7 @@ Text - LINQ to XML + LINQ to XML overview @@ -341,8 +341,8 @@ Text ]]> - LINQ to XML - Serializing XML Trees + LINQ to XML overview + Serialize to files, TextWriters, and XmlWriters diff --git a/xml/System.Xml.Linq/XComment.xml b/xml/System.Xml.Linq/XComment.xml index 9ae83e0b4ab..f339ec48d97 100644 --- a/xml/System.Xml.Linq/XComment.xml +++ b/xml/System.Xml.Linq/XComment.xml @@ -44,7 +44,7 @@ ]]> - LINQ to XML + LINQ to XML overview @@ -56,7 +56,7 @@ Initializes a new instance of the class. - LINQ to XML + LINQ to XML overview @@ -124,7 +124,7 @@ Console.WriteLine(root) ]]> The parameter is . - LINQ to XML + LINQ to XML overview @@ -170,7 +170,7 @@ Console.WriteLine(root) ]]> The parameter is . - LINQ to XML + LINQ to XML overview @@ -239,7 +239,7 @@ Comment ]]> - LINQ to XML + LINQ to XML overview @@ -315,7 +315,7 @@ This is a comment The is . - LINQ to XML + LINQ to XML overview @@ -364,8 +364,8 @@ This is a comment ]]> - LINQ to XML - Serializing XML Trees + LINQ to XML overview + Serialize to files, TextWriters, and XmlWriters diff --git a/xml/System.Xml.Linq/XContainer.xml b/xml/System.Xml.Linq/XContainer.xml index 3b2e7b96b3b..58d6aef3e7f 100644 --- a/xml/System.Xml.Linq/XContainer.xml +++ b/xml/System.Xml.Linq/XContainer.xml @@ -45,8 +45,8 @@ ]]> - LINQ to XML - How to: Retrieve Elements at a Particular Depth + LINQ to XML overview + How to chain axis method calls @@ -63,7 +63,7 @@ ## Remarks This method adds the new content after the existing content of the . - For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). This method will raise the and the events. @@ -127,7 +127,7 @@ Console.WriteLine(xmlTree) - LINQ to XML + LINQ to XML overview @@ -173,7 +173,7 @@ Console.WriteLine(xmlTree) ## Remarks This method adds the new content after the existing content of the . - For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). This method will raise the and the events. @@ -261,7 +261,7 @@ Console.WriteLine(xmlTree) - LINQ to XML + LINQ to XML overview @@ -320,7 +320,7 @@ Console.WriteLine(xmlTree) ## Remarks This method adds the new content after the existing content of the . - For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). This method will raise the and the events. @@ -407,7 +407,7 @@ Console.WriteLine(xmlTree) - LINQ to XML + LINQ to XML overview @@ -424,7 +424,7 @@ Console.WriteLine(xmlTree) ## Remarks This method adds the new content before the existing content of the . - For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). This method will raise the and the events. @@ -488,7 +488,7 @@ Console.WriteLine(xmlTree) - LINQ to XML + LINQ to XML overview @@ -534,7 +534,7 @@ Console.WriteLine(xmlTree) ## Remarks This method adds the new content before the existing content of the . - For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). This method will raise the and the events. @@ -621,7 +621,7 @@ Console.WriteLine(xmlTree) - LINQ to XML + LINQ to XML overview @@ -680,7 +680,7 @@ Console.WriteLine(xmlTree) ## Remarks This method adds the new content before the existing content of the . - For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). This method will raise the and the events. @@ -768,7 +768,7 @@ Console.WriteLine(xmlTree) - LINQ to XML + LINQ to XML overview @@ -812,7 +812,7 @@ Console.WriteLine(xmlTree) ## Remarks While serializing, namespace prefixes are inferred from the namespace attributes in the XML tree. - For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). @@ -894,8 +894,8 @@ Console.WriteLine(newTree) ]]> - LINQ to XML - Serializing XML Trees + LINQ to XML overview + Serialize to files, TextWriters, and XmlWriters @@ -1005,7 +1005,7 @@ element content - LINQ to XML + LINQ to XML overview @@ -1026,7 +1026,7 @@ element content - LINQ to XML + LINQ to XML overview @@ -1126,7 +1126,7 @@ GrandChild - LINQ to XML + LINQ to XML overview @@ -1217,7 +1217,7 @@ Next Child ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp // Attributes are not nodes, so will not be returned by DescendantNodes. @@ -1269,7 +1269,7 @@ End Module - LINQ to XML + LINQ to XML overview @@ -1391,7 +1391,7 @@ Console.WriteLine(xmlTree) ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -1467,7 +1467,7 @@ End Module ]]> - LINQ to XML + LINQ to XML overview @@ -1489,7 +1489,7 @@ End Module - LINQ to XML + LINQ to XML overview @@ -1587,7 +1587,7 @@ Next 3 ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -1645,7 +1645,7 @@ End Module - LINQ to XML + LINQ to XML overview @@ -1738,7 +1738,7 @@ Next 5 ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -1794,7 +1794,7 @@ End Module - LINQ to XML + LINQ to XML overview @@ -1873,7 +1873,7 @@ Console.WriteLine(firstNode) - LINQ to XML + LINQ to XML overview @@ -1952,7 +1952,7 @@ Console.WriteLine(lastNode) - LINQ to XML + LINQ to XML overview @@ -2143,7 +2143,7 @@ Text - LINQ to XML + LINQ to XML overview @@ -2233,7 +2233,7 @@ Console.WriteLine(xmltree) - LINQ to XML + LINQ to XML overview @@ -2248,7 +2248,7 @@ Console.WriteLine(xmltree) and the events. @@ -2305,7 +2305,7 @@ Console.WriteLine(root) - LINQ to XML + LINQ to XML overview @@ -2349,7 +2349,7 @@ Console.WriteLine(root) and the events. @@ -2408,7 +2408,7 @@ Console.WriteLine(root) - LINQ to XML + LINQ to XML overview @@ -2465,7 +2465,7 @@ Console.WriteLine(root) and the events. @@ -2522,7 +2522,7 @@ Console.WriteLine(root) - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XDeclaration.xml b/xml/System.Xml.Linq/XDeclaration.xml index 387db3a3bf5..8734cc04624 100644 --- a/xml/System.Xml.Linq/XDeclaration.xml +++ b/xml/System.Xml.Linq/XDeclaration.xml @@ -41,13 +41,13 @@ ## Remarks An XML declaration is used to declare the XML version, the encoding, and whether or not the XML document is standalone. This class represents the XML concept of an XML declaration. - Just as in the XML standard, declarations are associated with a document. When you create a document, you have the option to specify the declaration for the document. The class contains the property, which allows you to set or get the declaration. For information about how to serialize an XML tree with an XML declaration, see [Serializing with an XML Declaration](https://msdn.microsoft.com/library/30f1b564-62b5-4e5d-9c36-884e51113feb). + Just as in the XML standard, declarations are associated with a document. When you create a document, you have the option to specify the declaration for the document. The class contains the property, which allows you to set or get the declaration. For information about how to serialize an XML tree with an XML declaration, see [Serialize with an XML Declaration](/dotnet/standard/linq/serialize-xml-declaration). ]]> - LINQ to XML - How to: Read and Write an Encoded Document + LINQ to XML overview + How to read and write an encoded document @@ -60,8 +60,8 @@ Initializes a new instance of the class. - LINQ to XML - How to: Read and Write an Encoded Document + LINQ to XML overview + How to read and write an encoded document @@ -107,8 +107,8 @@ ]]> - LINQ to XML - How to: Read and Write an Encoded Document + LINQ to XML overview + How to read and write an encoded document @@ -194,8 +194,8 @@ Console.WriteLine(File.ReadAllText("Root.xml")) ]]> - LINQ to XML - How to: Read and Write an Encoded Document + LINQ to XML overview + How to read and write an encoded document @@ -347,8 +347,8 @@ Encoding of loaded document is:utf-16 ]]> - LINQ to XML - How to: Read and Write an Encoded Document + LINQ to XML overview + How to read and write an encoded document @@ -431,7 +431,7 @@ yes ]]> - LINQ to XML + LINQ to XML overview @@ -470,7 +470,7 @@ yes Provides the declaration as a formatted string. A that contains the formatted XML string. To be added. - LINQ to XML + LINQ to XML overview @@ -553,7 +553,7 @@ yes ]]> - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XDocument.xml b/xml/System.Xml.Linq/XDocument.xml index 25a1484c9bb..46624c3b498 100644 --- a/xml/System.Xml.Linq/XDocument.xml +++ b/xml/System.Xml.Linq/XDocument.xml @@ -34,12 +34,12 @@ - Represents an XML document. For the components and usage of an object, see XDocument Class Overview. + Represents an XML document. For the components and usage of an object, see XDocument Class Overview. , see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content of an , see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). @@ -115,8 +115,8 @@ Console.WriteLine(doc) - LINQ to XML - XDocument Class Overview + LINQ to XML overview + XDocument Class Overview @@ -135,7 +135,7 @@ Console.WriteLine(doc) There are not many scenarios that require you to create an . Instead, you can usually create your XML trees with an root node. Unless you have a specific requirement to create a document (for example, because you have to create processing instructions and comments at the top level, or you have to support document types), it is often more convenient to use as your root node. - For details about the valid content of an , see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content of an , see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). @@ -208,8 +208,8 @@ Console.WriteLine(doc) ]]> - LINQ to XML - XDocument Class Overview + LINQ to XML overview + XDocument Class Overview @@ -254,7 +254,7 @@ Console.WriteLine(doc) ## Remarks There are not many scenarios that require you to create an . Instead, you can usually create your XML trees with an root node. Unless you have a specific requirement to create a document (for example, because you have to create processing instructions and comments at the top level, or you have to support document types), it is often more convenient to use as your root node. - For details about the valid content of an , see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content of an , see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). @@ -285,8 +285,8 @@ Console.WriteLine(doc) ]]> - LINQ to XML - XDocument Class Overview + LINQ to XML overview + XDocument Class Overview @@ -336,7 +336,7 @@ Console.WriteLine(doc) ## Remarks There are not many scenarios that require you to create an . Instead, you can usually create your XML trees with an root node. Unless you have a specific requirement to create a document (for example, because you have to create processing instructions and comments at the top level, or you have to support document types), it is often more convenient to use as your root node. - For details about the valid content of an , see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content of an , see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). @@ -409,8 +409,8 @@ Console.WriteLine(doc) ]]> - LINQ to XML - XDocument Class Overview + LINQ to XML overview + XDocument Class Overview @@ -458,8 +458,8 @@ Console.WriteLine(doc) ]]> - LINQ to XML - XDocument Class Overview + LINQ to XML overview + XDocument Class Overview @@ -517,7 +517,7 @@ Console.WriteLine(doc) ## Remarks There are not many scenarios that require you to create an . Instead, you can usually create your XML trees with an root node. Unless you have a specific requirement to create a document (for example, because you have to create processing instructions and comments at the top level, or you have to support document types), it is often more convenient to use as your root node. - For details about the valid content of an , see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content of an , see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). @@ -594,8 +594,8 @@ Console.WriteLine(File.ReadAllText("Test.xml")) ]]> - LINQ to XML - XDocument Class Overview + LINQ to XML overview + XDocument Class Overview @@ -681,8 +681,8 @@ Console.WriteLine(doc.Declaration) ]]> - LINQ to XML - How to: Read and Write an Encoded Document + LINQ to XML overview + How to read and write an encoded document @@ -828,7 +828,7 @@ Console.WriteLine(doc) - LINQ to XML + LINQ to XML overview @@ -852,8 +852,8 @@ Console.WriteLine(doc) - LINQ to XML - Querying an XDocument vs. Querying an XElement + LINQ to XML overview + Query an XDocument vs. query an XElement @@ -995,8 +995,8 @@ Console.WriteLine(doc) - LINQ to XML - Querying an XDocument vs. Querying an XElement + LINQ to XML overview + Query an XDocument vs. query an XElement @@ -1060,7 +1060,7 @@ Console.WriteLine(doc) This example uses the following XML document: - [Sample XML File: Typical Purchase Order (LINQ to XML)](https://msdn.microsoft.com/library/0606c09f-6e43-4f8d-95c8-e8e2e08d2348) + [Sample XML File: Typical Purchase Order (LINQ to XML)](/dotnet/standard/linq/sample-xml-file-typical-purchase-order) ```csharp XDocument doc = XDocument.Load("PurchaseOrder.xml"); @@ -1115,8 +1115,8 @@ Console.WriteLine(doc) - LINQ to XML - Querying an XDocument vs. Querying an XElement + LINQ to XML overview + Query an XDocument vs. query an XElement @@ -1229,8 +1229,8 @@ End Using - LINQ to XML - Querying an XDocument vs. Querying an XElement + LINQ to XML overview + Query an XDocument vs. query an XElement @@ -1338,7 +1338,7 @@ End Using If the source XML is not indented, setting the flag in `options` has no effect. Significant white space is still preserved, and there are no spans of insignificant white space that could cause the creation of more white space text nodes. - For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). Use to create an from a string that contains XML. @@ -1421,8 +1421,8 @@ Count of white space nodes (preserving whitespace): 3 - LINQ to XML - Querying an XDocument vs. Querying an XElement + LINQ to XML overview + Query an XDocument vs. query an XElement @@ -1475,7 +1475,7 @@ Count of white space nodes (preserving whitespace): 3 If the source XML is not indented, setting the flag in `options` has no effect. Significant white space is still preserved, and there are no spans of insignificant white space that could cause the creation of more white space text nodes. - For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). Use to create an from a string that contains XML. @@ -1492,7 +1492,7 @@ Count of white space nodes (preserving whitespace): 3 This example uses the following XML document: - [Sample XML File: Typical Purchase Order (LINQ to XML)](https://msdn.microsoft.com/library/0606c09f-6e43-4f8d-95c8-e8e2e08d2348) + [Sample XML File: Typical Purchase Order (LINQ to XML)](/dotnet/standard/linq/sample-xml-file-typical-purchase-order) ```csharp XDocument doc1 = XDocument.Load("PurchaseOrder.xml", LoadOptions.None); @@ -1522,8 +1522,8 @@ nodes if preserving whitespace: 82 - LINQ to XML - Querying an XDocument vs. Querying an XElement + LINQ to XML overview + Query an XDocument vs. query an XElement @@ -1671,8 +1671,8 @@ Root 1 2 - LINQ to XML - How to: Read and Write an Encoded Document + LINQ to XML overview + How to read and write an encoded document @@ -1880,7 +1880,7 @@ Document - LINQ to XML + LINQ to XML overview @@ -1939,8 +1939,8 @@ Console.WriteLine(doc) - LINQ to XML - Parsing XML + LINQ to XML overview + How to parse a string @@ -1993,7 +1993,7 @@ Console.WriteLine(doc) ## Remarks This method does not preserve white space. If you want to preserve white space in the XML tree, use the overload of that takes as a parameter. - For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). LINQ to XML's loading functionality is built upon . Therefore, you might catch any exceptions that are thrown by the overload methods and the methods that read and parse the document. @@ -2039,8 +2039,8 @@ Console.WriteLine(doc) - LINQ to XML - Parsing XML + LINQ to XML overview + How to parse a string @@ -2093,7 +2093,7 @@ Console.WriteLine(doc) If the source XML is not indented, setting the flag in `options` has no effect. Significant white space is still preserved, and there are no spans of insignificant white space that could cause the creation of more white space text nodes. - For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). Setting is not valid when parsing from a . @@ -2147,8 +2147,8 @@ nodes when not preserving whitespace: 4 - LINQ to XML - Parsing XML + LINQ to XML overview + How to parse a string @@ -2195,7 +2195,7 @@ nodes when not preserving whitespace: 4 . See [Querying an XDocument vs. Querying an XElement](https://msdn.microsoft.com/library/d266f58d-f2f3-4668-b661-e716e658d13a) for more details. + This property is useful when you want to compose [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] queries in the same context as when composing them for a tree rooted in . See [Query an XDocument vs. query an XElement](/dotnet/standard/linq/query-xdocument-vs-query-xelement) for more details. @@ -2247,8 +2247,8 @@ Pubs ]]> - LINQ to XML - How to: Find All Nodes in a Namespace + LINQ to XML overview + How to find all nodes in a namespace @@ -2263,8 +2263,8 @@ Pubs - LINQ to XML - How to: Read and Write an Encoded Document + LINQ to XML overview + How to read and write an encoded document @@ -2360,7 +2360,7 @@ Pubs ## Remarks The serialized XML will be indented. All insignificant white space will be removed, and additional white space will be added so that the XML will be properly indented. The behavior of this method is that insignificant white space will not be preserved. - If you want to control white space, use the overload of that takes as a parameter. For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + If you want to control white space, use the overload of that takes as a parameter. For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). @@ -2406,8 +2406,8 @@ Console.WriteLine(sb.ToString()) - LINQ to XML - How to: Read and Write an Encoded Document + LINQ to XML overview + How to read and write an encoded document @@ -2451,7 +2451,7 @@ Console.WriteLine(sb.ToString()) ## Remarks The serialized XML will be indented. All insignificant white space will be removed, and additional white space will be added so that the XML will be properly indented. The behavior of this method is that insignificant white space will not be preserved. - If you want to control white space, use the overload of that takes as a parameter. For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + If you want to control white space, use the overload of that takes as a parameter. For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). @@ -2491,8 +2491,8 @@ Console.WriteLine(File.ReadAllText("Root.xml")) - LINQ to XML - How to: Read and Write an Encoded Document + LINQ to XML overview + How to read and write an encoded document @@ -2584,8 +2584,8 @@ Console.WriteLine(sb.ToString()) - LINQ to XML - How to: Read and Write an Encoded Document + LINQ to XML overview + How to read and write an encoded document @@ -2687,7 +2687,7 @@ Console.WriteLine(sb.ToString()) If you want to save indented XML, do not specify the flag for `options`. This will remove all extraneous insignificant white space, and add appropriate insignificant white space so that the XML is properly indented. This is the default behavior, and the behavior of the overloads of the methods that do not take `options` as a parameter. - For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). @@ -2748,8 +2748,8 @@ End Using - LINQ to XML - How to: Read and Write an Encoded Document + LINQ to XML overview + How to read and write an encoded document @@ -2797,7 +2797,7 @@ End Using If you want to save indented XML, do not specify the flag for `options`. This will remove all extraneous insignificant white space, and add appropriate insignificant white space so that the XML is properly indented. This is the default behavior, and the behavior of the overloads of the methods that do not take `options` as a parameter. - For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). @@ -2842,8 +2842,8 @@ Console.WriteLine(File.ReadAllText("Root2.xml")) - LINQ to XML - How to: Read and Write an Encoded Document + LINQ to XML overview + How to: Read and Write an Encoded Document @@ -3066,7 +3066,7 @@ Console.WriteLine(sb.ToString()) - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XDocumentType.xml b/xml/System.Xml.Linq/XDocumentType.xml index a7a0429fffc..9de46b7eca1 100644 --- a/xml/System.Xml.Linq/XDocumentType.xml +++ b/xml/System.Xml.Linq/XDocumentType.xml @@ -65,7 +65,7 @@ ]]> - LINQ to XML + LINQ to XML overview @@ -77,7 +77,7 @@ Initializes a new instance of the class. - LINQ to XML + LINQ to XML overview @@ -122,7 +122,7 @@ ]]> - LINQ to XML + LINQ to XML overview @@ -253,7 +253,7 @@ Console.WriteLine(doc) ]]> - LINQ to XML + LINQ to XML overview @@ -371,7 +371,7 @@ Console.WriteLine(doc.DocumentType.InternalSubset) ]]> - LINQ to XML + LINQ to XML overview @@ -486,7 +486,7 @@ Pubs ]]> - LINQ to XML + LINQ to XML overview @@ -600,7 +600,7 @@ DocumentType ]]> - LINQ to XML + LINQ to XML overview @@ -651,7 +651,7 @@ DocumentType ]]> - LINQ to XML + LINQ to XML overview @@ -797,7 +797,7 @@ SystemId:Pubs.dtd ]]> - LINQ to XML + LINQ to XML overview @@ -845,7 +845,7 @@ SystemId:Pubs.dtd ]]> - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XElement.xml b/xml/System.Xml.Linq/XElement.xml index 249e42f64bb..11412ab6fec 100644 --- a/xml/System.Xml.Linq/XElement.xml +++ b/xml/System.Xml.Linq/XElement.xml @@ -80,11 +80,11 @@ - - For details about the valid content of an , see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content of an , see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). derives from , which derives from . - Some methods can be used from XAML. For more information, see [LINQ to XML Dynamic Properties](https://msdn.microsoft.com/library/0455f47c-4a68-4f2e-a3f8-dd1d85b99012). + Some methods can be used from XAML. For more information, see [LINQ to XML Dynamic Properties](/dotnet/desktop/wpf/data/linq-to-xml-dynamic-properties). @@ -140,7 +140,7 @@ Console.WriteLine(xmlTree2) ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -200,8 +200,8 @@ End Module ]]> - LINQ to XML - LINQ to XML Dynamic Properties + LINQ to XML overview + LINQ to XML Dynamic Properties @@ -216,11 +216,11 @@ End Module . Typical use of this constructor is to specify a string as the parameter instead of creating a new . - When creating an element in a namespace, typical use is to use the addition operator overload with an and a string to create an . For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + When creating an element in a namespace, typical use is to use the addition operator overload with an and a string to create an . For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). @@ -278,7 +278,7 @@ Console.WriteLine(xmlTree2) ]]> - LINQ to XML + LINQ to XML overview @@ -371,7 +371,7 @@ xmlTree = treeClone: False ]]> - LINQ to XML + LINQ to XML overview @@ -414,7 +414,7 @@ xmlTree = treeClone: False ## Remarks This constructor creates an element with no content and no attributes. - There is an implicit conversion from string to . Typical use of this constructor is to specify a string as the parameter instead of creating a new . When creating an element in a namespace, typical use is to use the addition operator overload with an and a string to create an . For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + There is an implicit conversion from string to . Typical use of this constructor is to specify a string as the parameter instead of creating a new . When creating an element in a namespace, typical use is to use the addition operator overload with an and a string to create an . For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). @@ -437,7 +437,7 @@ Console.WriteLine(el) ``` - The following example creates an element in a namespace with no content. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following example creates an element in a namespace with no content. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -464,7 +464,7 @@ End Module ]]> - LINQ to XML + LINQ to XML overview @@ -564,7 +564,7 @@ Console.WriteLine(xse) ]]> - LINQ to XML + LINQ to XML overview @@ -611,9 +611,9 @@ Console.WriteLine(xse) There is an implicit conversion from string to . Typical use of this constructor is to specify a string as the parameter instead of creating a new . - When creating an element in a namespace, typical use is to use the addition operator overload with an and a string to create an . For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + When creating an element in a namespace, typical use is to use the addition operator overload with an and a string to create an . For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). - For details about the valid content that can be passed to this constructor, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this constructor, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). @@ -877,7 +877,7 @@ Console.WriteLine(root) ]]> - LINQ to XML + LINQ to XML overview @@ -937,9 +937,9 @@ Console.WriteLine(root) There is an implicit conversion from string to . Typical use of this constructor is to specify a string as the parameter instead of creating a new . - When creating an element in a namespace, typical use is to use the addition operator overload with an and a string to create an . For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + When creating an element in a namespace, typical use is to use the addition operator overload with an and a string to create an . For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). - For details about the valid content that can be passed to this constructor, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this constructor, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). @@ -1200,7 +1200,7 @@ Console.WriteLine(root) ]]> - LINQ to XML + LINQ to XML overview @@ -1222,7 +1222,7 @@ Console.WriteLine(root) ]]> - LINQ to XML + LINQ to XML overview @@ -1317,7 +1317,7 @@ Root ]]> - LINQ to XML + LINQ to XML overview @@ -1407,7 +1407,7 @@ Child ]]> - LINQ to XML + LINQ to XML overview @@ -1452,7 +1452,7 @@ Child - LINQ to XML + LINQ to XML overview @@ -1534,7 +1534,7 @@ aw:Att="attribute content" ]]> - LINQ to XML + LINQ to XML overview @@ -1622,7 +1622,7 @@ Att1="content1" Att2="content2" ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -1667,7 +1667,7 @@ xmlns:aw="http://www.adventure-works.com" ]]> - LINQ to XML + LINQ to XML overview @@ -1747,7 +1747,7 @@ Next Att1="content1" ``` - The following is the same example, but in this case the XML is in a namespace. For more information, see [Working with XML Namespaces](https://msdn.microsoft.com/library/e3003209-3234-45be-a832-47feb7927430). + The following is the same example, but in this case the XML is in a namespace. For more information, see [Work with XML Namespaces](/dotnet/standard/linq/namespaces-overview). ```csharp XNamespace aw = "http://www.adventure-works.com"; @@ -1785,7 +1785,7 @@ aw:Att1="content1" ]]> - LINQ to XML + LINQ to XML overview @@ -1887,7 +1887,7 @@ element content ]]> - LINQ to XML + LINQ to XML overview @@ -1906,7 +1906,7 @@ element content ]]> - LINQ to XML + LINQ to XML overview @@ -1997,7 +1997,7 @@ GrandChild ]]> - LINQ to XML + LINQ to XML overview @@ -2085,7 +2085,7 @@ Child ]]> - LINQ to XML + LINQ to XML overview @@ -2130,7 +2130,7 @@ Child ]]> - LINQ to XML + LINQ to XML overview @@ -2200,7 +2200,7 @@ Att1="1" ]]> - LINQ to XML + LINQ to XML overview @@ -2280,7 +2280,7 @@ Default namespace: http://www.adventure-works.com ]]> - LINQ to XML + LINQ to XML overview @@ -2360,7 +2360,7 @@ Namespace: http://www.adventure-works.com ]]> - LINQ to XML + LINQ to XML overview @@ -2440,7 +2440,7 @@ Prefix: aw ]]> - LINQ to XML + LINQ to XML overview @@ -2510,7 +2510,7 @@ False ]]> - LINQ to XML + LINQ to XML overview @@ -2583,7 +2583,7 @@ False ]]> - LINQ to XML + LINQ to XML overview @@ -2686,7 +2686,7 @@ True ]]> - LINQ to XML + LINQ to XML overview @@ -2762,7 +2762,7 @@ Att3="3" ]]> - LINQ to XML + LINQ to XML overview @@ -2785,7 +2785,7 @@ Att3="3" - LINQ to XML + LINQ to XML overview @@ -2930,7 +2930,7 @@ Console.WriteLine(xmlTree) ]]> - LINQ to XML + LINQ to XML overview @@ -3021,7 +3021,7 @@ Root - LINQ to XML + LINQ to XML overview @@ -3131,7 +3131,7 @@ End Using ]]> - LINQ to XML + LINQ to XML overview @@ -3239,7 +3239,7 @@ End Using If the source XML is not indented, setting the flag in `options` has no effect. Significant white space is still preserved, and there are no spans of insignificant white space that could cause the creation of more white space text nodes. - For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). Use to create an from a string that contains XML. @@ -3378,7 +3378,7 @@ Root 1 2 ]]> - LINQ to XML + LINQ to XML overview @@ -3431,7 +3431,7 @@ Root 1 2 If the source XML is not indented, setting the flag in `options` has no effect. Significant white space is still preserved, and there are no spans of insignificant white space that could cause the creation of more white space text nodes. - For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). Use to create an from a string that contains XML. @@ -3504,7 +3504,7 @@ Count of white space nodes (preserving whitespace): 3 The following example loads the base URI and line information as it loads the file. It then prints the base URI and the line information. - This example uses the following resource file: [Sample XML File: Typical Purchase Order (LINQ to XML)](https://msdn.microsoft.com/library/0606c09f-6e43-4f8d-95c8-e8e2e08d2348). + This example uses the following resource file: [Sample XML File: Typical Purchase Order (LINQ to XML)](/dotnet/standard/linq/sample-xml-file-typical-purchase-order). ```csharp XElement po = XElement.Load("PurchaseOrder.xml", @@ -3586,7 +3586,7 @@ PurchaseOrder 2 2 ]]> - LINQ to XML + LINQ to XML overview @@ -3731,7 +3731,7 @@ Root 1 2 ]]> - LINQ to XML + LINQ to XML overview @@ -3962,7 +3962,7 @@ Root ]]> - LINQ to XML + LINQ to XML overview @@ -4030,7 +4030,7 @@ Element ]]> - LINQ to XML + LINQ to XML overview @@ -4120,7 +4120,7 @@ Console.WriteLine("(bool)BoolValue2={0}", bool2) The element does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -4230,7 +4230,7 @@ orderDate=10/6/2006 The element does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -4320,7 +4320,7 @@ dt=10/6/2006 12:30:00 PM -07:00 The element does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -4396,7 +4396,7 @@ value=79228162514264337593543950335 The element does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -4470,7 +4470,7 @@ value=1.79769313486231E+308 The element does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -4545,7 +4545,7 @@ value=3c1cc55b-baff-4b7a-9d17-077af3aa5730 The element does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -4620,7 +4620,7 @@ value=2147483647 The element does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -4695,7 +4695,7 @@ value=9223372036854775807 The element does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -4784,7 +4784,7 @@ Nullable Boolean: value2=False ]]> The element is not and does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -4870,7 +4870,7 @@ Nullable DateTime: value=10/6/2006 12:30:00 PM ]]> The element is not and does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -4959,7 +4959,7 @@ dt=10/6/2006 12:30:00 PM -07:00 ]]> The element is not and does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -5038,7 +5038,7 @@ Nullable decimal: value=79228162514264337593543950335 ]]> The element is not and does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -5118,7 +5118,7 @@ Nullable double: value=1.79769313486231E+308 ]]> The element is not and does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -5197,7 +5197,7 @@ Nullable Guid: value=3c1cc55b-baff-4b7a-9d17-077af3aa5730 ]]> The element is not and does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -5277,7 +5277,7 @@ Nullable integer: value=2147483647 ]]> The element is not and does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -5356,7 +5356,7 @@ Nullable ulong: value=9223372036854775807 ]]> The element is not and does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -5435,7 +5435,7 @@ Nullable Single: value=3.402823E+38 ]]> The element is not and does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -5519,7 +5519,7 @@ Nullable TimeSpan: value=01:05:30 ]]> The element is not and does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -5598,7 +5598,7 @@ Nullable uint: value=4294967295 ]]> The element is not and does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -5678,7 +5678,7 @@ Nullable ulong: value=9223372036854775807 ]]> The element is not and does not contain a valid value. - LINQ to XML + LINQ to XML overview @@ -5753,7 +5753,7 @@ value=3.402823E+38 The element does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -5827,7 +5827,7 @@ Console.WriteLine("(string)root={0}", root.Value) ]]> - LINQ to XML + LINQ to XML overview @@ -5907,7 +5907,7 @@ value=01:05:30 The element does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -5982,7 +5982,7 @@ value=4294967295 The element does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -6057,7 +6057,7 @@ value=18446744073709551615 The element does not contain a valid value. The parameter is . - LINQ to XML + LINQ to XML overview @@ -6069,7 +6069,7 @@ value=18446744073709551615 Load an from a string that contains XML, optionally preserving white space and retaining line information. - LINQ to XML + LINQ to XML overview @@ -6120,7 +6120,7 @@ value=18446744073709551615 method that takes as a parameter. For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + This method does not preserve white space. If you want to preserve white space in the XML tree, use the overload of the method that takes as a parameter. For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). LINQ to XML's loading functionality is built upon . Therefore, you might catch any exceptions that are thrown by the overload methods and the methods that read and parse the document. @@ -6149,7 +6149,7 @@ Console.WriteLine(xmlTree) ]]> - LINQ to XML + LINQ to XML overview @@ -6202,7 +6202,7 @@ Console.WriteLine(xmlTree) If the source XML is not indented, setting the flag in `options` has no effect. Significant white space is still preserved, and there are no spans of insignificant white space that could cause the creation of more white space text nodes. - For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). Setting will have no effect when parsing from a . @@ -6333,7 +6333,7 @@ Root 1 2 ]]> - LINQ to XML + LINQ to XML overview @@ -6416,7 +6416,7 @@ Console.WriteLine(root) - LINQ to XML + LINQ to XML overview @@ -6503,7 +6503,7 @@ Console.WriteLine(root) - LINQ to XML + LINQ to XML overview @@ -6520,7 +6520,7 @@ Console.WriteLine(root) ## Remarks This method uses snapshot semantics - that is, it creates a separate copy of the new content before replacing the contents of the current element with the new content. This means that you can query the contents of the current element and use the results of the query as the specified new content. - For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). This method will raise the and the events. @@ -6592,7 +6592,7 @@ Console.WriteLine(xmlTree) ]]> - LINQ to XML + LINQ to XML overview @@ -6640,7 +6640,7 @@ Console.WriteLine(xmlTree) This method uses snapshot semantics - that is, it creates a separate copy of the new content before replacing the contents of the current element with the new content. This means that you can query the contents of the current element and use the results of the query as the specified new content. - For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). This method will raise the and the events. @@ -6785,7 +6785,7 @@ Console.WriteLine(root) ]]> - LINQ to XML + LINQ to XML overview @@ -6846,7 +6846,7 @@ Console.WriteLine(root) This method uses snapshot semantics - that is, it creates a separate copy of the new content before replacing the contents of the current element with the new content. This means that you can query the contents of the current element and use the results of the query as the specified new content. - For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). This method will raise the and the events. @@ -6913,7 +6913,7 @@ Console.WriteLine(root) ]]> - LINQ to XML + LINQ to XML overview @@ -6930,7 +6930,7 @@ Console.WriteLine(root) ## Remarks This method will raise the and the events. - For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). @@ -6963,7 +6963,7 @@ Console.WriteLine(root) ]]> - LINQ to XML + LINQ to XML overview @@ -7009,7 +7009,7 @@ Console.WriteLine(root) ## Remarks This method first removes existing attributes. It then adds the specified `content`. - For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). This method will raise the and the events. @@ -7044,7 +7044,7 @@ Console.WriteLine(root) ]]> - LINQ to XML + LINQ to XML overview @@ -7103,7 +7103,7 @@ Console.WriteLine(root) ## Remarks This method first removes existing attributes. It then adds the specified `content`. - For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). This method will raise the and the events. @@ -7143,7 +7143,7 @@ Console.WriteLine(root) ]]> - LINQ to XML + LINQ to XML overview @@ -7155,7 +7155,7 @@ Console.WriteLine(root) Serialize this element's underlying XML tree. The output can be saved to a file, an , a , or an . Optionally, formatting (indenting) can be disabled. - LINQ to XML + LINQ to XML overview @@ -7251,7 +7251,7 @@ Console.WriteLine(root) ## Remarks The serialized XML will be indented. All insignificant white space will be removed, and additional white space will be added so that the XML will be properly indented. The behavior of this method is that white space will not be preserved. - If you want to control white space, use the overload of that allows you to specify as a parameter. For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + If you want to control white space, use the overload of that allows you to specify as a parameter. For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). @@ -7285,7 +7285,7 @@ End Using ]]> - LINQ to XML + LINQ to XML overview @@ -7329,7 +7329,7 @@ End Using ## Remarks The serialized XML will be indented. All insignificant white space will be removed, and additional white space will be added so that the XML will be properly indented. The behavior of this method is that insignificant white space nodes in the XML tree will not be preserved. - If you want to control white space, use the overload of that allows you to specify as a parameter. For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + If you want to control white space, use the overload of that allows you to specify as a parameter. For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). @@ -7366,7 +7366,7 @@ Console.WriteLine(Str) ]]> - LINQ to XML + LINQ to XML overview @@ -7446,7 +7446,7 @@ Console.WriteLine(sb.ToString()) ]]> - LINQ to XML + LINQ to XML overview @@ -7548,7 +7548,7 @@ Console.WriteLine(sb.ToString()) If you want to save indented XML, do not specify the flag for `options`. This will remove all extraneous insignificant white space, and add appropriate insignificant white space so that the XML is properly indented. This is the default behavior, and the behavior of the overloads of the methods that do not take `options` as a parameter. - For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). @@ -7602,7 +7602,7 @@ End Using ]]> - LINQ to XML + LINQ to XML overview @@ -7650,7 +7650,7 @@ End Using If you want to save indented XML, do not specify the flag for `options`. This will remove all extraneous insignificant white space, and add appropriate insignificant white space so that the XML is properly indented. This is the default behavior, and the behavior of the overloads of the methods that do not take `options` as a parameter. - For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). @@ -7700,7 +7700,7 @@ Console.WriteLine(str) ]]> - LINQ to XML + LINQ to XML overview @@ -7867,7 +7867,7 @@ Console.WriteLine(str) The value is assigned to the attribute with the specified name. If no attribute with the specified name exists, a new attribute is added. If the value is `null`, the attribute with the specified name, if any, is deleted. - For more information, see [Maintaining Name/Value Pairs](https://msdn.microsoft.com/library/fe9798bf-b5e2-4a3c-a86c-7f8638912691). + For more information, see [Maintain name-value pairs](/dotnet/standard/linq/maintain-name-value-pairs). @@ -7926,8 +7926,8 @@ Console.WriteLine(root) - LINQ to XML - Maintaining Name/Value Pairs + LINQ to XML overview + Maintain name-value pairs @@ -7981,7 +7981,7 @@ Console.WriteLine(root) This method does not add child nodes or attributes to the specified child element. This method throws an exception if any object that derives from is passed as `value`. - For more information, see [Maintaining Name/Value Pairs](https://msdn.microsoft.com/library/fe9798bf-b5e2-4a3c-a86c-7f8638912691). + For more information, see [Maintain name-value pairs](/dotnet/standard/linq/maintain-name-value-pairs). @@ -8051,8 +8051,8 @@ Console.WriteLine(root) - LINQ to XML - Maintaining Name/Value Pairs + LINQ to XML overview + Maintain name-value pairs @@ -8136,7 +8136,7 @@ Console.WriteLine(root) - LINQ to XML + LINQ to XML overview @@ -8182,7 +8182,7 @@ Console.WriteLine(root) ## Remarks This method is part of implementation of the interface. - This method is used internally for serializing object graphs that contain LINQ to XML objects. For an example of serializing an object graph that contains LINQ to XML objects, see [Serializing Object Graphs that Contain XElement Objects](https://msdn.microsoft.com/library/443d7904-a6f0-450a-b1a4-5d7ed869d1d5). + This method is used internally for serializing object graphs that contain LINQ to XML objects. For an example of serializing an object graph that contains LINQ to XML objects, see [Serialize object graphs that contain XElement objects](/dotnet/standard/linq/serialize-xmlserializer). ]]> @@ -8233,7 +8233,7 @@ Console.WriteLine(root) ## Remarks This method is part of implementation of the interface. - This method is used internally for serializing object graphs that contain LINQ to XML objects. For an example of serializing an object graph that contains LINQ to XML objects, see [Serializing Object Graphs that Contain XElement Objects](https://msdn.microsoft.com/library/443d7904-a6f0-450a-b1a4-5d7ed869d1d5). + This method is used internally for serializing object graphs that contain LINQ to XML objects. For an example of serializing an object graph that contains LINQ to XML objects, see [Serialize object graphs that contain XElement objects](/dotnet/standard/linq/serialize-xmlserializer). ]]> @@ -8282,7 +8282,7 @@ Console.WriteLine(root) @@ -8355,7 +8355,7 @@ This is mixed content ]]> - LINQ to XML + LINQ to XML overview @@ -8465,7 +8465,7 @@ Console.WriteLine(sb.ToString()) ]]> - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XName.xml b/xml/System.Xml.Linq/XName.xml index ca1259ce25a..e496f466d71 100644 --- a/xml/System.Xml.Linq/XName.xml +++ b/xml/System.Xml.Linq/XName.xml @@ -177,7 +177,7 @@ Console.WriteLine(root) ]]> - LINQ to XML + LINQ to XML overview @@ -227,7 +227,7 @@ Console.WriteLine(root) ]]> - LINQ to XML + LINQ to XML overview @@ -246,15 +246,15 @@ Console.WriteLine(root) A much more common and easier way to create an is to use the implicit conversion from string. To create a name that is in a namespace, the common approach is to use the addition operator overload that allows you to combine an object and a string. - For more information and examples, see [How to: Create a Document with Namespaces (C#) (LINQ to XML)](https://msdn.microsoft.com/library/af4a595e-ffb2-4187-a61b-d5ed71642c4c). + For more information and examples, see [How to create a document with namespaces in C#](/dotnet/standard/linq/create-document-namespaces-csharp). - For more information on using namespaces in Visual Basic, see [Namespaces in Visual Basic (LINQ to XML)](https://msdn.microsoft.com/library/10b7ba7b-518c-4f14-899f-892575d14dcc). + For more information on using namespaces, see [Work with XML namespace](/dotnet/standard/linq/namespaces-overview). Because objects are atomized, if there is an existing with exactly the same name, the assigned variable will refer to the existing . If there is no existing , a new one will be created and initialized. ]]> - LINQ to XML + LINQ to XML overview @@ -348,7 +348,7 @@ End Module ]]> - LINQ to XML + LINQ to XML overview @@ -443,7 +443,7 @@ End Module ]]> - LINQ to XML + LINQ to XML overview @@ -489,7 +489,7 @@ End Module ]]> - LINQ to XML + LINQ to XML overview @@ -575,7 +575,7 @@ http://www.adventure-works.com ]]> - LINQ to XML + LINQ to XML overview @@ -660,7 +660,7 @@ http://www.adventure-works.com ]]> - LINQ to XML + LINQ to XML overview @@ -733,7 +733,7 @@ http://www.adventure-works.com ]]> - LINQ to XML + LINQ to XML overview @@ -820,7 +820,7 @@ True ]]> - LINQ to XML + LINQ to XML overview @@ -912,7 +912,7 @@ End Module ]]> - LINQ to XML + LINQ to XML overview @@ -998,7 +998,7 @@ False ]]> - LINQ to XML + LINQ to XML overview @@ -1168,7 +1168,7 @@ http://www.adventure-works.com ]]> - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XNamespace.xml b/xml/System.Xml.Linq/XNamespace.xml index c99c426e03c..c882c7e6362 100644 --- a/xml/System.Xml.Linq/XNamespace.xml +++ b/xml/System.Xml.Linq/XNamespace.xml @@ -80,9 +80,9 @@ End Module Assigning a string to an uses the implicit conversion from . - See [How to: Create a Document with Namespaces (C#) (LINQ to XML)](https://msdn.microsoft.com/library/af4a595e-ffb2-4187-a61b-d5ed71642c4c) for more information and examples. + See [How to create a document with namespaces in C# (LINQ to XML)](/dotnet/standard/linq/create-document-namespaces-csharp) for more information and examples. - See [Namespaces in Visual Basic (LINQ to XML)](https://msdn.microsoft.com/library/10b7ba7b-518c-4f14-899f-892575d14dcc) for more information on using namespaces in Visual Basic. + See [Work with XML namespaces](/dotnet/standard/linq/namespaces-overview) for more information on using namespaces in Visual Basic. ## Controlling Namespace Prefixes If you create an attribute that declares a namespace, the prefix specified in the attribute will be persisted in the serialized XML. To create an attribute that declares a namespace with a prefix, you create an attribute where the namespace of the name of the attribute is , and the name of the attribute is the namespace prefix. The value of the attribute is the URI of the namespace. The following example shows this idiom: @@ -123,7 +123,7 @@ End Module Content ``` - For more information, see [How to: Control Namespace Prefixes (C#) (LINQ to XML)](https://msdn.microsoft.com/library/a40d4479-f1b9-4d8b-8623-445648caed28). + For more information, see [How to control namespace prefixes](/dotnet/standard/linq/control-namespace-prefixes). ## Creating a Default Namespace When constructing an attribute that will be a namespace, if the attribute name has the special value of "xmlns", then when the XML tree is serialized, the namespace will be declared as the default namespace. The special attribute with the name of "xmlns" itself is not in any namespace. The value of the attribute is the namespace URI. @@ -204,7 +204,7 @@ Console.WriteLine(e) ]]> - LINQ to XML + LINQ to XML overview @@ -279,7 +279,7 @@ True ]]> - LINQ to XML + LINQ to XML overview @@ -364,7 +364,7 @@ http://www.adventure-works.com ]]> - LINQ to XML + LINQ to XML overview @@ -410,7 +410,7 @@ http://www.adventure-works.com ]]> - LINQ to XML + LINQ to XML overview @@ -488,7 +488,7 @@ End Module ]]> - LINQ to XML + LINQ to XML overview @@ -565,7 +565,7 @@ http://www.adventure-works.com ]]> - LINQ to XML + LINQ to XML overview @@ -681,7 +681,7 @@ ChildInNoNamespace element is in no namespace ]]> - LINQ to XML + LINQ to XML overview @@ -776,7 +776,7 @@ End Module ]]> - LINQ to XML + LINQ to XML overview @@ -852,7 +852,7 @@ True ]]> - LINQ to XML + LINQ to XML overview @@ -927,7 +927,7 @@ http://www.adventure-works.com ]]> - LINQ to XML + LINQ to XML overview @@ -1003,7 +1003,7 @@ False ]]> - LINQ to XML + LINQ to XML overview @@ -1071,7 +1071,7 @@ http://www.adventure-works.com ]]> - LINQ to XML + LINQ to XML overview @@ -1145,7 +1145,7 @@ Console.WriteLine(root) ]]> - LINQ to XML + LINQ to XML overview @@ -1235,7 +1235,7 @@ End Module ]]> - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XNode.xml b/xml/System.Xml.Linq/XNode.xml index 42409eac072..537409a9353 100644 --- a/xml/System.Xml.Linq/XNode.xml +++ b/xml/System.Xml.Linq/XNode.xml @@ -66,7 +66,7 @@ ]]> - LINQ to XML + LINQ to XML overview @@ -81,7 +81,7 @@ and the events. @@ -158,7 +158,7 @@ Console.WriteLine(xmlTree) ]]> - LINQ to XML + LINQ to XML overview @@ -202,7 +202,7 @@ Console.WriteLine(xmlTree) events. @@ -257,7 +257,7 @@ Console.WriteLine(xmlTree) ]]> The parent is . - LINQ to XML + LINQ to XML overview @@ -314,7 +314,7 @@ Console.WriteLine(xmlTree) and the events. @@ -391,7 +391,7 @@ Console.WriteLine(xmlTree) ]]> The parent is . - LINQ to XML + LINQ to XML overview @@ -406,7 +406,7 @@ Console.WriteLine(xmlTree) and events. @@ -485,7 +485,7 @@ Console.WriteLine(xmlTree) ]]> - LINQ to XML + LINQ to XML overview @@ -529,7 +529,7 @@ Console.WriteLine(xmlTree) and the events. @@ -586,7 +586,7 @@ Console.WriteLine(xmlTree) ]]> The parent is . - LINQ to XML + LINQ to XML overview @@ -643,7 +643,7 @@ Console.WriteLine(xmlTree) and the events. @@ -723,7 +723,7 @@ Console.WriteLine(xmlTree) ]]> The parent is . - LINQ to XML + LINQ to XML overview @@ -746,7 +746,7 @@ Console.WriteLine(xmlTree) ]]> - LINQ to XML + LINQ to XML overview @@ -839,7 +839,7 @@ Root ]]> - LINQ to XML + LINQ to XML overview @@ -928,7 +928,7 @@ Child ]]> - LINQ to XML + LINQ to XML overview @@ -1041,7 +1041,7 @@ el1 is before el2 ]]> The two nodes do not share a common ancestor. - LINQ to XML + LINQ to XML overview @@ -1233,7 +1233,7 @@ Console.WriteLine(newTree) ]]> - LINQ to XML + LINQ to XML overview @@ -1384,7 +1384,7 @@ True ]]> - LINQ to XML + LINQ to XML overview @@ -1486,7 +1486,7 @@ Next ]]> - LINQ to XML + LINQ to XML overview @@ -1505,7 +1505,7 @@ Next ]]> - LINQ to XML + LINQ to XML overview @@ -1604,7 +1604,7 @@ Child5 ]]> - LINQ to XML + LINQ to XML overview @@ -1700,7 +1700,7 @@ Child4 ]]> - LINQ to XML + LINQ to XML overview @@ -1719,7 +1719,7 @@ Child4 ]]> - LINQ to XML + LINQ to XML overview @@ -1819,7 +1819,7 @@ Child2 ]]> - LINQ to XML + LINQ to XML overview @@ -1915,7 +1915,7 @@ Child2 ]]> - LINQ to XML + LINQ to XML overview @@ -2003,7 +2003,7 @@ Child 3 Information ]]> - LINQ to XML + LINQ to XML overview @@ -2101,7 +2101,7 @@ Child5 is after Child3 ]]> - LINQ to XML + LINQ to XML overview @@ -2199,7 +2199,7 @@ Child5 is not before Child3 ]]> - LINQ to XML + LINQ to XML overview @@ -2318,7 +2318,7 @@ NodeType: Element Child3 ]]> - LINQ to XML + LINQ to XML overview @@ -2430,7 +2430,7 @@ Node type: Element ]]> - LINQ to XML + LINQ to XML overview @@ -2541,7 +2541,7 @@ Node type: Element ]]> - LINQ to XML + LINQ to XML overview @@ -2661,7 +2661,7 @@ NodeType: Element Child1 ]]> - LINQ to XML + LINQ to XML overview @@ -2710,11 +2710,11 @@ NodeType: Element Child1 The reader that you pass to this method might throw exceptions. does not catch all exceptions thrown by the reader; the unhandled exceptions bubble up to the code that called . In particular, your code should be prepared to handle . - For an example of how to stream a more complex document, see [How to: Stream XML Fragments with Access to Header Information](https://msdn.microsoft.com/library/01311522-9d03-4977-8641-2932c6f56092). + For an example of how to stream a more complex document, see [How to stream XML fragments with access to header information](/dotnet/standard/linq/stream-xml-fragments-access-header-information). Certain standard query operators, such as , iterate their source, collect all of the data, sort it, and then finally yield the first item in the sequence. If you use a query operator that materializes its source before yielding the first item, you will not retain a small memory footprint. - For an example of using [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] to transform extremely large XML documents while maintaining a small memory footprint, see [How to: Perform Streaming Transform of Large XML Documents](https://msdn.microsoft.com/library/0759e428-6e59-4d80-a506-365d3a6a2b73). + For an example of using [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] to transform extremely large XML documents while maintaining a small memory footprint, see [How to perform streaming transform of large XML documents](/dotnet/standard/linq/perform-streaming-transform-large-xml-documents). ## Examples @@ -2738,7 +2738,7 @@ ccc The is not positioned on a recognized node type. The underlying throws an exception. - LINQ to XML + LINQ to XML overview @@ -2817,7 +2817,7 @@ ccc by using the extension method. Then, you can iterate over the list to remove the nodes. For more information, see [Mixed Declarative Code/Imperative Code Bugs (LINQ to XML)](https://msdn.microsoft.com/library/d9a5c404-2b0e-46cd-a358-0e78773b3094). + In [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] programming, you should not manipulate or modify a set of nodes while you are querying for nodes in that set. In practical terms, this means that you should not iterate over a set of nodes and remove them. Instead, you should materialize them into a by using the extension method. Then, you can iterate over the list to remove the nodes. For more information, see [Mixed Declarative Code/Imperative Code Bugs (LINQ to XML)](/dotnet/standard/linq/mixed-declarative-imperative-code-bugs). Alternatively, if you want to remove a set of nodes, it is recommended that you use the method. This method copies the nodes to a list, and then iterates over the list to remove the nodes. @@ -2872,7 +2872,7 @@ Console.WriteLine(xmlTree) ]]> The parent is . - LINQ to XML + LINQ to XML overview @@ -2887,7 +2887,7 @@ Console.WriteLine(xmlTree) and the events. @@ -2942,7 +2942,7 @@ Console.WriteLine(xmlTree) ]]> - LINQ to XML + LINQ to XML overview @@ -2990,7 +2990,7 @@ Console.WriteLine(xmlTree) The stores its child nodes as a singly-linked list of objects. This means that the method must traverse the list of direct child nodes under the parent container. Therefore, using this method might affect your performance. - For details about the valid content that can be passed to this method, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this method, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). This method will raise the and the events. @@ -3043,7 +3043,7 @@ Console.WriteLine(xmlTree) ]]> - LINQ to XML + LINQ to XML overview @@ -3104,7 +3104,7 @@ Console.WriteLine(xmlTree) The stores its child nodes as a singly-linked list of objects. This means that the method must traverse the list of direct child nodes under the parent container. Therefore, using this method might affect your performance. - For details about the valid content that can be passed to this method, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this method, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). This method will raise the and the events. @@ -3180,7 +3180,7 @@ Console.WriteLine(xmlTree) ]]> - LINQ to XML + LINQ to XML overview @@ -3192,7 +3192,7 @@ Console.WriteLine(xmlTree) Returns the XML for this node, optionally disabling formatting. - LINQ to XML + LINQ to XML overview @@ -3262,7 +3262,7 @@ Console.WriteLine(xmlTree) ]]> - LINQ to XML + LINQ to XML overview @@ -3343,7 +3343,7 @@ Console.WriteLine(root.ToString(SaveOptions.None)) ]]> - LINQ to XML + LINQ to XML overview @@ -3387,7 +3387,7 @@ Console.WriteLine(root.ToString(SaveOptions.None)) - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XNodeDocumentOrderComparer.xml b/xml/System.Xml.Linq/XNodeDocumentOrderComparer.xml index fbb8bc7d804..b0e2bd2d13e 100644 --- a/xml/System.Xml.Linq/XNodeDocumentOrderComparer.xml +++ b/xml/System.Xml.Linq/XNodeDocumentOrderComparer.xml @@ -53,7 +53,7 @@ ]]> - LINQ to XML + LINQ to XML overview @@ -133,7 +133,7 @@ Child3 is before Child5 ]]> - LINQ to XML + LINQ to XML overview @@ -221,7 +221,7 @@ Child3 is before Child5 ]]> The two nodes do not share a common ancestor. - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XNodeEqualityComparer.xml b/xml/System.Xml.Linq/XNodeEqualityComparer.xml index 7a5b269e068..3ecb05d4615 100644 --- a/xml/System.Xml.Linq/XNodeEqualityComparer.xml +++ b/xml/System.Xml.Linq/XNodeEqualityComparer.xml @@ -51,7 +51,7 @@ ]]> - LINQ to XML + LINQ to XML overview @@ -124,7 +124,7 @@ False ]]> - LINQ to XML + LINQ to XML overview @@ -225,7 +225,7 @@ False ]]> - LINQ to XML + LINQ to XML overview @@ -302,7 +302,7 @@ HashCode: AD26516B ]]> - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XObject.xml b/xml/System.Xml.Linq/XObject.xml index b96c276a31d..09dca419ad1 100644 --- a/xml/System.Xml.Linq/XObject.xml +++ b/xml/System.Xml.Linq/XObject.xml @@ -49,7 +49,7 @@ ]]> - LINQ to XML + LINQ to XML overview @@ -160,7 +160,7 @@ T1 ]]> - LINQ to XML + LINQ to XML overview @@ -267,7 +267,7 @@ T1 ]]> - LINQ to XML + LINQ to XML overview @@ -378,7 +378,7 @@ T1 ]]> - LINQ to XML + LINQ to XML overview @@ -515,7 +515,7 @@ def ]]> - LINQ to XML + LINQ to XML overview @@ -663,7 +663,7 @@ def ]]> - LINQ to XML + LINQ to XML overview @@ -719,7 +719,7 @@ def ## Examples The following example loads the base URI and line information as it loads the file. It then prints the base URI and the line information. - This example uses the following XML document: [Sample XML File: Typical Purchase Order (LINQ to XML)](https://msdn.microsoft.com/library/0606c09f-6e43-4f8d-95c8-e8e2e08d2348). + This example uses the following XML document: [Sample XML File: Typical Purchase Order (LINQ to XML)](/dotnet/standard/linq/sample-xml-file-typical-purchase-order). ```csharp XElement po = XElement.Load("PurchaseOrder.xml", @@ -801,7 +801,7 @@ PurchaseOrder 2 2 ]]> - LINQ to XML + LINQ to XML overview @@ -1029,7 +1029,7 @@ Total:308 ]]> - LINQ to XML + LINQ to XML overview @@ -1144,7 +1144,7 @@ Changed event raised ]]> - LINQ to XML + LINQ to XML overview @@ -1219,7 +1219,7 @@ Console.WriteLine(documentOfChild.FirstNode) ]]> - LINQ to XML + LINQ to XML overview @@ -1330,7 +1330,7 @@ Text ]]> - LINQ to XML + LINQ to XML overview @@ -1413,7 +1413,7 @@ Root ]]> - LINQ to XML + LINQ to XML overview @@ -1527,7 +1527,7 @@ Count after removing: 2 ]]> - LINQ to XML + LINQ to XML overview @@ -1644,7 +1644,7 @@ Count after removing: 2 ]]> - LINQ to XML + LINQ to XML overview @@ -1935,7 +1935,7 @@ Root 1 2 ]]> - LINQ to XML + LINQ to XML overview @@ -2079,7 +2079,7 @@ Root 1 2 ]]> - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XObjectChange.xml b/xml/System.Xml.Linq/XObjectChange.xml index 80a55eeab16..ce3ae19ab4e 100644 --- a/xml/System.Xml.Linq/XObjectChange.xml +++ b/xml/System.Xml.Linq/XObjectChange.xml @@ -173,7 +173,7 @@ Changed event raised ]]> - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XObjectChangeEventArgs.xml b/xml/System.Xml.Linq/XObjectChangeEventArgs.xml index 97f6e82d51e..89abb444173 100644 --- a/xml/System.Xml.Linq/XObjectChangeEventArgs.xml +++ b/xml/System.Xml.Linq/XObjectChangeEventArgs.xml @@ -44,7 +44,7 @@ ]]> - LINQ to XML + LINQ to XML overview @@ -95,7 +95,7 @@ ]]> - LINQ to XML + LINQ to XML overview @@ -139,7 +139,7 @@ ]]> - LINQ to XML + LINQ to XML overview @@ -183,7 +183,7 @@ ]]> - LINQ to XML + LINQ to XML overview @@ -227,7 +227,7 @@ Gets the type of change. An that contains the type of change. To be added. - LINQ to XML + LINQ to XML overview @@ -271,7 +271,7 @@ ]]> - LINQ to XML + LINQ to XML overview @@ -315,7 +315,7 @@ ]]> - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XProcessingInstruction.xml b/xml/System.Xml.Linq/XProcessingInstruction.xml index c96c0edfdae..376aab2a2f0 100644 --- a/xml/System.Xml.Linq/XProcessingInstruction.xml +++ b/xml/System.Xml.Linq/XProcessingInstruction.xml @@ -45,7 +45,7 @@ ]]> - LINQ to XML + LINQ to XML overview @@ -57,7 +57,7 @@ Initializes a new instance of the class. - LINQ to XML + LINQ to XML overview @@ -102,7 +102,7 @@ ]]> - LINQ to XML + LINQ to XML overview @@ -167,7 +167,7 @@ Console.WriteLine(pi) The or parameter is . The does not follow the constraints of an XML name. - LINQ to XML + LINQ to XML overview @@ -246,7 +246,7 @@ type='text/xsl' href='xform.xsl' ]]> The string is . - LINQ to XML + LINQ to XML overview @@ -314,7 +314,7 @@ ProcessingInstruction ]]> - LINQ to XML + LINQ to XML overview @@ -385,7 +385,7 @@ xml-stylesheet The string is . The does not follow the constraints of an XML name. - LINQ to XML + LINQ to XML overview @@ -433,7 +433,7 @@ xml-stylesheet ]]> - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XStreamingElement.xml b/xml/System.Xml.Linq/XStreamingElement.xml index 491f593bc41..ce6d3e050c7 100644 --- a/xml/System.Xml.Linq/XStreamingElement.xml +++ b/xml/System.Xml.Linq/XStreamingElement.xml @@ -234,7 +234,7 @@ End Module Even if you use the technique described in , if you try to assemble an XML tree that contains the transformed document, memory usage may be too great. - The following example builds on the example in [How to: Stream XML Fragments with Access to Header Information](https://msdn.microsoft.com/library/01311522-9d03-4977-8641-2932c6f56092). + The following example builds on the example in [How to stream XML fragments with access to header information](/dotnet/standard/linq/stream-xml-fragments-access-header-information). This example uses the deferred execution capabilities of to stream the output. @@ -463,7 +463,7 @@ End Sub ]]> - LINQ to XML + LINQ to XML overview @@ -480,11 +480,11 @@ End Sub ## Remarks Queries are not iterated until the is serialized. This is in contrast to using queries for content for an , where queries are iterated at the time of construction of the new . - For details about the valid content that can be passed to this constructor, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this constructor, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). ]]> - LINQ to XML + LINQ to XML overview @@ -582,7 +582,7 @@ Console.WriteLine(dstTree) ]]> - LINQ to XML + LINQ to XML overview @@ -631,7 +631,7 @@ Console.WriteLine(dstTree) Queries are not iterated until the is serialized. This is in contrast to using queries for content for an , where queries are iterated at the time of construction of the new . - For details about the valid content that can be passed to this constructor, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this constructor, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). @@ -655,7 +655,7 @@ Console.WriteLine(dstTree) ]]> - LINQ to XML + LINQ to XML overview @@ -717,7 +717,7 @@ Console.WriteLine(dstTree) Queries are not iterated until the is serialized. This is in contrast to using queries for content for an , where queries are iterated at the time of construction of the new . - For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). @@ -741,7 +741,7 @@ Console.WriteLine(dstTree) ]]> - LINQ to XML + LINQ to XML overview @@ -753,7 +753,7 @@ Console.WriteLine(dstTree) Adds the specified content as children to this . - LINQ to XML + LINQ to XML overview @@ -801,7 +801,7 @@ Console.WriteLine(dstTree) Queries are not iterated until the is serialized. This is in contrast to using queries for content for an , where queries are iterated at the time of construction of the new . - For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). @@ -874,7 +874,7 @@ Console.WriteLine(dstTree) ]]> - LINQ to XML + LINQ to XML overview @@ -935,7 +935,7 @@ Console.WriteLine(dstTree) Queries are not iterated until the is serialized. This is in contrast to using queries for content for an , where queries are iterated at the time of construction of the new . - For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](https://msdn.microsoft.com/library/aee2d319-5c5f-4b99-9bb4-2f58232577ae). + For details about the valid content that can be passed to this function, see [Valid Content of XElement and XDocument Objects](/dotnet/standard/linq/valid-content-xelement-xdocument-objects). @@ -1008,7 +1008,7 @@ Console.WriteLine(dstTree) ]]> - LINQ to XML + LINQ to XML overview @@ -1102,7 +1102,7 @@ NewRoot ]]> - LINQ to XML + LINQ to XML overview @@ -1114,7 +1114,7 @@ NewRoot Serialize this streaming element. The output can be saved to a file, an , a , or an . Optionally, formatting (indenting) can be disabled. - LINQ to XML + LINQ to XML overview @@ -1222,7 +1222,7 @@ NewRoot ## Remarks The serialized XML will be indented. All insignificant white space will be removed, and additional white space will be added so that the XML will be properly indented. The behavior of this method is that insignificant white space nodes in the XML tree will not be preserved. - If you want to control white space, use one of the overloads of that take as a parameter. For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + If you want to control white space, use one of the overloads of that take as a parameter. For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). @@ -1283,7 +1283,7 @@ Console.WriteLine(sb.ToString()) ]]> - LINQ to XML + LINQ to XML overview @@ -1333,7 +1333,7 @@ Console.WriteLine(sb.ToString()) ## Remarks The serialized XML will be indented. All insignificant white space will be removed, and additional white space will be added so that the XML will be properly indented. The behavior of this method is that insignificant white space nodes in the XML tree will not be preserved. - If you want to control white space, use one of the overloads of that take as a parameter. For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + If you want to control white space, use one of the overloads of that take as a parameter. For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). @@ -1392,7 +1392,7 @@ Console.WriteLine(File.ReadAllText("Test.xml")) ]]> - LINQ to XML + LINQ to XML overview @@ -1495,7 +1495,7 @@ Console.WriteLine(sb.ToString()) ]]> - LINQ to XML + LINQ to XML overview @@ -1597,7 +1597,7 @@ Console.WriteLine(sb.ToString()) If you want to save indented XML, do not specify the flag for `options`. This will remove all extraneous insignificant white space, and add appropriate insignificant white space so that the XML is properly indented. This is the default behavior, and the behavior of the overloads of the methods that do not take `options` as a parameter. - For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). @@ -1666,7 +1666,7 @@ Console.WriteLine(sb.ToString()) ]]> - LINQ to XML + LINQ to XML overview @@ -1714,7 +1714,7 @@ Console.WriteLine(sb.ToString()) If you want to save indented XML, do not specify the flag for `options`. This will remove all extraneous insignificant white space, and add appropriate insignificant white space so that the XML is properly indented. This is the default behavior, and the behavior of the overloads of the methods that do not take `options` as a parameter. - For more information, see [Preserving White Space while Loading or Parsing XML](https://msdn.microsoft.com/library/093a7169-a04e-4638-b08c-d1cb98aa650d) and [Preserving White Space While Serializing](https://msdn.microsoft.com/library/fb146217-0a49-4efc-ac84-7265b91d3939). + For more information, see [Preserve white space while loading or parsing XML](/dotnet/standard/linq/preserve-white-space-loading-parsing-xml) and [Preserve white space while serializing](/dotnet/standard/linq/preserve-white-space-serializing). @@ -1779,7 +1779,7 @@ Console.WriteLine(File.ReadAllText("Test2.xml")) ]]> - LINQ to XML + LINQ to XML overview @@ -1798,7 +1798,7 @@ Console.WriteLine(File.ReadAllText("Test2.xml")) ]]> - LINQ to XML + LINQ to XML overview @@ -1906,7 +1906,7 @@ Console.WriteLine(dstTree.ToString()) ]]> - LINQ to XML + LINQ to XML overview @@ -2017,7 +2017,7 @@ Console.WriteLine(dstTree.ToString()) ]]> - LINQ to XML + LINQ to XML overview @@ -2127,7 +2127,7 @@ Console.WriteLine(sb.ToString()) ]]> - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Linq/XText.xml b/xml/System.Xml.Linq/XText.xml index 541c2559bb1..86e1dc03e65 100644 --- a/xml/System.Xml.Linq/XText.xml +++ b/xml/System.Xml.Linq/XText.xml @@ -45,11 +45,11 @@ When processing the contents of an XML tree at the node level, you should be prepared for multiple nodes to be adjacent to each other. Further, you should be prepared for nodes that contain no text. It is possible through [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] methods to remove the content of a text node. However, [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] does not automatically delete the node. The node has identity, and might have annotations, so [!INCLUDE[sqltecxlinq](~/includes/sqltecxlinq-md.md)] allows for zero-length nodes in the tree. - For more information, see [Programming with Nodes](https://msdn.microsoft.com/library/18680d1c-6e7c-4645-8d53-27b5a96f2d3f). + For more information, see [Programming with nodes](/dotnet/standard/linq/program-nodes). ]]> - LINQ to XML + LINQ to XML overview @@ -61,7 +61,7 @@ Initializes a new instance of the class. - LINQ to XML + LINQ to XML overview @@ -127,7 +127,7 @@ Console.WriteLine(root) ]]> - LINQ to XML + LINQ to XML overview @@ -172,7 +172,7 @@ Console.WriteLine(root) ]]> - LINQ to XML + LINQ to XML overview @@ -285,7 +285,7 @@ Text ]]> - LINQ to XML + LINQ to XML overview @@ -373,7 +373,7 @@ Newer text ]]> - LINQ to XML + LINQ to XML overview @@ -421,7 +421,7 @@ Newer text ]]> - LINQ to XML + LINQ to XML overview diff --git a/xml/System.Xml.Schema/Extensions.xml b/xml/System.Xml.Schema/Extensions.xml index 5590e1a4a88..19fbd7ec2f2 100644 --- a/xml/System.Xml.Schema/Extensions.xml +++ b/xml/System.Xml.Schema/Extensions.xml @@ -43,7 +43,7 @@ ## Examples - The XSD in [Sample XSD File: Customers and Orders](https://msdn.microsoft.com/library/8b05efe3-cc5e-4c7b-b322-892dbda41687) contains a schema that can be used to validate the XML document in [Sample XML File: Customers and Orders (LINQ to XML)](https://msdn.microsoft.com/library/26790c41-5976-4558-a096-d0f67bfc4d92). The following example loads the schema and the document, validates the document, changes the document so that the `xs:key` and `xs:keyref` relationship is not valid, and then attempts to validate again. + The XSD in [Sample XSD file: Customers and orders](/dotnet/standard/linq/sample-xsd-file-customers-orders) contains a schema that can be used to validate the XML document in [Sample XML file: Customers and orders](/dotnet/standard/linq/sample-xml-file-customers-orders). The following example loads the schema and the document, validates the document, changes the document so that the `xs:key` and `xs:keyref` relationship is not valid, and then attempts to validate again. ```csharp diff --git a/xml/ns-System.Xml.Linq.xml b/xml/ns-System.Xml.Linq.xml index cf3865ca355..605b909fd04 100644 --- a/xml/ns-System.Xml.Linq.xml +++ b/xml/ns-System.Xml.Linq.xml @@ -23,6 +23,6 @@ ]]> - LINQ to XML + LINQ to XML overview \ No newline at end of file