Skip to content
Merged
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
4 changes: 1 addition & 3 deletions xml/System.Diagnostics/ActivityLink.xml
Original file line number Diff line number Diff line change
Expand Up @@ -202,9 +202,7 @@ Activity links can be used to represent batched operations where an activity was
<remarks>
<format type="text/markdown"><![CDATA[

## Remarks

<xref:System.Diagnostics.ActivityLink> equality is currently undefined. The current behavior is that two <xref:System.Diagnostics.ActivityLink> instances with the same <xref:System.Diagnostics.ActivityContext> and no tags will return `true` for <xref:System.Diagnostics.ActivityLink.Equals(System.Object)>. Prior to .NET 7, xref:System.Diagnostics.ActivityLink> instances sharing an <xref:System.Diagnostics.ActivityTagsCollection> instance and the same <xref:System.Diagnostics.ActivityContext> would return `true` for <xref:System.Diagnostics.ActivityLink.Equals(System.Object)>. Starting from .NET 7, <xref:System.Diagnostics.ActivityLink.Equals(System.Object)> will always return `false` when tags are used. This may change in the future. Exercise caution in calling this method.
<xref:System.Diagnostics.ActivityLink> equality is currently undefined. The current behavior is that two <xref:System.Diagnostics.ActivityLink> instances with the same <xref:System.Diagnostics.ActivityContext> and no tags will return `true` for <xref:System.Diagnostics.ActivityLink.Equals(System.Object)>. Prior to .NET 7, <xref:System.Diagnostics.ActivityLink> instances sharing an <xref:System.Diagnostics.ActivityTagsCollection> instance and the same <xref:System.Diagnostics.ActivityContext> would return `true` for <xref:System.Diagnostics.ActivityLink.Equals(System.Object)>. Starting in .NET 7, <xref:System.Diagnostics.ActivityLink.Equals(System.Object)> always returns `false` when tags are used.

]]></format>
</remarks>
Expand Down
2 changes: 1 addition & 1 deletion xml/System.Drawing.Printing/PrintPageEventArgs.xml
Original file line number Diff line number Diff line change
Expand Up @@ -296,7 +296,7 @@
:::code language="csharp" source="~/snippets/csharp/System.Drawing.Printing/PrintPageEventArgs/Overview/source.cs" id="Snippet1":::
:::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/Classic PrintPageEventArgs Example/VB/source.vb" id="Snippet1":::

For another example that shows how to use <xref:System.Drawing.Printing.PrintPageEventArgs.HasMorePages%2A>, see [How to: Print a Multi-Page Text File in Windows Forms](/dotnet/framework/winforms/advanced/how-to-print-a-multi-page-text-file-in-windows-forms)
For another example that shows how to use <xref:System.Drawing.Printing.PrintPageEventArgs.HasMorePages%2A>, see [How to: Print a Multi-Page Text File in Windows Forms](/dotnet/framework/winforms/advanced/how-to-print-a-multi-page-text-file-in-windows-forms).

]]></format>
</remarks>
Expand Down
2 changes: 1 addition & 1 deletion xml/System.Net.Sockets/TcpClient.xml
Original file line number Diff line number Diff line change
Expand Up @@ -934,7 +934,7 @@ The `Available` property is a way to determine whether data is queued for readin
> If you receive a <xref:System.Net.Sockets.SocketException>, use <xref:System.Net.Sockets.SocketException.ErrorCode%2A?displayProperty=nameWithType> to obtain the specific error code. After you have obtained this code, you can refer to the [Windows Sockets version 2 API error code](/windows/desktop/winsock/windows-sockets-error-codes-2) documentation for a detailed description of the error.

> [!NOTE]
> This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in the .NET Framework](/dotnet/framework/network-programming/network-tracing)
> This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in the .NET Framework](/dotnet/framework/network-programming/network-tracing).

> [!NOTE]
> If you receive NotSupportedException with message `This protocol version is not supported` while using IPv6 address, then make sure you enabled IPv6 in constructor by passing <xref:System.Net.Sockets.AddressFamily.InterNetworkV6>.
Expand Down
4 changes: 2 additions & 2 deletions xml/System.Net/HttpListener.xml
Original file line number Diff line number Diff line change
Expand Up @@ -389,7 +389,7 @@

This method does not block while the operation completes. To get an incoming request and block until the operation completes, call the <xref:System.Net.HttpListener.GetContext%2A> method.

For detailed information about using the asynchronous programming model, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously)
For detailed information about using the asynchronous programming model, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously).



Expand Down Expand Up @@ -598,7 +598,7 @@ The following code example demonstrates calling the `Close` method:

Because calling the <xref:System.Net.HttpListener.EndGetContext%2A> method requires the <xref:System.Net.HttpListener> object, this object is typically passed into a callback method by using the state object passed into the <xref:System.Net.HttpListener.BeginGetContext%2A> method. You can obtain this state object by using the <xref:System.IAsyncResult.AsyncState%2A> property of the `asyncResult` object.

For detailed information about using the asynchronous programming model, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously)
For detailed information about using the asynchronous programming model, see [Calling Synchronous Methods Asynchronously](/dotnet/standard/asynchronous-programming-patterns/calling-synchronous-methods-asynchronously).



Expand Down
2 changes: 1 addition & 1 deletion xml/System.Net/WebClient.xml
Original file line number Diff line number Diff line change
Expand Up @@ -2849,7 +2849,7 @@ internal class MyWebClient : WebClientProtocol
## Remarks
Classes that inherit from this class can override this method to perform additional tasks when the <xref:System.Net.WebClient.DownloadDataCompleted> event occurs.

Raising an event invokes the event handler through a delegate. For more information, see [Handling and Raising Events](/dotnet/standard/events/)
Raising an event invokes the event handler through a delegate. For more information, see [Handling and Raising Events](/dotnet/standard/events/).

The <xref:System.Net.WebClient.OnDownloadDataCompleted%2A> method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Expand Down
4 changes: 2 additions & 2 deletions xml/System.Runtime.Remoting/RemotingConfiguration.xml
Original file line number Diff line number Diff line change
Expand Up @@ -213,7 +213,7 @@
<format type="text/markdown"><![CDATA[

## Remarks
Passing `null` as the `filename` parameter will cause default remoting initialization without requiring the existence of a configuration file. For more information about remoting and security see [Security in Remoting.](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/9hwst9th(v=vs.100))
Passing `null` as the `filename` parameter will cause default remoting initialization without requiring the existence of a configuration file. For more information about remoting and security see [Security in Remoting.](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/9hwst9th(v=vs.100)).

For configuration file syntax, see [Remoting Settings Schema](https://msdn.microsoft.com/library/dc2d1e62-9af7-4ca1-99fd-98b93bb4db9e).

Expand Down Expand Up @@ -879,7 +879,7 @@

To activate a client-activated object type with the `new` keyword, you must first register the object type on the client end using the <xref:System.Runtime.Remoting.RemotingConfiguration.RegisterActivatedClientType%2A> method. Calling the <xref:System.Runtime.Remoting.RemotingConfiguration.RegisterActivatedClientType%2A> method gives the remoting infrastructure the location of the remote application where `new` attempts to create it. If, on the other hand, you use the <xref:System.Activator.CreateInstance%2A?displayProperty=nameWithType> method to create a new instance of the client-activated object, you must supply the remote application's URL as a parameter, so no prior registration on the client end is necessary. To supply the <xref:System.Activator.CreateInstance%2A?displayProperty=nameWithType> method with the URL of the server where you want to create the object, you must encapsulate the URL in an instance of the <xref:System.Runtime.Remoting.Activation.UrlAttribute> class.

For a detailed description of client-activated objects, see [Client Activation](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/w93betdk(v=vs.100))
For a detailed description of client-activated objects, see [Client Activation](https://docs.microsoft.com/previous-versions/dotnet/netframework-4.0/w93betdk(v=vs.100)).



Expand Down
2 changes: 1 addition & 1 deletion xml/System.Security.Cryptography/DSACng.xml
Original file line number Diff line number Diff line change
Expand Up @@ -295,7 +295,7 @@ An error occurred during signature creation.
<Docs>
<param name="disposing">
<see langword="true" /> to release managed and unmanaged resources; <see langword="false" /> to release only unmanaged resources.</param>
<summary>Releases the resources used by the current instance of the <see xref="T:System.Security.Cryptography.DSACng" /> class.</summary>
<summary>Releases the resources used by the current instance of the <see cref="T:System.Security.Cryptography.DSACng" /> class.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -498,7 +498,7 @@
<Docs>
<param name="disposing">
<see langword="true" /> to release managed and unmanaged resources; <see langword="false" /> to release only unmanaged resources.</param>
<summary>Releases the resources used by the current instance of the <see xref="T:System.Security.Cryptography.DSACng" /> class.</summary>
<summary>Releases the resources used by the current instance of the <see cref="T:System.Security.Cryptography.DSACryptoServiceProvider" /> class.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
Expand Down
48 changes: 24 additions & 24 deletions xml/System.Security.Cryptography/DSAOpenSsl.xml
Original file line number Diff line number Diff line change
Expand Up @@ -42,14 +42,14 @@
<Docs>
<summary>Provides an implementation of the Digital Signature Algorithm (DSA) backed by OpenSSL.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
<format type="text/markdown"><![CDATA[

## Remarks

This class should only be used directly when doing platform interop with the system OpenSSL library. When platform interop is not needed, you should use the <xref:System.Security.Cryptography.DSA.Create%2A?displayProperty=nameWithType> factory methods instead of a specific derived implementation.

> [!IMPORTANT]
> The creators of the DSA algorithm have withdrawn their support for it. Consider using the <xref:System.Security.Cryptography.RSA> class or the <xref:System.Security.Cryptography.ECDsa> class instead of the <xref:System.Security.Cryptography.DSA> class. Use <xref:System.Security.Cryptography.DSA> only for compatibility with legacy applications and data.
> The creators of the DSA algorithm have withdrawn their support for it. Consider using the <xref:System.Security.Cryptography.RSA> class or the <xref:System.Security.Cryptography.ECDsa> class instead of the <xref:System.Security.Cryptography.DSA> class. Use <xref:System.Security.Cryptography.DSA> only for compatibility with legacy applications and data.

DSAOpenSSL provides the FIPS 186-3 version of DSA.

Expand Down Expand Up @@ -104,9 +104,9 @@ DSAOpenSSL provides the FIPS 186-3 version of DSA.
<Docs>
<summary>Initializes a new instance of the <see cref="T:System.Security.Cryptography.DSAOpenSsl" /> class with a default key size of 2048 bits.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
<format type="text/markdown"><![CDATA[

## Remarks

This constructor does not generate a new DSA public/private keypair immediately, it just sets the size which will be used to generate a key when one is needed.
If key is loaded via the <xref:System.Security.Cryptography.DSAOpenSsl.ImportParameters%2A> method, or other key import method, the key size from this constructor has no meaning.
Expand Down Expand Up @@ -167,9 +167,9 @@ If key is loaded via the <xref:System.Security.Cryptography.DSAOpenSsl.ImportPar
<param name="keySize">The size of the key to generate, when a key is needed.</param>
<summary>Initializes a new instance of the <see cref="T:System.Security.Cryptography.DSAOpenSsl" /> class with a specified key size.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
<format type="text/markdown"><![CDATA[

## Remarks

This constructor does not generate a new DSA public/private keypair immediately, it just sets the size which will be used to generate a key when one is needed.
If key is loaded via the <xref:System.Security.Cryptography.DSAOpenSsl.ImportParameters%2A> method, or other key import method, the `keySize` provided to this constructor has no meaning.
Expand Down Expand Up @@ -231,13 +231,13 @@ If key is loaded via the <xref:System.Security.Cryptography.DSAOpenSsl.ImportPar
<param name="handle">The OpenSSL <c>DSA*</c> value to use as the key.</param>
<summary>Initializes a new instance of the <see cref="T:System.Security.Cryptography.DSAOpenSsl" /> class from an existing OpenSSL key represented as a <c>DSA*</c>.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
<format type="text/markdown"><![CDATA[

## Remarks

> [!IMPORTANT]
> OpenSSL supports multiple library versions being loaded within the same process.
> Before calling this constructor, verify your pointer value came from the same version of OpenSSL that this class uses.
> Before calling this constructor, verify your pointer value came from the same version of OpenSSL that this class uses.
> For more information, see <xref:System.Security.Cryptography.SafeEvpPKeyHandle.OpenSslVersion>.

]]></format>
Expand Down Expand Up @@ -364,9 +364,9 @@ If key is loaded via the <xref:System.Security.Cryptography.DSAOpenSsl.ImportPar
<param name="pkeyHandle">The OpenSSL <c>EVP_PKEY*</c> value to use as the key, represented as a <see cref="T:System.Security.Cryptography.SafeEvpPKeyHandle" />.</param>
<summary>Initializes a new instance of the <see cref="T:System.Security.Cryptography.DSAOpenSsl" /> class from an existing OpenSSL key represented as an <c>EVP_PKEY*</c>.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
<format type="text/markdown"><![CDATA[

## Remarks

> [!IMPORTANT]
> OpenSSL supports multiple library versions being loaded within the same process.
Expand Down Expand Up @@ -455,7 +455,7 @@ An error occurred during signature creation.
<Docs>
<param name="disposing">
<see langword="true" /> to release managed and unmanaged resources; <see langword="false" /> to release only unmanaged resources.</param>
<summary>Releases the resources used by the current instance of the <see xref="T:System.Security.Cryptography.DSAOpenSsl" /> class.</summary>
<summary>Releases the resources used by the current instance of the <see cref="T:System.Security.Cryptography.DSAOpenSsl" /> class.</summary>
<remarks>To be added.</remarks>
</Docs>
</Member>
Expand Down Expand Up @@ -489,9 +489,9 @@ An error occurred during signature creation.
<summary>Gets a <see cref="T:System.Security.Cryptography.SafeEvpPKeyHandle" /> representation of the cryptographic key.</summary>
<returns>A <see cref="T:System.Security.Cryptography.SafeEvpPKeyHandle" /> representation of the cryptographic key.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
<format type="text/markdown"><![CDATA[

## Remarks

Each call to this method produces a new <xref:System.Security.Cryptography.SafeEvpPKeyHandle> object with its own lifetime.
The objects returned by this method can safely be used even after this <xref:System.Security.Cryptography.DSAOpenSsl> instance has been disposed.
Expand Down Expand Up @@ -681,9 +681,9 @@ The objects returned by this method can safely be used even after this <xref:Sys
<summary>Gets or sets the size, in bits, of the key modulus used by the asymmetric algorithm.</summary>
<value>The size, in bits, of the key modulus used by the asymmetric algorithm.</value>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
<format type="text/markdown"><![CDATA[

## Remarks

Setting this property to its current value has no visible effect.
Setting this property to a new legal value discards the current key, but defers creation of a new key until one is needed.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@

The <xref:System.Web.Configuration.SystemWebCachingSectionGroup> class and the `caching` section provide centralized control of the caching mechanism for a site or application. This makes it possible for caching to be deployed, modified, and disabled without modifying individual pages in the application.

The ASP.NET caching mechanism is implemented by the <xref:System.Web.Caching.Cache> class. For more information, see [ASP.NET Caching Overview](https://docs.microsoft.com/previous-versions/aspnet/ms178597(v=vs.100))
The ASP.NET caching mechanism is implemented by the <xref:System.Web.Caching.Cache> class. For more information, see [ASP.NET Caching Overview](https://docs.microsoft.com/previous-versions/aspnet/ms178597(v=vs.100)).

The following list describes the two types of caching ASP.NET provides.

Expand Down
2 changes: 1 addition & 1 deletion xml/System.Web.UI.WebControls/CheckBox.xml
Original file line number Diff line number Diff line change
Expand Up @@ -641,7 +641,7 @@
> [!NOTE]
> A <xref:System.Web.UI.WebControls.CheckBox> control must persist some values between posts to the server for this event to work correctly. Be sure that view state is enabled for this control.

Raising an event invokes the event handler through a delegate. For more information, see [How to: Consume Events in a Web Forms Application](/dotnet/standard/events/how-to-consume-events-in-a-web-forms-application)
Raising an event invokes the event handler through a delegate. For more information, see [How to: Consume Events in a Web Forms Application](/dotnet/standard/events/how-to-consume-events-in-a-web-forms-application).

The <xref:System.Web.UI.WebControls.CheckBox.OnCheckedChanged%2A> method also allows derived classes to handle the event without attaching a delegate. This is the preferred technique for handling the event in a derived class.

Expand Down
10 changes: 5 additions & 5 deletions xml/System.Web.UI/Control.xml
Original file line number Diff line number Diff line change
Expand Up @@ -483,12 +483,12 @@
<param name="calcViewState">A Boolean that indicates whether the view-state size is calculated.</param>
<summary>Gathers information about the server control and delivers it to the <see cref="P:System.Web.UI.Page.Trace" /> property to be displayed when tracing is enabled for the page.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
<format type="text/markdown"><![CDATA[

## Remarks

This property gathers the information necessary about a page's UI hierarchy and passes it to the page's [&lt;trace&gt;](/dotnet/framework/configure-apps/file-schema/trace-debug/trace-element) property. When you enable tracing, either for a page or for your application, this information is displayed in the `Control Tree` section of the trace output. Trace output for a page is appended to the end of the page; while trace output for an application can be viewed from the trace viewer (trace.axd file) which is stored in the application's root directory. For more information about tracing, see [ASP.NET Tracing Overview](https://docs.microsoft.com/previous-versions/aspnet/bb386420(v=vs.100)).

]]></format>
</remarks>
</Docs>
Expand Down Expand Up @@ -2483,7 +2483,7 @@ HyperLink1.NavigateUrl = HyperLink1.GetRouteUrl("Product",
<format type="text/markdown"><![CDATA[

## Remarks
For a sample custom server control that uses this property, see [Templated Server Control Example](https://docs.microsoft.com/previous-versions/aspnet/ms178657(v=vs.100))
For a sample custom server control that uses this property, see [Templated Server Control Example](https://docs.microsoft.com/previous-versions/aspnet/ms178657(v=vs.100)).



Expand Down
Loading