Skip to content

Commit

Permalink
Fix some xrefs (dotnet#4624)
Browse files Browse the repository at this point in the history
* Fix some xrefs

* Fixed typo

* Change hybrid xref links to normal xrefs

* Remove redundant text with bad link
  • Loading branch information
svick authored and Ron Petrusha committed Mar 13, 2018
1 parent fb4ce95 commit c3fa0ef
Show file tree
Hide file tree
Showing 4 changed files with 7 additions and 7 deletions.
2 changes: 1 addition & 1 deletion xml/System.Data.SqlTypes/SqlByte.xml
Original file line number Diff line number Diff line change
Expand Up @@ -1943,7 +1943,7 @@
<summary>Subtracts the second <see cref="T:System.Data.SqlTypes.SqlByte" /> operand from the first.</summary>
<returns>The results of subtracting the second <see cref="T:System.Data.SqlTypes.SqlByte" /> operand from the first.</returns>
<remarks>
<format type="text/markdown"><![CDATA[The equivalent method for this operator is <xref:System.Data.SqlTypes.SqlByte.Subtract(System.Data.SqlTypes.SqlByte, System.Data.SqlTypes.SqlByte)?displayProperty=nameWithType>.]]></format>
<format type="text/markdown"><![CDATA[The equivalent method for this operator is <xref:System.Data.SqlTypes.SqlByte.Subtract(System.Data.SqlTypes.SqlByte,System.Data.SqlTypes.SqlByte)?displayProperty=nameWithType>.]]></format>
</remarks>
</Docs>
</Member>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@
## Remarks
Appends a custom legend item with the specified text and symbol color to the end of the collection.
To add a custom legend item that uses an image for its symbol, call the [LegendItemsCollection.Add(String, String)](<xref:System.Windows.Forms.DataVisualization.Charting.LegendItemsCollection.Add(System.String,System.String)>) method.
To add a custom legend item that uses an image for its symbol, call the <xref:System.Windows.Forms.DataVisualization.Charting.LegendItemsCollection.Add(System.String,System.String)> method.
To insert a custom <xref:System.Windows.Forms.DataVisualization.Charting.LegendItem> into the collection, use one of the <xref:System.Collections.ObjectModel.Collection%601.Insert%2A> methods of this class.
Expand Down Expand Up @@ -95,7 +95,7 @@
## Remarks
Appends a custom legend item to the collection with the specified text and image to be used as the symbol for the legend item.
To add a custom legend item that uses a color for its symbol, call the [Add(Color, String)](<xref:System.Windows.Forms.DataVisualization.Charting.LegendItemsCollection.Add(System.Drawing.Color,System.String)) method.
To add a custom legend item that uses a color for its symbol, call the <xref:System.Windows.Forms.DataVisualization.Charting.LegendItemsCollection.Add(System.Drawing.Color,System.String)> method.
To insert a <xref:System.Windows.Forms.DataVisualization.Charting.LegendItem> object into the collection use one of the <xref:System.Windows.Forms.DataVisualization.Charting.LegendItemsCollection.Insert%2A> methods of this class.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -519,12 +519,12 @@
<param name="items">An <see cref="T:System.Collections.ICollection" /> of serialized state objects to be written to the database.</param>
<summary>Returns a value that indicates whether the collection of serialized state objects should be written to the database.</summary>
<returns>
<see langword="true" /> indicates that the batch should be committed; <see cref="M:System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService.System.Workflow.Runtime.IPendingWork.MustCommit(System.Collections.ICollection)" /> always returns <see langword="true" />.</returns>
<see langword="true" /> indicates that the batch should be committed.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
<xref:System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService.System%23Workflow%23Runtime%23IPendingWork%23MustCommit(System.Collections.ICollection) always returns `true`, which instructs the workflow run-time engine to invoke <xref:System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService.System%23Workflow%23Runtime%23IPendingWork%23MustCommit(System.Collections.ICollection)> on the batch.
<xref:System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService.System%23Workflow%23Runtime%23IPendingWork%23MustCommit(System.Collections.ICollection)> always returns `true`, which instructs the workflow run-time engine to invoke <xref:System.Workflow.Runtime.Hosting.SqlWorkflowPersistenceService.System%23Workflow%23Runtime%23IPendingWork%23MustCommit(System.Collections.ICollection)> on the batch.
]]></format>
</remarks>
Expand Down
4 changes: 2 additions & 2 deletions xml/System/String.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4526,11 +4526,11 @@ In .NET Core, sorting and comparison operations are based on [Version 8.0.0 of t

String interpolation is:

- More flexible. It can be used in any string without requiring a call to a method that supports composite formatting. Otherwise, you have to call the <xref:System.String.Format%2A> method or another method that supports composite formatting, such as <xref:System.Console.WriteLine%2A?displayProperty=nameWithType> or <xref:System.Text StringBuilder AppendFormat%2A?displayProperty=nameWithType>.
- More flexible. It can be used in any string without requiring a call to a method that supports composite formatting. Otherwise, you have to call the <xref:System.String.Format%2A> method or another method that supports composite formatting, such as <xref:System.Console.WriteLine%2A?displayProperty=nameWithType> or <xref:System.Text.StringBuilder.AppendFormat%2A?displayProperty=nameWithType>.

- More readable. Because the expression to insert into a string appears in the interpolated expression rather than in a argument list, interpolated strings are far easier to code and to read. Because of their greater readability, interpolated strings can replace not only calls to composite format methods, but they can also be used in string concatenation operations to produce more concise, clearer code.

A comparison of the following two code examples illustrates the superiority of interpolated strings over string concatenation and calls to composite formatting methods. The use of mutiple string concatenation operations in the following example produces verbose and hard-to-read code.
A comparison of the following two code examples illustrates the superiority of interpolated strings over string concatenation and calls to composite formatting methods. The use of multiple string concatenation operations in the following example produces verbose and hard-to-read code.

[!code-csharp-interactive[non-interpolated string operations](~/samples/snippets/csharp/VS_Snippets_CLR_System/system.String.Format/cs/qa-interpolated1.cs)]
[!code-vb[non-interpolated string operations](~/samples/snippets/visualbasic/VS_Snippets_CLR_System/system.String.Format/vb/qa-interpolated1.vb)]
Expand Down

0 comments on commit c3fa0ef

Please sign in to comment.