Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions xml/System.Numerics/Complex.xml
Original file line number Diff line number Diff line change
Expand Up @@ -6844,7 +6844,7 @@ Languages that support custom operators can use the <xref:System.Numerics.Comple
<format type="text/markdown"><![CDATA[

## Remarks
The default string representation of a complex number displays the number using its Cartesian coordinates in the form `<a; b>` (or `(a, b)` in .NET Framework), where *a* is the real part of the complex number, and *b* is its imaginary part. Both *a* and *b* are formatted using the general format specifier ("G") and the conventions of the current system culture.
The default string representation of a complex number displays the number using its Cartesian coordinates in the form `<a; b>` where *a* is the real part of the complex number, and *b* is its imaginary part. Both *a* and *b* are formatted using the general format specifier ("G") and the conventions of the current system culture.

## Examples
The following example displays the string representation of several complex numbers. The output uses the formatting conventions of the English - United States ("en-US") culture, which, in this case, is the current system culture.
Expand Down Expand Up @@ -6911,7 +6911,7 @@ Languages that support custom operators can use the <xref:System.Numerics.Comple
<format type="text/markdown"><![CDATA[

## Remarks
The string representation of the complex number returned by this method displays the number using its Cartesian coordinates in the form `<a; b>` (or `(a, b)` in .NET Framework), where *a* is the real part of the complex number, and *b* is its imaginary part. Both *a* and *b* are formatted using the general format specifier ("G") and the conventions of the culture defined by `provider`.
The string representation of the complex number returned by this method displays the number using its Cartesian coordinates in the form `<a; b>` where *a* is the real part of the complex number, and *b* is its imaginary part. Both *a* and *b* are formatted using the general format specifier ("G") and the conventions of the culture defined by `provider`.

The `provider` parameter is an <xref:System.IFormatProvider> implementation. Its <xref:System.IFormatProvider.GetFormat*> method returns a <xref:System.Globalization.NumberFormatInfo> object that provides culture-specific information about the format of the real and imaginary numbers in the returned string. If `provider` is `null`, the returned string is formatted using the <xref:System.Globalization.NumberFormatInfo> object of the current culture.

Expand Down Expand Up @@ -6990,7 +6990,7 @@ Languages that support custom operators can use the <xref:System.Numerics.Comple
<format type="text/markdown"><![CDATA[

## Remarks
The string representation of the complex number returned by this method displays the number using its Cartesian coordinates in the form `<a; b>` (or `(a, b)` in .NET Framework), where *a* is the real part of the complex number, and *b* is its imaginary part. Both *a* and *b* are formatted using the format string specified by `format`. The `format` parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. If `format` is equal to <xref:System.String.Empty?displayProperty=nameWithType> or is `null`, the real and imaginary parts of the complex number are formatted with the general format specifier ("G"). If `format` is any other value, the method throws a <xref:System.FormatException>.
The string representation of the complex number returned by this method displays the number using its Cartesian coordinates in the form `<a; b>` where *a* is the real part of the complex number, and *b* is its imaginary part. Both *a* and *b* are formatted using the format string specified by `format`. The `format` parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. If `format` is equal to <xref:System.String.Empty?displayProperty=nameWithType> or is `null`, the real and imaginary parts of the complex number are formatted with the general format specifier ("G"). If `format` is any other value, the method throws a <xref:System.FormatException>.

.NET provides extensive formatting support, which is described in greater detail in the following articles:

Expand Down Expand Up @@ -7079,7 +7079,7 @@ Languages that support custom operators can use the <xref:System.Numerics.Comple
<format type="text/markdown"><![CDATA[

## Remarks
The string representation of the complex number returned by this method displays the number using its Cartesian coordinates in the form `<a; b>` (or `(a, b)` in .NET Framework), where *a* is the real part of the complex number, and *b* is its imaginary part. Both *a* and *b* are formatted using the format string specified by `format`. The `format` parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. If `format` is equal to <xref:System.String.Empty?displayProperty=nameWithType> or is `null`, the real and imaginary parts of the complex number are formatted with the general format specifier ("G"). If `format` is any other value, the method throws a <xref:System.FormatException>.
The string representation of the complex number returned by this method displays the number using its Cartesian coordinates in the form `<a; b>` where *a* is the real part of the complex number, and *b* is its imaginary part. Both *a* and *b* are formatted using the format string specified by `format`. The `format` parameter can be any valid standard numeric format specifier, or any combination of custom numeric format specifiers. If `format` is equal to <xref:System.String.Empty?displayProperty=nameWithType> or is `null`, the real and imaginary parts of the complex number are formatted with the general format specifier ("G"). If `format` is any other value, the method throws a <xref:System.FormatException>.

.NET provides extensive formatting support, which is described in greater detail in the following articles:

Expand Down
1 change: 0 additions & 1 deletion xml/System.Printing/PrintQueue.xml
Original file line number Diff line number Diff line change
Expand Up @@ -601,7 +601,6 @@
</remarks>
<altmember cref="T:System.Threading.ApartmentState" />
<altmember cref="T:System.STAThreadAttribute" />
<related type="Article" href="/dotnet/framework/interop/exposing-com-components">Exposing COM Components to the .NET Framework</related>
</Docs>
</Member>
<Member MemberName="AddJob">
Expand Down
9 changes: 1 addition & 8 deletions xml/System.Printing/PrintSystemJobInfo.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1021,14 +1021,7 @@
<Docs>
<summary>Gets a reference to the <see cref="T:System.IO.Stream" /> of the print job.</summary>
<value>A <see cref="T:System.IO.Stream" /> that contains the print job.</value>
<remarks>
<format type="text/markdown"><![CDATA[

## Remarks
Starting with the .NET Framework 4.5 on Windows 8 and later versions of the operating system, data written to this stream must be in XPS format as a package stream.

]]></format>
</remarks>
<remarks>Data written to this stream must be in XPS format as a package stream.</remarks>
</Docs>
</Member>
<Member MemberName="NumberOfPages">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -41,14 +41,12 @@
<format type="text/markdown"><![CDATA[

## Remarks
Typically, resources separate code from content within an application. Creating and consuming these resources makes it easier to develop localizable applications. In the .NET Framework, resources are usually consumed by using the <xref:System.Resources.ResourceManager> class, which contains methods that provide access to culture-specific resources at run time. For more information about creating and consuming resources, see [Resources in Desktop Apps](/dotnet/framework/resources/).
Typically, resources separate code from content within an application. Creating and consuming these resources makes it easier to develop localizable applications. In .NET, resources are usually consumed by using the <xref:System.Resources.ResourceManager> class, which contains methods that provide access to culture-specific resources at run time. For more information about creating and consuming resources, see [Resources in .NET apps](/dotnet/core/extensions/resources).

Strongly typed resource support is a compile-time feature that encapsulates access to resources by creating classes that contain a set of static, read-only (`get`) properties. This provides an alternative way to consume resources instead of calling the <xref:System.Resources.ResourceManager.GetString*?displayProperty=nameWithType> and <xref:System.Resources.ResourceManager.GetObject*?displayProperty=nameWithType> methods.

The basic functionality for strongly typed resource support is provided by the <xref:System.Resources.Tools.StronglyTypedResourceBuilder> class (as well as the `/str` command-line option in the [Resgen.exe (Resource File Generator)](/dotnet/framework/tools/resgen-exe-resource-file-generator)). The output of the <xref:System.Resources.Tools.StronglyTypedResourceBuilder.Create*> method is a class that contains strongly typed properties that match the resources that are referenced in the input parameter. This class provides read-only access to the resources that are available in the file processed.



## Examples
The following example generates a class named `DemoResources` that is written in C# or Visual Basic (depending on the example's source code). This class is in the `DemoApp` namespace and has properties that return the bitmap of a logo and the name of an application. The example calls a `CreateResourceFile` method to create the necessary .resw file and requires that a bitmap file named Logo.bmp be found in the example's current directory. The code example uses the following resource file, named demo.resx:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@
<format type="text/markdown"><![CDATA[

## Remarks
The default culture is the culture whose resources are loaded if the appropriate culture-specific resources cannot be found. By default, resources for the default culture are located in the main assembly, and a <xref:System.Resources.MissingManifestResourceException> is thrown if the resource manager tries to retrieve but cannot find a resource for the default culture. However, the .NET Framework will load the resources for an app's default culture from a satellite assembly if the <xref:System.Resources.NeutralResourcesLanguageAttribute> attribute specifies a value of <xref:System.Resources.UltimateResourceFallbackLocation.Satellite?displayProperty=nameWithType> for the location parameter. When this is the case, the <xref:System.Resources.MissingSatelliteAssemblyException> exception is thrown when the resource manager tries to retrieve a resource of the default culture and the satellite assembly for the culture specified in the <xref:System.Resources.NeutralResourcesLanguageAttribute> attribute is missing. Note that the exception is thrown by a resource retrieval method such as <xref:System.Resources.ResourceManager.GetString*?displayProperty=nameWithType> or <xref:System.Resources.ResourceManager.GetObject*?displayProperty=nameWithType>, and not when the <xref:System.Resources.ResourceManager> object is instantiated.
The default culture is the culture whose resources are loaded if the appropriate culture-specific resources cannot be found. By default, resources for the default culture are located in the main assembly, and a <xref:System.Resources.MissingManifestResourceException> is thrown if the resource manager tries to retrieve but cannot find a resource for the default culture. However, .NET loads the resources for an app's default culture from a satellite assembly if the <xref:System.Resources.NeutralResourcesLanguageAttribute> attribute specifies a value of <xref:System.Resources.UltimateResourceFallbackLocation.Satellite?displayProperty=nameWithType> for the location parameter. When this is the case, the <xref:System.Resources.MissingSatelliteAssemblyException> exception is thrown when the resource manager tries to retrieve a resource of the default culture and the satellite assembly for the culture specified in the <xref:System.Resources.NeutralResourcesLanguageAttribute> attribute is missing. Note that the exception is thrown by a resource retrieval method such as <xref:System.Resources.ResourceManager.GetString*?displayProperty=nameWithType> or <xref:System.Resources.ResourceManager.GetObject*?displayProperty=nameWithType>, and not when the <xref:System.Resources.ResourceManager> object is instantiated.

<xref:System.Resources.MissingSatelliteAssemblyException> uses the HRESULT COR_E_MISSINGSATELLITEASSEMBLY, which has the value 0x80131536.

Expand Down
7 changes: 1 addition & 6 deletions xml/System.Resources/ResXResourceReader.xml
Original file line number Diff line number Diff line change
Expand Up @@ -75,11 +75,6 @@

If you want to retrieve named resources from a .resx file rather than enumerating its resources, you can instantiate a <xref:System.Resources.ResXResourceSet> object and call its `GetString` and `GetObject` methods.

> [!NOTE]
> The <xref:System.Resources.ResXResourceReader> class contains a link demand and an inheritance demand at the class level that applies to all members. A <xref:System.Security.SecurityException> exception is thrown when either the immediate caller or the derived class does not have full-trust permission.



## Examples
The following example demonstrates how to use a <xref:System.Resources.ResXResourceReader> to iterate through the resources in a .resx file. First, the <xref:System.Resources.ResXResourceReader> `rsxr` is created for the file `items.resx`. Next, the <xref:System.Resources.ResXResourceReader.GetEnumerator*> method is used to create an <xref:System.Collections.IDictionaryEnumerator> to iterate through the resources and display the contents to the console.

Expand Down Expand Up @@ -439,7 +434,7 @@
:::code language="csharp" source="~/snippets/csharp/System.Resources/ResXResourceReader/BasePath/basepathex1.cs" id="Snippet1":::
:::code language="vb" source="~/snippets/visualbasic/System.Resources/ResXResourceReader/BasePath/basepathex1.vb" id="Snippet1":::

Note that you must add a reference to System.Drawing.dll to compile the project successfully. The example also requires that the necessary images exist in a directory named C:\data\images\\.
The example requires that the necessary images exist in a directory named C:\data\images\\.

]]></format>
</remarks>
Expand Down
44 changes: 9 additions & 35 deletions xml/System.Resources/ResXResourceWriter.xml
Original file line number Diff line number Diff line change
Expand Up @@ -51,11 +51,6 @@

For more information on the format of a.resx file, see [Working with .resx Files Programmatically](/dotnet/framework/resources/working-with-resx-files-programmatically).

> [!NOTE]
> This class contains a link demand and an inheritance demand at the class level that applies to all members. A <xref:System.Security.SecurityException> is thrown when either the immediate caller or the derived class does not have full-trust permission.



## Examples
The following example creates a .resx file named `CarResources.resx` that stores six strings, an icon, and two application-defined objects (two `Automobile` objects). Note that the `Automobile` class, which is defined and instantiated in the example, is tagged with the <xref:System.SerializableAttribute> attribute.

Expand Down Expand Up @@ -210,16 +205,9 @@
</Parameters>
<Docs>
<param name="stream">The stream to send the output to.</param>
<param name="typeNameConverter">The delegate that is used to target earlier versions of the .NET Framework.</param>
<summary>Initializes a new instance of the <see cref="T:System.Resources.ResXResourceWriter" /> class that writes the resources to a specified stream object and sets a converter delegate. This delegate enables resource assemblies to be written that target versions of the .NET Framework before .NET Framework 4 by using qualified assembly names.</summary>
<remarks>
<format type="text/markdown"><![CDATA[

## Remarks
Visual Studio and MSBuild use this constructor when you create resources for an application that target versions of the .NET Framework before .NET Framework 4.

]]></format>
</remarks>
<param name="typeNameConverter">The delegate that is used to target earlier versions of .NET Framework.</param>
<summary>Initializes a new instance of the <see cref="T:System.Resources.ResXResourceWriter" /> class that writes the resources to a specified stream object and sets a converter delegate. This delegate enables resource assemblies to be written that target versions of .NET Framework before .NET Framework 4 by using qualified assembly names.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
Expand Down Expand Up @@ -255,16 +243,9 @@
</Parameters>
<Docs>
<param name="textWriter">The object to send output to.</param>
<param name="typeNameConverter">The delegate that is used to target earlier versions of the .NET Framework.</param>
<summary>Initializes a new instance of the <see cref="T:System.Resources.ResXResourceWriter" /> class that writes the resources to a specified <see cref="T:System.IO.TextWriter" /> object and sets a delegate that enables resource assemblies to be written that target versions of the .NET Framework before .NET Framework 4 by using qualified assembly names.</summary>
<remarks>
<format type="text/markdown"><![CDATA[

## Remarks
Visual Studio and MSBuild use this constructor when you create resources for an application that target versions of the .NET Framework before the .NET Framework 4.

]]></format>
</remarks>
<param name="typeNameConverter">The delegate that is used to target earlier versions of .NET Framework.</param>
<summary>Initializes a new instance of the <see cref="T:System.Resources.ResXResourceWriter" /> class that writes the resources to a specified <see cref="T:System.IO.TextWriter" /> object and sets a delegate that enables resource assemblies to be written that target versions of .NET Framework before .NET Framework 4 by using qualified assembly names.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
Expand Down Expand Up @@ -300,16 +281,9 @@
</Parameters>
<Docs>
<param name="fileName">The file to send output to.</param>
<param name="typeNameConverter">The delegate that is used to target earlier versions of the .NET Framework.</param>
<summary>Initializes a new instance of the <see cref="T:System.Resources.ResXResourceWriter" /> class that writes the resources to a specified file and sets a delegate that enables resource assemblies to be written that target versions of the .NET Framework before .NET Framework 4 by using qualified assembly names.</summary>
<remarks>
<format type="text/markdown"><![CDATA[

## Remarks
Visual Studio and MSBuild use this constructor when you create resources for an application that target versions of the .NET Framework before .NET Framework 4.

]]></format>
</remarks>
<param name="typeNameConverter">The delegate that is used to target earlier versions of .NET Framework.</param>
<summary>Initializes a new instance of the <see cref="T:System.Resources.ResXResourceWriter" /> class that writes the resources to a specified file and sets a delegate that enables resource assemblies to be written that target versions of .NET Framework before .NET Framework 4 by using qualified assembly names.</summary>
<remarks>To be added.</remarks>
<exception cref="T:System.IO.DirectoryNotFoundException">The directory specified in <paramref name="fileName" /> does not exist.</exception>
</Docs>
</Member>
Expand Down
Loading
Loading