diff --git a/xml/System.Collections.Immutable/ImmutableList`1.xml b/xml/System.Collections.Immutable/ImmutableList`1.xml index 67736b5159a..e2d6a6b73d1 100644 --- a/xml/System.Collections.Immutable/ImmutableList`1.xml +++ b/xml/System.Collections.Immutable/ImmutableList`1.xml @@ -88,15 +88,15 @@ The type of elements in the list. - Represents an immutable list, which is a strongly typed list of objects that can be accessed by index. - + Represents an immutable list, which is a strongly typed list of objects that can be accessed by index. + **NuGet package**: System.Collections.Immutable (about immutable collections and how to install) - ` has no public constructor; you begin by retrieving an empty `ImmutableList` by using the . You can then call methods, such as and , to populate the collection. Note that these methods return a new object. When you add or remove items from an immutable list, a copy of the original list is made with the items added or removed, and the original list is unchanged. +`ImmutableList` has no public constructor; you begin by retrieving an empty `ImmutableList` by using the . You can then call methods, such as and , to populate the collection. Note that these methods return a new object. When you add or remove items from an immutable list, a copy of the original list is made with the items added or removed, and the original list is unchanged. ## Examples This example shows how to create an immutable list and iterate over elements in it: @@ -106,7 +106,7 @@ This example shows how to create an immutable list and iterate over elements in This example shows how to create a new immutable list by adding and removing items from the original list: :::code language="csharp" source="~/snippets/csharp/System.Collections.Immutable/ImmutableList`1/Overview/ImmutableListSnippets.cs" id="SnippetModify"::: - + ]]> This type is thread safe. @@ -1071,13 +1071,13 @@ This example shows how to create a new immutable list by adding and removing ite Returns an enumerator that iterates through the immutable list. An enumerator that can be used to iterate through the immutable list. - [!CAUTION] -> When this enumerator is used as a value type (that is, when it isn't boxed), do not copy it by assigning it to a second variable or by passing it to another method. When this enumerator is disposed of, it returns a mutable reference type stack to a resource pool, and if the value type enumerator is copied (which can easily happen unintentionally if you pass the value around), there is a risk that a stack that has already been returned to the resource pool may still be in use by one of the enumerator copies, leading to data corruption or exceptions. - +> When this enumerator is used as a value type (that is, when it isn't boxed), do not copy it by assigning it to a second variable or by passing it to another method. When this enumerator is disposed of, it returns a mutable reference type stack to a resource pool, and if the value type enumerator is copied (which can easily happen unintentionally if you pass the value around), there is a risk that a stack that has already been returned to the resource pool may still be in use by one of the enumerator copies, leading to data corruption or exceptions. + ]]> @@ -1353,7 +1353,7 @@ This example shows how to create a new immutable list by adding and removing ite Gets the element at the specified index of the list. The element at the specified index. To be added. - In a get operation, is negative or not less than . + In a get operation, is negative or not less than . @@ -1390,7 +1390,7 @@ This example shows how to create a new immutable list by adding and removing ite Gets a read-only reference to the element of the set at the given . A read-only reference to the element at the given position. To be added. - + is negative or not less than . @@ -2081,11 +2081,11 @@ This example shows how to create a new immutable list by adding and removing ite The item to add. Adds the specified item to the immutable list. - instance is cast to an interface. - + instance is cast to an interface. + ]]> Always thrown. @@ -2122,11 +2122,11 @@ This example shows how to create a new immutable list by adding and removing ite Removes all items from the immutable list. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -2202,11 +2202,11 @@ This example shows how to create a new immutable list by adding and removing ite if was successfully removed from the list; otherwise, . This method also returns if is not found in the original list. - instance is cast to an interface. - + instance is cast to an interface. + ]]> Always thrown. @@ -2244,11 +2244,11 @@ This example shows how to create a new immutable list by adding and removing ite Returns an enumerator that iterates through the immutable list. An enumerator that can be used to iterate through the list. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -2289,11 +2289,11 @@ This example shows how to create a new immutable list by adding and removing ite The object to insert. Inserts an object in the immutable list at the specified index. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -2334,7 +2334,7 @@ This example shows how to create a new immutable list by adding and removing ite Gets or sets the value at the specified index. Value stored in the specified index. To be added. - Thrown from getter when is negative or not less than . + In a get operation, is negative or not less than . Always thrown from the setter. @@ -2372,11 +2372,11 @@ This example shows how to create a new immutable list by adding and removing ite The zero-based index of the item to remove. Removes the value at the specified index. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -2418,11 +2418,11 @@ This example shows how to create a new immutable list by adding and removing ite The zero-based index in at which copying begins. Copies the entire immutable list to a compatible one-dimensional array, starting at the specified array index. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -2553,11 +2553,11 @@ This member is an explicit interface member implementation. It can be used only Returns an enumerator that iterates through the immutable list. An enumerator that can be used to iterate through the list. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -2597,11 +2597,11 @@ This member is an explicit interface member implementation. It can be used only Adds an item to the immutable list. The position into which the new element was inserted, or -1 to indicate that the item was not inserted into the list. - instance is cast to an interface. - + instance is cast to an interface. + ]]> Always thrown. @@ -2638,11 +2638,11 @@ This member is an explicit interface member implementation. It can be used only Removes all items from the immutable list. - instance is cast to an interface. - + instance is cast to an interface. + ]]> Always thrown. @@ -2684,11 +2684,11 @@ This member is an explicit interface member implementation. It can be used only if the object is found in the list; otherwise, . - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -2729,11 +2729,11 @@ This member is an explicit interface member implementation. It can be used only Determines the index of a specific item in the immutable list. The index of if found in the list; otherwise, -1. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -2775,11 +2775,11 @@ This member is an explicit interface member implementation. It can be used only The object to insert into the list. Inserts an item into the immutable list at the specified index. - instance is cast to an interface. - + instance is cast to an interface. + ]]> Always thrown. @@ -2911,7 +2911,7 @@ This member is an explicit interface member implementation. It can be used only Gets or sets the at the specified index. The value at the specified index. To be added. - Thrown from getter when is negative or not less than . + In a get operation, is negative or not less than . Always thrown from the setter. @@ -2949,11 +2949,11 @@ This member is an explicit interface member implementation. It can be used only The object to remove from the list. Removes the first occurrence of a specific object from the immutable list. - instance is cast to an interface. - + instance is cast to an interface. + ]]> Always thrown. @@ -2993,11 +2993,11 @@ This member is an explicit interface member implementation. It can be used only The zero-based index of the item to remove. Removes the item at the specified index of the immutable list. - instance is cast to an interface. - + instance is cast to an interface. + ]]> Always thrown. @@ -3038,11 +3038,11 @@ This member is an explicit interface member implementation. It can be used only Adds the specified value to this immutable list. A new list with the element added. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -3082,11 +3082,11 @@ This member is an explicit interface member implementation. It can be used only Adds the specified values to this immutable list. A new list with the elements added. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -3123,11 +3123,11 @@ This member is an explicit interface member implementation. It can be used only Retrieves an empty list that has the same sorting and ordering semantics as this instance. An empty list that has the same sorting and ordering semantics as this instance. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -3169,11 +3169,11 @@ This member is an explicit interface member implementation. It can be used only Inserts the specified element at the specified index in the immutable list. A new immutable list that includes the specified element. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -3215,11 +3215,11 @@ This member is an explicit interface member implementation. It can be used only Inserts the specified elements at the specified index in the immutable list. A new immutable list that includes the specified elements. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -3261,11 +3261,11 @@ This member is an explicit interface member implementation. It can be used only Removes the element with the specified value from the list. A new with the specified element removed. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -3305,11 +3305,11 @@ This member is an explicit interface member implementation. It can be used only Removes all the elements that match the conditions defined by the specified predicate. A new immutable list with the elements removed. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -3349,11 +3349,11 @@ This member is an explicit interface member implementation. It can be used only Removes the element at the specified index of the immutable list. A new list with the element removed. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -3367,11 +3367,11 @@ This member is an explicit interface member implementation. It can be used only Removes a range of elements from this immutable list. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -3413,11 +3413,11 @@ This member is an explicit interface member implementation. It can be used only Removes a range of elements from this immutable list that match the items specified. An immutable list with the items removed. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -3461,11 +3461,11 @@ This member is an explicit interface member implementation. It can be used only Removes the specified number of elements at the specified location from this list. A new list with the elements removed. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -3550,11 +3550,11 @@ This member is an explicit interface member implementation. It can be used only Replaces an element in the list at a given position with the specified element. The new list. - instance is cast to an interface. - + instance is cast to an interface. + ]]> @@ -3588,11 +3588,11 @@ This member is an explicit interface member implementation. It can be used only Creates a list that has the same contents as this list and can be efficiently mutated across multiple operations using standard mutable interfaces. The created list with the same contents as this list. - diff --git a/xml/System.IO/PathTooLongException.xml b/xml/System.IO/PathTooLongException.xml index de7b885807f..57a9a544890 100644 --- a/xml/System.IO/PathTooLongException.xml +++ b/xml/System.IO/PathTooLongException.xml @@ -59,37 +59,19 @@ - The exception that is thrown when a path or fully qualified file name is longer than the system-defined maximum length. + The exception that's thrown when a path or fully qualified file name is longer than the system-defined maximum length. . For more information about this restriction, see the entry [Long Paths in .NET](https://go.microsoft.com/fwlink/?LinkID=163666) in the BCL Team blog. > [!NOTE] -> This exception is not included in [.NET for Windows Store apps](https://go.microsoft.com/fwlink/?LinkID=247912) or the [Portable Class Library](/dotnet/standard/cross-platform/cross-platform-development-with-the-portable-class-library), but it is thrown by some members that are. To catch the exception in that case, write a `catch` statement that handles an instead. +> This exception is not included in [.NET for Windows Store apps](https://go.microsoft.com/fwlink/?LinkID=247912) or the [Portable Class Library](/dotnet/standard/cross-platform/cross-platform-development-with-the-portable-class-library), but it is thrown by some members that are. To catch the exception in that case, write a `catch` statement that handles an instead. - Starting with apps running under the .NET Framework 4.6.2, the .NET Framework supports long paths in excess of 260 (or `MAX_PATH`) characters. The conditions under which a exception are thrown depend on the version of the .NET Framework that an app targets: + Starting with apps running under .NET Framework 4.6.2, .NET supports long paths in excess of 260 (or `MAX_PATH`) characters. The runtime throws a under the following conditions: - **Apps that target the .NET Framework 4.6.2 and later versions** - Long paths are supported by default. The runtime throws a under the following conditions: - -- The operating system returns `COR_E_PATHTOOLONG` or its equivalent. - -- The length of the path exceeds (32,767) characters. - - **Apps that target the .NET Framework 4.6.1 and earlier versions** - Long paths are disabled by default, and the legacy behavior is maintained. The runtime throws a whenever a path exceeds 260 characters. - - If this is undesirable, apps that target the .NET Framework 4.6.1 and earlier but run under the .NET Framework 4.6.2 can enable long path support by including the following setting in the [\](/dotnet/framework/configure-apps/file-schema/runtime/runtime-element) element of the application configuration file: - -```xml - - - - - -``` +- The operating system returns `COR_E_PATHTOOLONG` or its equivalent. +- The length of the path exceeds (32,767) characters. uses the HRESULT `COR_E_PATHTOOLONG`, which has the value 0x800700CE.