From 1ca77b52976a02689875778a676eebe640a2635a Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Wed, 2 Apr 2025 08:12:05 -0700 Subject: [PATCH 1/4] fix mismatched paramrefs (#11146) --- xml/System.Numerics/BigInteger.xml | 2 +- xml/System.Numerics/Vector`1.xml | 330 +-- .../AssemblyBuilder.xml | 7 +- xml/System.Reflection.Emit/DynamicILInfo.xml | 186 +- xml/System.Reflection.Emit/DynamicMethod.xml | 5 - xml/System.Reflection.Emit/EnumBuilder.xml | 2 +- xml/System.Reflection.Emit/EventBuilder.xml | 2 +- xml/System.Reflection.Emit/FieldBuilder.xml | 2 +- xml/System.Reflection.Emit/ILGenerator.xml | 6 +- xml/System.Reflection.Emit/ModuleBuilder.xml | 6 - .../ParameterBuilder.xml | 2 +- .../PersistedAssemblyBuilder.xml | 2 +- .../SignatureHelper.xml | 2 +- .../MetadataRootBuilder.xml | 2 +- xml/System.Reflection/Assembly.xml | 14 +- xml/System.Reflection/ConstructorInfo.xml | 4 +- .../ICustomAttributeProvider.xml | 43 +- .../ITargetAwareCodeDomProvider.xml | 2 +- .../StronglyTypedResourceBuilder.xml | 8 +- xml/System.Resources/ResXResourceWriter.xml | 4 +- xml/System.Resources/ResourceManager.xml | 2 +- xml/System.Runtime.Caching/MemoryCache.xml | 2 +- .../IDataObject.xml | 312 +-- .../WindowsRuntimeBufferExtensions.xml | 2 +- .../Marshal.xml | 2 +- .../NativeLibrary.xml | 2 +- xml/System.Runtime.InteropServices/_Type.xml | 2360 ++++++++--------- .../RemotingConfiguration.xml | 6 +- .../RemotingServices.xml | 2 +- 29 files changed, 1646 insertions(+), 1675 deletions(-) diff --git a/xml/System.Numerics/BigInteger.xml b/xml/System.Numerics/BigInteger.xml index 66342fdbb35..102aec0050f 100644 --- a/xml/System.Numerics/BigInteger.xml +++ b/xml/System.Numerics/BigInteger.xml @@ -11708,7 +11708,7 @@ The integer value `33022` can be exported in four different arrays: The span of characters into which this instance will be written. When the method returns, contains the length of the span in number of characters. A read-only span of characters that specifies the format for the formatting operation. - An object that supplies culture-specific formatting information about . + An object that supplies culture-specific formatting information. Formats this big integer instance into a span of characters. if the formatting operation succeeds; otherwise. diff --git a/xml/System.Numerics/Vector`1.xml b/xml/System.Numerics/Vector`1.xml index 202addcba34..c1361c216ce 100644 --- a/xml/System.Numerics/Vector`1.xml +++ b/xml/System.Numerics/Vector`1.xml @@ -77,15 +77,15 @@ The type of the elements in the vector. can be any primitive numeric type. Represents a single vector of a specified numeric type that is suitable for low-level optimization of parallel algorithms. - is an immutable structure that represents a single vector of a specified numeric type. The count of instances is fixed, but its upper limit is CPU-register dependent. It's intended to be used as a building block for vectorizing large algorithms, and therefore cannot be used directly as an arbitrary length vector or tensor. - + The structure provides support for hardware acceleration. - + The term *primitive numeric data type* in this article refers to numeric data types that are directly supported by the CPU and have instructions that can manipulate those data types. - + ]]> @@ -162,7 +162,7 @@ The type `T` can be any of the following numeric types: elements are added to the vector. The remainders are ignored. @@ -213,7 +213,7 @@ The type `T` can be any of the following numeric types: elements are added to the vector. The remainders are ignored. @@ -272,7 +272,7 @@ The type `T` can be any of the following numeric types: elements are added to the vector. The remainders are ignored. @@ -359,12 +359,12 @@ The type `T` can be any of the following numeric types: The values to add to the vector, as an array of objects of type T. The array must contain at least elements and only the first elements are used. Creates a vector from a specified array. - elements are added to the vector. The remainders are ignored. - + ]]> @@ -415,7 +415,7 @@ The type `T` can be any of the following numeric types: elements are added to the vector. The remainders are ignored. @@ -424,10 +424,10 @@ The type `T` can be any of the following numeric types: is . - is less than zero. - - -or- - + is less than zero. + + -or- + The length of minus is less than . .NET 5 and later: Type is not supported. @@ -607,11 +607,11 @@ The type `T` can be any of the following numeric types: The array to receive a copy of the vector values. Copies the vector instance to a specified destination array. - elements. - + elements. + ]]> @@ -669,18 +669,18 @@ The type `T` can be any of the following numeric types: The starting index in at which to begin the copy operation. Copies the vector instance to a specified destination array starting at a specified index position. - elements. - + elements. + ]]> is . The number of elements in the current instance is greater than the number of elements available from to the end of the array. - is less than zero or greater than the last index in . + is less than zero or greater than the last index in . .NET 5 and later: Type is not supported. is . @@ -723,9 +723,9 @@ The type `T` can be any of the following numeric types: The number of elements stored in the vector. To be added. Access to the property getter via reflection is not supported. - + -or- - + .NET 5 and later: Type is not supported. @@ -787,11 +787,11 @@ The type `T` can be any of the following numeric types: if the current instance and are equal; otherwise, . - .NET 5 and later: Type is not supported. @@ -853,11 +853,11 @@ The type `T` can be any of the following numeric types: if the current instance and are equal; otherwise, . The method returns if is null, or if is a vector of a different type than the current instance. - .NET 5 and later: Type is not supported. @@ -1021,10 +1021,10 @@ The type `T` can be any of the following numeric types: The element at index . To be added. - is less than zero. - - -or- - + is less than zero. + + -or- + is greater than or equal to . .NET 5 and later: Type is not supported. @@ -1132,11 +1132,11 @@ The type `T` can be any of the following numeric types: Adds two vectors together. The summed vector. - method defines the addition operation for objects. - + method defines the addition operation for objects. + ]]> .NET 5 and later: Type is not supported. @@ -1198,11 +1198,11 @@ The type `T` can be any of the following numeric types: Returns a new vector by performing a bitwise operation on each of the elements in two vectors. The vector that results from the bitwise of and . - method defines the bitwise `And` operation for objects. - + method defines the bitwise `And` operation for objects. + ]]> .NET 5 and later: Type is not supported. @@ -1264,11 +1264,11 @@ The type `T` can be any of the following numeric types: Returns a new vector by performing a bitwise operation on each of the elements in two vectors. The vector that results from the bitwise of the elements in and . - method defines the bitwise `Or` operation for objects. - + method defines the bitwise `Or` operation for objects. + ]]> .NET 5 and later: Type is not supported. @@ -1330,11 +1330,11 @@ The type `T` can be any of the following numeric types: 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. + ]]> .NET 5 and later: Type is not supported. @@ -1442,11 +1442,11 @@ The type `T` can be any of the following numeric types: if and are equal; otherwise, . - .NET 5 and later: Type is not supported. @@ -1508,11 +1508,11 @@ The type `T` can be any of the following numeric types: Returns a new vector by performing a bitwise operation on each of the elements in two vectors. The vector that results from the bitwise of the elements in and . - method defines the bitwise `XOr` operation for objects. - + method defines the bitwise `XOr` operation for objects. + ]]> .NET 5 and later: Type is not supported. @@ -1565,11 +1565,11 @@ The type `T` can be any of the following numeric types: Reinterprets the bits of the specified vector into a vector of type . The reinterpreted vector. - operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). - + operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). + ]]> .NET 5 and later: Type is not supported. @@ -1622,11 +1622,11 @@ The type `T` can be any of the following numeric types: Reinterprets the bits of the specified vector into a vector of type . The reinterpreted vector. - operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). - + operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). + ]]> .NET 5 and later: Type is not supported. @@ -1679,11 +1679,11 @@ The type `T` can be any of the following numeric types: Reinterprets the bits of the specified vector into a vector of type . The reinterpreted vector. - operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). - + operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). + ]]> .NET 5 and later: Type is not supported. @@ -1736,11 +1736,11 @@ The type `T` can be any of the following numeric types: Reinterprets the bits of the specified vector into a vector of type . The reinterpreted vector. - operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). - + operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). + ]]> .NET 5 and later: Type is not supported. @@ -1793,11 +1793,11 @@ The type `T` can be any of the following numeric types: Reinterprets the bits of the specified vector into a vector of type . The reinterpreted vector. - operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). - + operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). + ]]> .NET 5 and later: Type is not supported. @@ -1899,11 +1899,11 @@ The type `T` can be any of the following numeric types: Reinterprets the bits of the specified vector into a vector of type . The reinterpreted vector. - operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). - + operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). + ]]> .NET 5 and later: Type is not supported. @@ -1956,11 +1956,11 @@ The type `T` can be any of the following numeric types: Reinterprets the bits of the specified vector into a vector of type . The reinterpreted vector. - operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). - + operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). + ]]> .NET 5 and later: Type is not supported. @@ -2019,11 +2019,11 @@ The type `T` can be any of the following numeric types: Reinterprets the bits of the specified vector into a vector of type . The reinterpreted vector. - operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). - + operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). + ]]> .NET 5 and later: Type is not supported. @@ -2082,11 +2082,11 @@ The type `T` can be any of the following numeric types: Reinterprets the bits of the specified vector into a vector of type . The reinterpreted vector. - operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). - + operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). + ]]> .NET 5 and later: Type is not supported. @@ -2145,11 +2145,11 @@ The type `T` can be any of the following numeric types: Reinterprets the bits of the specified vector into a vector of type . The reinterpreted vector. - operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). - + operator defines a narrowing conversion; it requires a casting operator (in C#) or a conversion method (in Visual Basic). + ]]> .NET 5 and later: Type is not supported. @@ -2365,11 +2365,11 @@ The type `T` can be any of the following numeric types: 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. + ]]> .NET 5 and later: Type is not supported. @@ -2424,11 +2424,11 @@ The type `T` can be any of the following numeric types: Multiplies a vector by a specified scalar value. The scaled vector. - method defines the multiplication operation for objects. - + method defines the multiplication operation for objects. + ]]> .NET 5 and later: Type is not supported. @@ -2483,11 +2483,11 @@ The type `T` can be any of the following numeric types: Multiplies a vector by a specified scalar value. The scaled vector. - method defines the multiplication operation for objects. - + method defines the multiplication operation for objects. + ]]> .NET 5 and later: Type is not supported. @@ -2644,11 +2644,11 @@ The type `T` can be any of the following numeric types: 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. + ]]> .NET 5 and later: Type is not supported. @@ -2701,11 +2701,11 @@ The type `T` can be any of the following numeric types: Negates a given vector. The negated vector. - method defines the unary negation operation for objects. - + method defines the unary negation operation for objects. + ]]> .NET 5 and later: Type is not supported. @@ -2845,11 +2845,11 @@ The type `T` can be any of the following numeric types: Returns the string representation of this vector using default formatting. The string representation of this vector. - property followed by a space is used to separate each element. - + property followed by a space is used to separate each element. + ]]> .NET 5 and later: Type is not supported. @@ -2914,11 +2914,11 @@ The type `T` can be any of the following numeric types: Returns the string representation of this vector using the specified format string to format individual elements. The string representation of the current instance. - property followed by a space is used to separate each element. - + property followed by a space is used to separate each element. + ]]> .NET 5 and later: Type is not supported. @@ -2984,11 +2984,11 @@ The type `T` can be any of the following numeric types: Returns the string representation of this vector 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. - property followed by a space is used to separate each element. - + property followed by a space is used to separate each element. + ]]> .NET 5 and later: Type is not supported. diff --git a/xml/System.Reflection.Emit/AssemblyBuilder.xml b/xml/System.Reflection.Emit/AssemblyBuilder.xml index 37c98138693..f1cce090757 100644 --- a/xml/System.Reflection.Emit/AssemblyBuilder.xml +++ b/xml/System.Reflection.Emit/AssemblyBuilder.xml @@ -3383,11 +3383,6 @@ The following code example shows how to define and use a dynamic assembly. The e > [!NOTE] > cannot be used to set declarative security attributes. Use one of the overloads of that takes required, optional, and refused permissions. -> [!NOTE] -> Starting with the .NET Framework 2.0 Service Pack 1, this member no longer requires with the flag. (See [Security Issues in Reflection Emit](/dotnet/framework/reflection-and-codedom/security-issues-in-reflection-emit).) To use this functionality, your application should target the .NET Framework 3.5 or later. - - - ## Examples The following code sample illustrates the use of `SetCustomAttribute` within , using a . @@ -3398,7 +3393,7 @@ The following code example shows how to define and use a dynamic assembly. The e ]]> - is . + is . The caller does not have the required permission. diff --git a/xml/System.Reflection.Emit/DynamicILInfo.xml b/xml/System.Reflection.Emit/DynamicILInfo.xml index b30ee4fd0e1..6c0b2c2f4bb 100644 --- a/xml/System.Reflection.Emit/DynamicILInfo.xml +++ b/xml/System.Reflection.Emit/DynamicILInfo.xml @@ -56,20 +56,20 @@ Provides support for alternative ways to generate the Microsoft intermediate language (MSIL) and metadata for a dynamic method, including methods for creating tokens and for inserting the code, exception handling, and local variable signature blobs. - class allows developers to write their own MSIL generators instead of using . - - To create instances of other types, call methods, and so on, the MSIL you generate must include tokens for those entities. The class provides several overloads of the method, which return tokens valid in the scope of the current . For example, if you need to call an overload of the method, you can obtain a for that overload and pass it to the method to obtain a token to embed in your MSIL. - - Once you have created arrays for your local variable signature, exceptions, and code body, you can use the , , and methods to insert them into the associated with your object. - + class allows developers to write their own MSIL generators instead of using . + + To create instances of other types, call methods, and so on, the MSIL you generate must include tokens for those entities. The class provides several overloads of the method, which return tokens valid in the scope of the current . For example, if you need to call an overload of the method, you can obtain a for that overload and pass it to the method to obtain a token to embed in your MSIL. + + Once you have created arrays for your local variable signature, exceptions, and code body, you can use the , , and methods to insert them into the associated with your object. + Generating your own metadata and MSIL requires familiarity with the Common Language Infrastructure (CLI) documentation, especially "Partition II: Metadata Definition and Semantics" and "Partition III: CIL Instruction Set". For more information, see [ECMA 335 Common Language Infrastructure (CLI)](https://www.ecma-international.org/publications-and-standards/standards/ecma-335/). - + > [!NOTE] -> Do not use to generate code that creates a delegate to another dynamic method by calling the delegate constructor directly. Instead, use the method to create the delegate. A delegate that is created with the delegate constructor does not have a reference to the target dynamic method. The dynamic method might be reclaimed by garbage collection while the delegate is still in use. - +> Do not use to generate code that creates a delegate to another dynamic method by calling the delegate constructor directly. Instead, use the method to create the delegate. A delegate that is created with the delegate constructor does not have a reference to the target dynamic method. The dynamic method might be reclaimed by garbage collection while the delegate is still in use. + ]]> @@ -110,11 +110,11 @@ Gets the dynamic method whose body is generated by the current instance. A object representing the dynamic method for which the current object is generating code. - object is always associated with a dynamic method. The purpose of the class is to provide another way of inserting the MSIL stream, exception handling, and local variable signature into a dynamic method, for developers who want to generate MSIL without using the class. - + object is always associated with a dynamic method. The purpose of the class is to provide another way of inserting the MSIL stream, exception handling, and local variable signature into a dynamic method, for developers who want to generate MSIL without using the class. + ]]> @@ -169,11 +169,11 @@ Gets a token, valid in the scope of the current , representing the signature for the associated dynamic method. A token that can be embedded in the metadata and the MSIL stream for the associated dynamic method. - @@ -218,11 +218,11 @@ Gets a token, valid in the scope of the current , representing a dynamic method to be called from the associated method. A token that can be embedded in the MSIL stream for the associated dynamic method, as the target of an MSIL instruction. - object. To call the associated dynamic method recursively, pass the value of the property. - + object. To call the associated dynamic method recursively, pass the value of the property. + ]]> @@ -267,11 +267,11 @@ Gets a token, valid in the scope of the current , representing a field to be accessed from the associated dynamic method. A token that can be used as the operand of an MSIL instruction that accesses fields, in the scope of the current object. - object. Use the method to get a for the field you want to access, then use the property to get the . - + object. Use the method to get a for the field you want to access, then use the property to get the . + ]]> @@ -322,14 +322,14 @@ Gets a token, valid in the scope of the current , representing a method to be accessed from the associated dynamic method. A token that can be used as the operand of an MSIL instruction that accesses methods, such as or , in the scope of the current object. - object. Use the method to get a for the method you want to access, and then use the property to get the . - + object. Use the method to get a for the method you want to access, and then use the property to get the . + > [!NOTE] -> For a method that belongs to a generic type, use the method overload and specify a for the generic type. - +> For a method that belongs to a generic type, use the method overload and specify a for the generic type. + ]]> @@ -374,13 +374,13 @@ Gets a token, valid in the scope of the current , representing a type to be used in the associated dynamic method. A token that can be used as the operand of an MSIL instruction that requires a type, in the scope of the current object. - object. - - To get a representing a type, use the property. - + object. + + To get a representing a type, use the property. + ]]> @@ -468,11 +468,11 @@ Gets a token, valid in the scope of the current , representing a field to be accessed from the associated dynamic method; the field is on the specified generic type. A token that can be used as the operand of an MSIL instruction that accesses fields in the scope of the current object. - object. Use the method to get a for the field you want to access, and then use the property to get the . - + object. Use the method to get a for the field you want to access, and then use the property to get the . + ]]> @@ -519,11 +519,11 @@ Gets a token, valid in the scope of the current , representing a method on a generic type. A token that can be used as the operand of an MSIL instruction that accesses methods, such as or , in the scope of the current object. - object. Use the method to get a for the method you want to call, and then use the property to get the . - + object. Use the method to get a for the method you want to call, and then use the property to get the . + ]]> @@ -580,15 +580,15 @@ The maximum number of items on the operand stack when the method is executing. Sets the code body of the associated dynamic method. - @@ -645,15 +645,15 @@ The maximum number of items on the operand stack when the method is executing. Sets the code body of the associated dynamic method. - @@ -713,11 +713,11 @@ An array that contains the exception metadata. Sets the exception metadata for the associated dynamic method. - @@ -772,18 +772,18 @@ The number of bytes of exception metadata. Sets the exception metadata for the associated dynamic method. - - is and is greater than 0. + is and is greater than 0. - is less than 0. + is less than 0. @@ -836,13 +836,13 @@ An array that contains the layout of local variables for the associated . Sets the local variable signature that describes the layout of local variables for the associated dynamic method. - method to get a for the local signature. - + method to get a for the local signature. + For information on local variable signatures, see the Common Language Infrastructure (CLI) documentation, especially "Partition II: Metadata Definition and Semantics". For more information, see [ECMA 335 Common Language Infrastructure (CLI)](https://www.ecma-international.org/publications-and-standards/standards/ecma-335/). - + ]]> @@ -897,13 +897,13 @@ The number of bytes in the signature. Sets the local variable signature that describes the layout of local variables for the associated dynamic method. - method to get a for the local signature. - + method to get a for the local signature. + For information on local variable signatures, see the Common Language Infrastructure (CLI) documentation, especially "Partition II: Metadata Definition and Semantics". For more information, see [ECMA 335 Common Language Infrastructure (CLI)](https://www.ecma-international.org/publications-and-standards/standards/ecma-335/). - + ]]> diff --git a/xml/System.Reflection.Emit/DynamicMethod.xml b/xml/System.Reflection.Emit/DynamicMethod.xml index 40153c3ff04..3db6a665d24 100644 --- a/xml/System.Reflection.Emit/DynamicMethod.xml +++ b/xml/System.Reflection.Emit/DynamicMethod.xml @@ -1988,11 +1988,6 @@ The following code example creates a dynamic method that takes two parameters. T This method does not demand permissions directly, but invoking the dynamic method can result in security demands, depending on the method. For example, no demands are made for anonymously hosted dynamic methods that are created with the `restrictedSkipVisibility` parameter set to `false`. On the other hand, if you create a method with `restrictedSkipVisibility` set to `true` so it can access a hidden member of a target assembly, the method will cause a demand for the permissions of the target assembly plus with the flag. -> [!NOTE] -> Prior to .NET Framework 2.0, this method required with the flag. - - - ## Examples The following code example invokes a dynamic method with exact binding, using the US-English culture. This code example is part of a larger example provided for the class. diff --git a/xml/System.Reflection.Emit/EnumBuilder.xml b/xml/System.Reflection.Emit/EnumBuilder.xml index f155695c599..9407747e51a 100644 --- a/xml/System.Reflection.Emit/EnumBuilder.xml +++ b/xml/System.Reflection.Emit/EnumBuilder.xml @@ -3739,7 +3739,7 @@ The following code sample demonstrates the use of the `AssemblyQualifiedName` pr ]]> - is . + is . diff --git a/xml/System.Reflection.Emit/EventBuilder.xml b/xml/System.Reflection.Emit/EventBuilder.xml index bef0e32ad85..100b95b3e20 100644 --- a/xml/System.Reflection.Emit/EventBuilder.xml +++ b/xml/System.Reflection.Emit/EventBuilder.xml @@ -367,7 +367,7 @@ Sets a custom attribute using a custom attribute builder. To be added. - is . + is . has been called on the enclosing type. diff --git a/xml/System.Reflection.Emit/FieldBuilder.xml b/xml/System.Reflection.Emit/FieldBuilder.xml index 0ecf08ac094..58d40f419ed 100644 --- a/xml/System.Reflection.Emit/FieldBuilder.xml +++ b/xml/System.Reflection.Emit/FieldBuilder.xml @@ -902,7 +902,7 @@ ]]> - is . + is . The parent type of this field is complete. diff --git a/xml/System.Reflection.Emit/ILGenerator.xml b/xml/System.Reflection.Emit/ILGenerator.xml index 552c94ea575..49639a6e8a1 100644 --- a/xml/System.Reflection.Emit/ILGenerator.xml +++ b/xml/System.Reflection.Emit/ILGenerator.xml @@ -1174,7 +1174,7 @@ ]]> - is . This exception is new in the .NET Framework 4. + is . @@ -1302,8 +1302,6 @@ Labels are created using and their location within the stream is fixed by using . If a single-byte instruction is used, the label can represent a jump of at most 127 bytes along the stream. `opcode` must represent a branch instruction. Because branches are relative instructions, `label` will be replaced with the correct offset to branch during the fixup process. - - ## Examples The code sample below illustrates the creation of a dynamic method with a jump table. The jump table is built using an array of . @@ -1313,8 +1311,6 @@ ]]> - - is . This exception is new in the .NET Framework 4. diff --git a/xml/System.Reflection.Emit/ModuleBuilder.xml b/xml/System.Reflection.Emit/ModuleBuilder.xml index ed15f9e494d..cbaad27085b 100644 --- a/xml/System.Reflection.Emit/ModuleBuilder.xml +++ b/xml/System.Reflection.Emit/ModuleBuilder.xml @@ -3229,7 +3229,6 @@ ]]> - The parameter is . @@ -5438,13 +5437,8 @@ ## Remarks This method does nothing. -> [!NOTE] -> Starting with the .NET Framework 2.0 Service Pack 1, this member no longer requires with the flag. (See [Security Issues in Reflection Emit](/dotnet/framework/reflection-and-codedom/security-issues-in-reflection-emit).) To use this functionality, your application should target the .NET Framework 3.5 or later. - ]]> - - is . diff --git a/xml/System.Reflection.Emit/ParameterBuilder.xml b/xml/System.Reflection.Emit/ParameterBuilder.xml index 52c6681a8e8..27889885838 100644 --- a/xml/System.Reflection.Emit/ParameterBuilder.xml +++ b/xml/System.Reflection.Emit/ParameterBuilder.xml @@ -535,7 +535,7 @@ Set a custom attribute using a custom attribute builder. To be added. - is . + is . diff --git a/xml/System.Reflection.Emit/PersistedAssemblyBuilder.xml b/xml/System.Reflection.Emit/PersistedAssemblyBuilder.xml index 76eed2dabda..8f14876da81 100644 --- a/xml/System.Reflection.Emit/PersistedAssemblyBuilder.xml +++ b/xml/System.Reflection.Emit/PersistedAssemblyBuilder.xml @@ -65,7 +65,7 @@ For more information about this API, see [Persisted dynamic assemblies in .NET]( A collection that contains the attributes of the assembly. Creates a instance that can be saved to a file or stream. Currently the persisted assembly doesn't support running. You must save it and load it back to run. - The or or is . + The or is . diff --git a/xml/System.Reflection.Emit/SignatureHelper.xml b/xml/System.Reflection.Emit/SignatureHelper.xml index b0c5aa1f393..9a75670421b 100644 --- a/xml/System.Reflection.Emit/SignatureHelper.xml +++ b/xml/System.Reflection.Emit/SignatureHelper.xml @@ -785,7 +785,7 @@ For more information, see [ECMA 335 Common Language Infrastructure (CLI)](https: The object for a method. To be added. - is an unknown unmanaged calling convention. + is an unknown unmanaged calling convention. diff --git a/xml/System.Reflection.Metadata.Ecma335/MetadataRootBuilder.xml b/xml/System.Reflection.Metadata.Ecma335/MetadataRootBuilder.xml index 975b561ab7d..31d7e72332f 100644 --- a/xml/System.Reflection.Metadata.Ecma335/MetadataRootBuilder.xml +++ b/xml/System.Reflection.Metadata.Ecma335/MetadataRootBuilder.xml @@ -80,7 +80,7 @@ Metadata root constitutes of a metadata header followed by metadata streams (`#~ Builder populated with metadata entities stored in tables and values stored in heaps. The entities and values will be enumerated when serializing the metadata root. The version string written to the metadata header. The default value is "v4.0.30319". - to suppress basic validation of metadata tables during serialization; otherwise, . + to suppress basic validation of metadata tables during serialization; otherwise, . Creates a builder of a metadata root. .NET for Win > [!NOTE] > If the type has been forwarded to another assembly, it is still returned by this method. For information on type forwarding, see [Type Forwarding in the Common Language Runtime](/dotnet/standard/assembly/type-forwarding). - - ## Examples The following example defines an abstract `MeansOfTransportation` class in the `Transportation` namespace. It calls the method to retrieve its object, calls the method to get an array of objects that represent the type's properties, and then displays information on the type's abstract properties. Note that the call to the method uses the type's fully qualified name (that is, its namespace along with its type name). @@ -3275,11 +3273,9 @@ Note: In .NET for Win -or- The current assembly was loaded into the reflection-only context, and requires a dependent assembly that was not preloaded. - -Note: In .NET for Windows Store apps or the Portable Class Library, catch the base class exception, , instead. - requires a dependent assembly, but the file is not a valid assembly for the currently loaded runtime. + requires a dependent assembly, but the file is not a valid assembly for the currently loaded runtime. @@ -3384,7 +3380,7 @@ Note: In .NET for Win The current assembly was loaded into the reflection-only context, and requires a dependent assembly that was not preloaded. - requires a dependent assembly, but the file is not a valid assembly for the currently loaded runtime. + requires a dependent assembly, but the file is not a valid assembly for the currently loaded runtime. @@ -3489,7 +3485,7 @@ Note: In .NET for Win The current assembly was loaded into the reflection-only context, and requires a dependent assembly that was not preloaded. - requires a dependent assembly, but the file is not a valid assembly for the currently loaded runtime. + requires a dependent assembly, but the file is not a valid assembly for the currently loaded runtime. @@ -5595,7 +5591,7 @@ The assembly is loaded into the default AssemblyLoadContext. For more informatio The parameter is . - is not a valid assembly for the currently loaded runtime. + The assembly is not a valid assembly for the currently loaded runtime. @@ -5665,7 +5661,7 @@ The assembly is loaded into the default AssemblyLoadContext. For more informatio An assembly or module was loaded twice with two different sets of evidence. The parameter is . - is not a valid assembly for the currently loaded runtime. + The assembly is not a valid assembly for the currently loaded runtime. diff --git a/xml/System.Reflection/ConstructorInfo.xml b/xml/System.Reflection/ConstructorInfo.xml index 633ede7370f..1e7d646ea44 100644 --- a/xml/System.Reflection/ConstructorInfo.xml +++ b/xml/System.Reflection/ConstructorInfo.xml @@ -1057,7 +1057,7 @@ Note: In .NET for Win The instance that created this method. - An array of objects used to match the number, order, and type of the parameters for this constructor, under the constraints of . If this constructor does not require parameters, pass an array with zero elements. Any object in this array that is not explicitly initialized with a value will contain the default value for that object type. For reference-type elements, this value is . For value-type elements, this value is 0, 0.0, or , depending on the specific element type. + An array of objects used to match the number, order, and type of the parameters for this constructor. If this constructor does not require parameters, pass an array with zero elements. Any object in this array that is not explicitly initialized with a value will contain the default value for that object type. For reference-type elements, this value is . For value-type elements, this value is 0, 0.0, or , depending on the specific element type. Provides COM objects with version-independent access to the method. An instance of the type. @@ -1155,7 +1155,7 @@ Note: In .NET for Win - An array of objects used to match the number, order, and type of the parameters for this constructor, under the constraints of . If this constructor does not require parameters, pass an array with zero elements. Any object in this array that is not explicitly initialized with a value will contain the default value for that object type. For reference-type elements, this value is . For value-type elements, this value is 0, 0.0, or , depending on the specific element type. + An array of objects used to match the number, order, and type of the parameters for this constructor. If this constructor does not require parameters, pass an array with zero elements. Any object in this array that is not explicitly initialized with a value will contain the default value for that object type. For reference-type elements, this value is . For value-type elements, this value is 0, 0.0, or , depending on the specific element type. Provides COM objects with version-independent access to the method. An instance of the type. diff --git a/xml/System.Reflection/ICustomAttributeProvider.xml b/xml/System.Reflection/ICustomAttributeProvider.xml index 34730f8fdf2..1a7fd67a714 100644 --- a/xml/System.Reflection/ICustomAttributeProvider.xml +++ b/xml/System.Reflection/ICustomAttributeProvider.xml @@ -62,11 +62,11 @@ Provides custom attributes for reflection objects that support them. - @@ -127,17 +127,16 @@ Returns an array of all of the custom attributes defined on this member, excluding named attributes, or an empty array if there are no custom attributes. An array of Objects representing custom attributes, or an empty array. - on or when the `inherit` parameter of `GetCustomAttributes` is `true` does not walk the type hierarchy. Use to inherit custom attributes. - - This method returns custom attributes defined directly on a non-inherited member only. - + on or when the `inherit` parameter of `GetCustomAttributes` is `true` does not walk the type hierarchy. Use to inherit custom attributes. + + This method returns custom attributes defined directly on a non-inherited member only. + ]]> The custom attribute type cannot be loaded. - There is more than one attribute of type defined on this member. @@ -189,15 +188,15 @@ Returns an array of custom attributes defined on this member, identified by type, or an empty array if there are no custom attributes of that type. An array of Objects representing custom attributes, or an empty array. - on or when the `inherit` parameter of `GetCustomAttributes` is `true` does not walk the type hierarchy. Use to inherit custom attributes. - + on or when the `inherit` parameter of `GetCustomAttributes` is `true` does not walk the type hierarchy. Use to inherit custom attributes. + ]]> The custom attribute type cannot be loaded. diff --git a/xml/System.Resources.Tools/ITargetAwareCodeDomProvider.xml b/xml/System.Resources.Tools/ITargetAwareCodeDomProvider.xml index e8d48d5edac..b8f883f3ff7 100644 --- a/xml/System.Resources.Tools/ITargetAwareCodeDomProvider.xml +++ b/xml/System.Resources.Tools/ITargetAwareCodeDomProvider.xml @@ -69,7 +69,7 @@ A flag that indicates whether the property must include a get accessor. Indicates whether the specified type on the project target framework has a specified named property. - if on the project target framework has a property named ; otherwise, . + if on the project target framework has a property named ; otherwise, . To be added. diff --git a/xml/System.Resources.Tools/StronglyTypedResourceBuilder.xml b/xml/System.Resources.Tools/StronglyTypedResourceBuilder.xml index f699bc209c1..46ae3c0a9fb 100644 --- a/xml/System.Resources.Tools/StronglyTypedResourceBuilder.xml +++ b/xml/System.Resources.Tools/StronglyTypedResourceBuilder.xml @@ -144,7 +144,7 @@ ]]> - , , or is . + , , or is . A resource node name does not match its key in . @@ -221,7 +221,7 @@ ]]> - or is . + or is . @@ -306,7 +306,7 @@ System.Resources.ResourceManager rm = new System.Resources.ResourceManager(" - , , or is . + , , or is . A resource node name does not match its key in . @@ -386,7 +386,7 @@ System.Resources.ResourceManager rm = new System.Resources.ResourceManager(" - or is . + or is . diff --git a/xml/System.Resources/ResXResourceWriter.xml b/xml/System.Resources/ResXResourceWriter.xml index 55e597c4c9d..b997e4d3d1d 100644 --- a/xml/System.Resources/ResXResourceWriter.xml +++ b/xml/System.Resources/ResXResourceWriter.xml @@ -179,7 +179,7 @@ ]]> - The directory specified in does not exist. + The directory specified in does not exist. @@ -312,7 +312,7 @@ ]]> - The directory specified in does not exist. + The directory specified in does not exist. diff --git a/xml/System.Resources/ResourceManager.xml b/xml/System.Resources/ResourceManager.xml index 59111cb6aff..bd835b7b6f8 100644 --- a/xml/System.Resources/ResourceManager.xml +++ b/xml/System.Resources/ResourceManager.xml @@ -327,7 +327,7 @@ ]]> - is not a derived class of . + is not a derived class of . The or parameter is . This constructor lets you specify a implementation. If you do not want a specific implementation but would like to use a custom resource file format, you should derive from the class, override the and methods, and pass that type to this constructor. diff --git a/xml/System.Runtime.Caching/MemoryCache.xml b/xml/System.Runtime.Caching/MemoryCache.xml index 186f62ae85b..9d94f787f82 100644 --- a/xml/System.Runtime.Caching/MemoryCache.xml +++ b/xml/System.Runtime.Caching/MemoryCache.xml @@ -1170,7 +1170,7 @@ private void btnGet_Click(object sender, EventArgs e) -or- - is . + is . - An invalid combination of arguments for the cache entry was passed. This occurs if the following expiration details are set on the policy object for the cache entry: - If both the absolute and sliding expiration values on object are set to values other than the defaults of and . This occurs because the class does not support expiring entries based on both an absolute and a sliding expiration. Only one expiration setting can be explicitly set when you use the class. The other setting must be set to or . diff --git a/xml/System.Runtime.InteropServices.ComTypes/IDataObject.xml b/xml/System.Runtime.InteropServices.ComTypes/IDataObject.xml index ddb5456c896..6398eb54680 100644 --- a/xml/System.Runtime.InteropServices.ComTypes/IDataObject.xml +++ b/xml/System.Runtime.InteropServices.ComTypes/IDataObject.xml @@ -55,13 +55,13 @@ Provides the managed definition of the interface. - @@ -113,39 +113,39 @@ A pointer to the interface on the advisory sink that will receive the change notification. When this method returns, contains a pointer to a DWORD token that identifies this connection. You can use this token later to delete the advisory connection by passing it to . If this value is zero, the connection was not established. This parameter is passed uninitialized. Creates a connection between a data object and an advisory sink. This method is called by an object that supports an advisory sink and enables the advisory sink to be notified of changes in the object's data. - This method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following: - - Value - - Description - - S_OK - - The advisory connection was created. - - E_NOTIMPL - - This method is not implemented on the data object. - - DV_E_LINDEX - - There is an invalid value for ; currently, only -1 is supported. - - DV_E_FORMATETC - - There is an invalid value for the parameter. - - OLE_E_ADVISENOTSUPPORTED - - The data object does not support change notification. - + This method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following: + + Value + + Description + + S_OK + + The advisory connection was created. + + E_NOTIMPL + + This method is not implemented on the data object. + + DV_E_LINDEX + + There is an invalid value for ; currently, only -1 is supported. + + DV_E_FORMATETC + + There is an invalid value for the parameter. + + OLE_E_ADVISENOTSUPPORTED + + The data object does not support change notification. + - @@ -191,11 +191,11 @@ A DWORD token that specifies the connection to remove. Use the value returned by when the connection was originally established. Destroys a notification connection that had been previously established. - @@ -241,27 +241,27 @@ When this method returns, contains an that receives the interface pointer to the new enumerator object. If the implementation sets to , there are no connections to advisory sinks at this time. This parameter is passed uninitialized. Creates an object that can be used to enumerate the current advisory connections. - This method supports the standard return value E_OUTOFMEMORY, as well as the following: - - Value - - Description - - S_OK - - The enumerator object is successfully instantiated or there are no connections. - - OLE_E_ADVISENOTSUPPORTED - - This object does not support advisory notifications. - + This method supports the standard return value E_OUTOFMEMORY, as well as the following: + + Value + + Description + + S_OK + + The enumerator object is successfully instantiated or there are no connections. + + OLE_E_ADVISENOTSUPPORTED + + This object does not support advisory notifications. + - @@ -306,31 +306,31 @@ One of the values that specifies the direction of the data. Creates an object for enumerating the structures for a data object. These structures are used in calls to or . - This method supports the standard return values E_INVALIDARG and E_OUTOFMEMORY, as well as the following: - - Value - - Description - - S_OK - - The enumerator object was successfully created. - - E_NOTIMPL - - The direction specified by the parameter is not supported. - - OLE_S_USEREG - - Requests that OLE enumerate the formats from the registry. - + This method supports the standard return values E_INVALIDARG and E_OUTOFMEMORY, as well as the following: + + Value + + Description + + S_OK + + The enumerator object was successfully created. + + E_NOTIMPL + + The direction specified by the parameter is not supported. + + OLE_S_USEREG + + Requests that OLE enumerate the formats from the registry. + - @@ -378,39 +378,39 @@ A pointer to a structure, passed by reference, that defines the format, medium, and target device that the caller would like to use to retrieve data in a subsequent call such as . The member is not significant in this case and should be ignored. When this method returns, contains a pointer to a structure that contains the most general information possible for a specific rendering, making it canonically equivalent to formatetcIn. The caller must allocate this structure and the method must fill in the data. To retrieve data in a subsequent call such as , the caller uses the supplied value of , unless the value supplied is . This value is if the method returns . The member is not significant in this case and should be ignored. This parameter is passed uninitialized. Provides a standard structure that is logically equivalent to a more complex structure. Use this method to determine whether two different structures would return the same data, removing the need for duplicate rendering. - This method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following: - - Value - - Description - - S_OK - - The returned structure is different from the one that was passed. - - DATA_S_SAMEFORMATETC - - The structures are the same and is returned in the parameter. - - DV_E_LINDEX - - There is an invalid value for ; currently, only -1 is supported. - - DV_E_FORMATETC - - There is an invalid value for the parameter. - - OLE_E_NOTRUNNING - - The application is not running. - + This method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following: + + Value + + Description + + S_OK + + The returned structure is different from the one that was passed. + + DATA_S_SAMEFORMATETC + + The structures are the same and is returned in the parameter. + + DV_E_LINDEX + + There is an invalid value for ; currently, only -1 is supported. + + DV_E_FORMATETC + + There is an invalid value for the parameter. + + OLE_E_NOTRUNNING + + The application is not running. + - @@ -459,11 +459,11 @@ When this method returns, contains a pointer to the structure that indicates the storage medium containing the returned data through its member, and the responsibility for releasing the medium through the value of its member. If is , the receiver of the medium is responsible for releasing it; otherwise, points to the interface on the appropriate object so its method can be called. The medium must be allocated and filled in by . This parameter is passed uninitialized. Obtains data from a source data object. The method, which is called by a data consumer, renders the data described in the specified structure and transfers it through the specified structure. The caller then assumes responsibility for releasing the structure. - @@ -512,11 +512,11 @@ A , passed by reference, that defines the storage medium containing the data being transferred. The medium must be allocated by the caller and filled in by . The caller must also free the medium. The implementation of this method must always supply a value of for the member of the structure that this parameter points to. Obtains data from a source data object. This method, which is called by a data consumer, differs from the method in that the caller must allocate and free the specified storage medium. - @@ -562,43 +562,43 @@ A pointer to a structure, passed by reference, that defines the format, medium, and target device to use for the query. Determines whether the data object is capable of rendering the data described in the structure. Objects attempting a paste or drop operation can call this method before calling to get an indication of whether the operation may be successful. - This method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following: - - Value - - Description - - S_OK - - A subsequent call to would probably be successful. - - DV_E_LINDEX - - An invalid value for ; currently, only -1 is supported. - - DV_E_FORMATETC - - An invalid value for the parameter. - - DV_E_TYMED - - An invalid value. - - DV_E_DVASPECT - - An invalid value. - - OLE_E_NOTRUNNING - - The application is not running. - + This method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following: + + Value + + Description + + S_OK + + A subsequent call to would probably be successful. + + DV_E_LINDEX + + An invalid value for ; currently, only -1 is supported. + + DV_E_FORMATETC + + An invalid value for the parameter. + + DV_E_TYMED + + An invalid value. + + DV_E_DVASPECT + + An invalid value. + + OLE_E_NOTRUNNING + + The application is not running. + - @@ -650,11 +650,11 @@ to specify that the data object called, which implements , owns the storage medium after the call returns. This means that the data object must free the medium after it has been used by calling the function. to specify that the caller retains ownership of the storage medium, and the data object called uses the storage medium for the duration of the call only. Transfers data to the object that implements this method. This method is called by an object that contains a data source. - diff --git a/xml/System.Runtime.InteropServices.WindowsRuntime/WindowsRuntimeBufferExtensions.xml b/xml/System.Runtime.InteropServices.WindowsRuntime/WindowsRuntimeBufferExtensions.xml index ded3f6141d3..7ed22263c76 100644 --- a/xml/System.Runtime.InteropServices.WindowsRuntime/WindowsRuntimeBufferExtensions.xml +++ b/xml/System.Runtime.InteropServices.WindowsRuntime/WindowsRuntimeBufferExtensions.xml @@ -520,7 +520,7 @@ or is less than 0 (zero). - is beyond the end of . + is beyond the end of . cannot expose its underlying memory buffer. diff --git a/xml/System.Runtime.InteropServices/Marshal.xml b/xml/System.Runtime.InteropServices/Marshal.xml index 116f54ddbda..0b202c48b83 100644 --- a/xml/System.Runtime.InteropServices/Marshal.xml +++ b/xml/System.Runtime.InteropServices/Marshal.xml @@ -2337,7 +2337,7 @@ ]]> - has an automatic layout. Use sequential or explicit instead. + has an automatic layout. Use sequential or explicit instead. Blittable and Non-Blittable types diff --git a/xml/System.Runtime.InteropServices/NativeLibrary.xml b/xml/System.Runtime.InteropServices/NativeLibrary.xml index 378bd57b6bc..489bf4047eb 100644 --- a/xml/System.Runtime.InteropServices/NativeLibrary.xml +++ b/xml/System.Runtime.InteropServices/NativeLibrary.xml @@ -385,7 +385,7 @@ Calling this method with a invalid `handle` parameter other than if the native library was loaded successfully; otherwise, . To be added. - or is . + or is . is not a . diff --git a/xml/System.Runtime.InteropServices/_Type.xml b/xml/System.Runtime.InteropServices/_Type.xml index b58e0eafe02..163df05f597 100644 --- a/xml/System.Runtime.InteropServices/_Type.xml +++ b/xml/System.Runtime.InteropServices/_Type.xml @@ -38,13 +38,13 @@ Exposes the public members of the class to the unmanaged code. - class members that can be accessed by unmanaged COM objects. - + class members that can be accessed by unmanaged COM objects. + ]]> @@ -70,13 +70,13 @@ Provides COM objects with version-independent access to the property. An instance that describes the assembly containing the current type. - property gets the in which the type is declared. For generic types, this property gets the in which the generic type is defined. - + property gets the in which the type is declared. For generic types, this property gets the in which the generic type is defined. + ]]> @@ -102,13 +102,13 @@ Provides COM objects with version-independent access to the property. The assembly-qualified name of the , including the name of the assembly from which the was loaded. - property gets the assembly-qualified name of the , including the name of the assembly from which the was loaded. - + property gets the assembly-qualified name of the , including the name of the assembly from which the was loaded. + ]]> @@ -134,13 +134,13 @@ Provides COM objects with version-independent access to the property. A object representing the attribute set of the , unless the represents a generic type parameter, in which case the value is unspecified. - property gets the attributes associated with the . - + property gets the attributes associated with the . + ]]> @@ -166,13 +166,13 @@ Provides COM objects with version-independent access to the property. The from which the current directly inherits, or if the current represents the class. - property gets the type from which the current directly inherits. - + property gets the type from which the current directly inherits. + ]]> @@ -198,13 +198,13 @@ Provides COM objects with version-independent access to the property. The object for the class that declares this member. If the type is a nested type, this property returns the enclosing type. - property gets the class that declares this member. - + property gets the class that declares this member. + ]]> @@ -218,15 +218,15 @@ Provides COM objects with version-independent access to the method. - method determines if the underlying system type of the current is the same as the underlying system type of the specified or . - - . - + method determines if the underlying system type of the current is the same as the underlying system type of the specified or . + + . + ]]> @@ -255,15 +255,15 @@ The whose underlying system type is to be compared with the underlying system type of the current . Provides COM objects with version-independent access to the method. - if the underlying system type of is the same as the underlying system type of the current ; otherwise, . + if the underlying system type of is the same as the underlying system type of the current ; otherwise, . - method determines if the underlying system type of the current is the same as the underlying system type of the specified . - + method determines if the underlying system type of the current is the same as the underlying system type of the specified . + ]]> @@ -294,13 +294,13 @@ if the underlying system type of is the same as the underlying system type of the current ; otherwise, . - method determines if the underlying system type of the current is the same as the underlying system type of the specified . - + method determines if the underlying system type of the current is the same as the underlying system type of the specified . + ]]> @@ -330,19 +330,19 @@ The delegate that compares the interfaces against . The search criteria that determines whether an interface should be included in the returned array. Provides COM objects with version-independent access to the method. - An array of objects representing a filtered list of the interfaces implemented or inherited by the current . - - -or- - + An array of objects representing a filtered list of the interfaces implemented or inherited by the current . + + -or- + An empty array of type , if no interfaces matching the filter are implemented or inherited by the current . - method returns an array of objects representing a filtered list of interfaces implemented or inherited by the current . - + method returns an array of objects representing a filtered list of interfaces implemented or inherited by the current . + ]]> @@ -372,29 +372,29 @@ A object indicating the type of member to search for. - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . The delegate that does the comparisons, returning if the member currently being inspected matches the and otherwise. You can use the , , and delegates supplied by this class. The first uses the fields of , , and as search criteria, and the other two delegates use objects as the search criteria. - The search criteria that determines whether a member is returned in the array of objects. - + The search criteria that determines whether a member is returned in the array of objects. + The fields of , , and can be used in conjunction with the delegate supplied by this class. Provides COM objects with version-independent access to the method. - A filtered array of objects of the specified member type. - - -or- - + A filtered array of objects of the specified member type. + + -or- + An empty array of type , if the current does not have members of type that match the filter criteria. - method returns a filtered array of objects of the specified member type. - + method returns a filtered array of objects of the specified member type. + ]]> @@ -420,13 +420,13 @@ Provides COM objects with version-independent access to the property. A string containing the fully qualified name of the , including the namespace of the but not the assembly. - property gets the fully qualified name of the , including the namespace of the but not the assembly. - + property gets the fully qualified name of the , including the namespace of the but not the assembly. + ]]> @@ -453,13 +453,13 @@ Provides COM objects with version-independent access to the method. An containing the number of dimensions in the current . - method gets the number of dimensions in an . - + method gets the number of dimensions in an . + ]]> @@ -473,13 +473,13 @@ Provides COM objects with version-independent access to the method. - method gets a specific constructor of the current . - + method gets a specific constructor of the current . + ]]> @@ -505,21 +505,21 @@ - An array of objects representing the number, order, and type of the parameters for the desired constructor. - - -or- - + An array of objects representing the number, order, and type of the parameters for the desired constructor. + + -or- + An empty array of objects, to get a constructor that takes no parameters. Such an empty array is provided by the field . Provides COM objects with version-independent access to the method. A object representing the public instance constructor whose parameters match the types in the parameter type array, if found; otherwise, . - method searches for a public instance constructor whose parameters match the types in the specified array. - + method searches for a public instance constructor whose parameters match the types in the specified array. + ]]> @@ -548,36 +548,36 @@ - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . - A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. - - -or- - + A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. + + -or- + , to use the . - An array of objects representing the number, order, and type of the parameters for the constructor to get. - - -or- - - An empty array of the type (that is, Type[] types = new Type[0]) to get a constructor that takes no parameters. - - -or- - + An array of objects representing the number, order, and type of the parameters for the constructor to get. + + -or- + + An empty array of the type (that is, Type[] types = new Type[0]) to get a constructor that takes no parameters. + + -or- + . An array of objects representing the attributes associated with the corresponding element in the parameter type array. The default binder does not process this parameter. Provides COM objects with version-independent access to the method. A object representing the constructor that matches the specified requirements, if found; otherwise, . - method searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints. - + method searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints. + ]]> @@ -607,33 +607,33 @@ - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . - A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. - - -or- - + A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. + + -or- + , to use the . The object that specifies the set of rules to use regarding the order and layout of arguments, how the return value is passed, what registers are used for arguments, and the stack is cleaned up. - An array of objects representing the number, order, and type of the parameters for the constructor to get. - - -or- - + An array of objects representing the number, order, and type of the parameters for the constructor to get. + + -or- + An empty array of the type (that is, Type[] types = new Type[0]) to get a constructor that takes no parameters. An array of objects representing the attributes associated with the corresponding element in the array. The default binder does not process this parameter. Provides COM objects with version-independent access to the method. A object representing the constructor that matches the specified requirements, if found; otherwise, . - method searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention. - + method searches for a constructor whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention. + ]]> @@ -647,13 +647,13 @@ Provides COM objects with version-independent access to the method. - method gets the constructors of the current . - + method gets the constructors of the current . + ]]> @@ -680,13 +680,13 @@ Provides COM objects with version-independent access to the method. An array of objects representing all the public instance constructors defined for the current , but not including the type initializer (static constructor). If no public instance constructors are defined for the current , or if the current represents a type parameter of a generic type or method definition, an empty array of type is returned. - method returns all the public constructors defined for the current . - + method returns all the public constructors defined for the current . + ]]> @@ -712,21 +712,21 @@ - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . Provides COM objects with version-independent access to the method. An array of objects representing all constructors defined for the current that match the specified binding constraints, including the type initializer if it is defined. Returns an empty array of type if no constructors are defined for the current , if none of the defined constructors match the binding constraints, or if the current represents a type parameter of a generic type or method definition. - method searches for the constructors defined for the current , using the specified . - + method searches for the constructors defined for the current , using the specified . + ]]> @@ -740,13 +740,13 @@ Provides COM objects with version-independent access to the method. - method returns all attributes applied to this member. - + method returns all attributes applied to this member. + ]]> @@ -776,13 +776,13 @@ Provides COM objects with version-independent access to the method. An array of custom attributes applied to this member, or an array with zero (0) elements if no attributes have been applied. - method returns all attributes applied to this member. - + method returns all attributes applied to this member. + ]]> @@ -814,13 +814,13 @@ Provides COM objects with version-independent access to the method. An array of custom attributes applied to this member, or an array with zero (0) elements if no attributes have been applied. - method returns all attributes applied to this member. - + method returns all attributes applied to this member. + ]]> @@ -845,19 +845,19 @@ Provides COM objects with version-independent access to the method. - An array of objects representing all default members of the current . - - -or- - + An array of objects representing all default members of the current . + + -or- + An empty array of type , if the current does not have default members. - method searches for the members defined for the current whose is set. - + method searches for the members defined for the current whose is set. + ]]> @@ -882,19 +882,19 @@ Provides COM objects with version-independent access to the method. - The of the object encompassed or referred to by the current array, pointer or reference type. - - -or- - + The of the object encompassed or referred to by the current array, pointer or reference type. + + -or- + if the current is not an array or a pointer, or is not passed by reference, or represents a generic type or a type parameter of a generic type or method definition. - method returns the of the object encompassed or referred to by the current array, pointer or reference type. - + method returns the of the object encompassed or referred to by the current array, pointer or reference type. + ]]> @@ -908,13 +908,13 @@ Provides COM objects with version-independent access to the method. - method gets a specific event declared or inherited by the current . - + method gets a specific event declared or inherited by the current . + ]]> @@ -940,25 +940,25 @@ - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . Provides COM objects with version-independent access to the method. - An array of objects representing all events that are declared or inherited by the current that match the specified binding constraints. - - -or- - + An array of objects representing all events that are declared or inherited by the current that match the specified binding constraints. + + -or- + An empty array of type , if the current does not have events, or if none of the events match the binding constraints. - method searches for events that are declared or inherited by the current , using the specified binding constraints. - + method searches for events that are declared or inherited by the current , using the specified binding constraints. + ]]> @@ -986,21 +986,21 @@ The containing the name of an event that is declared or inherited by the current . - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . Provides COM objects with version-independent access to the method. The object representing the specified event that is declared or inherited by the current , if found; otherwise, . - method returns the object representing the specified event, using the specified binding constraints. - + method returns the object representing the specified event, using the specified binding constraints. + ]]> @@ -1014,13 +1014,13 @@ Provides COM objects with version-independent access to the method. - method gets the events that are declared or inherited by the current . - + method gets the events that are declared or inherited by the current . + ]]> @@ -1045,19 +1045,19 @@ Provides COM objects with version-independent access to the method. - An array of objects representing all the public events that are declared or inherited by the current . - - -or- - + An array of objects representing all the public events that are declared or inherited by the current . + + -or- + An empty array of type , if the current does not have public events. - method returns all the public events that are declared or inherited by the current . - + method returns all the public events that are declared or inherited by the current . + ]]> @@ -1083,25 +1083,25 @@ - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . Provides COM objects with version-independent access to the method. - An array of objects representing all events that are declared or inherited by the current that match the specified binding constraints. - - -or- - + An array of objects representing all events that are declared or inherited by the current that match the specified binding constraints. + + -or- + An empty array of type , if the current does not have events, or if none of the events match the binding constraints. - method searches for events that are declared or inherited by the current , using the specified binding constraints. - + method searches for events that are declared or inherited by the current , using the specified binding constraints. + ]]> @@ -1115,13 +1115,13 @@ Provides COM objects with version-independent access to the method. - method gets a specific field of the current . - + method gets a specific field of the current . + ]]> @@ -1151,13 +1151,13 @@ Provides COM objects with version-independent access to the method. A object representing the public field with the specified name, if found; otherwise, . - method searches for the public field with the specified name. - + method searches for the public field with the specified name. + ]]> @@ -1185,21 +1185,21 @@ The containing the name of the data field to get. - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . Provides COM objects with version-independent access to the method. A object representing the field that matches the specified requirements, if found; otherwise, . - method searches for the specified field, using the specified binding constraints. - + method searches for the specified field, using the specified binding constraints. + ]]> @@ -1213,13 +1213,13 @@ Provides COM objects with version-independent access to the method. - method gets a specific field of the current . - + method gets a specific field of the current . + ]]> @@ -1244,19 +1244,19 @@ Provides COM objects with version-independent access to the method. - An array of objects representing all the public fields defined for the current . - - -or- - + An array of objects representing all the public fields defined for the current . + + -or- + An empty array of type , if no public fields are defined for the current . - method returns all the public fields of the current . - + method returns all the public fields of the current . + ]]> @@ -1282,25 +1282,25 @@ - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . Provides COM objects with version-independent access to the method. - An array of objects representing all fields defined for the current that match the specified binding constraints. - - -or- - + An array of objects representing all fields defined for the current that match the specified binding constraints. + + -or- + An empty array of type , if no fields are defined for the current , or if none of the defined fields match the binding constraints. - method searches for the fields defined for the current , using the specified binding constraints. - + method searches for the fields defined for the current , using the specified binding constraints. + ]]> @@ -1327,13 +1327,13 @@ Provides COM objects with version-independent access to the method. An containing the hash code for this instance. - method. - + method. + ]]> @@ -1370,11 +1370,11 @@ Caller-allocated array that receives the IDs corresponding to the names. Maps a set of names to a corresponding set of dispatch identifiers. - @@ -1388,13 +1388,13 @@ Provides COM objects with version-independent access to the method. - method gets a specific interface implemented or inherited by the current . - + method gets a specific interface implemented or inherited by the current . + ]]> @@ -1424,13 +1424,13 @@ Provides COM objects with version-independent access to the method. A object representing the interface with the specified name, implemented or inherited by the current , if found; otherwise, . - method searches for the interface with the specified name. - + method searches for the interface with the specified name. + ]]> @@ -1459,21 +1459,21 @@ The containing the name of the interface to get. For generic interfaces, this is the mangled name. - to perform a case-insensitive search for . - - -or- - + to perform a case-insensitive search for . + + -or- + to perform a case-sensitive search for . Provides COM objects with version-independent access to the method. A object representing the interface with the specified name, implemented or inherited by the current , if found; otherwise, . - method searches for the specified interface, specifying whether to do a case-sensitive search. - + method searches for the specified interface, specifying whether to do a case-sensitive search. + ]]> @@ -1503,13 +1503,13 @@ Provides COM objects with version-independent access to the method. An object representing the interface mapping for . - method returns an interface mapping for the specified interface type. - + method returns an interface mapping for the specified interface type. + ]]> @@ -1534,19 +1534,19 @@ Provides COM objects with version-independent access to the method. - An array of objects representing all the interfaces implemented or inherited by the current . - - -or- - + An array of objects representing all the interfaces implemented or inherited by the current . + + -or- + An empty array of type , if no interfaces are implemented or inherited by the current . - method gets all the interfaces implemented or inherited by the current . - + method gets all the interfaces implemented or inherited by the current . + ]]> @@ -1560,13 +1560,13 @@ Provides COM objects with version-independent access to the method. - method gets the specified members of the current . - + method gets the specified members of the current . + ]]> @@ -1596,13 +1596,13 @@ Provides COM objects with version-independent access to the method. An array of objects representing the public members with the specified name, if found; otherwise, an empty array. - method searches for the public members with the specified name. - + method searches for the public members with the specified name. + ]]> @@ -1630,21 +1630,21 @@ The containing the name of the members to get. - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return an empty array. Provides COM objects with version-independent access to the method. An array of objects representing the public members with the specified name, if found; otherwise, an empty array. - method searches for the specified members, using the specified binding constraints. - + method searches for the specified members, using the specified binding constraints. + ]]> @@ -1674,21 +1674,21 @@ The containing the name of the members to get. The value to search for. - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return an empty array. Provides COM objects with version-independent access to the method. An array of objects representing the public members with the specified name, if found; otherwise, an empty array. - method searches for the specified members of the specified member type, using the specified binding constraints. - + method searches for the specified members of the specified member type, using the specified binding constraints. + ]]> @@ -1702,13 +1702,13 @@ Provides COM objects with version-independent access to the method. - method gets the members (properties, methods, fields, events, and so on) of the current . - + method gets the members (properties, methods, fields, events, and so on) of the current . + ]]> @@ -1733,19 +1733,19 @@ Provides COM objects with version-independent access to the method. - An array of objects representing all the public members of the current . - - -or- - + An array of objects representing all the public members of the current . + + -or- + An empty array of type , if the current does not have public members. - method returns all the public members of the current . - + method returns all the public members of the current . + ]]> @@ -1771,25 +1771,25 @@ - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . Provides COM objects with version-independent access to the method. - An array of objects representing all members defined for the current that match the specified binding constraints. - - -or- - + An array of objects representing all members defined for the current that match the specified binding constraints. + + -or- + An empty array of type , if no members are defined for the current , or if none of the defined members match the binding constraints. - method searches for the members defined for the current , using the specified binding constraints. - + method searches for the members defined for the current , using the specified binding constraints. + ]]> @@ -1803,13 +1803,13 @@ Provides COM objects with version-independent access to the method. - method. - + method. + ]]> @@ -1839,13 +1839,13 @@ Provides COM objects with version-independent access to the method. A object representing the public method with the specified name, if found; otherwise, . - method searches for the public method with the specified name. - + method searches for the public method with the specified name. + ]]> @@ -1873,21 +1873,21 @@ The containing the name of the method to get. - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . Provides COM objects with version-independent access to the method. A object representing the method that matches the specified requirements, if found; otherwise, . - method searches for the specified method, using the specified binding constraints. - + method searches for the specified method, using the specified binding constraints. + ]]> @@ -1915,21 +1915,21 @@ The containing the name of the public method to get. - An array of objects representing the number, order, and type of the parameters for the method to get. - - -or- - + An array of objects representing the number, order, and type of the parameters for the method to get. + + -or- + An empty array of the type (that is, Type[] types = new Type[0]) to get a method that takes no parameters. Provides COM objects with version-independent access to the method. A object representing the public method whose parameters match the specified argument types, if found; otherwise, . - method searches for the specified public method whose parameters match the specified argument types. - + method searches for the specified public method whose parameters match the specified argument types. + ]]> @@ -1958,22 +1958,22 @@ The containing the name of the public method to get. - An array of objects representing the number, order, and type of the parameters for the method to get. - - -or- - + An array of objects representing the number, order, and type of the parameters for the method to get. + + -or- + An empty array of the type (that is, Type[] types = new Type[0]) to get a method that takes no parameters. An array of objects representing the attributes associated with the corresponding element in the array. The default binder does not process this parameter. Provides COM objects with version-independent access to the method. A object representing the public method that matches the specified requirements, if found; otherwise, . - method searches for the specified public method whose parameters match the specified argument types and modifiers. - + method searches for the specified public method whose parameters match the specified argument types and modifiers. + ]]> @@ -2004,32 +2004,32 @@ The containing the name of the method to get. - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . - A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. - - -or- - + A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. + + -or- + , to use the . - An array of objects representing the number, order, and type of the parameters for the method to get. - - -or- - + An array of objects representing the number, order, and type of the parameters for the method to get. + + -or- + An empty array of the type (that is, Type[] types = new Type[0]) to get a method that takes no parameters. An array of objects representing the attributes associated with the corresponding element in the array. The default binder does not process this parameter. Provides COM objects with version-independent access to the method. A object representing the method that matches the specified requirements, if found; otherwise, . - method searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints. - + method searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints. + ]]> @@ -2061,33 +2061,33 @@ The containing the name of the method to get. - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . - A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. - - -or- - + A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. + + -or- + , to use the . The object that specifies the set of rules to use regarding the order and layout of arguments, how the return value is passed, what registers are used for arguments, and how the stack is cleaned up. - An array of objects representing the number, order, and type of the parameters for the method to get. - - -or- - + An array of objects representing the number, order, and type of the parameters for the method to get. + + -or- + An empty array of the type (that is, Type[] types = new Type[0]) to get a method that takes no parameters. An array of objects representing the attributes associated with the corresponding element in the array. The default binder does not process this parameter. Provides COM objects with version-independent access to the method. A object representing the method that matches the specified requirements, if found; otherwise, . - method searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention. - + method searches for the specified method whose parameters match the specified argument types and modifiers, using the specified binding constraints and the specified calling convention. + ]]> @@ -2101,13 +2101,13 @@ Provides COM objects with version-independent access to the method. - method gets the methods of the current . - + method gets the methods of the current . + ]]> @@ -2132,19 +2132,19 @@ Provides COM objects with version-independent access to the method. - An array of objects representing all the public methods defined for the current . - - -or- - + An array of objects representing all the public methods defined for the current . + + -or- + An empty array of type , if no public methods are defined for the current . - method returns all the public methods of the current . - + method returns all the public methods of the current . + ]]> @@ -2170,25 +2170,25 @@ - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . Provides COM objects with version-independent access to the method. - An array of objects representing all methods defined for the current that match the specified binding constraints. - - -or- - + An array of objects representing all methods defined for the current that match the specified binding constraints. + + -or- + An empty array of type , if no methods are defined for the current , or if none of the defined methods match the binding constraints. - method searches for the methods defined for the current , using the specified binding constraints. - + method searches for the methods defined for the current , using the specified binding constraints. + ]]> @@ -2202,13 +2202,13 @@ Provides COM objects with version-independent access to the method. - method gets a specific type nested within the current . - + method gets a specific type nested within the current . + ]]> @@ -2238,13 +2238,13 @@ Provides COM objects with version-independent access to the method. A object representing the public nested type with the specified name, if found; otherwise, . - method searches for the public nested type with the specified name. - + method searches for the public nested type with the specified name. + ]]> @@ -2272,21 +2272,21 @@ The string containing the name of the nested type to get. - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . Provides COM objects with version-independent access to the method. A object representing the nested type that matches the specified requirements, if found; otherwise, . - method searches for the specified nested type, using the specified binding constraints. - + method searches for the specified nested type, using the specified binding constraints. + ]]> @@ -2300,13 +2300,13 @@ Provides COM objects with version-independent access to the method. - method gets the types nested within the current . - + method gets the types nested within the current . + ]]> @@ -2331,19 +2331,19 @@ Provides COM objects with version-independent access to the method. - An array of objects representing all the types nested within the current . - - -or- - + An array of objects representing all the types nested within the current . + + -or- + An empty array of type , if no types are nested within the current . - method returns all the types nested within the current . - + method returns all the types nested within the current . + ]]> @@ -2369,23 +2369,23 @@ - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . Provides COM objects with version-independent access to the method, and searches for the types nested within the current , using the specified binding constraints. - An array of objects representing all the types nested within the current that match the specified binding constraints. - - -or- - + An array of objects representing all the types nested within the current that match the specified binding constraints. + + -or- + An empty array of type , if no types are nested within the current , or if none of the nested types match the binding constraints. - @@ -2399,13 +2399,13 @@ Provides COM objects with version-independent access to the method. - method gets the properties of the current . - + method gets the properties of the current . + ]]> @@ -2430,19 +2430,19 @@ Provides COM objects with version-independent access to the method. - An array of objects representing all public properties of the current . - - -or- - + An array of objects representing all public properties of the current . + + -or- + An empty array of type , if the current does not have public properties. - method returns all the public properties of the current . - + method returns all the public properties of the current . + ]]> @@ -2468,25 +2468,25 @@ - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . Provides COM objects with version-independent access to the method. - An array of objects representing all properties of the current that match the specified binding constraints. - - -or- - + An array of objects representing all properties of the current that match the specified binding constraints. + + -or- + An empty array of type , if the current does not have properties, or if none of the properties match the binding constraints. - method searches for the properties of the current , using the specified binding constraints. - + method searches for the properties of the current , using the specified binding constraints. + ]]> @@ -2500,13 +2500,13 @@ Provides COM objects with version-independent access to the method. - method gets a specific property of the current . - + method gets a specific property of the current . + ]]> @@ -2536,13 +2536,13 @@ Provides COM objects with version-independent access to the method. A object representing the public property with the specified name, if found; otherwise, . - method searches for the public property with the specified name. - + method searches for the public property with the specified name. + ]]> @@ -2570,21 +2570,21 @@ The containing the name of the property to get. - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . Provides COM objects with version-independent access to the method. A object representing the property that matches the specified requirements, if found; otherwise, . - method searches for the specified property, using the specified binding constraints. - + method searches for the specified property, using the specified binding constraints. + ]]> @@ -2616,13 +2616,13 @@ Provides COM objects with version-independent access to the method. A object representing the public property with the specified name, if found; otherwise, . - method searches for the public property with the specified name and return type. - + method searches for the public property with the specified name and return type. + ]]> @@ -2650,21 +2650,21 @@ The containing the name of the public property to get. - An array of objects representing the number, order, and type of the parameters for the indexed property to get. - - -or- - + An array of objects representing the number, order, and type of the parameters for the indexed property to get. + + -or- + An empty array of the type (that is, Type[] types = new Type[0]) to get a property that is not indexed. Provides COM objects with version-independent access to the method. A object representing the public property whose parameters match the specified argument types, if found; otherwise, . - method searches for the specified public property whose parameters match the specified argument types. - + method searches for the specified public property whose parameters match the specified argument types. + ]]> @@ -2694,21 +2694,21 @@ The containing the name of the public property to get. The return type of the property. - An array of objects representing the number, order, and type of the parameters for the indexed property to get. - - -or- - + An array of objects representing the number, order, and type of the parameters for the indexed property to get. + + -or- + An empty array of the type (that is, Type[] types = new Type[0]) to get a property that is not indexed. Provides COM objects with version-independent access to the method. A object representing the public property whose parameters match the specified argument types, if found; otherwise, . - method searches for the specified public property whose parameters match the specified argument types. - + method searches for the specified public property whose parameters match the specified argument types. + ]]> @@ -2739,22 +2739,22 @@ The containing the name of the public property to get. The return type of the property. - An array of objects representing the number, order, and type of the parameters for the indexed property to get. - - -or- - + An array of objects representing the number, order, and type of the parameters for the indexed property to get. + + -or- + An empty array of the type (that is, Type[] types = new Type[0]) to get a property that is not indexed. An array of objects representing the attributes associated with the corresponding element in the array. The default binder does not process this parameter. Provides COM objects with version-independent access to the method. A object representing the public property that matches the specified requirements, if found; otherwise, . - method searches for the specified public property whose parameters match the specified argument types and modifiers. - + method searches for the specified public property whose parameters match the specified argument types and modifiers. + ]]> @@ -2786,33 +2786,33 @@ The containing the name of the property to get. - A bitmask comprised of one or more that specify how the search is conducted. - - -or- - + A bitmask comprised of one or more that specify how the search is conducted. + + -or- + Zero, to return . - A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. - - -or- - + A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. + + -or- + , to use the . The return type of the property. - An array of objects representing the number, order, and type of the parameters for the indexed property to get. - - -or- - + An array of objects representing the number, order, and type of the parameters for the indexed property to get. + + -or- + An empty array of the type (that is, Type[] types = new Type[0]) to get a property that is not indexed. An array of objects representing the attributes associated with the corresponding element in the array. The default binder does not process this parameter. Provides COM objects with version-independent access to the method. A object representing the property that matches the specified requirements, if found; otherwise, . - method searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints. - + method searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints. + ]]> @@ -2839,13 +2839,13 @@ Provides COM objects with version-independent access to the method. The current . - method gets the current . - + method gets the current . + ]]> @@ -2878,11 +2878,11 @@ Receives a pointer to the requested type information object. Retrieves the type information for an object, which can then be used to get the type information for an interface. - @@ -2911,11 +2911,11 @@ Points to a location that receives the number of type information interfaces provided by the object. Retrieves the number of type information interfaces that an object provides (either 0 or 1). - @@ -2941,13 +2941,13 @@ Provides COM objects with version-independent access to the property. The GUID associated with the . - property gets the GUID associated with the . - + property gets the GUID associated with the . + ]]> @@ -2974,13 +2974,13 @@ if the is an array, a pointer, or is passed by reference; otherwise, . - property - + property + ]]> @@ -3023,11 +3023,11 @@ The index of the first argument that has an error. Provides access to properties and methods exposed by an object. - @@ -3041,15 +3041,15 @@ Provides COM objects with version-independent access to the method. - method invokes a specific member of the current . - - . - + method invokes a specific member of the current . + + . + ]]> @@ -3079,33 +3079,33 @@ - The containing the name of the constructor, method, property, or field member to invoke. - - -or- - - An empty string ("") to invoke the default member. - - -or- - + The containing the name of the constructor, method, property, or field member to invoke. + + -or- + + An empty string ("") to invoke the default member. + + -or- + For IDispatch members, a string representing the DispID, for example "[DispID=3]". A bitmask comprised of one or more that specify how the search is conducted. The access can be one of the such as , , , , , and so on. The type of lookup need not be specified. If the type of lookup is omitted, | will apply. - A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. - - -or- - + A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. + + -or- + , to use the . The on which to invoke the specified member. An array containing the arguments to pass to the member to invoke. Provides COM objects with version-independent access to the method. An representing the return value of the invoked member. - method invokes the specified member, using the specified binding constraints and matching the specified argument list. - + method invokes the specified member, using the specified binding constraints and matching the specified argument list. + ]]> @@ -3136,38 +3136,38 @@ - The containing the name of the constructor, method, property, or field member to invoke. - - -or- - - An empty string ("") to invoke the default member. - - -or- - + The containing the name of the constructor, method, property, or field member to invoke. + + -or- + + An empty string ("") to invoke the default member. + + -or- + For IDispatch members, a string representing the DispID, for example "[DispID=3]". A bitmask comprised of one or more that specify how the search is conducted. The access can be one of the such as , , , , , and so on. The type of lookup need not be specified. If the type of lookup is omitted, | will apply. - A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. - - -or- - + A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. + + -or- + , to use the . The on which to invoke the specified member. An array containing the arguments to pass to the member to invoke. - The object representing the globalization locale to use, which may be necessary for locale-specific conversions, such as converting a numeric String to a Double. - - -or- - + The object representing the globalization locale to use, which may be necessary for locale-specific conversions, such as converting a numeric String to a Double. + + -or- + to use the current thread's . Provides COM objects with version-independent access to the method. An representing the return value of the invoked member. - method invokes the specified member, using the specified binding constraints and matching the specified argument list and culture. - + method invokes the specified member, using the specified binding constraints and matching the specified argument list and culture. + ]]> @@ -3200,40 +3200,40 @@ - The containing the name of the constructor, method, property, or field member to invoke. - - -or- - - An empty string ("") to invoke the default member. - - -or- - + The containing the name of the constructor, method, property, or field member to invoke. + + -or- + + An empty string ("") to invoke the default member. + + -or- + For IDispatch members, a string representing the DispID, for example "[DispID=3]". A bitmask comprised of one or more that specify how the search is conducted. The access can be one of the such as , , , , , and so on. The type of lookup need not be specified. If the type of lookup is omitted, | will apply. - A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. - - -or- - + A object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection. + + -or- + , to use the . The on which to invoke the specified member. An array containing the arguments to pass to the member to invoke. An array of objects representing the attributes associated with the corresponding element in the array. A parameter's associated attributes are stored in the member's signature. The default binder does not process this parameter. - The object representing the globalization locale to use, which may be necessary for locale-specific conversions, such as converting a numeric String to a Double. - - -or- - + The object representing the globalization locale to use, which may be necessary for locale-specific conversions, such as converting a numeric String to a Double. + + -or- + to use the current thread's . An array containing the names of the parameters to which the values in the array are passed. Provides COM objects with version-independent access to the method. An representing the return value of the invoked member. - method invokes the specified member, using the specified binding constraints and matching the specified argument list, modifiers, and culture. - + method invokes the specified member, using the specified binding constraints and matching the specified argument list, modifiers, and culture. + ]]> @@ -3260,13 +3260,13 @@ if the is abstract; otherwise, . - property gets a value indicating whether the is abstract and must be overridden. - + property gets a value indicating whether the is abstract and must be overridden. + ]]> @@ -3293,13 +3293,13 @@ if the string format attribute is selected for the ; otherwise, . - property gets a value indicating whether the string format attribute `AnsiClass` is selected for the . - + property gets a value indicating whether the string format attribute `AnsiClass` is selected for the . + ]]> @@ -3326,13 +3326,13 @@ if the is an array; otherwise, . - property gets a value indicating whether the is an array. - + property gets a value indicating whether the is an array. + ]]> @@ -3363,11 +3363,11 @@ if and the current represent the same type, or if the current is in the inheritance hierarchy of , or if the current is an interface that implements, or if is a generic type parameter and the current represents one of the constraints of . if none of these conditions are the case, or if is . - @@ -3394,13 +3394,13 @@ if the string format attribute is selected for the ; otherwise, . - property gets a value indicating whether the string format attribute `AutoClass` is selected for the . - + property gets a value indicating whether the string format attribute `AutoClass` is selected for the . + ]]> @@ -3427,13 +3427,13 @@ if the class layout attribute is selected for the ; otherwise, . - property gets a value indicating whether the class layout attribute `AutoLayout` is selected for the . - + property gets a value indicating whether the class layout attribute `AutoLayout` is selected for the . + ]]> @@ -3460,13 +3460,13 @@ if the is passed by reference; otherwise, . - property gets a value indicating whether the is passed by reference. - + property gets a value indicating whether the is passed by reference. + ]]> @@ -3493,13 +3493,13 @@ if the is a class; otherwise, . - property gets a value indicating whether the is a class; that is, not a value type or interface. - + property gets a value indicating whether the is a class; that is, not a value type or interface. + ]]> @@ -3526,13 +3526,13 @@ if the is a COM object; otherwise, . - property gets a value indicating whether the is a COM object. - + property gets a value indicating whether the is a COM object. + ]]> @@ -3559,13 +3559,13 @@ if the can be hosted in a context; otherwise, . - property gets a value indicating whether the can be hosted in a context. - + property gets a value indicating whether the can be hosted in a context. + ]]> @@ -3598,13 +3598,13 @@ if one or more instance of is applied to this member; otherwise, . - method indicates whether one or more instance of `attributeType` is applied to this member. - + method indicates whether one or more instance of `attributeType` is applied to this member. + ]]> @@ -3631,13 +3631,13 @@ if the current represents an enumeration; otherwise, . - property gets a value indicating whether the current represents an enumeration. - + property gets a value indicating whether the current represents an enumeration. + ]]> @@ -3664,13 +3664,13 @@ if the class layout attribute is selected for the ; otherwise, . - property gets a value indicating whether the class layout attribute `ExplicitLayout` is selected for the . - + property gets a value indicating whether the class layout attribute `ExplicitLayout` is selected for the . + ]]> @@ -3697,13 +3697,13 @@ if the has ; otherwise, . - property gets a value indicating whether the has , indicating that it was imported from a COM type library. - + property gets a value indicating whether the has , indicating that it was imported from a COM type library. + ]]> @@ -3734,13 +3734,13 @@ if the current is in the inheritance hierarchy of the object represented by , or if the current is an interface that supports. if neither of these conditions is the case, or if is , or if the current is an open generic type (that is, returns ). - method determines whether the specified object is an instance of the current . - + method determines whether the specified object is an instance of the current . + ]]> @@ -3767,13 +3767,13 @@ if the is an interface; otherwise, . - property gets a value indicating whether the is an interface; that is, not a class or a value type. - + property gets a value indicating whether the is an interface; that is, not a class or a value type. + ]]> @@ -3800,13 +3800,13 @@ if the class layout attribute is selected for the ; otherwise, . - property gets a value indicating whether the class layout attribute `SequentialLayout` is selected for the . - + property gets a value indicating whether the class layout attribute `SequentialLayout` is selected for the . + ]]> @@ -3833,13 +3833,13 @@ if the is marshaled by reference; otherwise, . - property gets a value indicating whether the Type is marshaled by reference. - + property gets a value indicating whether the Type is marshaled by reference. + ]]> @@ -3866,13 +3866,13 @@ if the is nested and visible only within its own assembly; otherwise, . - property gets a value indicating whether the is nested and visible only within its own assembly. - + property gets a value indicating whether the is nested and visible only within its own assembly. + ]]> @@ -3899,13 +3899,13 @@ if the is nested and visible only to classes that belong to both its own family and its own assembly; otherwise, . - property gets a value indicating whether the is nested and visible only to classes that belong to both its own family and its own assembly. - + property gets a value indicating whether the is nested and visible only to classes that belong to both its own family and its own assembly. + ]]> @@ -3932,13 +3932,13 @@ if the is nested and visible only within its own family; otherwise, . - property gets a value indicating whether the is nested and visible only within its own family. - + property gets a value indicating whether the is nested and visible only within its own family. + ]]> @@ -3965,13 +3965,13 @@ if the is nested and visible only to classes that belong to its own family or to its own assembly; otherwise, . - property gets a value indicating whether the is nested and visible only to classes that belong to either its own family or to its own assembly. - + property gets a value indicating whether the is nested and visible only to classes that belong to either its own family or to its own assembly. + ]]> @@ -3998,13 +3998,13 @@ if the is nested and declared private; otherwise, . - property gets a value indicating whether the is nested and declared private. - + property gets a value indicating whether the is nested and declared private. + ]]> @@ -4031,13 +4031,13 @@ if the class is nested and declared public; otherwise, . - property gets a value indicating whether a class is nested and declared public. - + property gets a value indicating whether a class is nested and declared public. + ]]> @@ -4064,13 +4064,13 @@ if the top-level is not declared public; otherwise, . - property gets a value indicating whether the top-level is not declared public. - + property gets a value indicating whether the top-level is not declared public. + ]]> @@ -4097,13 +4097,13 @@ if the is a pointer; otherwise, . - property gets a value indicating whether the is a pointer. - + property gets a value indicating whether the is a pointer. + ]]> @@ -4130,13 +4130,13 @@ if the is one of the primitive types; otherwise, . - property gets a value indicating whether the is one of the primitive types. - + property gets a value indicating whether the is one of the primitive types. + ]]> @@ -4163,13 +4163,13 @@ if the top-level is declared public; otherwise, . - property gets a value indicating whether the top-level is declared public. - + property gets a value indicating whether the top-level is declared public. + ]]> @@ -4196,13 +4196,13 @@ if the is declared sealed; otherwise, . - property gets a value indicating whether the is declared sealed. - + property gets a value indicating whether the is declared sealed. + ]]> @@ -4229,13 +4229,13 @@ if the is serializable; otherwise, . - property gets a value indicating whether the is serializable. - + property gets a value indicating whether the is serializable. + ]]> @@ -4262,13 +4262,13 @@ if the has a name that requires special handling; otherwise, . - property gets a value indicating whether the has a name that requires special handling. - + property gets a value indicating whether the has a name that requires special handling. + ]]> @@ -4299,13 +4299,13 @@ if the represented by the parameter and the current represent classes, and the class represented by the current derives from the class represented by ; otherwise, . This method also returns if and the current represent the same class. - method determines whether the class represented by the current derives from the class represented by the specified . - + method determines whether the class represented by the current derives from the class represented by the specified . + ]]> @@ -4332,13 +4332,13 @@ if the string format attribute is selected for the ; otherwise, . - property gets a value indicating whether the string format attribute `UnicodeClass` is selected for the . - + property gets a value indicating whether the string format attribute `UnicodeClass` is selected for the . + ]]> @@ -4365,13 +4365,13 @@ if the is a value type; otherwise, . - property gets a value indicating whether the is a value type. - + property gets a value indicating whether the is a value type. + ]]> @@ -4397,13 +4397,13 @@ Provides COM objects with version-independent access to the property. A value indicating that this member is a type or a nested type. - property gets a value indicating that this member is a type or a nested type. - + property gets a value indicating that this member is a type or a nested type. + ]]> @@ -4429,13 +4429,13 @@ Provides COM objects with version-independent access to the property. The name of the module in which the current is defined. - property gets the module (the DLL) in which the current is defined. - + property gets the module (the DLL) in which the current is defined. + ]]> @@ -4461,13 +4461,13 @@ Provides COM objects with version-independent access to the property. The name of the . - property gets the name of the . - + property gets the name of the . + ]]> @@ -4493,13 +4493,13 @@ Provides COM objects with version-independent access to the property. The namespace of the . - property gets the namespace of the . - + property gets the namespace of the . + ]]> @@ -4525,13 +4525,13 @@ Provides COM objects with version-independent access to the property. The object through which this object was obtained. - property gets the class object that was used to obtain this member. - + property gets the class object that was used to obtain this member. + ]]> @@ -4558,13 +4558,13 @@ Provides COM objects with version-independent access to the method. A representing the name of the current . - method returns the name of the current . - + method returns the name of the current . + ]]> @@ -4590,13 +4590,13 @@ Provides COM objects with version-independent access to the property. The handle for the current . - property gets the handle for the current . - + property gets the handle for the current . + ]]> @@ -4622,13 +4622,13 @@ Provides COM objects with version-independent access to the property. A containing the name of the class constructor for the . - property gets the initializer for the . - + property gets the initializer for the . + ]]> @@ -4654,13 +4654,13 @@ Provides COM objects with version-independent access to the property. The underlying system type for the . - property indicates the type provided by the common language runtime that represents this type. - + property indicates the type provided by the common language runtime that represents this type. + ]]> diff --git a/xml/System.Runtime.Remoting/RemotingConfiguration.xml b/xml/System.Runtime.Remoting/RemotingConfiguration.xml index d4b46f68e4f..704f057ad95 100644 --- a/xml/System.Runtime.Remoting/RemotingConfiguration.xml +++ b/xml/System.Runtime.Remoting/RemotingConfiguration.xml @@ -879,10 +879,6 @@ To activate a client-activated object type with the `new` keyword, you must first register the object type on the client end using the method. Calling the method gives the remoting infrastructure the location of the remote application where `new` attempts to create it. If, on the other hand, you use the method to create a new instance of the client-activated object, you must supply the remote application's URL as a parameter, so no prior registration on the client end is necessary. To supply the method with the URL of the server where you want to create the object, you must encapsulate the URL in an instance of the class. - For a detailed description of client-activated objects, see [Client Activation](https://learn.microsoft.com/previous-versions/dotnet/netframework-4.0/w93betdk(v=vs.100)). - - - ## Examples The following code example demonstrates registration of an object type on the client end as a type that can be activated on the server. For the server code that corresponds to the presented client code, see the example for the method. @@ -892,7 +888,7 @@ ]]> - The or parameter is . + The or parameter is . At least one of the callers higher in the callstack does not have permission to configure remoting types and channels. diff --git a/xml/System.Runtime.Remoting/RemotingServices.xml b/xml/System.Runtime.Remoting/RemotingServices.xml index 2e8887623de..33ea4495884 100644 --- a/xml/System.Runtime.Remoting/RemotingServices.xml +++ b/xml/System.Runtime.Remoting/RemotingServices.xml @@ -1147,7 +1147,7 @@ ]]> - is a proxy of a remote object, and the parameter is not . + is a proxy of a remote object, and the parameter is not . At least one of the callers higher in the callstack does not have permission to configure remoting types and channels. From a33cd573a85962ba89e6882a3e16d6d517c052e5 Mon Sep 17 00:00:00 2001 From: Dave Rayment Date: Thu, 3 Apr 2025 03:15:50 +0100 Subject: [PATCH 2/4] System.Globalization.CompareOptions update (#10087) --- .../CPP/compareoptions_stringsort.cpp | 119 ------------------ .../CompareOptions/Overview/Program.cs | 2 + .../CompareOptions/Overview/Project.csproj | 4 +- .../Overview/compareoptions_stringsort.cs | 104 +++++++-------- .../Overview/compareoptions_values.cs | 97 ++++++++++++++ .../System.Globalization/Project.fsproj | 13 ++ .../compareoptions_stringsort.fs | 67 ++++++++++ .../compareoptions_values.fs | 90 +++++++++++++ .../VB/Project.vbproj | 8 ++ .../VB/compareoptions_stringsort.vb | 113 ++++++----------- .../VB/Project.vbproj | 8 ++ .../VB/compareoptions_values.vb | 90 +++++++++++++ xml/System.Globalization/CompareOptions.xml | 57 ++++++--- 13 files changed, 497 insertions(+), 275 deletions(-) delete mode 100644 snippets/cpp/VS_Snippets_CLR_System/system.Globalization.CompareOptions.StringSort/CPP/compareoptions_stringsort.cpp create mode 100644 snippets/csharp/System.Globalization/CompareOptions/Overview/Program.cs create mode 100644 snippets/csharp/System.Globalization/CompareOptions/Overview/compareoptions_values.cs create mode 100644 snippets/fsharp/System.Globalization/Project.fsproj create mode 100644 snippets/fsharp/System.Globalization/compareoptions_stringsort.fs create mode 100644 snippets/fsharp/System.Globalization/compareoptions_values.fs create mode 100644 snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.StringSort/VB/Project.vbproj create mode 100644 snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.Values/VB/Project.vbproj create mode 100644 snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.Values/VB/compareoptions_values.vb diff --git a/snippets/cpp/VS_Snippets_CLR_System/system.Globalization.CompareOptions.StringSort/CPP/compareoptions_stringsort.cpp b/snippets/cpp/VS_Snippets_CLR_System/system.Globalization.CompareOptions.StringSort/CPP/compareoptions_stringsort.cpp deleted file mode 100644 index 5885be28f72..00000000000 --- a/snippets/cpp/VS_Snippets_CLR_System/system.Globalization.CompareOptions.StringSort/CPP/compareoptions_stringsort.cpp +++ /dev/null @@ -1,119 +0,0 @@ - -// The following code example shows how sorting with CompareOptions::StringSort differs -// from sorting with->Item[Out] CompareOptions::StringSort. -// -using namespace System; -using namespace System::Collections; -using namespace System::Globalization; - -// __gc public class SamplesCompareOptions { -ref class MyStringComparer: public IComparer -{ -public: - - // Constructs a comparer using the specified CompareOptions. - CompareInfo^ myComp; - CompareOptions myOptions; - MyStringComparer( CompareInfo^ cmpi, CompareOptions options ) - : myComp( cmpi ), myOptions( options ) - {} - - // Compares strings with the CompareOptions specified in the constructor. - virtual int Compare( Object^ a, Object^ b ) - { - if ( a == b ) - return 0; - - if ( a == nullptr ) - return -1; - - if ( b == nullptr ) - return 1; - - String^ sa = dynamic_cast(a); - String^ sb = dynamic_cast(b); - if ( sa != nullptr && sb != nullptr ) - return myComp->Compare( sa, sb, myOptions ); - - throw gcnew ArgumentException( "a and b should be strings." ); - } -}; - -int main() -{ - - // Creates and initializes an array of strings to sort. - array^myArr = {"cant","bill's","coop","cannot","billet","can't","con","bills","co-op"}; - Console::WriteLine( "\nInitially, " ); - IEnumerator^ myEnum = myArr->GetEnumerator(); - while ( myEnum->MoveNext() ) - { - String^ myStr = safe_cast(myEnum->Current); - Console::WriteLine( myStr ); - } - - - // Creates and initializes a Comparer to use. - //CultureInfo* myCI = new CultureInfo(S"en-US", false); - MyStringComparer^ myComp = gcnew MyStringComparer( CompareInfo::GetCompareInfo( "en-US" ),CompareOptions::None ); - - // Sorts the array without StringSort. - Array::Sort( myArr, myComp ); - Console::WriteLine( "\nAfter sorting without CompareOptions::StringSort:" ); - myEnum = myArr->GetEnumerator(); - while ( myEnum->MoveNext() ) - { - String^ myStr = safe_cast(myEnum->Current); - Console::WriteLine( myStr ); - } - - - // Sorts the array with StringSort. - myComp = gcnew MyStringComparer( CompareInfo::GetCompareInfo( "en-US" ),CompareOptions::StringSort ); - Array::Sort( myArr, myComp ); - Console::WriteLine( "\nAfter sorting with CompareOptions::StringSort:" ); - myEnum = myArr->GetEnumerator(); - while ( myEnum->MoveNext() ) - { - String^ myStr = safe_cast(myEnum->Current); - Console::WriteLine( myStr ); - } -} - -/* -This code produces the following output. - -Initially, -cant -bill's -coop -cannot -billet -can't -con -bills -co-op - -After sorting without CompareOptions::StringSort: -billet -bills -bill's -cannot -cant -can't -con -coop -co-op - -After sorting with CompareOptions::StringSort: -bill's -billet -bills -can't -cannot -cant -co-op -con -coop -*/ -// diff --git a/snippets/csharp/System.Globalization/CompareOptions/Overview/Program.cs b/snippets/csharp/System.Globalization/CompareOptions/Overview/Program.cs new file mode 100644 index 00000000000..120ab0719ff --- /dev/null +++ b/snippets/csharp/System.Globalization/CompareOptions/Overview/Program.cs @@ -0,0 +1,2 @@ +CompareOptionsExample.Run(); +StringSort.Run(); diff --git a/snippets/csharp/System.Globalization/CompareOptions/Overview/Project.csproj b/snippets/csharp/System.Globalization/CompareOptions/Overview/Project.csproj index c02dc5044e7..325ccd545c2 100644 --- a/snippets/csharp/System.Globalization/CompareOptions/Overview/Project.csproj +++ b/snippets/csharp/System.Globalization/CompareOptions/Overview/Project.csproj @@ -1,8 +1,8 @@ - Library - net6.0 + Exe + net9.0 \ No newline at end of file diff --git a/snippets/csharp/System.Globalization/CompareOptions/Overview/compareoptions_stringsort.cs b/snippets/csharp/System.Globalization/CompareOptions/Overview/compareoptions_stringsort.cs index b8fc19680cf..849675dcef8 100644 --- a/snippets/csharp/System.Globalization/CompareOptions/Overview/compareoptions_stringsort.cs +++ b/snippets/csharp/System.Globalization/CompareOptions/Overview/compareoptions_stringsort.cs @@ -1,67 +1,51 @@ -// The following code example shows how sorting with CompareOptions.StringSort differs from sorting without CompareOptions.StringSort. - -// -using System; -using System.Collections; +using System; +using System.Collections.Generic; using System.Globalization; -public class SamplesCompareOptions { - - private class MyStringComparer: IComparer { - private CompareInfo myComp; - private CompareOptions myOptions = CompareOptions.None; - - // Constructs a comparer using the specified CompareOptions. - public MyStringComparer( CompareInfo cmpi, CompareOptions options ) { - myComp = cmpi; - this.myOptions = options; - } - - // Compares strings with the CompareOptions specified in the constructor. - public int Compare(Object a, Object b) { - if (a == b) return 0; - if (a == null) return -1; - if (b == null) return 1; - - String sa = a as String; - String sb = b as String; - if (sa != null && sb != null) - return myComp.Compare(sa, sb, myOptions); - throw new ArgumentException("a and b should be strings."); - } - } - - public static void Main() { - - // Creates and initializes an array of strings to sort. - String[] myArr = new String[9] { "cant", "bill's", "coop", "cannot", "billet", "can't", "con", "bills", "co-op" }; - Console.WriteLine( "\nInitially," ); - foreach ( String myStr in myArr ) - Console.WriteLine( myStr ); - - // Creates and initializes a Comparer to use. - //CultureInfo myCI = new CultureInfo( "en-US", false ); - MyStringComparer myComp = new MyStringComparer(CompareInfo.GetCompareInfo("en-US"), CompareOptions.None); - - // Sorts the array without StringSort. - Array.Sort( myArr, myComp ); - Console.WriteLine( "\nAfter sorting without CompareOptions.StringSort:" ); - foreach ( String myStr in myArr ) - Console.WriteLine( myStr ); - - // Sorts the array with StringSort. - myComp = new MyStringComparer(CompareInfo.GetCompareInfo("en-US"), CompareOptions.StringSort); - Array.Sort( myArr, myComp ); - Console.WriteLine( "\nAfter sorting with CompareOptions.StringSort:" ); - foreach ( String myStr in myArr ) - Console.WriteLine( myStr ); - } +public class StringSort +{ + public static void Run() + { + var wordList = new List + { + "cant", "bill's", "coop", "cannot", "billet", "can't", "con", "bills", "co-op" + }; + + Console.WriteLine("Before sorting:"); + foreach (string word in wordList) + { + Console.WriteLine(word); + } + + Console.WriteLine(Environment.NewLine + "After sorting with CompareOptions.None:"); + SortAndDisplay(wordList, CompareOptions.None); + + Console.WriteLine(Environment.NewLine + "After sorting with CompareOptions.StringSort:"); + SortAndDisplay(wordList, CompareOptions.StringSort); + } + + // Sort the list of words with the supplied CompareOptions. + private static void SortAndDisplay(List unsorted, CompareOptions options) + { + // Create a copy of the original list to sort. + var words = new List(unsorted); + // Define the CompareInfo to use to compare strings. + CompareInfo comparer = CultureInfo.InvariantCulture.CompareInfo; + + // Sort the copy with the supplied CompareOptions then display. + words.Sort((str1, str2) => comparer.Compare(str1, str2, options)); + foreach (string word in words) + { + Console.WriteLine(word); + } + } } /* -This code produces the following output. +CompareOptions.None and CompareOptions.StringSort provide identical ordering by default +in .NET 5 and later. But in prior versions, the output is the following: -Initially, +Before sorting: cant bill's coop @@ -72,7 +56,7 @@ This code produces the following output. bills co-op -After sorting without CompareOptions.StringSort: +After sorting with CompareOptions.None: billet bills bill's @@ -93,6 +77,4 @@ This code produces the following output. co-op con coop - */ -// diff --git a/snippets/csharp/System.Globalization/CompareOptions/Overview/compareoptions_values.cs b/snippets/csharp/System.Globalization/CompareOptions/Overview/compareoptions_values.cs new file mode 100644 index 00000000000..05e9124a430 --- /dev/null +++ b/snippets/csharp/System.Globalization/CompareOptions/Overview/compareoptions_values.cs @@ -0,0 +1,97 @@ +using System; +using System.Globalization; + +public class CompareOptionsExample +{ + public static void Run() + { + // Uppercase and lowercase characters are equivalent (according to the culture rules) + // when IgnoreCase is used. + TestStringEquality("ONE two", "one TWO", "Case sensitivity", CompareOptions.IgnoreCase); + + // Punctuation is ignored with the IgnoreSymbols option. + TestStringEquality("hello world", "hello, world!", "Punctuation", CompareOptions.IgnoreSymbols); + + // Whitespace and mathematical symbols are also ignored with IgnoreSymbols. + TestStringEquality("3 + 5 = 8", "358", "Whitespace and mathematical symbols", CompareOptions.IgnoreSymbols); + + // Caution: currency symbols and thousands separators are ignored with IgnoreSymbols. + // Parse strings containing numbers/currency and compare them numerically instead. + TestStringEquality("Total $15,000", "Total: £150.00", "Currency symbols, decimals and thousands separators", CompareOptions.IgnoreSymbols); + + // Full width characters are common in East Asian languages. Use the IgnoreWidth + // option to treat full- and half-width characters as equal. + TestStringEquality("ａｂｃ，－", "abc,-", "Half width and full width characters", CompareOptions.IgnoreWidth); + + // The same string in Hiragana and Katakana is equal when IgnoreKanaType is used. + TestStringEquality("ありがとう", "アリガトウ", "Hiragana and Katakana strings", CompareOptions.IgnoreKanaType); + + // When comparing with the IgnoreNonSpace option, characters like diacritical marks are ignored. + TestStringEquality("café", "cafe", "Diacritical marks", CompareOptions.IgnoreNonSpace); + + // Ligature characters and their non-ligature forms compare equal with the IgnoreNonSpace option. + // Note: prior to .NET 5, ligature characters were equal to their expanded forms by default. + TestStringEquality("straße œuvre cæsar", "strasse oeuvre caesar", "Ligature characters", CompareOptions.IgnoreNonSpace); + } + + private static void TestStringEquality(string str1, string str2, string description, CompareOptions options) + { + Console.WriteLine(Environment.NewLine + description + ":"); + // First test with the default CompareOptions then with the provided options + TestStringEquality(str1, str2, CompareOptions.None); + TestStringEquality(str1, str2, options); + } + + private static void TestStringEquality(string str1, string str2, CompareOptions options) + { + Console.Write($" When using CompareOptions.{options}, \"{str1}\" and \"{str2}\" are "); + if (string.Compare(str1, str2, CultureInfo.InvariantCulture, options) != 0) + { + Console.Write("not "); + } + Console.WriteLine("equal."); + } +} + +/* +In .NET 5 and later, the output is the following: + +Case sensitivity: + When using CompareOptions.None, "ONE two" and "one TWO" are not equal. + When using CompareOptions.IgnoreCase, "ONE two" and "one TWO" are equal. + +Punctuation: + When using CompareOptions.None, "hello world" and "hello, world!" are not equal. + When using CompareOptions.IgnoreSymbols, "hello world" and "hello, world!" are equal. + +Whitespace and mathematical symbols: + When using CompareOptions.None, "3 + 5 = 8" and "358" are not equal. + When using CompareOptions.IgnoreSymbols, "3 + 5 = 8" and "358" are equal. + +Currency symbols, decimals and thousands separators: + When using CompareOptions.None, "Total $15,000" and "Total: £150.00" are not equal. + When using CompareOptions.IgnoreSymbols, "Total $15,000" and "Total: £150.00" are equal. + +Half width and full width characters: + When using CompareOptions.None, "ａｂｃ，－" and "abc,-" are not equal. + When using CompareOptions.IgnoreWidth, "ａｂｃ，－" and "abc,-" are equal. + +Hiragana and Katakana strings: + When using CompareOptions.None, "ありがとう" and "アリガトウ" are not equal. + When using CompareOptions.IgnoreKanaType, "ありがとう" and "アリガトウ" are equal. + +Diacritical marks: + When using CompareOptions.None, "café" and "cafe" are not equal. + When using CompareOptions.IgnoreNonSpace, "café" and "cafe" are equal. + +Ligature characters: + When using CompareOptions.None, "straße œuvre cæsar" and "strasse oeuvre caesar" are not equal. + When using CompareOptions.IgnoreNonSpace, "straße œuvre cæsar" and "strasse oeuvre caesar" are equal. + +Note: When using .NET versions prior to .NET 5, ligature characters compare as equal to their +non-ligature counterparts by default, so the last test will output as follows: + +Ligature characters: + When using CompareOptions.None, "straße œuvre cæsar" and "strasse oeuvre caesar" are equal. + When using CompareOptions.IgnoreNonSpace, "straße œuvre cæsar" and "strasse oeuvre caesar" are equal. +*/ diff --git a/snippets/fsharp/System.Globalization/Project.fsproj b/snippets/fsharp/System.Globalization/Project.fsproj new file mode 100644 index 00000000000..145f21d0946 --- /dev/null +++ b/snippets/fsharp/System.Globalization/Project.fsproj @@ -0,0 +1,13 @@ + + + + Library + net9.0 + + + + + + + + diff --git a/snippets/fsharp/System.Globalization/compareoptions_stringsort.fs b/snippets/fsharp/System.Globalization/compareoptions_stringsort.fs new file mode 100644 index 00000000000..355c2d18ccf --- /dev/null +++ b/snippets/fsharp/System.Globalization/compareoptions_stringsort.fs @@ -0,0 +1,67 @@ +module compareoptions_stringsort + +open System +open System.Collections.Generic +open System.Globalization + +let sortAndDisplay (unsorted: List) (options: CompareOptions) = + let words = new List(unsorted) + let comparer = CultureInfo.InvariantCulture.CompareInfo + words.Sort((fun str1 str2 -> comparer.Compare(str1, str2, options))) + for word in words do + printfn "%s" word + +[] +let main argv = + let wordList = new List( + ["cant"; "bill's"; "coop"; "cannot"; "billet"; "can't"; "con"; "bills"; "co-op"]) + + printfn "Before sorting:" + for word in wordList do + printfn "%s" word + + printfn "\nAfter sorting with CompareOptions.None:" + sortAndDisplay wordList CompareOptions.None + + printfn "\nAfter sorting with CompareOptions.StringSort:" + sortAndDisplay wordList CompareOptions.StringSort + + 0 // return an integer exit code + +(* +CompareOptions.None and CompareOptions.StringSort provide identical ordering by default +in .NET 5 and later, but in prior versions, the output will be the following: + +Before sorting: +cant +bill's +coop +cannot +billet +can't +con +bills +co-op + +After sorting with CompareOptions.None: +billet +bills +bill's +cannot +cant +can't +con +coop +co-op + +After sorting with CompareOptions.StringSort: +bill's +billet +bills +can't +cannot +cant +co-op +con +coop +*) diff --git a/snippets/fsharp/System.Globalization/compareoptions_values.fs b/snippets/fsharp/System.Globalization/compareoptions_values.fs new file mode 100644 index 00000000000..eb3a3529af5 --- /dev/null +++ b/snippets/fsharp/System.Globalization/compareoptions_values.fs @@ -0,0 +1,90 @@ +module compareoptions_values + +open System +open System.Globalization + +let testStringEquality (str1: string) (str2: string) (description: string) (options: CompareOptions) = + printfn "\n%s:" description + + let compareAndPrint opts = + let result = String.Compare(str1, str2, CultureInfo.InvariantCulture, opts) + let equalityStatus = if result = 0 then "equal" else "not equal" + printfn " When using CompareOptions.%A, \"%s\" and \"%s\" are %s." opts str1 str2 equalityStatus + + compareAndPrint CompareOptions.None + compareAndPrint options + +[] +let main argv = + // Uppercase and lowercase characters are equivalent (according to the culture rules) when IgnoreCase is used. + testStringEquality "ONE two" "one TWO" "Case sensitivity" CompareOptions.IgnoreCase + + // Punctuation is ignored with the IgnoreSymbols option. + testStringEquality "hello world" "hello, world!" "Punctuation" CompareOptions.IgnoreSymbols + + // Whitespace and mathematical symbols are also ignored with IgnoreSymbols. + testStringEquality "3 + 5 = 8" "358" "Whitespace and mathematical symbols" CompareOptions.IgnoreSymbols + + // Caution: currency symbols and thousands separators are ignored with IgnoreSymbols. + // Parse strings containing numbers/currency and compare them numerically instead. + testStringEquality "Total $15,000" "Total: £150.00" "Currency symbols, decimals and thousands separators" CompareOptions.IgnoreSymbols + + // Full width characters are common in East Asian languages. Use the IgnoreWidth + // option to treat full- and half-width characters as equal. + testStringEquality "ａｂｃ，－" "abc,-" "Half width and full width characters" CompareOptions.IgnoreWidth + + // The same string in Hiragana and Katakana is equal when IgnoreKanaType is used. + testStringEquality "ありがとう" "アリガトウ" "Hiragana and Katakana strings" CompareOptions.IgnoreKanaType + + // When comparing with the IgnoreNonSpace option, characters like diacritical marks are ignored. + testStringEquality "café" "cafe" "Diacritical marks" CompareOptions.IgnoreNonSpace + + // Ligature characters and their non-ligature forms compare equal with the IgnoreNonSpace option. + // Note: prior to .NET 5, ligature characters were equal to their expanded forms by default. + testStringEquality "straße œuvre cæsar" "strasse oeuvre caesar" "Ligature characters" CompareOptions.IgnoreNonSpace + + 0 // return an integer exit code + +(* +In .NET 5 and later, the output will be the following: + +Case sensitivity: + When using CompareOptions.None, "ONE two" and "one TWO" are not equal. + When using CompareOptions.IgnoreCase, "ONE two" and "one TWO" are equal. + +Punctuation: + When using CompareOptions.None, "hello world" and "hello, world!" are not equal. + When using CompareOptions.IgnoreSymbols, "hello world" and "hello, world!" are equal. + +Whitespace and mathematical symbols: + When using CompareOptions.None, "3 + 5 = 8" and "358" are not equal. + When using CompareOptions.IgnoreSymbols, "3 + 5 = 8" and "358" are equal. + +Currency symbols, decimals and thousands separators: + When using CompareOptions.None, "Total $15,000" and "Total: £150.00" are not equal. + When using CompareOptions.IgnoreSymbols, "Total $15,000" and "Total: £150.00" are equal. + +Half width and full width characters: + When using CompareOptions.None, "ａｂｃ，－" and "abc,-" are not equal. + When using CompareOptions.IgnoreWidth, "ａｂｃ，－" and "abc,-" are equal. + +Hiragana and Katakana strings: + When using CompareOptions.None, "ありがとう" and "アリガトウ" are not equal. + When using CompareOptions.IgnoreKanaType, "ありがとう" and "アリガトウ" are equal. + +Diacritical marks: + When using CompareOptions.None, "café" and "cafe" are not equal. + When using CompareOptions.IgnoreNonSpace, "café" and "cafe" are equal. + +Ligature characters: + When using CompareOptions.None, "straße œuvre cæsar" and "strasse oeuvre caesar" are not equal. + When using CompareOptions.IgnoreNonSpace, "straße œuvre cæsar" and "strasse oeuvre caesar" are equal. + + +Note: when using .NET versions prior to .NET 5, ligature characters compare as equal to their +non-ligature counterparts by default, so the last test will output as follows: + +Ligature characters: + When using CompareOptions.None, "straße œuvre cæsar" and "strasse oeuvre caesar" are equal. + When using CompareOptions.IgnoreNonSpace, "straße œuvre cæsar" and "strasse oeuvre caesar" are equal. +*) diff --git a/snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.StringSort/VB/Project.vbproj b/snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.StringSort/VB/Project.vbproj new file mode 100644 index 00000000000..92e46ddaccf --- /dev/null +++ b/snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.StringSort/VB/Project.vbproj @@ -0,0 +1,8 @@ + + + + Exe + net9.0 + + + diff --git a/snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.StringSort/VB/compareoptions_stringsort.vb b/snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.StringSort/VB/compareoptions_stringsort.vb index da1c2c9195e..164042db7b6 100644 --- a/snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.StringSort/VB/compareoptions_stringsort.vb +++ b/snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.StringSort/VB/compareoptions_stringsort.vb @@ -1,87 +1,46 @@ -' The following code example shows how sorting with CompareOptions.StringSort differs from sorting without CompareOptions.StringSort. - -' -Imports System.Collections +Imports System +Imports System.Collections.Generic Imports System.Globalization -Public Class SamplesCompareOptions - - Private Class MyStringComparer - Implements IComparer - - Private myComp As CompareInfo - Private myOptions As CompareOptions = CompareOptions.None - - ' Constructs a comparer using the specified CompareOptions. - Public Sub New(cmpi As CompareInfo, options As CompareOptions) - myComp = cmpi - Me.myOptions = options - End Sub - - ' Compares strings with the CompareOptions specified in the constructor. - Public Function Compare(a As [Object], b As [Object]) As Integer Implements IComparer.Compare - If a = b Then - Return 0 - End If - If a Is Nothing Then - Return - 1 - End If - If b Is Nothing Then - Return 1 - End If +Public Class StringSort + Public Shared Sub Main() + Dim wordList As New List(Of String) From { + "cant", "bill's", "coop", "cannot", "billet", "can't", "con", "bills", "co-op" + } - Dim sa As [String] = a - Dim sb As [String] = b - If Not (sa Is Nothing) And Not (sb Is Nothing) Then - Return myComp.Compare(sa, sb, myOptions) - End If - Throw New ArgumentException("a and b should be strings.") + Console.WriteLine("Before sorting:") + For Each word In wordList + Console.WriteLine(word) + Next - End Function 'Compare + Console.WriteLine(Environment.NewLine & "After sorting with CompareOptions.None:") + SortAndDisplay(wordList, CompareOptions.None) - End Class + Console.WriteLine(Environment.NewLine & "After sorting with CompareOptions.StringSort:") + SortAndDisplay(wordList, CompareOptions.StringSort) + End Sub + ' Sort the list of words with the supplied CompareOptions. + Private Shared Sub SortAndDisplay(unsorted As List(Of String), options As CompareOptions) + ' Create a copy of the original list to sort. + Dim words As New List(Of String)(unsorted) - Public Shared Sub Main() - - ' Creates and initializes an array of strings to sort. - Dim myArr() As [String] = {"cant", "bill's", "coop", "cannot", "billet", "can't", "con", "bills", "co-op"} - Console.WriteLine() - Console.WriteLine("Initially,") - Dim myStr As [String] - For Each myStr In myArr - Console.WriteLine(myStr) - Next myStr + ' Define the CompareInfo to use to compare strings. + Dim comparer As CompareInfo = CultureInfo.InvariantCulture.CompareInfo - ' Creates and initializes a Comparer to use. - 'CultureInfo myCI = new CultureInfo( "en-US", false ); - Dim myComp As New MyStringComparer(CompareInfo.GetCompareInfo("en-US"), CompareOptions.None) - - ' Sorts the array without StringSort. - Array.Sort(myArr, myComp) - Console.WriteLine() - Console.WriteLine("After sorting without CompareOptions.StringSort:") - For Each myStr In myArr - Console.WriteLine(myStr) - Next myStr - - ' Sorts the array with StringSort. - myComp = New MyStringComparer(CompareInfo.GetCompareInfo("en-US"), CompareOptions.StringSort) - Array.Sort(myArr, myComp) - Console.WriteLine() - Console.WriteLine("After sorting with CompareOptions.StringSort:") - For Each myStr In myArr - Console.WriteLine(myStr) - Next myStr - - End Sub + ' Sort the copy with the supplied CompareOptions then display. + words.Sort(Function(str1, str2) comparer.Compare(str1, str2, options)) + For Each word In words + Console.WriteLine(word) + Next + End Sub End Class - -'This code produces the following output. +' CompareOptions.None and CompareOptions.StringSort provide identical ordering by default +' in .NET 5 And later, but in prior versions, the output is the following: ' -'Initially, +'Before sorting 'cant 'bill's 'coop @@ -91,8 +50,8 @@ End Class 'con 'bills 'co-op -' -'After sorting without CompareOptions.StringSort: + +'After sorting with CompareOptions.None 'billet 'bills 'bill's @@ -102,8 +61,8 @@ End Class 'con 'coop 'co-op -' -'After sorting with CompareOptions.StringSort: + +'After sorting with CompareOptions.StringSort 'bill's 'billet 'bills @@ -113,5 +72,3 @@ End Class 'co-op 'con 'coop - -' \ No newline at end of file diff --git a/snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.Values/VB/Project.vbproj b/snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.Values/VB/Project.vbproj new file mode 100644 index 00000000000..92e46ddaccf --- /dev/null +++ b/snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.Values/VB/Project.vbproj @@ -0,0 +1,8 @@ + + + + Exe + net9.0 + + + diff --git a/snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.Values/VB/compareoptions_values.vb b/snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.Values/VB/compareoptions_values.vb new file mode 100644 index 00000000000..885a8c140fe --- /dev/null +++ b/snippets/visualbasic/VS_Snippets_CLR_System/system.Globalization.CompareOptions.Values/VB/compareoptions_values.vb @@ -0,0 +1,90 @@ +Imports System +Imports System.Globalization + +Module CompareOptionsExample + Sub Main() + ' Uppercase and lowercase characters are equivalent (according to the culture rules) + ' when IgnoreCase is used. + TestStringEquality("ONE two", "one TWO", "Case sensitivity", CompareOptions.IgnoreCase) + + ' Punctuation is ignored with the IgnoreSymbols option. + TestStringEquality("hello world", "hello, world!", "Punctuation", CompareOptions.IgnoreSymbols) + + ' Whitespace and mathematical symbols are also ignored with IgnoreSymbols. + TestStringEquality("3 + 5 = 8", "358", "Whitespace and mathematical symbols", CompareOptions.IgnoreSymbols) + + ' Caution: currency symbols and thousands separators are ignored with IgnoreSymbols. + ' Parse strings containing numbers/currency and compare them numerically instead. + TestStringEquality("Total $15,000", "Total: £150.00", "Currency symbols, decimals and thousands separators", CompareOptions.IgnoreSymbols) + + ' Full width characters are common in East Asian languages. Use the IgnoreWidth + ' option to treat full- and half-width characters as equal. + TestStringEquality("ａｂｃ，－", "abc,-", "Half width and full width characters", CompareOptions.IgnoreWidth) + + ' The same string in Hiragana and Katakana is equal when IgnoreKanaType is used. + TestStringEquality("ありがとう", "アリガトウ", "Hiragana and Katakana strings", CompareOptions.IgnoreKanaType) + + ' When comparing with the IgnoreNonSpace option, characters like diacritical marks are ignored. + TestStringEquality("café", "cafe", "Diacritical marks", CompareOptions.IgnoreNonSpace) + + ' Ligature characters and their non-ligature forms compare equal with the IgnoreNonSpace option. + ' Note: prior to .NET 5, ligature characters were equal to their expanded forms by default. + TestStringEquality("straße œuvre cæsar", "strasse oeuvre caesar", "Ligature characters", CompareOptions.IgnoreNonSpace) + End Sub + + Private Sub TestStringEquality(str1 As String, str2 As String, description As String, options As CompareOptions) + Console.WriteLine(Environment.NewLine & description & ":") + ' First test with the default CompareOptions then with the provided options + TestStringEqualityWithOptions(str1, str2, CompareOptions.None) + TestStringEqualityWithOptions(str1, str2, options) + End Sub + + Private Sub TestStringEqualityWithOptions(str1 As String, str2 As String, options As CompareOptions) + Console.Write($" When using CompareOptions.{options}, ""{str1}"" and ""{str2}"" are ") + If String.Compare(str1, str2, CultureInfo.InvariantCulture, options) <> 0 Then + Console.Write("not ") + End If + Console.WriteLine("equal.") + End Sub +End Module + +' In .NET 5 and later, the output is the following: +' +'Case sensitivity : +' When using CompareOptions.None, "ONE two" and "one TWO" are not equal. +' When using CompareOptions.IgnoreCase, "ONE two" and "one TWO" are equal. +' +'Punctuation: +' When using CompareOptions.None, "hello world" and "hello, world!" are not equal. +' When using CompareOptions.IgnoreSymbols, "hello world" and "hello, world!" are equal. +' +'Whitespace And mathematical symbols: +' When using CompareOptions.None, "3 + 5 = 8" and "358" are not equal. +' When using CompareOptions.IgnoreSymbols, "3 + 5 = 8" and "358" are equal. +' +'Currency symbols, decimals And thousands separators: +' When using CompareOptions.None, "Total $15,000" and "Total: £150.00" are not equal. +' When using CompareOptions.IgnoreSymbols, "Total $15,000" and "Total: £150.00" are equal. +' +'Half width And full width characters: +' When using CompareOptions.None, "ａｂｃ，－" and "abc,-" are not equal. +' When using CompareOptions.IgnoreWidth, "ａｂｃ，－" and "abc,-" are equal. +' +'Hiragana And Katakana strings: +' When using CompareOptions.None, "ありがとう" and "アリガトウ" are not equal. +' When using CompareOptions.IgnoreKanaType, "ありがとう" and "アリガトウ" are equal. +' +'Diacritical marks : +' When using CompareOptions.None, "café" and "cafe" are not equal. +' When using CompareOptions.IgnoreNonSpace, "café" and "cafe" are equal. +' +'Ligature characters : +' When using CompareOptions.None, "straße œuvre cæsar" and "strasse oeuvre caesar" are not equal. +' When using CompareOptions.IgnoreNonSpace, "straße œuvre cæsar" and "strasse oeuvre caesar" are equal. +' +' Note: when using .NET versions prior to .NET 5, ligature characters compare as equal to their +' non-ligature counterparts by default, so the last test will output as follows: +' +'Ligature characters : +' When using CompareOptions.None, "straße œuvre cæsar" and "strasse oeuvre caesar" are equal. +' When using CompareOptions.IgnoreNonSpace, "straße œuvre cæsar" and "strasse oeuvre caesar" are equal. diff --git a/xml/System.Globalization/CompareOptions.xml b/xml/System.Globalization/CompareOptions.xml index 80bd38adff3..e5940339c94 100644 --- a/xml/System.Globalization/CompareOptions.xml +++ b/xml/System.Globalization/CompareOptions.xml @@ -71,15 +71,42 @@ - Defines the string comparison options to use with . - For more information about this API, see Supplemental API remarks for CompareOptions. + + Defines the string comparison options to use with . + + + + + + + The following code example shows how each of the CompareOptions values affect string comparisons. + + + + The following code example shows how sorting with StringSort differs from sorting without StringSort. - + + + + Basic String Operations in .NET @@ -125,7 +152,7 @@ 1 - Indicates that the string comparison must ignore case. + Indicates that the string comparison ignores case differences. @@ -170,7 +197,7 @@ 8 - Indicates that the string comparison must ignore the Kana type. Kana type refers to Japanese hiragana and katakana characters, which represent phonetic sounds in the Japanese language. Hiragana is used for native Japanese expressions and words, while katakana is used for words borrowed from other languages, such as "computer" or "Internet". A phonetic sound can be expressed in both hiragana and katakana. If this value is selected, the hiragana character for one sound is considered equal to the katakana character for the same sound. + Indicates that the string comparison ignores the kana type. Kana type refers to Japanese hiragana and katakana characters, which represent phonetic sounds. Hiragana is used for native Japanese words, while katakana is used for words borrowed from other languages. With this option, hiragana and katakana characters that represent the same sound are considered equal. @@ -215,7 +242,7 @@ 2 - Indicates that the string comparison must ignore nonspacing combining characters, such as diacritics. The Unicode Standard defines combining characters as characters that are combined with base characters to produce a new character. Nonspacing combining characters do not occupy a spacing position by themselves when rendered. + Indicates that the string comparison ignores nonspacing combining characters, such as diacritics. Nonspacing characters modify base characters without occupying their own space. The Unicode Standard defines combining characters as characters that are combined with base characters to produce a new character. @@ -260,7 +287,7 @@ 4 - Indicates that the string comparison must ignore symbols, such as white-space characters, punctuation, currency symbols, the percent sign, mathematical symbols, the ampersand, and so on. + Indicates that the string comparison ignores symbols, including whitespace, punctuation, currency symbols, the percent sign, mathematical symbols, the ampersand, and similar characters. @@ -305,7 +332,7 @@ 16 - Indicates that the string comparison must ignore the character width. For example, Japanese katakana characters can be written as full-width or half-width. If this value is selected, the katakana characters written as full-width are considered equal to the same characters written as half-width. + Indicates that the string comparison ignores character width. For example, full-width and half-width forms of Japanese katakana characters are considered equal with this option. @@ -424,7 +451,7 @@ 1073741824 - Indicates that the string comparison must use successive Unicode UTF-16 encoded values of the string (code unit by code unit comparison), leading to a fast comparison but one that is culture-insensitive. A string starting with a code unit XXXX16 comes before a string starting with YYYY16, if XXXX16 is less than YYYY16. This value cannot be combined with other values and must be used alone. + Indicates that the string comparison uses the Unicode UTF-16 encoded values of the strings, comparing them code unit by code unit. This results in a fast, culture-insensitive comparison where strings are ordered based only on their binary values. This option can't be combined with other values and must be used alone. @@ -468,7 +495,7 @@ 268435456 - String comparison must ignore case, then perform an ordinal comparison. This technique is equivalent to converting the string to uppercase using the invariant culture and then performing an ordinal comparison on the result. + Indicates that the string comparison ignores case and then performs an ordinal comparison. This is equivalent to converting both strings to uppercase using the invariant culture and then performing the comparison. @@ -513,7 +540,7 @@ 536870912 - Indicates that the string comparison must use the string sort algorithm. In a string sort, the hyphen and the apostrophe, as well as other nonalphanumeric symbols, come before alphanumeric characters. + Indicates that the string comparison uses the string sort algorithm, where nonalphanumeric symbols (such as hyphens and apostrophes) are sorted before alphanumeric characters. From 35abe3575d2ad8050426e4c87ee0c60dc53a9ca6 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Thu, 3 Apr 2025 10:58:43 -0700 Subject: [PATCH 3/4] Fix build warnings in CompareOptions (#11164) --- xml/System.Globalization/CompareOptions.xml | 49 +++++++++------------ 1 file changed, 22 insertions(+), 27 deletions(-) diff --git a/xml/System.Globalization/CompareOptions.xml b/xml/System.Globalization/CompareOptions.xml index e5940339c94..795f416e9be 100644 --- a/xml/System.Globalization/CompareOptions.xml +++ b/xml/System.Globalization/CompareOptions.xml @@ -75,38 +75,33 @@ Defines the string comparison options to use with . - - - - The following code example shows how each of the CompareOptions values affect string comparisons. - - - - - - The following code example shows how sorting with StringSort differs from sorting without StringSort. - - - - Basic String Operations in .NET From 48555106fa27e6d221c2d244947e0ac7fd138b7c Mon Sep 17 00:00:00 2001 From: Petr Onderka Date: Thu, 3 Apr 2025 21:59:05 +0200 Subject: [PATCH 4/4] Modernize 3DES examples (#8742) --- .../CPP/fileexample.cpp | 113 ----------------- .../CPP/memoryexample.cpp | 105 ---------------- .../CPP/source.cpp | 43 ------- .../TripleDES/Overview/Project.csproj | 8 -- .../TripleDES/Overview/source.cs | 39 ------ .../Overview/fileexample.cs | 114 ------------------ .../Overview/memoryexample.cs | 106 ---------------- .../VB/{project.csproj => project.vbproj} | 0 .../{project.csproj => project.vbproj} | 0 .../VB/fileexample.vb | 98 --------------- .../VB/memoryexample.vb | 94 --------------- .../VB/source.vb | 39 ------ .../TripleDES.xml | 15 ++- .../TripleDESCryptoServiceProvider.xml | 67 +--------- 14 files changed, 15 insertions(+), 826 deletions(-) delete mode 100644 snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/CPP/fileexample.cpp delete mode 100644 snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/CPP/memoryexample.cpp delete mode 100644 snippets/cpp/VS_Snippets_CLR_Classic/classic TripleDESCryptoServiceProvider Example/CPP/source.cpp delete mode 100644 snippets/csharp/System.Security.Cryptography/TripleDES/Overview/Project.csproj delete mode 100644 snippets/csharp/System.Security.Cryptography/TripleDES/Overview/source.cs delete mode 100644 snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/fileexample.cs delete mode 100644 snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/memoryexample.cs rename snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.File/VB/{project.csproj => project.vbproj} (100%) rename snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.Memory/{project.csproj => project.vbproj} (100%) delete mode 100644 snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/VB/fileexample.vb delete mode 100644 snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/VB/memoryexample.vb delete mode 100644 snippets/visualbasic/VS_Snippets_CLR_Classic/classic TripleDESCryptoServiceProvider Example/VB/source.vb diff --git a/snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/CPP/fileexample.cpp b/snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/CPP/fileexample.cpp deleted file mode 100644 index 3a2a66eed8a..00000000000 --- a/snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/CPP/fileexample.cpp +++ /dev/null @@ -1,113 +0,0 @@ - -// -using namespace System; -using namespace System::Security::Cryptography; -using namespace System::Text; -using namespace System::IO; -void EncryptTextToFile( String^ Data, String^ FileName, array^Key, array^IV ) -{ - try - { - - // Create or open the specified file. - FileStream^ fStream = File::Open( FileName, FileMode::OpenOrCreate ); - - // Create a CryptoStream using the FileStream - // and the passed key and initialization vector (IV). - CryptoStream^ cStream = gcnew CryptoStream( fStream,(gcnew TripleDESCryptoServiceProvider)->CreateEncryptor( Key, IV ),CryptoStreamMode::Write ); - - // Create a StreamWriter using the CryptoStream. - StreamWriter^ sWriter = gcnew StreamWriter( cStream ); - - // Write the data to the stream - // to encrypt it. - sWriter->WriteLine( Data ); - - // Close the streams and - // close the file. - sWriter->Close(); - cStream->Close(); - fStream->Close(); - } - catch ( CryptographicException^ e ) - { - Console::WriteLine( "A Cryptographic error occurred: {0}", e->Message ); - } - catch ( UnauthorizedAccessException^ e ) - { - Console::WriteLine( "A file access error occurred: {0}", e->Message ); - } - -} - -String^ DecryptTextFromFile( String^ FileName, array^Key, array^IV ) -{ - try - { - - // Create or open the specified file. - FileStream^ fStream = File::Open( FileName, FileMode::OpenOrCreate ); - - // Create a CryptoStream using the FileStream - // and the passed key and initialization vector (IV). - CryptoStream^ cStream = gcnew CryptoStream( fStream,(gcnew TripleDESCryptoServiceProvider)->CreateDecryptor( Key, IV ),CryptoStreamMode::Read ); - - // Create a StreamReader using the CryptoStream. - StreamReader^ sReader = gcnew StreamReader( cStream ); - - // Read the data from the stream - // to decrypt it. - String^ val = sReader->ReadLine(); - - // Close the streams and - // close the file. - sReader->Close(); - cStream->Close(); - fStream->Close(); - - // Return the string. - return val; - } - catch ( CryptographicException^ e ) - { - Console::WriteLine( "A Cryptographic error occurred: {0}", e->Message ); - return nullptr; - } - catch ( UnauthorizedAccessException^ e ) - { - Console::WriteLine( "A file access error occurred: {0}", e->Message ); - return nullptr; - } - -} - -int main() -{ - try - { - - // Create a new TripleDESCryptoServiceProvider object - // to generate a key and initialization vector (IV). - TripleDESCryptoServiceProvider^ tDESalg = gcnew TripleDESCryptoServiceProvider; - - // Create a string to encrypt. - String^ sData = "Here is some data to encrypt."; - String^ FileName = "CText.txt"; - - // Encrypt text to a file using the file name, key, and IV. - EncryptTextToFile( sData, FileName, tDESalg->Key, tDESalg->IV ); - - // Decrypt the text from a file using the file name, key, and IV. - String^ Final = DecryptTextFromFile( FileName, tDESalg->Key, tDESalg->IV ); - - // Display the decrypted string to the console. - Console::WriteLine( Final ); - } - catch ( Exception^ e ) - { - Console::WriteLine( e->Message ); - } - -} - -// diff --git a/snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/CPP/memoryexample.cpp b/snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/CPP/memoryexample.cpp deleted file mode 100644 index 1d26f0f096b..00000000000 --- a/snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/CPP/memoryexample.cpp +++ /dev/null @@ -1,105 +0,0 @@ - -// -using namespace System; -using namespace System::Security::Cryptography; -using namespace System::Text; -using namespace System::IO; -array^ EncryptTextToMemory( String^ Data, array^Key, array^IV ) -{ - try - { - - // Create a MemoryStream. - MemoryStream^ mStream = gcnew MemoryStream; - - // Create a CryptoStream using the MemoryStream - // and the passed key and initialization vector (IV). - CryptoStream^ cStream = gcnew CryptoStream( mStream,(gcnew TripleDESCryptoServiceProvider)->CreateEncryptor( Key, IV ),CryptoStreamMode::Write ); - - // Convert the passed string to a byte array. - array^toEncrypt = (gcnew ASCIIEncoding)->GetBytes( Data ); - - // Write the byte array to the crypto stream and flush it. - cStream->Write( toEncrypt, 0, toEncrypt->Length ); - cStream->FlushFinalBlock(); - - // Get an array of bytes from the - // MemoryStream that holds the - // encrypted data. - array^ret = mStream->ToArray(); - - // Close the streams. - cStream->Close(); - mStream->Close(); - - // Return the encrypted buffer. - return ret; - } - catch ( CryptographicException^ e ) - { - Console::WriteLine( "A Cryptographic error occurred: {0}", e->Message ); - return nullptr; - } - -} - -String^ DecryptTextFromMemory( array^Data, array^Key, array^IV ) -{ - try - { - - // Create a new MemoryStream using the passed - // array of encrypted data. - MemoryStream^ msDecrypt = gcnew MemoryStream( Data ); - - // Create a CryptoStream using the MemoryStream - // and the passed key and initialization vector (IV). - CryptoStream^ csDecrypt = gcnew CryptoStream( msDecrypt,(gcnew TripleDESCryptoServiceProvider)->CreateDecryptor( Key, IV ),CryptoStreamMode::Read ); - - // Create buffer to hold the decrypted data. - array^fromEncrypt = gcnew array(Data->Length); - - // Read the decrypted data out of the crypto stream - // and place it into the temporary buffer. - csDecrypt->Read( fromEncrypt, 0, fromEncrypt->Length ); - - //Convert the buffer into a string and return it. - return (gcnew ASCIIEncoding)->GetString( fromEncrypt ); - } - catch ( CryptographicException^ e ) - { - Console::WriteLine( "A Cryptographic error occurred: {0}", e->Message ); - return nullptr; - } - -} - -int main() -{ - try - { - - // Create a new TripleDESCryptoServiceProvider object - // to generate a key and initialization vector (IV). - TripleDESCryptoServiceProvider^ tDESalg = gcnew TripleDESCryptoServiceProvider; - - // Create a string to encrypt. - String^ sData = "Here is some data to encrypt."; - - // Encrypt the string to an in-memory buffer. - array^Data = EncryptTextToMemory( sData, tDESalg->Key, tDESalg->IV ); - - // Decrypt the buffer back to a string. - String^ Final = DecryptTextFromMemory( Data, tDESalg->Key, tDESalg->IV ); - - // Display the decrypted string to the console. - Console::WriteLine( Final ); - } - catch ( Exception^ e ) - { - Console::WriteLine( e->Message ); - } - -} - -// diff --git a/snippets/cpp/VS_Snippets_CLR_Classic/classic TripleDESCryptoServiceProvider Example/CPP/source.cpp b/snippets/cpp/VS_Snippets_CLR_Classic/classic TripleDESCryptoServiceProvider Example/CPP/source.cpp deleted file mode 100644 index 2caa6452d62..00000000000 --- a/snippets/cpp/VS_Snippets_CLR_Classic/classic TripleDESCryptoServiceProvider Example/CPP/source.cpp +++ /dev/null @@ -1,43 +0,0 @@ - - -#using - -using namespace System; -using namespace System::IO; -using namespace System::ComponentModel; -using namespace System::Security::Cryptography; - -// -void EncryptData( String^ inName, String^ outName, array^tdesKey, array^tdesIV ) -{ - - //Create the file streams to handle the input and output files. - FileStream^ fin = gcnew FileStream( inName,FileMode::Open,FileAccess::Read ); - FileStream^ fout = gcnew FileStream( outName,FileMode::OpenOrCreate,FileAccess::Write ); - fout->SetLength( 0 ); - - //Create variables to help with read and write. - array^bin = gcnew array(100); - long rdlen = 0; //This is the total number of bytes written. - - long totlen = (long)fin->Length; //This is the total length of the input file. - - int len; //This is the number of bytes to be written at a time. - - TripleDESCryptoServiceProvider^ tdes = gcnew TripleDESCryptoServiceProvider; - CryptoStream^ encStream = gcnew CryptoStream( fout,tdes->CreateEncryptor( tdesKey, tdesIV ),CryptoStreamMode::Write ); - Console::WriteLine( "Encrypting..." ); - - //Read from the input file, then encrypt and write to the output file. - while ( rdlen < totlen ) - { - len = fin->Read( bin, 0, 100 ); - encStream->Write( bin, 0, len ); - rdlen = rdlen + len; - Console::WriteLine( "{0} bytes processed", rdlen ); - } - - encStream->Close(); -} - -// diff --git a/snippets/csharp/System.Security.Cryptography/TripleDES/Overview/Project.csproj b/snippets/csharp/System.Security.Cryptography/TripleDES/Overview/Project.csproj deleted file mode 100644 index c02dc5044e7..00000000000 --- a/snippets/csharp/System.Security.Cryptography/TripleDES/Overview/Project.csproj +++ /dev/null @@ -1,8 +0,0 @@ - - - - Library - net6.0 - - - \ No newline at end of file diff --git a/snippets/csharp/System.Security.Cryptography/TripleDES/Overview/source.cs b/snippets/csharp/System.Security.Cryptography/TripleDES/Overview/source.cs deleted file mode 100644 index 2066c68c338..00000000000 --- a/snippets/csharp/System.Security.Cryptography/TripleDES/Overview/source.cs +++ /dev/null @@ -1,39 +0,0 @@ -using System; -using System.IO; -using System.ComponentModel; -using System.Security.Cryptography; - -public class Sample -{ -// - private static void EncryptData(string inName, string outName, byte[] tdesKey, byte[] tdesIV) - { - //Create the file streams to handle the input and output files. - FileStream fin = new FileStream(inName, FileMode.Open, FileAccess.Read); - FileStream fout = new FileStream(outName, FileMode.OpenOrCreate, FileAccess.Write); - fout.SetLength(0); - - //Create variables to help with read and write. - byte[] bin = new byte[100]; //This is intermediate storage for the encryption. - long rdlen = 0; //This is the total number of bytes written. - long totlen = fin.Length; //This is the total length of the input file. - int len; //This is the number of bytes to be written at a time. - - TripleDESCryptoServiceProvider tdes = new TripleDESCryptoServiceProvider(); - CryptoStream encStream = new CryptoStream(fout, tdes.CreateEncryptor(tdesKey, tdesIV), CryptoStreamMode.Write); - - Console.WriteLine("Encrypting..."); - - //Read from the input file, then encrypt and write to the output file. - while(rdlen < totlen) - { - len = fin.Read(bin, 0, 100); - encStream.Write(bin, 0, len); - rdlen = rdlen + len; - Console.WriteLine("{0} bytes processed", rdlen); - } - - encStream.Close(); - } -// -} diff --git a/snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/fileexample.cs b/snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/fileexample.cs deleted file mode 100644 index 7f087762f75..00000000000 --- a/snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/fileexample.cs +++ /dev/null @@ -1,114 +0,0 @@ -// -using System; -using System.Security.Cryptography; -using System.Text; -using System.IO; - -class TrippleDESCSPSample -{ - - static void Main() - { - try - { - // Create a new TripleDESCryptoServiceProvider object - // to generate a key and initialization vector (IV). - TripleDESCryptoServiceProvider tDESalg = new TripleDESCryptoServiceProvider(); - - // Create a string to encrypt. - string sData = "Here is some data to encrypt."; - string FileName = "CText.txt"; - - // Encrypt text to a file using the file name, key, and IV. - EncryptTextToFile(sData, FileName, tDESalg.Key, tDESalg.IV); - - // Decrypt the text from a file using the file name, key, and IV. - string Final = DecryptTextFromFile(FileName, tDESalg.Key, tDESalg.IV); - - // Display the decrypted string to the console. - Console.WriteLine(Final); - } - catch (Exception e) - { - Console.WriteLine(e.Message); - } - } - - public static void EncryptTextToFile(String Data, String FileName, byte[] Key, byte[] IV) - { - try - { - // Create or open the specified file. - FileStream fStream = File.Open(FileName,FileMode.OpenOrCreate); - - // Create a CryptoStream using the FileStream - // and the passed key and initialization vector (IV). - CryptoStream cStream = new CryptoStream(fStream, - new TripleDESCryptoServiceProvider().CreateEncryptor(Key,IV), - CryptoStreamMode.Write); - - // Create a StreamWriter using the CryptoStream. - StreamWriter sWriter = new StreamWriter(cStream); - - // Write the data to the stream - // to encrypt it. - sWriter.WriteLine(Data); - - // Close the streams and - // close the file. - sWriter.Close(); - cStream.Close(); - fStream.Close(); - } - catch(CryptographicException e) - { - Console.WriteLine("A Cryptographic error occurred: {0}", e.Message); - } - catch(UnauthorizedAccessException e) - { - Console.WriteLine("A file access error occurred: {0}", e.Message); - } - } - - public static string DecryptTextFromFile(String FileName, byte[] Key, byte[] IV) - { - try - { - // Create or open the specified file. - FileStream fStream = File.Open(FileName, FileMode.OpenOrCreate); - - // Create a CryptoStream using the FileStream - // and the passed key and initialization vector (IV). - CryptoStream cStream = new CryptoStream(fStream, - new TripleDESCryptoServiceProvider().CreateDecryptor(Key,IV), - CryptoStreamMode.Read); - - // Create a StreamReader using the CryptoStream. - StreamReader sReader = new StreamReader(cStream); - - // Read the data from the stream - // to decrypt it. - string val = sReader.ReadLine(); - - // Close the streams and - // close the file. - sReader.Close(); - cStream.Close(); - fStream.Close(); - - // Return the string. - return val; - } - catch(CryptographicException e) - { - Console.WriteLine("A Cryptographic error occurred: {0}", e.Message); - return null; - } - catch(UnauthorizedAccessException e) - { - Console.WriteLine("A file access error occurred: {0}", e.Message); - return null; - } - } -} -// \ No newline at end of file diff --git a/snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/memoryexample.cs b/snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/memoryexample.cs deleted file mode 100644 index c48a200e792..00000000000 --- a/snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/memoryexample.cs +++ /dev/null @@ -1,106 +0,0 @@ -// -using System; -using System.Security.Cryptography; -using System.Text; -using System.IO; - -class TrippleDESCSPSample -{ - - static void Main() - { - try - { - // Create a new TripleDESCryptoServiceProvider object - // to generate a key and initialization vector (IV). - TripleDESCryptoServiceProvider tDESalg = new TripleDESCryptoServiceProvider(); - - // Create a string to encrypt. - string sData = "Here is some data to encrypt."; - - // Encrypt the string to an in-memory buffer. - byte[] Data = EncryptTextToMemory(sData, tDESalg.Key, tDESalg.IV); - - // Decrypt the buffer back to a string. - string Final = DecryptTextFromMemory(Data, tDESalg.Key, tDESalg.IV); - - // Display the decrypted string to the console. - Console.WriteLine(Final); - } - catch (Exception e) - { - Console.WriteLine(e.Message); - } - } - - public static byte[] EncryptTextToMemory(string Data, byte[] Key, byte[] IV) - { - try - { - // Create a MemoryStream. - MemoryStream mStream = new MemoryStream(); - - // Create a CryptoStream using the MemoryStream - // and the passed key and initialization vector (IV). - CryptoStream cStream = new CryptoStream(mStream, - new TripleDESCryptoServiceProvider().CreateEncryptor(Key, IV), - CryptoStreamMode.Write); - - // Convert the passed string to a byte array. - byte[] toEncrypt = new ASCIIEncoding().GetBytes(Data); - - // Write the byte array to the crypto stream and flush it. - cStream.Write(toEncrypt, 0, toEncrypt.Length); - cStream.FlushFinalBlock(); - - // Get an array of bytes from the - // MemoryStream that holds the - // encrypted data. - byte[] ret = mStream.ToArray(); - - // Close the streams. - cStream.Close(); - mStream.Close(); - - // Return the encrypted buffer. - return ret; - } - catch(CryptographicException e) - { - Console.WriteLine("A Cryptographic error occurred: {0}", e.Message); - return null; - } - } - - public static string DecryptTextFromMemory(byte[] Data, byte[] Key, byte[] IV) - { - try - { - // Create a new MemoryStream using the passed - // array of encrypted data. - MemoryStream msDecrypt = new MemoryStream(Data); - - // Create a CryptoStream using the MemoryStream - // and the passed key and initialization vector (IV). - CryptoStream csDecrypt = new CryptoStream(msDecrypt, - new TripleDESCryptoServiceProvider().CreateDecryptor(Key, IV), - CryptoStreamMode.Read); - - // Create buffer to hold the decrypted data. - byte[] fromEncrypt = new byte[Data.Length]; - - // Read the decrypted data out of the crypto stream - // and place it into the temporary buffer. - csDecrypt.Read(fromEncrypt, 0, fromEncrypt.Length); - - //Convert the buffer into a string and return it. - return new ASCIIEncoding().GetString(fromEncrypt); - } - catch(CryptographicException e) - { - Console.WriteLine("A Cryptographic error occurred: {0}", e.Message); - return null; - } - } -} -// diff --git a/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.File/VB/project.csproj b/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.File/VB/project.vbproj similarity index 100% rename from snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.File/VB/project.csproj rename to snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.File/VB/project.vbproj diff --git a/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.Memory/project.csproj b/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.Memory/project.vbproj similarity index 100% rename from snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.Memory/project.csproj rename to snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.Memory/project.vbproj diff --git a/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/VB/fileexample.vb b/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/VB/fileexample.vb deleted file mode 100644 index abf5d60b8a5..00000000000 --- a/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/VB/fileexample.vb +++ /dev/null @@ -1,98 +0,0 @@ - ' -Imports System.Security.Cryptography -Imports System.Text -Imports System.IO - -Module TrippleDESCSPSample - - Sub Main() - Try - ' Create a new TripleDESCryptoServiceProvider object - ' to generate a key and initialization vector (IV). - Dim tDESalg As New TripleDESCryptoServiceProvider - - ' Create a string to encrypt. - Dim sData As String = "Here is some data to encrypt." - Dim FileName As String = "CText.txt" - - ' Encrypt text to a file using the file name, key, and IV. - EncryptTextToFile(sData, FileName, tDESalg.Key, tDESalg.IV) - - ' Decrypt the text from a file using the file name, key, and IV. - Dim Final As String = DecryptTextFromFile(FileName, tDESalg.Key, tDESalg.IV) - - ' Display the decrypted string to the console. - Console.WriteLine(Final) - Catch e As Exception - Console.WriteLine(e.Message) - End Try - End Sub - - - Sub EncryptTextToFile(ByVal Data As String, ByVal FileName As String, ByVal Key() As Byte, ByVal IV() As Byte) - Try - ' Create or open the specified file. - Dim fStream As FileStream = File.Open(FileName, FileMode.OpenOrCreate) - - ' Create a CryptoStream using the FileStream - ' and the passed key and initialization vector (IV). - Dim cStream As New CryptoStream(fStream, _ - New TripleDESCryptoServiceProvider().CreateEncryptor(Key, IV), _ - CryptoStreamMode.Write) - - ' Create a StreamWriter using the CryptoStream. - Dim sWriter As New StreamWriter(cStream) - - ' Write the data to the stream - ' to encrypt it. - sWriter.WriteLine(Data) - - ' Close the streams and - ' close the file. - sWriter.Close() - cStream.Close() - fStream.Close() - Catch e As CryptographicException - Console.WriteLine("A Cryptographic error occurred: {0}", e.Message) - Catch e As UnauthorizedAccessException - Console.WriteLine("A file error occurred: {0}", e.Message) - End Try - End Sub - - - Function DecryptTextFromFile(ByVal FileName As String, ByVal Key() As Byte, ByVal IV() As Byte) As String - Try - ' Create or open the specified file. - Dim fStream As FileStream = File.Open(FileName, FileMode.OpenOrCreate) - - ' Create a CryptoStream using the FileStream - ' and the passed key and initialization vector (IV). - Dim cStream As New CryptoStream(fStream, _ - New TripleDESCryptoServiceProvider().CreateDecryptor(Key, IV), _ - CryptoStreamMode.Read) - - ' Create a StreamReader using the CryptoStream. - Dim sReader As New StreamReader(cStream) - - ' Read the data from the stream - ' to decrypt it. - Dim val As String = sReader.ReadLine() - - ' Close the streams and - ' close the file. - sReader.Close() - cStream.Close() - fStream.Close() - - ' Return the string. - Return val - Catch e As CryptographicException - Console.WriteLine("A Cryptographic error occurred: {0}", e.Message) - Return Nothing - Catch e As UnauthorizedAccessException - Console.WriteLine("A file error occurred: {0}", e.Message) - Return Nothing - End Try - End Function -End Module - ' \ No newline at end of file diff --git a/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/VB/memoryexample.vb b/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/VB/memoryexample.vb deleted file mode 100644 index 94ea1e8c7e1..00000000000 --- a/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/VB/memoryexample.vb +++ /dev/null @@ -1,94 +0,0 @@ - ' -Imports System.Security.Cryptography -Imports System.Text -Imports System.IO - -Module TrippleDESCSPSample - - Sub Main() - Try - ' Create a new TripleDESCryptoServiceProvider object - ' to generate a key and initialization vector (IV). - Dim tDESalg As New TripleDESCryptoServiceProvider - - ' Create a string to encrypt. - Dim sData As String = "Here is some data to encrypt." - - ' Encrypt the string to an in-memory buffer. - Dim Data As Byte() = EncryptTextToMemory(sData, tDESalg.Key, tDESalg.IV) - - ' Decrypt the buffer back to a string. - Dim Final As String = DecryptTextFromMemory(Data, tDESalg.Key, tDESalg.IV) - - ' Display the decrypted string to the console. - Console.WriteLine(Final) - Catch e As Exception - Console.WriteLine(e.Message) - End Try - End Sub - - - Function EncryptTextToMemory(ByVal Data As String, ByVal Key() As Byte, ByVal IV() As Byte) As Byte() - Try - ' Create a MemoryStream. - Dim mStream As New MemoryStream - - ' Create a CryptoStream using the MemoryStream - ' and the passed key and initialization vector (IV). - Dim cStream As New CryptoStream(mStream, _ - New TripleDESCryptoServiceProvider().CreateEncryptor(Key, IV), _ - CryptoStreamMode.Write) - - ' Convert the passed string to a byte array. - Dim toEncrypt As Byte() = New ASCIIEncoding().GetBytes(Data) - - ' Write the byte array to the crypto stream and flush it. - cStream.Write(toEncrypt, 0, toEncrypt.Length) - cStream.FlushFinalBlock() - - ' Get an array of bytes from the - ' MemoryStream that holds the - ' encrypted data. - Dim ret As Byte() = mStream.ToArray() - - ' Close the streams. - cStream.Close() - mStream.Close() - - ' Return the encrypted buffer. - Return ret - Catch e As CryptographicException - Console.WriteLine("A Cryptographic error occurred: {0}", e.Message) - Return Nothing - End Try - End Function - - - Function DecryptTextFromMemory(ByVal Data() As Byte, ByVal Key() As Byte, ByVal IV() As Byte) As String - Try - ' Create a new MemoryStream using the passed - ' array of encrypted data. - Dim msDecrypt As New MemoryStream(Data) - - ' Create a CryptoStream using the MemoryStream - ' and the passed key and initialization vector (IV). - Dim csDecrypt As New CryptoStream(msDecrypt, _ - New TripleDESCryptoServiceProvider().CreateDecryptor(Key, IV), _ - CryptoStreamMode.Read) - - ' Create buffer to hold the decrypted data. - Dim fromEncrypt(Data.Length - 1) As Byte - - ' Read the decrypted data out of the crypto stream - ' and place it into the temporary buffer. - csDecrypt.Read(fromEncrypt, 0, fromEncrypt.Length) - - 'Convert the buffer into a string and return it. - Return New ASCIIEncoding().GetString(fromEncrypt) - Catch e As CryptographicException - Console.WriteLine("A Cryptographic error occurred: {0}", e.Message) - Return Nothing - End Try - End Function -End Module - ' \ No newline at end of file diff --git a/snippets/visualbasic/VS_Snippets_CLR_Classic/classic TripleDESCryptoServiceProvider Example/VB/source.vb b/snippets/visualbasic/VS_Snippets_CLR_Classic/classic TripleDESCryptoServiceProvider Example/VB/source.vb deleted file mode 100644 index 7023c3dc158..00000000000 --- a/snippets/visualbasic/VS_Snippets_CLR_Classic/classic TripleDESCryptoServiceProvider Example/VB/source.vb +++ /dev/null @@ -1,39 +0,0 @@ -Imports System.IO -Imports System.ComponentModel -Imports System.Security.Cryptography - -Public Class Sample - -' -Private Shared Sub EncryptData(inName As String, outName As String, _ - tdesKey() As Byte, tdesIV() As Byte) - - 'Create the file streams to handle the input and output files. - Dim fin As New FileStream(inName, FileMode.Open, FileAccess.Read) - Dim fout As New FileStream(outName, FileMode.OpenOrCreate, _ - FileAccess.Write) - fout.SetLength(0) - - 'Create variables to help with read and write. - Dim bin(100) As Byte 'This is intermediate storage for the encryption. - Dim rdlen As Long = 0 'This is the total number of bytes written. - Dim totlen As Long = fin.Length 'This is the total length of the input file. - Dim len As Integer 'This is the number of bytes to be written at a time. - Dim tdes As New TripleDESCryptoServiceProvider() - Dim encStream As New CryptoStream(fout, _ - tdes.CreateEncryptor(tdesKey, tdesIV), CryptoStreamMode.Write) - - Console.WriteLine("Encrypting...") - - 'Read from the input file, then encrypt and write to the output file. - While rdlen < totlen - len = fin.Read(bin, 0, 100) - encStream.Write(bin, 0, len) - rdlen = rdlen + len - Console.WriteLine("{0} bytes processed", rdlen) - End While - - encStream.Close() -End Sub -' -End Class diff --git a/xml/System.Security.Cryptography/TripleDES.xml b/xml/System.Security.Cryptography/TripleDES.xml index 75acf1733d6..ae3b04001f5 100644 --- a/xml/System.Security.Cryptography/TripleDES.xml +++ b/xml/System.Security.Cryptography/TripleDES.xml @@ -81,14 +81,17 @@ ## Examples - The following code example method uses with the specified key () and initialization vector () to encrypt a file specified by `inName`. It then outputs the encrypted result to the file specified by `outName`. + The following code example shows how to create and use a object to encrypt and decrypt data in a file. - :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_Classic/classic TripleDESCryptoServiceProvider Example/CPP/source.cpp" id="Snippet1"::: - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/TripleDES/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_Classic/classic TripleDESCryptoServiceProvider Example/VB/source.vb" id="Snippet1"::: + :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/TripleDES/Create/fileexample.cs" id="Snippet1"::: + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.File/VB/fileexample.vb" id="Snippet1"::: - Decryption can be handled in the same way; use instead of . The same key () and initialization vector () used to encrypt the file must be used to decrypt it. + The following code example shows how to create and use a object to encrypt and decrypt data in memory. + :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/TripleDES/Create/memoryexample.cs" id="Snippet1"::: + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.Memory/VB/memoryexample.vb" id="Snippet1"::: + + ]]> @@ -242,7 +245,7 @@ The following code example shows how to create and use a object to encrypt and decrypt data in memory. - :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/Cryptography.3DES.Create.Memory/CPP/memoryexample.cpp" id="Snippet1"::: + :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/TripleDES/Create/memoryexample.cs" id="Snippet1"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DES.Create.Memory/VB/memoryexample.vb" id="Snippet1"::: ]]> diff --git a/xml/System.Security.Cryptography/TripleDESCryptoServiceProvider.xml b/xml/System.Security.Cryptography/TripleDESCryptoServiceProvider.xml index 1e22ba85c31..41c0edcaa4a 100644 --- a/xml/System.Security.Cryptography/TripleDESCryptoServiceProvider.xml +++ b/xml/System.Security.Cryptography/TripleDESCryptoServiceProvider.xml @@ -73,26 +73,11 @@ method instead. + > [!NOTE] > A newer symmetric encryption algorithm, Advanced Encryption Standard (AES), is available. Consider using the class instead of the class. Use only for compatibility with legacy applications and data. - - -## Examples - The following code example creates a object and uses it to encrypt and decrypt data in a file. - - :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/CPP/fileexample.cpp" id="Snippet1"::: - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/fileexample.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/VB/fileexample.vb" id="Snippet1"::: - - The following code example creates a object and uses it to encrypt and decrypt data in memory. - - :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/CPP/memoryexample.cpp" id="Snippet1"::: - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/memoryexample.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/VB/memoryexample.vb" id="Snippet1"::: - ]]> Cryptographic Services @@ -144,18 +129,8 @@ object and uses it to encrypt and decrypt data in a file. - - :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/CPP/fileexample.cpp" id="Snippet1"::: - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/fileexample.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/VB/fileexample.vb" id="Snippet1"::: - - The following code example creates a object and uses it to encrypt and decrypt data in memory. - - :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/CPP/memoryexample.cpp" id="Snippet1"::: - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/memoryexample.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/VB/memoryexample.vb" id="Snippet1"::: +## Remarks +`TripleDESCryptoServiceProvider` is obsolete. Use the method instead. ]]> @@ -315,22 +290,7 @@ overload with the same parameters. - - - -## Examples - The following code example creates a object and uses it to encrypt and decrypt data in a file. - - :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/CPP/fileexample.cpp" id="Snippet1"::: - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/fileexample.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/VB/fileexample.vb" id="Snippet1"::: - - The following code example creates a object and uses it to encrypt and decrypt data in memory. - - :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/CPP/memoryexample.cpp" id="Snippet1"::: - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/memoryexample.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/VB/memoryexample.vb" id="Snippet1"::: + This method decrypts an encrypted message created using the overload with the same parameters. ]]> @@ -471,22 +431,7 @@ overload with the same parameters to decrypt the result of this method. - - - -## Examples - The following code example creates a object and uses it to encrypt and decrypt data in a file. - - :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/CPP/fileexample.cpp" id="Snippet1"::: - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/fileexample.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.File/VB/fileexample.vb" id="Snippet1"::: - - The following code example creates a object and uses it to encrypt and decrypt data in memory. - - :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/CPP/memoryexample.cpp" id="Snippet1"::: - :::code language="csharp" source="~/snippets/csharp/System.Security.Cryptography/TripleDESCryptoServiceProvider/Overview/memoryexample.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Cryptography.3DESCSP.CreateEncryptor.Memory/VB/memoryexample.vb" id="Snippet1"::: + Use the overload with the same parameters to decrypt the result of this method. ]]>