diff --git a/snippets/csharp/System.Data.Linq/TableAttribute/Overview/Program.cs b/snippets/csharp/System.Data.Linq/TableAttribute/Overview/Program.cs new file mode 100644 index 00000000000..cfdf4858bdf --- /dev/null +++ b/snippets/csharp/System.Data.Linq/TableAttribute/Overview/Program.cs @@ -0,0 +1,101 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using System.Text; +using System.Data.Linq; +using System.Data.Linq.Mapping; + +namespace cs_maketables +{ + class Program + { + static void Main(string[] args) + { + } + } + + // + [Table(Name = "Customers")] + public class Customer + { + // ... + } + // + + // + [Table(Name = "Customers")] + public class customer + { + [Column(Name = "CustomerID")] + public string CustomerID; + // ... + } + // +} + +// +[Table(Name = "Customers")] +public partial class Customer +{ + [Column(IsPrimaryKey = true)] + public string CustomerID; + // ... + private EntitySet _Orders; + [Association(Storage = "_Orders", OtherKey = "CustomerID")] + public EntitySet Orders + { + get { return this._Orders; } + set { this._Orders.Assign(value); } + } +} +// + +// +[Table] +[InheritanceMapping(Code = "C", Type = typeof(Car))] +[InheritanceMapping(Code = "T", Type = typeof(Truck))] +[InheritanceMapping(Code = "V", Type = typeof(Vehicle), + IsDefault = true)] +public class Vehicle +{ + [Column(IsDiscriminator = true)] + public string DiscKey; + [Column(IsPrimaryKey = true)] + public string VIN; + [Column] + public string MfgPlant; +} +public class Car : Vehicle +{ + [Column] + public int TrimCode; + [Column] + public string ModelName; +} + +public class Truck : Vehicle +{ + [Column] + public int Tonnage; + [Column] + public int Axles; +} +// + +// +[Table(Name = "Orders")] +public class Order +{ + [Column(IsPrimaryKey = true)] + public int OrderID; + [Column] + public string CustomerID; + private EntityRef _Customer; + [Association(Storage = "_Customer", ThisKey = "CustomerID")] + public Customer Customer + { + get { return this._Customer.Entity; } + set { this._Customer.Entity = value; } + } +} +// diff --git a/snippets/csharp/System.Data.Linq/TableAttribute/Overview/Project.csproj b/snippets/csharp/System.Data.Linq/TableAttribute/Overview/Project.csproj new file mode 100644 index 00000000000..eb2b274fcac --- /dev/null +++ b/snippets/csharp/System.Data.Linq/TableAttribute/Overview/Project.csproj @@ -0,0 +1,12 @@ + + + + Library + net48 + + + + + + + diff --git a/snippets/visualbasic/System.Data.Linq/TableAttribute/Overview/Module1.vb b/snippets/visualbasic/System.Data.Linq/TableAttribute/Overview/Module1.vb new file mode 100644 index 00000000000..03fe361db5b --- /dev/null +++ b/snippets/visualbasic/System.Data.Linq/TableAttribute/Overview/Module1.vb @@ -0,0 +1,104 @@ +Imports System.Data.Linq +Imports System.Data.Linq.Mapping + +Module Module1 + Sub Main() + + End Sub + +End Module + +' + +Public Class Customer + ' ... +End Class +' + +Namespace ns + + ' + + Public Class Customer + + Public CustomerID As String + ' ... + End Class + ' + +End Namespace + +Namespace ns2 + + ' + + Public Class Customer + + Public CustomerID As String + ' ... + Private _orders As EntitySet(Of Order) + + Public Property Orders() As EntitySet(Of Order) + Get + Return _orders + End Get + Set(ByVal value As EntitySet(Of Order)) + _orders.Assign(value) + End Set + End Property + End Class + ' + + ' + + + + + Public Class Vehicle + + Private _discKey As String + + Private _vIN As String + + Private _mfgPlant As String + End Class + + Public Class Car + Inherits Vehicle + + Private _trimCode As Integer + + Private _modelName As String + End Class + + Public Class Truck + Inherits Vehicle + + Private _tonnage As Integer + + Private _axles As Integer + End Class + ' + + ' + + Public Class Order + + Public OrderID As Integer + + Public CustomerID As String + Private _customer As EntityRef(Of Customer) + + Public Property Customer() As Customer + Get + Return _customer.Entity + End Get + Set(ByVal value As Customer) + _customer.Entity = value + End Set + End Property + End Class + ' + +End Namespace diff --git a/snippets/visualbasic/System.Data.Linq/TableAttribute/Overview/Project.vbproj b/snippets/visualbasic/System.Data.Linq/TableAttribute/Overview/Project.vbproj new file mode 100644 index 00000000000..c4963049dfd --- /dev/null +++ b/snippets/visualbasic/System.Data.Linq/TableAttribute/Overview/Project.vbproj @@ -0,0 +1,12 @@ + + + + Exe + net48 + + + + + + + diff --git a/xml/Microsoft.CSharp/CSharpCodeProvider.xml b/xml/Microsoft.CSharp/CSharpCodeProvider.xml index 6adfb45b785..e6210c823f7 100644 --- a/xml/Microsoft.CSharp/CSharpCodeProvider.xml +++ b/xml/Microsoft.CSharp/CSharpCodeProvider.xml @@ -174,7 +174,7 @@ In .NET Framework apps, you can obtain the value for `providerOptions` from the Configuration file schema for the .NET Framework <compilers> Element - Specifying Fully Qualified Type Names + Specifying Fully Qualified Type Names <provideroption> Element diff --git a/xml/Microsoft.CSharp/Compiler.xml b/xml/Microsoft.CSharp/Compiler.xml index 9201f765c4d..60e896f92b5 100644 --- a/xml/Microsoft.CSharp/Compiler.xml +++ b/xml/Microsoft.CSharp/Compiler.xml @@ -79,29 +79,29 @@ For the `options` parameter, the key is the short form of the compiler option. T | Key Name | Usage | | --- | --- | -| `addmodule` | List of modules to include in this assembly. The module names must be separated by the vertical bar or pipe character. Value must be of type . See [-addmodule (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/addmodule-compiler-option). | -| `baseaddress` | Base address for libraries. Value must be of type . See [-baseaddress (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/baseaddress-compiler-option). | -| `bugreport` | Produces bug report file. Value must be of type . See [-bugreport (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/bugreport-compiler-option). | -| `checked` | Set default expression evaluation to checked (or unchecked). Value must be of type . See [-checked (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/checked-compiler-option). | -| `d` | List of semicolon separated symbols to define. Value must be of type . See [-define (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/define-compiler-option). | -| `debug` | Emit debug information with output. Value must be of type . Full or pdb-only cannot be specified. See [-debug (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/debug-compiler-option). | -| `doc` | File name to put XML comments in. Value must be of type . See [-doc (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/doc-compiler-option). | -| `filealign` | PE section alignment size. Value must be of type . See [-filealign (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/filealign-compiler-option). | +| `addmodule` | List of modules to include in this assembly. The module names must be separated by the vertical bar or pipe character. Value must be of type . See [-addmodule (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/inputs). | +| `baseaddress` | Base address for libraries. Value must be of type . See [-baseaddress (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/advanced). | +| `bugreport` | Produces bug report file. Value must be of type . See [-bugreport (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/). | +| `checked` | Set default expression evaluation to checked (or unchecked). Value must be of type . See [-checked (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/language). | +| `d` | List of semicolon separated symbols to define. Value must be of type . See [-define (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/language). | +| `debug` | Emit debug information with output. Value must be of type . Full or pdb-only cannot be specified. See [-debug (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/code-generation). | +| `doc` | File name to put XML comments in. Value must be of type . See [-doc (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/output). | +| `filealign` | PE section alignment size. Value must be of type . See [-filealign (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/advanced). | | `incr` | Enable incremental rebuild. Value must be of type . | -| `lib` | Additional paths to search when locating modules and referenced assemblies. Value must be of type . See [-lib (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/lib-compiler-option). | -| `linkres` | Link a managed resource to the assembly. Value must be of type . See [-linkresource (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/linkresource-compiler-option). | -| `m` | Type to search in for the Main method. Value must be of type . See [-main (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/main-compiler-option). | -| `nostdlib` | Do not auto-reference mscorlib.dll. Value must be of type . See [-nostdlib (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/nostdlib-compiler-option). | -| `nowarn` | List of semicolon separated warning numbers to not report. Value must be of type . See [-nowarn (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/nowarn-compiler-option). | -| `o` | Enable compiler optimizations. Value must be of type . See [-optimize (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/optimize-compiler-option). | -| `r` | Referenced assemblies. Value must be of type String. If more than one assembly is specified, the file name must be separated by the vertical bar or pipe character. See [-reference (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/reference-compiler-option). | -| `res` | Embed a managed resource. Value must be of type . See [-resource (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/resource-compiler-option). | -| `target` | Output file target type, one of the following: "library", "exe", "winexe", or "module". Value must be of type . See [-target (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/target-compiler-option). | -| `unsafe` | Allow unsafe constructs. Value must be of type . See [-unsafe (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/unsafe-compiler-option). | -| `w` | Warning level (0-4). Value must be of type . See [-warn (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/warn-compiler-option). | -| `warnaserror` | Report warning diagnostics as errors. Value must be of type . See [-warnaserror (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/warnaserror-compiler-option). | -| `win32icon` | Win32 icon for auto generated Win32 resource. Value must be of type . See [-win32icon (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/win32icon-compiler-option). | -| `win32res` | Win32 resource file. Value must be of type . See [-win32res (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/win32res-compiler-option). | +| `lib` | Additional paths to search when locating modules and referenced assemblies. Value must be of type . See [-lib (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/advanced). | +| `linkres` | Link a managed resource to the assembly. Value must be of type . See [-linkresource (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/resources). | +| `m` | Type to search in for the Main method. Value must be of type . See [-main (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/advanced). | +| `nostdlib` | Do not auto-reference mscorlib.dll. Value must be of type . See [-nostdlib (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/advanced). | +| `nowarn` | List of semicolon separated warning numbers to not report. Value must be of type . See [-nowarn (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/errors-warnings). | +| `o` | Enable compiler optimizations. Value must be of type . See [-optimize (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/code-generation). | +| `r` | Referenced assemblies. Value must be of type String. If more than one assembly is specified, the file name must be separated by the vertical bar or pipe character. See [-reference (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/inputs). | +| `res` | Embed a managed resource. Value must be of type . See [-resource (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/resources). | +| `target` | Output file target type, one of the following: "library", "exe", "winexe", or "module". Value must be of type . See [-target (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/output). | +| `unsafe` | Allow unsafe constructs. Value must be of type . See [-unsafe (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/language). | +| `w` | Warning level (0-4). Value must be of type . See [-warn (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/errors-warnings). | +| `warnaserror` | Report warning diagnostics as errors. Value must be of type . See [-warnaserror (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/errors-warnings). | +| `win32icon` | Win32 icon for auto generated Win32 resource. Value must be of type . See [-win32icon (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/resources). | +| `win32res` | Win32 resource file. Value must be of type . See [-win32res (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/resources). | ]]> @@ -124,8 +124,8 @@ For the `options` parameter, the key is the short form of the compiler option. T is not the same size as . - #line (C# Reference) - -reference (C# Compiler Options) + #line (C# Reference) + -reference (C# Compiler Options) C# Compiler Options diff --git a/xml/System.AddIn.Contract.Automation/RemoteParameterData.xml b/xml/System.AddIn.Contract.Automation/RemoteParameterData.xml index f4ef29e751a..295045d1f6f 100644 --- a/xml/System.AddIn.Contract.Automation/RemoteParameterData.xml +++ b/xml/System.AddIn.Contract.Automation/RemoteParameterData.xml @@ -128,7 +128,7 @@ The value of this field is always `false` if this describes a parameter of a method provided by a COM object. - Parameters that can have a variable number of arguments are specified by the `params` (for Visual C#) and `ParamArray` (for Visual Basic) keywords. For more information, see [params](/dotnet/csharp/language-reference/keywords/params) and [ParamArray](/dotnet/visual-basic/language-reference/modifiers/paramarray). + Parameters that can have a variable number of arguments are specified by the `params` (for Visual C#) and `ParamArray` (for Visual Basic) keywords. For more information, see [params](/dotnet/csharp/language-reference/keywords/method-parameters) and [ParamArray](/dotnet/visual-basic/language-reference/modifiers/paramarray). ]]> diff --git a/xml/System.CodeDom.Compiler/CodeCompiler.xml b/xml/System.CodeDom.Compiler/CodeCompiler.xml index 5c9ea251248..fae837e63eb 100644 --- a/xml/System.CodeDom.Compiler/CodeCompiler.xml +++ b/xml/System.CodeDom.Compiler/CodeCompiler.xml @@ -44,7 +44,7 @@ is a useful utility base class for code generators to derive from in order to provide code compilation functions. > [!NOTE] -> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. ]]> diff --git a/xml/System.CodeDom.Compiler/CodeDomProvider.xml b/xml/System.CodeDom.Compiler/CodeDomProvider.xml index 749243d1ded..617f2f1f098 100644 --- a/xml/System.CodeDom.Compiler/CodeDomProvider.xml +++ b/xml/System.CodeDom.Compiler/CodeDomProvider.xml @@ -59,7 +59,7 @@ For more details on language provider settings in the configuration file, see [Compiler and Language Provider Settings Schema](/dotnet/framework/configure-apps/file-schema/compiler/). > [!NOTE] -> This class makes a link demand and an inheritance demand at the class level. A is thrown if either the immediate caller or the derived class does not have full trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class makes a link demand and an inheritance demand at the class level. A is thrown if either the immediate caller or the derived class does not have full trust permission. diff --git a/xml/System.CodeDom.Compiler/CodeGenerator.xml b/xml/System.CodeDom.Compiler/CodeGenerator.xml index b70dc2ad7c4..a83b0b1414e 100644 --- a/xml/System.CodeDom.Compiler/CodeGenerator.xml +++ b/xml/System.CodeDom.Compiler/CodeGenerator.xml @@ -44,7 +44,7 @@ This is a useful base class for code generators to derive from. Code generators are capable of rendering source code in a specific language according to the structure of a Code Document Object Model (CodeDOM) graph. This class provides many functions and methods to generate specific types of code from a CodeDOM graph. > [!NOTE] -> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. ]]> diff --git a/xml/System.CodeDom.Compiler/CodeGeneratorOptions.xml b/xml/System.CodeDom.Compiler/CodeGeneratorOptions.xml index 11f8f9133e6..e7fac11673b 100644 --- a/xml/System.CodeDom.Compiler/CodeGeneratorOptions.xml +++ b/xml/System.CodeDom.Compiler/CodeGeneratorOptions.xml @@ -44,7 +44,7 @@ An implementation can provide custom code generation options which you can set or pass data to using the dictionary indexer, which a code generator can search through to locate additional code generation options. > [!NOTE] -> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. diff --git a/xml/System.CodeDom.Compiler/CodeParser.xml b/xml/System.CodeDom.Compiler/CodeParser.xml index e2322973a3c..8d1c4d26cbc 100644 --- a/xml/System.CodeDom.Compiler/CodeParser.xml +++ b/xml/System.CodeDom.Compiler/CodeParser.xml @@ -44,7 +44,7 @@ Developers who build compilers can implement this interface to support code parsing by designers. > [!NOTE] -> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. ]]> diff --git a/xml/System.CodeDom.Compiler/CompilerInfo.xml b/xml/System.CodeDom.Compiler/CompilerInfo.xml index c80eb56978c..a8ba04be442 100644 --- a/xml/System.CodeDom.Compiler/CompilerInfo.xml +++ b/xml/System.CodeDom.Compiler/CompilerInfo.xml @@ -47,9 +47,7 @@ For more details on language provider settings in the configuration file, see [Compiler and Language Provider Settings Schema](/dotnet/framework/configure-apps/file-schema/compiler/). > [!NOTE] -> This class contains a link demand at the class level that applies to all members. A is thrown when the immediate caller does not have full-trust permission. For details about link demands, see [Link Demands](/dotnet/framework/misc/link-demands). - - +> This class contains a link demand at the class level that applies to all members. A is thrown when the immediate caller does not have full-trust permission. ## Examples The following code example displays language provider configuration settings. Command-line arguments are used to specify a language, file name extension, or provider type. For the given input, the example determines the corresponding language provider and displays the configured language compiler settings. diff --git a/xml/System.CodeDom.Compiler/CompilerParameters.xml b/xml/System.CodeDom.Compiler/CompilerParameters.xml index 23ea29f53ca..e75a12a8d70 100644 --- a/xml/System.CodeDom.Compiler/CompilerParameters.xml +++ b/xml/System.CodeDom.Compiler/CompilerParameters.xml @@ -61,7 +61,7 @@ To specify a custom command-line arguments string to use when invoking the compilation process, set the string in the property. If a Win32 security token is required to invoke the compiler process, specify the token in the property. To include .NET Framework resource files in the compiled assembly, add the names of the resource files to the property. To reference .NET Framework resources in another assembly, add the names of the resource files to the property. To include a Win32 resource file in the compiled assembly, specify the name of the Win32 resource file in the property. > [!NOTE] -> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. ## Examples The following example builds a CodeDOM source graph for a simple Hello World program. The source is then saved to a file, compiled into an executable, and run. The `CompileCode` method illustrates how to use the class to specify various compiler settings and options. @@ -903,7 +903,7 @@ An typically includes this string o The temporary files in the collection are retained or deleted upon the completion of compiler activity based on the value of the property in the collection. The property is set if the collection is created using the constructor with the `keepFiles` parameter set to `true`. > [!NOTE] -> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. diff --git a/xml/System.CodeDom.Compiler/Executor.xml b/xml/System.CodeDom.Compiler/Executor.xml index e70e1915d74..5a19cdb0d9c 100644 --- a/xml/System.CodeDom.Compiler/Executor.xml +++ b/xml/System.CodeDom.Compiler/Executor.xml @@ -38,14 +38,14 @@ Provides command execution functions for invoking compilers. This class cannot be inherited. - implementation. - + implementation. + > [!NOTE] -> This class contains a link demand at the class level that applies to all members. A is thrown when the immediate caller does not have full-trust permission. For more information, see [Link Demands](/dotnet/framework/misc/link-demands). - +> This class contains a link demand at the class level that applies to all members. A is thrown when the immediate caller does not have full-trust permission. + ]]> @@ -190,11 +190,11 @@ Executes the specified command using the specified user token and temporary files, and waits for the call to return, storing output and error information from the compiler in the specified strings. The return value from the compiler. - diff --git a/xml/System.CodeDom.Compiler/IndentedTextWriter.xml b/xml/System.CodeDom.Compiler/IndentedTextWriter.xml index c8395689588..74bf268c1a9 100644 --- a/xml/System.CodeDom.Compiler/IndentedTextWriter.xml +++ b/xml/System.CodeDom.Compiler/IndentedTextWriter.xml @@ -83,7 +83,7 @@ The tab string is the string that each indentation consists of. Typically the tab string contains white space. > [!NOTE] -> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. diff --git a/xml/System.CodeDom.Compiler/TempFileCollection.xml b/xml/System.CodeDom.Compiler/TempFileCollection.xml index e4d3f142e42..82cb9861722 100644 --- a/xml/System.CodeDom.Compiler/TempFileCollection.xml +++ b/xml/System.CodeDom.Compiler/TempFileCollection.xml @@ -71,7 +71,7 @@ The property indicates a full path to the base file name, without a file name extension, used to generate the file names returned by the method. > [!NOTE] -> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. diff --git a/xml/System.CodeDom/CodeDefaultValueExpression.xml b/xml/System.CodeDom/CodeDefaultValueExpression.xml index d150282c526..9464f7a4d28 100644 --- a/xml/System.CodeDom/CodeDefaultValueExpression.xml +++ b/xml/System.CodeDom/CodeDefaultValueExpression.xml @@ -53,7 +53,7 @@ ## Remarks A can be used to represent a reference to a default value. - The property specifies the reference to the value type. The class is used in the generation of generics-based code. For more information on generics, see [Generics in the .NET Framework Class Library](/dotnet/csharp/programming-guide/generics/generics-in-the-net-framework-class-library). The following code steps are provided in this section to further describe the use of the class to add a new default value to a code graph. + The property specifies the reference to the value type. The class is used in the generation of generics-based code. For more information on generics, see [Generics in the .NET Framework Class Library](/dotnet/standard/generics/). The following code steps are provided in this section to further describe the use of the class to add a new default value to a code graph. The code in part 1 is part of a larger example provided for the class. This code, when run through the C# code generator, results in the C# code that appears in part 2. When this code is called in the statement in part 3, the result is the output shown in part 4. diff --git a/xml/System.CodeDom/CodeTypeDeclaration.xml b/xml/System.CodeDom/CodeTypeDeclaration.xml index 51df57fbec4..ee8dd24bec2 100644 --- a/xml/System.CodeDom/CodeTypeDeclaration.xml +++ b/xml/System.CodeDom/CodeTypeDeclaration.xml @@ -668,7 +668,7 @@ Implements Interface1 ## Remarks A generic type declaration contains one or more unspecified types known as type parameters. A type parameter name stands for the type within the body of the generic declaration. For example, the generic declaration for the class contains the type parameter `T`. - For more information on generics, see [Generics in the .NET Framework Class Library](/dotnet/csharp/programming-guide/generics/generics-in-the-net-framework-class-library). + For more information on generics, see [Generics in the .NET Framework Class Library](/dotnet/standard/generics/). ]]> diff --git a/xml/System.CodeDom/CodeTypeParameter.xml b/xml/System.CodeDom/CodeTypeParameter.xml index c859f1a33c2..f3e45ef9134 100644 --- a/xml/System.CodeDom/CodeTypeParameter.xml +++ b/xml/System.CodeDom/CodeTypeParameter.xml @@ -55,7 +55,7 @@ A generic type or method declaration contains one or more unspecified types known as type parameters. A type parameter name stands for the type within the body of the generic declaration. For example, the generic declaration for the class contains the type parameter `T`. - For more information on generics, see [Generics in the .NET Framework Class Library](/dotnet/csharp/programming-guide/generics/generics-in-the-net-framework-class-library). + For more information on generics, see [Generics in the .NET Framework Class Library](/dotnet/standard/generics/). diff --git a/xml/System.Collections.Generic/IEnumerable`1.xml b/xml/System.Collections.Generic/IEnumerable`1.xml index cc70cc4f5d4..be1f8709256 100644 --- a/xml/System.Collections.Generic/IEnumerable`1.xml +++ b/xml/System.Collections.Generic/IEnumerable`1.xml @@ -82,7 +82,7 @@ ## Examples - The following example demonstrates how to implement the interface and how to use that implementation to create a LINQ query. When you implement , you must also implement or, for C# only, you can use the [yield](/dotnet/csharp/language-reference/keywords/yield) keyword. Implementing also requires to be implemented, which you will see in this example. + The following example demonstrates how to implement the interface and how to use that implementation to create a LINQ query. When you implement , you must also implement or, for C# only, you can use the [yield](/dotnet/csharp/language-reference/statements/yield) keyword. Implementing also requires to be implemented, which you will see in this example. :::code language="csharp" source="~/snippets/csharp/System.Collections.Generic/IEnumerableT/Overview/program.cs" id="Snippet1"::: :::code language="vb" source="~/snippets/visualbasic/System.Collections.Generic/IEnumerableT/Overview/module1.vb" id="Snippet1"::: @@ -163,7 +163,7 @@ Default implementations of collections in the namespace aren't synchronized. ## Examples - The following example demonstrates how to implement the interface and uses that implementation to create a LINQ query. When you implement , you must also implement or, for C# only, you can use the [yield](/dotnet/csharp/language-reference/keywords/yield) keyword. Implementing also requires to be implemented, which you will see in this example. + The following example demonstrates how to implement the interface and uses that implementation to create a LINQ query. When you implement , you must also implement or, for C# only, you can use the [yield](/dotnet/csharp/language-reference/statements/yield) keyword. Implementing also requires to be implemented, which you will see in this example. :::code language="csharp" source="~/snippets/csharp/System.Collections.Generic/IEnumerableT/Overview/program.cs" id="Snippet1"::: :::code language="vb" source="~/snippets/visualbasic/System.Collections.Generic/IEnumerableT/Overview/module1.vb" id="Snippet1"::: diff --git a/xml/System.Collections.Generic/List`1.xml b/xml/System.Collections.Generic/List`1.xml index f50bb56302c..a34a0d4dd7c 100644 --- a/xml/System.Collections.Generic/List`1.xml +++ b/xml/System.Collections.Generic/List`1.xml @@ -2484,7 +2484,7 @@ Public Function StartsWith(e As Employee) As Boolean The following example demonstrates the use of the delegate to print the contents of a object. In this example the `Print` method is used to display the contents of the list to the console. > [!NOTE] -> In addition to displaying the contents using the `Print` method, the C# example demonstrates the use of [anonymous methods](/dotnet/csharp/programming-guide/statements-expressions-operators/anonymous-methods) to display the results to the console. +> In addition to displaying the contents using the `Print` method, the C# example demonstrates the use of [anonymous methods](/dotnet/csharp/language-reference/operators/delegate-operator) to display the results to the console. :::code language="csharp" source="~/snippets/csharp/System/ActionT/Overview/action.cs" interactive="try-dotnet-method" id="Snippet01"::: :::code language="vb" source="~/snippets/visualbasic/System/ActionT/Overview/action.vb" id="Snippet01"::: diff --git a/xml/System.Collections.Specialized/INotifyCollectionChanged.xml b/xml/System.Collections.Specialized/INotifyCollectionChanged.xml index a8761012d66..df935e65fc3 100644 --- a/xml/System.Collections.Specialized/INotifyCollectionChanged.xml +++ b/xml/System.Collections.Specialized/INotifyCollectionChanged.xml @@ -84,7 +84,6 @@ ]]> - ObservableCollection Simply Explained diff --git a/xml/System.Collections/DictionaryBase.xml b/xml/System.Collections/DictionaryBase.xml index 93e2a8095ff..3df32cf7cb1 100644 --- a/xml/System.Collections/DictionaryBase.xml +++ b/xml/System.Collections/DictionaryBase.xml @@ -81,7 +81,7 @@ > [!IMPORTANT] > We don't recommend that you use the `DictionaryBase` class for new development. Instead, we recommend that you use the generic or class . For more information, see [Non-generic collections shouldn't be used](https://github.com/dotnet/platform-compat/blob/master/docs/DE0006.md) on GitHub. -The C# [foreach](/dotnet/csharp/language-reference/keywords/foreach-in) statement and the Visual Basic [For Each](/dotnet/visual-basic/language-reference/statements/for-each-next-statement) statement return an object of the type of the elements in the collection. Since each element of the is a key/value pair, the element type is not the type of the key or the type of the value. Instead, the element type is . +The C# [foreach](/dotnet/csharp/language-reference/statements/iteration-statements) statement and the Visual Basic [For Each](/dotnet/visual-basic/language-reference/statements/for-each-next-statement) statement return an object of the type of the elements in the collection. Since each element of the is a key/value pair, the element type is not the type of the key or the type of the value. Instead, the element type is . The `foreach` statement is a wrapper around the enumerator, which only allows reading from, not writing to, the collection. diff --git a/xml/System.Collections/DictionaryEntry.xml b/xml/System.Collections/DictionaryEntry.xml index 5d4189665b9..7432724a7ae 100644 --- a/xml/System.Collections/DictionaryEntry.xml +++ b/xml/System.Collections/DictionaryEntry.xml @@ -74,7 +74,7 @@ The [!IMPORTANT] > We don't recommend that you use the `DictionaryEntry` structure for new development. Instead, we recommend that you use a generic structure along with the class. For more information, see [Non-generic collections shouldn't be used](https://github.com/dotnet/platform-compat/blob/master/docs/DE0006.md) on GitHub. - The C# [foreach](/dotnet/csharp/language-reference/keywords/foreach-in) statement and the Visual Basic [For Each](/dotnet/visual-basic/language-reference/statements/for-each-next-statement) statement require the type of each element in the collection. Since each element of the is a key/value pair, the element type is not the type of the key or the type of the value. Instead, the element type is . For example: + The C# [foreach](/dotnet/csharp/language-reference/statements/iteration-statements) statement and the Visual Basic [For Each](/dotnet/visual-basic/language-reference/statements/for-each-next-statement) statement require the type of each element in the collection. Since each element of the is a key/value pair, the element type is not the type of the key or the type of the value. Instead, the element type is . For example: :::code language="csharp" source="~/snippets/csharp/System.Collections/DictionaryEntry/Overview/DictionaryEntrySample.cs" id="Snippet01"::: :::code language="vb" source="~/snippets/visualbasic/System.Collections/DictionaryEntry/Overview/DictionaryEntrySample.vb" id="Snippet01"::: diff --git a/xml/System.Data.Linq.Mapping/TableAttribute.xml b/xml/System.Data.Linq.Mapping/TableAttribute.xml index a48fa4fb38b..5b05a5cfa4a 100644 --- a/xml/System.Data.Linq.Mapping/TableAttribute.xml +++ b/xml/System.Data.Linq.Mapping/TableAttribute.xml @@ -22,7 +22,36 @@ Designates a class as an entity class that is associated with a database table. - For more information about this API, see Supplemental API remarks for TableAttribute. + + attribute to designate a class as an entity class that is associated with a database table or view. LINQ to SQL treats classes that have the attribute as persistent classes. + +LINQ to SQL supports only single-table mapping. That is, an entity class must be mapped to exactly one database table, and you cannot map a database table to multiple classes at the same time. + +You can use the property of the attribute to specify a name for the table, and you can optionally use the schema name to qualify a table name. If you do not specify a name by using the property, the table name is assumed to be the same as the class name. + +## Schema-qualified names + +You can optionally use the schema name to qualify a table name. By default, the token to the left of the first period in the string is considered to be the schema name. The remainder of the name is considered to be the table name. The provider quotes the table name as appropriate. For example, the LINQ to SQL provider for SQL Server makes sure that brackets are used at least where they are needed. + +> [!NOTE] +> In some cases, you must explicitly quote attributes because the SQL Server provider cannot auto-quote. The following table shows some examples. + +| Case | Example: Identifier name | Example: Expected string in attributes | Otherwise… | +|------|--------------------------|----------------------------------------|------------| +|Schema name contains a period|Schema: "A.B"

Table: "C"|"[A.B].C"|The first period is assumed to separate the schema name from the table name.| +|Schema/table name starts with `@`|"@SomeName"|"[@SomeName]"|Assumed to be a parameter name.| +|Schema starts with `[` and ends with `]`|"[Schema.Table]"|"[[Schema].[Table]]]"|The unquoted identifier resembles a quoted identifier.| +|Table starts with `[` and ends with `]`|"[Table]"|"[[Table]]]"|The unquoted identifier resembles a quoted identifier.| + +## Examples + +:::code language="csharp" source="~/snippets/csharp/System.Data.Linq.Mapping/TableAttribute/Overview/Program.cs" id="Snippet1"::: +:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Data/DLinqCustomize/vb/Module1.vb" id="Snippet1"::: + +]]> + diff --git a/xml/System.Data.Linq/DataLoadOptions.xml b/xml/System.Data.Linq/DataLoadOptions.xml index 4866d13ff27..45542e3525b 100644 --- a/xml/System.Data.Linq/DataLoadOptions.xml +++ b/xml/System.Data.Linq/DataLoadOptions.xml @@ -16,7 +16,68 @@ Provides for immediate loading and filtering of related data. - For more information about this API, see Supplemental API remarks for DataLoadOptions. + + class provides for immediate loading and filtering of related data. + +When you query for an object, you actually retrieve only the object you requested. The *related* objects are not automatically fetched at the same time. For more information, see [Querying Across Relationships](/dotnet/framework/data/adonet/sql/linq/querying-across-relationships). + +The class provides two methods to achieve immediate loading of specified related data. The method allows for immediate loading of data related to the main target. The method allows for filtering related objects. + +## Rules + +Consider the following rules regarding usage: + +- Assigning a to a after the first query has been executed generates an exception. +- Modifying a after it has been assigned to a generates an exception. + +## Handle cycles + + and directives must not create cycles. The following represent examples of such graphs: + +- Example 1: Self recursive + + - `dlo.LoadWith(e => e.Reports);` + +- Example 2: Back-pointers + + - `dlo.LoadWith (c => C.Orders);` + - `dlo.LoadWith (o => o.Customer);` + +- Example 3: Longer cycles + + Although this should not occur in a well-normalized model, it is possible. + + - `dlo.LoadWith (a => a.Bs);` + - `dlo.LoadWith (b => b.Cs);` + - `dlo.LoadWith (c => c.As);` + +- Example 4: Self recursive subQueries + + - `dlo.AssociateWith(a=>a.As.Where(a=>a.Id=33));` + +- Example 5: Longer recursive subqueries + + - `dlo.AssociateWith(a=>a.Bs.Where(b=>b.Id==3));` + - `dlo.AssociateWith(b=>b.As.Where(a=>a.Id==3));` + +The following general rules help you understand what occurs in these scenarios: + +- : Each call to checks whether cycles have been introduced into the graph. If there are, as in Examples 1, 2, and 3, an exception is thrown. + +- : At run time, the engine doesn't apply the existing SubQuery clauses to the relationship inside the expression. + + - In Example 4, the `Where` clause is executed against all `A`, not just the ones sub-filtered by the SubQuery expression itself (because that would be recursive). + - In Example 5, the first `Where` clause is applied to all the `B`s, even though there are subqueries on `B`. The second `Where` clause is applied to all the `A`s even though there are subqueries on `A`. + +## Examples + +When you retrieve `Customers` from the Northwind sample database, you can use to specify that `Orders` is also to be retrieved. You can even specify which subset of `Orders` to retrieve. + +]]> + + diff --git a/xml/System.Data/EnumerableRowCollectionExtensions.xml b/xml/System.Data/EnumerableRowCollectionExtensions.xml index 895be9fea2e..b4d38eb5831 100644 --- a/xml/System.Data/EnumerableRowCollectionExtensions.xml +++ b/xml/System.Data/EnumerableRowCollectionExtensions.xml @@ -69,7 +69,7 @@ - Standard Query Operators Overview (C#) + Standard Query Operators Overview (C#) Standard Query Operators Overview (Visual Basic) diff --git a/xml/System.Data/TypedTableBaseExtensions.xml b/xml/System.Data/TypedTableBaseExtensions.xml index fd9c9c3efc4..323583f325f 100644 --- a/xml/System.Data/TypedTableBaseExtensions.xml +++ b/xml/System.Data/TypedTableBaseExtensions.xml @@ -67,7 +67,7 @@ ]]> Standard Query Operators Overview (Visual Basic) - Standard Query Operators Overview (C#) + Standard Query Operators Overview (C#) Querying Typed DataSets diff --git a/xml/System.Diagnostics.CodeAnalysis/ExperimentalAttribute.xml b/xml/System.Diagnostics.CodeAnalysis/ExperimentalAttribute.xml index 9e1bcf0f5cf..23f56944ed7 100644 --- a/xml/System.Diagnostics.CodeAnalysis/ExperimentalAttribute.xml +++ b/xml/System.Diagnostics.CodeAnalysis/ExperimentalAttribute.xml @@ -32,7 +32,7 @@ allows call sites to be flagged with a diagnostic that indicates that an experimental feature is used. You can use this attribute to ship preview features in otherwise stable libraries. -For more information about marking APIs as preview, see [Preview APIs](/dotnet/fundamentals/apicompat/preview-apis). +For more information about marking APIs as preview, see [Preview APIs](/dotnet/fundamentals/runtime-libraries/preview-apis). ]]> diff --git a/xml/System.Diagnostics.Tracing/EventSource.xml b/xml/System.Diagnostics.Tracing/EventSource.xml index a63cab5cb99..e8ebb7ea5cc 100644 --- a/xml/System.Diagnostics.Tracing/EventSource.xml +++ b/xml/System.Diagnostics.Tracing/EventSource.xml @@ -3829,7 +3829,7 @@ public void LogTime(string tag, int hour, int minute, int second) You could do this without calling , but it would be slower than it needs to be. That is because it uses arrays and reflection to figure out what to do. If you log these at a high rate (> 1000 / sec), it can be worth making a fast helper, as shown in the following example. The method shadows the existing . Thus the original caller code (LogTime) does not actually change, but the C# compiler will use the more specialized version which will be faster. - To compile unsafe code, you must specify the [/unsafe (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/unsafe-compiler-option) compiler option. + To compile unsafe code, you must specify the [/unsafe (C# Compiler Options)](/dotnet/csharp/language-reference/compiler-options/language) compiler option. ```csharp class AnotherEventSource : EventSource { diff --git a/xml/System.Diagnostics/Debug.xml b/xml/System.Diagnostics/Debug.xml index 143ed8bbbf5..28a6255d4d2 100644 --- a/xml/System.Diagnostics/Debug.xml +++ b/xml/System.Diagnostics/Debug.xml @@ -3009,7 +3009,7 @@ The following example creates a named `gen ## Remarks This method uses the [.NET composite formatting feature](/dotnet/standard/base-types/composite-formatting) to convert the value of an object to its text representation and embed that representation in a string. - The [params](/dotnet/csharp/language-reference/keywords/params) (in C#) or [ParamArray](/dotnet/visual-basic/language-reference/modifiers/paramarray) (in Visual Basic) keyword in the syntax for this method implies that the object array can be a single value. The exception to this is the object. Explicit overloads take precedence, so an `arg` value of a single string will default to the overload. + The [params](/dotnet/csharp/language-reference/keywords/method-parameters) (in C#) or [ParamArray](/dotnet/visual-basic/language-reference/modifiers/paramarray) (in Visual Basic) keyword in the syntax for this method implies that the object array can be a single value. The exception to this is the object. Explicit overloads take precedence, so an `arg` value of a single string will default to the overload. By default, the output is written to an instance of . diff --git a/xml/System.Diagnostics/FileVersionInfo.xml b/xml/System.Diagnostics/FileVersionInfo.xml index 53983f8dc4b..9328d5160c3 100644 --- a/xml/System.Diagnostics/FileVersionInfo.xml +++ b/xml/System.Diagnostics/FileVersionInfo.xml @@ -73,9 +73,7 @@ Version resources are typically specified in a Win32 resource file, or in assembly attributes. For example the property reflects the `VS_FF_DEBUG` flag value in the file's `VS_FIXEDFILEINFO` block, which is built from the `VERSIONINFO` resource in a Win32 resource file. For more information about specifying version resources in a Win32 resource file, see "About Resource Files" and "VERSIONINFO Resource" in the Platform SDK. For more information about specifying version resources in a .NET module, see the [Setting Assembly Attributes](/dotnet/standard/assembly/set-attributes) topic. > [!NOTE] -> This class makes a link demand at the class level that applies to all members. A is thrown when the immediate caller does not have full trust permission. For details about link demands, see [Link Demands](/dotnet/framework/misc/link-demands). - - +> This class makes a link demand at the class level that applies to all members. A is thrown when the immediate caller does not have full trust permission. ## Examples The following example calls to get the for the Notepad. Then it prints the file description and version number to the console. diff --git a/xml/System.Diagnostics/Process.xml b/xml/System.Diagnostics/Process.xml index 7ed68012238..1bb82066d1a 100644 --- a/xml/System.Diagnostics/Process.xml +++ b/xml/System.Diagnostics/Process.xml @@ -114,27 +114,24 @@ On macOS, the following properties return 0: - - - - - - +- +- +- > [!NOTE] -> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class contains a link demand and an inheritance demand at the class level that applies to all members. A is thrown when either the immediate caller or the derived class does not have full-trust permission. - ## .NET Core Notes - In .NET Framework, the class by default uses encodings, which are typically code page encodings, for the input, output, and error streams. For example code, on systems whose culture is English (United States), code page 437 is the default encoding for the class. However, .NET Core may make only a limited subset of these encodings available. If this is the case, it uses as the default encoding. + In .NET Framework, the class by default uses encodings, which are typically code-page encodings, for the input, output, and error streams. For example code, on systems whose culture is English (United States), code page 437 is the default encoding for the class. However, .NET Core may make only a limited subset of these encodings available. If this is the case, it uses as the default encoding. If a object depends on specific code page encodings, you can still make them available by doing the following *before* you call any methods: -1. Retrieve the object from the property. +1. Retrieve the object from the property. -2. Pass the object to the method to make the additional encodings supported by the encoding provider available. +2. Pass the object to the method to make the additional encodings supported by the encoding provider available. The class will then automatically use the default system encoding rather than UTF8, provided that you have registered the encoding provider before calling any methods. - - ## Examples The following example uses an instance of the class to start a process. @@ -148,7 +145,7 @@ On macOS, the following properties return 0: :::code language="fsharp" source="~/snippets/fsharp/System.Diagnostics/Process/Overview/processstartstatic.fs"::: :::code language="vb" source="~/snippets/visualbasic/System.Diagnostics/Process/Overview/processstartstatic.vb"::: - The following F# example defines a `runProc` function that starts a process, captures all output and error information, and records the number of milliseconds that the process has run. The `runProc` function has three parameters: the name of application to launch, the arguments to supply to the application, and the starting directory. + The following F# example defines a `runProc` function that starts a process, captures all output and error information, and records the number of milliseconds that the process has run. The `runProc` function has three parameters: the name of application to launch, the arguments to supply to the application, and the starting directory. :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.diagnostics.process/fs/Start1.fs" id="Snippet1"::: @@ -364,15 +361,15 @@ On macOS, the following properties return 0: Follow these steps to perform asynchronous read operations on for a : -1. Set to `false`. +1. Set to `false`. -2. Set to `true`. +2. Set to `true`. -3. Add your event handler to the event. The event handler must match the delegate signature. +3. Add your event handler to the event. The event handler must match the delegate signature. -4. Start the . +4. Start the . -5. Call for the . This call starts asynchronous read operations on . +5. Call for the . This call starts asynchronous read operations on . When asynchronous read operations start, the event handler is called each time the associated writes a line of text to its stream. @@ -463,15 +460,15 @@ On macOS, the following properties return 0: Follow these steps to perform asynchronous read operations on for a : -1. Set to `false`. +1. Set to `false`. -2. Set to `true`. +2. Set to `true`. -3. Add your event handler to the event. The event handler must match the delegate signature. +3. Add your event handler to the event. The event handler must match the delegate signature. -4. Start the . +4. Start the . -5. Call for the . This call starts asynchronous read operations on . +5. Call for the . This call starts asynchronous read operations on . When asynchronous read operations start, the event handler is called each time the associated writes a line of text to its stream. @@ -3200,12 +3197,12 @@ If no main module is found, it could be because the process hasn't finished load [<System.Obsolete("Process.NonpagedSystemMemorySize has been deprecated because the type of the property can't represent all valid results. Use System.Diagnostics.Process.NonpagedSystemMemorySize64 instead.")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.NonpagedSystemMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.NonpagedSystemMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.NonpagedSystemMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.NonpagedSystemMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.NonpagedSystemMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.NonpagedSystemMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.NonpagedSystemMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.NonpagedSystemMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] [System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)] @@ -3494,12 +3491,12 @@ If no main module is found, it could be because the process hasn't finished load [<System.Obsolete("Process.PagedMemorySize has been deprecated because the type of the property can't represent all valid results. Use System.Diagnostics.Process.PagedMemorySize64 instead.")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] [System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)] @@ -3637,12 +3634,12 @@ If no main module is found, it could be because the process hasn't finished load [<System.Obsolete("Process.PagedSystemMemorySize has been deprecated because the type of the property can't represent all valid results. Use System.Diagnostics.Process.PagedSystemMemorySize64 instead.")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedSystemMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedSystemMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedSystemMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedSystemMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedSystemMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedSystemMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedSystemMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PagedSystemMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] [System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)] @@ -3778,12 +3775,12 @@ If no main module is found, it could be because the process hasn't finished load [<System.Obsolete("Process.PeakPagedMemorySize has been deprecated because the type of the property can't represent all valid results. Use System.Diagnostics.Process.PeakPagedMemorySize64 instead.")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakPagedMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakPagedMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakPagedMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakPagedMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakPagedMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakPagedMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakPagedMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakPagedMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] [System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)] @@ -3918,12 +3915,12 @@ If no main module is found, it could be because the process hasn't finished load [<System.Obsolete("Process.PeakVirtualMemorySize has been deprecated because the type of the property can't represent all valid results. Use System.Diagnostics.Process.PeakVirtualMemorySize64 instead.")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakVirtualMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakVirtualMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakVirtualMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakVirtualMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakVirtualMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakVirtualMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakVirtualMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakVirtualMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] [System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)] @@ -4058,12 +4055,12 @@ If no main module is found, it could be because the process hasn't finished load [<System.Obsolete("Process.PeakWorkingSet has been deprecated because the type of the property can't represent all valid results. Use System.Diagnostics.Process.PeakWorkingSet64 instead.")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakWorkingSet64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakWorkingSet64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakWorkingSet64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakWorkingSet64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakWorkingSet64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakWorkingSet64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakWorkingSet64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PeakWorkingSet64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] [System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)] @@ -4378,12 +4375,12 @@ If no main module is found, it could be because the process hasn't finished load [<System.Obsolete("Process.PrivateMemorySize has been deprecated because the type of the property can't represent all valid results. Use System.Diagnostics.Process.PrivateMemorySize64 instead.")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PrivateMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PrivateMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PrivateMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PrivateMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PrivateMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PrivateMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PrivateMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.PrivateMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] [System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)] @@ -5377,7 +5374,7 @@ There is a similar issue when you read all text from both the standard output an If you have a path variable declared in your system using quotes, you must fully qualify that path when starting any process found in that location. Otherwise, the system will not find the path. For example, if `c:\mypath` is not in your path, and you add it using quotation marks: `path = %path%;"c:\mypath"`, you must fully qualify any process in `c:\mypath` when starting it. > [!NOTE] -> ASP.NET Web page and server control code executes in the context of the ASP.NET worker process on the Web server. If you use the method in an ASP.NET Web page or server control, the new process executes on the Web server with restricted permissions. The process does not start in the same context as the client browser, and does not have access to the user desktop. +> ASP.NET Web page and server control code executes in the context of the ASP.NET worker process on the Web server. If you use the method in an ASP.NET Web page or server control, the new process executes on the Web server with restricted permissions. The process does not start in the same context as the client browser, and does not have access to the user desktop. Whenever you use to start a process, you might need to close it or you risk losing system resources. Close processes using or . You can check whether a process has already been closed by using its property. @@ -5498,7 +5495,7 @@ The member If you have a path variable declared in your system using quotes, you must fully qualify that path when starting any process found in that location. Otherwise, the system will not find the path. For example, if `c:\mypath` is not in your path, and you add it using quotation marks: `path = %path%;"c:\mypath"`, you must fully qualify any process in `c:\mypath` when starting it. > [!NOTE] -> ASP.NET Web page and server control code executes in the context of the ASP.NET worker process on the Web server. If you use the method in an ASP.NET Web page or server control, the new process executes on the Web server with restricted permissions. The process does not start in the same context as the client browser, and does not have access to the user desktop. +> ASP.NET Web page and server control code executes in the context of the ASP.NET worker process on the Web server. If you use the method in an ASP.NET Web page or server control, the new process executes on the Web server with restricted permissions. The process does not start in the same context as the client browser, and does not have access to the user desktop. Whenever you use to start a process, you might need to close it or you risk losing system resources. Close processes using or . You can check whether a process has already been closed by using its property. @@ -5627,7 +5624,7 @@ The member If you have a path variable declared in your system using quotes, you must fully qualify that path when starting any process found in that location. Otherwise, the system will not find the path. For example, if `c:\mypath` is not in your path, and you add it using quotation marks: `path = %path%;"c:\mypath"`, you must fully qualify any process in `c:\mypath` when starting it. > [!NOTE] -> ASP.NET Web page and server control code executes in the context of the ASP.NET worker process on the Web server. If you use the method in an ASP.NET Web page or server control, the new process executes on the Web server with restricted permissions. The process does not start in the same context as the client browser, and does not have access to the user desktop. +> ASP.NET Web page and server control code executes in the context of the ASP.NET worker process on the Web server. If you use the method in an ASP.NET Web page or server control, the new process executes on the Web server with restricted permissions. The process does not start in the same context as the client browser, and does not have access to the user desktop. Whenever you use to start a process, you might need to close it or you risk losing system resources. Close processes using or . You can check whether a process has already been closed by using its property. @@ -5804,7 +5801,7 @@ The file specified in the could not be found. [!NOTE] -> ASP.NET Web page and server control code executes in the context of the ASP.NET worker process on the Web server. If you use the method in an ASP.NET Web page or server control, the new process executes on the Web server with restricted permissions. The process does not start in the same context as the client browser, and does not have access to the user desktop. +> ASP.NET Web page and server control code executes in the context of the ASP.NET worker process on the Web server. If you use the method in an ASP.NET Web page or server control, the new process executes on the Web server with restricted permissions. The process does not start in the same context as the client browser, and does not have access to the user desktop. Whenever you use to start a process, you might need to close it or you risk losing system resources. Close processes using or . You can check whether a process has already been closed by using its property. @@ -6627,12 +6624,12 @@ The file specified in the could not be found. [<System.Obsolete("Process.VirtualMemorySize has been deprecated because the type of the property can't represent all valid results. Use System.Diagnostics.Process.VirtualMemorySize64 instead.")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.VirtualMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.VirtualMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.VirtualMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.VirtualMemorySize64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.VirtualMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.VirtualMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.VirtualMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.VirtualMemorySize64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] [System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)] @@ -6787,7 +6784,7 @@ The file specified in the could not be found. makes the current thread wait until the associated process terminates. It should be called after all other methods are called on the process. To avoid blocking the current thread, use the event. + makes the current thread wait until the associated process terminates. It should be called after all other methods are called on the process. To avoid blocking the current thread, use the event. This method instructs the component to wait an infinite amount of time for the process and event handlers to exit. This can cause an application to stop responding. For example, if you call for a process that has a user interface, the request to the operating system to terminate the associated process might not be handled if the process is written to never enter its message loop. @@ -7255,12 +7252,12 @@ No process is associated with this o [<System.Obsolete("Process.WorkingSet has been deprecated because the type of the property can't represent all valid results. Use System.Diagnostics.Process.WorkingSet64 instead.")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.WorkingSet64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.WorkingSet64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.WorkingSet64 instead. https://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.WorkingSet64 instead. https://go.microsoft.com/fwlink/?linkid=14202")>] - [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.WorkingSet64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] - [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.WorkingSet64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] + [System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.WorkingSet64 instead. http://go.microsoft.com/fwlink/?linkid=14202")] + [<System.Obsolete("This property has been deprecated. Please use System.Diagnostics.Process.WorkingSet64 instead. http://go.microsoft.com/fwlink/?linkid=14202")>] [System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Hidden)] diff --git a/xml/System.Diagnostics/ProcessStartInfo.xml b/xml/System.Diagnostics/ProcessStartInfo.xml index 496a35be857..ccad2fb0b56 100644 --- a/xml/System.Diagnostics/ProcessStartInfo.xml +++ b/xml/System.Diagnostics/ProcessStartInfo.xml @@ -75,7 +75,7 @@ [!INCLUDE [untrusted-data-instance-note](~/includes/untrusted-data-instance-note.md)] > [!NOTE] -> This class contains a link demand at the class level that applies to all members. A is thrown when the immediate caller does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class contains a link demand at the class level that applies to all members. A is thrown when the immediate caller does not have full-trust permission. ## Examples The following code example demonstrates how to use the class to start Internet Explorer. The destination URLs are provided as arguments. diff --git a/xml/System.Dynamic/DynamicObject.xml b/xml/System.Dynamic/DynamicObject.xml index 70a3774b1fd..4bab308c7cc 100644 --- a/xml/System.Dynamic/DynamicObject.xml +++ b/xml/System.Dynamic/DynamicObject.xml @@ -87,7 +87,7 @@ You cannot directly create an instance of the `DynamicObject` class. To implement the dynamic behavior, you may want to inherit from the `DynamicObject` class and override necessary methods. For example, if you need only operations for setting and getting properties, you can override just the and methods. - In C#, to enable dynamic behavior for instances of classes derived from the `DynamicObject` class, you must use the `dynamic` keyword. For more information, see [Using Type dynamic](/dotnet/csharp/programming-guide/types/using-type-dynamic). + In C#, to enable dynamic behavior for instances of classes derived from the `DynamicObject` class, you must use the `dynamic` keyword. For more information, see [Using Type dynamic](/dotnet/csharp/advanced-topics/interop/using-type-dynamic). In Visual Basic, dynamic operations are supported by late binding. For more information, see [Early and Late Binding (Visual Basic)](/dotnet/visual-basic/programming-guide/language-features/early-late-binding/). @@ -181,7 +181,7 @@ Dim sampleObject As Object = New SampleDynamicObject() ## Remarks You cannot directly create an instance of the class. To implement dynamic behavior, you have to inherit from the class and override necessary methods. - In C#, to enable dynamic behavior for instances of the classes derived from the class, you must use the `dynamic` keyword. For more information, see [Using Type dynamic](/dotnet/csharp/programming-guide/types/using-type-dynamic). + In C#, to enable dynamic behavior for instances of the classes derived from the class, you must use the `dynamic` keyword. For more information, see [Using Type dynamic](/dotnet/csharp/advanced-topics/interop/using-type-dynamic). In Visual Basic, dynamic operations are supported by late binding. For more information, see [Early and Late Binding (Visual Basic)](/dotnet/visual-basic/programming-guide/language-features/early-late-binding/). diff --git a/xml/System.IO/File.xml b/xml/System.IO/File.xml index cae86bb21c0..e7b38a92141 100644 --- a/xml/System.IO/File.xml +++ b/xml/System.IO/File.xml @@ -524,7 +524,7 @@ You can use this method to create a file that contains the following: -- The results of a [LINQ to Objects](/dotnet/csharp/programming-guide/concepts/linq/linq-to-objects) query on the lines of a file, as obtained by using the method. +- The results of a [LINQ to Objects](/dotnet/csharp/linq/get-started/introduction-to-linq-queries) query on the lines of a file, as obtained by using the method. - The contents of a collection that implements an of strings. @@ -4846,6 +4846,8 @@ The following example moves a file. ## Remarks This method opens a file, reads each line of the file, then adds each line as an element of a string array. It then closes the file. A line is defined as a sequence of characters followed by a carriage return ('\r'), a line feed ('\n'), or a carriage return immediately followed by a line feed. The resulting string does not contain the terminating carriage return and/or line feed. + If the file ends with a newline sequence, no additional empty line is appended to the array. For example, a file containing `"line1\nline2\n"` produces the same two-element array (`["line1", "line2"]`) as a file containing `"line1\nline2"`. + This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected. @@ -4945,6 +4947,8 @@ The following example moves a file. ## Remarks This method opens a file, reads each line of the file, and then adds each line as an element of a string array. It then closes the file. A line is defined as a sequence of characters followed by a carriage return ('\r'), a line feed ('\n'), or a carriage return immediately followed by a line feed. The resulting string does not contain the terminating carriage return and/or line feed. + If the file ends with a newline sequence, no additional empty line is appended to the array. For example, a file containing `"line1\nline2\n"` produces the same two-element array (`["line1", "line2"]`) as a file containing `"line1\nline2"`. + This method attempts to automatically detect the encoding of a file based on the presence of byte order marks. Encoding formats UTF-8 and UTF-32 (both big-endian and little-endian) can be detected. @@ -5454,14 +5458,17 @@ The and met You can use the method to do the following: -- Perform [LINQ to Objects](/dotnet/csharp/programming-guide/concepts/linq/linq-to-objects) queries on a file to obtain a filtered set of its lines. +- Perform [LINQ to Objects](/dotnet/csharp/linq/get-started/introduction-to-linq-queries) queries on a file to obtain a filtered set of its lines. - Write the returned collection of lines to a file with the method, or append them to an existing file with the method. - Create an immediately populated instance of a collection that takes an collection of strings for its constructor, such as a or a . This method uses for the encoding value. +A line is defined as a sequence of characters followed by a carriage return ('\r'), a line feed ('\n'), or a carriage return immediately followed by a line feed, or as the final sequence of characters in the file or stream if it ends without a newline sequence. If the file ends with a newline sequence, no additional empty line is returned. For example, a file containing `"line1\nline2\n"` produces the same two lines (`"line1"` and `"line2"`) as a file containing `"line1\nline2"`. + ## Examples - The following example reads the lines of a file to find lines that contain specified strings. + +The following example reads the lines of a file to find lines that contain specified strings. :::code language="csharp" source="~/snippets/csharp/System.IO/File/ReadLines/program.cs" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System.IO/File/ReadLines/program.fs" id="Snippet1"::: @@ -5564,10 +5571,12 @@ The and met You can use the method to do the following: -- Perform [LINQ to Objects](/dotnet/csharp/programming-guide/concepts/linq/linq-to-objects) queries on a file to obtain a filtered set of its lines. +- Perform [LINQ to Objects](/dotnet/csharp/linq/get-started/introduction-to-linq-queries) queries on a file to obtain a filtered set of its lines. - Write the returned collection of lines to a file with the method, or append them to an existing file with the method. - Create an immediately populated instance of a collection that takes an collection of strings for its constructor, such as a or a . +A line is defined as a sequence of characters terminated by a carriage return ('\r'), a line feed ('\n'), a carriage return immediately followed by a line feed, or the end of the file or stream. If the file ends with a newline sequence, no additional empty line is returned. For example, a file containing `"line1\nline2\n"` produces the same two lines (`"line1"` and `"line2"`) as a file containing `"line1\nline2"`. + ]]> .NET Framework and .NET Core versions older than 2.1: is a zero-length string, contains only white space, or contains one or more invalid characters as defined by the method. @@ -7620,7 +7629,7 @@ Given a string array and a file path, this method opens the specified file, writ You can use this method to create a file that contains the following: -- The results of a [LINQ to Objects](/dotnet/csharp/programming-guide/concepts/linq/linq-to-objects) query on the lines of a file, as obtained by using the method. +- The results of a [LINQ to Objects](/dotnet/csharp/linq/get-started/introduction-to-linq-queries) query on the lines of a file, as obtained by using the method. - The contents of a collection that implements an of strings. diff --git a/xml/System.IO/StreamReader.xml b/xml/System.IO/StreamReader.xml index 945483c1535..72b03c29b6c 100644 --- a/xml/System.IO/StreamReader.xml +++ b/xml/System.IO/StreamReader.xml @@ -2520,6 +2520,8 @@ Following a call to , any operations on the ## Remarks A line is defined as a sequence of characters followed by a line feed ("\n"), a carriage return ("\r"), or a carriage return immediately followed by a line feed ("\r\n"). The string that is returned does not contain the terminating carriage return or line feed. The returned value is `null` if the end of the input stream is reached. + If the stream ends with a newline sequence, no additional empty line is returned. For example, a stream containing `"line1\nline2\n"` produces the same two lines (`"line1"` and `"line2"`) as a stream containing `"line1\nline2"`. + This method overrides . If the current method throws an , the reader's position in the underlying object is advanced by the number of characters the method was able to read, but the characters already read into the internal buffer are discarded. If you manipulate the position of the underlying stream after reading data into the buffer, the position of the underlying stream might not match the position of the internal buffer. To reset the internal buffer, call the method; however, this method slows performance and should be called only when absolutely necessary. diff --git a/xml/System.IO/StringReader.xml b/xml/System.IO/StringReader.xml index 05691d24a18..29378dfa8cb 100644 --- a/xml/System.IO/StringReader.xml +++ b/xml/System.IO/StringReader.xml @@ -1058,6 +1058,8 @@ This implementation of `Close` calls the , A line is defined as a sequence of characters followed by a line feed ("\n"), a carriage return ("\r"), a carriage return immediately followed by a line feed ("\r\n"), or the end-of-stream marker. The string that is returned does not contain the terminating carriage return or line feed. The returned value is `null` if the end-of-stream marker has been reached. That is to say, if there is nothing between the last line read and the end-of-stream marker, the method returns `null`. + If the string ends with a newline sequence, no additional empty line is returned. For example, the string `"line1\nline2\n"` produces the same two lines (`"line1"` and `"line2"`) as the string `"line1\nline2"`. + If the current method throws an , the reader's position in the underlying string is advanced by the number of characters the method was able to read, but the characters already read into the internal buffer are discarded. Because the position of the reader in the string cannot be changed, the characters already read are unrecoverable, and can be accessed only by reinitializing the . To avoid such a situation, use the method and store the read characters in a preallocated buffer. The following table lists examples of other typical or related I/O tasks. @@ -1075,8 +1077,6 @@ This implementation of `Close` calls the , |Read from a binary file.|[How to: Read and Write to a Newly Created Data File](/dotnet/standard/io/how-to-read-and-write-to-a-newly-created-data-file)| |Write to a binary file.|[How to: Read and Write to a Newly Created Data File](/dotnet/standard/io/how-to-read-and-write-to-a-newly-created-data-file)| - - ## Examples This code example is part of a larger example provided for the class. diff --git a/xml/System.IO/TextReader.xml b/xml/System.IO/TextReader.xml index b730cb11c72..307edb09e23 100644 --- a/xml/System.IO/TextReader.xml +++ b/xml/System.IO/TextReader.xml @@ -1193,9 +1193,11 @@ , or the end-of-stream marker. The string that is returned does not contain the terminating carriage return or line feed. The return value is `null` if the end of the input stream has been reached. + A line is defined as a sequence of characters followed by a carriage return (0x000d), a line feed (0x000a), a carriage return followed by a line feed, , or the end of the reader's input. The string that is returned does not contain the terminating carriage return or line feed. The return value is `null` if the end of the input has been reached. - If the method throws an exception, the reader's position in the underlying is advanced by the number of characters the method was able to read, but the characters that were already read into the internal buffer are discarded. Because the position of the reader in the stream cannot be changed, the characters that were already read are unrecoverable and can be accessed only by reinitializing the object. If the initial position within the stream is unknown or the stream does not support seeking, the underlying also needs to be reinitialized. + If the input ends with a newline sequence, no additional empty line is returned. For example, input containing `"line1\nline2\n"` produces the same two lines (`"line1"` and `"line2"`) as input containing `"line1\nline2"`. + + If the method throws an exception, the reader's position in its underlying source is advanced by the number of characters the method was able to read, but the characters that were already read into the internal buffer are discarded. Because the reader's position in the underlying source cannot be reset, the characters that were already read are unrecoverable and can be accessed only by reinitializing the object. If the initial position within the underlying source is unknown or the source does not support repositioning, the underlying source also needs to be reinitialized. To avoid such a situation and produce robust code you should use the method and store the read characters in a preallocated buffer. diff --git a/xml/System.Linq.Expressions/Expression`1.xml b/xml/System.Linq.Expressions/Expression`1.xml index 5c902779af3..3f357dd2029 100644 --- a/xml/System.Linq.Expressions/Expression`1.xml +++ b/xml/System.Linq.Expressions/Expression`1.xml @@ -94,7 +94,7 @@ ]]> - Lambda Expressions (C# Programming Guide) + Lambda Expressions (C# Programming Guide) diff --git a/xml/System.Linq/Enumerable.xml b/xml/System.Linq/Enumerable.xml index 95791bba536..2c264c81e38 100644 --- a/xml/System.Linq/Enumerable.xml +++ b/xml/System.Linq/Enumerable.xml @@ -65,7 +65,7 @@ ]]> - Standard Query Operators overview (C#) + Standard Query Operators overview (C#) Standard Query Operators overview (Visual Basic) Extension Methods (C# Programming Guide) Extension Methods (Visual Basic) @@ -2501,7 +2501,7 @@ Each chunk except the last one will be of size `size`. The last chunk will conta ]]> - Partitioning data + Partitioning data is . @@ -3101,7 +3101,7 @@ Each chunk except the last one will be of size `size`. The last chunk will conta is . - Join operations (C#) + Join operations (C#) Join operations (Visual Basic) @@ -3178,7 +3178,7 @@ Each chunk except the last one will be of size `size`. The last chunk will conta ]]> - Join operations (C#) + Join operations (C#) Join operations (Visual Basic) @@ -3450,7 +3450,7 @@ The - Distinct and DistinctBy examples + Distinct and DistinctBy examples is . @@ -3530,7 +3530,7 @@ The - Distinct and DistinctBy examples + Distinct and DistinctBy examples is . @@ -4152,7 +4152,7 @@ Only unique elements are returned. Produces the set difference of two sequences according to a specified key selector function. A sequence that contains the set difference of the elements of two sequences. To be added. - Except and ExceptBy examples + Except and ExceptBy examples @@ -4222,7 +4222,7 @@ Only unique elements are returned. Produces the set difference of two sequences according to a specified key selector function. A sequence that contains the set difference of the elements of two sequences. To be added. - Except and ExceptBy examples + Except and ExceptBy examples @@ -5630,7 +5630,7 @@ Only unique elements are returned. `GroupJoin` preserves the order of the elements of `outer`, and for each element of `outer`, the order of the matching elements from `inner`. - has no direct equivalent in traditional relational database terms. However, this method does implement a superset of inner joins and left outer joins. Both of these operations can be written in terms of a grouped join. For more information, see [Join operations](/dotnet/csharp/programming-guide/concepts/linq/join-operations). + has no direct equivalent in traditional relational database terms. However, this method does implement a superset of inner joins and left outer joins. Both of these operations can be written in terms of a grouped join. For more information, see [Join operations](/dotnet/csharp/linq/standard-query-operators/join-operations). In query expression syntax, a `join ... into` (C#) or `Group Join` (Visual Basic) clause translates to an invocation of . @@ -5644,7 +5644,7 @@ Only unique elements are returned. or or or or is . - Join operations (C#) + Join operations (C#) Join operations (Visual Basic) join clause (C# Reference) Group Join Clause (Visual Basic) @@ -5767,13 +5767,13 @@ Only unique elements are returned. `GroupJoin` preserves the order of the elements of `outer`, and for each element of `outer`, the order of the matching elements from `inner`. - has no direct equivalent in traditional relational database terms. However, this method does implement a superset of inner joins and left outer joins. Both of these operations can be written in terms of a grouped join. For more information, see [Join operations](/dotnet/csharp/programming-guide/concepts/linq/join-operations). + has no direct equivalent in traditional relational database terms. However, this method does implement a superset of inner joins and left outer joins. Both of these operations can be written in terms of a grouped join. For more information, see [Join operations](/dotnet/csharp/linq/standard-query-operators/join-operations). ]]> or or or or is . - Join operations (C#) + Join operations (C#) Join operations (Visual Basic) @@ -6159,7 +6159,7 @@ The default equality comparer, - Intersect and IntersectBy examples + Intersect and IntersectBy examples or is . @@ -6245,7 +6245,7 @@ If `comparer` is `null`, the default equality comparer, - Intersect and IntersectBy examples + Intersect and IntersectBy examples or is . @@ -6365,7 +6365,7 @@ If `comparer` is `null`, the default equality comparer, . - In relational database terms, the method implements an inner equijoin. 'Inner' means that only elements that have a match in the other sequence are included in the results. An 'equijoin' is a join in which the keys are compared for equality. A left outer join operation has no dedicated standard query operator, but can be performed by using the method. For more information, see [Join operations](/dotnet/csharp/programming-guide/concepts/linq/join-operations). + In relational database terms, the method implements an inner equijoin. 'Inner' means that only elements that have a match in the other sequence are included in the results. An 'equijoin' is a join in which the keys are compared for equality. A left outer join operation has no dedicated standard query operator, but can be performed by using the method. For more information, see [Join operations](/dotnet/csharp/linq/standard-query-operators/join-operations). ## Examples The following code example demonstrates how to use to perform an inner join of two sequences based on a common key. @@ -6377,7 +6377,7 @@ If `comparer` is `null`, the default equality comparer, or or or or is . - Join operations (C#) + Join operations (C#) Join operations (Visual Basic) join clause (C# Reference) Join Clause (Visual Basic) @@ -6495,13 +6495,13 @@ If `comparer` is `null`, the default equality comparer, preserves the order of the elements of `outer`, and for each of these elements, the order of the matching elements of `inner`. - In relational database terms, the method implements an inner equijoin. 'Inner' means that only elements that have a match in the other sequence are included in the results. An 'equijoin' is a join in which the keys are compared for equality. A left outer join operation has no dedicated standard query operator, but can be performed by using the method. For more information, see [Join operations](/dotnet/csharp/programming-guide/concepts/linq/join-operations). + In relational database terms, the method implements an inner equijoin. 'Inner' means that only elements that have a match in the other sequence are included in the results. An 'equijoin' is a join in which the keys are compared for equality. A left outer join operation has no dedicated standard query operator, but can be performed by using the method. For more information, see [Join operations](/dotnet/csharp/linq/standard-query-operators/join-operations). ]]> or or or or is . - Join operations (C#) + Join operations (C#) Join operations (Visual Basic) @@ -17932,7 +17932,7 @@ The following example demonstrates how to use `UnionBy` to merge two collections ]]> - Union and UnionBy examples + Union and UnionBy examples or is . @@ -18022,7 +18022,7 @@ The following example demonstrates how to use `UnionBy` to merge two collections ]]> - Union and UnionBy examples + Union and UnionBy examples or is . @@ -18263,7 +18263,7 @@ The following example demonstrates how to use `UnionBy` to merge two collections Produces a sequence of tuples with elements from the two specified sequences. A sequence of tuples with elements taken from the first and second sequences, in that order. To be added. - Projection operations - Zip + Projection operations - Zip @@ -18358,7 +18358,7 @@ The following example demonstrates how to use `UnionBy` to merge two collections ]]> - Projection operations - Zip + Projection operations - Zip or is . @@ -18440,7 +18440,7 @@ The following example demonstrates how to use `UnionBy` to merge two collections Produces a sequence of tuples with elements from the three specified sequences. A sequence of tuples with elements taken from the first, second, and third sequences, in that order. To be added. - Projection operations - Zip + Projection operations - Zip diff --git a/xml/System.Linq/OrderedParallelQuery`1.xml b/xml/System.Linq/OrderedParallelQuery`1.xml index 47b62c0437d..6c15f49204b 100644 --- a/xml/System.Linq/OrderedParallelQuery`1.xml +++ b/xml/System.Linq/OrderedParallelQuery`1.xml @@ -66,7 +66,7 @@ Represents a sorted, parallel sequence. To be added. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) Order Preservation in PLINQ How to: Control Ordering in a PLINQ Query @@ -111,7 +111,7 @@ An enumerator that iterates through the sequence. To be added. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) diff --git a/xml/System.Linq/ParallelEnumerable.xml b/xml/System.Linq/ParallelEnumerable.xml index 32fe8686b2e..9a82c76425e 100644 --- a/xml/System.Linq/ParallelEnumerable.xml +++ b/xml/System.Linq/ParallelEnumerable.xml @@ -51,7 +51,7 @@ Provides a set of methods for querying objects that implement ParallelQuery{TSource}. This is the parallel equivalent of . To be added. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -131,7 +131,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -212,7 +212,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -298,7 +298,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -393,7 +393,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -488,7 +488,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -551,7 +551,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -629,7 +629,7 @@ is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -692,7 +692,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -756,7 +756,7 @@ To be added. is a null reference (Nothing in Visual Basic). - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -819,7 +819,7 @@ -or- is not one of , , or . - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -890,7 +890,7 @@ -or- is not one of AsParallel, ParallelEnumerable.Range, or ParallelEnumerable.Repeat. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -904,7 +904,7 @@ @@ -961,7 +961,7 @@ is a null reference (Nothing in Visual Basic). - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1026,7 +1026,7 @@ is a null reference (Nothing in Visual Basic). - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1084,7 +1084,7 @@ To be added. is a null reference (Nothing in Visual Basic). - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1149,7 +1149,7 @@ is a null reference (Nothing in Visual Basic). - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1214,7 +1214,7 @@ is a null reference (Nothing in Visual Basic). - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1225,7 +1225,7 @@ Computes in parallel the average of a sequence of values. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1276,7 +1276,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1327,7 +1327,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1378,7 +1378,7 @@ The sum or count of the elements in the sequence is larger than Int32.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1429,7 +1429,7 @@ The sum or count of the elements in the sequence is larger than Int32.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1480,7 +1480,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1531,7 +1531,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1582,7 +1582,7 @@ The sum or count of the elements in the sequence is larger than Int32.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1633,7 +1633,7 @@ The sum or count of the elements in the sequence is larger than Int32.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1684,7 +1684,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1735,7 +1735,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1800,7 +1800,7 @@ contains no elements. (Thrown as inner exception in an ). The function returns a value greater than MaxValue for the element type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1865,7 +1865,7 @@ contains no elements. (Thrown as inner exception in an ). The function returns a value greater than MaxValue for the element type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1930,7 +1930,7 @@ contains no elements. (Thrown as inner exception in an ). The function returns a value greater than MaxValue for the element type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -1995,7 +1995,7 @@ contains no elements. (Thrown as inner exception in an ). The function returns a value greater than MaxValue for the element type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -2060,7 +2060,7 @@ contains no elements. (Thrown as inner exception in an ). The function returns a value greater than MaxValue for the element type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -2125,7 +2125,7 @@ contains no elements. (Thrown as inner exception in an ). The function returns a value greater than MaxValue for the element type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -2190,7 +2190,7 @@ contains no elements. (Thrown as inner exception in an ). The function returns a value greater than MaxValue for the element type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -2255,7 +2255,7 @@ contains no elements. (Thrown as inner exception in an ). The function returns a value greater than MaxValue for the element type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -2320,7 +2320,7 @@ contains no elements. (Thrown as inner exception in an ). The function returns a value greater than MaxValue for the element type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -2385,7 +2385,7 @@ contains no elements. (Thrown as inner exception in an ). The function returns a value greater than MaxValue for the element type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -2444,7 +2444,7 @@ is a null reference (Nothing in Visual Basic). The type of the source sequence could not be converted to . - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -2526,7 +2526,7 @@ ]]> The exception that occurs when this method is called. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -2586,7 +2586,7 @@ To be added. or is a null reference (Nothing in Visual Basic). - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -2665,7 +2665,7 @@ is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -2738,7 +2738,7 @@ is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -2808,7 +2808,7 @@ is a null reference (Nothing in Visual Basic). The number of elements in source is larger than Int32.MaxValue. (In this case the InnerException is ) -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -2870,7 +2870,7 @@ or is a null reference (Nothing in Visual Basic). The number of elements in source is larger than Int32.MaxValue. (In this case the InnerException is ) -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -2940,7 +2940,7 @@ is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -3002,7 +3002,7 @@ is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -3078,7 +3078,7 @@ is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -3147,7 +3147,7 @@ is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -3211,7 +3211,7 @@ is less than 0 or greater than or equal to the number of elements in . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -3274,7 +3274,7 @@ is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -3327,7 +3327,7 @@ Returns an empty ParallelQuery{TResult} that has the specified type argument. An empty sequence whose type argument is . To be added. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -3409,7 +3409,7 @@ ]]> The exception that occurs when this method is called. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -3477,7 +3477,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -3559,7 +3559,7 @@ ]]> The exception that occurs when this method is called. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -3632,7 +3632,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -3711,7 +3711,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -3781,7 +3781,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. No element in satisfies the condition in . - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -3859,7 +3859,7 @@ is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -3929,7 +3929,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -3997,7 +3997,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -4084,7 +4084,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -4165,7 +4165,7 @@ is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -4253,7 +4253,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -4345,7 +4345,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -4427,7 +4427,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -4519,7 +4519,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -4612,7 +4612,7 @@ or or or is ( in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -4715,7 +4715,7 @@ or or or is ( in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -4830,7 +4830,7 @@ ]]> The exception that occurs when this method is called. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -4931,7 +4931,7 @@ or or or or is ( in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -5046,7 +5046,7 @@ ]]> The exception that occurs when this method is called. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -5151,7 +5151,7 @@ or or or or is ( in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -5233,7 +5233,7 @@ ]]> The exception that occurs when this method is called. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -5301,7 +5301,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -5383,7 +5383,7 @@ ]]> The exception that occurs when this method is called. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -5455,7 +5455,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -5570,7 +5570,7 @@ ]]> The exception that occurs when this method is called. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -5671,7 +5671,7 @@ or or or or is ( in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -5786,7 +5786,7 @@ ]]> The exception that occurs when this method is called. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -5891,7 +5891,7 @@ or or or or is ( in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -5970,7 +5970,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6040,7 +6040,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. No element in satisfies the condition in . - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6118,7 +6118,7 @@ is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6188,7 +6188,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6259,7 +6259,7 @@ is a null reference (Nothing in Visual Basic). The number of elements in source is larger than Int32.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. The computed result is greater than Int32.MaxValue. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6322,7 +6322,7 @@ or is a null reference (Nothing in Visual Basic). The number of elements in source is larger than Int32.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. The computed result is greater than Int32.MaxValue. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6383,7 +6383,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6434,7 +6434,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6485,7 +6485,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6536,7 +6536,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6587,7 +6587,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6638,7 +6638,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6689,7 +6689,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6740,7 +6740,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6791,7 +6791,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6842,7 +6842,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6905,7 +6905,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -6969,7 +6969,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7033,7 +7033,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7097,7 +7097,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7161,7 +7161,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7225,7 +7225,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7289,7 +7289,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7353,7 +7353,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7417,7 +7417,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7481,7 +7481,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7545,7 +7545,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7619,7 +7619,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7680,7 +7680,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7731,7 +7731,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7782,7 +7782,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7833,7 +7833,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7884,7 +7884,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7935,7 +7935,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -7986,7 +7986,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8037,7 +8037,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8088,7 +8088,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8139,7 +8139,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8202,7 +8202,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8266,7 +8266,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8330,7 +8330,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8394,7 +8394,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8458,7 +8458,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8522,7 +8522,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8586,7 +8586,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8650,7 +8650,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8714,7 +8714,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8778,7 +8778,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8842,7 +8842,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8916,7 +8916,7 @@ One or more exceptions occurred during the evaluation of the query. contains no elements and is a non-nullable value type. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -8976,7 +8976,7 @@ is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -9064,7 +9064,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -9152,7 +9152,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -9240,7 +9240,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -9328,7 +9328,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -9377,7 +9377,7 @@ To be added. is less than 0 -or- + - 1 is larger than Int32.MaxValue. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -9437,7 +9437,7 @@ To be added. is less than 0. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -9497,7 +9497,7 @@ is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -9579,7 +9579,7 @@ The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. More than Int32.MaxValue elements are enumerated by the query. This condition might occur in streaming scenarios. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -9650,7 +9650,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -9731,7 +9731,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -9803,7 +9803,7 @@ The query was canceled with the token passed in through . More than Int32.MaxValue elements are enumerated by the query. One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -9886,7 +9886,7 @@ The query was canceled with the token passed in through . More than Int32.MaxValue elements are enumerated by the query. One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -9969,7 +9969,7 @@ The query was canceled with the token passed in through . More than Int32.MaxValue elements are enumerated by the query. One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -10051,7 +10051,7 @@ ]]> Thrown every time this method is called. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -10114,7 +10114,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -10196,7 +10196,7 @@ ]]> Thrown every time this method is called. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -10269,7 +10269,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -10340,7 +10340,7 @@ is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. The input sequence contains more than one element. -or- The input sequence is empty. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -10403,7 +10403,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. No element satisfies the condition in . -or- More than one element satisfies the condition in . - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -10476,7 +10476,7 @@ has more than one element. One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -10541,7 +10541,7 @@ One or more exceptions occurred during the evaluation of the query. is empty or multiple elements are returned. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -10611,7 +10611,7 @@ The query was canceled with the token passed in through . Count is greater than Int32.MaxValue One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -10683,7 +10683,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -10746,7 +10746,7 @@ The query was canceled with the token passed in through . More than Int32.MaxValue elements are enumerated by the query. One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -10805,7 +10805,7 @@ is a null reference (Nothing in Visual Basic). The sum is larger than Decimal.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -10854,7 +10854,7 @@ is a null reference (Nothing in Visual Basic). The sum is larger than Double.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -10903,7 +10903,7 @@ is a null reference (Nothing in Visual Basic). The sum is larger than Int32.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -10952,7 +10952,7 @@ is a null reference (Nothing in Visual Basic). The sum is larger than Int64.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11001,7 +11001,7 @@ is a null reference (Nothing in Visual Basic). The sum is larger than Decimal.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11050,7 +11050,7 @@ is a null reference (Nothing in Visual Basic). The sum is larger than Double.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11099,7 +11099,7 @@ is a null reference (Nothing in Visual Basic). The sum is larger than Int32.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11148,7 +11148,7 @@ is a null reference (Nothing in Visual Basic). The sum is larger than Int64.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11197,7 +11197,7 @@ is a null reference (Nothing in Visual Basic). The sum is larger than Single.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11246,7 +11246,7 @@ is a null reference (Nothing in Visual Basic). The sum is larger than Single.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11308,7 +11308,7 @@ or is a null reference (Nothing in Visual Basic). The sum is larger than Decimal.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11370,7 +11370,7 @@ or is a null reference (Nothing in Visual Basic). The sum is larger than Double.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11432,7 +11432,7 @@ or is a null reference (Nothing in Visual Basic). The sum is larger than Int32.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11494,7 +11494,7 @@ or is a null reference (Nothing in Visual Basic). The sum is larger than Int64.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11556,7 +11556,7 @@ or is a null reference (Nothing in Visual Basic). The sum is larger than Decimal.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11618,7 +11618,7 @@ or is a null reference (Nothing in Visual Basic). The sum is larger than Double.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11680,7 +11680,7 @@ or is a null reference (Nothing in Visual Basic). The sum is larger than Int32.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11742,7 +11742,7 @@ or is a null reference (Nothing in Visual Basic). The sum is larger than Int64.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11804,7 +11804,7 @@ or is a null reference (Nothing in Visual Basic). The sum is larger than Single.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11866,7 +11866,7 @@ or is a null reference (Nothing in Visual Basic). The sum is larger than Single.MaxValue. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -11928,7 +11928,7 @@ is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -12000,7 +12000,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -12063,7 +12063,7 @@ The query was canceled with the token passed in through . More than Int32.MaxValue elements are enumerated by this query. One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -12151,7 +12151,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -12239,7 +12239,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -12327,7 +12327,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -12415,7 +12415,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -12475,7 +12475,7 @@ is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -12550,7 +12550,7 @@ or is a null reference (Nothing in Visual Basic). produces a key that is a null reference (Nothing in Visual Basic). -or- produces duplicate keys for two elements. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -12625,7 +12625,7 @@ or is a null reference (Nothing in Visual Basic). produces a key that is a null reference (Nothing in Visual Basic). -or- produces duplicate keys for two elements. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -12701,7 +12701,7 @@ or or is a null reference (Nothing in Visual Basic). produces a key that is a null reference (Nothing in Visual Basic). -or- produces duplicate keys for two elements. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -12787,7 +12787,7 @@ or or is a null reference (Nothing in Visual Basic). produces a key that is a null reference (Nothing in Visual Basic). -or- produces duplicate keys for two elements. -or- One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -12847,7 +12847,7 @@ is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -12921,7 +12921,7 @@ or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -12995,7 +12995,7 @@ or or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -13070,7 +13070,7 @@ or or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -13155,7 +13155,7 @@ or or is a null reference (Nothing in Visual Basic). One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -13239,7 +13239,7 @@ The exception that occurs when this method is called. The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -13307,7 +13307,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -13391,7 +13391,7 @@ The exception that occurs when this method is called. The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -13463,7 +13463,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -13535,7 +13535,7 @@ or is a null reference (Nothing in Visual Basic). The query was canceled with the token passed in through . One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -13598,7 +13598,7 @@ The query was canceled with the token passed in through . More than Int32.MaxValue elements are enumerated by the query. One or more exceptions occurred during the evaluation of the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -13661,7 +13661,7 @@ is a null reference (Nothing in Visual Basic). is used multiple times in the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) How to: Cancel a PLINQ Query Cancellation @@ -13726,7 +13726,7 @@ is less than 1 or greater than 512. WithDegreeOfParallelism is used multiple times in the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -13796,7 +13796,7 @@ is not a valid value. WithExecutionMode is used multiple times in the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -13860,7 +13860,7 @@ is not a valid value. is used multiple times in the query. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) Merge Options in PLINQ How to: Specify Merge Options in PLINQ @@ -13964,7 +13964,7 @@ ]]> The exception that occurs when this method is called. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) diff --git a/xml/System.Linq/ParallelExecutionMode.xml b/xml/System.Linq/ParallelExecutionMode.xml index 56826e11388..a0485e2fc2c 100644 --- a/xml/System.Linq/ParallelExecutionMode.xml +++ b/xml/System.Linq/ParallelExecutionMode.xml @@ -44,7 +44,7 @@ The query execution mode is a hint that specifies how the system should handle performance trade-offs when parallelizing queries. To be added. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) How to: Specify the Execution Mode in PLINQ Understanding Speedup in PLINQ diff --git a/xml/System.Linq/ParallelMergeOptions.xml b/xml/System.Linq/ParallelMergeOptions.xml index 9072dc284d0..cf0c63dbf6c 100644 --- a/xml/System.Linq/ParallelMergeOptions.xml +++ b/xml/System.Linq/ParallelMergeOptions.xml @@ -55,7 +55,7 @@ ]]> - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) Merge Options in PLINQ How to: Specify Merge Options in PLINQ diff --git a/xml/System.Linq/ParallelQuery.xml b/xml/System.Linq/ParallelQuery.xml index 045ee997c1b..882036b2cda 100644 --- a/xml/System.Linq/ParallelQuery.xml +++ b/xml/System.Linq/ParallelQuery.xml @@ -50,7 +50,7 @@ Represents a parallel sequence. To be added. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -109,7 +109,7 @@ This member is an explicit interface member implementation. It can be used only ]]> - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) diff --git a/xml/System.Linq/ParallelQuery`1.xml b/xml/System.Linq/ParallelQuery`1.xml index 2575eeeabce..41c8181bd36 100644 --- a/xml/System.Linq/ParallelQuery`1.xml +++ b/xml/System.Linq/ParallelQuery`1.xml @@ -64,7 +64,7 @@ Represents a parallel sequence. To be added. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) @@ -109,7 +109,7 @@ Returns an enumerator that iterates through the sequence. An enumerator that iterates through the sequence. To be added. - Parallel LINQ (PLINQ) + Parallel LINQ (PLINQ) diff --git a/xml/System.Management.Instrumentation/WmiProviderInstallationException.xml b/xml/System.Management.Instrumentation/WmiProviderInstallationException.xml index 3bbe2a5c89c..d8763343526 100644 --- a/xml/System.Management.Instrumentation/WmiProviderInstallationException.xml +++ b/xml/System.Management.Instrumentation/WmiProviderInstallationException.xml @@ -23,7 +23,7 @@ Represents an exception to throw when WMI provider installation fails. - Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development. + Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. Use the MI APIs for all new development. To be added. diff --git a/xml/System.Net.Http/HttpClient.xml b/xml/System.Net.Http/HttpClient.xml index fbc6bc7ad84..c35eef7f2cc 100644 --- a/xml/System.Net.Http/HttpClient.xml +++ b/xml/System.Net.Http/HttpClient.xml @@ -55,7 +55,7 @@ :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Misc/system.net.http.httpclient/vb/source.vb" id="Snippet1"::: ]]> - Guidelines for using HttpClient + Guidelines for using HttpClient HttpClient Sample diff --git a/xml/System.Net/WebRequest.xml b/xml/System.Net/WebRequest.xml index 54e6218bbe6..411ff231bee 100644 --- a/xml/System.Net/WebRequest.xml +++ b/xml/System.Net/WebRequest.xml @@ -1332,7 +1332,7 @@ ## Remarks -This property allows an application to determine which derived factory object was used to create the request. This object may be [System.Net.Browser.WebRequestCreator.BrowserHttp](https://learn.microsoft.com/en-us/)) or [System.Net.Browser.WebRequestCreator.ClientHttp](https://learn.microsoft.com/en-us/)), but it may also be a custom instance derived from . This allows an application to determine whether the browser hosting Silverlight, the Silverlight client, or some custom object handles HTTP requests and responses for the instance. The method allows an application to configure which derived type will be instantiated when making a request to a specific URI. creators are typically registered to handle a specific protocol, such HTTP or HTTPS, but can be registered to handle a request to a specific server or path on a server. This is useful when more than one derived type can process requests for the same protocol. The Microsoft Silverlight 3 and later runtime supports multiple HTTP handlers each having different capabilities. For example, a web service that uses Representational State Transfer (REST) might require the [System.Net.Browser.WebRequestCreator.ClientHttp](https://learn.microsoft.com/en-us/)) handler while a SOAP web service might be able to use the default [System.Net.Browser.WebRequestCreator.BrowserHttp](https://learn.microsoft.com/en-us/)) handler. +This property allows an application to determine which derived factory object was used to create the request. This object may be System.Net.Browser.WebRequestCreator.BrowserHttp or System.Net.Browser.WebRequestCreator.ClientHttp, but it may also be a custom instance derived from . This allows an application to determine whether the browser hosting Silverlight, the Silverlight client, or some custom object handles HTTP requests and responses for the instance. The method allows an application to configure which derived type will be instantiated when making a request to a specific URI. creators are typically registered to handle a specific protocol, such as HTTP or HTTPS, but can be registered to handle a request to a specific server or path on a server. This is useful when more than one derived type can process requests for the same protocol. The Microsoft Silverlight 3 and later runtime supports multiple HTTP handlers each having different capabilities. For example, a web service that uses Representational State Transfer (REST) might require the System.Net.Browser.WebRequestCreator.ClientHttp handler while a SOAP web service might be able to use the default System.Net.Browser.WebRequestCreator.BrowserHttp handler. ]]> diff --git a/xml/System.Reflection/Assembly.xml b/xml/System.Reflection/Assembly.xml index 6456a5ab29c..007366ca28b 100644 --- a/xml/System.Reflection/Assembly.xml +++ b/xml/System.Reflection/Assembly.xml @@ -1184,7 +1184,7 @@ In .NET 5 and later versions, for bundled assemblies, this property throws an ex ]]> - Specifying Fully Qualified Type Names + Specifying Fully Qualified Type Names diff --git a/xml/System.Reflection/AssemblyName.xml b/xml/System.Reflection/AssemblyName.xml index 250039e168a..8d0b3398cbc 100644 --- a/xml/System.Reflection/AssemblyName.xml +++ b/xml/System.Reflection/AssemblyName.xml @@ -197,7 +197,7 @@ ExampleAssembly, Version=1.0.0.0, Culture=en, PublicKeyToken=a5d015c7d5a0b012 - Specifying Fully Qualified Type Names + Specifying Fully Qualified Type Names @@ -826,7 +826,7 @@ mylib, Version=1.2.1900.0, Culture=neutral, PublicKeyToken=a14f3033def15840 ]]> - Specifying Fully Qualified Type Names + Specifying Fully Qualified Type Names @@ -1303,7 +1303,7 @@ mylib, Version=1.2.1900.0, Culture=neutral, PublicKeyToken=a14f3033def15840 ]]> - Specifying Fully Qualified Type Names + Specifying Fully Qualified Type Names diff --git a/xml/System.Reflection/MethodImplAttributes.xml b/xml/System.Reflection/MethodImplAttributes.xml index f64660aab45..1d5e07b8b8b 100644 --- a/xml/System.Reflection/MethodImplAttributes.xml +++ b/xml/System.Reflection/MethodImplAttributes.xml @@ -911,7 +911,7 @@ 32 - Specifies that the method is single-threaded through the body. Static methods ( in Visual Basic) lock on the type, whereas instance methods lock on the instance. You can also use the C# lock statement or the Visual Basic SyncLock statement for this purpose. + Specifies that the method is single-threaded through the body. Static methods ( in Visual Basic) lock on the type, whereas instance methods lock on the instance. You can also use the C# lock statement or the Visual Basic SyncLock statement for this purpose. diff --git a/xml/System.Reflection/MethodInfo.xml b/xml/System.Reflection/MethodInfo.xml index 9481db14f90..8efbd29db1c 100644 --- a/xml/System.Reflection/MethodInfo.xml +++ b/xml/System.Reflection/MethodInfo.xml @@ -675,7 +675,7 @@ For a list of the invariant conditions for other terms used in generic reflectio Reflection and Generic Types - Introduction to Generics (C# Programming Guide) + Introduction to Generics (C# Programming Guide) @@ -782,7 +782,7 @@ End Class Reflection and Generic Types - Introduction to Generics (C# Programming Guide) + Introduction to Generics (C# Programming Guide) @@ -1085,7 +1085,7 @@ Console::WriteLine("\tIs this a generic method definition? {0}", Reflection and Generic Types - Introduction to Generics (C# Programming Guide) + Introduction to Generics (C# Programming Guide) @@ -1220,7 +1220,7 @@ End Class Reflection and Generic Types - Introduction to Generics (C# Programming Guide) + Introduction to Generics (C# Programming Guide) diff --git a/xml/System.Runtime.CompilerServices/AsyncStateMachineAttribute.xml b/xml/System.Runtime.CompilerServices/AsyncStateMachineAttribute.xml index 0788717d5bb..40f2bdc10bf 100644 --- a/xml/System.Runtime.CompilerServices/AsyncStateMachineAttribute.xml +++ b/xml/System.Runtime.CompilerServices/AsyncStateMachineAttribute.xml @@ -67,7 +67,7 @@ When a method (*MethodName*) has the Async or async modifier, the compiler emits IL that includes a state machine structure. This structure contains the code in the method. That IL also contains a stub method (*MethodName*) that calls into the state machine. The compiler adds the `AsyncStateMachine` attribute to the stub method so that tools can identify the corresponding state machine. Details of the emitted IL might change in future releases of the compilers. - For information about the Async feature, see [Asynchronous programming (C#)](/dotnet/csharp/async) or [Asynchronous programming with Async and Await (Visual Basic)](/dotnet/visual-basic/programming-guide/concepts/async/). + For information about the Async feature, see [Asynchronous programming (C#)](/dotnet/csharp/asynchronous-programming/) or [Asynchronous programming with Async and Await (Visual Basic)](/dotnet/visual-basic/programming-guide/concepts/async/). @@ -76,7 +76,7 @@ - Obtains a object for the method name by using . -- Obtains a object for the attribute by using [GetType Operator](/dotnet/visual-basic/language-reference/operators/gettype-operator) or [typeof](/dotnet/csharp/language-reference/keywords/typeof). +- Obtains a object for the attribute by using [GetType Operator](/dotnet/visual-basic/language-reference/operators/gettype-operator) or [typeof](/dotnet/csharp/language-reference/operators/type-testing-and-cast). - Obtains an attribute object for the method and attribute type by using `MethodInfo.GetCustomAttribute`. If `GetCustomAttribute` returns `Nothing` (Visual Basic) or `null` (C#), the method doesn't contain the attribute. diff --git a/xml/System.Runtime.InteropServices/CoClassAttribute.xml b/xml/System.Runtime.InteropServices/CoClassAttribute.xml index 001e62ddb0a..6c0cfd05b6a 100644 --- a/xml/System.Runtime.InteropServices/CoClassAttribute.xml +++ b/xml/System.Runtime.InteropServices/CoClassAttribute.xml @@ -66,15 +66,15 @@ Specifies the class identifier of a coclass imported from a type library. - , you must also apply the and attributes to the coclass interface. For additional information about how Tlbimp.exe imports interfaces and coclasses from a type library, see [Imported Type Conversion](https://learn.microsoft.com/en-us/)). - + , you must also apply the and attributes to the coclass interface. + ]]> diff --git a/xml/System.Runtime.InteropServices/DispIdAttribute.xml b/xml/System.Runtime.InteropServices/DispIdAttribute.xml index 13265142c80..817307c7ca8 100644 --- a/xml/System.Runtime.InteropServices/DispIdAttribute.xml +++ b/xml/System.Runtime.InteropServices/DispIdAttribute.xml @@ -62,24 +62,20 @@ Specifies the COM dispatch identifier (DISPID) of a method, field, or property. - diff --git a/xml/System.Runtime.InteropServices/InterfaceTypeAttribute.xml b/xml/System.Runtime.InteropServices/InterfaceTypeAttribute.xml index 92b5e3e4b3f..524d9610e45 100644 --- a/xml/System.Runtime.InteropServices/InterfaceTypeAttribute.xml +++ b/xml/System.Runtime.InteropServices/InterfaceTypeAttribute.xml @@ -62,24 +62,22 @@ Indicates whether a managed interface is dual, dispatch-only, or -only when exposed to COM. - enumeration enables you to override the default behavior and specify late binding only or early binding only. For example, you can apply `InterfaceType (ComInterfaceType.InterfaceIsIDispatch)` to an interface to produce metadata to restrict callers to late binding only. Although interfaces that derive from the `IDispatch` interface are often dual, the `InterfaceIsIDispatch` enumeration member allows only late-bound calls to the interface methods. This attribute has no effect on the managed view of the interface. For additional information on how interfaces are exposed to COM, see [Exported Type Conversion](https://learn.microsoft.com/en-us/)). - - The [Tlbimp.exe (Type Library Importer)](/dotnet/framework/tools/tlbimp-exe-type-library-importer) also applies this attribute to imported, nondual interfaces; it applies the appropriate enumeration member to indicate that the interface is dispatch-only or `IUnknown` -only. - - - -## Examples - The following example shows how `InterfaceTypeAttribute` controls how the interface is exposed to COM. - + enumeration enables you to override the default behavior and specify late binding only or early binding only. For example, you can apply `InterfaceType (ComInterfaceType.InterfaceIsIDispatch)` to an interface to produce metadata to restrict callers to late binding only. Although interfaces that derive from the `IDispatch` interface are often dual, the `InterfaceIsIDispatch` enumeration member allows only late-bound calls to the interface methods. This attribute has no effect on the managed view of the interface. + + The [Tlbimp.exe (Type Library Importer)](/dotnet/framework/tools/tlbimp-exe-type-library-importer) also applies this attribute to imported, nondual interfaces; it applies the appropriate enumeration member to indicate that the interface is dispatch-only or `IUnknown` -only. + +## Examples + The following example shows how `InterfaceTypeAttribute` controls how the interface is exposed to COM. + :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_Classic/classic InterfaceTypeAttribute Example/CPP/source.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Runtime.InteropServices/InterfaceTypeAttribute/Overview/source.cs" id="Snippet1"::: - :::code language="vb" source="~/snippets/visualbasic/System.Runtime.InteropServices/InterfaceTypeAttribute/Overview/source.vb" id="Snippet1"::: - + :::code language="vb" source="~/snippets/visualbasic/System.Runtime.InteropServices/InterfaceTypeAttribute/Overview/source.vb" id="Snippet1"::: + ]]> @@ -146,11 +144,11 @@ Describes how the interface should be exposed to COM clients. Initializes a new instance of the class with the specified enumeration member. - enumeration member. The [Tlbimp.exe (Type Library Importer)](/dotnet/framework/tools/tlbimp-exe-type-library-importer) uses this constructor. - + enumeration member. The [Tlbimp.exe (Type Library Importer)](/dotnet/framework/tools/tlbimp-exe-type-library-importer) uses this constructor. + ]]> Tlbimp.exe (Type Library Importer) @@ -201,11 +199,11 @@ One of the values that describes how the interface should be exposed to COM clients. Initializes a new instance of the class with the specified enumeration member. - diff --git a/xml/System.Runtime.InteropServices/Marshal.xml b/xml/System.Runtime.InteropServices/Marshal.xml index c1d6debcbe2..478ffee0ced 100644 --- a/xml/System.Runtime.InteropServices/Marshal.xml +++ b/xml/System.Runtime.InteropServices/Marshal.xml @@ -593,7 +593,7 @@ The object whose CCW holds a reference counted handle. The handle is strong if the reference count on the CCW is greater than zero; otherwise, it is weak. to change the strength of the handle on the parameter to weak, regardless of its reference count; to reset the handle strength on to be reference counted. - Changes the strength of an object's COM Callable Wrapper (CCW) handle. + Changes the strength of an object's COM Callable Wrapper (CCW) handle. - Notifies the runtime to clean up all Runtime Callable Wrappers (RCWs) allocated in the current context. + Notifies the runtime to clean up all Runtime Callable Wrappers (RCWs) allocated in the current context. The RCW to be released. - Releases all references to a Runtime Callable Wrapper (RCW) by setting its reference count to 0. + Releases all references to a Runtime Callable Wrapper (RCW) by setting its reference count to 0. The new value of the reference count of the RCW associated with the parameter, which is 0 (zero) if the release is successful. A managed pointer to an interface. - Creates a unique Runtime Callable Wrapper (RCW) object for a given IUnknown interface. + Creates a unique Runtime Callable Wrapper (RCW) object for a given IUnknown interface. A unique RCW for the specified interface. The COM object to release. - Decrements the reference count of the Runtime Callable Wrapper (RCW) associated with the specified COM object. + Decrements the reference count of the Runtime Callable Wrapper (RCW) associated with the specified COM object. The new value of the reference count of the RCW associated with . This value is typically zero since the RCW keeps just one reference to the wrapped COM object regardless of the number of managed clients calling it. and to the assembly at design time. The on the primary interop assembly identifies the LIBID of the type library and the identifies the version of the particular type library for which this assembly is the primary interop assembly. The can appear multiple times if the assembly is the primary interop assembly for multiple versions of the same type library. - When using the types defined in a type library, always reference the primary interop assembly for that type library, rather than reimporting or redefining the types themselves. For guidelines and procedures on how to produce or use primary interop assemblies, see [Primary Interop Assemblies](https://learn.microsoft.com/en-us/)). For a detailed description of the type library importing process, see [Type Library to Assembly Conversion Summary](https://learn.microsoft.com/en-us/)). + When using the types defined in a type library, always reference the primary interop assembly for that type library, rather than reimporting or redefining the types themselves. ]]> diff --git a/xml/System.Runtime.Remoting.Channels/BaseChannelObjectWithProperties.xml b/xml/System.Runtime.Remoting.Channels/BaseChannelObjectWithProperties.xml index 44f706ee85d..a374f5dcdcc 100644 --- a/xml/System.Runtime.Remoting.Channels/BaseChannelObjectWithProperties.xml +++ b/xml/System.Runtime.Remoting.Channels/BaseChannelObjectWithProperties.xml @@ -48,7 +48,7 @@ handles the complex task of asking a channel object for its properties. - This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). + This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. diff --git a/xml/System.Runtime.Remoting.Channels/BaseChannelSinkWithProperties.xml b/xml/System.Runtime.Remoting.Channels/BaseChannelSinkWithProperties.xml index 744f92c5937..986fe1df95c 100644 --- a/xml/System.Runtime.Remoting.Channels/BaseChannelSinkWithProperties.xml +++ b/xml/System.Runtime.Remoting.Channels/BaseChannelSinkWithProperties.xml @@ -34,7 +34,7 @@ ## Remarks Channel sinks provide a plug-in point that allows access to the underlying messages that are flowing through the channel as well as the stream that is used by the transport mechanism to send messages to a remote object. Channel sinks are linked together in a chain of channel sink providers, and all channel messages flow through this chain of sinks before the message is serialized and transported. - This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). + This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. diff --git a/xml/System.Runtime.Remoting.Channels/BaseChannelWithProperties.xml b/xml/System.Runtime.Remoting.Channels/BaseChannelWithProperties.xml index 0e8cf4b1678..35c1f30d7ac 100644 --- a/xml/System.Runtime.Remoting.Channels/BaseChannelWithProperties.xml +++ b/xml/System.Runtime.Remoting.Channels/BaseChannelWithProperties.xml @@ -37,7 +37,7 @@ The class handles the complexity of asking the sinks in a channel sink chain for their properties. After the channel constructs its sink chain (if applicable), it must set the property. - This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). + This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. ]]> diff --git a/xml/System.Runtime.Remoting.Channels/ChannelDataStore.xml b/xml/System.Runtime.Remoting.Channels/ChannelDataStore.xml index 4368bf2c729..9c0ee465fc9 100644 --- a/xml/System.Runtime.Remoting.Channels/ChannelDataStore.xml +++ b/xml/System.Runtime.Remoting.Channels/ChannelDataStore.xml @@ -40,7 +40,7 @@ is thrown when either the immediate caller or the derived class does not have infrastructure permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). + This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. ]]> diff --git a/xml/System.Runtime.Remoting.Channels/ClientChannelSinkStack.xml b/xml/System.Runtime.Remoting.Channels/ClientChannelSinkStack.xml index ccba7b148ad..10bef0775f5 100644 --- a/xml/System.Runtime.Remoting.Channels/ClientChannelSinkStack.xml +++ b/xml/System.Runtime.Remoting.Channels/ClientChannelSinkStack.xml @@ -39,9 +39,7 @@ + This class makes a link demand. A security exception is thrown if the immediate caller does not have infrastructure permission. ]]> diff --git a/xml/System.Runtime.Remoting.Channels/ServerChannelSinkStack.xml b/xml/System.Runtime.Remoting.Channels/ServerChannelSinkStack.xml index 4c128cc8b22..03f4d22316b 100644 --- a/xml/System.Runtime.Remoting.Channels/ServerChannelSinkStack.xml +++ b/xml/System.Runtime.Remoting.Channels/ServerChannelSinkStack.xml @@ -39,9 +39,7 @@ + This class makes a link demand. A security exception is thrown if the immediate caller does not have infrastructure permission. ]]> diff --git a/xml/System.Runtime.Remoting.Channels/TransportHeaders.xml b/xml/System.Runtime.Remoting.Channels/TransportHeaders.xml index 2a1d0cb7823..8293a465686 100644 --- a/xml/System.Runtime.Remoting.Channels/TransportHeaders.xml +++ b/xml/System.Runtime.Remoting.Channels/TransportHeaders.xml @@ -42,7 +42,7 @@ ## Remarks You can use the `foreach` statement to iterate over the contents of the header list that contains objects of type . Keys to the headers are required to be strings, and comparisons are done on a case-insensitive basis. - This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). + This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. ]]> diff --git a/xml/System.Runtime.Remoting.Contexts/SynchronizationAttribute.xml b/xml/System.Runtime.Remoting.Contexts/SynchronizationAttribute.xml index 9dc9b10f652..bae459faa57 100644 --- a/xml/System.Runtime.Remoting.Contexts/SynchronizationAttribute.xml +++ b/xml/System.Runtime.Remoting.Contexts/SynchronizationAttribute.xml @@ -53,7 +53,7 @@ > There are two classes named `SynchronizationAttribute` : one in the namespace, and the other in the namespace. The class supports only synchronous calls, and can be used only with serviced components. The supports both synchronous and asynchronous calls, and can be used only with context bound objects. (For more information on context bound objects, see the class.) > [!NOTE] -> This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. diff --git a/xml/System.Runtime.Remoting.Lifetime/ClientSponsor.xml b/xml/System.Runtime.Remoting.Lifetime/ClientSponsor.xml index 412c9dc865a..98e5d736149 100644 --- a/xml/System.Runtime.Remoting.Lifetime/ClientSponsor.xml +++ b/xml/System.Runtime.Remoting.Lifetime/ClientSponsor.xml @@ -39,7 +39,7 @@ The current lifetime sponsor implementation can be used to sponsor objects by specifying the required renewal . > [!NOTE] -> This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. diff --git a/xml/System.Runtime.Remoting.Lifetime/LifetimeServices.xml b/xml/System.Runtime.Remoting.Lifetime/LifetimeServices.xml index 150592a42ea..a589417f1ad 100644 --- a/xml/System.Runtime.Remoting.Lifetime/LifetimeServices.xml +++ b/xml/System.Runtime.Remoting.Lifetime/LifetimeServices.xml @@ -37,9 +37,7 @@ The lifetime service associates a lease with each remotely activated object. When the lease expires, the object is removed. > [!NOTE] -> This class makes a link demand. A SecurityException is thrown if the immediate caller does not have infrastructure permission. See [Link Demands](/dotnet/framework/misc/link-demands) for more information. - - +> This class makes a link demand. A SecurityException is thrown if the immediate caller does not have infrastructure permission. ## Examples :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/System.Runtime.Remoting.Lifetime/CPP/server.cpp" id="Snippet2"::: diff --git a/xml/System.Runtime.Remoting.Messaging/CallContext.xml b/xml/System.Runtime.Remoting.Messaging/CallContext.xml index f61587bc5b1..8f071a4b856 100644 --- a/xml/System.Runtime.Remoting.Messaging/CallContext.xml +++ b/xml/System.Runtime.Remoting.Messaging/CallContext.xml @@ -44,9 +44,7 @@ > All methods in are static and operate on the call context in the current . > [!NOTE] -> This class makes a link demand. A `SecurityException` is thrown if the immediate caller does not have infrastructure permission. See [Link Demands](/dotnet/framework/misc/link-demands) for more information. - - +> This class makes a link demand. A `SecurityException` is thrown if the immediate caller does not have infrastructure permission. ## Examples The following code example demonstrates the use of the class to transmit [Principal and Identity Objects](/dotnet/standard/security/principal-and-identity-objects) to a remote location for identification. To view the code for the `LogicalCallContextData` class used in this sample, see the example for the interface. To view the code for the `HelloServiceClass` class used in this sample, see the example for the method. To view the code for the server class used in this sample, see the example for the class. diff --git a/xml/System.Runtime.Remoting.Messaging/LogicalCallContext.xml b/xml/System.Runtime.Remoting.Messaging/LogicalCallContext.xml index f9fc4071b50..8a9506eab21 100644 --- a/xml/System.Runtime.Remoting.Messaging/LogicalCallContext.xml +++ b/xml/System.Runtime.Remoting.Messaging/LogicalCallContext.xml @@ -48,9 +48,7 @@ When a remote method call is made to an object in another , the class generates a that travels along with the remote call. Only objects that expose the interface and are stored in the are propagated outside the in a . Objects that do not support this interface are not transmitted in instances with remote method calls. > [!NOTE] -> This class makes a link demand. A SecurityException is thrown if the immediate caller does not have infrastructure permission. See [Link Demands](/dotnet/framework/misc/link-demands) for more information. - - ]]> +> This class makes a link demand. A SecurityException is thrown if the immediate caller does not have infrastructure permission. ]]> diff --git a/xml/System.Runtime.Remoting.Messaging/RemotingSurrogateSelector.xml b/xml/System.Runtime.Remoting.Messaging/RemotingSurrogateSelector.xml index 3f96e22143a..9737729121f 100644 --- a/xml/System.Runtime.Remoting.Messaging/RemotingSurrogateSelector.xml +++ b/xml/System.Runtime.Remoting.Messaging/RemotingSurrogateSelector.xml @@ -41,7 +41,7 @@ During serialization for remoting purposes of a , the remoting surrogate creates an that contains all the relevant information required to activate and communicate with the remote object. The newly created can then be sent to a remote location and used to create a proxy. > [!NOTE] -> This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. ]]> diff --git a/xml/System.Runtime.Remoting.Messaging/ReturnMessage.xml b/xml/System.Runtime.Remoting.Messaging/ReturnMessage.xml index 4cd41ad4f6c..6d7c33b2c6f 100644 --- a/xml/System.Runtime.Remoting.Messaging/ReturnMessage.xml +++ b/xml/System.Runtime.Remoting.Messaging/ReturnMessage.xml @@ -44,7 +44,7 @@ ## Remarks > [!NOTE] -> This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. diff --git a/xml/System.Runtime.Remoting.Proxies/ProxyAttribute.xml b/xml/System.Runtime.Remoting.Proxies/ProxyAttribute.xml index 119a19ceb42..a0ccb71c735 100644 --- a/xml/System.Runtime.Remoting.Proxies/ProxyAttribute.xml +++ b/xml/System.Runtime.Remoting.Proxies/ProxyAttribute.xml @@ -43,7 +43,7 @@ Apply the current attribute to types that need custom proxies. You can use the ProxyAttribute class to intercept the `new` (`New` in Visual Basic) statement by deriving from the ProxyAttribute and placing the attribute on a child of `ContextBoundObject`. (Placing the proxy attribute on a child of `MarshalByRefObject` is not supported.) > [!NOTE] -> This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. diff --git a/xml/System.Runtime.Remoting.Proxies/RealProxy.xml b/xml/System.Runtime.Remoting.Proxies/RealProxy.xml index a146cdcb308..da22d5b776e 100644 --- a/xml/System.Runtime.Remoting.Proxies/RealProxy.xml +++ b/xml/System.Runtime.Remoting.Proxies/RealProxy.xml @@ -42,7 +42,7 @@ A proxy object can be used without regard to any remoting subdivisions within a . > [!NOTE] -> This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. @@ -324,7 +324,7 @@ if the object reference is requested for marshaling to a remote location; if the object reference is requested for communication with unmanaged objects in the current process through COM. Requests an unmanaged reference to the object represented by the current proxy instance. - A pointer to a COM Callable Wrapper if the object reference is requested for communication with unmanaged objects in the current process through COM, or a pointer to a cached or newly generated COM interface if the object reference is requested for marshaling to a remote location. + A pointer to a COM Callable Wrapper if the object reference is requested for communication with unmanaged objects in the current process through COM, or a pointer to a cached or newly generated COM interface if the object reference is requested for marshaling to a remote location. [!NOTE] -> This class makes a link demand. A SecurityException is thrown if the immediate caller does not have infrastructure permission. See [Link Demands](/dotnet/framework/misc/link-demands) for more information. - - ]]> +> This class makes a link demand. A SecurityException is thrown if the immediate caller does not have infrastructure permission. ]]> @@ -124,7 +122,7 @@ A proxy that represents the old instance of a class that is referenced by a CCW. A proxy that represents the new instance of a class that is referenced by a CCW. - Switches a COM Callable Wrapper (CCW) from one instance of a class to another instance of the same class. + Switches a COM Callable Wrapper (CCW) from one instance of a class to another instance of the same class. Indicates that the implementing object must be notified of marshaling, unmarshaling, and disconnection of objects and proxies by the remoting infrastructure. - is called by remoting when an object or proxy in the current is marshaled, unmarshaled, or disconnected. - - Note that only objects can be disconnected. An exception is thrown when disconnect is called on a proxy. - + is called by remoting when an object or proxy in the current is marshaled, unmarshaled, or disconnected. + +Only objects can be disconnected. An exception is thrown when disconnect is called on a proxy. + > [!NOTE] -> This interface makes a link demand. A SecurityException is thrown if the immediate caller makes the call through a reference to the interface and does not have infrastructure permission. See [Link Demands](/dotnet/framework/misc/link-demands) for more information. - - - -## Examples - The following code example shows how to implement the methods of the interface to receive notifications from the remoting infrastructure. - - The following code example shows how to implement this interface. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/trackinghandler.cs" id="Snippet30"::: - - The following code example shows how to implement this interface on a server. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/server.cs" id="Snippet20"::: - - The following code example shows how to implement this interface on a client for the server in the preceding code example. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/client.cs" id="Snippet0"::: - - The following code example shows the remote object that is used by the server and the client. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/remoteservice.cs" id="Snippet10"::: - +> This interface makes a link demand. A SecurityException is thrown if the immediate caller makes the call through a reference to the interface and does not have infrastructure permission. + +## Examples + The following code example shows how to implement the methods of the interface to receive notifications from the remoting infrastructure. + + The following code example shows how to implement this interface. + + :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/trackinghandler.cs" id="Snippet30"::: + + The following code example shows how to implement this interface on a server. + + :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/server.cs" id="Snippet20"::: + + The following code example shows how to implement this interface on a client for the server in the preceding code example. + + :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/client.cs" id="Snippet0"::: + + The following code example shows the remote object that is used by the server and the client. + + :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/remoteservice.cs" id="Snippet10"::: + ]]> @@ -87,13 +86,13 @@ The disconnected object. Notifies the current instance that an object has been disconnected from its proxy. - interface. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/trackinghandler.cs" id="Snippet33"::: - + interface. + + :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/trackinghandler.cs" id="Snippet33"::: + ]]> @@ -130,13 +129,13 @@ The that results from marshaling and represents the specified object. Notifies the current instance that an object has been marshaled. - interface. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/trackinghandler.cs" id="Snippet31"::: - + interface. + + :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/trackinghandler.cs" id="Snippet31"::: + ]]> @@ -173,13 +172,13 @@ The that represents the specified object. Notifies the current instance that an object has been unmarshaled. - interface. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/trackinghandler.cs" id="Snippet32"::: - + interface. + + :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/trackinghandler.cs" id="Snippet32"::: + ]]> diff --git a/xml/System.Runtime.Remoting.Services/TrackingServices.xml b/xml/System.Runtime.Remoting.Services/TrackingServices.xml index 9dc72bd790f..889c3dc8acb 100644 --- a/xml/System.Runtime.Remoting.Services/TrackingServices.xml +++ b/xml/System.Runtime.Remoting.Services/TrackingServices.xml @@ -29,37 +29,35 @@ Provides a way to register, unregister, and obtain a list of tracking handlers. - interface, indicating that they must be notified whenever the remoting infrastructure marshals, unmarshals, or disconnects an object or proxy. Every object that is registered with is called by remoting when an object or proxy in the current is marshaled, unmarshaled, or disconnected. - - All methods in the class are static and operate on the tracking handlers in the current . - + interface, indicating that they must be notified whenever the remoting infrastructure marshals, unmarshals, or disconnects an object or proxy. Every object that is registered with is called by remoting when an object or proxy in the current is marshaled, unmarshaled, or disconnected. + + All methods in the class are static and operate on the tracking handlers in the current . + > [!NOTE] -> This class makes a link demand. A SecurityException is thrown if the immediate caller does not have infrastructure permission. See [Link Demands](/dotnet/framework/misc/link-demands) for more information. - - - -## Examples - The following code example shows how to use the methods of the class to register and unregister tracking handlers. - - The following code example shows how to implement a tracking handler. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/trackinghandler.cs" id="Snippet30"::: - - The following code example shows how to implement this class on a server. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/server.cs" id="Snippet20"::: - - The following code example shows how to implement this class on a client for the server in the preceding code example. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/client.cs" id="Snippet0"::: - - The following code example shows the remote object that is used by the server and the client. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/remoteservice.cs" id="Snippet10"::: - +> This class makes a link demand. A SecurityException is thrown if the immediate caller does not have infrastructure permission. + +## Examples + The following code example shows how to use the methods of the class to register and unregister tracking handlers. + + The following code example shows how to implement a tracking handler. + + :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/trackinghandler.cs" id="Snippet30"::: + + The following code example shows how to implement this class on a server. + + :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/server.cs" id="Snippet20"::: + + The following code example shows how to implement this class on a client for the server in the preceding code example. + + :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/client.cs" id="Snippet0"::: + + The following code example shows the remote object that is used by the server and the client. + + :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/remoteservice.cs" id="Snippet10"::: + ]]> @@ -111,13 +109,13 @@ Gets an array of the tracking handlers that are currently registered with in the current . An array of the tracking handlers that are currently registered with in the current . - class. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/server.cs" id="Snippet22"::: - + class. + + :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/server.cs" id="Snippet22"::: + ]]> @@ -152,13 +150,13 @@ The tracking handler to register. Registers a new tracking handler with the . - class. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/server.cs" id="Snippet21"::: - + class. + + :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/server.cs" id="Snippet21"::: + ]]> @@ -196,13 +194,13 @@ The handler to unregister. Unregisters the specified tracking handler from . - class. - - :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/server.cs" id="Snippet23"::: - + class. + + :::code language="csharp" source="~/snippets/csharp/System.Runtime.Remoting.Services/ITrackingHandler/Overview/server.cs" id="Snippet23"::: + ]]> diff --git a/xml/System.Runtime.Remoting/ObjRef.xml b/xml/System.Runtime.Remoting/ObjRef.xml index bf54010a2cd..fe9d1735f4c 100644 --- a/xml/System.Runtime.Remoting/ObjRef.xml +++ b/xml/System.Runtime.Remoting/ObjRef.xml @@ -53,7 +53,7 @@ A proxy object can be used without regard to any remoting subdivisions within a . Applications need not distinguish between proxy references and object references. However, service providers dealing with issues such as activation, lifetime management, and transactions need to make such distinctions. - This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). + This class makes a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. diff --git a/xml/System.Runtime.Remoting/SoapServices.xml b/xml/System.Runtime.Remoting/SoapServices.xml index 91916afb424..7478036b904 100644 --- a/xml/System.Runtime.Remoting/SoapServices.xml +++ b/xml/System.Runtime.Remoting/SoapServices.xml @@ -32,9 +32,7 @@ class to convert between a object and an XML type. diff --git a/xml/System.Runtime.Serialization/FormatterServices.xml b/xml/System.Runtime.Serialization/FormatterServices.xml index e8c58576db5..da38b131191 100644 --- a/xml/System.Runtime.Serialization/FormatterServices.xml +++ b/xml/System.Runtime.Serialization/FormatterServices.xml @@ -257,7 +257,7 @@ ## Remarks Because the new instance of the object is initialized to zero and no constructors are run, the object might not represent a state that is regarded as valid by that object. should only be used for deserialization when the user intends to immediately populate all fields. It does not create an uninitialized string, since creating an empty instance of an immutable type serves no purpose. - converts all class level [Link Demands](/dotnet/framework/misc/link-demands) to Demands to ensure that all direct and indirect callers have the permissions that the demand specifies. Use to increase the level of security when deserializing from a partially trusted source. For better performance in full trust scenarios, use . + converts all class level Link Demands to Demands to ensure that all direct and indirect callers have the permissions that the demand specifies. Use to increase the level of security when deserializing from a partially trusted source. For better performance in full trust scenarios, use . ]]> diff --git a/xml/System.Runtime.Versioning/RequiresPreviewFeaturesAttribute.xml b/xml/System.Runtime.Versioning/RequiresPreviewFeaturesAttribute.xml index e865311dae2..ed076e2a606 100644 --- a/xml/System.Runtime.Versioning/RequiresPreviewFeaturesAttribute.xml +++ b/xml/System.Runtime.Versioning/RequiresPreviewFeaturesAttribute.xml @@ -36,7 +36,7 @@ If you want to ship preview functionality in your own libraries, use instead. -For more information about marking APIs as preview, see [Preview APIs](/dotnet/fundamentals/apicompat/preview-apis). +For more information about marking APIs as preview, see [Preview APIs](/dotnet/fundamentals/runtime-libraries/preview-apis). ]]> Preview Features diff --git a/xml/System.Security.Cryptography/CryptoStream.xml b/xml/System.Security.Cryptography/CryptoStream.xml index 72e4970e68b..993ea7c0cab 100644 --- a/xml/System.Security.Cryptography/CryptoStream.xml +++ b/xml/System.Security.Cryptography/CryptoStream.xml @@ -1089,7 +1089,7 @@ Flushing the stream will not flush its underlying encoder unless you explicitly with the `await` (C#) or `Await` (Visual Basic) operator to suspend execution of the method until the task is complete. For more information, see [Asynchronous programming (C#)](/dotnet/csharp/async) or [Asynchronous programming with Async and Await (Visual Basic)](/dotnet/visual-basic/programming-guide/concepts/async/). +You must preface your call to with the `await` (C#) or `Await` (Visual Basic) operator to suspend execution of the method until the task is complete. For more information, see [Asynchronous programming (C#)](/dotnet/csharp/asynchronous-programming/) or [Asynchronous programming with Async and Await (Visual Basic)](/dotnet/visual-basic/programming-guide/concepts/async/). If the operation is canceled before it completes, the returned task contains the value for the property. @@ -1519,7 +1519,7 @@ This property exists only to support inheritance from , a > [!IMPORTANT] > Starting in .NET 6, this method might not read as many bytes as were requested. For more information, see [Partial and zero-byte reads in DeflateStream, GZipStream, and CryptoStream](/dotnet/core/compatibility/core-libraries/6.0/partial-byte-reads-in-streams). -You must preface your call to with the `await` (C#) or `Await` (Visual Basic) operator to suspend execution of the method until the task is complete. For more information, see [Asynchronous programming (C#)](/dotnet/csharp/async) or [Asynchronous programming with Async and Await (Visual Basic)](/dotnet/visual-basic/programming-guide/concepts/async/). +You must preface your call to with the `await` (C#) or `Await` (Visual Basic) operator to suspend execution of the method until the task is complete. For more information, see [Asynchronous programming (C#)](/dotnet/csharp/asynchronous-programming/) or [Asynchronous programming with Async and Await (Visual Basic)](/dotnet/visual-basic/programming-guide/concepts/async/). If the operation is canceled before it completes, the returned task contains the value for the property. @@ -1902,7 +1902,7 @@ This member is an explicit interface member implementation. It can be used only with the `await` (C#) or `Await` (Visual Basic) operator to suspend execution of the method until the task is complete. For more information, see [Asynchronous programming (C#)](/dotnet/csharp/async) or [Asynchronous programming with Async and Await (Visual Basic)](/dotnet/visual-basic/programming-guide/concepts/async/). +You must preface your call to with the `await` (C#) or `Await` (Visual Basic) operator to suspend execution of the method until the task is complete. For more information, see [Asynchronous programming (C#)](/dotnet/csharp/asynchronous-programming/) or [Asynchronous programming with Async and Await (Visual Basic)](/dotnet/visual-basic/programming-guide/concepts/async/). If the operation is canceled before it completes, the returned task contains the value for the property. diff --git a/xml/System.Security.Permissions/HostProtectionAttribute.xml b/xml/System.Security.Permissions/HostProtectionAttribute.xml index fbf42eef1be..128a9fc5e42 100644 --- a/xml/System.Security.Permissions/HostProtectionAttribute.xml +++ b/xml/System.Security.Permissions/HostProtectionAttribute.xml @@ -81,7 +81,6 @@ ]]> Extending Metadata Using Attributes - Link Demands diff --git a/xml/System.Security.Permissions/SecurityAction.xml b/xml/System.Security.Permissions/SecurityAction.xml index 9407fa20051..8fb069f7fcf 100644 --- a/xml/System.Security.Permissions/SecurityAction.xml +++ b/xml/System.Security.Permissions/SecurityAction.xml @@ -168,7 +168,7 @@ 3 - The calling code can access the resource identified by the current permission object, even if callers higher in the stack have not been granted permission to access the resource (see Using the Assert Method). + The calling code can access the resource identified by the current permission object, even if callers higher in the stack have not been granted permission to access the resource. diff --git a/xml/System.Security/SecurityException.xml b/xml/System.Security/SecurityException.xml index 587f86a9fbb..2d7b5a486f3 100644 --- a/xml/System.Security/SecurityException.xml +++ b/xml/System.Security/SecurityException.xml @@ -864,7 +864,7 @@ because it can contain a permission, a permission set, or a permission set collection. To test the run-time type of this property, you can use the method or a specific language operator, such as the [is operator](/dotnet/csharp/language-reference/keywords/is) in C# or the [TypeOf operator](/dotnet/visual-basic/language-reference/operators/typeof-operator) in Visual Basic. + This property contains the denied permission, permission set, or permission set collection that caused the security check to fail. It is `null` for exceptions that are not caused by a Deny. The property is of type because it can contain a permission, a permission set, or a permission set collection. To test the run-time type of this property, you can use the method or a specific language operator, such as the [is operator](/dotnet/csharp/language-reference/operators/is) in C# or the [TypeOf operator](/dotnet/visual-basic/language-reference/operators/typeof-operator) in Visual Basic. ]]> @@ -1365,7 +1365,7 @@ ## Remarks The property represents the permitted permission, permission set, or permission set collection contained in the stack frame that caused the security exception. For instance, when a security exception occurs because of a failure, the permitted permission appears in this property and the demanded is contained in the property. - This property is of type because permissions, permission sets, or permission set collections can all be demanded and is their common base class. To test the run-time type of this property, you can use the method or a specific language operator, such as the [is operator](/dotnet/csharp/language-reference/keywords/is) in C# or the [TypeOf operator](/dotnet/visual-basic/language-reference/operators/typeof-operator) in Visual Basic. + This property is of type because permissions, permission sets, or permission set collections can all be demanded and is their common base class. To test the run-time type of this property, you can use the method or a specific language operator, such as the [is operator](/dotnet/csharp/language-reference/operators/is) in C# or the [TypeOf operator](/dotnet/visual-basic/language-reference/operators/typeof-operator) in Visual Basic. ]]> diff --git a/xml/System.Text/Encoding.xml b/xml/System.Text/Encoding.xml index 92684abc1b4..63575c8148d 100644 --- a/xml/System.Text/Encoding.xml +++ b/xml/System.Text/Encoding.xml @@ -4130,7 +4130,7 @@ In .NET 5 and later versions, the code page name `utf-7` is not supported. To calculate the exact array size required by to store the resulting bytes, you should use the method. To calculate the maximum array size, use the method. The method generally allows allocation of less memory, while the method generally executes faster. - retrieves a worst-case number, including the worst case for the currently selected . If a fallback is chosen with a potentially large string, retrieves large values, particularly in cases where the worst case for the encoding involves switching modes for every character. For example, this can happen for ISO-2022-JP. For more information, see the blog post "[What's with Encoding.GetMaxByteCount() and Encoding.GetMaxCharCount()?](https://learn.microsoft.com/en-us/archive/blogs/shawnste/whats-with-encoding-getmaxbytecount-and-encoding-getmaxcharcount). + retrieves a worst-case number, including the worst case for the currently selected . If a fallback is chosen with a potentially large string, retrieves large values, particularly in cases where the worst case for the encoding involves switching modes for every character. For example, this can happen for ISO-2022-JP. For more information, see the blog post [What's with Encoding.GetMaxByteCount() and Encoding.GetMaxCharCount()?](https://learn.microsoft.com/archive/blogs/shawnste/whats-with-encoding-getmaxbytecount-and-encoding-getmaxcharcount). In most cases, this method retrieves reasonable values for small strings. For large strings, you might have to choose between using very large buffers and catching errors in the rare case when a more reasonable buffer is too small. You might also want to consider a different approach using or . diff --git a/xml/System.Threading/AutoResetEvent.xml b/xml/System.Threading/AutoResetEvent.xml index e652e0f4cfd..48810ccf590 100644 --- a/xml/System.Threading/AutoResetEvent.xml +++ b/xml/System.Threading/AutoResetEvent.xml @@ -65,7 +65,7 @@ ## Remarks -You use `AutoResetEvent`, , and for thread interaction (or thread signaling). For more information, see [Thread interaction](/dotnet/standard/threading/overview-of-synchronization-primitives#thread-interaction-or-signaling). +You use `AutoResetEvent`, , and for thread interaction (or thread signaling). For more information, see [Thread interaction](/dotnet/standard/threading/managed-threading-basicsoverview-of-synchronization-primitives#thread-interaction-or-signaling). A thread waits for a signal by calling [AutoResetEvent.WaitOne](xref:System.Threading.WaitHandle.WaitOne%2A). If the `AutoResetEvent` is in the non-signaled state, the thread blocks until [AutoResetEvent.Set](xref:System.Threading.EventWaitHandle.Set%2A) is called. Calling `Set` signals `AutoResetEvent` to release a waiting thread. `AutoResetEvent` remains signaled until `Reset` is called or a single waiting thread is released, at which time it automatically returns to the non-signaled state. @@ -99,8 +99,8 @@ After the threads are released from the first This class is thread safe. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -169,8 +169,8 @@ After the threads are released from the first - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives diff --git a/xml/System.Threading/EventWaitHandle.xml b/xml/System.Threading/EventWaitHandle.xml index 16f3e53ec1a..8e0a1ca5f48 100644 --- a/xml/System.Threading/EventWaitHandle.xml +++ b/xml/System.Threading/EventWaitHandle.xml @@ -75,7 +75,7 @@ The class allows threads to communicate objects can be used with the `static`(`Shared` in Visual Basic) and methods. - For more information, see the [Thread interaction, or signaling](/dotnet/standard/threading/overview-of-synchronization-primitives#thread-interaction-or-signaling) section of the [Overview of synchronization primitives](/dotnet/standard/threading/overview-of-synchronization-primitives) article. + For more information, see the [Thread interaction, or signaling](/dotnet/standard/threading/managed-threading-basicsoverview-of-synchronization-primitives#thread-interaction-or-signaling) section of the [Overview of synchronization primitives](/dotnet/standard/threading/managed-threading-basicsoverview-of-synchronization-primitives) article. > [!CAUTION] > By default, a named event is not restricted to the user that created it. Other users might be able to open and use the event, including interfering with the event by setting or resetting it inappropriately. To restrict access to specific users, you can use a constructor overload or and pass in an when creating the named event. Avoid using named events without access restrictions on systems that might have untrusted users running code. @@ -94,8 +94,8 @@ The class allows threads to communicate - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -175,7 +175,7 @@ The class allows threads to communicate ]]> The enum value was out of legal range. - Overview of synchronization primitives + Overview of synchronization primitives @@ -266,7 +266,7 @@ There was some other error. The `HResult` property might provide more informatio -or- .NET Framework only: is longer than MAX_PATH (260 characters). - Overview of synchronization primitives + Overview of synchronization primitives @@ -356,7 +356,7 @@ There was some other error. The `HResult` property might provide more informatio -or- .NET Framework only: is longer than MAX_PATH (260 characters). - Overview of synchronization primitives + Overview of synchronization primitives @@ -425,7 +425,7 @@ There was some other error. The `HResult` property might provide more informatio An object with the specified exists, but the specified are not compatible with the existing object's options. The enum value was out of legal range. - Overview of synchronization primitives + Overview of synchronization primitives @@ -522,7 +522,7 @@ There was some other error. The `HResult` property might provide more informatio -or- .NET Framework only: is longer than MAX_PATH (260 characters). - Overview of synchronization primitives + Overview of synchronization primitives @@ -591,7 +591,7 @@ There was some other error. The `HResult` property might provide more informatio An object with the specified exists, but the specified are not compatible with the existing object's options. The enum value was out of legal range. - Overview of synchronization primitives + Overview of synchronization primitives @@ -655,7 +655,7 @@ An object with the specified exists, but the specified The current object represents a named system event, and was not opened with . The method was previously called on this . - Overview of synchronization primitives + Overview of synchronization primitives @@ -759,7 +759,7 @@ There was some other error. The `HResult` property might provide more informatio Windows only: specified an unknown namespace. See Object Names for more information. The is too long. Length restrictions might depend on the operating system or configuration. The named event exists, but the user does not have the security access required to use it. - Overview of synchronization primitives + Overview of synchronization primitives @@ -845,7 +845,7 @@ There was some other error. The `HResult` property might provide more informatio Windows only: specified an unknown namespace. See Object Names for more information. The is too long. Length restrictions might depend on the operating system or configuration. The named event exists, but the user does not have the desired security access. - Overview of synchronization primitives + Overview of synchronization primitives @@ -914,7 +914,7 @@ There was some other error. The `HResult` property might provide more informatio Windows only: specified an unknown namespace. See Object Names for more information. The is too long. Length restrictions might depend on the operating system or configuration. The named event exists, but the user does not have the security access required to use it. - Overview of synchronization primitives + Overview of synchronization primitives @@ -967,7 +967,7 @@ There was some other error. The `HResult` property might provide more informatio if the operation succeeds; otherwise, . To be added. The method was previously called on this . - Overview of synchronization primitives + Overview of synchronization primitives @@ -1040,7 +1040,7 @@ There was some other error. The `HResult` property might provide more informatio ]]> The method was previously called on this . - Overview of synchronization primitives + Overview of synchronization primitives @@ -1107,7 +1107,7 @@ There was some other error. The `HResult` property might provide more informatio The event was not opened with . The current object does not represent a named system event. The method was previously called on this . - Overview of synchronization primitives + Overview of synchronization primitives diff --git a/xml/System.Threading/Interlocked.xml b/xml/System.Threading/Interlocked.xml index c4577649a29..d9338a3cc1c 100644 --- a/xml/System.Threading/Interlocked.xml +++ b/xml/System.Threading/Interlocked.xml @@ -91,8 +91,8 @@ ]]> This type is thread safe. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -171,8 +171,8 @@ ]]> The address of is a null pointer. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -243,8 +243,8 @@ - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -674,8 +674,8 @@ ]]> The address of is a null pointer. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -793,8 +793,8 @@ ]]> The address of is a null pointer. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -860,8 +860,8 @@ ]]> The address of is a null pointer. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -934,8 +934,8 @@ ]]> The address of is a null pointer. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -1013,8 +1013,8 @@ If `comparand` and the object in `location1` are equal by reference, then `value ]]> - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives The address of is a pointer. @@ -1136,8 +1136,8 @@ If `comparand` and the object in `location1` are equal by reference, then `value ]]> The address of is a null pointer. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -1508,8 +1508,8 @@ If `comparand` and the value in `location1` are equal by reference, then `value` ]]> The address of is a pointer. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives The address of is a pointer. @@ -1576,8 +1576,8 @@ If `comparand` and the value in `location1` are equal by reference, then `value` - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives The address of is a pointer. @@ -1770,8 +1770,8 @@ If `comparand` and the value in `location1` are equal by reference, then `value` The original value of . To be added. The address of is a pointer. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -1879,8 +1879,8 @@ If `comparand` and the value in `location1` are equal by reference, then `value` ]]> The address of is a pointer. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives The address of is a pointer. @@ -1938,8 +1938,8 @@ If `comparand` and the value in `location1` are equal by reference, then `value` The original value of . To be added. The address of is a pointer. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -2000,8 +2000,8 @@ If `comparand` and the value in `location1` are equal by reference, then `value` The original value of . To be added. The address of is a pointer. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -2080,8 +2080,8 @@ If `comparand` and the value in `location1` are equal by reference, then `value` ]]> The address of is a pointer. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives The address of is a pointer. @@ -2182,8 +2182,8 @@ If `comparand` and the value in `location1` are equal by reference, then `value` The original value of . To be added. The address of is a pointer. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -2543,8 +2543,8 @@ If `comparand` and the value in `location1` are equal by reference, then `value` ]]> The address of is a pointer. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -2614,8 +2614,8 @@ If `comparand` and the value in `location1` are equal by reference, then `value` - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -3098,8 +3098,8 @@ This method wraps a call to [FlushProcessWriteBuffers](/windows/win32/api/proces - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives diff --git a/xml/System.Threading/Lock.xml b/xml/System.Threading/Lock.xml index 4bd546efd2f..f1b20efba3a 100644 --- a/xml/System.Threading/Lock.xml +++ b/xml/System.Threading/Lock.xml @@ -32,7 +32,7 @@ It is recommended to use the method wit :::code language="csharp" source="~/snippets/csharp/System.Threading/Lock/Overview/UsagePatterns.cs" id="Snippet1"::: -When using the C# `lock` keyword or similar to enter and exit a lock, the type of the expression must be precisely `System.Threading.Lock`. If the type of the expression is anything else, such as `Object` or a generic type like `T`, a different implementation that is not interchangeable can be used instead (such as ). For more information, see the relevant [compiler speclet](https://learn.microsoft.com/en-us/dotnet/csharp/language-reference/proposals/csharp-13.0/lock-object). +When using the C# `lock` keyword or similar to enter and exit a lock, the type of the expression must be precisely `System.Threading.Lock`. If the type of the expression is anything else, such as `Object` or a generic type like `T`, a different implementation that is not interchangeable can be used instead (such as ). For more information, see the relevant [compiler speclet](https://learn.microsoft.com/dotnet/csharp/language-reference/proposals/csharp-13.0/lock-object). can interrupt threads that are waiting to enter a lock. On Windows STA threads, waits for locks allow message pumping that can run other code on the same thread during a wait. Some features of the waits can be overridden by a custom . diff --git a/xml/System.Threading/LockCookie.xml b/xml/System.Threading/LockCookie.xml index 85cd60ba3aa..d78027f2f11 100644 --- a/xml/System.Threading/LockCookie.xml +++ b/xml/System.Threading/LockCookie.xml @@ -83,8 +83,8 @@ This type is thread safe. - Managed Threading - Reader-Writer Locks + Managed Threading + Reader-Writer Locks diff --git a/xml/System.Threading/ManualResetEvent.xml b/xml/System.Threading/ManualResetEvent.xml index bc87a85f3c5..15da134bb08 100644 --- a/xml/System.Threading/ManualResetEvent.xml +++ b/xml/System.Threading/ManualResetEvent.xml @@ -65,7 +65,7 @@ ## Remarks - You use `ManualResetEvent`, , and for thread interaction (or thread signaling). For more information, see the [Thread interaction, or signaling](/dotnet/standard/threading/overview-of-synchronization-primitives#thread-interaction-or-signaling) section of the [Overview of synchronization primitives](/dotnet/standard/threading/overview-of-synchronization-primitives) article. + You use `ManualResetEvent`, , and for thread interaction (or thread signaling). For more information, see the [Thread interaction, or signaling](/dotnet/standard/threading/managed-threading-basicsoverview-of-synchronization-primitives#thread-interaction-or-signaling) section of the [Overview of synchronization primitives](/dotnet/standard/threading/managed-threading-basicsoverview-of-synchronization-primitives) article. When a thread begins an activity that must complete before other threads proceed, it calls [ManualResetEvent.Reset](xref:System.Threading.EventWaitHandle.Reset%2A) to put `ManualResetEvent` in the non-signaled state. This thread can be thought of as controlling the `ManualResetEvent`. Threads that call [ManualResetEvent.WaitOne](xref:System.Threading.WaitHandle.WaitOne%2A) block, awaiting the signal. When the controlling thread completes the activity, it calls [ManualResetEvent.Set](xref:System.Threading.EventWaitHandle.Set%2A) to signal that the waiting threads can proceed. All waiting threads are released. @@ -98,8 +98,8 @@ This class is thread safe. - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives @@ -159,8 +159,8 @@ ]]> - Managed Threading - Overview of synchronization primitives + Managed Threading + Overview of synchronization primitives diff --git a/xml/System.Threading/Monitor.xml b/xml/System.Threading/Monitor.xml index 113289971f3..7f5d3046035 100644 --- a/xml/System.Threading/Monitor.xml +++ b/xml/System.Threading/Monitor.xml @@ -65,8 +65,8 @@ For more information about this API, see Supplemental API remarks for Monitor. This type is thread safe. - Managed Threading - Threading Objects and Features + Managed Threading + Threading Objects and Features @@ -155,7 +155,7 @@ The parameter is . - Managed Threading + Managed Threading @@ -316,7 +316,7 @@ The current thread does not own the lock for the specified object. - Managed Threading + Managed Threading @@ -491,7 +491,7 @@ The calling thread does not own the lock for the specified object. - Managed Threading + Managed Threading @@ -564,7 +564,7 @@ The calling thread does not own the lock for the specified object. - Managed Threading + Managed Threading @@ -652,7 +652,7 @@ The parameter is . - Managed Threading + Managed Threading @@ -815,7 +815,7 @@ is negative, and not equal to . - Managed Threading + Managed Threading @@ -885,7 +885,7 @@ The parameter is . The value of in milliseconds is negative and is not equal to (-1 millisecond), or is greater than Int32.MaxValue. - Managed Threading + Managed Threading @@ -1050,7 +1050,7 @@ The parameter is . The value of in milliseconds is negative and is not equal to (-1 millisecond), or is greater than Int32.MaxValue. - Managed Threading + Managed Threading @@ -1145,7 +1145,7 @@ The thread that invokes is later interrupted from the waiting state. This happens when another thread calls this thread's method. - Managed Threading + Managed Threading @@ -1238,7 +1238,7 @@ The value of the parameter is negative, and is not equal to . - Managed Threading + Managed Threading @@ -1331,7 +1331,7 @@ The value of the parameter in milliseconds is negative and does not represent (-1 millisecond), or is greater than Int32.MaxValue. - Managed Threading + Managed Threading @@ -1401,7 +1401,7 @@ The value of the parameter is negative, and is not equal to . - Managed Threading + Managed Threading @@ -1467,7 +1467,7 @@ The parameter is negative and does not represent (-1 millisecond), or is greater than Int32.MaxValue. - Managed Threading + Managed Threading diff --git a/xml/System.Threading/Mutex.xml b/xml/System.Threading/Mutex.xml index ef1b956106d..2a9d4605f37 100644 --- a/xml/System.Threading/Mutex.xml +++ b/xml/System.Threading/Mutex.xml @@ -115,8 +115,8 @@ This type is thread safe. - Managed Threading - Mutexes + Managed Threading + Mutexes @@ -193,8 +193,8 @@ ]]> - Managed Threading - Mutexes + Managed Threading + Mutexes @@ -260,8 +260,8 @@ ]]> - Managed Threading - Mutexes + Managed Threading + Mutexes @@ -369,8 +369,8 @@ There was some other error. The `HResult` property might provide more informatio A synchronization object with the provided cannot be created. A synchronization object of a different type might have the same name. .NET Framework only: is longer than MAX_PATH (260 characters). - Managed Threading - Mutexes + Managed Threading + Mutexes @@ -432,8 +432,8 @@ There was some other error. The `HResult` property might provide more informatio -or- An object with the specified exists, but the specified are not compatible with the existing object's options. - Managed Threading - Mutexes + Managed Threading + Mutexes @@ -539,8 +539,8 @@ There was some other error. The `HResult` property might provide more informatio A synchronization object with the provided cannot be created. A synchronization object of a different type might have the same name. .NET Framework only: is longer than MAX_PATH (260 characters). - Managed Threading - Mutexes + Managed Threading + Mutexes @@ -605,8 +605,8 @@ There was some other error. The `HResult` property might provide more informatio -or- An object with the specified exists, but the specified are not compatible with the existing object's options. - Managed Threading - Mutexes + Managed Threading + Mutexes @@ -777,8 +777,8 @@ There was some other error. The `HResult` property might provide more informatio -or- An object with the specified exists, but the specified are not compatible with the existing object's options. - Managed Threading - Mutexes + Managed Threading + Mutexes @@ -1194,8 +1194,8 @@ There was some other error. The `HResult` property might provide more informatio The calling thread does not own the mutex. The current instance has already been disposed. - Managed Threading - Mutexes + Managed Threading + Mutexes diff --git a/xml/System.Threading/ReaderWriterLock.xml b/xml/System.Threading/ReaderWriterLock.xml index ea2c574c06c..b53a91c7310 100644 --- a/xml/System.Threading/ReaderWriterLock.xml +++ b/xml/System.Threading/ReaderWriterLock.xml @@ -105,8 +105,8 @@ ]]> This type is thread safe. - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -165,8 +165,8 @@ ]]> - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -264,8 +264,8 @@ expires before the lock request is granted. - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -341,8 +341,8 @@ expires before the lock request is granted. specifies a negative value other than -1 milliseconds. - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -436,8 +436,8 @@ expires before the lock request is granted. - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -511,8 +511,8 @@ expires before the lock request is granted. specifies a negative value other than -1 milliseconds. - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -589,8 +589,8 @@ ]]> - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -670,8 +670,8 @@ The thread does not have the writer lock. The address of is a null pointer. - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -779,8 +779,8 @@ ]]> - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -844,8 +844,8 @@ ]]> - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -916,8 +916,8 @@ ]]> - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -995,8 +995,8 @@ ]]> The thread does not have any reader or writer locks. - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -1074,8 +1074,8 @@ ]]> The thread does not have the writer lock. - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -1160,8 +1160,8 @@ ]]> The address of is a null pointer. - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -1260,8 +1260,8 @@ expires before the lock request is granted. - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -1334,8 +1334,8 @@ expires before the lock request is granted. specifies a negative value other than -1 milliseconds. - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock @@ -1409,8 +1409,8 @@ ]]> - Managed Threading - ReaderWriterLock + Managed Threading + ReaderWriterLock diff --git a/xml/System.Threading/Semaphore.xml b/xml/System.Threading/Semaphore.xml index c2eea74bd26..a29fb779517 100644 --- a/xml/System.Threading/Semaphore.xml +++ b/xml/System.Threading/Semaphore.xml @@ -89,8 +89,8 @@ ]]> This type is thread safe. - Managed Threading - Semaphore + Managed Threading + Semaphore @@ -182,8 +182,8 @@ -or- is less than 0. - Managed Threading - Semaphore + Managed Threading + Semaphore @@ -287,8 +287,8 @@ There was some other error. The `HResult` property might provide more informatio The is too long. Length restrictions may depend on the operating system or configuration. The named semaphore exists and has access control security, and the user does not have . A synchronization object with the provided cannot be created. A synchronization object of a different type might have the same name. - Managed Threading - Semaphore + Managed Threading + Semaphore @@ -397,8 +397,8 @@ There was some other error. The `HResult` property might provide more informatio The is too long. Length restrictions may depend on the operating system or configuration. The named semaphore exists and has access control security, and the user does not have . A synchronization object with the provided cannot be created. A synchronization object of a different type might have the same name. - Managed Threading - Semaphore + Managed Threading + Semaphore @@ -477,8 +477,8 @@ There was some other error. The `HResult` property might provide more informatio -or- An object with the specified exists, but the specified are not compatible with the existing object's options. - Managed Threading - Semaphore + Managed Threading + Semaphore @@ -576,8 +576,8 @@ There was some other error. The `HResult` property might provide more informatio Windows only: specified an unknown namespace. See Object Names for more information. The is too long. Length restrictions may depend on the operating system or configuration. A synchronization object with the provided cannot be created. A synchronization object of a different type might have the same name. - Managed Threading - Semaphore + Managed Threading + Semaphore @@ -655,8 +655,8 @@ There was some other error. The `HResult` property might provide more informatio -or- An object with the specified exists, but the specified are not compatible with the existing object's options. - Managed Threading - Semaphore + Managed Threading + Semaphore @@ -716,8 +716,8 @@ An object with the specified exists, but the specified -or- The current object represents a named system semaphore and was not opened with rights. - Managed Threading - Semaphore + Managed Threading + Semaphore @@ -834,8 +834,8 @@ An object with the specified exists, but the specified There was some other error. The `HResult` property might provide more information. The is too long. Length restrictions may depend on the operating system or configuration. The named semaphore exists, but the user does not have the security access required to use it. - Managed Threading - Semaphore + Managed Threading + Semaphore @@ -916,8 +916,8 @@ There was some other error. The `HResult` property might provide more informatio There was some other error. The `HResult` property might provide more information. The is too long. Length restrictions may depend on the operating system or configuration. The named semaphore exists, but the user does not have the desired security access rights. - Managed Threading - Semaphore + Managed Threading + Semaphore @@ -985,8 +985,8 @@ An object with the specified exists, but the specified There was some other error. The `HResult` property might provide more information. The is too long. Length restrictions may depend on the operating system or configuration. The named semaphore exists, but the user does not have the security access required to use it. - Managed Threading - Semaphore + Managed Threading + Semaphore @@ -1084,8 +1084,8 @@ There was some other error. The `HResult` property might provide more informatio -or- The current semaphore represents a named system semaphore, but it was not opened with . - Managed Threading - Semaphore + Managed Threading + Semaphore @@ -1169,8 +1169,8 @@ There was some other error. The `HResult` property might provide more informatio -or- The current semaphore represents a named system semaphore, but it was not opened with rights. - Managed Threading - Semaphore + Managed Threading + Semaphore @@ -1233,8 +1233,8 @@ There was some other error. The `HResult` property might provide more informatio The semaphore was not opened with rights. The current object does not represent a named system semaphore. - Managed Threading - Semaphore + Managed Threading + Semaphore diff --git a/xml/System.Threading/WaitHandle.xml b/xml/System.Threading/WaitHandle.xml index 257b5a61400..33ef9704eba 100644 --- a/xml/System.Threading/WaitHandle.xml +++ b/xml/System.Threading/WaitHandle.xml @@ -74,15 +74,15 @@ class encapsulates a native operating system synchronization handle and is used to represent all synchronization objects in the runtime that allow multiple wait operations. For a comparison of wait handles with other synchronization objects, see [Overview of Synchronization Primitives](/dotnet/standard/threading/overview-of-synchronization-primitives). + The class encapsulates a native operating system synchronization handle and is used to represent all synchronization objects in the runtime that allow multiple wait operations. For a comparison of wait handles with other synchronization objects, see [Overview of Synchronization Primitives](/dotnet/standard/threading/managed-threading-basicsoverview-of-synchronization-primitives). The class itself is abstract. Classes derived from define a signaling mechanism to indicate taking or releasing access to a shared resource, but they use the inherited methods to block while waiting for access to shared resources. The classes derived from include: -- The class. See [Mutexes](/dotnet/standard/threading/mutexes). +- The class. See [Mutexes](/dotnet/standard/threading/managed-threading-basicsmutexes). - The class and its derived classes, and . -- The class. See [Semaphore and SemaphoreSlim](/dotnet/standard/threading/semaphore-and-semaphoreslim). +- The class. See [Semaphore and SemaphoreSlim](/dotnet/standard/threading/managed-threading-basicssemaphore-and-semaphoreslim). Threads can block on an individual wait handle by calling the instance method , which is inherited by classes derived from . @@ -116,11 +116,11 @@ ]]> This type is thread safe. - Threading - Threading Objects and Features - Mutexes - EventWaitHandle, AutoResetEvent, and ManualResetEvent - Semaphores + Threading + Threading Objects and Features + Mutexes + EventWaitHandle, AutoResetEvent, and ManualResetEvent + Semaphores diff --git a/xml/System.Windows.Annotations.Storage/AnnotationStore.xml b/xml/System.Windows.Annotations.Storage/AnnotationStore.xml index 00de1576a37..196280a724b 100644 --- a/xml/System.Windows.Annotations.Storage/AnnotationStore.xml +++ b/xml/System.Windows.Annotations.Storage/AnnotationStore.xml @@ -924,7 +924,7 @@ Gets the object to use as a synchronization lock for critical sections. The object to use as a synchronization lock for critical sections. To be added. - lock keyword + lock keyword diff --git a/xml/System.Windows.Controls/ItemContainerGenerator.xml b/xml/System.Windows.Controls/ItemContainerGenerator.xml index 0f5db349d8c..dd01b17e63d 100644 --- a/xml/System.Windows.Controls/ItemContainerGenerator.xml +++ b/xml/System.Windows.Controls/ItemContainerGenerator.xml @@ -155,7 +155,7 @@ ]]> - using Statement (C# Reference) + using Statement (C# Reference) Using Statement (Visual Basic) diff --git a/xml/System.Windows.Controls/TabControl.xml b/xml/System.Windows.Controls/TabControl.xml index 1e29d1fcc3f..9abc526eafb 100644 --- a/xml/System.Windows.Controls/TabControl.xml +++ b/xml/System.Windows.Controls/TabControl.xml @@ -38,19 +38,22 @@ is useful for minimizing screen space usage while allowing an application to expose a large amount of data. A consists of multiple objects that share the same screen space. Only one in a is visible at a time. When a user selects the tab of a , the contents of that become visible and the contents of the other objects are hidden. - is an , which means it can contain a collection of objects of any type (such as string, image, or panel). For more information, see the class. +The is useful for minimizing screen space usage while allowing an application to expose a large amount of data. A consists of multiple objects that share the same screen space. Only one in a is visible at a time. When a user selects the tab of a , the contents of that become visible and the contents of the other objects are hidden. + + is an , which means it can contain a collection of objects of any type (such as string, image, or panel). For more information, see the class. ## Customizing the TabControl Control - To apply the same property settings to multiple controls, use the property. You can modify the default to give the control a unique appearance. For more information about creating a , see [How to create a template for a control](/dotnet/desktop/wpf/controls/how-to-create-apply-template). To see the parts and states that are specific to the , see [TabControl Styles and Templates](/dotnet/desktop/wpf/controls/tabcontrol-styles-and-templates). - Dependency properties for this control might be set by the control's default style. If a property is set by a default style, the property might change from its default value when the control appears in the application. The default style is determined by which desktop theme is used when the application is running. +To apply the same property settings to multiple controls, use the property. You can modify the default to give the control a unique appearance. For more information about creating a , see [How to create a template for a control](/dotnet/desktop/wpf/controls/how-to-create-apply-template). + +Dependency properties for this control might be set by the control's default style. If a property is set by a default style, the property might change from its default value when the control appears in the application. The default style is determined by which desktop theme is used when the application is running. [!INCLUDE[setting-a-visual-property](~/includes/visual-property-note.md)] ## Examples - The following example creates a and binds the in the second to a in the first . + +The following example creates a and binds the in the second to a in the first . :::code language="xaml" source="~/snippets/csharp/System.Windows.Controls/ContentControl/Overview/Window1.xaml" id="Snippet16"::: diff --git a/xml/System.Windows.Controls/TabItem.xml b/xml/System.Windows.Controls/TabItem.xml index a7fe5230fe8..f884b6c9135 100644 --- a/xml/System.Windows.Controls/TabItem.xml +++ b/xml/System.Windows.Controls/TabItem.xml @@ -34,19 +34,22 @@ is a . Its content property is and its header property is . For more information, see the class. + + is a . Its content property is and its header property is . For more information, see the class. ## Customizing the TabControl Control - To apply the same property settings to multiple controls, use the property. You can modify the default to give the control a unique appearance. For more information about creating a , see [How to create a template for a control](/dotnet/desktop/wpf/controls/how-to-create-apply-template). To see the parts and states that are specific to the , see [TabControl Styles and Templates](/dotnet/desktop/wpf/controls/tabcontrol-styles-and-templates). - Dependency properties for this control might be set by the control's default style. If a property is set by a default style, the property might change from its default value when the control appears in the application. The default style is determined by which desktop theme is used when the application is running. +To apply the same property settings to multiple controls, use the property. You can modify the default to give the control a unique appearance. For more information about creating a , see [How to create a template for a control](/dotnet/desktop/wpf/controls/how-to-create-apply-template). + +Dependency properties for this control might be set by the control's default style. If a property is set by a default style, the property might change from its default value when the control appears in the application. The default style is determined by which desktop theme is used when the application is running. [!INCLUDE[setting-a-visual-property](~/includes/visual-property-note.md)] ## Examples - The following example shows how to create a with elements. - :::code language="xaml" source="~/snippets/csharp/System.Windows.Controls/TabControl/TabStripPlacement/Pane1.xaml" id="Snippet1"::: +The following example shows how to create a with elements. + +:::code language="xaml" source="~/snippets/csharp/System.Windows.Controls/TabControl/TabStripPlacement/Pane1.xaml" id="Snippet1"::: ]]> diff --git a/xml/System.Windows.Input/TouchDevice.xml b/xml/System.Windows.Input/TouchDevice.xml index fe5c6c675a4..3221e48a63a 100644 --- a/xml/System.Windows.Input/TouchDevice.xml +++ b/xml/System.Windows.Input/TouchDevice.xml @@ -33,7 +33,7 @@ You typically access a by using the property. A represents a single touch on a screen. If multiple touches are present, use the property to distinguish between them. > [!NOTE] -> This class contains an inheritance demand at the class level that applies to all members. A is thrown when the derived class does not have full-trust permission. For more information about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class contains an inheritance demand at the class level that applies to all members. A is thrown when the derived class does not have full-trust permission. For more information about security demands, see [Link Demands](/previous-versions/dotnet/framework/code-access-security/link-demands). diff --git a/xml/System.Windows.Markup/MarkupExtensionReturnTypeAttribute.xml b/xml/System.Windows.Markup/MarkupExtensionReturnTypeAttribute.xml index 2ac0c9223f3..e8f16543944 100644 --- a/xml/System.Windows.Markup/MarkupExtensionReturnTypeAttribute.xml +++ b/xml/System.Windows.Markup/MarkupExtensionReturnTypeAttribute.xml @@ -188,7 +188,7 @@ - The return type that this .NET Framework attribute reports. + The return type that this .NET Framework attribute reports. Deprecated; do not use. Deprecated; do not use. diff --git a/xml/System.Windows.Media.Effects/ShaderEffect.xml b/xml/System.Windows.Media.Effects/ShaderEffect.xml index 5c172c38219..cd198958b40 100644 --- a/xml/System.Windows.Media.Effects/ShaderEffect.xml +++ b/xml/System.Windows.Media.Effects/ShaderEffect.xml @@ -28,40 +28,38 @@ class to implement a custom effect based on a single pixel shader. - The following steps show how to create a custom effect. +Derive from the class to implement a custom effect based on a single pixel shader. -1. Load a from precompiled High Level Shading Language (HLSL) bytecode. +The following steps show how to create a custom effect. -2. Define dependency properties that represent the parameters of the effect and the -based surface inputs. Use one of the overloads to associate these inputs with register numbers that are referenced in the HLSL bytecode. +1. Load a from precompiled High Level Shading Language (HLSL) bytecode. +1. Define dependency properties that represent the parameters of the effect and the -based surface inputs. Use one of the overloads to associate these inputs with register numbers that are referenced in the HLSL bytecode. - The number of samplers is limited to 4. +The number of samplers is limited to 4. - The following restrictions apply when using a PS 3.0 shader. +The following restrictions apply when using a PS 3.0 shader. - When a PS 3.0 shader is assigned, the number of samplers increases to 8. Assign the PS 3.0 shader before other shaders to enable registering 8 samplers. - The full shader constant register limit of 224 for floats is used. For more information, see [ps_3_0](https://learn.microsoft.com/windows/win32/direct3dhlsl/dx9-graphics-reference-asm-ps-3-0). -- The following data types are supported in PS 3.0 shaders only. An exception is thrown if these are used in lower shader versions. +- The following data types are supported in PS 3.0 shaders only. An exception is thrown if they're used in lower shader versions: - - `int` and types convertible to `int`: `uint`, `byte`, `sbyte`, `long`, `ulong`, `short`, `ushort`, `char` - - - `bool` + - `int` and types convertible to `int`: `uint`, `byte`, `sbyte`, `long`, `ulong`, `short`, `ushort`, `char` + - `bool` - If a valid PS 3.0 shader is loaded on a computer that does not have hardware support for PS 3.0, the shader is ignored. If the shader is invalid, no exception is thrown. - If a computer has more than one video card, the behavior is defined by the least capable video card. For example, if the computer has two video cards, one of which supports PS 3.0 and one of which does not, the behavior is the same as if the computer does not support PS 3.0. -- If a computer supports rendering PS 3.0 in hardware, but an invalid PS 3.0 shader is assigned, the event is raised. An example of an invalid PS 3.0 shader is one compiled with the `ps_3_sw` flag. The class accepts only PS 3.0 shaders that are compiled with the `ps_3_0` flag passed to fxc.exe. For more information, see [Effect-Compiler Tool](https://learn.microsoft.com/). +- If a computer supports rendering PS 3.0 in hardware, but an invalid PS 3.0 shader is assigned, the event is raised. An example of an invalid PS 3.0 shader is one compiled with the `ps_3_sw` flag. The class accepts only PS 3.0 shaders that are compiled with the `ps_3_0` flag passed to fxc.exe. > [!NOTE] > PS 2.0 shaders run when rendering in software. However, even if PS 3.0 is supported by the system's hardware, PS 3.0 shaders do not run during software rendering. - - ## Examples + The following code example shows how to derive from the class. [!code-csharp[System.Windows.Media.Effects.ShaderEffect#1](~/snippets/csharp/System.Windows/UIElement/Effect/ThresholdEffect.cs#1)] diff --git a/xml/System.Windows.Shell/JumpList.xml b/xml/System.Windows.Shell/JumpList.xml index 7ce9cb82dde..dc9ed52241f 100644 --- a/xml/System.Windows.Shell/JumpList.xml +++ b/xml/System.Windows.Shell/JumpList.xml @@ -77,7 +77,7 @@ Windows Media Player Jump List > You typically create one that is attached to the and applied to the Windows shell. However, you can create multiple objects. Only one at a time can be applied to the Windows shell, and only one at a time can be associated with an . The .NET Framework does not require that these be the same . > [!NOTE] -> This class contains a link demand at the class level that applies to all members. A is thrown when the immediate caller does not have full-trust permission. For more information about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class contains a link demand at the class level that applies to all members. A is thrown when the immediate caller does not have full-trust permission. For more information about security demands, see [Link Demands](/previous-versions/dotnet/framework/code-access-security/link-demands). diff --git a/xml/System.Windows/AttachedPropertyBrowsableForChildrenAttribute.xml b/xml/System.Windows/AttachedPropertyBrowsableForChildrenAttribute.xml index 87d8288629a..229f5335775 100644 --- a/xml/System.Windows/AttachedPropertyBrowsableForChildrenAttribute.xml +++ b/xml/System.Windows/AttachedPropertyBrowsableForChildrenAttribute.xml @@ -35,17 +35,17 @@ ## Remarks The meaning of the term `browsable` as used in descriptions for this .NET Framework attribute is analogous to the descriptions given for , but the browsable state for an attached property is particularly relevant to property information for Extensible Application Markup Language (XAML), because an attached property is primarily a XAML concept. - When this .NET Framework attribute is applied to the get accessor for an attached property, this .NET Framework attribute specifies that an attached property is browsable when the attached property owner is a parent element of other elements. + When this .NET Framework attribute is applied to the get accessor for an attached property, this .NET Framework attribute specifies that an attached property is browsable when the attached property owner is a parent element of other elements. - When interpreted by a designer that uses type descriptor information, the designer should add this property as a browsable property to all child elements in the logical tree, based on the parent element with this .NET Framework attribute applied. + When interpreted by a designer that uses type descriptor information, the designer should add this property as a browsable property to all child elements in the logical tree, based on the parent element with this .NET Framework attribute applied. Generally, the browsable state parallels functionality. For example, is designated browsable on elements that are child elements of a , because includes code for checking any set values of on child elements. - This .NET Framework attribute supports two types of tree detection modes for parent element positions: a shallow mode, and a deep mode. The shallow mode, which is the default mode for an applied .NET Framework attribute, requires that the immediate parent element be the owner type of the property in order for the attached property to be browsable. The deep mode is declared by applying the attribute with as `true`. The deep mode is less restrictive because it only requires that the owner type be somewhere in the ancestor direction of the logical tree, and therefore the attached property is browsable on all child elements, not just immediate child elements. The deep mode is applied for attached property usages where intervening elements in the logical tree should not be reported as the true parent element. Implicit collections (for example, the that is implicit in the of a ) are not considered to be parent elements for purposes of how this .NET Framework attribute declares the tree detection mode. + This .NET Framework attribute supports two types of tree detection modes for parent element positions: a shallow mode, and a deep mode. The shallow mode, which is the default mode for an applied .NET Framework attribute, requires that the immediate parent element be the owner type of the property in order for the attached property to be browsable. The deep mode is declared by applying the attribute with as `true`. The deep mode is less restrictive because it only requires that the owner type be somewhere in the ancestor direction of the logical tree, and therefore the attached property is browsable on all child elements, not just immediate child elements. The deep mode is applied for attached property usages where intervening elements in the logical tree should not be reported as the true parent element. Implicit collections (for example, the that is implicit in the of a ) are not considered to be parent elements for purposes of how this .NET Framework attribute declares the tree detection mode. This .NET Framework attribute should only be applied on the get accessor of attached property definitions. Do not apply this .NET Framework attribute to the set accessor. Although intuitively it is the set operation that is being made browsable for XAML on child elements, it is the presence and characteristics of the get accessor on the parent element that controls the true behavior. - Whether an attached property is browsable on a child element is not an absolute guarantee that the attached property value is really processed by the parent element in some manner. Also, the value is not an absolute guarantee that the processing scope does or does not extend beyond the immediate parent element. All this is implementation specific. However, this .NET Framework attribute for reporting the browsable state is the best available mechanism for reporting the usage information and functional information for an attached property. Therefore, you can generally assume that the browsable state of an attached property is analogous to the behavior of how an attached property value on a child element is processed or interpreted by the relevant parent element in your application code. + Whether an attached property is browsable on a child element is not an absolute guarantee that the attached property value is really processed by the parent element in some manner. Also, the value is not an absolute guarantee that the processing scope does or does not extend beyond the immediate parent element. All this is implementation specific. However, this .NET Framework attribute for reporting the browsable state is the best available mechanism for reporting the usage information and functional information for an attached property. Therefore, you can generally assume that the browsable state of an attached property is analogous to the behavior of how an attached property value on a child element is processed or interpreted by the relevant parent element in your application code. For general information on declaring attached properties, see [Attached Properties Overview](/dotnet/framework/wpf/advanced/attached-properties-overview). @@ -208,7 +208,7 @@ System.Boolean - Gets or sets a value that declares whether to use the deep mode for detection of parent elements on the attached property where this .NET Framework attribute is applied. + Gets or sets a value that declares whether to use the deep mode for detection of parent elements on the attached property where this .NET Framework attribute is applied. if the attached property is browsable for all child elements in the logical tree of the parent element that owns the attached property. if the attached property is only browsable for immediate child elements of a parent element that owns the attached property. The default is . diff --git a/xml/System.Windows/AttachedPropertyBrowsableForTypeAttribute.xml b/xml/System.Windows/AttachedPropertyBrowsableForTypeAttribute.xml index 5d19f4958da..b7ac979f064 100644 --- a/xml/System.Windows/AttachedPropertyBrowsableForTypeAttribute.xml +++ b/xml/System.Windows/AttachedPropertyBrowsableForTypeAttribute.xml @@ -37,7 +37,7 @@ If more than one type is specified for a .NET Framework attribute, the property is browsable if any specified type matches (logical or). The type can also be an interface. - This .NET Framework attribute specifies `true`. + This .NET Framework attribute specifies `true`. This .NET Framework attribute should only be applied on the get accessor of attached property definitions. Do not apply this .NET Framework attribute to the set accessor. Although intuitively it is the set operation that is being made browsable for XAML on relevant elements, it is the presence and characteristics of the get accessor on the property defining element that controls the true behavior. @@ -111,7 +111,7 @@ . + This implementation supports value equality of the one possible settable value exposed by this .NET Framework attribute, . ]]> @@ -190,7 +190,7 @@ constructor. + This property is settable only via the .NET Framework attribute declaration as exposed by the constructor. ]]> @@ -220,16 +220,9 @@ System.Object - Gets a unique type identifier for this .NET Framework attribute. + Gets a unique type identifier for this .NET attribute. An object that is a unique identifier for the . - - - + This implementation returns a unique value for each .NET attribute, which is necessary because this .NET attribute allows multiple usages. diff --git a/xml/System.Windows/AttachedPropertyBrowsableWhenAttributePresentAttribute.xml b/xml/System.Windows/AttachedPropertyBrowsableWhenAttributePresentAttribute.xml index 24d31ee0e8c..ab61b1b6efb 100644 --- a/xml/System.Windows/AttachedPropertyBrowsableWhenAttributePresentAttribute.xml +++ b/xml/System.Windows/AttachedPropertyBrowsableWhenAttributePresentAttribute.xml @@ -67,7 +67,7 @@ - The of the .NET Framework attribute that must also be applied on a class in order for the attached property to be browsable on the class where is applied. + The of the .NET Framework attribute that must also be applied on a class in order for the attached property to be browsable on the class where is applied. Initializes a new instance of the class. To be added. @@ -102,13 +102,14 @@ System.Type - Gets the type of the .NET Framework attribute that must also be applied on a class. - The .NET Framework attribute type. + Gets the type of the .NET attribute that must also be applied on a class. + The .NET attribute type. value can only be set through the `attributeType` parameter of the .NET Framework attribute constructor. + +The value can only be set through the `attributeType` parameter of the .NET attribute constructor. ]]> diff --git a/xml/System.Xml.Linq/XElement.xml b/xml/System.Xml.Linq/XElement.xml index d9362523133..7e44f1344b5 100644 --- a/xml/System.Xml.Linq/XElement.xml +++ b/xml/System.Xml.Linq/XElement.xml @@ -77,12 +77,12 @@ - Represents an XML element. See XElement Class Overview and the Remarks section on this page for usage information and examples. + Represents an XML element. See XElement Class Overview and the Remarks section on this page for usage information and examples. , optionally one or more attributes, and can optionally contain content (for more information, see ). diff --git a/xml/System.Xml.Serialization.Advanced/SchemaImporterExtension.xml b/xml/System.Xml.Serialization.Advanced/SchemaImporterExtension.xml index 7043651e480..82dc9138d2d 100644 --- a/xml/System.Xml.Serialization.Advanced/SchemaImporterExtension.xml +++ b/xml/System.Xml.Serialization.Advanced/SchemaImporterExtension.xml @@ -24,7 +24,7 @@ The class allows you to modify the code generated when using any of these tools. For example, you may have an existing class that processes book orders on a system and you have an existing XSD document that supplies your orders. Using the class, you can enable one of the tools to generate code that uses your class. - In order to control the generation of the code, you must use the classes found in the namespace. For more information, see [Using the CodeDOM](/dotnet/framework/reflection-and-codedom/using-the-codedom) and [CodeDOM Quick Reference](https://learn.microsoft.com/en-us/).aspx). + In order to control the generation of the code, you must use the classes found in the namespace. For more information, see [Using the CodeDOM](/dotnet/framework/reflection-and-codedom/using-the-codedom). The steps to enabling the WSDL.exe tool (which in turn is used by other tools such as the Add Web Reference dialog box) to use your extension are: @@ -111,7 +111,7 @@ See the [SchemaImporterExtension Technology Sample](/dotnet/standard/serializati namespace. For more information, see [Using the CodeDOM](/dotnet/framework/reflection-and-codedom/using-the-codedom) and [CodeDOM Quick Reference](https://learn.microsoft.com/en-us/).aspx). + In order to control the generation of the code, you must use the classes found in the namespace. For more information, see [Using the CodeDOM](/dotnet/framework/reflection-and-codedom/using-the-codedom). ]]> @@ -146,7 +146,7 @@ See the [SchemaImporterExtension Technology Sample](/dotnet/standard/serializati namespace. For more information, see [Using the CodeDOM](/dotnet/framework/reflection-and-codedom/using-the-codedom) and [CodeDOM Quick Reference](https://learn.microsoft.com/en-us/).aspx). +To control the generation of the code, use the classes found in the namespace. For more information, see [Using the CodeDOM](/dotnet/framework/reflection-and-codedom/using-the-codedom). ]]> @@ -264,10 +264,7 @@ See the [SchemaImporterExtension Technology Sample](/dotnet/standard/serializati namespace. For more information, see [Using the CodeDOM](/dotnet/framework/reflection-and-codedom/using-the-codedom) and [CodeDOM Quick Reference](https://learn.microsoft.com/en-us/).aspx). - - +To control the generation of the code, use the classes found in the namespace. For more information, see [Using the CodeDOM](/dotnet/framework/reflection-and-codedom/using-the-codedom). ## Examples The example below shows a simple implementation of the method. The code checks the namespace and name. When the right values are found, it adds the name of a custom assembly ("Order.dll") that must be referenced in the generated code. It then adds a new namespace ("Microsoft.Samples") that is generated in the code. diff --git a/xml/System.Xml.Xsl/XslTransform.xml b/xml/System.Xml.Xsl/XslTransform.xml index 6a301d26ba3..a859f0f5877 100644 --- a/xml/System.Xml.Xsl/XslTransform.xml +++ b/xml/System.Xml.Xsl/XslTransform.xml @@ -140,7 +140,7 @@ > [!NOTE] > `msxsl:script` and `msxsl:node-list` are the only functions from the `urn:schemas-microsoft-com:xslt` namespace that are supported by the class. - has the ability to utilize common language runtime (CLR) code as an extension mechanism. This is accomplished by passing an instance of a class to the class and calling its public methods within an XSLT style sheet. Methods that are defined with the `params` keyword, which allows an unspecified number of parameters to be passed, do not work correctly in this scenario. See [params](/dotnet/csharp/language-reference/keywords/params) for more details. + has the ability to utilize common language runtime (CLR) code as an extension mechanism. This is accomplished by passing an instance of a class to the class and calling its public methods within an XSLT style sheet. Methods that are defined with the `params` keyword, which allows an unspecified number of parameters to be passed, do not work correctly in this scenario. See [params](/dotnet/csharp/language-reference/keywords/method-parameters) for more details. For more information see [XSLT Transformations with the XslTransform Class](/dotnet/standard/data/xml/xslt-transformations-with-the-xsltransform-class). diff --git a/xml/System.Xml.Xsl/XsltArgumentList.xml b/xml/System.Xml.Xsl/XsltArgumentList.xml index 0fd4020da46..9c8d4a20d0b 100644 --- a/xml/System.Xml.Xsl/XsltArgumentList.xml +++ b/xml/System.Xml.Xsl/XsltArgumentList.xml @@ -172,7 +172,7 @@ asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -3727,7 +3727,7 @@ An asynchronous method was calle -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) diff --git a/xml/System.Xml/XmlReader.xml b/xml/System.Xml/XmlReader.xml index 0a0030a77b3..24e7bd62197 100644 --- a/xml/System.Xml/XmlReader.xml +++ b/xml/System.Xml/XmlReader.xml @@ -2032,7 +2032,7 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -3422,7 +3422,7 @@ public class Sample -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -4119,7 +4119,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -4383,7 +4383,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -4533,7 +4533,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -4683,7 +4683,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -5365,7 +5365,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -5496,7 +5496,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -5744,7 +5744,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -5899,7 +5899,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -6054,7 +6054,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -7393,7 +7393,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -7630,7 +7630,7 @@ An method was called before a previous asy ]]> An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -8056,7 +8056,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -8200,7 +8200,7 @@ An asynchronous method was called without ]]> An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -9212,7 +9212,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -9556,7 +9556,7 @@ If you have to get the post-schema-validation information set (PSVI) for an elem -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlReaderSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) diff --git a/xml/System.Xml/XmlReaderSettings.xml b/xml/System.Xml/XmlReaderSettings.xml index 674a38acf49..6cc849f941d 100644 --- a/xml/System.Xml/XmlReaderSettings.xml +++ b/xml/System.Xml/XmlReaderSettings.xml @@ -246,7 +246,7 @@ The following example creates an that uses an - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) diff --git a/xml/System.Xml/XmlResolver.xml b/xml/System.Xml/XmlResolver.xml index f2151852d5a..3297a777a91 100644 --- a/xml/System.Xml/XmlResolver.xml +++ b/xml/System.Xml/XmlResolver.xml @@ -370,7 +370,7 @@ resolver.Credentials = myCache; ]]> - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) diff --git a/xml/System.Xml/XmlWriter.xml b/xml/System.Xml/XmlWriter.xml index 5cc9f2d52f9..83b8ceefbd8 100644 --- a/xml/System.Xml/XmlWriter.xml +++ b/xml/System.Xml/XmlWriter.xml @@ -1333,7 +1333,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -1652,7 +1652,7 @@ This member might behave differently when it is used in a Portable Class Library -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -2033,7 +2033,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -2178,7 +2178,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -2328,7 +2328,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -2467,7 +2467,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -2594,7 +2594,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -2739,7 +2739,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -2880,7 +2880,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -3045,7 +3045,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -3398,7 +3398,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -3518,7 +3518,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -3644,7 +3644,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -3774,7 +3774,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -3903,7 +3903,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -4026,7 +4026,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -4153,7 +4153,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -4278,7 +4278,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -4522,7 +4522,7 @@ while (!reader.EOF){ ]]> - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -4588,7 +4588,7 @@ while (!reader.EOF){ -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -4657,7 +4657,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -4822,7 +4822,7 @@ writer.Close(); -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -4996,7 +4996,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -5179,7 +5179,7 @@ An asynchronous method was called without ]]> - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -5242,7 +5242,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -5309,7 +5309,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -5631,7 +5631,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -5802,7 +5802,7 @@ An method was called before a previous asy ]]> - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -5862,7 +5862,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -5925,7 +5925,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -6274,7 +6274,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -6475,7 +6475,7 @@ test<item>test -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -6607,7 +6607,7 @@ An asynchronous method was called without -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) @@ -7433,7 +7433,7 @@ An method was called before a previous asy -or- An asynchronous method was called without setting the flag to . In this case, is thrown with the message "Set XmlWriterSettings.Async to true if you want to use Async Methods." - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) diff --git a/xml/System.Xml/XmlWriterSettings.xml b/xml/System.Xml/XmlWriterSettings.xml index 4d8bb0a9d6d..829768df462 100644 --- a/xml/System.Xml/XmlWriterSettings.xml +++ b/xml/System.Xml/XmlWriterSettings.xml @@ -228,7 +228,7 @@ ]]> - Asynchronous programming (C#) + Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) diff --git a/xml/System/Action.xml b/xml/System/Action.xml index 850a253871f..2fc9a62c6e9 100644 --- a/xml/System/Action.xml +++ b/xml/System/Action.xml @@ -84,11 +84,11 @@ :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Action/fs/Action.fs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/System/Action/Overview/Action.vb" id="Snippet2"::: - You can also use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/programming-guide/statements-expressions-operators/anonymous-methods).) + You can also use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/language-reference/operators/delegate-operator).) :::code language="csharp" source="~/snippets/csharp/System/Action/Overview/Anon.cs" id="Snippet3"::: - You can also assign a lambda expression to an delegate instance, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (C#)](/dotnet/csharp/programming-guide/statements-expressions-operators/lambda-expressions) or [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) + You can also assign a lambda expression to an delegate instance, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (C#)](/dotnet/csharp/language-reference/operators/lambda-expressions) or [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) :::code language="csharp" source="~/snippets/csharp/System/Action/Overview/Lambda.cs" id="Snippet4"::: :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Action/fs/Lambda.fs" id="Snippet4"::: diff --git a/xml/System/Action`1.xml b/xml/System/Action`1.xml index 26feaa8c744..929d8926159 100644 --- a/xml/System/Action`1.xml +++ b/xml/System/Action`1.xml @@ -94,11 +94,11 @@ :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Action~1/fs/Action1.fs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/System/ActionT/Overview/Action1.vb" id="Snippet2"::: - You can also use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/programming-guide/statements-expressions-operators/anonymous-methods).) + You can also use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/language-reference/operators/delegate-operator).) :::code language="csharp" source="~/snippets/csharp/System/ActionT/Overview/Anon.cs" id="Snippet3"::: - You can also assign a lambda expression to an delegate instance, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions](/dotnet/csharp/programming-guide/statements-expressions-operators/lambda-expressions).) + You can also assign a lambda expression to an delegate instance, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions](/dotnet/csharp/language-reference/operators/lambda-expressions).) :::code language="csharp" source="~/snippets/csharp/System/ActionT/Overview/Lambda.cs" id="Snippet4"::: :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Action~1/fs/Lambda.fs" id="Snippet4"::: diff --git a/xml/System/Action`2.xml b/xml/System/Action`2.xml index 24e3c017e54..6f0f00a8496 100644 --- a/xml/System/Action`2.xml +++ b/xml/System/Action`2.xml @@ -119,11 +119,11 @@ :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Action~2/fs/Action2.fs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/System/ActionT1,T2/Overview/action2.vb" id="Snippet2"::: - You can also use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/programming-guide/statements-expressions-operators/anonymous-methods).) + You can also use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/language-reference/operators/delegate-operator).) :::code language="csharp" source="~/snippets/csharp/System/ActionT1,T2/Overview/Anon.cs" id="Snippet3"::: - You can also assign a lambda expression to an delegate instance, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (C#)](/dotnet/csharp/programming-guide/statements-expressions-operators/lambda-expressions), or [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) + You can also assign a lambda expression to an delegate instance, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (C#)](/dotnet/csharp/language-reference/operators/lambda-expressions), or [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) :::code language="csharp" source="~/snippets/csharp/System/ActionT1,T2/Overview/Lambda.cs" id="Snippet4"::: :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Action~2/fs/Lambda.fs" id="Snippet4"::: diff --git a/xml/System/Action`3.xml b/xml/System/Action`3.xml index acd026ce5ed..e2f7268c225 100644 --- a/xml/System/Action`3.xml +++ b/xml/System/Action`3.xml @@ -133,11 +133,11 @@ :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Action~3/fs/Action3.fs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/System/ActionT1,T2,T3/Overview/Action3.vb" id="Snippet2"::: - You can also use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/programming-guide/statements-expressions-operators/anonymous-methods).) + You can also use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/language-reference/operators/delegate-operator).) :::code language="csharp" source="~/snippets/csharp/System/ActionT1,T2,T3/Overview/Anon.cs" id="Snippet3"::: - You can also assign a lambda expression to an delegate instance, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (C#)](/dotnet/csharp/programming-guide/statements-expressions-operators/lambda-expressions) or [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) + You can also assign a lambda expression to an delegate instance, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (C#)](/dotnet/csharp/language-reference/operators/lambda-expressions) or [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) :::code language="csharp" source="~/snippets/csharp/System/ActionT1,T2,T3/Overview/Lambda.cs" id="Snippet4"::: :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Action~3/fs/Lambda.fs" id="Snippet4"::: diff --git a/xml/System/Action`4.xml b/xml/System/Action`4.xml index 09b9210f5ad..7908169e6e7 100644 --- a/xml/System/Action`4.xml +++ b/xml/System/Action`4.xml @@ -127,11 +127,11 @@ :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Action~4/fs/Action4.fs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/System/ActionT1,T2,T3,T4/Overview/Action4.vb" id="Snippet2"::: - You can also use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/programming-guide/statements-expressions-operators/anonymous-methods).) + You can also use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/language-reference/operators/delegate-operator).) :::code language="csharp" source="~/snippets/csharp/System/ActionT1,T2,T3,T4/Overview/Anon.cs" id="Snippet3"::: - You can also assign a lambda expression to an delegate instance, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (C#)](/dotnet/csharp/programming-guide/statements-expressions-operators/lambda-expressions) or [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) + You can also assign a lambda expression to an delegate instance, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (C#)](/dotnet/csharp/language-reference/operators/lambda-expressions) or [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) :::code language="csharp" source="~/snippets/csharp/System/ActionT1,T2,T3,T4/Overview/Lambda.cs" id="Snippet4"::: :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Action~4/fs/Lambda.fs" id="Snippet4"::: diff --git a/xml/System/AggregateException.xml b/xml/System/AggregateException.xml index e3afabfe644..be0c1b8697d 100644 --- a/xml/System/AggregateException.xml +++ b/xml/System/AggregateException.xml @@ -82,7 +82,7 @@ is used to consolidate multiple failures into a single, throwable exception object. It is used extensively in the [Task Parallel Library (TPL)](/dotnet/standard/parallel-programming/task-parallel-library-tpl) and [Parallel LINQ (PLINQ)](/dotnet/standard/parallel-programming/parallel-linq-plinq). For more information, see [Exception Handling](/dotnet/standard/parallel-programming/exception-handling-task-parallel-library) and [How to: Handle Exceptions in a PLINQ Query](/dotnet/standard/parallel-programming/how-to-handle-exceptions-in-a-plinq-query). For additional information, see the [Aggregating Exceptions](https://learn.microsoft.com/archive/msdn-magazine/2009/brownfield/aggregating-exceptions) entry in the .NET Matters blog. + is used to consolidate multiple failures into a single, throwable exception object. It is used extensively in the [Task Parallel Library (TPL)](/dotnet/standard/parallel-programming/task-parallel-library-tpl) and [Parallel LINQ (PLINQ)](/dotnet/standard/parallel-programming/introduction-to-plinq). For more information, see [Exception Handling](/dotnet/standard/parallel-programming/exception-handling-task-parallel-library) and [How to: Handle Exceptions in a PLINQ Query](/dotnet/standard/parallel-programming/how-to-handle-exceptions-in-a-plinq-query). For additional information, see the [Aggregating Exceptions](https://learn.microsoft.com/archive/msdn-magazine/2009/brownfield/aggregating-exceptions) entry in the .NET Matters blog. diff --git a/xml/System/AppDomainManager.xml b/xml/System/AppDomainManager.xml index 889e03a7a39..ae8a5a34e65 100644 --- a/xml/System/AppDomainManager.xml +++ b/xml/System/AppDomainManager.xml @@ -33,7 +33,7 @@ ## Remarks > [!IMPORTANT] -> Do not use to configure an application domain in ASP.NET. In ASP.NET, configuration must be handled by the host. +> Do not use to configure an application domain in ASP.NET. In ASP.NET, configuration must be handled by the host. Implementing the class enables a hosting application to participate in the creation of new application domains. To replace the default , identify the assembly and type of the replacement in the APPDOMAIN_MANAGER_ASM and APPDOMAIN_MANAGER_TYPE environment variables, or use the [\](/dotnet/framework/configure-apps/file-schema/runtime/appdomainmanagerassembly-element) and [\](/dotnet/framework/configure-apps/file-schema/runtime/appdomainmanagertype-element) elements in your configuration file. The assembly must be fully trusted and be contained in the global assembly cache or the directory of the starting application. The type and assembly names must be fully qualified in the environment variables. For example: @@ -42,15 +42,15 @@ `set APPDOMAIN_MANAGER_ASM=customappDomainmanager, Version=1.0.0.0, Culture=neutral, PublicKeyToken=f1368f7b12a08d72` > [!IMPORTANT] -> If the assembly that contains your subclass of depends on assemblies that are marked with the conditional (APTCA) attribute, you must include those assemblies in the list that you pass to the property of the you use to create application domains. Otherwise, the assemblies that are marked with the conditional APTCA attribute will be disabled. +> If the assembly that contains your subclass of depends on assemblies that are marked with the conditional (APTCA) attribute, you must include those assemblies in the list that you pass to the property of the you use to create application domains. Otherwise, the assemblies that are marked with the conditional APTCA attribute will be disabled. The is the managed equivalent of the unmanaged host. An object participates in the creation of new application domains in a process and can customize the new before other managed code runs. The can also supply host managers that participate in other aspects of common language runtime execution. For example, an can identify a object that participates in the security decisions of the application domain. > [!NOTE] -> Only assemblies granted `FullTrust`, such as assemblies in the global assembly cache or identified as `fullTrustAssemblies` in the method can be loaded in the constructor and the method. +> Only assemblies granted `FullTrust`, such as assemblies in the global assembly cache or identified as `fullTrustAssemblies` in the method can be loaded in the constructor and the method. > [!NOTE] -> This class contains a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands). +> This class contains a link demand and an inheritance demand at the class level. A is thrown when either the immediate caller or the derived class does not have infrastructure permission. ## Examples The following example shows a very simple implementation of . diff --git a/xml/System/ArgumentOutOfRangeException.xml b/xml/System/ArgumentOutOfRangeException.xml index 2fceb20b211..b13a2b0990a 100644 --- a/xml/System/ArgumentOutOfRangeException.xml +++ b/xml/System/ArgumentOutOfRangeException.xml @@ -236,7 +236,7 @@ The conditions in which an exception i - if your app uses an array or collection object, consider using a thread-safe collection class, such as the types in the namespace or the out-of-band release. - - Ensure that shared state (that is, resources that can be accessed by multiple threads) is accessed in a thread-safe way, so that only one thread at a time has exclusive access to the resources. A large number of classes, such as , , , and , are available to synchronize access to resources. For more information, see [Threading](/dotnet/standard/threading/). In addition, language support is available through the [lock](/dotnet/csharp/language-reference/keywords/lock-statement) statement in C# and the [SyncLock](/dotnet/visual-basic/language-reference/statements/synclock-statement) construct in Visual Basic. + - Ensure that shared state (that is, resources that can be accessed by multiple threads) is accessed in a thread-safe way, so that only one thread at a time has exclusive access to the resources. A large number of classes, such as , , , and , are available to synchronize access to resources. For more information, see [Threading](/dotnet/standard/threading/managed-threading-basics). In addition, language support is available through the [lock](/dotnet/csharp/language-reference/statements/lock) statement in C# and the [SyncLock](/dotnet/visual-basic/language-reference/statements/synclock-statement) construct in Visual Basic. The following example addresses the and the other issues from the previous example. It replaces the object with a object to ensure that access to the collection is thread-safe, uses a object to ensure that the application thread continues only after other threads have executed, and uses a lock to ensure that only one thread can access the `msg` variable at a time. diff --git a/xml/System/Array.xml b/xml/System/Array.xml index c5e99d6a8df..211dc99058f 100644 --- a/xml/System/Array.xml +++ b/xml/System/Array.xml @@ -149,8 +149,8 @@ Enumerating through a collection is intrinsically not a thread-safe procedure. Even when a collection is synchronized, other threads can still modify the collection, which causes the enumerator to throw an exception. To guarantee thread safety during enumeration, you can either lock the collection during the entire enumeration or catch the exceptions resulting from changes made by other threads. - Performing Culture-Insensitive String Operations in Arrays - Arrays (C# Programming Guide) + Performing Culture-Insensitive String Operations in Arrays + Arrays (C# Programming Guide) Arrays in F# Arrays in Visual Basic @@ -353,7 +353,7 @@ does not implement the interface, and the search encounters an element that does not implement the interface. - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -464,7 +464,7 @@ - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -578,7 +578,7 @@ does not implement the interface, and the search encounters an element that does not implement the interface. - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -707,7 +707,7 @@ - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -818,7 +818,7 @@ does not implement the generic interface. - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -953,7 +953,7 @@ - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -1064,7 +1064,7 @@ does not implement the generic interface. - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -1198,7 +1198,7 @@ - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -3337,7 +3337,7 @@ - Lambda Expressions (C# Programming Guide) + Lambda Expressions (C# Programming Guide) Lambda Expressions (Visual Basic) @@ -5705,7 +5705,7 @@ is multidimensional. - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -5823,7 +5823,7 @@ is multidimensional. - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -5907,7 +5907,7 @@ is . - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -5997,7 +5997,7 @@ is outside the range of valid indexes for . - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -6097,7 +6097,7 @@ and do not specify a valid section in . - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -6471,7 +6471,7 @@ is multidimensional. - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -6569,7 +6569,7 @@ is multidimensional. - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -6681,7 +6681,7 @@ is multidimensional. - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -6767,7 +6767,7 @@ is . - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -6857,7 +6857,7 @@ is outside the range of valid indexes for . - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -6957,7 +6957,7 @@ and do not specify a valid section in . - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -8456,7 +8456,7 @@ int[,,] TDArray = new int[1,1,1]; One or more elements in do not implement the interface. - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -8571,7 +8571,7 @@ int[,,] TDArray = new int[1,1,1]; - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -8695,7 +8695,7 @@ This method is an O(`n` log `n`) operation, where `n` is the - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -8835,7 +8835,7 @@ This method is an O(`n` log `n`) operation, where `n` is the - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -8940,7 +8940,7 @@ This method is an O(`n` log `n`) operation, where `n` is the One or more elements in do not implement the interface. - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -9072,7 +9072,7 @@ This method is an O(`n` log `n`) operation, where `n` is the One or more elements in the do not implement the interface. - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -9211,7 +9211,7 @@ This method is an O(`n` log `n`) operation, where `n` is the - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -9377,7 +9377,7 @@ This method is an O(`n` log `n`) operation, where `n` is the - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -9485,7 +9485,7 @@ This method is an O(`n` log `n`) operation, where `n` is the One or more elements in do not implement the generic interface. - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -9611,7 +9611,7 @@ This method is an O(`n` log `n`) operation, where `n` is the - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -9717,7 +9717,7 @@ This method is an O(`n` log `n`) operation, where `n` is the - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -9837,7 +9837,7 @@ This method is an O(`n` log `n`) operation, where `n` is the One or more elements in do not implement the generic interface. - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -9980,7 +9980,7 @@ This method is an O(`n` log `n`) operation, where `n` is the - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -10114,7 +10114,7 @@ This method is an O(`n` log `n`) operation, where `n` is the - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -10263,7 +10263,7 @@ This method is an O(`n` log `n`) operation, where `n` is the - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -10412,7 +10412,7 @@ This method is an O(`n` log `n`) operation, where `n` is the One or more elements in the do not implement the generic interface. - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays @@ -10583,7 +10583,7 @@ This method is an O(`n` log `n`) operation, where `n` is the - Performing Culture-Insensitive String Operations in Arrays + Performing Culture-Insensitive String Operations in Arrays diff --git a/xml/System/ArraySegment`1+Enumerator.xml b/xml/System/ArraySegment`1+Enumerator.xml index 44a99b2241b..fd5967a023c 100644 --- a/xml/System/ArraySegment`1+Enumerator.xml +++ b/xml/System/ArraySegment`1+Enumerator.xml @@ -62,7 +62,7 @@ ## Remarks -The C# [foreach](/dotnet/csharp/language-reference/keywords/foreach-in) of the C# language and the [For Each...Next](/dotnet/visual-basic/language-reference/statements/for-each-next-statement) construct in Visual Basic hides the complexity of enumerators. Instead of directly manipulating the enumerator, using `foreach` or `For Each...Next` is recommended. +The C# [foreach](/dotnet/csharp/language-reference/statements/iteration-statements) of the C# language and the [For Each...Next](/dotnet/visual-basic/language-reference/statements/for-each-next-statement) construct in Visual Basic hides the complexity of enumerators. Instead of directly manipulating the enumerator, using `foreach` or `For Each...Next` is recommended. Initially, the enumerator is positioned before the first element in the . At this position, is undefined. You must call to advance the enumerator to the first item in the before reading the value of . diff --git a/xml/System/DateTime.xml b/xml/System/DateTime.xml index 4ea7ac2d898..7162fd71d5e 100644 --- a/xml/System/DateTime.xml +++ b/xml/System/DateTime.xml @@ -5631,19 +5631,18 @@ juillet 2009 ## Remarks In this section: -- [Which method do I call?](#Tasks) -- [The string to parse](#StringToParse) -- [Parsing and cultural conventions](#Culture) -- [Parsing and style elements](#Styles) -- [The return value and DateTime.Kind](#kind) +- [Which method do I call?](#which-method-do-i-call) +- [The string to parse](#the-string-to-parse) +- [Parsing and cultural conventions](#parsing-and-cultural-conventions) +- [Parsing and style elements](#parsing-and-style-elements) +- [The return value and DateTime.Kind](#the-return-value-and-datetimekind) - ### Which method do I call? |To|Call| |--------|----------| |Parse a date and time string by using the conventions of the current culture.| overload| -|Parse a date and time string by using the conventions of a specific culture.| overload (see [Parsing and Cultural Conventions](#Culture))| +|Parse a date and time string by using the conventions of a specific culture.| overload (see [Parsing and Cultural Conventions](#parsing-and-cultural-conventions))| |Parse a date and time string with special style elements (such as white space or no white space).| overload| |Parse a date and time string that must be in a particular format.| or | |Parse a date and time string and perform a conversion to UTC or local time.| overload| @@ -5651,7 +5650,6 @@ juillet 2009 |Restore (round-trip) a date and time value created by a formatting operation.|Pass the "o" or "r" standard format string to the method, and call the overload with | |Parse a date and time string in a fixed format across machine (and possibly cultural) boundaries.| or method| - ### The string to parse The method tries to convert the string representation of a date and time value to its equivalent. It tries to parse the input string completely without throwing a exception. When using overloads that accept an object, it will be used to parse `StringToParse`. If no such object is provided, will be used instead. @@ -5691,11 +5689,10 @@ The following example parses strings in each of these formats by using the forma :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.DateTime.Parse/fs/Parse6.fs"::: :::code language="vb" source="~/snippets/visualbasic/System/DateTime/Parse/Parse6.vb"::: - If the input string represents a leap day in a leap year in the calendar used by the parsing method (see [Parsing and cultural conventions](#Culture)), the method parses the string successfully. If the input string represents a leap day in a non-leap year, the method throws a . + If the input string represents a leap day in a leap year in the calendar used by the parsing method (see [Parsing and cultural conventions](#parsing-and-cultural-conventions)), the method parses the string successfully. If the input string represents a leap day in a non-leap year, the method throws a . Because the method tries to parse the string representation of a date and time by using the formatting rules of the current or a specified culture, trying to parse a string across different cultures can fail. To parse a specific date and time format across different locales, use one of the overloads of the method and provide a format specifier. - ### Parsing and cultural conventions All overloads of the method are culture-sensitive unless the string to be parsed (which is represented by `s` in the following table) conforms to the ISO 8601 pattern. The parsing operation uses the formatting information in a object that is derived as follows: @@ -5724,7 +5721,6 @@ The following example parses strings in each of these formats by using the forma > > For more information see the "Dynamic culture data" section in the topic and the "Persisting DateTime values" section in the topic. - ### Parsing and style elements All overloads ignore leading, inner, or trailing white-space characters in the input string (which is represented by `s` in the following table). The date and time can be bracketed with a pair of leading and trailing NUMBER SIGN characters ("#", U+0023), and can be trailed with one or more NULL characters (U+0000). @@ -5742,7 +5738,6 @@ The following example parses strings in each of these formats by using the forma ||Although valid, this value is ignored.| ||For strings that contain time zone information, tries to prevent the conversion of a date and time string to a value that represents a local time with its property set to . Typically, such a string is created by calling the method and by using the "o", "r", or "u" standard format specifier.| - ### The return value and DateTime.Kind The `DateTime.Parse` overloads return a value whose property includes time zone information. It can indicate that the time is: @@ -5833,7 +5828,7 @@ You can also download a complete set of `DateTime.Parse` examples, which are inc - A string that contains a date and time to convert. See The string to parse for more information. + A string that contains a date and time to convert. See The string to parse for more information. Converts the string representation of a date and time to its equivalent by using the conventions of the current culture. An object that is equivalent to the date and time contained in . @@ -5986,8 +5981,8 @@ It handles the exception that is thrown when the m - A string that contains a date and time to convert. See The string to parse for more information. - An object that supplies culture-specific format information about . See Parsing and cultural conventions + A string that contains a date and time to convert. See The string to parse for more information. + An object that supplies culture-specific format information about . See Parsing and cultural conventions Converts the string representation of a date and time to its equivalent by using culture-specific format information. An object that is equivalent to the date and time contained in as specified by . @@ -6064,8 +6059,8 @@ The following example parses an array of date strings by using the conventions o - The memory span that contains the string to parse. See The string to parse for more information. - An object that supplies culture-specific format information about . See Parsing and cultural conventions + The memory span that contains the string to parse. See The string to parse for more information. + An object that supplies culture-specific format information about . See Parsing and cultural conventions A bitwise combination of the enumeration values that indicates the style elements that can be present in for the parse operation to succeed, and that defines how to interpret the parsed date in relation to the current time zone or the current date. A typical value to specify is . Converts a memory span that contains string representation of a date and time to its equivalent by using culture-specific format information and a formatting style. An object that is equivalent to the date and time contained in , as specified by and . @@ -6136,8 +6131,8 @@ The following example parses an array of date strings by using the conventions o - A string that contains a date and time to convert. See The string to parse for more information. - An object that supplies culture-specific formatting information about . See Parsing and cultural conventions + A string that contains a date and time to convert. See The string to parse for more information. + An object that supplies culture-specific formatting information about . See Parsing and cultural conventions A bitwise combination of the enumeration values that indicates the style elements that can be present in for the parse operation to succeed, and that defines how to interpret the parsed date in relation to the current time zone or the current date. A typical value to specify is . Converts the string representation of a date and time to its equivalent by using culture-specific format information and a formatting style. An object that is equivalent to the date and time contained in , as specified by and . diff --git a/xml/System/DuplicateWaitObjectException.xml b/xml/System/DuplicateWaitObjectException.xml index fada35fd6a2..81ebb7f2ddc 100644 --- a/xml/System/DuplicateWaitObjectException.xml +++ b/xml/System/DuplicateWaitObjectException.xml @@ -80,7 +80,7 @@ - Managed Threading + Managed Threading Handling and Throwing Exceptions diff --git a/xml/System/Func`1.xml b/xml/System/Func`1.xml index 75d28e019d2..c02e2609bcb 100644 --- a/xml/System/Func`1.xml +++ b/xml/System/Func`1.xml @@ -103,11 +103,11 @@ :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Func~1/fs/Func1.fs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/System/FuncTResult/Overview/Func1.vb" id="Snippet2"::: - You can use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/programming-guide/statements-expressions-operators/anonymous-methods).) + You can use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/language-reference/operators/delegate-operator).) :::code language="csharp" source="~/snippets/csharp/System/FuncTResult/Overview/Anon.cs" id="Snippet3"::: - You can also assign a lambda expression to a delegate, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (VB)](/dotnet/visual-basic/programming-guide/language-features/procedures/lambda-expressions), [Lambda Expressions (C#)](/dotnet/csharp/programming-guide/statements-expressions-operators/lambda-expressions), and [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword/).) + You can also assign a lambda expression to a delegate, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (VB)](/dotnet/visual-basic/programming-guide/language-features/procedures/lambda-expressions), [Lambda Expressions (C#)](/dotnet/csharp/language-reference/operators/lambda-expressions), and [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword/).) :::code language="csharp" source="~/snippets/csharp/System/FuncTResult/Overview/Lambda.cs" id="Snippet4"::: :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Func~1/fs/Lambda.fs" id="Snippet4"::: @@ -130,7 +130,7 @@ ]]> - Lambda Expressions (C# Programming Guide) + Lambda Expressions (C# Programming Guide) Lambda Expressions: The fun Keyword (F#) Lambda Expressions Delegates (C# Programming Guide) diff --git a/xml/System/Func`2.xml b/xml/System/Func`2.xml index e042d8f498a..59e2fd60ded 100644 --- a/xml/System/Func`2.xml +++ b/xml/System/Func`2.xml @@ -118,11 +118,11 @@ :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Func~2/fs/Func2_1.fs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/System/FuncT,TResult/Overview/Func2_1.vb" id="Snippet2"::: - You can also use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/programming-guide/statements-expressions-operators/anonymous-methods).) + You can also use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/language-reference/operators/delegate-operator).) :::code language="csharp" source="~/snippets/csharp/System/FuncT,TResult/Overview/Anon.cs" id="Snippet3"::: - You can also assign a lambda expression to a delegate, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (VB)](/dotnet/visual-basic/programming-guide/language-features/procedures/lambda-expressions), [Lambda Expressions (C#)](/dotnet/csharp/programming-guide/statements-expressions-operators/lambda-expressions) and [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) + You can also assign a lambda expression to a delegate, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (VB)](/dotnet/visual-basic/programming-guide/language-features/procedures/lambda-expressions), [Lambda Expressions (C#)](/dotnet/csharp/language-reference/operators/lambda-expressions) and [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) :::code language="csharp" source="~/snippets/csharp/System/FuncT,TResult/Overview/Lambda.cs" id="Snippet4"::: :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Func~2/fs/Lambda.fs" id="Snippet4"::: @@ -141,7 +141,7 @@ ]]> - Lambda Expressions (C# Programming Guide) + Lambda Expressions (C# Programming Guide) Lambda Expressions: The fun Keyword (F#) Lambda Expressions (Visual Basic) Delegates (C# Programming Guide) diff --git a/xml/System/Func`3.xml b/xml/System/Func`3.xml index 691039c8c41..c2e228b16e7 100644 --- a/xml/System/Func`3.xml +++ b/xml/System/Func`3.xml @@ -132,11 +132,11 @@ :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Func~3/fs/Func3.fs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/System/FuncT1,T2,TResult/Overview/Func3.vb" id="Snippet2"::: - You can use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/programming-guide/statements-expressions-operators/anonymous-methods).) + You can use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/language-reference/operators/delegate-operator).) :::code language="csharp" source="~/snippets/csharp/System/FuncT1,T2,TResult/Overview/Anon.cs" id="Snippet3"::: - You can also assign a lambda expression to a delegate, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (VB)](/dotnet/visual-basic/programming-guide/language-features/procedures/lambda-expressions), [Lambda Expressions (C#)](/dotnet/csharp/programming-guide/statements-expressions-operators/lambda-expressions) and [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) + You can also assign a lambda expression to a delegate, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (VB)](/dotnet/visual-basic/programming-guide/language-features/procedures/lambda-expressions), [Lambda Expressions (C#)](/dotnet/csharp/language-reference/operators/lambda-expressions) and [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) :::code language="csharp" source="~/snippets/csharp/System/FuncT1,T2,TResult/Overview/Lambda.cs" id="Snippet4"::: :::code language="fsharp" source="~/snippets/fsharp/VS_Snippets_CLR_System/system.Func~3/fs/Lambda.fs" id="Snippet4"::: @@ -155,7 +155,7 @@ ]]> - Lambda Expressions (C# Programming Guide) + Lambda Expressions (C# Programming Guide) Lambda Expressions: The fun Keyword (F#) Lambda Expressions Delegates (C# Programming Guide) diff --git a/xml/System/Func`4.xml b/xml/System/Func`4.xml index b873794c255..b94290d3c7e 100644 --- a/xml/System/Func`4.xml +++ b/xml/System/Func`4.xml @@ -146,11 +146,11 @@ :::code language="fsharp" source="~/snippets/fsharp/System/FuncT1,T2,T3,TResult/Overview/Func4.fs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/System/FuncT1,T2,T3,TResult/Overview/Func4.vb" id="Snippet2"::: - You can use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/programming-guide/statements-expressions-operators/anonymous-methods).) + You can use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/language-reference/operators/delegate-operator).) :::code language="csharp" source="~/snippets/csharp/System/FuncT1,T2,T3,TResult/Overview/Anon.cs" id="Snippet3"::: - You can also assign a lambda expression to a delegate, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (VB)](/dotnet/visual-basic/programming-guide/language-features/procedures/lambda-expressions), [Lambda Expressions (C#)](/dotnet/csharp/programming-guide/statements-expressions-operators/lambda-expressions) and [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) + You can also assign a lambda expression to a delegate, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (VB)](/dotnet/visual-basic/programming-guide/language-features/procedures/lambda-expressions), [Lambda Expressions (C#)](/dotnet/csharp/language-reference/operators/lambda-expressions) and [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) :::code language="csharp" source="~/snippets/csharp/System/FuncT1,T2,T3,TResult/Overview/Lambda.cs" id="Snippet4"::: :::code language="fsharp" source="~/snippets/fsharp/System/FuncT1,T2,T3,TResult/Overview/Lambda.fs" id="Snippet4"::: @@ -169,7 +169,7 @@ ]]> - Lambda Expressions (C# Programming Guide) + Lambda Expressions (C# Programming Guide) Lambda Expressions Lambda Expressions: The fun Keyword (F#) Delegates (C# Programming Guide) diff --git a/xml/System/Func`5.xml b/xml/System/Func`5.xml index f1660bafdcd..77e41f44e5b 100644 --- a/xml/System/Func`5.xml +++ b/xml/System/Func`5.xml @@ -134,11 +134,11 @@ :::code language="fsharp" source="~/snippets/fsharp/System/FuncT1,T2,T3,T4,TResult/Overview/Func5.fs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/System/FuncT1,T2,T3,T4,TResult/Overview/Func5.vb" id="Snippet2"::: - You can use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/programming-guide/statements-expressions-operators/anonymous-methods).) + You can use the delegate with anonymous methods in C#, as the following example illustrates. (For an introduction to anonymous methods, see [Anonymous Methods](/dotnet/csharp/language-reference/operators/delegate-operator).) :::code language="csharp" source="~/snippets/csharp/System/FuncT1,T2,T3,T4,TResult/Overview/Anon.cs" id="Snippet3"::: - You can also assign a lambda expression to a delegate, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (VB)](/dotnet/visual-basic/programming-guide/language-features/procedures/lambda-expressions), [Lambda Expressions (C#)](/dotnet/csharp/programming-guide/statements-expressions-operators/lambda-expressions) and [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) + You can also assign a lambda expression to a delegate, as the following example illustrates. (For an introduction to lambda expressions, see [Lambda Expressions (VB)](/dotnet/visual-basic/programming-guide/language-features/procedures/lambda-expressions), [Lambda Expressions (C#)](/dotnet/csharp/language-reference/operators/lambda-expressions) and [Lambda Expressions (F#)](/dotnet/fsharp/language-reference/functions/lambda-expressions-the-fun-keyword).) :::code language="csharp" source="~/snippets/csharp/System/FuncT1,T2,T3,T4,TResult/Overview/Lambda.cs" id="Snippet4"::: :::code language="fsharp" source="~/snippets/fsharp/System/FuncT1,T2,T3,T4,TResult/Overview/Lambda.fs" id="Snippet4"::: @@ -157,7 +157,7 @@ ]]> - Lambda Expressions (C# Programming Guide) + Lambda Expressions (C# Programming Guide) Lambda Expressions: The fun Keyword (F#) Lambda Expressions Delegates (C# Programming Guide) diff --git a/xml/System/IndexOutOfRangeException.xml b/xml/System/IndexOutOfRangeException.xml index 0a3c2c95bc3..d2d8674ae88 100644 --- a/xml/System/IndexOutOfRangeException.xml +++ b/xml/System/IndexOutOfRangeException.xml @@ -166,7 +166,7 @@ Using hard-coded index values to manipulate an array is likely to throw an exception if the index value is incorrect or invalid, or if the size of the array being manipulation is unexpected. To prevent an operation from throwing an exception, you can do the following: -- Iterate the elements of the array using the [foreach](/dotnet/csharp/language-reference/keywords/foreach-in) statement (in C#), the [for...in](/dotnet/fsharp/language-reference/loops-for-in-expression) statement (in F#), or the [For Each...Next](/dotnet/visual-basic/language-reference/statements/for-each-next-statement) construct (in Visual Basic) instead of iterating elements by index. +- Iterate the elements of the array using the [foreach](/dotnet/csharp/language-reference/statements/iteration-statements) statement (in C#), the [for...in](/dotnet/fsharp/language-reference/loops-for-in-expression) statement (in F#), or the [For Each...Next](/dotnet/visual-basic/language-reference/statements/for-each-next-statement) construct (in Visual Basic) instead of iterating elements by index. - Iterate the elements by index starting with the index returned by the method and ending with the index returned by the method. diff --git a/xml/System/IntPtr.xml b/xml/System/IntPtr.xml index c32ec01b7b6..eab97b22c80 100644 --- a/xml/System/IntPtr.xml +++ b/xml/System/IntPtr.xml @@ -278,7 +278,7 @@ This type implements the . In .NET 5 and later versions, this type also implements the interfaces. In .NET 7 and later versions, this type also implements the , , and interfaces. - In C# starting from version 9.0, you can use the built-in `nint` type to define native-sized integers. This type is represented by the type internally and provides operations and conversions that are appropriate for integer types. For more information, see [nint and nuint types](/dotnet/csharp/language-reference/builtin-types/nint-nuint). + In C# starting from version 9.0, you can use the built-in `nint` type to define native-sized integers. This type is represented by the type internally and provides operations and conversions that are appropriate for integer types. For more information, see [nint and nuint types](/dotnet/csharp/language-reference/builtin-types/integral-numeric-types). In C# starting from version 11 and when targeting the .NET 7 or later runtime, `nint` is an alias for in the same way that `int` is an alias for . diff --git a/xml/System/Math.xml b/xml/System/Math.xml index 84a53fe4994..84fdda2ec7e 100644 --- a/xml/System/Math.xml +++ b/xml/System/Math.xml @@ -3451,7 +3451,7 @@ Dim i2 As Integer = CInt(Math.Ceiling(d2)) ' Result: 7969 method. @@ -3529,7 +3529,7 @@ Dim i2 As Integer = CInt(Math.Ceiling(d2)) ' Result: 7969 method. @@ -3987,7 +3987,7 @@ Dim i2 As Integer = CInt(Math.Floor(d2)) ' Result: 7968 ## Remarks This operation complies with the remainder operation defined in Section 5.1 of ANSI/IEEE Std 754-1985; IEEE Standard for Binary Floating-Point Arithmetic; Institute of Electrical and Electronics Engineers, Inc; 1985. - The method is not the same as the [remainder operator](/dotnet/csharp/language-reference/operators/remainder-operator). Although both return the remainder after division, the formulas they use are different. The formula for the method is: + The method is not the same as the [remainder operator](/dotnet/csharp/language-reference/operators/arithmetic-operators). Although both return the remainder after division, the formulas they use are different. The formula for the method is: ```txt IEEERemainder = dividend - (divisor * Math.Round(dividend / divisor)) @@ -4004,7 +4004,7 @@ Remainder = (Math.Abs(dividend) - (Math.Abs(divisor) * ## Examples - The following example contrasts the remainder returned by the method with the remainder returned by the [remainder operator](/dotnet/csharp/language-reference/operators/remainder-operator). + The following example contrasts the remainder returned by the method with the remainder returned by the [remainder operator](/dotnet/csharp/language-reference/operators/arithmetic-operators). :::code language="csharp" source="~/snippets/csharp/System/Math/IEEERemainder/ieeeremainder1.cs" id="Snippet1"::: :::code language="fsharp" source="~/snippets/fsharp/System/Math/IEEERemainder/ieeeremainder1.fs" id="Snippet1"::: @@ -6586,7 +6586,6 @@ On hardware without specialized support, this may just return `1.0 / Sqrt(d)`. ## Remarks In this section: @@ -6595,7 +6594,6 @@ In this section: - [Midpoint values and rounding conventions](#midpoint-values-and-rounding-conventions) - [Rounding and precision](#rounding-and-precision) - [Rounding and single-precision floating point values](#rounding-and-single-precision-floating-point-values) -- [Examples of individual overloads](#round-examples) ### Which method do I call? @@ -6608,7 +6606,7 @@ You can use the following table to select an appropriate rounding method. In add |Round a number to a specified number of fractional digits by using the rounding to nearest convention.|
-or-
| |Round a number to a specified number of fractional digits by using a specified rounding convention.|
-or-
| |Round a value to a specified number of fractional digits by using a specified rounding convention and minimizing the loss of precision.|Convert the to a and call .| -|Round a number to a specified number of fractional digits while minimizing problems of precision in rounding midpoint values.|Call a rounding method that implements a "greater than or approximately equal to" comparison. See [Rounding and precision](#precision).| +|Round a number to a specified number of fractional digits while minimizing problems of precision in rounding midpoint values.|Call a rounding method that implements a "greater than or approximately equal to" comparison. See [Rounding and precision](#rounding-and-precision).| |Round a fractional value to an integer that is greater than the fractional value. For example, round 3.1 to 4.|| |Round a fractional value to an integer that is less than the fractional value. For example, round 3.9 to 3.|| @@ -6652,7 +6650,6 @@ By default, the method uses the round to nearest even | | Determined by `mode` parameter | | | Determined by `mode` parameter | - ### Rounding and precision In order to determine whether a rounding operation involves a midpoint value, the method multiplies the original value to be rounded by 10n, where *n* is the desired number of fractional digits in the return value, and then determines whether the remaining fractional portion of the value is greater than or equal to .5. This is a slight variation on a test for equality, and as discussed in the "Testing for Equality" section of the reference topic, tests for equality with floating-point values are problematic because of the floating-point format's issues with binary representation and precision. This means that any fractional portion of a number that is slightly less than .5 (because of a loss of precision) will not be rounded upward. @@ -6666,15 +6663,12 @@ The following example illustrates the problem. It repeatedly adds .1 to 11.0 and Problems of precision in rounding midpoint values are most likely to arise in the following conditions: - When a fractional value cannot be expressed precisely in the floating-point type's binary format. - - When the value to be rounded is calculated from one or more floating-point operations. - - When the value to be rounded is a rather than a or . For more information, see the next section, [Rounding and single-precision floating-point values](#rounding-and-single-precision-floating-point-values). - In cases where the lack of precision in rounding operations is problematic, you can do the following: +In cases where the lack of precision in rounding operations is problematic, you can do the following: - If the rounding operation calls an overload that rounds a value, you can change the to a value and call an overload that rounds a value instead. Although the data type also has problems of representation and loss of precision, these issues are far less common. - - Define a custom rounding algorithm that performs a "nearly equal" test to determine whether the value to be rounded is acceptably close to a midpoint value. The following example defines a `RoundApproximate` method that examines whether a fractional value is sufficiently near to a midpoint value to be subject to midpoint rounding. As the output from the example shows, it corrects the rounding problem shown in the previous example. :::code language="csharp" source="~/snippets/csharp/System/Decimal/Round/precision2.cs" id="Snippet8"::: @@ -6693,19 +6687,9 @@ This unexpected result is due to a loss of precision in the conversion of the value to a . Note that, because this is a narrowing conversion, it requires using a cast operator or calling a conversion method. - ## Examples -In addition to the examples in the [Remarks](#remarks-round) section, this article includes examples that illustrate the following overloads of the `Math.Round` method: - -[Math.Round(Decimal)](#Round1_Example) -[Math.Round(Double)](#Round2_Example) -[Math.Round(Decimal, Int32)](#Round3_Example) -[Math.Round(Decimal, MidpointRounding)](#Round4_Example) -[Math.Round(Double, Int32)](#Round5_Example) -[Math.Round(Double, MidpointRounding)](#Round6_Example) -[Math.Round(Decimal, Int32, MidpointRounding)](#Round7_Example) -[Math.Round(Double, Int32, MidpointRounding)](#Round8_Example) +In addition to the examples in the [Remarks](#remarks) section, there are examples in each overload of the `Math.Round` method. ]]> @@ -6773,7 +6757,6 @@ This method uses the default rounding convention of ## Examples The following example demonstrates the method. The value of 4.5 rounds to 4 rather than 5, because this overload uses the default convention. @@ -6866,7 +6849,6 @@ Dim d2 As Double = 7968.4136 Dim i2 As Integer = CInt(Math.Ceiling(d2)) ' Result: 7968 ``` - ## Example The following example demonstrates rounding to the nearest integer value. @@ -6953,7 +6935,6 @@ This method uses the default rounding convention of ## Example The following example rounds decimal values with two fractional digits to values that have a single fractional digit. @@ -7037,7 +7018,6 @@ For information about rounding numbers with midpoint values, see [Midpoint value [!INCLUDE[midpoint-rounding](~/includes/floating-point-equality.md)] - ## Example The following example displays values returned by the method with different `mode` values. @@ -7120,7 +7100,6 @@ This method uses the default rounding convention of , the method returns . If `value` is or , the method returns or , respectively. - ## Example The following example rounds double values with two fractional digits to doubles that have a single fractional digit. @@ -7208,7 +7187,6 @@ See [Midpoint values and rounding conventions](#midpoint-values-and-rounding-con If the value of the `value` argument is , the method returns . If `value` is or , the method returns or , respectively. - ## Example The following example displays values returned by the method with different `mode` values. @@ -7304,7 +7282,6 @@ See [Midpoint values and rounding conventions](#midpoint-values-and-rounding-con The value of the `decimals` argument can range from 0 to 28. - ## Example The following example demonstrates how to use the method with the enumeration. @@ -7390,7 +7367,6 @@ See [Midpoint values and rounding conventions](#midpoint-values-and-rounding-con If the value of the `value` argument is , the method returns . If `value` is or , the method returns or , respectively. - ## Example The following example demonstrates how to use the method with the enumeration. diff --git a/xml/System/MathF.xml b/xml/System/MathF.xml index 266e229b472..11f5cb42c8f 100644 --- a/xml/System/MathF.xml +++ b/xml/System/MathF.xml @@ -1237,7 +1237,7 @@ The value of this constant is 2.71828175. ## Remarks This operation complies with the remainder operation defined in Section 5.1 of ANSI/IEEE Std 754-1985; IEEE Standard for Binary Floating-Point Arithmetic; Institute of Electrical and Electronics Engineers, Inc; 1985. - The method is not the same as the [remainder operator](/dotnet/csharp/language-reference/operators/remainder-operator). Although both return the remainder after division, the formulas they use are different. The formula for the method is: + The method is not the same as the [remainder operator](/dotnet/csharp/language-reference/operators/arithmetic-operators). Although both return the remainder after division, the formulas they use are different. The formula for the method is: ```txt IEEERemainder = dividend - (divisor * MathF.Round(dividend / divisor)) diff --git a/xml/System/NullReferenceException.xml b/xml/System/NullReferenceException.xml index 1770c4f4a94..2988bbe2451 100644 --- a/xml/System/NullReferenceException.xml +++ b/xml/System/NullReferenceException.xml @@ -79,7 +79,7 @@ A exception is thrown when you try to access a member on a type whose value is `null`. A exception typically reflects developer error and is thrown in the following scenarios: > [!NOTE] -> You can avoid most `NullReferenceException` exceptions in C# by using the [null-conditional operator](/dotnet/csharp/language-reference/operators/null-conditional-operator) (`?.`) or the [null-coalescing operator](/dotnet/csharp/language-reference/operators/null-coalescing-operator) (`??`). For more information, see [Nullable reference types](/dotnet/csharp/whats-new/csharp-8#nullable-reference-types). The following C# examples assume the nullable context is disabled (not recommended). +> You can avoid most `NullReferenceException` exceptions in C# by using the [null-conditional operator](/dotnet/csharp/language-reference/operators/member-access-operators#null-conditional-operators--and-) (`?.`) or the [null-coalescing operator](/dotnet/csharp/language-reference/operators/null-coalescing-operator) (`??`). For more information, see [Nullable reference types](/dotnet/csharp/nullable-references). The following C# examples assume the nullable context is disabled (not recommended). - You forgot to instantiate a reference type. In the following example, `names` is declared but never instantiated (the affected line is commented out in the C# example since it doesn't compile): @@ -105,7 +105,7 @@ A exception is thrown when you try to acces :::code language="fsharp" source="~/snippets/fsharp/System/NullReferenceException/Overview/Array4.fs" id="Snippet11"::: :::code language="vb" source="~/snippets/visualbasic/System/NullReferenceException/Overview/Array4.vb" id="Snippet11"::: - For more information on declaring and initializing arrays, see [Arrays](/dotnet/csharp/programming-guide/arrays/) and [Arrays](/dotnet/visual-basic/programming-guide/language-features/arrays/). + For more information on declaring and initializing arrays, see [Arrays](/dotnet/csharp/language-reference/builtin-types/arrays) and [Arrays](/dotnet/visual-basic/programming-guide/language-features/arrays/). - You get a **null** return value from a method, and then call a method on the returned type. This sometimes is the result of a documentation error; the documentation fails to note that a method call can return `null`. In other cases, your code erroneously assumes that the method will always return a non-null value. diff --git a/xml/System/Nullable`1.xml b/xml/System/Nullable`1.xml index ed170ec7b8b..f70bbfa76e1 100644 --- a/xml/System/Nullable`1.xml +++ b/xml/System/Nullable`1.xml @@ -345,7 +345,7 @@ The following code example defines three rows of a table in the Microsoft Pubs s method returns a value even if the property is `false` (unlike the property, which throws an exception). If the property is `false`, the method returns the [default](/dotnet/csharp/language-reference/keywords/default-values-table) value of the underlying type. + The method returns a value even if the property is `false` (unlike the property, which throws an exception). If the property is `false`, the method returns the [default](/dotnet/csharp/language-reference/builtin-types/default-values) value of the underlying type. ]]> diff --git a/xml/System/ReadOnlySpan`1+Enumerator.xml b/xml/System/ReadOnlySpan`1+Enumerator.xml index 68aa6bd492e..19aeb5e63f4 100644 --- a/xml/System/ReadOnlySpan`1+Enumerator.xml +++ b/xml/System/ReadOnlySpan`1+Enumerator.xml @@ -97,7 +97,7 @@ ## Remarks -The C# [foreach](/dotnet/csharp/language-reference/keywords/foreach-in) of the C# language and the [For Each...Next](/dotnet/visual-basic/language-reference/statements/for-each-next-statement) construct in Visual Basic hides the complexity of enumerators. Instead of directly manipulating the enumerator, using `foreach` or `For Each...Next` is recommended. +The C# [foreach](/dotnet/csharp/language-reference/statements/iteration-statements) of the C# language and the [For Each...Next](/dotnet/visual-basic/language-reference/statements/for-each-next-statement) construct in Visual Basic hides the complexity of enumerators. Instead of directly manipulating the enumerator, using `foreach` or `For Each...Next` is recommended. Initially, the enumerator is positioned before the first element in the . At this position, is undefined. You must call to advance the enumerator to the first item in the before reading the value of . diff --git a/xml/System/Span`1+Enumerator.xml b/xml/System/Span`1+Enumerator.xml index 0d7259bf0d6..442ddc8117c 100644 --- a/xml/System/Span`1+Enumerator.xml +++ b/xml/System/Span`1+Enumerator.xml @@ -95,7 +95,7 @@ . At this position, is undefined. You must call to advance the enumerator to the first item in the before reading the value of . @@ -115,7 +115,7 @@ If you synchronize access to the array before enumerating the span, as the revis Unlike some other enumerator structures in .NET, the : -- Does not implement the or interface. This is because is a [ref struct](/dotnet/csharp/reference-semantics-with-value-types#ref-struct-type). +- Does not implement the or interface. This is because is a [ref struct](/dotnet/csharp/advanced-topics/performance/). - Does not include a `Reset` method, which can set the enumerator to its initial position before the first element in the span. (The method must be implemented as part of the interface, but most implementors either throw an exception or provide no implementation.) diff --git a/xml/System/String.xml b/xml/System/String.xml index 4db1819ab6a..3829760c095 100644 --- a/xml/System/String.xml +++ b/xml/System/String.xml @@ -5939,8 +5939,6 @@ This method uses the [composite formatting feature](/dotnet/standard/base-types/ [!INCLUDE[provider-string-format](~/includes/remarks/System/String/provider-string-format.md)] - - ### Example: Culture-sensitive formatting This example uses the method to display the string representation of some date and time values and numeric values by using several different cultures. @@ -6797,7 +6795,7 @@ The index of a format item is less than zero, or greater than two. ## Remarks > [!TIP] -> Rather than calling the method to retrieve a object that you then use to enumerate a string, you should instead use your language's iteration construct. Examples include [foreach](/dotnet/csharp/language-reference/keywords/foreach-in) in C#, [for..in](/dotnet/fsharp/language-reference/loops-for-in-expression) in F#, and [For Each](/dotnet/visual-basic/language-reference/statements/for-each-next-statement) in Visual Basic). +> Rather than calling the method to retrieve a object that you then use to enumerate a string, you should instead use your language's iteration construct. Examples include [foreach](/dotnet/csharp/language-reference/statements/iteration-statements) in C#, [for..in](/dotnet/fsharp/language-reference/loops-for-in-expression) in F#, and [For Each](/dotnet/visual-basic/language-reference/statements/for-each-next-statement) in Visual Basic). This method enables you to iterate the individual characters in a string. For example, the Visual Basic `For Each`, the F# `for..in` expression, and C# `foreach` statements invoke this method to return a object that can provide read-only access to the characters in this string instance. diff --git a/xml/System/ThreadStaticAttribute.xml b/xml/System/ThreadStaticAttribute.xml index a7aaa411f85..44dcda21884 100644 --- a/xml/System/ThreadStaticAttribute.xml +++ b/xml/System/ThreadStaticAttribute.xml @@ -95,7 +95,7 @@ The following example code demonstrates how to use the `ThreadStaticAttribute` t Extending Metadata Using Attributes - Managed Threading + Managed Threading diff --git a/xml/System/Type.xml b/xml/System/Type.xml index 8b572a68f81..59cf598e843 100644 --- a/xml/System/Type.xml +++ b/xml/System/Type.xml @@ -380,7 +380,7 @@ TopNamespace.Sub\+Namespace.ContainingClass+NestedClass, MyAssembly, Version=1.3 - Specifying Fully Qualified Type Names + Specifying Fully Qualified Type Names @@ -1678,7 +1678,7 @@ The `filter` argument can be a custom delegate of type - Specifying Fully Qualified Type Names + Specifying Fully Qualified Type Names @@ -9063,7 +9063,7 @@ The following example retrieves the `Type` object of a user-defined class, retri To be added. A class initializer is invoked and throws an exception. - Specifying Fully Qualified Type Names + Specifying Fully Qualified Type Names @@ -9272,7 +9272,7 @@ Type.GetType("System.Collections.Generic.Dictionary`2[System.String,[MyType,MyAs - Specifying Fully Qualified Type Names + Specifying Fully Qualified Type Names @@ -9506,7 +9506,7 @@ Type.GetType("System.Collections.Generic.Dictionary`2[System.String,[MyType,MyAs - Specifying Fully Qualified Type Names + Specifying Fully Qualified Type Names @@ -9731,7 +9731,7 @@ Type.GetType("System.Collections.Generic.Dictionary`2[System.String,[MyType,MyAs - Specifying Fully Qualified Type Names + Specifying Fully Qualified Type Names @@ -17117,7 +17117,7 @@ The following example uses the method to cre - Specifying Fully Qualified Type Names + Specifying Fully Qualified Type Names @@ -17423,7 +17423,7 @@ The following example uses the method to cre - Specifying Fully Qualified Type Names + Specifying Fully Qualified Type Names How to: Load Assemblies into the Reflection-Only Context diff --git a/xml/System/UIntPtr.xml b/xml/System/UIntPtr.xml index 592b32559af..36e16c89f94 100644 --- a/xml/System/UIntPtr.xml +++ b/xml/System/UIntPtr.xml @@ -280,7 +280,7 @@ This type implements the . In .NET 5 and later versions, this type also implements the interfaces. In .NET 7 and later versions, this type also implements the , , and interfaces. - In C# starting from version 9.0, you can use the built-in `nuint` type to define native-sized integers. This type is represented by the type internally and provides operations and conversions that are appropriate for integer types. For more information, see [nint and nuint types](/dotnet/csharp/language-reference/builtin-types/nint-nuint). + In C# starting from version 9.0, you can use the built-in `nuint` type to define native-sized integers. This type is represented by the type internally and provides operations and conversions that are appropriate for integer types. For more information, see [nint and nuint types](/dotnet/csharp/language-reference/builtin-types/integral-numeric-types). In C# starting from version 11 and when targeting the .NET 7 or later runtime, `nuint` is an alias for in the same way that `uint` is an alias for .