Skip to content
Merged
Show file tree
Hide file tree
Changes from 5 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
404 changes: 202 additions & 202 deletions xml/System.Drawing.Design/ToolboxService.xml

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion xml/System.Drawing.Drawing2D/GraphicsPath.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5437,7 +5437,7 @@
<ReturnType>System.Drawing.Drawing2D.PathData</ReturnType>
</ReturnValue>
<Docs>
<summary>Gets a <see cref="T:System.Drawing.Drawing2D.PathData" /> that encapsulates arrays of points (<paramref name="points" />) and types (<paramref name="types" />) for this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</summary>
<summary>Gets a <see cref="T:System.Drawing.Drawing2D.PathData" /> that encapsulates arrays of points and types for this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</summary>
<value>A <see cref="T:System.Drawing.Drawing2D.PathData" /> that encapsulates arrays for both the points and types for this <see cref="T:System.Drawing.Drawing2D.GraphicsPath" />.</value>
<remarks>To be added.</remarks>
</Docs>
Expand Down
2 changes: 1 addition & 1 deletion xml/System.Drawing.Imaging/EncoderParameter.xml
Original file line number Diff line number Diff line change
Expand Up @@ -544,7 +544,7 @@
<param name="encoder">An <see cref="T:System.Drawing.Imaging.Encoder" /> object that encapsulates the globally unique identifier of the parameter category.</param>
<param name="numberValues">An integer that specifies the number of values stored in the <see cref="T:System.Drawing.Imaging.EncoderParameter" /> object. The <see cref="P:System.Drawing.Imaging.EncoderParameter.NumberOfValues" /> property is set to this value.</param>
<param name="type">A member of the <see cref="T:System.Drawing.Imaging.EncoderParameterValueType" /> enumeration that specifies the data type of the values stored in the <see cref="T:System.Drawing.Imaging.EncoderParameter" /> object. The <see cref="T:System.Type" /> and <see cref="P:System.Drawing.Imaging.EncoderParameter.ValueType" /> properties are set to this value.</param>
<param name="value">A pointer to an array of values of the type specified by the <paramref name="Type" /> parameter.</param>
<param name="value">A pointer to an array of values of the type specified by the <paramref name="type" /> parameter.</param>
<summary>Initializes a new instance of the <see cref="T:System.Drawing.Imaging.EncoderParameter" /> class with the specified <see cref="T:System.Drawing.Imaging.Encoder" /> object, number of values, data type of the values, and a pointer to the values stored in the <see cref="T:System.Drawing.Imaging.EncoderParameter" /> object.</summary>
<remarks>To be added.</remarks>
</Docs>
Expand Down
50 changes: 25 additions & 25 deletions xml/System.Drawing/ColorConverter.xml
Original file line number Diff line number Diff line change
Expand Up @@ -46,20 +46,20 @@
<Docs>
<summary>Converts colors from one data type to another. Access this class through the <see cref="T:System.ComponentModel.TypeDescriptor" />.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
When converting from a string to a <xref:System.Drawing.Color> the <xref:System.Drawing.ColorConverter> expects the unqualified color name; otherwise, an exception will occur in the conversion process. For example, you should pass "Blue", not "System.Drawing.Color.Blue" or "Color.Blue", to the <xref:System.Drawing.ColorConverter.ConvertFrom%2A> method.
## Examples
The following code example demonstrates how to use the <xref:System.ComponentModel.TypeConverter.ConvertToString%2A> method. This example is designed to be used with Windows Forms. Paste this code into a form and call the `ShowColorConverter` method when handling the form's <xref:System.Windows.Forms.Control.Paint> event, passing `e` as <xref:System.Windows.Forms.PaintEventArgs>.
<format type="text/markdown"><![CDATA[

## Remarks
When converting from a string to a <xref:System.Drawing.Color> the <xref:System.Drawing.ColorConverter> expects the unqualified color name; otherwise, an exception will occur in the conversion process. For example, you should pass "Blue", not "System.Drawing.Color.Blue" or "Color.Blue", to the <xref:System.Drawing.ColorConverter.ConvertFrom%2A> method.



## Examples
The following code example demonstrates how to use the <xref:System.ComponentModel.TypeConverter.ConvertToString%2A> method. This example is designed to be used with Windows Forms. Paste this code into a form and call the `ShowColorConverter` method when handling the form's <xref:System.Windows.Forms.Control.Paint> event, passing `e` as <xref:System.Windows.Forms.PaintEventArgs>.

:::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.Converters/CPP/form1.cpp" id="Snippet2":::
:::code language="csharp" source="~/snippets/csharp/System.Drawing/ColorConverter/Overview/form1.cs" id="Snippet2":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Converters/VB/form1.vb" id="Snippet2":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/System.Drawing.Converters/VB/form1.vb" id="Snippet2":::

]]></format>
</remarks>
</Docs>
Expand Down Expand Up @@ -202,8 +202,8 @@
</Parameter>
</Parameters>
<Docs>
<param name="context">An <see cref="T:System.ComponentModel.ITypeDescriptorContext" /> that provides a format context.</param>
<param name="destinationType">A <see cref="T:System.Type" /> that represents the type to which you want to convert.</param>
<param name="context">A format context.</param>
<param name="destinationType">The type to which you want to convert.</param>
<summary>Returns a value indicating whether this converter can convert an object to the given destination type using the context.</summary>
<returns>
<see langword="true" /> if this converter can perform the operation; otherwise, <see langword="false" />.</returns>
Expand Down Expand Up @@ -262,11 +262,11 @@
<summary>Converts the given object to the converter's native type.</summary>
<returns>An <see cref="T:System.Object" /> representing the converted value.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
When converting from a string to a <xref:System.Drawing.Color> the <xref:System.Drawing.ColorConverter> expects the unqualified color name; otherwise, an exception will occur in the conversion process. For example, you should pass "Blue", not "System.Drawing.Color.Blue" or "Color.Blue", to the <xref:System.Drawing.ColorConverter.ConvertFrom%2A> method.
<format type="text/markdown"><![CDATA[

## Remarks
When converting from a string to a <xref:System.Drawing.Color> the <xref:System.Drawing.ColorConverter> expects the unqualified color name; otherwise, an exception will occur in the conversion process. For example, you should pass "Blue", not "System.Drawing.Color.Blue" or "Color.Blue", to the <xref:System.Drawing.ColorConverter.ConvertFrom%2A> method.

]]></format>
</remarks>
<exception cref="T:System.ArgumentException">The conversion cannot be performed.</exception>
Expand Down Expand Up @@ -326,15 +326,15 @@
<summary>Converts the specified object to another type.</summary>
<returns>An <see cref="T:System.Object" /> representing the converted value.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
The most common conversion is to or from a string.
<format type="text/markdown"><![CDATA[

## Remarks
The most common conversion is to or from a string.

]]></format>
</remarks>
<exception cref="T:System.ArgumentNullException">
<paramref name="destinationtype" /> is <see langword="null" />.</exception>
<paramref name="destinationType" /> is <see langword="null" />.</exception>
<exception cref="T:System.NotSupportedException">The conversion cannot be performed.</exception>
</Docs>
</Member>
Expand Down
12 changes: 5 additions & 7 deletions xml/System.Drawing/Graphics.xml
Original file line number Diff line number Diff line change
Expand Up @@ -14340,11 +14340,9 @@ The <see cref="T:System.Drawing.Graphics" /> object has a transform applied othe
## Examples
The following code example is designed for use with Windows Forms, and it requires <xref:System.Windows.Forms.PaintEventArgs> `e`, which is a parameter of the <xref:System.Windows.Forms.Control.Paint> event handler. The code performs the following action:

- Creates a solid blue brush.

- Creates an array of three rectangles.

- Fills the three rectangular areas on the screen.
- Creates a solid blue brush.
- Creates an array of three rectangles.
- Fills the three rectangular areas on the screen.

:::code language="cpp" source="~/snippets/cpp/VS_Snippets_Winforms/System.Drawing.ClassicGraphicsExamples3/CPP/form1.cpp" id="Snippet116":::
:::code language="csharp" source="~/snippets/csharp/System.Drawing/Graphics/FillRectangle/form1.cs" id="Snippet116":::
Expand All @@ -14359,7 +14357,7 @@ The <see cref="T:System.Drawing.Graphics" /> object has a transform applied othe

<paramref name="rects" /> is <see langword="null" />.</exception>
<exception cref="T:System.ArgumentException">
<paramref name="Rects" /> is a zero-length array.</exception>
<paramref name="rects" /> is a zero-length array.</exception>
</Docs>
</Member>
<Member MemberName="FillRectangles">
Expand Down Expand Up @@ -17154,7 +17152,7 @@ The <see cref="T:System.Drawing.Graphics" /> object has a transform applied othe
<param name="format">
<see cref="T:System.Drawing.StringFormat" /> that represents formatting information, such as line spacing, for the string.</param>
<summary>Measures the specified string when drawn with the specified <see cref="T:System.Drawing.Font" /> and formatted with the specified <see cref="T:System.Drawing.StringFormat" />.</summary>
<returns>This method returns a <see cref="T:System.Drawing.SizeF" /> structure that represents the size, in the units specified by the <see cref="P:System.Drawing.Graphics.PageUnit" /> property, of the string specified in the <paramref name="text" /> parameter as drawn with the <paramref name="font" /> parameter and the <paramref name="stringFormat" /> parameter.</returns>
<returns>This method returns a <see cref="T:System.Drawing.SizeF" /> structure that represents the size, in the units specified by the <see cref="P:System.Drawing.Graphics.PageUnit" /> property, of the string specified in the <paramref name="text" /> parameter as drawn with the <paramref name="font" /> parameter and the <paramref name="format" /> parameter.</returns>
<remarks>
<format type="text/markdown"><![CDATA[

Expand Down
4 changes: 2 additions & 2 deletions xml/System.Drawing/Icon.xml
Original file line number Diff line number Diff line change
Expand Up @@ -348,7 +348,7 @@

]]></format>
</remarks>
<exception cref="T:System.ArgumentException">The <paramref name="string" /> is <see langword="null" /> or does not contain image data.</exception>
<exception cref="T:System.ArgumentException">The <paramref name="fileName" /> is <see langword="null" /> or does not contain image data.</exception>
</Docs>
</Member>
<Member MemberName=".ctor">
Expand Down Expand Up @@ -539,7 +539,7 @@

]]></format>
</remarks>
<exception cref="T:System.ArgumentException">The <paramref name="string" /> is <see langword="null" /> or does not contain image data.</exception>
<exception cref="T:System.ArgumentException">The <paramref name="fileName" /> is <see langword="null" /> or does not contain image data.</exception>
</Docs>
</Member>
<Member MemberName="Clone">
Expand Down
16 changes: 6 additions & 10 deletions xml/System.Globalization/CompareInfo.xml
Original file line number Diff line number Diff line change
Expand Up @@ -184,18 +184,14 @@
By default, the comparison is performed by using <xref:System.Globalization.CompareOptions.None?displayProperty=nameWithType>. If a security decision depends on a string comparison or a case change, you should use the <xref:System.Globalization.CultureInfo.InvariantCulture%2A> property to ensure that the behavior is consistent regardless of the culture settings of the operating system.

> [!NOTE]
> When possible, you should call string comparison methods that have a parameter of type <xref:System.Globalization.CompareOptions> to specify the kind of comparison expected. As a general rule, use linguistic options (using the current culture) for comparing strings displayed in the user interface and specify <xref:System.Globalization.CompareOptions.Ordinal> or <xref:System.Globalization.CompareOptions.OrdinalIgnoreCase> for security comparisons.


> When possible, you should call string comparison methods that have a parameter of type <xref:System.Globalization.CompareOptions> to specify the kind of comparison expected. As a general rule, use linguistic options (using the current culture) for comparing strings displayed in the user interface and specify <xref:System.Globalization.CompareOptions.Ordinal> or <xref:System.Globalization.CompareOptions.OrdinalIgnoreCase> for security comparisons.

## Examples
The following example compares portions of two strings using the different <xref:System.Globalization.CompareInfo> objects:

- <xref:System.Globalization.CompareInfo> object associated with the Spanish (Spain) culture with international sort

- <xref:System.Globalization.CompareInfo> object associated with the Spanish (Spain) culture with traditional sort

- <xref:System.Globalization.CompareInfo> object associated with the <xref:System.Globalization.CultureInfo.InvariantCulture%2A>
- <xref:System.Globalization.CompareInfo> object associated with the Spanish (Spain) culture with international sort
- <xref:System.Globalization.CompareInfo> object associated with the Spanish (Spain) culture with traditional sort
- <xref:System.Globalization.CompareInfo> object associated with the <xref:System.Globalization.CultureInfo.InvariantCulture%2A>

:::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR_System/system.Globalization.CompareInfo.CompareStrStr/CPP/comparestrstr.cpp" id="Snippet1":::
:::code language="csharp" source="~/snippets/csharp/System.Globalization/CompareInfo/Compare/comparestrstr.cs" id="Snippet1":::
Expand Down Expand Up @@ -3441,7 +3437,7 @@ This method has greater overhead than other <xref:System.Globalization.CompareIn
<param name="text">A string of zero or more Unicode characters.</param>
<summary>Indicates whether a specified Unicode string is sortable.</summary>
<returns>
<see langword="true" /> if the <paramref name="str" /> parameter is not an empty string ("") and all the Unicode characters in <paramref name="str" /> are sortable; otherwise, <see langword="false" />.</returns>
<see langword="true" /> if the <paramref name="text" /> parameter is not an empty string ("") and all the Unicode characters in <paramref name="text" /> are sortable; otherwise, <see langword="false" />.</returns>
<remarks>
<format type="text/markdown"><![CDATA[

Expand All @@ -3451,7 +3447,7 @@ This method has greater overhead than other <xref:System.Globalization.CompareIn
]]></format>
</remarks>
<exception cref="T:System.ArgumentNullException">
<paramref name="str" /> is <see langword="null" />.</exception>
<paramref name="text" /> is <see langword="null" />.</exception>
</Docs>
</Member>
<Member MemberName="IsSortable">
Expand Down
2 changes: 1 addition & 1 deletion xml/System.Globalization/CultureAndRegionInfoBuilder.xml
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ The following code example creates a custom culture with a private use prefix, t

-or-

<paramref name="cultureName" /> specifies an alternate sort replacement culture instead of a .NET Framework culture. For example, <paramref name="culturenName" /> is "de-de_phoneb", a culture that sorts strings as they appear in a German telephone book, instead of "de-DE", the German (Germany) culture.
<paramref name="cultureName" /> specifies an alternate sort replacement culture instead of a .NET Framework culture. For example, <paramref name="cultureName" /> is "de-de_phoneb", a culture that sorts strings as they appear in a German telephone book, instead of "de-DE", the German (Germany) culture.

-or-

Expand Down
Loading