diff --git a/xml/System.CodeDom.Compiler/IndentedTextWriter.xml b/xml/System.CodeDom.Compiler/IndentedTextWriter.xml index 002f26fb26c..11f61a19f4f 100644 --- a/xml/System.CodeDom.Compiler/IndentedTextWriter.xml +++ b/xml/System.CodeDom.Compiler/IndentedTextWriter.xml @@ -71,25 +71,25 @@ Provides a text writer that can indent new lines by a tab string token. - extends a by providing methods that insert a tab string and track the current indentation level. Text formatted with multiple indentation levels is useful for generated code, so this class is used by CodeDOM code generator implementations. - - The tab string is the string that each indentation consists of. Typically the tab string contains white space. - + extends a by providing methods that insert a tab string and track the current indentation level. Text formatted with multiple indentation levels is useful for generated code, so this class is used by CodeDOM code generator implementations. + + The tab string is the string that each indentation consists of. Typically the tab string contains white space. + > [!NOTE] -> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands) and [Inheritance Demands](https://learn.microsoft.com/previous-versions/dotnet/netframework-4.0/x4yx82e6(v=vs.100)). - - - -## Examples - The following code example demonstrates using an to write text at different levels of indentation. - +> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands) and [Inheritance Demands](https://learn.microsoft.com/previous-versions/dotnet/netframework-4.0/x4yx82e6(v=vs.100)). + + + +## Examples + The following code example demonstrates using an to write text at different levels of indentation. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/IndentedTextWriterExample/CPP/form1.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.CodeDom.Compiler/IndentedTextWriter/Overview/form1.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/IndentedTextWriterExample/VB/form1.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/IndentedTextWriterExample/VB/form1.vb" id="Snippet1"::: + ]]> @@ -205,15 +205,15 @@ The tab string to use for indentation. Initializes a new instance of the class using the specified text writer and tab string. - using a specified tab string. - + using a specified tab string. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/IndentedTextWriterExample/CPP/form1.cpp" id="Snippet3"::: :::code language="csharp" source="~/snippets/csharp/System.CodeDom.Compiler/IndentedTextWriter/Overview/form1.cs" id="Snippet3"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/IndentedTextWriterExample/VB/form1.vb" id="Snippet3"::: - + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/IndentedTextWriterExample/VB/form1.vb" id="Snippet3"::: + ]]> @@ -310,11 +310,11 @@ Specifies the default tab string. This field is constant. - @@ -352,7 +352,6 @@ Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously. A representing the asynchronous dispose operation. To be added. - @@ -447,11 +446,11 @@ Flushes the stream. - @@ -489,7 +488,6 @@ Clears all buffers for this asynchronously and causes any buffered data to be written to the underlying device. A representing the asynchronous flush operation. This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as , are still thrown synchronously. For the stored exceptions, see the exceptions thrown by . - @@ -580,15 +578,15 @@ Gets or sets the number of spaces to indent. The number of spaces to indent. - . The indentation level is the number of tab strings to prefix each line with. - + . The indentation level is the number of tab strings to prefix each line with. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/IndentedTextWriterExample/CPP/form1.cpp" id="Snippet3"::: :::code language="csharp" source="~/snippets/csharp/System.CodeDom.Compiler/IndentedTextWriter/Overview/form1.cs" id="Snippet3"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/IndentedTextWriterExample/VB/form1.vb" id="Snippet3"::: - + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/IndentedTextWriterExample/VB/form1.vb" id="Snippet3"::: + ]]> @@ -2687,7 +2685,6 @@ Asynchronously writes the line terminator to the underlying . A representing the asynchronous line writing operation. This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as , are still thrown synchronously. For the stored exceptions, see the exceptions thrown by . - @@ -2957,15 +2954,15 @@ The string to write. Writes the specified string to a line without tabs. - diff --git a/xml/System.Collections.Frozen/FrozenDictionary`2.xml b/xml/System.Collections.Frozen/FrozenDictionary`2.xml index ccc77bc4660..6951976384c 100644 --- a/xml/System.Collections.Frozen/FrozenDictionary`2.xml +++ b/xml/System.Collections.Frozen/FrozenDictionary`2.xml @@ -848,7 +848,6 @@ The zero-based index in at which copying begins. Copies the elements of the to an , starting at a particular index. To be added. - @@ -876,7 +875,6 @@ if access to the is synchronized (thread safe); otherwise, . To be added. - @@ -903,7 +901,6 @@ Gets an object that can be used to synchronize access to the . An object that can be used to synchronize access to the . To be added. - @@ -935,7 +932,6 @@ The to use as the value of the element to add. Adds an element with the provided key and value to the object. To be added. - @@ -962,7 +958,6 @@ Removes all elements from the object. To be added. - @@ -994,7 +989,6 @@ if the contains an element with the key; otherwise, . To be added. - @@ -1022,7 +1016,6 @@ Returns an object for the object. An object for the object. To be added. - @@ -1050,7 +1043,6 @@ if the object has a fixed size; otherwise, . To be added. - @@ -1078,7 +1070,6 @@ if the object is read-only; otherwise, . To be added. - @@ -1142,7 +1133,6 @@ Gets an object containing the keys of the object. An object containing the keys of the object. To be added. - @@ -1172,7 +1162,6 @@ The key of the element to remove. Removes the element with the specified key from the object. To be added. - @@ -1199,7 +1188,6 @@ Gets an object containing the values in the object. An object containing the values in the object. To be added. - @@ -1227,7 +1215,6 @@ Returns an enumerator that iterates through a collection. An object that can be used to iterate through the collection. To be added. - diff --git a/xml/System.Collections.Frozen/FrozenSet`1.xml b/xml/System.Collections.Frozen/FrozenSet`1.xml index 5b670cbcaba..7bcd620e9fd 100644 --- a/xml/System.Collections.Frozen/FrozenSet`1.xml +++ b/xml/System.Collections.Frozen/FrozenSet`1.xml @@ -862,7 +862,6 @@ The zero-based index in at which copying begins. Copies the elements of the to an , starting at a particular index. To be added. - @@ -890,7 +889,6 @@ if access to the is synchronized (thread safe); otherwise, . To be added. - @@ -917,7 +915,6 @@ Gets an object that can be used to synchronize access to the . An object that can be used to synchronize access to the . To be added. - @@ -945,7 +942,6 @@ Returns an enumerator that iterates through a collection. An object that can be used to iterate through the collection. To be added. - diff --git a/xml/System.Collections.Generic/OrderedDictionary`2+Enumerator.xml b/xml/System.Collections.Generic/OrderedDictionary`2+Enumerator.xml index b9d4d375995..b7a5555574b 100644 --- a/xml/System.Collections.Generic/OrderedDictionary`2+Enumerator.xml +++ b/xml/System.Collections.Generic/OrderedDictionary`2+Enumerator.xml @@ -130,7 +130,6 @@ Gets both the key and the value of the current dictionary entry. A containing both the key and the value of the current dictionary entry. This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2.Enumerator> instance is cast to an <xref:System.Collections.IDictionaryEnumerator> interface. - diff --git a/xml/System.Collections.Generic/OrderedDictionary`2+KeyCollection.xml b/xml/System.Collections.Generic/OrderedDictionary`2+KeyCollection.xml index a40680a69ab..35d4b96737b 100644 --- a/xml/System.Collections.Generic/OrderedDictionary`2+KeyCollection.xml +++ b/xml/System.Collections.Generic/OrderedDictionary`2+KeyCollection.xml @@ -92,7 +92,6 @@ if is found in the ; otherwise, . To be added. - @@ -123,7 +122,6 @@ The zero-based index in at which copying begins. Copies the elements of the to an , starting at a particular index. To be added. - @@ -151,7 +149,6 @@ Gets the number of elements contained in the . The number of elements contained in the . To be added. - @@ -503,7 +500,6 @@ The zero-based index in at which copying begins. Copies the elements of the to an , starting at a particular index. To be added. - @@ -530,7 +526,6 @@ if access to the is synchronized (thread safe); otherwise, . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2.KeyCollection> instance is cast to an <xref:System.Collections.ICollection> interface. - @@ -562,7 +557,6 @@ Gets an object that can be used to synchronize access to the . An object that can be used to synchronize access to the . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2.KeyCollection> instance is cast to an <xref:System.Collections.ICollection> interface. - @@ -589,7 +583,6 @@ Returns an enumerator that iterates through a collection. An object that can be used to iterate through the collection. This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2.KeyCollection> instance is cast to an <xref:System.Collections.IEnumerable> interface. - @@ -645,7 +638,6 @@ Removes all items from the . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2.KeyCollection> instance is cast to an <xref:System.Collections.IList> interface. - @@ -676,7 +668,6 @@ if the is found in the ; otherwise, . To be added. - @@ -706,7 +697,6 @@ Determines the index of a specific item in the . The index of if found in the list; otherwise, -1. To be added. - @@ -735,9 +725,8 @@ The zero-based index at which should be inserted. The object to insert into the . - Inserts an item to the at the specified index. + Inserts an item into the at the specified index. To be added. - @@ -764,7 +753,6 @@ if the has a fixed size; otherwise, . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2.KeyCollection> instance is cast to an <xref:System.Collections.IList> interface. - @@ -791,7 +779,6 @@ if the is read-only; otherwise, . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2.KeyCollection> instance is cast to an <xref:System.Collections.IList> interface. - @@ -856,7 +843,6 @@ The object to remove from the . Removes the first occurrence of a specific object from the . To be added. - @@ -885,7 +871,6 @@ The zero-based index of the item to remove. Removes the item at the specified index. To be added. - diff --git a/xml/System.Collections.Generic/OrderedDictionary`2+ValueCollection.xml b/xml/System.Collections.Generic/OrderedDictionary`2+ValueCollection.xml index fa362ed2121..f196e230e2b 100644 --- a/xml/System.Collections.Generic/OrderedDictionary`2+ValueCollection.xml +++ b/xml/System.Collections.Generic/OrderedDictionary`2+ValueCollection.xml @@ -92,7 +92,6 @@ The zero-based index in at which copying begins. Copies the elements of the to an , starting at a particular index. To be added. - @@ -120,7 +119,6 @@ Gets the number of elements contained in the . The number of elements contained in the . To be added. - @@ -529,7 +527,6 @@ if access to the is synchronized (thread safe); otherwise, . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2.ValueCollection> instance is cast to an <xref:System.Collections.ICollection> interface. - @@ -561,7 +558,6 @@ Gets an object that can be used to synchronize access to the . An object that can be used to synchronize access to the . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2.ValueCollection> instance is cast to an <xref:System.Collections.ICollection> interface. - @@ -588,7 +584,6 @@ Returns an enumerator that iterates through a collection. An object that can be used to iterate through the collection. This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2.ValueCollection> instance is cast to an <xref:System.Collections.IEnumerable> interface. - @@ -618,7 +613,6 @@ Adds an item to the . The position into which the new element was inserted, or -1 to indicate that the item was not inserted into the collection. To be added. - @@ -644,7 +638,6 @@ Removes all items from the . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2.ValueCollection> instance is cast to an <xref:System.Collections.IList> interface. - @@ -675,7 +668,6 @@ if the is found in the ; otherwise, . To be added. - @@ -705,7 +697,6 @@ Determines the index of a specific item in the . The index of if found in the list; otherwise, -1. To be added. - @@ -736,7 +727,6 @@ The object to insert into the . Inserts an item to the at the specified index. To be added. - @@ -763,7 +753,6 @@ if the has a fixed size; otherwise, . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2.ValueCollection> instance is cast to an <xref:System.Collections.IList> interface. - @@ -790,7 +779,6 @@ if the is read-only; otherwise, . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2.ValueCollection> instance is cast to an <xref:System.Collections.IList> interface. - @@ -855,7 +843,6 @@ The object to remove from the . Removes the first occurrence of a specific object from the . To be added. - @@ -884,7 +871,6 @@ The zero-based index of the item to remove. Removes the item at the specified index. To be added. - diff --git a/xml/System.Collections.Generic/OrderedDictionary`2.xml b/xml/System.Collections.Generic/OrderedDictionary`2.xml index a197d3ea8a7..e4fb81a6cb8 100644 --- a/xml/System.Collections.Generic/OrderedDictionary`2.xml +++ b/xml/System.Collections.Generic/OrderedDictionary`2.xml @@ -1335,7 +1335,6 @@ The zero-based index in at which copying begins. Copies the elements of the to an , starting at a particular index. To be added. - @@ -1362,7 +1361,6 @@ if access to the is synchronized (thread safe); otherwise, . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2> instance is cast to an <xref:System.Collections.ICollection> interface. - @@ -1388,7 +1386,6 @@ Gets an object that can be used to synchronize access to the . An object that can be used to synchronize access to the . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2> instance is cast to an <xref:System.Collections.ICollection> interface. - @@ -1419,7 +1416,6 @@ The to use as the value of the element to add. Adds an element with the provided key and value to the object. To be added. - @@ -1450,7 +1446,6 @@ if the contains an element with the key; otherwise, . To be added. - @@ -1477,7 +1472,6 @@ Returns an object for the object. An object for the object. This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2> instance is cast to an <xref:System.Collections.IDictionary> interface. - @@ -1504,7 +1498,6 @@ if the object has a fixed size; otherwise, . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2> instance is cast to an <xref:System.Collections.IDictionary> interface. - @@ -1531,7 +1524,6 @@ if the object is read-only; otherwise, . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2> instance is cast to an <xref:System.Collections.IDictionary> interface. - @@ -1593,7 +1585,6 @@ Gets an object containing the keys of the object. An object containing the keys of the object. This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2> instance is cast to an <xref:System.Collections.IDictionary> interface. - @@ -1622,7 +1613,6 @@ The key of the element to remove. Removes the element with the specified key from the object. To be added. - @@ -1648,7 +1638,6 @@ Gets an object containing the values in the object. An object containing the values in the object. This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2> instance is cast to an <xref:System.Collections.IDictionary> interface. - @@ -1705,7 +1694,6 @@ Adds an item to the . The position into which the new element was inserted, or -1 to indicate that the item was not inserted into the collection. To be added. - @@ -1736,7 +1724,6 @@ if the is found in the ; otherwise, . To be added. - @@ -1766,7 +1753,6 @@ Determines the index of a specific item in the . The index of if found in the list; otherwise, -1. To be added. - @@ -1797,7 +1783,6 @@ The object to insert into the . Inserts an item to the at the specified index. To be added. - @@ -1824,7 +1809,6 @@ if the has a fixed size; otherwise, . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2> instance is cast to an <xref:System.Collections.IList> interface. - @@ -1851,7 +1835,6 @@ if the is read-only; otherwise, . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.Generic.OrderedDictionary`2> instance is cast to an <xref:System.Collections.IList> interface. - @@ -1916,7 +1899,6 @@ The object to remove from the . Removes the first occurrence of a specific object from the . To be added. - diff --git a/xml/System.Collections.Generic/Queue`1.xml b/xml/System.Collections.Generic/Queue`1.xml index 6e8207e30d8..884cb1135b3 100644 --- a/xml/System.Collections.Generic/Queue`1.xml +++ b/xml/System.Collections.Generic/Queue`1.xml @@ -100,42 +100,42 @@ Specifies the type of elements in the queue. Represents a first-in, first-out collection of objects. - are inserted at one end and removed from the other. Queues and stacks are useful when you need temporary storage for information; that is, when you might want to discard an element after retrieving its value. Use if you need to access the information in the same order that it is stored in the collection. Use if you need to access the information in reverse order. Use or if you need to access the collection from multiple threads concurrently. - - Three main operations can be performed on a and its elements: - -- adds an element to the end of the . - -- removes the oldest element from the start of the . - -- peek returns the oldest element that is at the start of the but does not remove it from the . - - The capacity of a is the number of elements the can hold. As elements are added to a , the capacity is automatically increased as required by reallocating the internal array. The capacity can be decreased by calling . - - accepts `null` as a valid value for reference types and allows duplicate elements. - - - -## Examples - The following code example demonstrates several methods of the generic class. The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. - - The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. - - An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. - - The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. - + are inserted at one end and removed from the other. Queues and stacks are useful when you need temporary storage for information; that is, when you might want to discard an element after retrieving its value. Use if you need to access the information in the same order that it is stored in the collection. Use if you need to access the information in reverse order. Use or if you need to access the collection from multiple threads concurrently. + + Three main operations can be performed on a and its elements: + +- adds an element to the end of the . + +- removes the oldest element from the start of the . + +- peek returns the oldest element that is at the start of the but does not remove it from the . + + The capacity of a is the number of elements the can hold. As elements are added to a , the capacity is automatically increased as required by reallocating the internal array. The capacity can be decreased by calling . + + accepts `null` as a valid value for reference types and allows duplicate elements. + + + +## Examples + The following code example demonstrates several methods of the generic class. The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. + + The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. + + An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. + + The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. + :::code language="csharp" source="~/snippets/csharp/System.Collections.Generic/QueueT/Overview/source.cs" interactive="try-dotnet" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System.Collections.Generic/QueueT/Overview/source.fs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: + ]]> - Public static ( in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe. - + Public static ( in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe. + A can support multiple readers concurrently, as long as the collection is not modified. Even so, enumerating through a collection is intrinsically not a thread-safe procedure. For a thread-safe queue, see . @@ -150,21 +150,21 @@ Initializes a new instance of the class. - generic class. The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. - - The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. - - An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. - - The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. - + generic class. The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. + + The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. + + An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. + + The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. + :::code language="csharp" source="~/snippets/csharp/System.Collections.Generic/QueueT/Overview/source.cs" interactive="try-dotnet" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System.Collections.Generic/QueueT/Overview/source.fs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: + ]]> @@ -205,17 +205,17 @@ Initializes a new instance of the class that is empty and has the default initial capacity. - is the number of elements that the can hold. As elements are added to a , the capacity is automatically increased as required by reallocating the internal array. - - If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the . - - The capacity can be decreased by calling . - - This constructor is an O(1) operation. - + is the number of elements that the can hold. As elements are added to a , the capacity is automatically increased as required by reallocating the internal array. + + If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the . + + The capacity can be decreased by calling . + + This constructor is an O(1) operation. + ]]> @@ -260,19 +260,19 @@ The collection whose elements are copied to the new . Initializes a new instance of the class that contains elements copied from the specified collection and has sufficient capacity to accommodate the number of elements copied. - is the number of elements that the can hold. As elements are added to a , the capacity is automatically increased as required by reallocating the internal array. - - If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the . - - The capacity can be decreased by calling . - - The elements are copied onto the in the same order they are read by the of the collection. - - This constructor is an O(`n`) operation, where `n` is the number of elements in `collection`. - + is the number of elements that the can hold. As elements are added to a , the capacity is automatically increased as required by reallocating the internal array. + + If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the . + + The capacity can be decreased by calling . + + The elements are copied onto the in the same order they are read by the of the collection. + + This constructor is an O(`n`) operation, where `n` is the number of elements in `collection`. + ]]> @@ -319,17 +319,17 @@ The initial number of elements that the can contain. Initializes a new instance of the class that is empty and has the specified initial capacity. - is the number of elements that the can hold. As elements are added to a , the capacity is automatically increased as required by reallocating the internal array. - - If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the . - - The capacity can be decreased by calling . - - This constructor is an O(`n`) operation, where `n` is `capacity`. - + is the number of elements that the can hold. As elements are added to a , the capacity is automatically increased as required by reallocating the internal array. + + If the size of the collection can be estimated, specifying the initial capacity eliminates the need to perform a number of resizing operations while adding elements to the . + + The capacity can be decreased by calling . + + This constructor is an O(`n`) operation, where `n` is `capacity`. + ]]> @@ -404,32 +404,32 @@ Removes all objects from the . - is set to zero, and references to other objects from elements of the collection are also released. - - The capacity remains unchanged. To reset the capacity of the , call . Trimming an empty sets the capacity of the to the default capacity. - - This method is an O(`n`) operation, where `n` is . - - - -## Examples - The following code example demonstrates several methods of the generic class, including the method. - - The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. - - The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. - - An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. - - The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. - + is set to zero, and references to other objects from elements of the collection are also released. + + The capacity remains unchanged. To reset the capacity of the , call . Trimming an empty sets the capacity of the to the default capacity. + + This method is an O(`n`) operation, where `n` is . + + + +## Examples + The following code example demonstrates several methods of the generic class, including the method. + + The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. + + The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. + + An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. + + The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. + :::code language="csharp" source="~/snippets/csharp/System.Collections.Generic/QueueT/Overview/source.cs" interactive="try-dotnet" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System.Collections.Generic/QueueT/Overview/source.fs" id="Snippet1"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: - + ]]> @@ -480,30 +480,30 @@ if is found in the ; otherwise, . - for `T`, the type of values in the queue. - - This method performs a linear search; therefore, this method is an O(`n`) operation, where `n` is . - - - -## Examples - The following code example demonstrates several methods of the generic class, including the method. - - The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. - - The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. - - An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. - - The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. - + for `T`, the type of values in the queue. + + This method performs a linear search; therefore, this method is an O(`n`) operation, where `n` is . + + + +## Examples + The following code example demonstrates several methods of the generic class, including the method. + + The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. + + The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. + + An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. + + The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. + :::code language="csharp" source="~/snippets/csharp/System.Collections.Generic/QueueT/Overview/source.cs" interactive="try-dotnet" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System.Collections.Generic/QueueT/Overview/source.fs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: + ]]> Performing Culture-Insensitive String Operations @@ -554,13 +554,13 @@ The zero-based index in at which copying begins. Copies the elements to an existing one-dimensional , starting at the specified array index. - in the same order in which the enumerator iterates through the . - - This method is an O(`n`) operation, where `n` is . - + in the same order in which the enumerator iterates through the . + + This method is an O(`n`) operation, where `n` is . + ]]> @@ -620,32 +620,32 @@ Gets the number of elements contained in the . The number of elements contained in the . - is the number of elements that the can store. is the number of elements that are actually in the . - - The capacity is always greater than or equal to . If exceeds the capacity while adding elements, the capacity is increased by automatically reallocating the internal array before copying the old elements and adding the new elements. - - Retrieving the value of this property is an O(1) operation. - - - -## Examples - The following code example demonstrates several properties and methods of the generic class, including the property. - - The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. - - The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. - - An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. - - The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. - + is the number of elements that the can store. is the number of elements that are actually in the . + + The capacity is always greater than or equal to . If exceeds the capacity while adding elements, the capacity is increased by automatically reallocating the internal array before copying the old elements and adding the new elements. + + Retrieving the value of this property is an O(1) operation. + + + +## Examples + The following code example demonstrates several properties and methods of the generic class, including the property. + + The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. + + The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. + + An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. + + The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. + :::code language="csharp" source="~/snippets/csharp/System.Collections.Generic/QueueT/Overview/source.cs" interactive="try-dotnet" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System.Collections.Generic/QueueT/Overview/source.fs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: + ]]> @@ -691,32 +691,32 @@ Removes and returns the object at the beginning of the . The object that is removed from the beginning of the . - method, but does not modify the . - - If type `T` is a reference type, `null` can be added to the as a value. - - This method is an O(1) operation. - - - -## Examples - The following code example demonstrates several methods of the generic class, including the method. - - The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. - - The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. - - An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. - - The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. - + method, but does not modify the . + + If type `T` is a reference type, `null` can be added to the as a value. + + This method is an O(1) operation. + + + +## Examples + The following code example demonstrates several methods of the generic class, including the method. + + The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. + + The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. + + An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. + + The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. + :::code language="csharp" source="~/snippets/csharp/System.Collections.Generic/QueueT/Overview/source.cs" interactive="try-dotnet" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System.Collections.Generic/QueueT/Overview/source.fs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: + ]]> The is empty. @@ -767,30 +767,30 @@ The object to add to the . The value can be for reference types. Adds an object to the end of the . - already equals the capacity, the capacity of the is increased by automatically reallocating the internal array, and the existing elements are copied to the new array before the new element is added. - - If is less than the capacity of the internal array, this method is an O(1) operation. If the internal array needs to be reallocated to accommodate the new element, this method becomes an O(`n`) operation, where `n` is . - - - -## Examples - The following code example demonstrates several methods of the generic class, including the method. - - The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. - - The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. - - An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. - - The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. - + already equals the capacity, the capacity of the is increased by automatically reallocating the internal array, and the existing elements are copied to the new array before the new element is added. + + If is less than the capacity of the internal array, this method is an O(1) operation. If the internal array needs to be reallocated to accommodate the new element, this method becomes an O(`n`) operation, where `n` is . + + + +## Examples + The following code example demonstrates several methods of the generic class, including the method. + + The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. + + The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. + + An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. + + The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. + :::code language="csharp" source="~/snippets/csharp/System.Collections.Generic/QueueT/Overview/source.cs" interactive="try-dotnet" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System.Collections.Generic/QueueT/Overview/source.fs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: + ]]> @@ -873,44 +873,44 @@ Returns an enumerator that iterates through the . An for the . - is undefined. Therefore, you must call to advance the enumerator to the first element of the collection before reading the value of . - - returns the same object until is called. sets to the next element. - - If passes the end of the collection, the enumerator is positioned after the last element in the collection and returns `false`. When the enumerator is at this position, subsequent calls to also return `false`. If the last call to returned `false`, is undefined. You cannot set to the first element of the collection again; you must create a new enumerator instance instead. - - An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is irrecoverably invalidated and the next call to or throws an . - - The enumerator does not have exclusive access to the collection; therefore, enumerating through a collection is intrinsically not a thread-safe procedure. To guarantee thread safety during enumeration, you can lock the collection during the entire enumeration. To allow the collection to be accessed by multiple threads for reading and writing, you must implement your own synchronization. - - Default implementations of collections in are not synchronized. - - This method is an O(1) operation. - - - -## Examples - The following code example demonstrates that the generic class is enumerable. The `foreach` statement (`For Each` in Visual Basic, `for each` in C++) is used to enumerate the queue. - - The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. - - The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. - - An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. - - The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. - + is undefined. Therefore, you must call to advance the enumerator to the first element of the collection before reading the value of . + + returns the same object until is called. sets to the next element. + + If passes the end of the collection, the enumerator is positioned after the last element in the collection and returns `false`. When the enumerator is at this position, subsequent calls to also return `false`. If the last call to returned `false`, is undefined. You cannot set to the first element of the collection again; you must create a new enumerator instance instead. + + An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is irrecoverably invalidated and the next call to or throws an . + + The enumerator does not have exclusive access to the collection; therefore, enumerating through a collection is intrinsically not a thread-safe procedure. To guarantee thread safety during enumeration, you can lock the collection during the entire enumeration. To allow the collection to be accessed by multiple threads for reading and writing, you must implement your own synchronization. + + Default implementations of collections in are not synchronized. + + This method is an O(1) operation. + + + +## Examples + The following code example demonstrates that the generic class is enumerable. The `foreach` statement (`For Each` in Visual Basic, `for each` in C++) is used to enumerate the queue. + + The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. + + The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. + + An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. + + The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. + :::code language="csharp" source="~/snippets/csharp/System.Collections.Generic/QueueT/Overview/source.cs" interactive="try-dotnet" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System.Collections.Generic/QueueT/Overview/source.fs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: + ]]> @@ -958,32 +958,32 @@ Returns the object at the beginning of the without removing it. The object at the beginning of the . - method, but does not modify the . - - If type `T` is a reference type, `null` can be added to the as a value. - - This method is an O(1) operation. - - - -## Examples - The following code example demonstrates several methods of the generic class, including the method. - - The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. - - The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. - - An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. - - The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. - + method, but does not modify the . + + If type `T` is a reference type, `null` can be added to the as a value. + + This method is an O(1) operation. + + + +## Examples + The following code example demonstrates several methods of the generic class, including the method. + + The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. + + The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. + + An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. + + The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. + :::code language="csharp" source="~/snippets/csharp/System.Collections.Generic/QueueT/Overview/source.cs" interactive="try-dotnet" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System.Collections.Generic/QueueT/Overview/source.fs" id="Snippet1"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: - + ]]> The is empty. @@ -1035,27 +1035,27 @@ Returns an enumerator that iterates through a collection. An that can be used to iterate through the collection. - is undefined. Therefore, you must call to advance the enumerator to the first element of the collection before reading the value of . - - returns the same object until is called. sets to the next element. - - If passes the end of the collection, the enumerator is positioned after the last element in the collection and returns `false`. When the enumerator is at this position, subsequent calls to also return `false`. If the last call to returned `false`, is undefined. You cannot set to the first element of the collection again; you must create a new enumerator instance instead. - - An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is irrecoverably invalidated and the next call to or throws an . - - The enumerator does not have exclusive access to the collection; therefore, enumerating through a collection is intrinsically not a thread-safe procedure. To guarantee thread safety during enumeration, you can lock the collection during the entire enumeration. To allow the collection to be accessed by multiple threads for reading and writing, you must implement your own synchronization. - - Default implementations of collections in are not synchronized. - - This method is an O(1) operation. - + is undefined. Therefore, you must call to advance the enumerator to the first element of the collection before reading the value of . + + returns the same object until is called. sets to the next element. + + If passes the end of the collection, the enumerator is positioned after the last element in the collection and returns `false`. When the enumerator is at this position, subsequent calls to also return `false`. If the last call to returned `false`, is undefined. You cannot set to the first element of the collection again; you must create a new enumerator instance instead. + + An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is irrecoverably invalidated and the next call to or throws an . + + The enumerator does not have exclusive access to the collection; therefore, enumerating through a collection is intrinsically not a thread-safe procedure. To guarantee thread safety during enumeration, you can lock the collection during the entire enumeration. To allow the collection to be accessed by multiple threads for reading and writing, you must implement your own synchronization. + + Default implementations of collections in are not synchronized. + + This method is an O(1) operation. + ]]> @@ -1111,15 +1111,15 @@ The zero-based index in at which copying begins. Copies the elements of the to an , starting at a particular index. - [!NOTE] -> If the type of the source cannot be cast automatically to the type of the destination `array`, the non-generic implementations of throw , whereas the generic implementations throw . - - This method is an O(`n`) operation, where `n` is . - +> If the type of the source cannot be cast automatically to the type of the destination `array`, the non-generic implementations of throw , whereas the generic implementations throw . + + This method is an O(`n`) operation, where `n` is . + ]]> @@ -1127,18 +1127,18 @@ is less than zero. - is multidimensional. - - -or- - - does not have zero-based indexing. - - -or- - - The number of elements in the source is greater than the available space from to the end of the destination . - - -or- - + is multidimensional. + + -or- + + does not have zero-based indexing. + + -or- + + The number of elements in the source is greater than the available space from to the end of the destination . + + -or- + The type of the source cannot be cast automatically to the type of the destination . @@ -1186,21 +1186,20 @@ if access to the is synchronized (thread safe); otherwise, . In the default implementation of , this property always returns . - are not synchronized. - - Enumerating through a collection is intrinsically not a thread-safe procedure. To guarantee thread safety during enumeration, you can lock the collection during the entire enumeration. To allow the collection to be accessed by multiple threads for reading and writing, you must implement your own synchronization. - - returns an object, which can be used to synchronize access to the . Synchronization is effective only if all threads lock this object before accessing the collection. - - Retrieving the value of this property is an O(1) operation. - + are not synchronized. + + Enumerating through a collection is intrinsically not a thread-safe procedure. To guarantee thread safety during enumeration, you can lock the collection during the entire enumeration. To allow the collection to be accessed by multiple threads for reading and writing, you must implement your own synchronization. + + returns an object, which can be used to synchronize access to the . Synchronization is effective only if all threads lock this object before accessing the collection. + + Retrieving the value of this property is an O(1) operation. + ]]> - @@ -1246,42 +1245,42 @@ Gets an object that can be used to synchronize access to the . An object that can be used to synchronize access to the . In the default implementation of , this property always returns the current instance. - are not synchronized. - - Enumerating through a collection is intrinsically not a thread-safe procedure. To guarantee thread safety during enumeration, you can lock the collection during the entire enumeration. To allow the collection to be accessed by multiple threads for reading and writing, you must implement your own synchronization. - - returns an object, which can be used to synchronize access to the . Synchronization is effective only if all threads lock this object before accessing the collection. The following code shows the use of the property for C#, C++, and Visual Basic. - -```csharp -ICollection ic = ...; -lock (ic.SyncRoot) { - // Access the collection. -} -``` - -```vb -Dim ic As ICollection = ... -SyncLock ic.SyncRoot - ' Access the collection. -End SyncLock -``` - -```cpp -ICollection^ ic = ...; -try { - Monitor::Enter(ic->SyncRoot); - // Access the collection. -} -finally { - Monitor::Exit(ic->SyncRoot); -} -``` - - Retrieving the value of this property is an O(1) operation. - + are not synchronized. + + Enumerating through a collection is intrinsically not a thread-safe procedure. To guarantee thread safety during enumeration, you can lock the collection during the entire enumeration. To allow the collection to be accessed by multiple threads for reading and writing, you must implement your own synchronization. + + returns an object, which can be used to synchronize access to the . Synchronization is effective only if all threads lock this object before accessing the collection. The following code shows the use of the property for C#, C++, and Visual Basic. + +```csharp +ICollection ic = ...; +lock (ic.SyncRoot) { + // Access the collection. +} +``` + +```vb +Dim ic As ICollection = ... +SyncLock ic.SyncRoot + ' Access the collection. +End SyncLock +``` + +```cpp +ICollection^ ic = ...; +try { + Monitor::Enter(ic->SyncRoot); + // Access the collection. +} +finally { + Monitor::Exit(ic->SyncRoot); +} +``` + + Retrieving the value of this property is an O(1) operation. + ]]> @@ -1331,27 +1330,27 @@ finally { Returns an enumerator that iterates through a collection. An that can be used to iterate through the collection. - also brings the enumerator back to this position. At this position, is undefined. Therefore, you must call to advance the enumerator to the first element of the collection before reading the value of . - - returns the same object until either or is called. sets to the next element. - - If passes the end of the collection, the enumerator is positioned after the last element in the collection and returns `false`. When the enumerator is at this position, subsequent calls to also return `false`. If the last call to returned `false`, is undefined. To set to the first element of the collection again, you can call followed by . - - An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is irrecoverably invalidated and the next call to or throws an . - - The enumerator does not have exclusive access to the collection; therefore, enumerating through a collection is intrinsically not a thread-safe procedure. To guarantee thread safety during enumeration, you can lock the collection during the entire enumeration. To allow the collection to be accessed by multiple threads for reading and writing, you must implement your own synchronization. - - Default implementations of collections in are not synchronized. - - This method is an O(1) operation. - + also brings the enumerator back to this position. At this position, is undefined. Therefore, you must call to advance the enumerator to the first element of the collection before reading the value of . + + returns the same object until either or is called. sets to the next element. + + If passes the end of the collection, the enumerator is positioned after the last element in the collection and returns `false`. When the enumerator is at this position, subsequent calls to also return `false`. If the last call to returned `false`, is undefined. To set to the first element of the collection again, you can call followed by . + + An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is irrecoverably invalidated and the next call to or throws an . + + The enumerator does not have exclusive access to the collection; therefore, enumerating through a collection is intrinsically not a thread-safe procedure. To guarantee thread safety during enumeration, you can lock the collection during the entire enumeration. To allow the collection to be accessed by multiple threads for reading and writing, you must implement your own synchronization. + + Default implementations of collections in are not synchronized. + + This method is an O(1) operation. + ]]> @@ -1400,30 +1399,30 @@ finally { Copies the elements to a new array. A new array containing elements copied from the . - is not modified. The order of the elements in the new array is the same as the order of the elements from the beginning of the to its end. - - This method is an O(`n`) operation, where `n` is . - - - -## Examples - The following code example demonstrates several methods of the generic class, including the method. - - The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. - - The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. - - An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. - - The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. - + is not modified. The order of the elements in the new array is the same as the order of the elements from the beginning of the to its end. + + This method is an O(`n`) operation, where `n` is . + + + +## Examples + The following code example demonstrates several methods of the generic class, including the method. + + The code example creates a queue of strings with default capacity and uses the method to queue five strings. The elements of the queue are enumerated, which does not change the state of the queue. The method is used to dequeue the first string. The method is used to look at the next item in the queue, and then the method is used to dequeue it. + + The method is used to create an array and copy the queue elements to it, then the array is passed to the constructor that takes , creating a copy of the queue. The elements of the copy are displayed. + + An array twice the size of the queue is created, and the method is used to copy the array elements beginning at the middle of the array. The constructor is used again to create a second copy of the queue containing three null elements at the beginning. + + The method is used to show that the string "four" is in the first copy of the queue, after which the method clears the copy and the property shows that the queue is empty. + :::code language="csharp" source="~/snippets/csharp/System.Collections.Generic/QueueT/Overview/source.cs" interactive="try-dotnet" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System.Collections.Generic/QueueT/Overview/source.fs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Generic.Queue/vb/source.vb" id="Snippet1"::: + ]]> @@ -1468,15 +1467,15 @@ finally { Sets the capacity to the actual number of elements in the , if that number is less than 90 percent of current capacity. - can be considerable, however, so the method does nothing if the list is at more than 90 percent of capacity. This avoids incurring a large reallocation cost for a relatively small gain. - - This method is an O(`n`) operation, where `n` is . - - To reset a to its initial state, call the method before calling method. Trimming an empty sets the capacity of the to the default capacity. - + can be considerable, however, so the method does nothing if the list is at more than 90 percent of capacity. This avoids incurring a large reallocation cost for a relatively small gain. + + This method is an O(`n`) operation, where `n` is . + + To reset a to its initial state, call the method before calling method. Trimming an empty sets the capacity of the to the default capacity. + ]]> diff --git a/xml/System.Collections.ObjectModel/ReadOnlySet`1.xml b/xml/System.Collections.ObjectModel/ReadOnlySet`1.xml index 3f84cba6df4..246a26cafc4 100644 --- a/xml/System.Collections.ObjectModel/ReadOnlySet`1.xml +++ b/xml/System.Collections.ObjectModel/ReadOnlySet`1.xml @@ -125,7 +125,6 @@ if is found in the ; otherwise, . To be added. - @@ -791,7 +790,6 @@ The zero-based index in at which copying begins. Copies the elements of the to an , starting at a particular index. To be added. - @@ -821,7 +819,6 @@ if access to the is synchronized (thread safe); otherwise, . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.ObjectModel.ReadOnlySet`1> instance is cast to an <xref:System.Collections.ICollection> interface. - @@ -850,7 +847,6 @@ Gets an object that can be used to synchronize access to the . An object that can be used to synchronize access to the . This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.ObjectModel.ReadOnlySet`1> instance is cast to an <xref:System.Collections.ICollection> interface. - @@ -880,7 +876,6 @@ Returns an enumerator that iterates through a collection. An object that can be used to iterate through the collection. This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.ObjectModel.ReadOnlySet`1> instance is cast to an <xref:System.Collections.IEnumerable> interface. - diff --git a/xml/System.ComponentModel/DateOnlyConverter.xml b/xml/System.ComponentModel/DateOnlyConverter.xml index 848572c7bc1..375f6f9eaf3 100644 --- a/xml/System.ComponentModel/DateOnlyConverter.xml +++ b/xml/System.ComponentModel/DateOnlyConverter.xml @@ -83,7 +83,6 @@ if this object can perform the conversion; otherwise, . To be added. - @@ -122,7 +121,6 @@ if this converter can perform the conversion; otherwise, . To be added. - @@ -162,7 +160,6 @@ Converts the given value object to a object. An that represents the converted . To be added. - @@ -204,7 +201,6 @@ Converts the given value object from a object using the arguments. An that represents the converted . To be added. - diff --git a/xml/System.ComponentModel/TimeOnlyConverter.xml b/xml/System.ComponentModel/TimeOnlyConverter.xml index faeff01f7cf..ef30ea206e4 100644 --- a/xml/System.ComponentModel/TimeOnlyConverter.xml +++ b/xml/System.ComponentModel/TimeOnlyConverter.xml @@ -83,7 +83,6 @@ if this object can perform the conversion; otherwise, . To be added. - @@ -122,7 +121,6 @@ if this converter can perform the conversion; otherwise, . To be added. - @@ -162,7 +160,6 @@ Converts the given value object to a object. An that represents the converted . To be added. - @@ -204,7 +201,6 @@ Converts the given value object from a object using the arguments. An that represents the converted . To be added. - diff --git a/xml/System.Net.Http.Headers/HeaderStringValues.xml b/xml/System.Net.Http.Headers/HeaderStringValues.xml index 36ae9cc2244..1ce6b42ecd7 100644 --- a/xml/System.Net.Http.Headers/HeaderStringValues.xml +++ b/xml/System.Net.Http.Headers/HeaderStringValues.xml @@ -160,7 +160,6 @@ This member is an explicit interface member implementation. It can be used only ]]> - diff --git a/xml/System.Net.Http.Headers/HttpHeadersNonValidated.xml b/xml/System.Net.Http.Headers/HttpHeadersNonValidated.xml index 1ece93eca68..7fd01baff6a 100644 --- a/xml/System.Net.Http.Headers/HttpHeadersNonValidated.xml +++ b/xml/System.Net.Http.Headers/HttpHeadersNonValidated.xml @@ -313,7 +313,6 @@ Multiple header values associated with the same header name are considered to be if the collection contains the specified header; otherwise, . To be added. - @@ -380,7 +379,6 @@ This member is an explicit interface member implementation. It can be used only ]]> - diff --git a/xml/System.Net.Quic/QuicStream.xml b/xml/System.Net.Quic/QuicStream.xml index d0d08f30b23..94b87ee9aca 100644 --- a/xml/System.Net.Quic/QuicStream.xml +++ b/xml/System.Net.Quic/QuicStream.xml @@ -119,7 +119,6 @@ Corresponds to [STOP_SENDING](https://www.rfc-editor.org/rfc/rfc9000.html#frame- Begins an asynchronous read operation. (Consider using instead.) An that represents the asynchronous read, which could still be pending. To be added. - @@ -170,7 +169,6 @@ Corresponds to [STOP_SENDING](https://www.rfc-editor.org/rfc/rfc9000.html#frame- Begins an asynchronous write operation. (Consider using instead.) An that represents the asynchronous write, which could still be pending. To be added. - @@ -222,7 +220,6 @@ Corresponds to [STOP_SENDING](https://www.rfc-editor.org/rfc/rfc9000.html#frame- if the stream supports seeking; otherwise, . To be added. - @@ -248,7 +245,6 @@ Corresponds to [STOP_SENDING](https://www.rfc-editor.org/rfc/rfc9000.html#frame- if the current stream can time out; otherwise, . To be added. - @@ -274,7 +270,6 @@ Corresponds to [STOP_SENDING](https://www.rfc-editor.org/rfc/rfc9000.html#frame- if the stream supports writing; otherwise, . To be added. - @@ -391,7 +386,6 @@ Equivalent to using The number of bytes read from the stream, between zero (0) and the number of bytes requested. ReadAsync returns zero (0) only if zero bytes were requested or if no more bytes will be available because it's at the end of the stream; otherwise, read operations do not complete until at least one byte is available. If zero bytes are requested, read operations may complete immediately or may not complete until at least one byte is available (but without consuming any data). - @@ -419,7 +413,6 @@ Equivalent to using A reference to the outstanding asynchronous I/O request. Ends an asynchronous write operation. (Consider using instead.) To be added. - @@ -472,7 +465,6 @@ Equivalent to using Asynchronously clears all buffers for this stream, causes any buffered data to be written to the underlying device, and monitors cancellation requests. A task that represents the asynchronous flush operation. To be added. - The cancellation token was canceled. This exception is stored into the returned task. @@ -523,7 +515,6 @@ Equivalent to using Gets the length of the data available on the stream. This property is not currently supported and always throws a . A long value representing the length of the stream in bytes. To be added. - In all cases. @@ -549,7 +540,6 @@ Equivalent to using Gets or sets the position within the current stream. This property is not currently supported and always throws a . The current position within the stream. To be added. - In all cases. @@ -642,7 +632,6 @@ Equivalent to using Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests. A task that represents the asynchronous read operation. The value of its property contains the total number of bytes read into the buffer. The result value can be less than the length of the buffer if that many bytes are not currently available, or it can be 0 (zero) if the length of the buffer is 0 or if the end of the stream has been reached. - The cancellation token was canceled. This exception is stored into the returned task. @@ -677,7 +666,6 @@ Equivalent to using Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests. A task that represents the asynchronous read operation. The value of the property contains the total number of bytes read into the buffer. The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if is 0 or if the end of the stream has been reached. - The cancellation token was canceled. This exception is stored into the returned task. @@ -704,7 +692,6 @@ Equivalent to using Reads a byte from the stream and advances the position within the stream by one byte, or returns -1 if at the end of the stream. The unsigned byte cast to an , or -1 if at the end of the stream. To be added. - @@ -784,7 +771,6 @@ Equivalent to using Sets the current position of the stream to the given value. This method is not currently supported and always throws a . The new position within the current stream. To be added. - In all cases. @@ -813,7 +799,6 @@ Equivalent to using The desired length of the current stream in bytes. Sets the length of the stream. This method is not currently supported and always throws a . To be added. - In all cases. @@ -954,7 +939,6 @@ Equivalent to using Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests. A task that represents the asynchronous write operation. To be added. - The cancellation token was canceled. This exception is stored into the returned task. @@ -988,7 +972,6 @@ Equivalent to using Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests. A task that represents the asynchronous write operation. To be added. - The cancellation token was canceled. This exception is stored into the returned task. @@ -1023,7 +1006,6 @@ Equivalent to using Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests. A task that represents the asynchronous write operation. To be added. - The cancellation token was canceled. This exception is stored into the returned task. @@ -1052,7 +1034,6 @@ Equivalent to using The byte to write to the stream. Writes a byte to the current position in the stream and advances the position within the stream by one byte. To be added. - diff --git a/xml/System.Numerics/BigInteger.xml b/xml/System.Numerics/BigInteger.xml index 102aec0050f..07e24014d96 100644 --- a/xml/System.Numerics/BigInteger.xml +++ b/xml/System.Numerics/BigInteger.xml @@ -9774,7 +9774,6 @@ The following example calls the Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System.Numerics/Vector2.xml b/xml/System.Numerics/Vector2.xml index 0a66c17d54a..32d75d42502 100644 --- a/xml/System.Numerics/Vector2.xml +++ b/xml/System.Numerics/Vector2.xml @@ -55,13 +55,13 @@ Represents a vector with two single-precision floating-point values. - structure provides support for hardware acceleration. - [!INCLUDE[vectors-are-rows-paragraph](~/includes/system-numerics-vectors-are-rows.md)] - + [!INCLUDE[vectors-are-rows-paragraph](~/includes/system-numerics-vectors-are-rows.md)] + ]]> @@ -767,11 +767,11 @@ The destination array. Copies the elements of the vector to a specified array. - @@ -877,21 +877,21 @@ The index at which to copy the first element of the vector. Copies the elements of the vector to a specified array starting at a specified index position. - is . The number of elements in the current instance is greater than in the array. - is less than zero. - - -or- - + is less than zero. + + -or- + is greater than or equal to the array length. is multidimensional. @@ -1439,10 +1439,9 @@ System.Numerics.Vector2 - Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.E)). + Gets a vector whose elements are equal to . + A vector whose elements are equal to (that is, it returns the vector Create(float.E)). To be added. - @@ -1468,10 +1467,9 @@ System.Numerics.Vector2 - Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.Epsilon)). + Gets a vector whose elements are equal to . + A vector whose elements are equal to (that is, it returns the vector Create(float.Epsilon)). To be added. - @@ -1541,11 +1539,11 @@ if the two vectors are equal; otherwise, . - and elements are equal. - + and elements are equal. + ]]> @@ -1611,11 +1609,11 @@ if the current instance and are equal; otherwise, . If is , the method returns . - object and their and elements are equal. - + object and their and elements are equal. + ]]> @@ -2747,11 +2745,11 @@ Returns the length of the vector squared. The vector's length squared. - method. - + method. + ]]> @@ -2843,12 +2841,12 @@ Performs a linear interpolation between two vectors based on the given weighting. The interpolated vector. - @@ -3908,10 +3906,9 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi System.Numerics.Vector2 - Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.NaN)). + Gets a vector whose elements are equal to . + A vector whose elements are equal to (that is, it returns the vector Create(float.NaN)). To be added. - @@ -3984,10 +3981,9 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi System.Numerics.Vector2 - Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.NegativeInfinity)). + Gets a vector whose elements are equal to . + A vector whose elements are equal to (that is, it returns the vector Create(float.NegativeInfinity)). To be added. - @@ -4013,10 +4009,9 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi System.Numerics.Vector2 - Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.NegativeZero)). + Gets a vector whose elements are equal to . + A vector whose elements are equal to (that is, it returns the vector Create(float.NegativeZero)). To be added. - @@ -4252,11 +4247,11 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi Adds two vectors together. The summed vector. - method defines the addition operation for objects. - + method defines the addition operation for objects. + ]]> @@ -4385,11 +4380,11 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi Divides the first vector by the second. The vector that results from dividing by . - method defines the division operation for objects. - + method defines the division operation for objects. + ]]> @@ -4441,11 +4436,11 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi Divides the specified vector by a specified scalar value. The result of the division. - method defines the division operation for objects. - + method defines the division operation for objects. + ]]> @@ -4498,11 +4493,11 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi if and are equal; otherwise, . - objects are equal if each value in `left` is equal to the corresponding value in `right`. - + objects are equal if each value in `left` is equal to the corresponding value in `right`. + ]]> @@ -4681,11 +4676,11 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi Returns a new vector whose values are the product of each pair of elements in two specified vectors. The element-wise product vector. - method defines the multiplication operation for objects. - + method defines the multiplication operation for objects. + ]]> @@ -4737,11 +4732,11 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi Multiples the specified vector by the specified scalar value. The scaled vector. - method defines the multiplication operation for objects. - + method defines the multiplication operation for objects. + ]]> @@ -4793,11 +4788,11 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi Multiples the scalar value by the specified vector. The scaled vector. - method defines the multiplication operation for objects. - + method defines the multiplication operation for objects. + ]]> @@ -4913,11 +4908,11 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi Subtracts the second vector from the first. The vector that results from subtracting from . - method defines the subtraction operation for objects. - + method defines the subtraction operation for objects. + ]]> @@ -4967,11 +4962,11 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi Negates the specified vector. The negated vector. - method defines the unary negation operation for objects. - + method defines the unary negation operation for objects. + ]]> @@ -5063,10 +5058,9 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi System.Numerics.Vector2 - Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.Pi)). + Gets a vector whose elements are equal to . + A vector whose elements are equal to (that is, it returns the vector Create(float.Pi)). To be added. - @@ -5092,10 +5086,9 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi System.Numerics.Vector2 - Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.PositiveInfinity)). + Gets a vector whose elements are equal to . + A vector whose elements are equal to (that is, it returns the vector Create(float.PositiveInfinity)). To be added. - @@ -5505,10 +5498,9 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi System.Numerics.Vector2 - Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.Tau)). + Gets a vector whose elements are equal to . + A vector whose elements are equal to (that is, it returns the vector Create(float.Tau)). To be added. - @@ -5571,11 +5563,11 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi Returns the string representation of the current instance using default formatting. The string representation of the current instance. - " characters are used to begin and end the string, and the current culture's property followed by a space is used to separate each element. - + " characters are used to begin and end the string, and the current culture's property followed by a space is used to separate each element. + ]]> @@ -5644,11 +5636,11 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi Returns the string representation of the current instance using the specified format string to format individual elements. The string representation of the current instance. - " characters are used to begin and end the string, and the current culture's property followed by a space is used to separate each element. - + " characters are used to begin and end the string, and the current culture's property followed by a space is used to separate each element. + ]]> Standard Numeric Format Strings @@ -5720,11 +5712,11 @@ The behavior of this method changed in .NET 5. For more information, see [Behavi Returns the string representation of the current instance using the specified format string to format individual elements and the specified format provider to define culture-specific formatting. The string representation of the current instance. - " characters are used to begin and end the string, and the format provider's property followed by a space is used to separate each element. - + " characters are used to begin and end the string, and the format provider's property followed by a space is used to separate each element. + ]]> Custom Numeric Format Strings diff --git a/xml/System.Numerics/Vector3.xml b/xml/System.Numerics/Vector3.xml index 3664db363a8..9a9d1b0012a 100644 --- a/xml/System.Numerics/Vector3.xml +++ b/xml/System.Numerics/Vector3.xml @@ -55,13 +55,13 @@ Represents a vector with three single-precision floating-point values. - structure provides support for hardware acceleration. + structure provides support for hardware acceleration. + + [!INCLUDE[vectors-are-rows-paragraph](~/includes/system-numerics-vectors-are-rows.md)] - [!INCLUDE[vectors-are-rows-paragraph](~/includes/system-numerics-vectors-are-rows.md)] - ]]> @@ -814,11 +814,11 @@ The destination array. Copies the elements of the vector to a specified array. - @@ -924,21 +924,21 @@ The index at which to copy the first element of the vector. Copies the elements of the vector to a specified array starting at a specified index position. - is . The number of elements in the current instance is greater than in the array. - is less than zero. - - -or- - + is less than zero. + + -or- + is greater than or equal to the array length. is multidimensional. @@ -1539,9 +1539,8 @@ Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.E)). + A vector whose elements are equal to (that is, it returns the vector Create(float.E)). To be added. - @@ -1568,9 +1567,8 @@ Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.Epsilon)). + A vector whose elements are equal to (that is, it returns the vector Create(float.Epsilon)). To be added. - @@ -1640,11 +1638,11 @@ if the two vectors are equal; otherwise, . - , , and elements are equal. - + , , and elements are equal. + ]]> @@ -1710,11 +1708,11 @@ if the current instance and are equal; otherwise, . If is , the method returns . - object and their corresponding elements are equal. - + object and their corresponding elements are equal. + ]]> @@ -2846,11 +2844,11 @@ Returns the length of the vector squared. The vector's length squared. - method. - + method. + ]]> @@ -4000,9 +3998,8 @@ Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.NaN)). + A vector whose elements are equal to (that is, it returns the vector Create(float.NaN)). To be added. - @@ -4076,9 +4073,8 @@ Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.NegativeInfinity)). + A vector whose elements are equal to (that is, it returns the vector Create(float.NegativeInfinity)). To be added. - @@ -4105,9 +4101,8 @@ Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.NegativeZero)). + A vector whose elements are equal to (that is, it returns the vector Create(float.NegativeZero)). To be added. - @@ -4343,11 +4338,11 @@ Adds two vectors together. The summed vector. - method defines the addition operation for objects. - + method defines the addition operation for objects. + ]]> @@ -4476,11 +4471,11 @@ Divides the first vector by the second. The vector that results from dividing by . - method defines the division operation for objects. - + method defines the division operation for objects. + ]]> @@ -4532,11 +4527,11 @@ Divides the specified vector by a specified scalar value. The result of the division. - method defines the division operation for objects. - + method defines the division operation for objects. + ]]> @@ -4589,11 +4584,11 @@ if and are equal; otherwise, . - objects are equal if each element in `left` is equal to the corresponding element in `right`. - + objects are equal if each element in `left` is equal to the corresponding element in `right`. + ]]> @@ -4772,11 +4767,11 @@ Returns a new vector whose values are the product of each pair of elements in two specified vectors. The element-wise product vector. - method defines the multiplication operation for objects. - + method defines the multiplication operation for objects. + ]]> @@ -4828,11 +4823,11 @@ Multiples the specified vector by the specified scalar value. The scaled vector. - method defines the multiplication operation for objects. - + method defines the multiplication operation for objects. + ]]> @@ -4884,11 +4879,11 @@ Multiples the scalar value by the specified vector. The scaled vector. - method defines the multiplication operation for objects. - + method defines the multiplication operation for objects. + ]]> @@ -5004,11 +4999,11 @@ Subtracts the second vector from the first. The vector that results from subtracting from . - method defines the subtraction operation for objects. - + method defines the subtraction operation for objects. + ]]> @@ -5058,11 +5053,11 @@ Negates the specified vector. The negated vector. - method defines the unary negation operation for objects. - + method defines the unary negation operation for objects. + ]]> @@ -5155,9 +5150,8 @@ Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.Pi)). + A vector whose elements are equal to (that is, it returns the vector Create(float.Pi)). To be added. - @@ -5184,9 +5178,8 @@ Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.PositiveInfinity)). + A vector whose elements are equal to (that is, it returns the vector Create(float.PositiveInfinity)). To be added. - @@ -5599,9 +5592,8 @@ Gets a vector whose elements are equal to . - A vector whose elements are equal to (that is, it returns the vector Create(float.Tau)). + A vector whose elements are equal to (that is, it returns the vector Create(float.Tau)). To be added. - @@ -5664,11 +5656,11 @@ Returns the string representation of the current instance using default formatting. The string representation of the current instance. - " characters are used to begin and end the string, and the current culture's property followed by a space is used to separate each element. - + " characters are used to begin and end the string, and the current culture's property followed by a space is used to separate each element. + ]]> @@ -5737,11 +5729,11 @@ Returns the string representation of the current instance using the specified format string to format individual elements. The string representation of the current instance. - " characters are used to begin and end the string, and the current culture's property followed by a space is used to separate each element. - + " characters are used to begin and end the string, and the current culture's property followed by a space is used to separate each element. + ]]> Standard Numeric Format Strings @@ -5813,11 +5805,11 @@ Returns the string representation of the current instance using the specified format string to format individual elements and the specified format provider to define culture-specific formatting. The string representation of the current instance. - " characters are used to begin and end the string, and the format provider's property followed by a space is used to separate each element. - + " characters are used to begin and end the string, and the format provider's property followed by a space is used to separate each element. + ]]> Standard Numeric Format Strings diff --git a/xml/System.Reflection.Emit/EnumBuilder.xml b/xml/System.Reflection.Emit/EnumBuilder.xml index 9407747e51a..35e5c672a7f 100644 --- a/xml/System.Reflection.Emit/EnumBuilder.xml +++ b/xml/System.Reflection.Emit/EnumBuilder.xml @@ -879,7 +879,6 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr When overridden in a derived class, implements the property and gets a bitwise combination of enumeration values that indicate the attributes associated with the . A object representing the attribute set of the . To be added. - @@ -960,7 +959,6 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr When overridden in a derived class, searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention. A object representing the constructor that matches the specified requirements, if found; otherwise, . To be added. - @@ -2031,7 +2029,6 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr When overridden in a derived class, searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention. An object representing the method that matches the specified requirements, if found; otherwise, . To be added. - @@ -2462,7 +2459,6 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr if the is an array, a pointer, or is passed by reference; otherwise, . To be added. - @@ -2598,7 +2594,6 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr if the is an array; otherwise, . To be added. - @@ -2689,7 +2684,6 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr if the is passed by reference; otherwise, . To be added. - @@ -2723,7 +2717,6 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr if the is a byref-like structure; otherwise, . To be added. - @@ -3015,7 +3008,6 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr if the is a pointer; otherwise, . To be added. - @@ -3059,7 +3051,6 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr if the is one of the primitive types; otherwise, . To be added. - @@ -3121,7 +3112,6 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr if the current is an array type that can represent only a single-dimensional array with a zero lower bound; otherwise, . To be added. - @@ -3156,7 +3146,6 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr if the current is a type definition; otherwise, . To be added. - @@ -3200,7 +3189,6 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr if the is a value type; otherwise, . To be added. - diff --git a/xml/System.Reflection.Emit/GenericTypeParameterBuilder.xml b/xml/System.Reflection.Emit/GenericTypeParameterBuilder.xml index fadd092d8e2..432ae0f28f0 100644 --- a/xml/System.Reflection.Emit/GenericTypeParameterBuilder.xml +++ b/xml/System.Reflection.Emit/GenericTypeParameterBuilder.xml @@ -723,7 +723,6 @@ When overridden in a derived class, implements the property and gets a bitwise combination of enumeration values that indicate the attributes associated with the . A object representing the attribute set of the . To be added. - @@ -2300,7 +2299,6 @@ if the is an array, a pointer, or is passed by reference; otherwise, . To be added. - @@ -2440,7 +2438,6 @@ if the is an array; otherwise, . To be added. - @@ -2606,7 +2603,6 @@ if the is passed by reference; otherwise, . To be added. - @@ -2640,7 +2636,6 @@ if the is a byref-like structure; otherwise, . To be added. - @@ -2683,7 +2678,6 @@ if the is a COM object; otherwise, . To be added. - @@ -2983,7 +2977,6 @@ if the is a pointer; otherwise, . To be added. - @@ -3026,7 +3019,6 @@ if the is one of the primitive types; otherwise, . To be added. - @@ -3146,7 +3138,6 @@ if the current is an array type that can represent only a single-dimensional array with a zero lower bound; otherwise, . To be added. - @@ -3181,7 +3172,6 @@ if the current is a type definition; otherwise, . To be added. - @@ -3224,7 +3214,6 @@ if the is a value type; otherwise, . To be added. - diff --git a/xml/System.Reflection.Emit/TypeBuilder.xml b/xml/System.Reflection.Emit/TypeBuilder.xml index 7034b67e3d6..5e9160077b3 100644 --- a/xml/System.Reflection.Emit/TypeBuilder.xml +++ b/xml/System.Reflection.Emit/TypeBuilder.xml @@ -4623,7 +4623,6 @@ See for a description of the format of the When overridden in a derived class, implements the property and gets a bitwise combination of enumeration values that indicate the attributes associated with the . A object representing the attribute set of the . To be added. - @@ -4787,7 +4786,6 @@ See for a description of the format of the When overridden in a derived class, searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention. A object representing the constructor that matches the specified requirements, if found; otherwise, . To be added. - @@ -6067,7 +6065,6 @@ See for a description of the format of the When overridden in a derived class, searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention. An object representing the method that matches the specified requirements, if found; otherwise, . To be added. - @@ -6413,7 +6410,6 @@ See for a description of the format of the When overridden in a derived class, searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints. An object representing the property that matches the specified requirements, if found; otherwise, . To be added. - @@ -6506,7 +6502,6 @@ See for a description of the format of the if the is an array, a pointer, or is passed by reference; otherwise, . To be added. - @@ -6649,7 +6644,6 @@ See for a description of the format of the if the is an array; otherwise, . To be added. - @@ -6803,7 +6797,6 @@ See for a description of the format of the if the is passed by reference; otherwise, . To be added. - @@ -6837,7 +6830,6 @@ See for a description of the format of the if the is a byref-like structure; otherwise, . To be added. - @@ -6881,7 +6873,6 @@ See for a description of the format of the if the is a COM object; otherwise, . To be added. - @@ -7295,7 +7286,6 @@ See for a description of the format of the if the is a pointer; otherwise, . To be added. - @@ -7339,7 +7329,6 @@ See for a description of the format of the if the is one of the primitive types; otherwise, . To be added. - diff --git a/xml/System.Runtime.InteropServices.Marshalling/ComExposedClassAttribute`1.xml b/xml/System.Runtime.InteropServices.Marshalling/ComExposedClassAttribute`1.xml index 65aa7505f10..2cdeb023ad4 100644 --- a/xml/System.Runtime.InteropServices.Marshalling/ComExposedClassAttribute`1.xml +++ b/xml/System.Runtime.InteropServices.Marshalling/ComExposedClassAttribute`1.xml @@ -88,7 +88,6 @@ Gets the COM interface information to provide to a instance to expose this type to COM. The interface entry information for the interfaces the type implements. To be added. - diff --git a/xml/System.Runtime.InteropServices.Marshalling/StrategyBasedComWrappers.xml b/xml/System.Runtime.InteropServices.Marshalling/StrategyBasedComWrappers.xml index 9f8905ff053..7769bb20c9f 100644 --- a/xml/System.Runtime.InteropServices.Marshalling/StrategyBasedComWrappers.xml +++ b/xml/System.Runtime.InteropServices.Marshalling/StrategyBasedComWrappers.xml @@ -85,7 +85,6 @@ pointer containing memory for all COM interface entries. To be added. - @@ -186,7 +185,7 @@ Gets the default strategy to discover interface details about COM interfaces. To be added. - This strategy can discover interfaces and classes that use source-generated COM interop that use the and attributes. + This strategy can discover interfaces and classes that use source-generated COM interop that use the and attributes. This strategy looks for an or attribute on the type of the provided object to discover COM type information. diff --git a/xml/System.Runtime.InteropServices/NFloat.xml b/xml/System.Runtime.InteropServices/NFloat.xml index a611a55a449..21042cfa4b4 100644 --- a/xml/System.Runtime.InteropServices/NFloat.xml +++ b/xml/System.Runtime.InteropServices/NFloat.xml @@ -5511,7 +5511,6 @@ For this method matches the IEEE 754:2 Rounds a value to the nearest integer using the default rounding mode (). The result of rounding to the nearest integer using the default rounding mode. To be added. - @@ -5545,7 +5544,6 @@ For this method matches the IEEE 754:2 Rounds a value to a specified number of fractional-digits using the default rounding mode (). The result of rounding to fractional-digits using the default rounding mode. To be added. - @@ -5579,7 +5577,6 @@ For this method matches the IEEE 754:2 Rounds a value to the nearest integer using the specified rounding mode. The result of rounding to the nearest integer using . To be added. - @@ -5689,7 +5686,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -6259,7 +6255,6 @@ This computes `sin(x * π)`. Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - @@ -6346,7 +6341,6 @@ This computes `sin(x * π)`. Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System.Security.Cryptography.X509Certificates/X509AuthorityInformationAccessExtension.xml b/xml/System.Security.Cryptography.X509Certificates/X509AuthorityInformationAccessExtension.xml index 5515dabcc44..a961a523bd6 100644 --- a/xml/System.Security.Cryptography.X509Certificates/X509AuthorityInformationAccessExtension.xml +++ b/xml/System.Security.Cryptography.X509Certificates/X509AuthorityInformationAccessExtension.xml @@ -177,7 +177,6 @@ The to be copied. Copies the extension properties of the specified object. To be added. - diff --git a/xml/System.Security.Cryptography.X509Certificates/X509AuthorityKeyIdentifierExtension.xml b/xml/System.Security.Cryptography.X509Certificates/X509AuthorityKeyIdentifierExtension.xml index b31445fd94f..97cadf840f8 100644 --- a/xml/System.Security.Cryptography.X509Certificates/X509AuthorityKeyIdentifierExtension.xml +++ b/xml/System.Security.Cryptography.X509Certificates/X509AuthorityKeyIdentifierExtension.xml @@ -124,7 +124,6 @@ The to be copied. Copies the extension properties of the specified object. To be added. - diff --git a/xml/System.Security.Cryptography.X509Certificates/X509SubjectAlternativeNameExtension.xml b/xml/System.Security.Cryptography.X509Certificates/X509SubjectAlternativeNameExtension.xml index 4160a9a5fb6..49f33ecd9f6 100644 --- a/xml/System.Security.Cryptography.X509Certificates/X509SubjectAlternativeNameExtension.xml +++ b/xml/System.Security.Cryptography.X509Certificates/X509SubjectAlternativeNameExtension.xml @@ -130,7 +130,6 @@ The to be copied. Copies the extension properties of the specified object. To be added. - diff --git a/xml/System.Security.Cryptography/CryptoStream.xml b/xml/System.Security.Cryptography/CryptoStream.xml index 3c9ead8a98c..69d99cce58d 100644 --- a/xml/System.Security.Cryptography/CryptoStream.xml +++ b/xml/System.Security.Cryptography/CryptoStream.xml @@ -700,7 +700,6 @@ This method stores in the task it returns all non-usage exceptions that the meth Either the current stream or the destination stream is disposed. The current stream does not support reading, or the destination stream does not support writing. An error occurred during a cryptographic operation. - The cancellation token was canceled. This exception is stored into the returned task. @@ -1433,7 +1432,6 @@ This property exists only to support inheritance from , a Starting in .NET 6, this method might not read as many bytes as were requested. For more information, see Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream. The associated with the current object does not match the underlying stream. For example, this exception is thrown when using with an underlying stream that's write only. The cancellation token was canceled. This exception is stored into the returned task. - @@ -1813,7 +1811,6 @@ This member is an explicit interface member implementation. It can be used only To be added. The associated with current object does not match the underlying stream. For example, this exception is thrown when using with an underlying stream that is read only. The cancellation token was canceled. This exception is stored into the returned task. - diff --git a/xml/System.Security.Cryptography/HMACSHA3_256.xml b/xml/System.Security.Cryptography/HMACSHA3_256.xml index f0a4b4ad5c9..a5cd4f06c0b 100644 --- a/xml/System.Security.Cryptography/HMACSHA3_256.xml +++ b/xml/System.Security.Cryptography/HMACSHA3_256.xml @@ -101,7 +101,6 @@ to release both managed and unmanaged resources; to release only unmanaged resources. Releases the unmanaged resources used by the class when a key change is legitimate and optionally releases the managed resources. To be added. - @@ -618,7 +617,6 @@ Initializes an instance of the default implementation of . To be added. - diff --git a/xml/System.Security.Cryptography/HMACSHA3_384.xml b/xml/System.Security.Cryptography/HMACSHA3_384.xml index a9e3ada87c8..a455bf23a72 100644 --- a/xml/System.Security.Cryptography/HMACSHA3_384.xml +++ b/xml/System.Security.Cryptography/HMACSHA3_384.xml @@ -101,7 +101,6 @@ to release both managed and unmanaged resources; to release only unmanaged resources. Releases the unmanaged resources used by the class when a key change is legitimate and optionally releases the managed resources. To be added. - @@ -618,7 +617,6 @@ Initializes an instance of the default implementation of . To be added. - diff --git a/xml/System.Security.Cryptography/HMACSHA3_512.xml b/xml/System.Security.Cryptography/HMACSHA3_512.xml index 71662d5e80d..9b9a0e801e2 100644 --- a/xml/System.Security.Cryptography/HMACSHA3_512.xml +++ b/xml/System.Security.Cryptography/HMACSHA3_512.xml @@ -101,7 +101,6 @@ to release both managed and unmanaged resources; to release only unmanaged resources. Releases the unmanaged resources used by the class when a key change is legitimate and optionally releases the managed resources. To be added. - @@ -618,7 +617,6 @@ Initializes an instance of the default implementation of . To be added. - diff --git a/xml/System.Text.Json.Nodes/JsonArray.xml b/xml/System.Text.Json.Nodes/JsonArray.xml index 080e4b21278..a48356b82b6 100644 --- a/xml/System.Text.Json.Nodes/JsonArray.xml +++ b/xml/System.Text.Json.Nodes/JsonArray.xml @@ -838,7 +838,6 @@ This member is an explicit interface member implementation. It can be used only Writes the into the provided as JSON. To be added. The parameter is . - diff --git a/xml/System.Text.Json.Nodes/JsonObject.xml b/xml/System.Text.Json.Nodes/JsonObject.xml index a2e4083ba7a..e4027735bde 100644 --- a/xml/System.Text.Json.Nodes/JsonObject.xml +++ b/xml/System.Text.Json.Nodes/JsonObject.xml @@ -1077,7 +1077,6 @@ This member is an explicit interface member implementation. It can be used only Writes the into the provided as JSON. To be added. The parameter is . - diff --git a/xml/System.Text.Json/JsonDocument.xml b/xml/System.Text.Json/JsonDocument.xml index 84f4034f377..73ead6ac75e 100644 --- a/xml/System.Text.Json/JsonDocument.xml +++ b/xml/System.Text.Json/JsonDocument.xml @@ -66,7 +66,6 @@ For more information, see [How to use the JSON DOM, Utf8JsonReader, and Utf8Json Releases the resources used by this instance. To be added. - diff --git a/xml/System.Text.Json/JsonElement+ArrayEnumerator.xml b/xml/System.Text.Json/JsonElement+ArrayEnumerator.xml index 9c5cfb81b33..f7cad2a3621 100644 --- a/xml/System.Text.Json/JsonElement+ArrayEnumerator.xml +++ b/xml/System.Text.Json/JsonElement+ArrayEnumerator.xml @@ -109,7 +109,6 @@ Releases the resources used by this instance. To be added. - @@ -237,15 +236,14 @@ Returns an enumerator that iterates through a collection. An enumerator for an array of that can be used to iterate through the collection. - instance is cast to an [IEnumerable\]( instance is cast to an [IEnumerable\]( - @@ -278,11 +276,11 @@ This member is an explicit interface member implementation. It can be used only Returns an enumerator that iterates through a collection. An enumerator that can be used to iterate through the collection. - instance is cast to an interface. +This member is an explicit interface member implementation. It can be used only when the instance is cast to an interface. ]]> diff --git a/xml/System.Text.Json/JsonElement+ObjectEnumerator.xml b/xml/System.Text.Json/JsonElement+ObjectEnumerator.xml index 59e24082ceb..4d19496c6af 100644 --- a/xml/System.Text.Json/JsonElement+ObjectEnumerator.xml +++ b/xml/System.Text.Json/JsonElement+ObjectEnumerator.xml @@ -109,7 +109,6 @@ Releases the resources used by this instance. To be added. - @@ -245,13 +244,12 @@ The enumerator will enumerate the properties in the order they are declared, and Returns an enumerator that iterates through a collection. An enumerator for objects that can be used to iterate through the collection. - instance is cast to an [IEnumerator\](xref:System.Collections.Generic.IEnumerator%601) interface. ]]> - @@ -284,7 +282,7 @@ This member is an explicit interface member implementation. It can be used only Returns an enumerator that iterates through a collection. An enumerator that can be used to iterate through the collection. - instance is cast to an interface. diff --git a/xml/System.Threading.Tasks/Task.xml b/xml/System.Threading.Tasks/Task.xml index b8812b8ed90..06a5c59e5da 100644 --- a/xml/System.Threading.Tasks/Task.xml +++ b/xml/System.Threading.Tasks/Task.xml @@ -7403,7 +7403,6 @@ The returned task will complete when any of the supplied tasks has completed. T To be added. To be added. To be added. - @@ -7455,7 +7454,6 @@ The returned task will complete when any of the supplied tasks has completed. T To be added. To be added. To be added. - @@ -7548,7 +7546,6 @@ The returned task will complete when any of the supplied tasks has completed. T To be added. To be added. To be added. - @@ -7611,7 +7608,6 @@ The returned task will complete when any of the supplied tasks has completed. T To be added. To be added. To be added. - @@ -7665,7 +7661,6 @@ The returned task will complete when any of the supplied tasks has completed. T To be added. To be added. To be added. - diff --git a/xml/System.Xml/XmlProcessingInstruction.xml b/xml/System.Xml/XmlProcessingInstruction.xml index 0ab3c594ec8..129f6cf1f23 100644 --- a/xml/System.Xml/XmlProcessingInstruction.xml +++ b/xml/System.Xml/XmlProcessingInstruction.xml @@ -130,11 +130,11 @@ The parent XML document. Initializes a new instance of the class. - directly; instead, use methods such as . - + directly; instead, use methods such as . + ]]> @@ -188,13 +188,13 @@ Creates a duplicate of this node. The duplicate node. - method in the `XmlNode` class. - - The cloned node has no parent ( returns `null`). - + method in the `XmlNode` class. + + The cloned node has no parent ( returns `null`). + ]]> @@ -250,15 +250,15 @@ Gets or sets the content of the processing instruction, excluding the target. The content of the processing instruction, excluding the target. - @@ -317,11 +317,11 @@ Gets or sets the concatenated values of the node and all its children. The concatenated values of the node and all its children. - @@ -520,15 +520,15 @@ Gets the target of the processing instruction. The target of the processing instruction. - @@ -638,14 +638,13 @@ The to which you want to save. Saves all the children of the node to the specified . Because ProcessingInstruction nodes do not have children, this method has no effect. - - @@ -695,14 +694,13 @@ The to which you want to save. Saves the node to the specified . - - diff --git a/xml/System/Byte.xml b/xml/System/Byte.xml index aa0dfe0d699..02912cd187e 100644 --- a/xml/System/Byte.xml +++ b/xml/System/Byte.xml @@ -2234,7 +2234,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -3352,7 +3351,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/Char.xml b/xml/System/Char.xml index 7254057ea52..85f20a2807d 100644 --- a/xml/System/Char.xml +++ b/xml/System/Char.xml @@ -6147,7 +6147,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/DateTime.xml b/xml/System/DateTime.xml index 0a9ae2df659..c8b649bb31d 100644 --- a/xml/System/DateTime.xml +++ b/xml/System/DateTime.xml @@ -5131,7 +5131,6 @@ juillet 2009 The equivalent method for this operator is ]]> - @@ -5198,7 +5197,6 @@ juillet 2009 The equivalent method for this operator is ]]> - @@ -5331,7 +5329,6 @@ juillet 2009 The equivalent method for this operator is ]]> - @@ -5398,7 +5395,6 @@ juillet 2009 The equivalent method for this operator is ]]> - diff --git a/xml/System/DateTimeOffset.xml b/xml/System/DateTimeOffset.xml index 96d09bbad34..bd3d417fb65 100644 --- a/xml/System/DateTimeOffset.xml +++ b/xml/System/DateTimeOffset.xml @@ -3652,7 +3652,6 @@ If you rely on properties such as or ]]> - @@ -3725,7 +3724,6 @@ If you rely on properties such as or ]]> - @@ -3942,7 +3940,6 @@ If you rely on properties such as or ]]> - @@ -4015,7 +4012,6 @@ If you rely on properties such as or ]]> - diff --git a/xml/System/Decimal.xml b/xml/System/Decimal.xml index 92bb4109bf0..e3e2bc3a8c5 100644 --- a/xml/System/Decimal.xml +++ b/xml/System/Decimal.xml @@ -3414,7 +3414,6 @@ For , this method matches the IE The return value is less than Decimal.MinValue or greater than Decimal.MaxValue. - @@ -3493,7 +3492,6 @@ For , this method matches the IE is zero. The return value is less than Decimal.MinValue or greater than Decimal.MaxValue. - @@ -3571,7 +3569,6 @@ For , this method matches the IE - @@ -4581,7 +4578,6 @@ For , this method matches the IE The equivalent method for this operator is ]]> - @@ -4660,7 +4656,6 @@ For , this method matches the IE The equivalent method for this operator is ]]> - @@ -4735,7 +4730,6 @@ For , this method matches the IE ## Remarks The overloads of the method define the types from which the compiler can automatically convert a value without an explicit casting operator (in C#) or a call to a conversion function (in Visual Basic). They are widening conversions that do not involve data loss and do not throw an exception. - ## Examples The following example converts values to numbers. @@ -4801,7 +4795,6 @@ For , this method matches the IE ## Remarks The overloads of the method define the types from which the compiler can automatically convert a value without an explicit casting operator (in C#) or a call to a conversion function (in Visual Basic). They are widening conversions that do not involve data loss and do not throw an exception. - ## Examples The following example converts values (Unicode characters) to numbers. This conversion requires the op_Implicit operator in Visual Basic, but not in C# and C++. @@ -4867,7 +4860,6 @@ For , this method matches the IE ## Remarks The overloads of the method define the types from which the compiler can automatically convert a value without an explicit casting operator (in C#) or a call to a conversion function (in Visual Basic). They are widening conversions that do not involve data loss and do not throw an exception. - ## Examples The following example converts values to numbers. This conversion requires the op_Implicit operator in Visual Basic, but not in C# and C++. @@ -4933,7 +4925,6 @@ For , this method matches the IE ## Remarks The overloads of the method define the types from which the compiler can automatically convert a value without an explicit casting operator (in C#) or a call to a conversion function (in Visual Basic). They are widening conversions that do not involve data loss and do not throw an exception. - ## Examples The following example converts values to numbers. @@ -4999,7 +4990,6 @@ For , this method matches the IE ## Remarks The overloads of the method define the types from which the compiler can automatically convert a value without an explicit casting operator (in C#) or a call to a conversion function (in Visual Basic). They are widening conversions that do not involve data loss and do not throw an exception. - ## Examples The following example converts values to numbers. @@ -5073,7 +5063,6 @@ For , this method matches the IE ## Remarks The overloads of the method define the types from which the compiler can automatically convert a value without an explicit casting operator (in C#) or a call to a conversion function (in Visual Basic). They are widening conversions that do not involve data loss and do not throw an exception. - ## Examples The following example converts values to numbers. @@ -5147,7 +5136,6 @@ For , this method matches the IE ## Remarks The overloads of the method define the types from which the compiler can automatically convert a value without an explicit casting operator (in C#) or a call to a conversion function (in Visual Basic). They are widening conversions that do not involve data loss and do not throw an exception. - ## Examples The following example converts values to numbers. @@ -5221,7 +5209,6 @@ For , this method matches the IE ## Remarks The overloads of the method define the types from which the compiler can automatically convert a value without an explicit casting operator (in C#) or a call to a conversion function (in Visual Basic). They are widening conversions that do not involve data loss and do not throw an exception. - ## Examples The following example converts values to numbers. @@ -5295,7 +5282,6 @@ For , this method matches the IE ## Remarks The overloads of the method define the types from which the compiler can automatically convert a value without an explicit casting operator (in C#) or a call to a conversion function (in Visual Basic). They are widening conversions that do not involve data loss and do not throw an exception. - ## Examples The following example converts values to numbers by using the to conversion operator. @@ -5382,7 +5368,6 @@ For , this method matches the IE The return value is less than Decimal.MinValue or greater than Decimal.MaxValue. - @@ -5456,15 +5441,13 @@ For , this method matches the IE If the language you're using doesn't support custom operators, you can test for inequality by using one of the following techniques: -- Calling the method, which indicates the relationship between two values. - -- Calling the method and reversing its value. +- Calling the method, which indicates the relationship between two values. +- Calling the method and reversing its value. The equivalent method for this operator is ]]> - @@ -5543,7 +5526,6 @@ For , this method matches the IE The equivalent method for this operator is ]]> - @@ -5622,7 +5604,6 @@ For , this method matches the IE The equivalent method for this operator is ]]> - @@ -5696,7 +5677,6 @@ For , this method matches the IE is . The return value is less than Decimal.MinValue or greater than Decimal.MaxValue. - @@ -5773,7 +5753,6 @@ For , this method matches the IE The return value is less than Decimal.MinValue or greater than Decimal.MaxValue. - @@ -7109,7 +7088,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -8254,7 +8232,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - @@ -8359,7 +8336,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/Double.xml b/xml/System/Double.xml index 293b2c4162a..c65f59d706e 100644 --- a/xml/System/Double.xml +++ b/xml/System/Double.xml @@ -4451,7 +4451,6 @@ The following code example illustrates the use of - @@ -4513,7 +4512,6 @@ The following code example illustrates the use of - @@ -4575,7 +4573,6 @@ The following code example illustrates the use of - @@ -4637,7 +4634,6 @@ The following code example illustrates the use of - @@ -4699,7 +4695,6 @@ The following code example illustrates the use of - @@ -4761,7 +4756,6 @@ The following code example illustrates the use of - @@ -5840,7 +5834,6 @@ The following code example illustrates the use of Rounds a value to the nearest integer using the default rounding mode (). The result of rounding to the nearest integer using the default rounding mode. To be added. - @@ -5880,7 +5873,6 @@ The following code example illustrates the use of Rounds a value to a specified number of fractional-digits using the default rounding mode (). The result of rounding to fractional-digits using the default rounding mode. To be added. - @@ -5920,7 +5912,6 @@ The following code example illustrates the use of Rounds a value to the nearest integer using the specified rounding mode. The result of rounding to the nearest integer using . To be added. - @@ -5962,7 +5953,6 @@ The following code example illustrates the use of Rounds a value to a specified number of fractional-digits using the default rounding mode (). The result of rounding to fractional-digits using . To be added. - @@ -6048,7 +6038,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -7653,7 +7642,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - @@ -7758,7 +7746,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/Half.xml b/xml/System/Half.xml index 67f2c3d18a4..0e0379d1eb1 100644 --- a/xml/System/Half.xml +++ b/xml/System/Half.xml @@ -2948,7 +2948,6 @@ For this method matches the IEEE 754:2 Represents the largest possible value of . 65504 To be added. - @@ -3181,7 +3180,6 @@ For this method matches the IEEE 754:2 Represents the smallest possible value of . -65504 To be added. - @@ -3553,7 +3551,6 @@ For this method matches the IEEE 754:2 if and are equal; otherwise, . To be added. - @@ -4467,7 +4464,6 @@ For this method matches the IEEE 754:2 if is greater than ; otherwise, . To be added. - @@ -4639,7 +4635,6 @@ For this method matches the IEEE 754:2 if and are not equal; otherwise, . To be added. - @@ -4677,7 +4672,6 @@ For this method matches the IEEE 754:2 if is less than ; otherwise, . To be added. - @@ -4715,7 +4709,6 @@ For this method matches the IEEE 754:2 if is less than or equal to ; otherwise, . To be added. - @@ -5495,7 +5488,6 @@ For this method matches the IEEE 754:2 Rounds a value to the nearest integer using the default rounding mode (). The result of rounding to the nearest integer using the default rounding mode. To be added. - @@ -5529,7 +5521,6 @@ For this method matches the IEEE 754:2 Rounds a value to a specified number of fractional-digits using the default rounding mode (). The result of rounding to fractional-digits using the default rounding mode. To be added. - @@ -5563,7 +5554,6 @@ For this method matches the IEEE 754:2 Rounds a value to the nearest integer using the specified rounding mode. The result of rounding to the nearest integer using . To be added. - @@ -5599,7 +5589,6 @@ For this method matches the IEEE 754:2 Rounds a value to a specified number of fractional-digits using the default rounding mode (). The result of rounding to fractional-digits using . To be added. - @@ -5673,7 +5662,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -6122,7 +6110,6 @@ This computes `sin(x * π)`. Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - @@ -6209,7 +6196,6 @@ This computes `sin(x * π)`. Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/Int128.xml b/xml/System/Int128.xml index f0b6f4ba8b7..b512cab32fb 100644 --- a/xml/System/Int128.xml +++ b/xml/System/Int128.xml @@ -3709,7 +3709,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -3765,7 +3764,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/Int16.xml b/xml/System/Int16.xml index 2cb4ead33e1..9048209a11d 100644 --- a/xml/System/Int16.xml +++ b/xml/System/Int16.xml @@ -2499,7 +2499,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -3611,7 +3610,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/Int32.xml b/xml/System/Int32.xml index 940abb3035a..f45bc195dfa 100644 --- a/xml/System/Int32.xml +++ b/xml/System/Int32.xml @@ -2562,7 +2562,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -3686,7 +3685,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/Int64.xml b/xml/System/Int64.xml index 302bdc15cd7..72a56423a2a 100644 --- a/xml/System/Int64.xml +++ b/xml/System/Int64.xml @@ -2496,7 +2496,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -3609,7 +3608,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/IntPtr.xml b/xml/System/IntPtr.xml index 6ac02010c0a..ca7987b3b28 100644 --- a/xml/System/IntPtr.xml +++ b/xml/System/IntPtr.xml @@ -1741,7 +1741,6 @@ For this method matches the IEE Gets the smallest possible value of . The smallest possible value of . To be added. - @@ -3001,7 +3000,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -3328,7 +3326,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/SByte.xml b/xml/System/SByte.xml index c4957fc90e5..0406727fc52 100644 --- a/xml/System/SByte.xml +++ b/xml/System/SByte.xml @@ -2528,7 +2528,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -3619,7 +3618,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/Single.xml b/xml/System/Single.xml index 389a3b125ba..0d0c8bc319e 100644 --- a/xml/System/Single.xml +++ b/xml/System/Single.xml @@ -4473,7 +4473,6 @@ For this method matches the IEEE 754:2 ]]> - @@ -4535,7 +4534,6 @@ For this method matches the IEEE 754:2 ]]> - @@ -4597,7 +4595,6 @@ For this method matches the IEEE 754:2 ]]> - @@ -4659,7 +4656,6 @@ For this method matches the IEEE 754:2 ]]> - @@ -4721,7 +4717,6 @@ For this method matches the IEEE 754:2 ]]> - @@ -4783,7 +4778,6 @@ For this method matches the IEEE 754:2 ]]> - @@ -5909,7 +5903,6 @@ Pi is approximately 3.1415926535897932385. Rounds a value to a specified number of fractional-digits using the default rounding mode (). The result of rounding to fractional-digits using the default rounding mode. To be added. - @@ -5949,7 +5942,6 @@ Pi is approximately 3.1415926535897932385. Rounds a value to the nearest integer using the specified rounding mode. The result of rounding to the nearest integer using . To be added. - @@ -5991,7 +5983,6 @@ Pi is approximately 3.1415926535897932385. Rounds a value to a specified number of fractional-digits using the default rounding mode (). The result of rounding to fractional-digits using . To be added. - @@ -6077,7 +6068,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -7682,7 +7672,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - @@ -7787,7 +7776,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/TimeOnly.xml b/xml/System/TimeOnly.xml index 940fea7d31a..fece4f688e3 100644 --- a/xml/System/TimeOnly.xml +++ b/xml/System/TimeOnly.xml @@ -1013,7 +1013,6 @@ If `start` and `end` are equal, this method returns `false`, meaning there is ze if left and right represent the same time; otherwise, . To be added. - @@ -1046,7 +1045,6 @@ If `start` and `end` are equal, this method returns `false`, meaning there is ze if left is later than right; otherwise, . To be added. - @@ -1079,7 +1077,6 @@ If `start` and `end` are equal, this method returns `false`, meaning there is ze if left is the same as or later than right; otherwise, . To be added. - @@ -1112,7 +1109,6 @@ If `start` and `end` are equal, this method returns `false`, meaning there is ze if left and right do not represent the same time; otherwise, . To be added. - @@ -1145,7 +1141,6 @@ If `start` and `end` are equal, this method returns `false`, meaning there is ze if left is earlier than right; otherwise, . To be added. - @@ -1178,7 +1173,6 @@ If `start` and `end` are equal, this method returns `false`, meaning there is ze if left is the same as or earlier than right; otherwise, . To be added. - @@ -1366,7 +1360,6 @@ If `start` and `end` are equal, this method returns `false`, meaning there is ze To be added. does not contain a valid string representation of a time. - @@ -2268,7 +2261,6 @@ The accepted standard formats are 'r', 'R', 'o', 'O', 't', and 'T'. if was successfully parsed; otherwise, . To be added. - @@ -2309,7 +2301,6 @@ The accepted standard formats are 'r', 'R', 'o', 'O', 't', and 'T'. if was parsed successfully; otherwise, . To be added. - @@ -2353,7 +2344,6 @@ The accepted standard formats are 'r', 'R', 'o', 'O', 't', and 'T'. if was converted successfully; otherwise, . To be added. - diff --git a/xml/System/TimeSpan.xml b/xml/System/TimeSpan.xml index dcafa602d58..7d5a81ec7ec 100644 --- a/xml/System/TimeSpan.xml +++ b/xml/System/TimeSpan.xml @@ -3269,7 +3269,6 @@ The value of this constant is 100. Returns a new object whose value is the result of dividing the specified by the specified . A new object that represents the value of divided by the value of . To be added. - @@ -3312,7 +3311,6 @@ The value of this constant is 100. Returns a new value that's the result of dividing by . A new value that represents result of dividing by the value of . To be added. - @@ -3386,7 +3384,6 @@ The value of this constant is 100. - @@ -3459,7 +3456,6 @@ The value of this constant is 100. - @@ -3532,7 +3528,6 @@ The value of this constant is 100. - @@ -3605,7 +3600,6 @@ The value of this constant is 100. - @@ -3678,7 +3672,6 @@ The value of this constant is 100. - @@ -3751,7 +3744,6 @@ The value of this constant is 100. - @@ -3794,7 +3786,6 @@ The value of this constant is 100. Returns a new object whose value is the result of multiplying the specified and the specified instance. A new object that represents the value of the specified multiplied by the value of the specified instance. To be added. - @@ -3837,7 +3828,6 @@ The value of this constant is 100. Returns a new object whose value is the result of multiplying the specified instance and the specified . A new object that represents the value of the specified instance multiplied by the value of the specified . To be added. - diff --git a/xml/System/UInt128.xml b/xml/System/UInt128.xml index ee70d100ae2..5af8b1915af 100644 --- a/xml/System/UInt128.xml +++ b/xml/System/UInt128.xml @@ -3597,7 +3597,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -3653,7 +3652,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/UInt16.xml b/xml/System/UInt16.xml index 53dba2a54ea..db975025c06 100644 --- a/xml/System/UInt16.xml +++ b/xml/System/UInt16.xml @@ -2294,7 +2294,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -3400,7 +3399,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/UInt32.xml b/xml/System/UInt32.xml index be3dab730fc..a2bb9dcf274 100644 --- a/xml/System/UInt32.xml +++ b/xml/System/UInt32.xml @@ -2343,7 +2343,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -3453,7 +3452,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/UInt64.xml b/xml/System/UInt64.xml index f31dfe411f5..ea0fd2688c8 100644 --- a/xml/System/UInt64.xml +++ b/xml/System/UInt64.xml @@ -2322,7 +2322,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -3428,7 +3427,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/UIntPtr.xml b/xml/System/UIntPtr.xml index ec9e455c8d6..f369bf6e92a 100644 --- a/xml/System/UIntPtr.xml +++ b/xml/System/UIntPtr.xml @@ -1330,7 +1330,6 @@ For this method matches the IEEE 754:2 Represents the largest possible value of . The largest possible value of . To be added. - @@ -1415,7 +1414,6 @@ For this method matches the IEEE 754:2 Represents the smallest possible value of . The smallest possible value of . To be added. - @@ -2590,7 +2588,6 @@ It is recommended that a function return `1`, `0`, and `-1`, respectively. ]]> - @@ -2899,7 +2896,6 @@ This member is an explicit interface member implementation. It can be used only Gets the number of bytes that will be written as part of . The number of bytes that will be written as part of . To be added. - diff --git a/xml/System/Uri.xml b/xml/System/Uri.xml index 9cbf2162f33..6ddc0ee3c45 100644 --- a/xml/System/Uri.xml +++ b/xml/System/Uri.xml @@ -4616,7 +4616,6 @@ The following examples show a URI and the results of calling Formats the value of the current instance using the specified format. The value of the current instance in the specified format. To be added. -