diff --git a/xml/Microsoft.Extensions.Caching.Distributed/DistributedCacheExtensions.xml b/xml/Microsoft.Extensions.Caching.Distributed/DistributedCacheExtensions.xml index 5fdc69c0277..c7c30ca3288 100644 --- a/xml/Microsoft.Extensions.Caching.Distributed/DistributedCacheExtensions.xml +++ b/xml/Microsoft.Extensions.Caching.Distributed/DistributedCacheExtensions.xml @@ -89,7 +89,7 @@ The key to get the stored data for. Asynchronously gets a string from the specified cache with the specified key. A task that gets the string value from the stored cache key. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -131,7 +131,7 @@ Optional. A to cancel the operation. Asynchronously gets a string from the specified cache with the specified key. A task that gets the string value from the stored cache key. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -200,7 +200,7 @@ The data to store in the cache. Asynchronously sets a sequence of bytes in the specified cache with the specified key. A task that represents the asynchronous set operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is null. @@ -239,7 +239,7 @@ Optional. A to cancel the operation. Asynchronously sets a sequence of bytes in the specified cache with the specified key. A task that represents the asynchronous set operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is null. @@ -351,7 +351,7 @@ The data to store in the cache. Asynchronously sets a string in the specified cache with the specified key. A task that represents the asynchronous set operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is null. @@ -385,7 +385,7 @@ The cache options for the entry. Asynchronously sets a string in the specified cache with the specified key. A task that represents the asynchronous set operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is null. @@ -424,7 +424,7 @@ Optional. A to cancel the operation. Asynchronously sets a string in the specified cache with the specified key. A task that represents the asynchronous set operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is null. @@ -465,7 +465,7 @@ Optional. A to cancel the operation. Asynchronously sets a string in the specified cache with the specified key. A task that represents the asynchronous set operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is null. diff --git a/xml/Microsoft.Extensions.Caching.Distributed/IDistributedCache.xml b/xml/Microsoft.Extensions.Caching.Distributed/IDistributedCache.xml index 5eff7dea422..6bce093da6b 100644 --- a/xml/Microsoft.Extensions.Caching.Distributed/IDistributedCache.xml +++ b/xml/Microsoft.Extensions.Caching.Distributed/IDistributedCache.xml @@ -82,7 +82,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -116,7 +116,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Gets a value with the given key. The that represents the asynchronous operation, containing the located value or null. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -175,7 +175,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -208,7 +208,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Refreshes a value in the cache based on its key, resetting its sliding expiration timeout (if any). The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -267,7 +267,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -300,7 +300,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Removes the value with the given key. The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -367,7 +367,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -404,7 +404,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Sets the value with the given key. The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Caching.Distributed/MemoryDistributedCache.xml b/xml/Microsoft.Extensions.Caching.Distributed/MemoryDistributedCache.xml index 8dc7748e521..4591c050753 100644 --- a/xml/Microsoft.Extensions.Caching.Distributed/MemoryDistributedCache.xml +++ b/xml/Microsoft.Extensions.Caching.Distributed/MemoryDistributedCache.xml @@ -172,7 +172,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -209,7 +209,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Gets a value with the given key. The that represents the asynchronous operation, containing the located value or . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -274,7 +274,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -310,7 +310,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Refreshes a value in the cache based on its key, resetting its sliding expiration timeout (if any). The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -375,7 +375,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -411,7 +411,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Removes the value with the given key. The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -484,7 +484,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -524,7 +524,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Sets the value with the given key. The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Caching.Redis/RedisCache.xml b/xml/Microsoft.Extensions.Caching.Redis/RedisCache.xml index bfb9c7b8ff2..01274af9f14 100644 --- a/xml/Microsoft.Extensions.Caching.Redis/RedisCache.xml +++ b/xml/Microsoft.Extensions.Caching.Redis/RedisCache.xml @@ -140,7 +140,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -171,7 +171,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Gets a value with the given key. The that represents the asynchronous operation, containing the located value or . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -231,7 +231,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -262,7 +262,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Refreshes a value in the cache based on its key, resetting its sliding expiration timeout (if any). The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -322,7 +322,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -353,7 +353,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Removes the value with the given key. The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -421,7 +421,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -456,7 +456,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Sets the value with the given key. The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Caching.SqlServer/SqlServerCache.xml b/xml/Microsoft.Extensions.Caching.SqlServer/SqlServerCache.xml index f473379ab84..5050150fbe8 100644 --- a/xml/Microsoft.Extensions.Caching.SqlServer/SqlServerCache.xml +++ b/xml/Microsoft.Extensions.Caching.SqlServer/SqlServerCache.xml @@ -115,7 +115,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -148,7 +148,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Gets a value with the given key. The that represents the asynchronous operation, containing the located value or . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -210,7 +210,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -243,7 +243,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Refreshes a value in the cache based on its key, resetting its sliding expiration timeout (if any). The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -305,7 +305,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -338,7 +338,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Removes the value with the given key. The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -408,7 +408,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -445,7 +445,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Sets the value with the given key. The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Caching.StackExchangeRedis/RedisCache.xml b/xml/Microsoft.Extensions.Caching.StackExchangeRedis/RedisCache.xml index ef56bb1a34a..130d19ce0cc 100644 --- a/xml/Microsoft.Extensions.Caching.StackExchangeRedis/RedisCache.xml +++ b/xml/Microsoft.Extensions.Caching.StackExchangeRedis/RedisCache.xml @@ -134,7 +134,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Gets a value with the given key. The that represents the asynchronous operation, containing the located value or . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -194,7 +194,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Refreshes a value in the cache based on its key, resetting its sliding expiration timeout (if any). The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -254,7 +254,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Removes the value with the given key. The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -322,7 +322,7 @@ Optional. The used to propagate notifications that the operation should be canceled. Sets the value with the given key. The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.DependencyInjection/AsyncServiceScope.xml b/xml/Microsoft.Extensions.DependencyInjection/AsyncServiceScope.xml index f241e2bda47..6f342781981 100644 --- a/xml/Microsoft.Extensions.DependencyInjection/AsyncServiceScope.xml +++ b/xml/Microsoft.Extensions.DependencyInjection/AsyncServiceScope.xml @@ -107,7 +107,7 @@ Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously. A task that represents the asynchronous dispose operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.DependencyInjection/ServiceProvider.xml b/xml/Microsoft.Extensions.DependencyInjection/ServiceProvider.xml index 912240feb8c..2362b2e0dbf 100644 --- a/xml/Microsoft.Extensions.DependencyInjection/ServiceProvider.xml +++ b/xml/Microsoft.Extensions.DependencyInjection/ServiceProvider.xml @@ -99,7 +99,7 @@ Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously. A task that represents the asynchronous dispose operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Diagnostics.HealthChecks/HealthCheckService.xml b/xml/Microsoft.Extensions.Diagnostics.HealthChecks/HealthCheckService.xml index 6590fec31fe..a6bff77a5b3 100644 --- a/xml/Microsoft.Extensions.Diagnostics.HealthChecks/HealthCheckService.xml +++ b/xml/Microsoft.Extensions.Diagnostics.HealthChecks/HealthCheckService.xml @@ -90,7 +90,7 @@ A which will complete when all the health checks have been run, yielding a containing the results. . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -127,7 +127,7 @@ A which will complete when all the health checks have been run, yielding a containing the results. . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Diagnostics.HealthChecks/IHealthCheck.xml b/xml/Microsoft.Extensions.Diagnostics.HealthChecks/IHealthCheck.xml index bea26e11d6f..93138484594 100644 --- a/xml/Microsoft.Extensions.Diagnostics.HealthChecks/IHealthCheck.xml +++ b/xml/Microsoft.Extensions.Diagnostics.HealthChecks/IHealthCheck.xml @@ -49,7 +49,7 @@ A that can be used to cancel the health check. Runs the health check, returning the status of the component being checked. A that completes when the health check has finished, yielding the status of the component being checked. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Diagnostics.HealthChecks/IHealthCheckPublisher.xml b/xml/Microsoft.Extensions.Diagnostics.HealthChecks/IHealthCheckPublisher.xml index a76c26e6364..fd86d2dc485 100644 --- a/xml/Microsoft.Extensions.Diagnostics.HealthChecks/IHealthCheckPublisher.xml +++ b/xml/Microsoft.Extensions.Diagnostics.HealthChecks/IHealthCheckPublisher.xml @@ -65,7 +65,7 @@ The . Publishes the provided . A which will complete when publishing is complete. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Hosting.Internal/ConsoleLifetime.xml b/xml/Microsoft.Extensions.Hosting.Internal/ConsoleLifetime.xml index ce326d954fb..16bdcc10aae 100644 --- a/xml/Microsoft.Extensions.Hosting.Internal/ConsoleLifetime.xml +++ b/xml/Microsoft.Extensions.Hosting.Internal/ConsoleLifetime.xml @@ -223,6 +223,8 @@ This API supports the .NET infrastructure and is not intended to be used directl This API supports the .NET infrastructure and is not intended to be used directly from your code. +This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + ]]> @@ -265,6 +267,8 @@ This API supports the .NET infrastructure and is not intended to be used directl This API supports the .NET infrastructure and is not intended to be used directly from your code. +This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + ]]> diff --git a/xml/Microsoft.Extensions.Hosting.Systemd/SystemdLifetime.xml b/xml/Microsoft.Extensions.Hosting.Systemd/SystemdLifetime.xml index b15e98885c6..d182e5a4e1c 100644 --- a/xml/Microsoft.Extensions.Hosting.Systemd/SystemdLifetime.xml +++ b/xml/Microsoft.Extensions.Hosting.Systemd/SystemdLifetime.xml @@ -105,7 +105,7 @@ A cancellation token that indicates when stop should no longer be graceful. Asynchronously stops and shuts down the host. This method is called from . A task that represents the asynchronous stop operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -134,7 +134,7 @@ A cancellation token that indicates when stop should no longer be graceful. Asynchronously waits until the start operation is complete before continuing. This method is called at the beginning of . This can be used to delay startup until signaled by an external event. A task that represents the waiting for start operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Hosting.WindowsServices/WindowsServiceLifetime.xml b/xml/Microsoft.Extensions.Hosting.WindowsServices/WindowsServiceLifetime.xml index 11fb4c74bfe..182706ed66f 100644 --- a/xml/Microsoft.Extensions.Hosting.WindowsServices/WindowsServiceLifetime.xml +++ b/xml/Microsoft.Extensions.Hosting.WindowsServices/WindowsServiceLifetime.xml @@ -149,7 +149,7 @@ A cancellation token that indicates when stop should no longer be graceful. Asynchronously stops and shuts down the host. This method is called from . A task that represents the asynchronous stop operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -178,7 +178,7 @@ A cancellation token that indicates when stop should no longer be graceful. Asynchronously waits until start is complete before continuing. This method is called at the beginning of . This can be used to delay startup until signaled by an external event. A task that represents the asynchronous waiting for start operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Hosting/BackgroundService.xml b/xml/Microsoft.Extensions.Hosting/BackgroundService.xml index 74cda548ba3..a65f401d6ac 100644 --- a/xml/Microsoft.Extensions.Hosting/BackgroundService.xml +++ b/xml/Microsoft.Extensions.Hosting/BackgroundService.xml @@ -120,7 +120,9 @@ For implementation guidelines, see [Worker Services in .NET](/dotnet/core/extensions/workers). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -186,7 +188,7 @@ Will return `null` if the background operation hasn't started. Indicates that the start process has been aborted. Triggered when the application host is ready to start the service. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -226,7 +228,7 @@ Will return `null` if the background operation hasn't started. Indicates that the shutdown process should no longer be graceful. Triggered when the application host is performing a graceful shutdown. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Hosting/HostingAbstractionsHostBuilderExtensions.xml b/xml/Microsoft.Extensions.Hosting/HostingAbstractionsHostBuilderExtensions.xml index 2b95fe71545..22482c82998 100644 --- a/xml/Microsoft.Extensions.Hosting/HostingAbstractionsHostBuilderExtensions.xml +++ b/xml/Microsoft.Extensions.Hosting/HostingAbstractionsHostBuilderExtensions.xml @@ -88,7 +88,7 @@ A that can be used to cancel the start. Builds and starts the host. The started . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Hosting/HostingAbstractionsHostExtensions.xml b/xml/Microsoft.Extensions.Hosting/HostingAbstractionsHostExtensions.xml index 86f82285789..70a5e824310 100644 --- a/xml/Microsoft.Extensions.Hosting/HostingAbstractionsHostExtensions.xml +++ b/xml/Microsoft.Extensions.Hosting/HostingAbstractionsHostExtensions.xml @@ -89,7 +89,7 @@ The token to trigger shutdown. Runs an application and returns a Task that only completes when the token is triggered or shutdown is triggered and all instances are stopped. The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -153,7 +153,7 @@ server may terminate any remaining active connections. Attempts to gracefully stop the host with the given timeout. The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -221,7 +221,7 @@ The token to trigger shutdown. Returns a Task that completes when shutdown is triggered via the given token. The that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Hosting/HostingHostBuilderExtensions.xml b/xml/Microsoft.Extensions.Hosting/HostingHostBuilderExtensions.xml index 71d84f59499..531f76befc9 100644 --- a/xml/Microsoft.Extensions.Hosting/HostingHostBuilderExtensions.xml +++ b/xml/Microsoft.Extensions.Hosting/HostingHostBuilderExtensions.xml @@ -89,8 +89,7 @@ - - + The to configure. The delegate for configuring the . Enables configuring the instantiated dependency container. This can be called multiple times and @@ -353,7 +352,7 @@ The following defaults are applied to the A that can be used to cancel the console. Enables console support, builds and starts the host, and waits for Ctrl+C or SIGTERM to shut down. A that only completes when the token is signaled or application is shutdown. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -403,7 +402,7 @@ The following defaults are applied to the A that can be used to cancel the console. Enables console support, builds and starts the host, and waits for Ctrl+C or SIGTERM to shut down. A that only completes when the token is signaled or application is shutdown. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -570,8 +569,7 @@ The following defaults are applied to the The to configure. - - + Specify the to be the default one. The . To be added. diff --git a/xml/Microsoft.Extensions.Hosting/IHost.xml b/xml/Microsoft.Extensions.Hosting/IHost.xml index fd0d675509f..66a9074badb 100644 --- a/xml/Microsoft.Extensions.Hosting/IHost.xml +++ b/xml/Microsoft.Extensions.Hosting/IHost.xml @@ -79,7 +79,7 @@ Used to abort program start. Starts the program. A that will be completed when the starts. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -109,7 +109,7 @@ Used to indicate when stop should no longer be graceful. Attempts to gracefully stop the program. A that will be completed when the stops. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Hosting/IHostLifetime.xml b/xml/Microsoft.Extensions.Hosting/IHostLifetime.xml index f0e04c39a54..8c4f86f6162 100644 --- a/xml/Microsoft.Extensions.Hosting/IHostLifetime.xml +++ b/xml/Microsoft.Extensions.Hosting/IHostLifetime.xml @@ -49,7 +49,7 @@ Used to indicate when stop should no longer be graceful. Called from to indicate that the host is stopping and it's time to shut down. A . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -81,7 +81,7 @@ Called at the start of which will wait until it's complete before continuing. This can be used to delay startup until signaled by an external event. A . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Hosting/IHostedService.xml b/xml/Microsoft.Extensions.Hosting/IHostedService.xml index 6b3ae608e13..9c77a6164e9 100644 --- a/xml/Microsoft.Extensions.Hosting/IHostedService.xml +++ b/xml/Microsoft.Extensions.Hosting/IHostedService.xml @@ -51,7 +51,7 @@ Indicates that the start process has been aborted. Triggered when the application host is ready to start the service. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -83,7 +83,7 @@ Indicates that the shutdown process should no longer be graceful. Triggered when the application host is performing a graceful shutdown. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Http.Logging/LoggingHttpMessageHandler.xml b/xml/Microsoft.Extensions.Http.Logging/LoggingHttpMessageHandler.xml index 37fdff5c57e..6ef8e617e8c 100644 --- a/xml/Microsoft.Extensions.Http.Logging/LoggingHttpMessageHandler.xml +++ b/xml/Microsoft.Extensions.Http.Logging/LoggingHttpMessageHandler.xml @@ -123,7 +123,9 @@ Logs the request and response from the sent . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/Microsoft.Extensions.Http.Logging/LoggingScopeHttpMessageHandler.xml b/xml/Microsoft.Extensions.Http.Logging/LoggingScopeHttpMessageHandler.xml index c46f0668806..8a37f7c3375 100644 --- a/xml/Microsoft.Extensions.Http.Logging/LoggingScopeHttpMessageHandler.xml +++ b/xml/Microsoft.Extensions.Http.Logging/LoggingScopeHttpMessageHandler.xml @@ -123,7 +123,9 @@ Logs the request and response from the sent . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/Microsoft.Extensions.Http/PolicyHttpMessageHandler.xml b/xml/Microsoft.Extensions.Http/PolicyHttpMessageHandler.xml index 36a02583875..aaec66d4de0 100644 --- a/xml/Microsoft.Extensions.Http/PolicyHttpMessageHandler.xml +++ b/xml/Microsoft.Extensions.Http/PolicyHttpMessageHandler.xml @@ -127,7 +127,9 @@ The will attach a cont Executes request processing surrounded by a . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -160,7 +162,7 @@ Executes request processing surrounded by a . The . Called inside the execution of the to perform request processing. Returns a that will yield a response when completed. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/AzureBlobSink.xml b/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/AzureBlobSink.xml index 9c001661f7e..e291d0adb37 100644 --- a/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/AzureBlobSink.xml +++ b/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/AzureBlobSink.xml @@ -87,7 +87,7 @@ This API supports the .NET infrastructure and is not intended to be used directl To be added. This API supports the .NET infrastructure and is not intended to be used directly from your code. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/BatchingLoggerProvider.xml b/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/BatchingLoggerProvider.xml index c59425a5b9b..b23cb4d77eb 100644 --- a/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/BatchingLoggerProvider.xml +++ b/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/BatchingLoggerProvider.xml @@ -132,7 +132,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -184,7 +184,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/BlobAppendReferenceWrapper.xml b/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/BlobAppendReferenceWrapper.xml index 76b184b4152..df6f4d909ff 100644 --- a/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/BlobAppendReferenceWrapper.xml +++ b/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/BlobAppendReferenceWrapper.xml @@ -118,6 +118,8 @@ This API supports the .NET infrastructure and is not intended to be used directl This API supports the .NET infrastructure and is not intended to be used directly from your code. +This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + ]]> @@ -152,6 +154,8 @@ This API supports the .NET infrastructure and is not intended to be used directl This API supports the .NET infrastructure and is not intended to be used directly from your code. +This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + ]]> @@ -186,6 +190,8 @@ This API supports the .NET infrastructure and is not intended to be used directl This API supports the .NET infrastructure and is not intended to be used directly from your code. +This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + ]]> diff --git a/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/BlobLoggerProvider.xml b/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/BlobLoggerProvider.xml index 46aa3276037..b6ff6cc4a8c 100644 --- a/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/BlobLoggerProvider.xml +++ b/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/BlobLoggerProvider.xml @@ -44,8 +44,7 @@ - - + Creates a new instance of . To be added. @@ -69,8 +68,7 @@ - - + The container to store logs to. Creates a new instance of . To be added. @@ -102,7 +100,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/FileLoggerProvider.xml b/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/FileLoggerProvider.xml index 3b249d72d80..be3c2bc34a8 100644 --- a/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/FileLoggerProvider.xml +++ b/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/FileLoggerProvider.xml @@ -208,7 +208,7 @@ This API supports the .NET infrastructure and is not intended to be used directl To be added. This API supports the .NET infrastructure and is not intended to be used directly from your code. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/ICloudAppendBlob.xml b/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/ICloudAppendBlob.xml index ee3c9e476bc..bd110c4f7d0 100644 --- a/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/ICloudAppendBlob.xml +++ b/xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/ICloudAppendBlob.xml @@ -59,6 +59,8 @@ This API supports the .NET infrastructure and is not intended to be used directl This API supports the .NET infrastructure and is not intended to be used directly from your code. +This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + ]]> @@ -89,6 +91,8 @@ This API supports the .NET infrastructure and is not intended to be used directl This API supports the .NET infrastructure and is not intended to be used directly from your code. +This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + ]]> @@ -119,6 +123,8 @@ This API supports the .NET infrastructure and is not intended to be used directl This API supports the .NET infrastructure and is not intended to be used directly from your code. +This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + ]]> diff --git a/xml/Microsoft.Extensions.Logging.AzureAppServices/BatchingLoggerProvider.xml b/xml/Microsoft.Extensions.Logging.AzureAppServices/BatchingLoggerProvider.xml index 933ba6f6cf8..b78b3e387be 100644 --- a/xml/Microsoft.Extensions.Logging.AzureAppServices/BatchingLoggerProvider.xml +++ b/xml/Microsoft.Extensions.Logging.AzureAppServices/BatchingLoggerProvider.xml @@ -108,7 +108,7 @@ A that can be used to cancel the delay. Wait for the given . A which completes when the has passed or the has been canceled. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/Mono.Security.Interface/IMonoSslStream.xml b/xml/Mono.Security.Interface/IMonoSslStream.xml index 56a98c8d9e5..291cdfd34af 100644 --- a/xml/Mono.Security.Interface/IMonoSslStream.xml +++ b/xml/Mono.Security.Interface/IMonoSslStream.xml @@ -95,7 +95,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -126,7 +126,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -205,7 +205,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -236,7 +236,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Activities/WorkflowInvoker.xml b/xml/System.Activities/WorkflowInvoker.xml index b2aa795ed7c..b29d5e994e4 100644 --- a/xml/System.Activities/WorkflowInvoker.xml +++ b/xml/System.Activities/WorkflowInvoker.xml @@ -320,7 +320,9 @@ :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet34"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1065,7 +1067,9 @@ The following example invokes a workflow consisting of a single `Add` activity t :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet33"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1113,7 +1117,9 @@ The following example invokes a workflow consisting of a single `Add` activity t :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet33"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1157,7 +1163,9 @@ The following example invokes a workflow consisting of a single `Add` activity t :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet33"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1208,7 +1216,9 @@ The following example invokes a workflow consisting of a single `Add` activity t :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet33"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1254,7 +1264,9 @@ The following example invokes a workflow consisting of a single `Add` activity t :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet33"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1307,7 +1319,9 @@ The following example invokes a workflow consisting of a single `Add` activity t :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet33"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1356,7 +1370,9 @@ The following example invokes a workflow consisting of a single `Add` activity t :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet33"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1407,7 +1423,9 @@ The following example invokes a workflow consisting of a single `Add` activity t :::code language="csharp" source="~/snippets/csharp/VS_Snippets_CFX/cfx_workflowinvokerexample/cs/program.cs" id="Snippet33"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.CodeDom.Compiler/IndentedTextWriter.xml b/xml/System.CodeDom.Compiler/IndentedTextWriter.xml index 34773fec4c9..53ba64cb290 100644 --- a/xml/System.CodeDom.Compiler/IndentedTextWriter.xml +++ b/xml/System.CodeDom.Compiler/IndentedTextWriter.xml @@ -318,7 +318,7 @@ Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously. A representing the asynchronous dispose operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -446,7 +446,7 @@ Clears all buffers for this asynchronously and causes any buffered data to be written to the underlying device. A representing the asynchronous flush operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -678,7 +678,7 @@ Asynchronously outputs tabs to the underlying based on the current . A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1380,7 +1380,7 @@ The to write. Asynchronously writes the specified to the underlying , inserting tabs at the start of every line. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1415,7 +1415,7 @@ The string to write. Asynchronously writes the specified string to the underlying , inserting tabs at the start of every line. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1451,7 +1451,7 @@ Token for canceling the operation. Asynchronously writes the specified characters to the underlying , inserting tabs at the start of every line. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1487,7 +1487,7 @@ Token for canceling the operation. Asynchronously writes the contents of the specified to the underlying , inserting tabs at the start of every line. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1526,7 +1526,7 @@ The number of characters to write. Asynchronously writes the specified number of s from the specified buffer to the underlying , starting at the specified index, and outputting tabs at the start of every new line. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2322,7 +2322,7 @@ Asynchronously writes the line terminator to the underlying . A representing the asynchronous line writing operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2358,7 +2358,7 @@ The character to write. Asynchronously writes the specified to the underlying followed by a line terminator, inserting tabs at the start of every line. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2393,7 +2393,7 @@ The string to write. Asynchronously writes the specified string followed by a line terminator to the underlying , inserting tabs at the start of every line. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2429,7 +2429,7 @@ Token for canceling the operation. Asynchronously writes the specified characters followed by a line terminator to the underlying , inserting tabs at the start of every line. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2465,7 +2465,7 @@ Token for canceling the operation. Asynchronously writes the contents of the specified followed by a line terminator to the underlying , inserting tabs at the start of every line. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2504,7 +2504,7 @@ The number of characters to write. Asynchronously writes the specified number of characters from the specified buffer followed by a line terminator, to the underlying , starting at the specified index within the buffer, inserting tabs at the start of every line. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2598,7 +2598,7 @@ The string to write. Asynchronously writes the specified string to the underlying without inserting tabs. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Collections.Generic/IAsyncEnumerator`1.xml b/xml/System.Collections.Generic/IAsyncEnumerator`1.xml index e8d181b2975..a45d61f4a6c 100644 --- a/xml/System.Collections.Generic/IAsyncEnumerator`1.xml +++ b/xml/System.Collections.Generic/IAsyncEnumerator`1.xml @@ -107,7 +107,7 @@ Advances the enumerator asynchronously to the next element of the collection. A that will complete with a result of if the enumerator was successfully advanced to the next element, or if the enumerator has passed the end of the collection. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.CommandLine.Invocation/ICommandHandler.xml b/xml/System.CommandLine.Invocation/ICommandHandler.xml index 657ec81fec7..d1639ff9e32 100644 --- a/xml/System.CommandLine.Invocation/ICommandHandler.xml +++ b/xml/System.CommandLine.Invocation/ICommandHandler.xml @@ -41,7 +41,7 @@ Performs an action when the associated command is invoked on the command line. A value that can be used as the exit code for the process. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.CommandLine.Parsing/ParseResultExtensions.xml b/xml/System.CommandLine.Parsing/ParseResultExtensions.xml index 3bf3e462881..81439843040 100644 --- a/xml/System.CommandLine.Parsing/ParseResultExtensions.xml +++ b/xml/System.CommandLine.Parsing/ParseResultExtensions.xml @@ -130,7 +130,7 @@ Invokes the appropriate command handler for a parsed command line input. A task whose result can be used as a process exit code. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.CommandLine.Parsing/ParserExtensions.xml b/xml/System.CommandLine.Parsing/ParserExtensions.xml index 408866c99b9..babeefcbde0 100644 --- a/xml/System.CommandLine.Parsing/ParserExtensions.xml +++ b/xml/System.CommandLine.Parsing/ParserExtensions.xml @@ -107,7 +107,7 @@ Parses a command line string value and invokes the handler for the indicated command. The exit code for the invocation. - The command line string input will be split into tokens as if it had been passed on the command line. + The command line string input will be split into tokens as if it had been passed on the command line.This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -137,7 +137,7 @@ Parses a command line string array and invokes the handler for the indicated command. The exit code for the invocation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.CommandLine/CommandExtensions.xml b/xml/System.CommandLine/CommandExtensions.xml index b9593400277..e008a440281 100644 --- a/xml/System.CommandLine/CommandExtensions.xml +++ b/xml/System.CommandLine/CommandExtensions.xml @@ -107,7 +107,7 @@ Parses and invokes a command. The exit code for the invocation. - The command line string input will be split into tokens as if it had been passed on the command line. + The command line string input will be split into tokens as if it had been passed on the command line.This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -137,7 +137,7 @@ Parses and invokes a command. The exit code for the invocation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.ComponentModel/BackgroundWorker.xml b/xml/System.ComponentModel/BackgroundWorker.xml index 0838cfa75ed..dbe58370f09 100644 --- a/xml/System.ComponentModel/BackgroundWorker.xml +++ b/xml/System.ComponentModel/BackgroundWorker.xml @@ -199,7 +199,9 @@ :::code language="csharp" source="~/snippets/csharp/System.ComponentModel/BackgroundWorker/Overview/fibonacciform.cs" id="Snippet4"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/VB/fibonacciform.vb" id="Snippet4"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -910,7 +912,9 @@ :::code language="csharp" source="~/snippets/csharp/System.ComponentModel/BackgroundWorker/IsBusy/Form1.cs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker.IsBusy/VB/Form1.vb" id="Snippet2"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -978,7 +982,9 @@ :::code language="csharp" source="~/snippets/csharp/System.ComponentModel/BackgroundWorker/Overview/fibonacciform.cs" id="Snippet3"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/System.ComponentModel.BackgroundWorker/VB/fibonacciform.vb" id="Snippet3"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . diff --git a/xml/System.Data.Common/DbBatch.xml b/xml/System.Data.Common/DbBatch.xml index 54b91face44..628149404d6 100644 --- a/xml/System.Data.Common/DbBatch.xml +++ b/xml/System.Data.Common/DbBatch.xml @@ -292,7 +292,9 @@ The precise semantics of batch execution vary across ADO.NET providers, especial The default implementation of this asynchronous method delegates to its synchronous counterpart and returns a completed `ValueTask`, potentially blocking the calling thread. Data providers that support [asynchronous programming](/dotnet/framework/data/adonet/asynchronous-programming) should override the default implementation using asynchronous I/O operations. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -366,7 +368,9 @@ The precise semantics of batch execution vary across ADO.NET providers, especial ## Remarks For more information about asynchronous programming, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -436,7 +440,9 @@ The precise semantics of batch execution vary across ADO.NET providers, especial ## Remarks For more information about asynchronous programming, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the batch. ADO.NET Overview @@ -502,7 +508,9 @@ The precise semantics of batch execution vary across ADO.NET providers, especial ## Remarks Managed provider implementers must call in . For more information about asynchronous programming, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the batch. The value is invalid. @@ -538,7 +546,9 @@ The precise semantics of batch execution vary across ADO.NET providers, especial ## Remarks Managed provider implementers must call in . For more information about asynchronous programming, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the batch. The value is invalid. @@ -590,7 +600,7 @@ The precise semantics of batch execution vary across ADO.NET providers, especial A token to cancel the asynchronous operation. An asynchronous version of , which executes the batch and returns the first column of the first row in the first returned result set. All other columns, rows and result sets are ignored. The first column of the first row in the first result set. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . An error occurred while executing the batch. @@ -638,7 +648,7 @@ The precise semantics of batch execution vary across ADO.NET providers, especial An optional token to cancel the asynchronous operation. The default value is . Asynchronously creates a prepared (or compiled) version of the batch, or of each of its commands, on the data source. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Data.Common/DbCommand.xml b/xml/System.Data.Common/DbCommand.xml index 00907fa09d9..f651221564d 100644 --- a/xml/System.Data.Common/DbCommand.xml +++ b/xml/System.Data.Common/DbCommand.xml @@ -747,7 +747,9 @@ The default implementation of this asynchronous method delegates to its synchronous counterpart and returns a completed `ValueTask`, potentially blocking the calling thread. Data providers that support [asynchronous programming](/dotnet/framework/data/adonet/asynchronous-programming) should override the default implementation using asynchronous I/O operations. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -848,7 +850,9 @@ ## Remarks For more information about asynchronous programming, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the command. An invalid value. @@ -973,7 +977,9 @@ ## Remarks For more information about asynchronous programming, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the command. ADO.NET Overview @@ -1028,7 +1034,9 @@ ## Remarks For more information about asynchronous programming, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the command. ADO.NET Overview @@ -1192,7 +1200,9 @@ ## Remarks Managed provider implementers must call in . For more information about asynchronous programming, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the command. An invalid value. @@ -1246,7 +1256,9 @@ ## Remarks Managed provider implementers must call in . For more information about asynchronous programming, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the command. An invalid value. @@ -1300,7 +1312,9 @@ ## Remarks Managed provider implementers must call in . For more information about asynchronous programming, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the command. An invalid value. @@ -1354,7 +1368,9 @@ ## Remarks Managed provider implementers must call in . For more information about asynchronous programming, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the command. An invalid value. @@ -1478,7 +1494,9 @@ ## Remarks For more information about asynchronous programming, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the command. ADO.NET Overview @@ -1534,7 +1552,9 @@ ## Remarks For more information about asynchronous programming, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the command. ADO.NET Overview @@ -1682,7 +1702,9 @@ If the property is set to `TableDirect`, `PrepareAsync` does nothing. If is set to `StoredProcedure`, the call to `PrepareAsync` should succeed, although it may result in a no-op. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Data.Common/DbConnection.xml b/xml/System.Data.Common/DbConnection.xml index 60f2d2bd699..3d6e85e2428 100644 --- a/xml/System.Data.Common/DbConnection.xml +++ b/xml/System.Data.Common/DbConnection.xml @@ -209,7 +209,9 @@ Data providers that support [asynchronous programming](/dotnet/framework/data/adonet/asynchronous-programming) should override the default implementation using asynchronous I/O operations. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -368,7 +370,9 @@ Data providers that support [asynchronous programming](/dotnet/framework/data/adonet/asynchronous-programming) should override the default implementation using asynchronous I/O operations. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -414,7 +418,9 @@ Data providers that support [asynchronous programming](/dotnet/framework/data/adonet/asynchronous-programming) should override the default implementation using asynchronous I/O operations. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -550,7 +556,9 @@ This property returns `false` by default; providers that implement + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -660,7 +668,9 @@ This property returns `false` by default; providers that implement [!CAUTION] > Do not close or dispose a `DbConnection`, a `DbDataReader`, or any other managed object in the `Finalize` method of your class. In a finalizer, you should only release unmanaged resources that your class owns directly. If your class does not own any unmanaged resources, do not include a `Finalize` method in your class definition. For more information, see [Garbage Collection](/dotnet/standard/garbage-collection/). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1154,7 +1164,9 @@ This property returns `false` by default; providers that implement + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1417,7 +1429,7 @@ This property returns `false` by default; providers that implement . Exceptions thrown by will be communicated via the returned Task Exception property. A task representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1453,7 +1465,7 @@ This property returns `false` by default; providers that implement . Exceptions thrown by will be communicated via the returned Task Exception property. A task representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1491,7 +1503,7 @@ This property returns `false` by default; providers that implement . Exceptions thrown by will be communicated via the returned Task Exception property. A task representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1662,7 +1674,9 @@ This property returns `false` by default; providers that implement + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> ADO.NET Overview @@ -1720,7 +1734,9 @@ This property returns `false` by default; providers that implement + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> ADO.NET Overview diff --git a/xml/System.Data.Common/DbDataReader.xml b/xml/System.Data.Common/DbDataReader.xml index 8b40c8fdac3..c42672311c0 100644 --- a/xml/System.Data.Common/DbDataReader.xml +++ b/xml/System.Data.Common/DbDataReader.xml @@ -203,7 +203,9 @@ Data providers that support [asynchronous programming](/dotnet/framework/data/adonet/asynchronous-programming) should override the default implementation using asynchronous I/O operations. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -428,7 +430,9 @@ Data providers that support [asynchronous programming](/dotnet/framework/data/adonet/asynchronous-programming) should override the default implementation using asynchronous I/O operations. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -775,7 +779,7 @@ The default implementation will return a cancelled task if passed an already cancelled . Exceptions thrown by will be communicated via the returned Task Exception property. A task representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2046,7 +2050,7 @@ Returns if the executed command returned no resultset, o The default implementation will return a cancelled task if passed an already cancelled . Exceptions thrown by will be communicated via the returned Task Exception property. A task representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2534,7 +2538,9 @@ Returns if the executed command returned no resultset, o Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The connection was dropped or closed during the data retrieval. @@ -2611,7 +2617,9 @@ Returns if the executed command returned no resultset, o This method accepts a cancellation token that can be used to request the operation to be cancelled early. Implementations may ignore this request. Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The connection was dropped or closed during the data retrieval. @@ -2854,7 +2862,9 @@ Returns if the executed command returned no resultset, o Data providers that support [asynchronous programming](/dotnet/framework/data/adonet/asynchronous-programming) should override the default implementation using asynchronous I/O operations. Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the command text. ADO.NET Overview @@ -2909,7 +2919,9 @@ Returns if the executed command returned no resultset, o This method accepts a cancellation token that can be used to request the operation to be cancelled early. Implementations may ignore this request. Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the command text. ADO.NET Overview @@ -3030,7 +3042,9 @@ Returns if the executed command returned no resultset, o Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the command text. ADO.NET Overview @@ -3086,7 +3100,9 @@ Returns if the executed command returned no resultset, o Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An error occurred while executing the command text. ADO.NET Overview diff --git a/xml/System.Data.Common/DbDataSource.xml b/xml/System.Data.Common/DbDataSource.xml index bb3ae447ebc..3136566d3a5 100644 --- a/xml/System.Data.Common/DbDataSource.xml +++ b/xml/System.Data.Common/DbDataSource.xml @@ -338,7 +338,9 @@ ## Remarks If the current instance of represents a connection pool, disposing it should close all idle connections, and arrange for busy connections to be closed as soon as possible. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -431,7 +433,9 @@ It is the responsibility of the caller to properly dispose the connection returned by this method. Failure to do so may result in a connection leak. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -491,7 +495,9 @@ ## Remarks This method is meant to be overridden by implementing ADO.NET providers, and is not a user-facing API. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Data.Common/DbTransaction.xml b/xml/System.Data.Common/DbTransaction.xml index d4cbbbf861c..ea86d2a65e2 100644 --- a/xml/System.Data.Common/DbTransaction.xml +++ b/xml/System.Data.Common/DbTransaction.xml @@ -195,7 +195,9 @@ Data providers that support [asynchronous programming](/dotnet/framework/data/adonet/asynchronous-programming) should override the default implementation using asynchronous I/O operations. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -459,7 +461,9 @@ Data providers that support [asynchronous programming](/dotnet/framework/data/adonet/asynchronous-programming) should override the default implementation using asynchronous I/O operations. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -564,7 +568,7 @@ An optional token to cancel the asynchronous operation. The default value is . Destroys a savepoint previously defined in the current transaction. This allows the system to reclaim some resources before the transaction ends. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -680,7 +684,9 @@ Data providers that support [asynchronous programming](/dotnet/framework/data/adonet/asynchronous-programming) should override the default implementation using asynchronous I/O operations. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -712,7 +718,7 @@ An optional token to cancel the asynchronous operation. The default value is . Rolls back all commands that were executed after the specified savepoint was established. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -772,7 +778,7 @@ An optional token to cancel the asynchronous operation. The default value is . Creates a savepoint in the transaction. This allows all commands that are executed after the savepoint was established to be rolled back, restoring the transaction state to what it was at the time of the savepoint. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Data.SqlClient/SqlAuthenticationProvider.xml b/xml/System.Data.SqlClient/SqlAuthenticationProvider.xml index d6b447c69e1..1fc85493ed0 100644 --- a/xml/System.Data.SqlClient/SqlAuthenticationProvider.xml +++ b/xml/System.Data.SqlClient/SqlAuthenticationProvider.xml @@ -57,7 +57,7 @@ The Active Directory authentication parameters passed by the driver to authentication providers. Acquires a security token from the authority. Represents an asynchronous operation that returns the AD authentication token. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Data.SqlClient/SqlBulkCopy.xml b/xml/System.Data.SqlClient/SqlBulkCopy.xml index e2e5fdfa28d..269ea395632 100644 --- a/xml/System.Data.SqlClient/SqlBulkCopy.xml +++ b/xml/System.Data.SqlClient/SqlBulkCopy.xml @@ -1201,7 +1201,9 @@ For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1242,7 +1244,9 @@ For more information about asynchronous programming in the .NET Framework Data P ## Remarks For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Calling multiple times for the same instance before task completion. @@ -1297,7 +1301,9 @@ For more information about asynchronous programming in the .NET Framework Data P ## Remarks For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Calling multiple times for the same instance before task completion. @@ -1352,7 +1358,9 @@ For more information about asynchronous programming in the .NET Framework Data P ## Remarks For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Calling multiple times for the same instance before task completion. @@ -1413,7 +1421,7 @@ For more information about asynchronous programming in the .NET Framework Data P The cancellation instruction. A value in this parameter makes this method equivalent to . The asynchronous version of , which copies all rows from the supplied array to a destination table specified by the property of the object. Returns . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1457,7 +1465,9 @@ For more information about asynchronous programming in the .NET Framework Data P ## Remarks For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Calling multiple times for the same instance before task completion. @@ -1514,7 +1524,9 @@ For more information about asynchronous programming in the .NET Framework Data P ## Remarks For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Calling multiple times for the same instance before task completion. @@ -1573,7 +1585,9 @@ For more information about asynchronous programming in the .NET Framework Data P ## Remarks For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Calling multiple times for the same instance before task completion. @@ -1632,7 +1646,9 @@ For more information about asynchronous programming in the .NET Framework Data P ## Remarks For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Calling multiple times for the same instance before task completion. @@ -1697,7 +1713,9 @@ For more information about asynchronous programming in the .NET Framework Data P ## Remarks For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Calling multiple times for the same instance before task completion. diff --git a/xml/System.Data.SqlClient/SqlCommand.xml b/xml/System.Data.SqlClient/SqlCommand.xml index 9592c9e4724..06bfee447f3 100644 --- a/xml/System.Data.SqlClient/SqlCommand.xml +++ b/xml/System.Data.SqlClient/SqlCommand.xml @@ -2557,7 +2557,7 @@ In some situations, can be set to To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2694,7 +2694,9 @@ If no statements are detected that contribute to the count, the return value is ## Remarks For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> A other than **Binary** or **VarBinary** was used when was set to . For more information about streaming, see [SqlClient Streaming Support](/dotnet/framework/data/adonet/sqlclient-streaming-support). @@ -2959,7 +2961,9 @@ The closed or dropped durin ## Remarks For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> A other than **Binary** or **VarBinary** was used when was set to . For more information about streaming, see [SqlClient Streaming Support](/dotnet/framework/data/adonet/sqlclient-streaming-support). @@ -3033,7 +3037,9 @@ The closed or dropped durin ## Remarks For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> A other than **Binary** or **VarBinary** was used when was set to . For more information about streaming, see [SqlClient Streaming Support](/dotnet/framework/data/adonet/sqlclient-streaming-support). @@ -3109,7 +3115,9 @@ The closed or dropped durin ## Remarks For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> A other than **Binary** or **VarBinary** was used when was set to . For more information about streaming, see [SqlClient Streaming Support](/dotnet/framework/data/adonet/sqlclient-streaming-support). @@ -3187,7 +3195,9 @@ A timeout occurred during a streaming operation. For more information about stre ## Remarks For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> A other than **Binary** or **VarBinary** was used when was set to . For more information about streaming, see [SqlClient Streaming Support](/dotnet/framework/data/adonet/sqlclient-streaming-support). @@ -3349,7 +3359,9 @@ A timeout occurred during a streaming operation. For more information about stre ## Remarks For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> A other than **Binary** or **VarBinary** was used when was set to . For more information about streaming, see [SqlClient Streaming Support](/dotnet/framework/data/adonet/sqlclient-streaming-support). @@ -3521,7 +3533,9 @@ The **XmlReader** returned by this method does not support asynchronous operatio For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> A other than **Binary** or **VarBinary** was used when was set to . For more information about streaming, see [SqlClient Streaming Support](/dotnet/framework/data/adonet/sqlclient-streaming-support). @@ -3599,7 +3613,9 @@ The **XmlReader** returned by this method does not support asynchronous operatio For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> A other than **Binary** or **VarBinary** was used when was set to . For more information about streaming, see [SqlClient Streaming Support](/dotnet/framework/data/adonet/sqlclient-streaming-support). diff --git a/xml/System.Data.SqlClient/SqlConnection.xml b/xml/System.Data.SqlClient/SqlConnection.xml index d6865c44734..2052d3cb243 100644 --- a/xml/System.Data.SqlClient/SqlConnection.xml +++ b/xml/System.Data.SqlClient/SqlConnection.xml @@ -2622,7 +2622,9 @@ class Program { For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Calling more than once for the same instance before task completion. diff --git a/xml/System.Data.SqlClient/SqlDataReader.xml b/xml/System.Data.SqlClient/SqlDataReader.xml index 07e69f4ac45..4044c2e8801 100644 --- a/xml/System.Data.SqlClient/SqlDataReader.xml +++ b/xml/System.Data.SqlClient/SqlDataReader.xml @@ -3724,7 +3724,9 @@ This member is an explicit interface member implementation. It can be used only ## Remarks For more information, see [SqlClient Streaming Support](/dotnet/framework/data/adonet/sqlclient-streaming-support). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The connection drops or is closed during the data retrieval. @@ -3967,7 +3969,9 @@ This member is an explicit interface member implementation. It can be used only ## Remarks For more information about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Calling more than once for the same instance before task completion. @@ -4092,7 +4096,9 @@ This member is an explicit interface member implementation. It can be used only For more information, including code samples, about asynchronous programming in the .NET Framework Data Provider for SQL Server, see [Asynchronous Programming](/dotnet/framework/data/adonet/asynchronous-programming). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Calling more than once for the same instance before task completion. diff --git a/xml/System.Data/DataReaderExtensions.xml b/xml/System.Data/DataReaderExtensions.xml index 786b472f6b2..45e4d054971 100644 --- a/xml/System.Data/DataReaderExtensions.xml +++ b/xml/System.Data/DataReaderExtensions.xml @@ -1166,7 +1166,9 @@ Other methods and properties of the DbDataReader object should not be invoked while the returned Task is not yet completed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The connection was dropped or closed during the data retrieval. diff --git a/xml/System.Device.Location/CivicAddressResolver.xml b/xml/System.Device.Location/CivicAddressResolver.xml index df83d7c1840..436010c2793 100644 --- a/xml/System.Device.Location/CivicAddressResolver.xml +++ b/xml/System.Device.Location/CivicAddressResolver.xml @@ -151,7 +151,9 @@ CivicAddressResolver resolver = new CivicAddressResolver(); :::code language="csharp" source="~/snippets/csharp/System.Device.Location/CivicAddress/Overview/resolvecivicaddressasync.cs" id="Snippet1"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Misc/system.device.location.resolvecivicaddressasync/vb/resolvecivicaddressasync.vb" id="Snippet1"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . diff --git a/xml/System.Device.Location/ICivicAddressResolver.xml b/xml/System.Device.Location/ICivicAddressResolver.xml index eb872e92586..270075b6432 100644 --- a/xml/System.Device.Location/ICivicAddressResolver.xml +++ b/xml/System.Device.Location/ICivicAddressResolver.xml @@ -88,7 +88,9 @@ :::code language="csharp" source="~/snippets/csharp/System.Device.Location/CivicAddress/Overview/resolvecivicaddressasync.cs" id="Snippet2"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Misc/system.device.location.resolvecivicaddressasync/vb/resolvecivicaddressasync.vb" id="Snippet2"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Diagnostics/Process.xml b/xml/System.Diagnostics/Process.xml index 104fc466c93..2a40a42f208 100644 --- a/xml/System.Diagnostics/Process.xml +++ b/xml/System.Diagnostics/Process.xml @@ -6847,7 +6847,9 @@ The file specified in the could not be found. Calling this method will set to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Formats.Tar/TarEntry.xml b/xml/System.Formats.Tar/TarEntry.xml index 718d29c8b92..524e143e564 100644 --- a/xml/System.Formats.Tar/TarEntry.xml +++ b/xml/System.Formats.Tar/TarEntry.xml @@ -168,6 +168,7 @@ An I/O problem occurred. Files of type , , or can only be extracted in Unix platforms. Elevation is required to extract a or to disk. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . diff --git a/xml/System.Formats.Tar/TarFile.xml b/xml/System.Formats.Tar/TarFile.xml index db31cc85e74..bd0a3d5c4bd 100644 --- a/xml/System.Formats.Tar/TarFile.xml +++ b/xml/System.Formats.Tar/TarFile.xml @@ -120,7 +120,7 @@ The token to monitor for cancellation requests. The default value is . Asynchronously creates a tar stream that contains all the filesystem entries from the specified directory. A task that represents the asynchronous creation operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is . @@ -161,7 +161,7 @@ The token to monitor for cancellation requests. The default value is . Asynchronously creates a tar archive from the contents of the specified directory, and outputs them into the specified path. Can optionally include the base directory as the prefix for the entry names. A task that represents the asynchronous creation operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is . @@ -292,6 +292,7 @@ Extracting one of the tar entries would have resulted in a file outside the spec Files of type , , or can only be extracted in Unix platforms. Elevation is required to extract a or to disk. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is . @@ -341,6 +342,7 @@ Extracting one of the tar entries would have resulted in a file outside the spec Files of type , , or can only be extracted in Unix platforms. Elevation is required to extract a or to disk. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is . diff --git a/xml/System.Formats.Tar/TarReader.xml b/xml/System.Formats.Tar/TarReader.xml index 281cea70e5e..f2a3beedb33 100644 --- a/xml/System.Formats.Tar/TarReader.xml +++ b/xml/System.Formats.Tar/TarReader.xml @@ -98,7 +98,7 @@ Asynchronously disposes the current instance, and closes the streams of all the entries that were read from the archive if the leaveOpen argument was set to in the constructor. A value task that represents the asynchronous dispose operation. - The property of any entry can be replaced with a new stream. If the user decides to replace it on a instance that was obtained using a , the underlying stream gets disposed immediately, freeing the of origin from the responsibility of having to dispose it. + The property of any entry can be replaced with a new stream. If the user decides to replace it on a instance that was obtained using a , the underlying stream gets disposed immediately, freeing the of origin from the responsibility of having to dispose it.This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -175,7 +175,7 @@ Two or more extended attributes entries were found consecutively in the current The token to monitor for cancellation requests. The default value is . Asynchronously retrieves the next entry from the archive stream. A value task containing a instance if a valid entry was found, or if the end of the archive has been reached. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The archive is malformed. diff --git a/xml/System.Formats.Tar/TarWriter.xml b/xml/System.Formats.Tar/TarWriter.xml index f3772831483..6c587f5d0bb 100644 --- a/xml/System.Formats.Tar/TarWriter.xml +++ b/xml/System.Formats.Tar/TarWriter.xml @@ -154,7 +154,7 @@ Asynchronously disposes the current instance, and closes the archive stream if the leaveOpen argument was set to in the constructor. A value task that represents the asynchronous dispose operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -313,7 +313,9 @@ These are the entry types supported for writing on each format: - - - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The entry type is or and the is or empty. The archive stream is disposed. @@ -347,7 +349,7 @@ These are the entry types supported for writing on each format: The token to monitor for cancellation requests. The default value is . Asynchronously writes the specified file into the archive stream as a tar entry. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The archive stream is disposed. or is or empty. diff --git a/xml/System.IO.Compression/BrotliStream.xml b/xml/System.IO.Compression/BrotliStream.xml index bb494427c23..f8102885d8d 100644 --- a/xml/System.IO.Compression/BrotliStream.xml +++ b/xml/System.IO.Compression/BrotliStream.xml @@ -441,6 +441,7 @@ The `DisposeAsync` method lets you perform a resource-intensive dispose operation without blocking the main thread. This performance consideration is particularly important in a Windows 8.x Store app or desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the and keywords in Visual Basic and C#. This method disposes the Brotli stream by writing any changes to the backing store and closing the stream to release resources. Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -576,7 +577,7 @@ The token to monitor for cancellation requests. The default value is . Asynchronously clears all buffers for this Brotli stream, causes any buffered data to be written to the underlying device, and monitors cancellation requests. A task that represents the asynchronous flush operation. - If the operation is canceled before it completes, the returned task contains the value for the property. + If the operation is canceled before it completes, the returned task contains the value for the property.This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -756,6 +757,7 @@ The `ReadAsync` method enables you to perform resource-intensive I/O operations without blocking the main thread. This performance consideration is particularly important in a Windows 8.x Store app or desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the and keywords in Visual Basic and C#. Use the property to determine whether the current instance supports reading. If the operation is canceled before it completes, the returned task contains the value for the property. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -799,6 +801,7 @@ The `ReadAsync` method enables you to perform resource-intensive I/O operations without blocking the main thread. This performance consideration is particularly important in a Windows 8.x Store app or desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the and keywords in Visual Basic and C#. Use the property to determine whether the current instance supports reading. If the operation is canceled before it completes, the returned task contains the value for the property. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1008,6 +1011,7 @@ The `WriteAsync` method enables you to perform resource-intensive I/O operations without blocking the main thread. This performance consideration is particularly important in a Windows 8.x Store app or desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the and keywords in Visual Basic and C#. Use the property to determine whether the current instance supports writing. If the operation is canceled before it completes, the returned task contains the value for the property. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1051,6 +1055,7 @@ The `WriteAsync` method enables you to perform resource-intensive I/O operations without blocking the main thread. This performance consideration is particularly important in a Windows 8.x Store app or desktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. The async methods are used in conjunction with the and keywords in Visual Basic and C#. Use the property to determine whether the current instance supports writing. If the operation is canceled before it completes, the returned task contains the value for the property. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.IO.Compression/DeflateStream.xml b/xml/System.IO.Compression/DeflateStream.xml index a2b9cddf60f..b0df8b4367a 100644 --- a/xml/System.IO.Compression/DeflateStream.xml +++ b/xml/System.IO.Compression/DeflateStream.xml @@ -719,7 +719,9 @@ If the operation is canceled before it completes, the returned task contains the Copying begins at the current position in the current Deflate stream. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -823,7 +825,9 @@ This method disposes the Deflate stream by writing any changes to the backing st Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1054,7 +1058,9 @@ The end write call is invalid. If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1310,7 +1316,9 @@ Use the property to determ If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1373,7 +1381,9 @@ Use the property to determ If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1660,7 +1670,9 @@ Use the property to deter If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1723,7 +1735,9 @@ Use the property to deter If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.IO.Compression/GZipStream.xml b/xml/System.IO.Compression/GZipStream.xml index f7c92f38aeb..b61de836138 100644 --- a/xml/System.IO.Compression/GZipStream.xml +++ b/xml/System.IO.Compression/GZipStream.xml @@ -752,7 +752,9 @@ If the operation is canceled before it completes, the returned task contains the Copying begins at the current position in the current GZip stream. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -855,7 +857,9 @@ This method disposes the GZip stream by writing any changes to the backing store Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1072,7 +1076,9 @@ This method flushes only if the current compression mode is value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1333,7 +1339,9 @@ Use the property to determine If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1396,7 +1404,9 @@ Use the property to determine If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1689,7 +1699,9 @@ Use the property to determin If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1752,7 +1764,9 @@ Use the property to determin If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.IO.Compression/ZLibStream.xml b/xml/System.IO.Compression/ZLibStream.xml index 021e8401589..033c4107827 100644 --- a/xml/System.IO.Compression/ZLibStream.xml +++ b/xml/System.IO.Compression/ZLibStream.xml @@ -364,7 +364,7 @@ The token to monitor for cancellation requests. Asynchronously reads the bytes from the current stream and writes them to another stream, using a specified buffer size and cancellation token. A task that represents the asynchronous copy operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . @@ -419,7 +419,7 @@ Asynchronously releases all resources used by the stream. A task that represents the completion of the disposal operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -518,7 +518,7 @@ The token to monitor for cancellation requests. Asynchronously clears all buffers for this stream, causes any buffered data to be written to the underlying device, and monitors cancellation requests. A task that represents the asynchronous flush operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -645,7 +645,7 @@ The token to monitor for cancellation requests. Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests. A task that represents the asynchronous completion of the operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -677,7 +677,7 @@ The token to monitor for cancellation requests. Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests. A task that represents the asynchronous completion of the operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -834,7 +834,7 @@ The token to monitor for cancellation requests. Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests. A task that represents the asynchronous completion of the operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -866,7 +866,7 @@ The token to monitor for cancellation requests. Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests. A task that represents the asynchronous completion of the operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.IO.Hashing/NonCryptographicHashAlgorithm.xml b/xml/System.IO.Hashing/NonCryptographicHashAlgorithm.xml index 8a8c0a69747..c7515e24ed1 100644 --- a/xml/System.IO.Hashing/NonCryptographicHashAlgorithm.xml +++ b/xml/System.IO.Hashing/NonCryptographicHashAlgorithm.xml @@ -147,7 +147,7 @@ The default value is . Asychronously reads the contents of and appends them to the data already processed for the current hash computation. A task that represents the asynchronous append operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . diff --git a/xml/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml b/xml/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml index bf5362e69f4..a3c6ba7b66d 100644 --- a/xml/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml +++ b/xml/System.IO.IsolatedStorage/IsolatedStorageFileStream.xml @@ -1088,7 +1088,7 @@ Dim source As New IsolatedStorageFileStream(UserName,FileMode.Open,isoFile) Asynchronously releases the unmanaged resources used by the . A task that represents the asynchronous dispose operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1330,7 +1330,7 @@ Dim source As New IsolatedStorageFileStream(UserName,FileMode.Open,isoFile) The token to monitor for cancellation requests. The default value is . Asynchronously clears buffers for this stream and causes any buffered data to be written to the file. A task that represents the asynchronous flush operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1765,7 +1765,7 @@ The method wi The token to monitor for cancellation requests. The default value is . Asynchronously copies bytes from the current buffered object to a byte memory range. A task that represents the asynchronous read operation. It wraps the total number of bytes read into the . This can be less than the number of bytes requested if that many bytes are not currently available, or zero if the end of the stream is reached. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1818,7 +1818,9 @@ The meth The method will return zero only if the end of the stream is reached. In all other cases, always reads at least one byte from the stream before returning. If no data is available from the object upon a call to , the method will block until at least one byte of data can be returned. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -2218,7 +2220,7 @@ If the write operation is successful, the current position of the The token to monitor for cancellation requests. The default value is . Asynchronously writes a block of bytes to the isolated storage file stream object using data read from a buffer consisting of a read-only byte memory range. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2265,7 +2267,9 @@ If the write operation is successful, the current position of the object is advanced by the number of bytes written. If an exception occurs, the current position of the object is unchanged. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.IO.Pipelines/PipeReader.xml b/xml/System.IO.Pipelines/PipeReader.xml index d688eef35b5..e0ee5bb09fc 100644 --- a/xml/System.IO.Pipelines/PipeReader.xml +++ b/xml/System.IO.Pipelines/PipeReader.xml @@ -278,7 +278,7 @@ The canceled An optional exception that indicates the failure that caused the reader to complete. Marks the current pipe reader instance as being complete, meaning no more data will be read from it. A value task that represents the asynchronous complete operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -308,7 +308,7 @@ The canceled The token to monitor for cancellation requests. The default value is . Asynchronously reads the bytes from the and writes them to the specified , using a specified buffer size and cancellation token. A task that represents the asynchronous copy operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -338,7 +338,7 @@ The canceled The token to monitor for cancellation requests. The default value is . Asynchronously reads the bytes from the and writes them to the specified stream, using a specified cancellation token. A task that represents the asynchronous copy operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -481,7 +481,7 @@ The canceled The token to monitor for cancellation requests. The default value is . Asynchronously reads a sequence of bytes from the current . A representing the asynchronous read operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -515,7 +515,9 @@ The canceled has read the `minimumSize` specified, or is cancelled or completed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.IO.Pipelines/PipeWriter.xml b/xml/System.IO.Pipelines/PipeWriter.xml index 9eb766317cb..559a826f69b 100644 --- a/xml/System.IO.Pipelines/PipeWriter.xml +++ b/xml/System.IO.Pipelines/PipeWriter.xml @@ -226,7 +226,7 @@ The canceled An optional exception that indicates the failure that caused the pipeline to complete. Marks the current pipe writer instance as being complete, meaning no more data will be written to it. A value task that represents the asynchronous complete operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -256,7 +256,7 @@ The canceled The token to monitor for cancellation requests. The default value is . Asynchronously reads the bytes from the specified stream and writes them to the . A task that represents the asynchronous copy operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -317,7 +317,7 @@ The canceled The token to monitor for cancellation requests. The default value is . Makes bytes written available to and runs continuation. A task that represents and wraps the asynchronous flush operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -516,7 +516,7 @@ You must request a new buffer after calling The token to monitor for cancellation requests. The default value is . Writes the specified byte memory range to the pipe and makes data accessible to the . A task that represents the asynchronous write operation, and wraps the flush asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.IO.Pipelines/StreamPipeExtensions.xml b/xml/System.IO.Pipelines/StreamPipeExtensions.xml index 9ea93da4ba6..d4380a8da07 100644 --- a/xml/System.IO.Pipelines/StreamPipeExtensions.xml +++ b/xml/System.IO.Pipelines/StreamPipeExtensions.xml @@ -51,7 +51,7 @@ The token to monitor for cancellation requests. The default value is . Asynchronously reads the bytes from the and writes them to the specified , using a cancellation token. A task that represents the asynchronous copy operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.IO.Pipes/NamedPipeClientStream.xml b/xml/System.IO.Pipes/NamedPipeClientStream.xml index 397190aa2f5..ec06c1c890d 100644 --- a/xml/System.IO.Pipes/NamedPipeClientStream.xml +++ b/xml/System.IO.Pipes/NamedPipeClientStream.xml @@ -910,7 +910,7 @@ Asynchronously connects to a waiting server with an infinite timeout period. A task that represents the asynchronous connect operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -951,7 +951,7 @@ The number of milliseconds to wait for the server to respond before the connection times out. Asynchronously connects to a waiting server within the specified timeout period. A task that represents the asynchronous connect operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -992,7 +992,7 @@ The token to monitor for cancellation requests. The default value is . Asynchronously connects to a waiting server and monitors cancellation requests. A task that represents the asynchronous connect operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1035,7 +1035,7 @@ The token to monitor for cancellation requests. The default value is . Asynchronously connects to a waiting server within the specified timeout period and monitors cancellation requests. A task that represents the asynchronous connect operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1065,7 +1065,7 @@ The token to monitor for cancellation requests. The default value is . Asynchronously connects to a waiting server within the specified timeout period and monitors cancellation requests. A task that represents the asynchronous connect operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.IO.Pipes/NamedPipeServerStream.xml b/xml/System.IO.Pipes/NamedPipeServerStream.xml index 95ac942101f..438ba53f162 100644 --- a/xml/System.IO.Pipes/NamedPipeServerStream.xml +++ b/xml/System.IO.Pipes/NamedPipeServerStream.xml @@ -1499,7 +1499,9 @@ ## Remarks Because it is asynchronous, this method returns immediately, but the connection process is completed when the client calls or . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1549,7 +1551,9 @@ Cancellation requests using the cancellation token will only work if the object was created with a pipe option value of or if the cancellation occurs before the method is called. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.IO.Pipes/PipeStream.xml b/xml/System.IO.Pipes/PipeStream.xml index bc4c89f4a20..6830c4b1fa5 100644 --- a/xml/System.IO.Pipes/PipeStream.xml +++ b/xml/System.IO.Pipes/PipeStream.xml @@ -878,7 +878,7 @@ When the disposing parameter is `true`, this method releases all resources held The token to monitor for cancellation requests. Asynchronously clears the buffer for the current stream and causes any buffered data to be written to the underlying device. A task that represent the asynchronous flush operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1594,7 +1594,9 @@ Use the property to determine wheth If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The stream does not support reading. Cannot access a closed pipe. @@ -1659,7 +1661,9 @@ Use the property to determine wheth If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The stream does not support reading. Cannot access a closed pipe. @@ -2278,7 +2282,9 @@ Use the property to determine whet If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Stream does not support writing. Cannot access a closed pipe. @@ -2344,7 +2350,9 @@ Use the property to determine whet If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . diff --git a/xml/System.IO/BinaryWriter.xml b/xml/System.IO/BinaryWriter.xml index ce8265afc00..7c1d20e2869 100644 --- a/xml/System.IO/BinaryWriter.xml +++ b/xml/System.IO/BinaryWriter.xml @@ -651,7 +651,7 @@ Asynchronously releases all resources used by the current instance of the class. A task that represents the asynchronous dispose operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.IO/BufferedStream.xml b/xml/System.IO/BufferedStream.xml index 1ec7ef78231..5c507527a2c 100644 --- a/xml/System.IO/BufferedStream.xml +++ b/xml/System.IO/BufferedStream.xml @@ -808,7 +808,9 @@ If the operation is canceled before it completes, the returned task contains the Copying begins at the current position in the current stream. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -916,7 +918,9 @@ This method disposes the stream by writing any changes to the backing store and Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1151,7 +1155,7 @@ Calling `DisposeAsync` allows the resources used by the The token to monitor for cancellation requests. Asynchronously clears all buffers for this stream, causes any buffered data to be written to the underlying device, and monitors cancellation requests. A task that represents the asynchronous flush operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The stream has been disposed. @@ -1468,7 +1472,9 @@ Use the property to determine whether If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1528,7 +1534,9 @@ If the operation is canceled before it completes, the returned task contains the ## Remarks You can create a cancellation token by creating an instance of the class and passing the property as the `cancellationToken` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1958,7 +1966,9 @@ Use the property to determine whethe If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -2018,7 +2028,9 @@ If the operation is canceled before it completes, the returned task contains the ## Remarks You can create a cancellation token by creating an instance of the class and passing the property as the `cancellationToken` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . diff --git a/xml/System.IO/File.xml b/xml/System.IO/File.xml index bc0d8a05718..ac822502d6b 100644 --- a/xml/System.IO/File.xml +++ b/xml/System.IO/File.xml @@ -348,7 +348,7 @@ The token to monitor for cancellation requests. The default value is . Asynchronously appends lines to a file, and then closes the file. If the specified file does not exist, this method creates a file, writes the specified lines to the file, and then closes the file. A task that represents the asynchronous append operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -394,7 +394,7 @@ The token to monitor for cancellation requests. The default value is . Asynchronously appends lines to a file by using a specified encoding, and then closes the file. If the specified file does not exist, this method creates a file, writes the specified lines to the file, and then closes the file. A task that represents the asynchronous append operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -643,7 +643,7 @@ The token to monitor for cancellation requests. The default value is . Asynchronously opens a file or creates a file if it does not already exist, appends the specified string to the file, and then closes the file. A task that represents the asynchronous append operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -690,7 +690,7 @@ The token to monitor for cancellation requests. The default value is . Asynchronously opens a file or creates the file if it does not already exist, appends the specified string to the file using the specified encoding, and then closes the file. A task that represents the asynchronous append operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -4051,7 +4051,7 @@ The following example moves a file. The token to monitor for cancellation requests. The default value is . Asynchronously opens a binary file, reads the contents of the file into a byte array, and then closes the file. A task that represents the asynchronous read operation, which wraps the byte array containing the contents of the file. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -4303,7 +4303,7 @@ The following example moves a file. The token to monitor for cancellation requests. The default value is . Asynchronously opens a text file, reads all lines of the file, and then closes the file. A task that represents the asynchronous read operation, which wraps the string array containing all lines of the file. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -4347,7 +4347,7 @@ The following example moves a file. The token to monitor for cancellation requests. The default value is . Asynchronously opens a text file, reads all lines of the file with the specified encoding, and then closes the file. A task that represents the asynchronous read operation, which wraps the string array containing all lines of the file. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -4607,7 +4607,7 @@ The following example moves a file. The token to monitor for cancellation requests. The default value is . Asynchronously opens a text file, reads all the text in the file, and then closes the file. A task that represents the asynchronous read operation, which wraps the string containing all text in the file. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -4651,7 +4651,7 @@ The following example moves a file. The token to monitor for cancellation requests. The default value is . Asynchronously opens a text file, reads all text in the file with the specified encoding, and then closes the file. A task that represents the asynchronous read operation, which wraps the string containing all text in the file. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -4896,7 +4896,7 @@ The following example moves a file. The token to monitor for cancellation requests. The default value is . Asynchronously reads the lines of a file. The async enumerable that represents all the lines of the file, or the lines that are the result of a query. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -4930,7 +4930,7 @@ The following example moves a file. The token to monitor for cancellation requests. The default value is . Asynchronously reads the lines of a file that has a specified encoding. The async enumerable that represents all the lines of the file, or the lines that are the result of a query. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -6401,7 +6401,7 @@ It is not possible to change the compression status of a o The token to monitor for cancellation requests. The default value is . Asynchronously creates a new file, writes the specified byte array to the file, and then closes the file. If the target file already exists, it is overwritten. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -6848,7 +6848,7 @@ It is not possible to change the compression status of a o The token to monitor for cancellation requests. The default value is . Asynchronously creates a new file, writes the specified lines to the file, and then closes the file. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -6894,7 +6894,7 @@ It is not possible to change the compression status of a o The token to monitor for cancellation requests. The default value is . Asynchronously creates a new file, write the specified lines to the file by using the specified encoding, and then closes the file. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -7149,7 +7149,7 @@ It is not possible to change the compression status of a o The token to monitor for cancellation requests. The default value is . Asynchronously creates a new file, writes the specified string to the file, and then closes the file. If the target file already exists, it is overwritten. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -7196,7 +7196,7 @@ It is not possible to change the compression status of a o The token to monitor for cancellation requests. The default value is . Asynchronously creates a new file, writes the specified string to the file using the specified encoding, and then closes the file. If the target file already exists, it is overwritten. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.IO/FileStream.xml b/xml/System.IO/FileStream.xml index 6680db14eac..8fc4dc9da06 100644 --- a/xml/System.IO/FileStream.xml +++ b/xml/System.IO/FileStream.xml @@ -2197,7 +2197,9 @@ Copying begins at the current position in the current file stream. For an example of copying between two streams, see the overload. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -2321,7 +2323,9 @@ This method disposes the stream by writing any changes to the backing store and Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -2756,7 +2760,9 @@ Calling `DisposeAsync` allows the resources used by the value for the property. If the handle to the file is disposed, the returned task contains the exception in the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The stream has been disposed. Cancellation @@ -3486,7 +3492,9 @@ The following example shows how to read from a file asynchronously. :::code language="csharp" source="~/snippets/csharp/System.IO/FileStream/Overview/example4.cs" id="Snippet4"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Asynchronous_File_IO_async/vb/example4.vb" id="Snippet4"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -3566,7 +3574,9 @@ The following example shows how to read from a file asynchronously. :::code language="csharp" source="~/snippets/csharp/System.IO/FileStream/Overview/example4.cs" id="Snippet4"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Asynchronous_File_IO_async/vb/example4.vb" id="Snippet4"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -4226,7 +4236,9 @@ Use the property to determine whether th If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -4306,7 +4318,9 @@ If the operation is canceled before it completes, the returned task contains the :::code language="csharp" source="~/snippets/csharp/System.IO/FileStream/Overview/example3.cs" id="Snippet3"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Asynchronous_File_IO_async/vb/example3.vb" id="Snippet3"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . diff --git a/xml/System.IO/MemoryStream.xml b/xml/System.IO/MemoryStream.xml index c4d1686b4d9..71a654321c9 100644 --- a/xml/System.IO/MemoryStream.xml +++ b/xml/System.IO/MemoryStream.xml @@ -1132,7 +1132,7 @@ The stream is unwritable. The token to monitor for cancellation requests. Asynchronously reads all the bytes from the current stream and writes them to another stream, using a specified buffer size and cancellation token. A task that represents the asynchronous copy operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . @@ -1448,7 +1448,9 @@ The pending operation does not support writing. You can create a cancellation token by creating an instance of the class and passing the property as the `cancellationToken` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The stream has been disposed. Cancellation @@ -1888,7 +1890,7 @@ The pending operation does not support writing. To be added. Asynchronously reads a sequence of bytes from the current memory stream, writes the sequence into , advances the position within the memory stream by the number of bytes read, and monitors cancellation requests. A task that represents the asynchronous read operation. The value of its property contains the total number of bytes read into the . The result value can be less than the number of bytes allocated in if that many bytes are not currently available, or it can be 0 (zero) if the end of the memory stream has been reached. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1957,7 +1959,9 @@ The pending operation does not support writing. You can create a cancellation token by creating an instance of the class and passing the property as the `cancellationToken` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -2524,7 +2528,7 @@ The underlying buffer will not be exposed if the current `MemoryStream` instance To be added. Asynchronously writes the sequence of bytes contained in into the current memory stream, advances the current position within this memory stream by the number of bytes written, and monitors cancellation requests. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2593,7 +2597,9 @@ The underlying buffer will not be exposed if the current `MemoryStream` instance You can create a cancellation token by creating an instance of the class and passing the property as the `cancellationToken` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . diff --git a/xml/System.IO/RandomAccess.xml b/xml/System.IO/RandomAccess.xml index 2d5be6dce4c..d7440ce6ec6 100644 --- a/xml/System.IO/RandomAccess.xml +++ b/xml/System.IO/RandomAccess.xml @@ -188,7 +188,9 @@ Position of the file is not advanced. Position of the file is not advanced. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> or is . @@ -238,7 +240,9 @@ Position of the file is not advanced. Position of the file is not advanced. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -420,7 +424,9 @@ Position of the file is not advanced. Position of the file is not advanced. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> or is . @@ -470,7 +476,9 @@ Position of the file is not advanced. Position of the file is not advanced. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . diff --git a/xml/System.IO/Stream.xml b/xml/System.IO/Stream.xml index 449306dcabb..38134ad2800 100644 --- a/xml/System.IO/Stream.xml +++ b/xml/System.IO/Stream.xml @@ -873,7 +873,9 @@ :::code language="csharp" source="~/snippets/csharp/System.IO/FileStream/Overview/example.cs" id="Snippet1"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Asynchronous_File_IO_async/vb/example.vb" id="Snippet1"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -942,7 +944,9 @@ For an example of copying between two streams, see the overload. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1002,7 +1006,9 @@ For an example of copying between two streams, see the overload. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1071,7 +1077,9 @@ For an example of copying between two streams, see the overload. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1331,7 +1339,9 @@ Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1598,7 +1608,9 @@ ## Remarks If a derived class, such as or , does not flush the buffer in its implementation of the method, the method will not flush the buffer. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The stream has been disposed. @@ -1660,7 +1672,9 @@ If a derived class, such as or , does not flush the buffer in its implementation of the method, the method will not flush the buffer. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The stream has been disposed. Cancellation @@ -2068,7 +2082,9 @@ For an example, see the overload. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -2141,7 +2157,9 @@ :::code language="csharp" source="~/snippets/csharp/System.IO/FileStream/Overview/example4.cs" id="Snippet4"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Asynchronous_File_IO_async/vb/example4.vb" id="Snippet4"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -2220,7 +2238,9 @@ For an example, see the overload. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -2330,7 +2350,9 @@ When `minimumBytes` is 0 (zero), this read operation will be completed without w When `minimumBytes` is 0 (zero), this read operation will be completed without waiting for available data in the stream. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is negative, or is greater than the length of . @@ -2547,7 +2569,9 @@ The range specified by the combination of and + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The end of the stream is reached before filling the . @@ -2595,7 +2619,9 @@ When `buffer` is empty, this read operation will be completed without waiting fo When `count` is 0 (zero), this read operation will be completed without waiting for available data in the stream. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -3157,7 +3183,9 @@ This member is an explicit interface member implementation. It can be used only For an example, see the overload. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -3230,7 +3258,9 @@ This member is an explicit interface member implementation. It can be used only :::code language="csharp" source="~/snippets/csharp/System.IO/FileStream/Overview/example3.cs" id="Snippet3"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/Asynchronous_File_IO_async/vb/example3.vb" id="Snippet3"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -3309,7 +3339,9 @@ This member is an explicit interface member implementation. It can be used only For an example, see the overload. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . diff --git a/xml/System.IO/StreamReader.xml b/xml/System.IO/StreamReader.xml index 48b8dcf8862..2caae7f5c18 100644 --- a/xml/System.IO/StreamReader.xml +++ b/xml/System.IO/StreamReader.xml @@ -1955,7 +1955,7 @@ Following a call to , any operations on th The token to monitor for cancellation requests. The default value is . Asynchronously reads the characters from the current stream into a memory block. A value task that represents the asynchronous read operation. The value of the type parameter of the value task contains the number of characters that have been read, or 0 if at the end of the stream and no data was read. The number will be less than or equal to the length, depending on whether the data is available within the stream. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2028,7 +2028,9 @@ Following a call to , any operations on th :::code language="csharp" source="~/snippets/csharp/System.IO/StreamReader/Overview/example42.cs" id="Snippet42"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.IO.StreamReader/VB/example42.vb" id="Snippet42"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -2195,7 +2197,7 @@ Following a call to , any operations on th The token to monitor for cancellation requests. The default value is . Asynchronously reads the characters from the current stream and writes the data to a buffer. A value task that represents the asynchronous read operation. The value of the type parameter of the value task contains the total number of characters read into the buffer. The result value can be less than the number of characters requested if the number of characters currently available is less than the requested number, or it can be 0 (zero) if the end of the stream has been reached. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2260,7 +2262,9 @@ Following a call to , any operations on th ## Remarks The task does not complete until either the number of characters specified by the `count` parameter are read, or the end of the stream has been reached. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -2412,7 +2416,9 @@ Following a call to , any operations on th :::code language="csharp" source="~/snippets/csharp/System.IO/StreamReader/Overview/example41.cs" id="Snippet41"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.IO.StreamReader/VB/example41.vb" id="Snippet41"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The number of characters in the next line is larger than Int32.MaxValue. The stream has been disposed. @@ -2462,7 +2468,9 @@ If this method is canceled via `cancellationToken`, some data that has been read from the current but not stored (by the ) or returned (to the caller) may be lost. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The number of characters in the next line is larger than Int32.MaxValue. The stream reader has been disposed. @@ -2612,7 +2620,9 @@ If this method is canceled via `cancellationToken`, some data :::code language="csharp" source="~/snippets/csharp/System.IO/StreamReader/Overview/example40.cs" id="Snippet40"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.IO.StreamReader/VB/example40.vb" id="Snippet40"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The number of characters is larger than Int32.MaxValue. The stream has been disposed. @@ -2662,7 +2672,9 @@ If this method is canceled via `cancellationToken`, some data that has been read from the current but not stored (by the ) or returned (to the caller) may be lost. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The number of characters is larger than Int32.MaxValue. The stream reader has been disposed. diff --git a/xml/System.IO/StreamWriter.xml b/xml/System.IO/StreamWriter.xml index 9cc74d73399..9774913b9de 100644 --- a/xml/System.IO/StreamWriter.xml +++ b/xml/System.IO/StreamWriter.xml @@ -1226,7 +1226,7 @@ Asynchronously writes any buffered data to the underlying stream and releases the unmanaged resources used by the . A task that represents the asynchronous dispose operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1454,7 +1454,7 @@ For a list of common I/O tasks, see [Common I/O Tasks](/dotnet/standard/io/commo Clears all buffers for this stream asynchronously and causes any buffered data to be written to the underlying device. A task that represents the asynchronous flush operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The stream has been disposed. @@ -2210,7 +2210,9 @@ See + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The stream writer is disposed. The stream writer is currently in use by a previous write operation. @@ -2278,7 +2280,9 @@ See + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The stream writer is disposed. The stream writer is currently in use by a previous write operation. @@ -2324,7 +2328,7 @@ See The token to monitor for cancellation requests. The default value is . Asynchronously writes a character memory region to the stream. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2392,7 +2396,9 @@ See + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -2819,7 +2825,9 @@ See property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The stream writer is disposed. The stream writer is currently in use by a previous write operation. @@ -2891,7 +2899,9 @@ See + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The stream writer is disposed. The stream writer is currently in use by a previous write operation. @@ -2964,7 +2974,9 @@ See + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The stream writer is disposed. The stream writer is currently in use by a previous write operation. @@ -3017,7 +3029,9 @@ See field. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -3091,7 +3105,9 @@ The line terminator is defined by the fi :::code language="csharp" source="~/snippets/csharp/System.IO/StreamWriter/AutoFlush/example25.cs" id="Snippet25"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.IO.StreamWriter/VB/example25.vb" id="Snippet25"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . diff --git a/xml/System.IO/StringReader.xml b/xml/System.IO/StringReader.xml index eb09c8ab3ee..397d18bfbc9 100644 --- a/xml/System.IO/StringReader.xml +++ b/xml/System.IO/StringReader.xml @@ -667,7 +667,7 @@ This implementation of `Close` calls the The token to monitor for cancellation requests. The default value is . Asynchronously reads all the characters from the input string, starting at the current position, and advances the current position to the end of the input string. A task that represents the asynchronous read operation. The value of the parameter contains the total number of characters read into the buffer. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -740,7 +740,9 @@ This implementation of `Close` calls the + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -849,7 +851,9 @@ This implementation of `Close` calls the calls asynchronously, which in turn calls directly. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -915,7 +919,9 @@ This implementation of `Close` calls the + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1080,7 +1086,9 @@ This implementation of `Close` calls the + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The number of characters in the next line is larger than Int32.MaxValue. The string reader has been disposed. @@ -1121,7 +1129,7 @@ This implementation of `Close` calls the The token to monitor for cancellation requests. Reads a line of characters asynchronously from the current string and returns the data as a string. A value task that represents the asynchronous read operation. The value of the TResult parameter contains the next line from the string reader, or is if all of the characters have been read. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The number of characters in the next line is larger than Int32.MaxValue. The string reader has been disposed. The reader is currently in use by a previous read operation. @@ -1271,7 +1279,9 @@ This implementation of `Close` calls the + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The number of characters is larger than Int32.MaxValue. The string reader has been disposed. @@ -1312,7 +1322,7 @@ This implementation of `Close` calls the The token to monitor for cancellation requests. Reads all characters from the current position to the end of the string asynchronously and returns them as a single string. A task that represents the asynchronous read operation. The value of the TResult parameter contains a string with the characters from the current position to the end of the string. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The number of characters is larger than Int32.MaxValue. The string reader has been disposed. The reader is currently in use by a previous read operation. diff --git a/xml/System.IO/StringWriter.xml b/xml/System.IO/StringWriter.xml index 84c1bccb5cf..5c6615bd856 100644 --- a/xml/System.IO/StringWriter.xml +++ b/xml/System.IO/StringWriter.xml @@ -729,7 +729,7 @@ Asynchronously clears all buffers for the current writer and causes any buffered data to be written to the underlying device. A task that represents the asynchronous flush operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1331,7 +1331,9 @@ :::code language="csharp" source="~/snippets/csharp/System.IO/StringWriter/WriteAsync/example5.cs" id="Snippet5"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.io.stringwriter/vb/example5.vb" id="Snippet5"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The string writer is disposed. The string writer is currently in use by a previous write operation. @@ -1399,7 +1401,9 @@ :::code language="csharp" source="~/snippets/csharp/System.IO/StringWriter/WriteAsync/example4.cs" id="Snippet4"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.io.stringwriter/vb/example4.vb" id="Snippet4"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The string writer is disposed. The string writer is currently in use by a previous write operation. @@ -1445,7 +1449,7 @@ The token to monitor for cancellation requests. The default value is . Asynchronously writes a memory region of characters to the string. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1487,7 +1491,7 @@ The token to monitor for cancellation requests. The default value is . Asynchronously writes the text representation of a string builder to the string. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1555,7 +1559,9 @@ :::code language="csharp" source="~/snippets/csharp/System.IO/StringWriter/WriteAsync/example6.cs" id="Snippet6"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR_System/system.io.stringwriter/vb/example6.vb" id="Snippet6"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1724,7 +1730,9 @@ The following example shows how to write characters by using the + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The string writer is disposed. The string writer is currently in use by a previous write operation. @@ -1796,7 +1804,9 @@ The following example shows how to write a string by using the + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The string writer is disposed. The string writer is currently in use by a previous write operation. @@ -1842,7 +1852,7 @@ The following example shows how to write a string by using the The token to monitor for cancellation requests. The default value is . Asynchronously writes the string representation of the memory region of characters to the current string, followed by a line terminator. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1884,7 +1894,7 @@ The following example shows how to write a string by using the The token to monitor for cancellation requests. The default value is . Asynchronously writes the string representation of the string builder to the current string, followed by a line terminator. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1957,7 +1967,9 @@ The following example shows how to write characters by using the + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . diff --git a/xml/System.IO/TextReader.xml b/xml/System.IO/TextReader.xml index c35ab9d2ed3..b354225522f 100644 --- a/xml/System.IO/TextReader.xml +++ b/xml/System.IO/TextReader.xml @@ -729,7 +729,7 @@ The token to monitor for cancellation requests. The default value is . Asynchronously reads the characters from the current stream into a memory block. A value task that represents the asynchronous read operation. The value of the type parameter contains the number of characters that have been read, or 0 if at the end of the stream and no data was read. The number will be less than or equal to the length, depending on whether the data is available within the stream. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -796,7 +796,9 @@ The class is an abstract class. Therefore, you do not instantiate it in your code. For an example of using the method, see the method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -974,7 +976,7 @@ The token to monitor for cancellation requests. The default value is . Asynchronously reads the characters from the current stream and writes the data to a buffer. A value task that represents the asynchronous read operation. The value of the type parameter contains the total number of characters read into the buffer. The result value can be less than the number of characters requested if the number of characters currently available is less than the requested number, or it can be 0 (zero) if the end of the stream has been reached. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1039,7 +1041,9 @@ ## Remarks The task does not complete until either the number of characters specified by the `count` parameter are read, or the end of the text has been reached. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1184,7 +1188,9 @@ If the current represents the standard input stream returned by the property, the method executes synchronously rather than asynchronously. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The number of characters in the next line is larger than Int32.MaxValue. The text reader has been disposed. @@ -1243,7 +1249,9 @@ If the current represents the standard input stream the `Console.In` property, the method executes synchronously rather than asynchronously. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The number of characters in the next line is larger than Int32.MaxValue. The text reader has been disposed. @@ -1377,7 +1385,9 @@ If the current represents the standard input stream ## Remarks The class is an abstract class. Therefore, you do not instantiate it in your code. For an example of using the method, see the method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The number of characters is larger than Int32.MaxValue. The text reader has been disposed. @@ -1432,7 +1442,9 @@ The class is an abstract class. Therefore, you do no your code. For an example of using the method, see the method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The number of characters is larger than Int32.MaxValue. The text reader has been disposed. diff --git a/xml/System.IO/TextWriter.xml b/xml/System.IO/TextWriter.xml index cb101893133..75bf4fc81dd 100644 --- a/xml/System.IO/TextWriter.xml +++ b/xml/System.IO/TextWriter.xml @@ -549,7 +549,7 @@ Asynchronously releases all resources used by the object. A task that represents the asynchronous dispose operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -723,7 +723,7 @@ Asynchronously clears all buffers for the current writer and causes any buffered data to be written to the underlying device. A task that represents the asynchronous flush operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The text writer is disposed. The writer is currently in use by a previous write operation. @@ -2586,7 +2586,9 @@ This method is equivalent to `Write(stringBuilder.ToString())`, but it uses the ## Remarks The class is an abstract class. Therefore, you do not instantiate it in your code. For an example of using the method, see the method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The text writer is disposed. The text writer is currently in use by a previous write operation. @@ -2647,7 +2649,7 @@ This method is equivalent to `Write(stringBuilder.ToString())`, but it uses the The character array to write to the text stream. If is , nothing is written. Writes a character array to the text stream asynchronously. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The text writer is disposed. The text writer is currently in use by a previous write operation. @@ -2713,7 +2715,9 @@ This method is equivalent to `Write(stringBuilder.ToString())`, but it uses the ## Remarks The class is an abstract class. Therefore, you do not instantiate it in your code. For an example of using the method, see the method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The text writer is disposed. The text writer is currently in use by a previous write operation. @@ -2761,7 +2765,7 @@ This method is equivalent to `Write(stringBuilder.ToString())`, but it uses the The token to monitor for cancellation requests. The default value is . Asynchronously writes a character memory region to the text stream. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2810,7 +2814,9 @@ This method is equivalent to `Write(stringBuilder.ToString())`, but it uses the This method is equivalent to calling `WriteAsync(stringBuilder.ToString())`, however, it uses the method to avoid creating the intermediate string. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -2876,7 +2882,9 @@ This method is equivalent to calling `WriteAsync(stringBuilder.ToString())`, how ## Remarks The class is an abstract class. Therefore, you do not instantiate it in your code. For an example of using the method, see the method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -4548,7 +4556,9 @@ The class is an abstract class. Therefore, you do no The line terminator is defined by the field. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The text writer is disposed. The text writer is currently in use by a previous write operation. @@ -4615,7 +4625,9 @@ The line terminator is defined by the fi The class is an abstract class. Therefore, you do not instantiate it in your code. For an example of using the method, see the method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The text writer is disposed. The text writer is currently in use by a previous write operation. @@ -4682,7 +4694,9 @@ The line terminator is defined by the fi ## Remarks The line terminator is defined by the field. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The text writer is disposed. The text writer is currently in use by a previous write operation. @@ -4751,7 +4765,9 @@ The line terminator is defined by the fi The class is an abstract class. Therefore, you do not instantiate it in your code. For an example of using the method, see the method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The text writer is disposed. The text writer is currently in use by a previous write operation. @@ -4806,7 +4822,9 @@ The line terminator is defined by the fi The line terminator is defined by the field. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -4856,7 +4874,9 @@ The line terminator is defined by the fi The line terminator is defined by the field. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -4923,7 +4943,9 @@ The line terminator is defined by the fi The line terminator is defined by the field. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . diff --git a/xml/System.IO/UnmanagedMemoryStream.xml b/xml/System.IO/UnmanagedMemoryStream.xml index 8606d836470..3e884c3f930 100644 --- a/xml/System.IO/UnmanagedMemoryStream.xml +++ b/xml/System.IO/UnmanagedMemoryStream.xml @@ -833,7 +833,9 @@ ## Remarks If the operation isn't cancelled, the calls the method, which means that no action performed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1366,7 +1368,7 @@ This method is equivalent to the The token to monitor for cancellation requests. The default value is . Asynchronously reads the unmanaged memory stream bytes into the memory region. A task that represents the asynchronous read operation, and wraps the total number of bytes read into the buffer. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1432,7 +1434,9 @@ This method is equivalent to the of the property of the returned task. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1831,7 +1835,9 @@ This method is equivalent to the of the property of the returned task. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1898,7 +1904,9 @@ If an exception occurs during the write operation, it will be set as the of the property of the returned task. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.IO/WindowsRuntimeStorageExtensions.xml b/xml/System.IO/WindowsRuntimeStorageExtensions.xml index 354bfcab39b..89a8ec28a94 100644 --- a/xml/System.IO/WindowsRuntimeStorageExtensions.xml +++ b/xml/System.IO/WindowsRuntimeStorageExtensions.xml @@ -260,6 +260,8 @@ The next example shows the XAML code that is associated with the previous exampl :::code language="xaml" source="~/snippets/csharp/System.IO/WindowsRuntimeStorageExtensions/Overview/blankpage.xaml" id="Snippet1"::: +This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + ]]> @@ -318,6 +320,8 @@ The next example shows the XAML code that is associated with the previous exampl :::code language="xaml" source="~/snippets/csharp/System.IO/WindowsRuntimeStorageExtensions/Overview/blankpage2.xaml" id="Snippet3"::: +This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + ]]> @@ -375,6 +379,8 @@ The next example shows the XAML code that is associated with the previous exampl :::code language="xaml" source="~/snippets/csharp/System.IO/WindowsRuntimeStorageExtensions/Overview/blankpage3.xaml" id="Snippet5"::: +This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + ]]> @@ -435,6 +441,8 @@ The next example shows the XAML code that is associated with the previous exampl :::code language="xaml" source="~/snippets/csharp/System.IO/WindowsRuntimeStorageExtensions/Overview/blankpage4.xaml" id="Snippet7"::: +This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + ]]> diff --git a/xml/System.IdentityModel.Selectors/SecurityTokenProvider.xml b/xml/System.IdentityModel.Selectors/SecurityTokenProvider.xml index 8a0e7157d4d..3ef730fb968 100644 --- a/xml/System.IdentityModel.Selectors/SecurityTokenProvider.xml +++ b/xml/System.IdentityModel.Selectors/SecurityTokenProvider.xml @@ -460,7 +460,9 @@ The method calls method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -546,7 +548,9 @@ When the method is overridden and the security token passed into the token parameter cannot be canceled, throw the exception. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -880,7 +884,9 @@ In most cases the `timeout` parameter is not used by derived classes of such as . However, sometimes retrieving a security token involves distributed messaging. An example is used in a federated service. In these cases the `timeout` parameter is used to avoid exceptions caused by network failures, message loss, and other error conditions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -968,7 +974,9 @@ The method is called by the class when a client sends a SOAP message and a security token is required. The method calls the method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1058,7 +1066,9 @@ The method calls the method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1152,7 +1162,9 @@ The method calls the method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Media/SoundPlayer.xml b/xml/System.Media/SoundPlayer.xml index dca88013f57..8f509b32f47 100644 --- a/xml/System.Media/SoundPlayer.xml +++ b/xml/System.Media/SoundPlayer.xml @@ -375,7 +375,9 @@ :::code language="csharp" source="~/snippets/csharp/System.Media/SoundPlayer/Overview/soundtestform.cs" id="Snippet3"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.Sound/VB/soundtestform.vb" id="Snippet3"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The elapsed time during loading exceeds the time, in milliseconds, specified by . The file specified by cannot be found. diff --git a/xml/System.Net.Http.Json/HttpClientJsonExtensions.xml b/xml/System.Net.Http.Json/HttpClientJsonExtensions.xml index 4de9483078e..99737ef9fcc 100644 --- a/xml/System.Net.Http.Json/HttpClientJsonExtensions.xml +++ b/xml/System.Net.Http.Json/HttpClientJsonExtensions.xml @@ -64,7 +64,7 @@ A cancellation token that can be used by other objects or threads to receive notice of cancellation. Sends a DELETE request to the specified Uri and returns the value that results from deserializing the response body as JSON in an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The is . @@ -105,7 +105,7 @@ A cancellation token that can be used by other objects or threads to receive notice of cancellation. Sends a DELETE request to the specified Uri and returns the value that results from deserializing the response body as JSON in an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The is . @@ -155,7 +155,7 @@ A cancellation token that can be used by other objects or threads to receive notice of cancellation. Sends a DELETE request to the specified Uri and returns the value that results from deserializing the response body as JSON in an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The is . @@ -195,7 +195,7 @@ A cancellation token that can be used by other objects or threads to receive notice of cancellation. Sends a DELETE request to the specified Uri and returns the value that results from deserializing the response body as JSON in an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The is . @@ -238,7 +238,7 @@ A cancellation token that can be used by other objects or threads to receive notice of cancellation. Sends a DELETE request to the specified Uri and returns the value that results from deserializing the response body as JSON in an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The is . @@ -271,7 +271,7 @@ A cancellation token that can be used by other objects or threads to receive notice of cancellation. Sends a DELETE request to the specified Uri and returns the value that results from deserializing the response body as JSON in an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The is . @@ -595,7 +595,9 @@ This method uses options for deserialization, whereas deserialization methods do not, by default. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -645,7 +647,9 @@ This method uses options for deserialization, whereas deserialization methods do not, by default. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -697,7 +701,7 @@ This method uses A cancellation token that can be used by other objects or threads to receive notice of cancellation. Sends a GET request to the specified Uri and returns the value that results from deserializing the response body as JSON in an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -737,7 +741,7 @@ This method uses A cancellation token that can be used by other objects or threads to receive notice of cancellation. Sends a GET request to the specified Uri and returns the value that results from deserializing the response body as JSON in an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -781,7 +785,7 @@ This method uses A cancellation token that can be used by other objects or threads to receive notice of cancellation. Sends a GET request to the specified Uri and returns the value that results from deserializing the response body as JSON in an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -814,7 +818,7 @@ This method uses A cancellation token that can be used by other objects or threads to receive notice of cancellation. Sends a GET request to the specified Uri and returns the value that results from deserializing the response body as JSON in an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Net.Http.Json/HttpContentJsonExtensions.xml b/xml/System.Net.Http.Json/HttpContentJsonExtensions.xml index 0454e6a8dc9..81b8a4af79e 100644 --- a/xml/System.Net.Http.Json/HttpContentJsonExtensions.xml +++ b/xml/System.Net.Http.Json/HttpContentJsonExtensions.xml @@ -59,7 +59,7 @@ A cancellation token that can be used by other objects or threads to receive notice of cancellation. Reads the HTTP content and returns the value that results from deserializing the content as JSON in an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -90,7 +90,7 @@ A cancellation token that can be used by other objects or threads to receive notice of cancellation. Reads the HTTP content and returns the value that results from deserializing the content as JSON in an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Net.Http.Json/JsonContent.xml b/xml/System.Net.Http.Json/JsonContent.xml index d20dedf3c8e..4cd18d19e24 100644 --- a/xml/System.Net.Http.Json/JsonContent.xml +++ b/xml/System.Net.Http.Json/JsonContent.xml @@ -185,7 +185,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -216,7 +216,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Net.Http/ByteArrayContent.xml b/xml/System.Net.Http/ByteArrayContent.xml index 9540cbcb80c..a7e735c3853 100644 --- a/xml/System.Net.Http/ByteArrayContent.xml +++ b/xml/System.Net.Http/ByteArrayContent.xml @@ -219,7 +219,9 @@ The class does not internally copy the p ## Remarks This operation will not block. The returned object will complete after all of the content stream has been created. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -304,7 +306,9 @@ The class does not internally copy the p ## Remarks This operation does not block. When the returned object completes, the whole byte array has been written to the `stream` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -345,7 +349,9 @@ The class does not internally copy the p ## Remarks This operation does not block. When the returned object completes, the whole byte array has been written to the `stream` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Net.Http/CFNetworkHandler.xml b/xml/System.Net.Http/CFNetworkHandler.xml index a703e3e89b8..8568cf42549 100644 --- a/xml/System.Net.Http/CFNetworkHandler.xml +++ b/xml/System.Net.Http/CFNetworkHandler.xml @@ -131,7 +131,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Net.Http/DelegatingHandler.xml b/xml/System.Net.Http/DelegatingHandler.xml index c18611b77a0..62c47a611e0 100644 --- a/xml/System.Net.Http/DelegatingHandler.xml +++ b/xml/System.Net.Http/DelegatingHandler.xml @@ -295,7 +295,9 @@ The method is mainly used by the system and not by applications. When this method is called, it calls the method on the inner handler. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The was . diff --git a/xml/System.Net.Http/FormUrlEncodedContent.xml b/xml/System.Net.Http/FormUrlEncodedContent.xml index a2312a6f4c4..d1c121393b5 100644 --- a/xml/System.Net.Http/FormUrlEncodedContent.xml +++ b/xml/System.Net.Http/FormUrlEncodedContent.xml @@ -108,7 +108,9 @@ ## Remarks This operation does not block. When the returned object completes, the all name/value tuples has been written to the `stream` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Net.Http/HttpClient.xml b/xml/System.Net.Http/HttpClient.xml index ea9727d777e..fa1f064ccb6 100644 --- a/xml/System.Net.Http/HttpClient.xml +++ b/xml/System.Net.Http/HttpClient.xml @@ -668,7 +668,9 @@ This property has no effect on any of the - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The request message was already sent by the instance. @@ -730,7 +732,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The request message was already sent by the instance. @@ -801,7 +805,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The request message was already sent by the instance. @@ -865,7 +871,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The request message was already sent by the instance. @@ -1002,7 +1010,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -1057,7 +1067,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -1120,7 +1132,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -1184,7 +1198,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -1241,7 +1257,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -1297,7 +1315,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -1362,7 +1382,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -1421,7 +1443,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -1507,7 +1531,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -1569,7 +1595,9 @@ The is not an absolute URI. > - .NET Core throws a without any inner exception. > - .NET 5 and later versions throw a that nests a . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). @@ -1624,7 +1652,9 @@ The is not an absolute URI. > - .NET Core throws a without any inner exception. > - .NET 5 and later versions throw a that nests a . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). .NET Core and .NET 5 and later only: The request failed due to timeout. @@ -1672,7 +1702,9 @@ The is not an absolute URI. > - .NET Core throws a without any inner exception. > - .NET 5 and later versions throw a that nests a . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). .NET Core and .NET 5 and later only: The request failed due to timeout. @@ -1757,7 +1789,9 @@ The is not an absolute URI. > - .NET Framework throws a . > - .NET Core throws a without any inner exception. > - .NET 5 and later versions throw a that nests a . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). @@ -1818,7 +1852,9 @@ The is not an absolute URI. > - .NET Framework throws a . > - .NET Core throws a without any inner exception. > - .NET 5 and later versions throw a that nests a . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). @@ -1872,7 +1908,9 @@ The is not an absolute URI. > - .NET Framework throws a . > - .NET Core throws a without any inner exception. > - .NET 5 and later versions throw a that nests a . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The is . @@ -1920,7 +1958,9 @@ The is not an absolute URI. > - .NET Framework throws a . > - .NET Core throws a without any inner exception. > - .NET 5 and later versions throw a that nests a . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The is . The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). @@ -2006,7 +2046,9 @@ The is not an absolute URI. > - .NET Framework throws a . > - .NET Core throws a without any inner exception. > - .NET 5 and later versions throw a that nests a . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). @@ -2067,7 +2109,9 @@ The is not an absolute URI. > - .NET Framework throws a . > - .NET Core throws a without any inner exception. > - .NET 5 and later versions throw a that nests a . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). @@ -2121,7 +2165,9 @@ The is not an absolute URI. > - .NET Framework throws a . > - .NET Core throws a without any inner exception. > - .NET 5 and later versions throw a that nests a . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The is . The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). @@ -2169,7 +2215,9 @@ The is not an absolute URI. > - .NET Framework throws a . > - .NET Core throws a without any inner exception. > - .NET 5 and later versions throw a that nests a . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The is . The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation (or timeout for .NET Framework only). @@ -2267,7 +2315,9 @@ The is not an absolute URI. ## Remarks This operation will not block. The returned object will complete after the whole response (including content) is read. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The provided request URI is not valid relative or absolute URI. @@ -2312,7 +2362,9 @@ The is not an absolute URI. ## Remarks This operation will not block. The returned object will complete after the whole response (including content) is read. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -2365,7 +2417,9 @@ The is not an absolute URI. ## Remarks This operation will not block. The returned object will complete after the whole response (including content) is read. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The provided request URI is not valid relative or absolute URI. @@ -2412,7 +2466,9 @@ The is not an absolute URI. ## Remarks This operation will not block. The returned object will complete after the whole response (including content) is read. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -2492,7 +2548,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -2550,7 +2608,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -2616,7 +2676,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -2676,7 +2738,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -2759,7 +2823,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -2817,7 +2883,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -2883,7 +2951,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -2943,7 +3013,9 @@ The is not an absolute URI. > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The must be an absolute URI or must be set. The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout. @@ -3231,7 +3303,9 @@ The custom does not override > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The is . The request message was already sent by the instance. @@ -3287,7 +3361,9 @@ The custom does not override > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The is . The request message was already sent by the instance. @@ -3343,7 +3419,9 @@ The custom does not override > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The is . The request message was already sent by the instance. @@ -3401,7 +3479,9 @@ The custom does not override > - is thrown on all applicable .NET Framework versions. > - without any inner exception is thrown on all applicable .NET Core versions. > - that nests a is thrown on .NET 5 and later versions. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The is . The request message was already sent by the instance. diff --git a/xml/System.Net.Http/HttpClientHandler.xml b/xml/System.Net.Http/HttpClientHandler.xml index ec31b037633..7f110fc6bb0 100644 --- a/xml/System.Net.Http/HttpClientHandler.xml +++ b/xml/System.Net.Http/HttpClientHandler.xml @@ -1042,7 +1042,9 @@ handler.ServerCertificateCustomValidationCallback = HttpClientHandler.DangerousA ## Remarks This operation is does not block. It returns an instance of to represent the asynchronous operation. When the operation completes, contains the response message. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The was . diff --git a/xml/System.Net.Http/HttpContent.xml b/xml/System.Net.Http/HttpContent.xml index 93155e8f585..24e48abbab9 100644 --- a/xml/System.Net.Http/HttpContent.xml +++ b/xml/System.Net.Http/HttpContent.xml @@ -202,7 +202,9 @@ If the content has been previously buffered, for example, by calling object will complete after all of the content has been written to the stream object passed as the `stream` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -250,7 +252,9 @@ If the content has been previously buffered, for example, by calling object will complete after all of the content has been written to the stream object passed as the `stream` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -289,7 +293,9 @@ If the content has been previously buffered, for example, by calling object will complete after all of the content has been written to the stream object passed as the `stream` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -330,7 +336,9 @@ If the content has been previously buffered, for example, by calling object will complete after all of the content has been written to the stream object passed as the `stream` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -423,7 +431,9 @@ Once the operation completes, the returned memory stream represents the HTTP con The method buffers the content to a memory stream. Derived classes can override this behavior if there is a better way to retrieve the content as stream. For example, a byte array or a string could use a more efficient method way such as wrapping a read-only around the bytes or string. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -464,7 +474,9 @@ Once the operation completes, the returned memory stream represents the HTTP con The method buffers the content to a memory stream. Derived classes can override this behavior if there is a better way to retrieve the content as stream. For example, a byte array or a string could use a more efficient method way such as wrapping a read-only around the bytes or string.) - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -657,7 +669,9 @@ When the `disposing` parameter is `true`, this method releases all resources hel After content is serialized to a memory buffer, calls to one of the methods will copy the content of the memory buffer to the target stream. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -712,7 +726,9 @@ When the `disposing` parameter is `true`, this method releases all resources hel If the content exceeds the value passed in the `maxBufferSize` parameter, an exception is thrown. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -764,7 +780,9 @@ When the `disposing` parameter is `true`, this method releases all resources hel Note that this method will internally buffer the content via . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -805,7 +823,9 @@ When the `disposing` parameter is `true`, this method releases all resources hel Note that this method will internally buffer the content via . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -952,7 +972,9 @@ When the `disposing` parameter is `true`, this method releases all resources hel Once the operation completes, the property on the returned task object contains the stream that represents the HTTP content. The returned stream can then be used to read the content using various stream APIs. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -991,7 +1013,9 @@ When the `disposing` parameter is `true`, this method releases all resources hel Once the operation completes, the property on the returned task object contains the stream that represents the HTTP content. The returned stream can then be used to read the content using various stream APIs. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1043,7 +1067,9 @@ When the `disposing` parameter is `true`, this method releases all resources hel Note that this method will internally buffer the content via . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1084,7 +1110,9 @@ When the `disposing` parameter is `true`, this method releases all resources hel Note that this method will internally buffer the content via . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1170,7 +1198,9 @@ When the `disposing` parameter is `true`, this method releases all resources hel ## Remarks This operation will not block. The returned object will complete after all of the content has been serialized to the stream object passed in the `stream` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1211,7 +1241,9 @@ When the `disposing` parameter is `true`, this method releases all resources hel ## Remarks This operation will not block. The returned object will complete after all of the content has been serialized to the stream object passed in the `stream` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Net.Http/HttpMessageHandler.xml b/xml/System.Net.Http/HttpMessageHandler.xml index 229b25208f1..f1f4a53c849 100644 --- a/xml/System.Net.Http/HttpMessageHandler.xml +++ b/xml/System.Net.Http/HttpMessageHandler.xml @@ -263,7 +263,9 @@ When the `disposing` parameter is `true`, this method releases all resources hel The method is used primarily by the system. This method is called by the system when one of the methods is called. Most apps will never call this method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The was . diff --git a/xml/System.Net.Http/HttpMessageInvoker.xml b/xml/System.Net.Http/HttpMessageInvoker.xml index 6b9d871b465..ecff38ad002 100644 --- a/xml/System.Net.Http/HttpMessageInvoker.xml +++ b/xml/System.Net.Http/HttpMessageInvoker.xml @@ -312,7 +312,9 @@ Most applications that are connecting to a web site will use one of the methods on the class. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The was . diff --git a/xml/System.Net.Http/MessageProcessingHandler.xml b/xml/System.Net.Http/MessageProcessingHandler.xml index 70011c6f3a0..932e39ebf04 100644 --- a/xml/System.Net.Http/MessageProcessingHandler.xml +++ b/xml/System.Net.Http/MessageProcessingHandler.xml @@ -296,7 +296,9 @@ ## Remarks This operation does not block. This overridable implementation of method forwards the HTTP request to the inner handler to send to the server as an asynchronous operation. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The was . diff --git a/xml/System.Net.Http/MultipartContent.xml b/xml/System.Net.Http/MultipartContent.xml index f9e46a44184..8d64dfada05 100644 --- a/xml/System.Net.Http/MultipartContent.xml +++ b/xml/System.Net.Http/MultipartContent.xml @@ -276,7 +276,9 @@ This method overrides property on the returned task object contains the stream that represents the multipart/* encoded HTTP content. The returned stream can then be used to read the content using various stream APIs. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -317,7 +319,9 @@ This method overrides property on the returned task object contains the stream that represents the multipart/* encoded HTTP content. The returned stream can then be used to read the content using various stream APIs. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -530,7 +534,9 @@ When the `disposing` parameter is `true`, this method releases all resources hel ## Remarks This operation will not block. The returned object will complete after all of the content has been serialized to the target stream. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -571,7 +577,9 @@ When the `disposing` parameter is `true`, this method releases all resources hel ## Remarks This operation will not block. The returned object will complete after all of the content has been serialized to the target stream. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Net.Http/MultipartFormDataContent.xml b/xml/System.Net.Http/MultipartFormDataContent.xml index cec0cbc2cab..9c7285b5e44 100644 --- a/xml/System.Net.Http/MultipartFormDataContent.xml +++ b/xml/System.Net.Http/MultipartFormDataContent.xml @@ -300,7 +300,9 @@ ## Remarks This operation does not block. When the returned object completes, the whole content has been written to the `stream` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Net.Http/NSUrlSessionHandler.xml b/xml/System.Net.Http/NSUrlSessionHandler.xml index 96b3fc26767..2e55ba0bc7b 100644 --- a/xml/System.Net.Http/NSUrlSessionHandler.xml +++ b/xml/System.Net.Http/NSUrlSessionHandler.xml @@ -159,7 +159,7 @@ The cancellation token to cancel the operation. Sends an HTTP request as an asynchronous operation. The task object representing the asynchronous operation. - This operation is does not block. It returns an instance of  to represent the asynchronous operation. When the operation completes, contains the response message. + This operation is does not block. It returns an instance of  to represent the asynchronous operation. When the operation completes, contains the response message.This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Net.Http/ReadOnlyMemoryContent.xml b/xml/System.Net.Http/ReadOnlyMemoryContent.xml index 5f77e54b3f8..c06f1d32055 100644 --- a/xml/System.Net.Http/ReadOnlyMemoryContent.xml +++ b/xml/System.Net.Http/ReadOnlyMemoryContent.xml @@ -117,7 +117,7 @@ To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -186,7 +186,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -220,7 +220,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Net.Http/SocketsHttpHandler.xml b/xml/System.Net.Http/SocketsHttpHandler.xml index aa27641d6d5..8d8725b1a00 100644 --- a/xml/System.Net.Http/SocketsHttpHandler.xml +++ b/xml/System.Net.Http/SocketsHttpHandler.xml @@ -999,7 +999,7 @@ Draining occurs when a request is cancelled or a response is disposed prior to f The cancellation token. Sends an HTTP request as an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Net.Http/StreamContent.xml b/xml/System.Net.Http/StreamContent.xml index dc1aeb35fb0..042d787e6f8 100644 --- a/xml/System.Net.Http/StreamContent.xml +++ b/xml/System.Net.Http/StreamContent.xml @@ -197,7 +197,7 @@ The object calls Returns the HTTP stream as a read-only stream as an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -328,7 +328,9 @@ When the `disposing` parameter is `true`, this method releases all resources hel ## Remarks This operation will not block. The returned object will complete after all of the content has been serialized to the target stream. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -369,7 +371,9 @@ When the `disposing` parameter is `true`, this method releases all resources hel ## Remarks This operation will not block. The returned object will complete after all of the content has been serialized to the target stream. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Net.Http/StringContent.xml b/xml/System.Net.Http/StringContent.xml index f609b8167ed..0dd78bea9c0 100644 --- a/xml/System.Net.Http/StringContent.xml +++ b/xml/System.Net.Http/StringContent.xml @@ -264,7 +264,9 @@ ## Remarks This operation does not block. When the returned object completes, the whole string has been written to the `stream` parameter. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Net.Http/WinHttpHandler.xml b/xml/System.Net.Http/WinHttpHandler.xml index 83ae034b3fc..8fee3012836 100644 --- a/xml/System.Net.Http/WinHttpHandler.xml +++ b/xml/System.Net.Http/WinHttpHandler.xml @@ -795,7 +795,7 @@ When this property is set to `true`, all HTTP redirect responses from the server The cancellation token. Sends an HTTP request as an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Net.Mail/SmtpClient.xml b/xml/System.Net.Mail/SmtpClient.xml index fbeca554a06..55cd6094d8e 100644 --- a/xml/System.Net.Mail/SmtpClient.xml +++ b/xml/System.Net.Mail/SmtpClient.xml @@ -1325,7 +1325,9 @@ The classes shown in the following table are used to construct email messages th :::code language="csharp" source="~/snippets/csharp/System.Net.Mail/MailAddress/.ctor/mailasync.cs" id="Snippet1"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Remoting/NclMailASync/vb/mailasync.vb" id="Snippet1"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1454,7 +1456,9 @@ The classes shown in the following table are used to construct email messages th > [!NOTE] > If the property is set to `true`, and the SMTP mail server does not advertise STARTTLS in the response to the EHLO command, then a call to the or methods will throw an . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1670,7 +1674,9 @@ The classes shown in the following table are used to construct email messages th ## Remarks This operation will not block. The returned object will complete once the message has been sent. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1752,7 +1758,9 @@ The classes shown in the following table are used to construct email messages th ## Remarks This operation will not block. The returned object will complete once the message has been sent. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1853,7 +1861,9 @@ The classes shown in the following table are used to construct email messages th ## Remarks This operation will not block. The returned object will complete once the message has been sent. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1951,7 +1961,9 @@ The classes shown in the following table are used to construct email messages th ## Remarks This operation will not block. The returned object will complete once the message has been sent. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . diff --git a/xml/System.Net.NetworkInformation/IPGlobalProperties.xml b/xml/System.Net.NetworkInformation/IPGlobalProperties.xml index e64aa37df95..5b8b5fd66b0 100644 --- a/xml/System.Net.NetworkInformation/IPGlobalProperties.xml +++ b/xml/System.Net.NetworkInformation/IPGlobalProperties.xml @@ -1200,7 +1200,9 @@ The method also returns non-Teredo addresses and provides a more convenient way to obtain the unicast IP addresses for a system than enumerating all the objects on a local computer and querying the associated IP addresses. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The call to the native function failed. The caller does not have necessary permission. diff --git a/xml/System.Net.NetworkInformation/Ping.xml b/xml/System.Net.NetworkInformation/Ping.xml index 368a7a33ad1..a29721c17f6 100644 --- a/xml/System.Net.NetworkInformation/Ping.xml +++ b/xml/System.Net.NetworkInformation/Ping.xml @@ -1129,7 +1129,9 @@ ## Examples For a code example that demonstrates calling a method, see the class overview. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1200,7 +1202,9 @@ ## Examples For a code example that demonstrates calling the method, see the class overview. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is or is an empty string (""). @@ -1273,7 +1277,9 @@ ## Examples For a code example that demonstrates calling a overload, see the class overview. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1348,7 +1354,9 @@ ## Examples For a code example that demonstrates calling the method, see the class overview. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is or is an empty string (""). @@ -1432,7 +1440,9 @@ ## Examples For a code example that demonstrates calling a overload, see the class overview. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> or is . @@ -1517,7 +1527,9 @@ ## Examples The following code example demonstrates how to call a overload, see the class overview. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is or is an empty string (""). @@ -1614,7 +1626,9 @@ :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NCLPingSampler/CPP/pingtest.cpp" id="Snippet7"::: :::code language="csharp" source="~/snippets/csharp/System.Net.NetworkInformation/Ping/Send/pingtest.cs" id="Snippet7"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> or is . @@ -1700,7 +1714,9 @@ :::code language="cpp" source="~/snippets/cpp/VS_Snippets_Remoting/NclPingAsync/CPP/asyncping.cpp" id="Snippet1"::: :::code language="csharp" source="~/snippets/csharp/System.Net.NetworkInformation/Ping/Overview/asyncping.cs" id="Snippet1"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is or is an empty string (""). @@ -1825,7 +1841,9 @@ The IP address returned by any of the > object will complete after the ICMP packet has been sent and the response has been received. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1880,7 +1898,9 @@ The IP address returned by any of the > object will complete after the ICMP packet has been sent and the response has been received. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is or is an empty string (""). @@ -1937,7 +1957,9 @@ The IP address returned by any of the > object will complete after the ICMP packet has been sent and the response has been received. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1994,7 +2016,9 @@ The IP address returned by any of the > object will complete after the ICMP packet has been sent and the response has been received. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -2055,7 +2079,9 @@ The IP address returned by any of the > object will complete after the ICMP packet has been sent and the response has been received. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> or is . @@ -2118,7 +2144,9 @@ The IP address returned by any of the > object will complete after the ICMP packet has been sent and the response has been received. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is or is an empty string (""). @@ -2188,7 +2216,9 @@ The IP address returned by any of the > object will complete after the ICMP packet has been sent and the response has been received. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> or is . @@ -2254,7 +2284,9 @@ The IP address returned by any of the > object will complete after the ICMP packet has been sent and the response has been received. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is or is an empty string (""). diff --git a/xml/System.Net.PeerToPeer.Collaboration/ContactManager.xml b/xml/System.Net.PeerToPeer.Collaboration/ContactManager.xml index 158104fbc5e..b20039acaad 100644 --- a/xml/System.Net.PeerToPeer.Collaboration/ContactManager.xml +++ b/xml/System.Net.PeerToPeer.Collaboration/ContactManager.xml @@ -220,7 +220,9 @@ ## Remarks Calling this method requires a of . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> already exists and is in use. diff --git a/xml/System.Net.PeerToPeer.Collaboration/Peer.xml b/xml/System.Net.PeerToPeer.Collaboration/Peer.xml index ed51c9bbbdb..93dd5c37952 100644 --- a/xml/System.Net.PeerToPeer.Collaboration/Peer.xml +++ b/xml/System.Net.PeerToPeer.Collaboration/Peer.xml @@ -506,7 +506,9 @@ ## Remarks Calling this method requires a of . This state is created when the peer collaboration session begins. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -552,7 +554,9 @@ ## Remarks Calling this method requires a of . This state is created when the peer collaboration session begins. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The application is not registered with the collaboration infrastructure. diff --git a/xml/System.Net.PeerToPeer.Collaboration/PeerContact.xml b/xml/System.Net.PeerToPeer.Collaboration/PeerContact.xml index 07ae5f46064..8c0129805fc 100644 --- a/xml/System.Net.PeerToPeer.Collaboration/PeerContact.xml +++ b/xml/System.Net.PeerToPeer.Collaboration/PeerContact.xml @@ -1141,7 +1141,9 @@ ## Remarks The caller is not required to sign-in to the infrastructure for this method to complete successfully. A from the invitee is not the same as the invitee accepting the invitation to collaborate. If an invitation is sent to a remote peer that has not installed the application, the invitation is automatically declined. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> cannot be . @@ -1195,7 +1197,9 @@ ## Remarks The caller is not required to sign-in to the infrastructure for this method to complete successfully. A from the invitee is not the same as the invitee accepting the invitation to collaborate. If an invitation is sent to a remote peer that has not installed the application, the invitation is automatically declined. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> - cannot be . @@ -1255,7 +1259,9 @@ ## Remarks The caller is not required to sign-in to the infrastructure for this method to complete successfully. A from the invitee is not the same as the invitee accepting the invitation to collaborate. If an invitation is sent to a remote peer that has not installed the application, the invitation is automatically declined. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> cannot be . @@ -1317,7 +1323,9 @@ ## Remarks The caller is not required to sign-in to the infrastructure for this method to complete successfully. A from the invitee is not the same as the invitee accepting the invitation to collaborate. If an invitation is sent to a remote peer that has not installed the application, the invitation is automatically declined. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> - cannot be null. @@ -1808,7 +1816,9 @@ Calling this method requires a of . This state is created when the peer collaboration session begins. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> cannot be . diff --git a/xml/System.Net.PeerToPeer.Collaboration/PeerNearMe.xml b/xml/System.Net.PeerToPeer.Collaboration/PeerNearMe.xml index 3e5045ce203..a6a64ffdca0 100644 --- a/xml/System.Net.PeerToPeer.Collaboration/PeerNearMe.xml +++ b/xml/System.Net.PeerToPeer.Collaboration/PeerNearMe.xml @@ -552,7 +552,7 @@ User-defined object passed to the callback of the asynchronous operation for identification. This required parameter must be unique across all asynchronous invitation operations still in-progress. Receives an invitation response from a peer regarding joining a peer collaboration application. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The object has been disposed. The argument specifies . This object does not specify a valid . @@ -592,7 +592,7 @@ A user defined data blob to associate with the invitation. Size is limited to 16K. User-defined object passed to the callback of the asynchronous operation for identification. This required parameter must be unique across all asynchronous invitation operations still in-progress. Receives an invitation response from a peer regarding an invitation to a peer collaboration application. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The object has been disposed. The argument specifies . The argument specifies . @@ -778,7 +778,9 @@ The caller is not required to sign in with the method or via a user interface in to complete this operation successfully. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The object has been disposed. The argument specifies . diff --git a/xml/System.Net.PeerToPeer/PeerNameResolver.xml b/xml/System.Net.PeerToPeer/PeerNameResolver.xml index 88c6bc561e0..8e47e39d444 100644 --- a/xml/System.Net.PeerToPeer/PeerNameResolver.xml +++ b/xml/System.Net.PeerToPeer/PeerNameResolver.xml @@ -402,7 +402,9 @@ The event will be raised if the resolve operation completes in error or is canceled. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> One or both of the and parameters are set to . @@ -447,7 +449,9 @@ The event will be raised if the resolve operation completes in error or is canceled. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> One or both of the and parameters are set to . The parameter is less than or equal to zero. @@ -501,7 +505,9 @@ The event will be raised if the resolve operation completes in error or is canceled. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> One or both of the and parameters are set to . @@ -556,7 +562,9 @@ The event will be raised if the resolve operation completes in error or is canceled. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> One or both of the and parameters are set to . One or more supplied parameters are invalid. diff --git a/xml/System.Net.Security/AuthenticatedStream.xml b/xml/System.Net.Security/AuthenticatedStream.xml index 6e2049a0976..a60d4757945 100644 --- a/xml/System.Net.Security/AuthenticatedStream.xml +++ b/xml/System.Net.Security/AuthenticatedStream.xml @@ -212,7 +212,9 @@ The following example demonstrates displaying the properties of an authenticated Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Net.Security/NegotiateStream.xml b/xml/System.Net.Security/NegotiateStream.xml index 2b1d61f044d..2af3c187052 100644 --- a/xml/System.Net.Security/NegotiateStream.xml +++ b/xml/System.Net.Security/NegotiateStream.xml @@ -669,7 +669,9 @@ The following example demonstrates calling this constructor. This code example i If the authentication fails, you receive an or an . In this case, you can retry the authentication with a different credential. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The authentication failed. You can use this object to retry the authentication. The authentication failed. You can use this object to retry the authentication. @@ -729,7 +731,9 @@ The following example demonstrates calling this constructor. This code example i When authentication succeeds, you must check the and properties to determine what security services are used by the . Check the property to determine whether mutual authentication occurred. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The authentication failed. You can use this object to retry the authentication. The authentication failed. You can use this object to retry the authentication. @@ -796,7 +800,9 @@ The following example demonstrates calling this constructor. This code example i When authentication succeeds, you must check the and properties to determine what security services are used by the . Check the property to determine whether mutual authentication occurred. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -868,7 +874,9 @@ The following example demonstrates calling this constructor. This code example i If the authentication fails, you receive an or an . In this case, you can retry the authentication with a different credential. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is not a valid value. @@ -941,7 +949,9 @@ The following example demonstrates calling this constructor. This code example i If the authentication fails, you receive an or an . In this case, you can retry the authentication with a different credential. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1327,7 +1337,9 @@ The following example demonstrates calling this constructor. This code example i If the authentication fails, you receive an or an . In this case, you can retry the authentication with a different credential. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The authentication failed. You can use this object to retry the authentication. The authentication failed. You can use this object to retry the authentication. @@ -1386,7 +1398,9 @@ The following example demonstrates calling this constructor. This code example i If the authentication fails, you receive an or an . In this case, you can retry the authentication with a different credential. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The and on the extended protection policy passed in the parameter are both . The authentication failed. You can use this object to retry the authentication. @@ -1448,7 +1462,9 @@ The following example demonstrates calling this constructor. This code example i If the authentication fails, you receive an or an . In this case, you can retry the authentication with a different credential. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1520,7 +1536,9 @@ The following example demonstrates calling this constructor. This code example i If the authentication fails, you receive an or an . In this case, you can retry the authentication with a different credential. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The and on the extended protection policy passed in the parameter are both . @@ -2849,7 +2867,9 @@ The following method is called when the operation completes. Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -3229,7 +3249,9 @@ Authentication has not occurred. ## Remarks This method invokes on the underlying stream. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -3812,7 +3834,9 @@ This method reads asynchronously as much data as is available into `buffer` and You cannot call this method until you have successfully authenticated. To authenticate, call one of the , , , , , or methods. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The read operation failed. Authentication has not occurred. @@ -3859,7 +3883,9 @@ This method reads asynchronously as much data as is available into `buffer` and You cannot call this method until you have successfully authenticated. To authenticate, call one of the , , , , , or methods. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The read operation failed. Authentication has not occurred. @@ -4214,7 +4240,9 @@ This method reads asynchronously as much data as is available into `buffer` and You cannot call this method until you have successfully authenticated. To authenticate, call one of the , , , , , or methods. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> This object has been closed. Authentication has not occurred. @@ -4261,7 +4289,9 @@ This method reads asynchronously as much data as is available into `buffer` and You cannot call this method until you have successfully authenticated. To authenticate, call one of the , , , , , or methods. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Net.Security/SslStream.xml b/xml/System.Net.Security/SslStream.xml index 52905620c6d..715612ff6fc 100644 --- a/xml/System.Net.Security/SslStream.xml +++ b/xml/System.Net.Security/SslStream.xml @@ -828,7 +828,9 @@ If the authentication fails, you receive a , and this is no longer useable. You should close this object and remove all references to it so that it can be collected by the garbage collector. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -888,7 +890,9 @@ If the authentication fails, you receive a , and this is no longer useable. You should close this object and remove all references to it so that it can be collected by the garbage collector. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -958,7 +962,9 @@ > [!NOTE] > Client certificates are not supported in the SSL version 2 protocol. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The authentication failed and left this object in an unusable state. Authentication has already occurred. @@ -1031,7 +1037,9 @@ > [!NOTE] > Client certificates are not supported in the SSL version 2 protocol. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The authentication failed and left this object in an unusable state. Authentication has already occurred. @@ -1378,7 +1386,9 @@ If the authentication fails, you receive a , and this is no longer useable. You should close this object and remove all references to it so that it can be collected by the garbage collector. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1437,7 +1447,9 @@ If the authentication fails, you receive a , and this is no longer useable. You should close this object and remove all references to it so that it can be collected by the garbage collector. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Either or or is and is not set in the constructor. @@ -1493,7 +1505,9 @@ If the authentication fails, you receive a , and this is no longer useable. You should close this object and remove all references to it so that it can be collected by the garbage collector. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Either or or is and is not set in the constructor. @@ -1557,7 +1571,9 @@ If the authentication fails, you receive a , and this is no longer useable. You should close this object and remove all references to it so that it can be collected by the garbage collector. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1626,7 +1642,9 @@ If the authentication fails, you receive a , and this is no longer useable. You should close this object and remove all references to it so that it can be collected by the garbage collector. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -2840,7 +2858,9 @@ Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -3224,7 +3244,9 @@ Authentication has not occurred. ## Remarks This method invokes on the underlying stream. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -3858,7 +3880,7 @@ Authentication has not occurred. The token to monitor for cancellation requests. Negotiates the client certificate on the authenticated connection. The task object representing the asynchronous operation. - You can negotiate the client certificate once authentication is successfully processed via one of the AuthenticateAs... methods. + You can negotiate the client certificate once authentication is successfully processed via one of the AuthenticateAs... methods.This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -4106,7 +4128,9 @@ This property gets the cipher suite that is going to be used in the communicatio You cannot call this method until you have successfully authenticated. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Authentication has not occurred. The read operation failed. Check the inner exception, if it is present, to determine the cause of the failure. @@ -4160,7 +4184,9 @@ This property gets the cipher suite that is going to be used in the communicatio You cannot call this method until you have successfully authenticated. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -4463,7 +4489,7 @@ If the property is accessed, the remote certificate will not be disposed when th Shuts down this SslStream. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -4777,7 +4803,9 @@ You cannot call this method until you have successfully authenticated. The class does not support multiple simultaneous write operations. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Authentication has not occurred. The write operation failed. @@ -4829,7 +4857,9 @@ You cannot call this method until you have successfully authenticated. The class does not support multiple simultaneous write operations. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . diff --git a/xml/System.Net.Sockets/NetworkStream.xml b/xml/System.Net.Sockets/NetworkStream.xml index 0e7bc10eaba..aed147b900f 100644 --- a/xml/System.Net.Sockets/NetworkStream.xml +++ b/xml/System.Net.Sockets/NetworkStream.xml @@ -1272,7 +1272,9 @@ The Close method frees both unmanaged and managed resources associated with the ## Remarks This operation will not block. The returned object will complete after data has been flushed from the stream for the instance. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1623,7 +1625,9 @@ This method reads as much data as is available into `buffer` and returns the num > [!NOTE] > If you receive an , check the property to determine if it was caused by a . If so, use the property to obtain the specific error code and 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. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The does not support reading. An error occurred when accessing the socket. @@ -1691,7 +1695,9 @@ There is a failure reading from the network. > [!NOTE] > If you receive an , check the property to determine if it was caused by a . If so, use the property to obtain the specific error code and 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. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The does not support reading. An error occurred when accessing the socket. @@ -2262,6 +2268,8 @@ This method sends all bytes in `buffer` to the network. > [!NOTE] > If you receive an , check the property to determine if it was caused by a . If so, use the property to obtain the specific error code and refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error. +This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + ]]> The does not support writing. @@ -2329,6 +2337,8 @@ This method starts at the specified `offset` and sends `size` bytes from the con > [!NOTE] > If you receive an , check the property to determine if it was caused by a . If so, use the property to obtain the specific error code and refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error. +This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + ]]> The parameter is . diff --git a/xml/System.Net.Sockets/Socket.xml b/xml/System.Net.Sockets/Socket.xml index c0fa6894427..9336780f1af 100644 --- a/xml/System.Net.Sockets/Socket.xml +++ b/xml/System.Net.Sockets/Socket.xml @@ -453,7 +453,7 @@ This method populates the instance with data ga Accepts an incoming connection. An asynchronous task that completes with the accepted Socket. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . An invalid operation was requested. This exception occurs if the accepting is not listening for connections or the accepted socket is bound. You must call the and method before calling the method. @@ -495,7 +495,7 @@ This method populates the instance with data ga The socket to use for accepting the connection. Accepts an incoming connection. An asynchronous task that completes with the accepted Socket. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . An invalid operation was requested. This exception occurs if the accepting is not listening for connections or the accepted socket is bound. You must call the and method before calling the method. @@ -575,7 +575,9 @@ This method populates the instance with data ga The event can occur in some cases when no connection has been accepted and cause the property to be set to . This can occur as a result of port scanning using a half-open SYN type scan (a SYN -> SYN-ACK -> RST sequence). Applications using the method should be prepared to handle this condition. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An argument is not valid. This exception occurs if the buffer provided is not large enough. The buffer must be at least 2 * (sizeof(SOCKADDR_STORAGE + 16) bytes. @@ -628,7 +630,7 @@ This method populates the instance with data ga A cancellation token that can be used to cancel the asynchronous operation. Accepts an incoming connection. An asynchronous task that completes with the accepted Socket. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . An invalid operation was requested. This exception occurs if the accepting is not listening for connections or the accepted socket is bound. You must call the and method before calling the method. @@ -672,7 +674,7 @@ This method populates the instance with data ga A cancellation token that can be used to cancel the asynchronous operation. Accepts an incoming connection. An asynchronous task that completes with the accepted Socket. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . An invalid operation was requested. This exception occurs if the accepting is not listening for connections or the accepted socket is bound. You must call the and method before calling the method. @@ -3356,7 +3358,9 @@ This method populates the instance with data ga ## Remarks The method cancels an asynchronous request for a remote host connection. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter cannot be null and the cannot be null. An error occurred when attempting to access the socket. @@ -3897,7 +3901,7 @@ This method populates the instance with data ga The endpoint to connect to. Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. The is listening. An error occurred when attempting to access the socket. @@ -3985,7 +3989,9 @@ This method populates the instance with data ga > [!NOTE] > If you receive a when calling this method, use the property to obtain the specific error code. After you have obtained this code, 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. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An argument is not valid. This exception occurs if multiple buffers are specified, the property is not null. The parameter cannot be null and the cannot be null. @@ -4036,7 +4042,7 @@ This method populates the instance with data ga A cancellation token that can be used to cancel the asynchronous operation. Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. The is listening. An error occurred when attempting to access the socket. @@ -4079,7 +4085,7 @@ This method populates the instance with data ga The port on the remote host to connect to. Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. is less than . @@ -4128,7 +4134,7 @@ This method populates the instance with data ga The port on the remote host to connect to. Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. The parameter cannot be empty array. @@ -4178,7 +4184,7 @@ This method populates the instance with data ga The port on the remote host to connect to. Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. is less than . @@ -4229,7 +4235,7 @@ This method populates the instance with data ga A cancellation token that can be used to cancel the asynchronous operation. Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. is less than . @@ -4279,7 +4285,7 @@ This method populates the instance with data ga A cancellation token that can be used to cancel the asynchronous operation. Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. The parameter cannot be empty array. @@ -4377,7 +4383,9 @@ This method populates the instance with data ga > [!NOTE] > If you receive a when calling this method, use the property to obtain the specific error code. After you have obtained this code, 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. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An argument is not valid. This exception occurs if multiple buffers are specified, the property is not null. The parameter cannot be null and the cannot be null. @@ -4424,7 +4432,7 @@ This method populates the instance with data ga A cancellation token that can be used to cancel the asynchronous operation. Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. is less than . @@ -4624,7 +4632,9 @@ This method populates the instance with data ga ## Remarks When using a connection-oriented protocol, calling the method requests a disconnect from a remote endpoint. If you set to `true` in the `e` parameter, the socket can be reused. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter cannot be null. A socket operation was already in progress using the object specified in the parameter. @@ -4668,7 +4678,7 @@ This method populates the instance with data ga A cancellation token that can be used to cancel the asynchronous operation. Disconnects a connected socket from the remote host. An asynchronous task that completes when the socket is disconnected. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The object has been closed. An error occurred when attempting to access the socket. @@ -8696,7 +8706,7 @@ If you're using a connectionless , The buffer for the received data. Receives data from a connected socket. An asynchronous task that completes with the number of bytes received. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The has been closed. An error occurred when attempting to access the socket. @@ -8732,7 +8742,7 @@ If you're using a connectionless , A list of buffers for the received data. Receives data from a connected socket. An asynchronous task that completes with the number of bytes received. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter was null. The has been closed. An error occurred when attempting to access the socket. @@ -8812,7 +8822,9 @@ If you're using a connectionless , method can indicate the graceful termination of the virtual circuit in one of two ways that depend on whether the socket is byte stream or message oriented. For byte streams, zero bytes having been read indicates graceful closure and that no more bytes will ever be read. For message-oriented sockets, where a zero byte message is often allowable, a with the set to the native Winsock WSAEDISCON error code (10101) is used to indicate graceful closure. In any case, a with the set to the native Winsock WSAECONNRESET error code (10054) indicates an abortive close has occurred. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An argument was invalid. The or properties on the parameter must reference valid buffers. One or the other of these properties may be set, but not both at the same time. A socket operation was already in progress using the object specified in the parameter. @@ -8861,7 +8873,7 @@ If you're using a connectionless , A bitwise combination of SocketFlags values that will be used when receiving the data. Receives data from a connected socket. An asynchronous task that completes with the number of bytes received. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The has been closed. An error occurred when attempting to access the socket. @@ -8900,7 +8912,7 @@ If you're using a connectionless , A bitwise combination of SocketFlags values that will be used when receiving the data. Receives data from a connected socket. An asynchronous task that completes with the number of bytes received. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter was null. The has been closed. An error occurred when attempting to access the socket. @@ -8938,7 +8950,7 @@ If you're using a connectionless , A cancellation token that can be used to cancel the asynchronous operation. Receives data from a connected socket. An asynchronous task that completes with the number of bytes received. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The has been closed. An error occurred when attempting to access the socket. @@ -8978,7 +8990,7 @@ If you're using a connectionless , A cancellation token that can be used to cancel the asynchronous operation. Receives data from a connected socket. An asynchronous task that completes with the number of bytes received. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The has been closed. An error occurred when attempting to access the socket. @@ -9661,7 +9673,9 @@ If you're using a connectionless , and properties determine where in the buffer the data is placed and the amount of data. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The cannot be null. A socket operation was already in progress using the object specified in the parameter. @@ -9709,7 +9723,7 @@ If you're using a connectionless , An endpoint of the same type as the endpoint of the remote host. Receives data and returns the endpoint of the sending host. An asynchronous task that completes with a containing the number of bytes received and the endpoint of the sending host. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . An error occurred when attempting to access the socket. @@ -9753,7 +9767,7 @@ If you're using a connectionless , An endpoint of the same type as the endpoint of the remote host. Receives data and returns the endpoint of the sending host. An asynchronous task that completes with a containing the number of bytes received and the endpoint of the sending host. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . An error occurred when attempting to access the socket. @@ -9795,7 +9809,7 @@ If you're using a connectionless , A cancellation token that can be used to signal the asynchronous operation should be canceled. Receives data and returns the endpoint of the sending host. An asynchronous task that completes with a containing the number of bytes received and the endpoint of the sending host. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . An error occurred when attempting to access the socket. @@ -9840,7 +9854,7 @@ If you're using a connectionless , A cancellation token that can be used to signal the asynchronous operation should be canceled. Receives data and returns the endpoint of the sending host. An asynchronous task that completes with a containing the number of bytes received and the endpoint of the sending host. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . An error occurred when attempting to access the socket. @@ -10099,7 +10113,9 @@ You must call the Bind method before performing this operation. An application can examine the resulting objects if it needs to know if the datagram was sent using a unicast, multicast, or broadcast address. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The cannot be null. The has been closed. @@ -10146,7 +10162,7 @@ You must call the Bind method before performing this operation. An endpoint of the same type as the endpoint of the remote host. Receives data and returns additional information about the sender of the message. An asynchronous task that completes with a containing the number of bytes received and additional information about the sending host. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The object has been closed. is . @@ -10189,7 +10205,7 @@ You must call the Bind method before performing this operation. An endpoint of the same type as the endpoint of the remote host. Receives data and returns additional information about the sender of the message. An asynchronous task that completes with a containing the number of bytes received and additional information about the sending host. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The object has been closed. is . @@ -10230,7 +10246,7 @@ You must call the Bind method before performing this operation. A cancellation token that can be used to signal the asynchronous operation should be canceled. Receives data and returns additional information about the sender of the message. An asynchronous task that completes with a containing the number of bytes received and additional information about the sending host. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The object has been closed. is . @@ -10274,7 +10290,7 @@ You must call the Bind method before performing this operation. A cancellation token that can be used to signal the asynchronous operation should be canceled. Receives data and returns additional information about the sender of the message. An asynchronous task that completes with a containing the number of bytes received and additional information about the sending host. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The object has been closed. is . @@ -11580,7 +11596,7 @@ This member outputs trace information when you enable network tracing in your ap The buffer for the data to send. Sends data on a connected socket. An asynchronous task that completes with the number of bytes sent. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . An error occurred when attempting to access the socket. The has been closed. @@ -11616,7 +11632,7 @@ This member outputs trace information when you enable network tracing in your ap A list of buffers for the data to send. Sends data on a connected socket. An asynchronous task that completes with the number of bytes sent. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . An error occurred when attempting to access the socket. @@ -11697,7 +11713,9 @@ This member outputs trace information when you enable network tracing in your ap Note that the successful completion of the method does not indicate that the data was successfully delivered. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The or properties on the parameter must reference valid buffers. One or the other of these properties may be set, but not both at the same time. A socket operation was already in progress using the object specified in the parameter. @@ -11746,7 +11764,7 @@ This member outputs trace information when you enable network tracing in your ap A bitwise combination of SocketFlags values that will be used when sending the data. Sends data on a connected socket. An asynchronous task that completes with the number of bytes sent. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . An error occurred when attempting to access the socket. The has been closed. @@ -11785,7 +11803,7 @@ This member outputs trace information when you enable network tracing in your ap A bitwise combination of SocketFlags values that will be used when sending the data. Sends data on a connected socket. An asynchronous task that completes with the number of bytes sent. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . An error occurred when attempting to access the socket. @@ -11824,7 +11842,7 @@ This member outputs trace information when you enable network tracing in your ap A cancellation token that can be used to cancel the asynchronous operation. Sends data on a connected socket. An asynchronous task that completes with the number of bytes sent. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -11862,7 +11880,7 @@ This member outputs trace information when you enable network tracing in your ap A cancellation token that can be used to cancel the asynchronous operation. Sends data on a connected socket. An asynchronous task that completes with the number of bytes sent. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . An error occurred when attempting to access the socket. The has been closed. @@ -12181,7 +12199,7 @@ This member outputs trace information when you enable network tracing in your ap A cancellation token that can be used to cancel the asynchronous operation. Sends the file to a connected object. A value task that represents the asynchronous send file operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The object has been closed. The object is not connected to a remote host. The file was not found. @@ -12227,7 +12245,7 @@ This member outputs trace information when you enable network tracing in your ap A cancellation token that can be used to cancel the asynchronous operation. Sends the file and buffers of data to a connected object using the specified value. A value task that represents the asynchronous send file operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The object has been closed. The object is not connected to a remote host. The file was not found. @@ -12315,7 +12333,9 @@ This member outputs trace information when you enable network tracing in your ap Use of the flag in the property on the `e` parameter can deliver significant performance benefits. If the thread initiating the method call is being used for heavy computations, it is possible, though unlikely, that APCs could be prevented from launching. Note that there is a difference between kernel and user-mode APCs. Kernel APCs launch when a thread is in a wait state. User-mode APCs launch when a thread is in an alertable wait state - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The file specified in the property was not found. A socket operation was already in progress using the object specified in the parameter. @@ -12957,7 +12977,9 @@ This member outputs trace information when you enable network tracing in your ap For message-oriented sockets, care must be taken not to exceed the maximum message size of the underlying transport. If the size of the buffer exceeds the maximum packet size of the underlying service provider, the datagram is not sent and will throw a . The successful completion of a method does not indicate that the data was successfully delivered. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The cannot be null. A socket operation was already in progress using the object specified in the parameter. @@ -13005,7 +13027,7 @@ This member outputs trace information when you enable network tracing in your ap The remote host to which to send the data. Sends data to the specified remote host. An asynchronous task that completes with the number of bytes sent. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . An error occurred when attempting to access the socket. @@ -13048,7 +13070,7 @@ This member outputs trace information when you enable network tracing in your ap The remote host to which to send the data. Sends data to the specified remote host. An asynchronous task that completes with the number of bytes sent. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . An error occurred when attempting to access the socket. @@ -13089,7 +13111,7 @@ This member outputs trace information when you enable network tracing in your ap A cancellation token that can be used to cancel the asynchronous operation. Sends data to the specified remote host. An asynchronous task that completes with the number of bytes sent. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . An error occurred when attempting to access the socket. @@ -13133,7 +13155,7 @@ This member outputs trace information when you enable network tracing in your ap A cancellation token that can be used to cancel the asynchronous operation. Sends data to the specified remote host. An asynchronous task that completes with the number of bytes sent. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . An error occurred when attempting to access the socket. diff --git a/xml/System.Net.Sockets/SocketTaskExtensions.xml b/xml/System.Net.Sockets/SocketTaskExtensions.xml index 9c82ca78b5c..5288a172c15 100644 --- a/xml/System.Net.Sockets/SocketTaskExtensions.xml +++ b/xml/System.Net.Sockets/SocketTaskExtensions.xml @@ -89,7 +89,7 @@ The socket that is listening for connections. Performs an asynchronous operation on to accept an incoming connection attempt on the socket. An asynchronous task that completes with a to handle communication with the remote host. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . An invalid operation was requested. This exception occurs if the accepting is not listening for connections or the accepted socket is bound. You must call the and method before calling the method. @@ -144,7 +144,7 @@ The accepted object. This value may be . Performs an asynchronous operation on to accept an incoming connection attempt on the socket. An asynchronous task that completes with a to handle communication with the remote host. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . An invalid operation was requested. This exception occurs if the accepting is not listening for connections or the accepted socket is bound. You must call the and method before calling the method. @@ -198,7 +198,7 @@ An EndPoint that represents the remote device. Establishes a connection to a remote host. An asynchronous Task. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. The is listening. An error occurred when attempting to access the socket. @@ -244,7 +244,7 @@ A cancellation token that can be used to signal the asynchronous operation should be canceled. Establishes a connection to a remote host. A task that represents the asynchronous connection operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. The is listening. An error occurred when attempting to access the socket. @@ -301,7 +301,7 @@ The port number of the remote host. Establishes a connection to a remote host. The host is specified by an IP address and a port number. A task that represents an asynchronous connection operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. is less than . @@ -363,7 +363,7 @@ The port number of the remote host. Establishes a connection to a remote host. The host is specified by an array of IP addresses and a port number. A task that represents the asynchronous connect operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. The parameter cannot be empty array. @@ -426,7 +426,7 @@ The port number of the remote host. Establishes a connection to a remote host. The host is specified by a host name and a port number. An asynchronous task. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. is less than . @@ -479,7 +479,7 @@ A cancellation token that can be used to signal the asynchronous operation should be canceled. Establishes a connection to a remote host, which is specified by an IP address and a port number. A task that represents the asynchronous connection operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. is less than . @@ -532,7 +532,7 @@ A cancellation token that can be used to signal the asynchronous operation should be canceled. Establishes a connection to a remote host, which is specified by an array of IP addresses and a port number. A task that represents the asynchronous connection operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. The parameter cannot be empty array. @@ -586,7 +586,7 @@ A cancellation token that can be used to signal the asynchronous operation should be canceled. Establishes a connection to a remote host, which is specified by a host name and a port number. A task that represents an asynchronous connection operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter cannot be null. is less than . @@ -648,7 +648,7 @@ A bitwise combination of the values. Receives data from a connected socket. A task that represents the asynchronous receive operation. The value of the parameter contains the number of bytes received. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The has been closed. An error occurred when attempting to access the socket. @@ -701,7 +701,7 @@ A bitwise combination of the values. Receives data from a connected socket. A task that represents the asynchronous receive operation. The value of the parameter contains the number of bytes received. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The parameter was null. The has been closed. An error occurred when attempting to access the socket. @@ -748,7 +748,7 @@ A cancellation token that can be used to signal the asynchronous operation should be canceled. Receives data from a connected socket. A task that completes with the number of bytes received, or 0 if the end of the stream has been reached. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The has been closed. An error occurred when attempting to access the socket. @@ -803,7 +803,7 @@ An EndPoint that represents the source of the data. Receives data from a specified network device. An asynchronous Task that completes with a SocketReceiveFromResult struct. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . @@ -865,7 +865,7 @@ An , that represents the remote server. Receives the specified number of bytes of data into the specified location of the data buffer, using the specified , and stores the endpoint and packet information. An asynchronous Task that completes with a struct. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The object has been closed. The is . You must call the Bind method before performing this operation. @@ -919,7 +919,7 @@ A bitwise combination of the values. Sends data to a connected socket. An asynchronous task that completes with number of bytes sent to the socket if the operation was successful. Otherwise, the task will complete with an invalid socket error. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . An error occurred when attempting to access the socket. The has been closed. @@ -972,7 +972,7 @@ A bitwise combination of the values. Sends data to a connected socket. An asynchronous task that completes with number of bytes sent to the socket if the operation was successful. Otherwise, the task will complete with an invalid socket error. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . An error occurred when attempting to access the socket. @@ -1020,7 +1020,7 @@ A cancellation token that can be used to signal the asynchronous operation should be canceled. Sends data to a connected socket. A task that completes with number of bytes sent to the socket if the operation was successful. Otherwise, the task will complete with an invalid socket error. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . An error occurred when attempting to access the socket. The has been closed. @@ -1075,7 +1075,7 @@ An that represents the remote device. Sends data asynchronously to a specific remote host. An asynchronous task that completes with number of bytes sent if the operation was successful. Otherwise, the task will complete with an invalid socket error. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . An error occurred when attempting to access the socket. diff --git a/xml/System.Net.Sockets/TcpClient.xml b/xml/System.Net.Sockets/TcpClient.xml index deed3657a47..f674521d954 100644 --- a/xml/System.Net.Sockets/TcpClient.xml +++ b/xml/System.Net.Sockets/TcpClient.xml @@ -1169,7 +1169,9 @@ The `Available` property is a way to determine whether data is queued for readin > [!NOTE] > If you receive a `NotSupportedException` with the message "This protocol version is not supported" while using IPv6 address, make sure you enabled IPv6 in the constructor by passing . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1230,7 +1232,9 @@ The `Available` property is a way to determine whether data is queued for readin > [!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 . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The is not between and . @@ -1297,7 +1301,9 @@ The `Available` property is a way to determine whether data is queued for readin > [!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 . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The port number is not valid. @@ -1353,7 +1359,9 @@ The `Available` property is a way to determine whether data is queued for readin > [!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 . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1413,7 +1421,9 @@ The `Available` property is a way to determine whether data is queued for readin > [!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 method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The parameter is not between and . @@ -1472,7 +1482,9 @@ The `Available` property is a way to determine whether data is queued for readin > [!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 . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The is not between and . @@ -1530,7 +1542,9 @@ The `Available` property is a way to determine whether data is queued for readin > [!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 . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The port number is not valid. @@ -1588,7 +1602,9 @@ The `Available` property is a way to determine whether data is queued for readin > [!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 method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The parameter is not between and . diff --git a/xml/System.Net.Sockets/TcpListener.xml b/xml/System.Net.Sockets/TcpListener.xml index 709ebded0b8..adc6784fc7d 100644 --- a/xml/System.Net.Sockets/TcpListener.xml +++ b/xml/System.Net.Sockets/TcpListener.xml @@ -404,7 +404,9 @@ > [!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 method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The listener has not been started with a call to . @@ -449,7 +451,9 @@ > [!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 method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -565,7 +569,9 @@ > [!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 method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The listener has not been started with a call to . Use the property to obtain the specific error code. When you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error. @@ -612,7 +618,9 @@ > [!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 method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Net.Sockets/UdpClient.xml b/xml/System.Net.Sockets/UdpClient.xml index 89469b33df8..b738a820777 100644 --- a/xml/System.Net.Sockets/UdpClient.xml +++ b/xml/System.Net.Sockets/UdpClient.xml @@ -2370,7 +2370,9 @@ > [!WARNING] > If you intend to receive multicasted datagrams, do not call the method prior to calling this method. The you use to receive datagrams must be created using the multicast port number. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The underlying has been closed. An error occurred when accessing the socket. @@ -2402,7 +2404,7 @@ The token to monitor for cancellation requests. Returns a UDP datagram asynchronously that was sent by a remote host. A representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The underlying has been closed. An error occurred when accessing the socket. @@ -2803,7 +2805,9 @@ If you want to send datagrams to a different remote host, you must call the method and specify the desired remote host. Use either of the other method overloads to send datagrams to a broadcast address. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -2839,7 +2843,7 @@ The token to monitor for cancellation requests. The default value is None. Sends a UDP datagram asynchronously to a remote host. A that represents the asynchronous send operation. The value of its Result property contains the number of bytes sent. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The is closed. An error occurred when accessing the socket. @@ -2898,7 +2902,9 @@ > [!WARNING] > Do not provide an `endPoint` parameter to this method if you have already established a remote host with the method. If you do, this method will throw a . If you receive a , use to obtain the specific error code. Once 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. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -2938,7 +2944,7 @@ The token to monitor for cancellation requests. The default value is None. Sends a UDP datagram asynchronously to a remote host. A that represents the asynchronous send operation. The value of its Result property contains the number of bytes sent. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . has already established a default remote host and is not . The is closed. @@ -3001,7 +3007,9 @@ > [!WARNING] > Do not provide a host name or port number to this method if you have already established a remote host with the method. If you do, this method will throw a . If you receive a , use to obtain the specific error code. Once 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. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -3041,7 +3049,7 @@ The token to monitor for cancellation requests. The default value is None. Sends a UDP datagram asynchronously to a remote host. A that represents the asynchronous send operation. The value of its Result property contains the number of bytes sent. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The has already established a default remote host. The is closed. An error occurred when accessing the socket. diff --git a/xml/System.Net.WebSockets/ClientWebSocket.xml b/xml/System.Net.WebSockets/ClientWebSocket.xml index ab872dd6f69..61026984c77 100644 --- a/xml/System.Net.WebSockets/ClientWebSocket.xml +++ b/xml/System.Net.WebSockets/ClientWebSocket.xml @@ -189,7 +189,9 @@ Exactly one send and one receive is supported on each object will complete after the instance is closed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -248,7 +250,9 @@ Exactly one send and one receive is supported on each object will complete after the output on the instance is closed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -397,7 +401,9 @@ Exactly one send and one receive is supported on each option and option. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -430,7 +436,7 @@ Exactly one send and one receive is supported on each A cancellation token used to propagate notification that the operation should be canceled. Connects to a WebSocket server as an asynchronous operation. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -606,7 +612,9 @@ Exactly one send and one receive is supported on each object in parallel. Issuing multiple receives at the same time is *not supported* and will result in an *undefined behavior*. You should serialize receive operations via whatever mechanism works best for you, for example, by using a lock or a semaphore. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The is not connected. The has been closed. @@ -652,7 +660,9 @@ Exactly one send and one receive is supported on each object in parallel. Issuing multiple receives at the same time is *not supported* and will result in an *undefined behavior*. You should serialize receive operations via whatever mechanism works best for you, for example, by using a lock or a semaphore. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The is not connected. The has been closed. @@ -712,7 +722,9 @@ Exactly one send and one receive is supported on each object in parallel. Issuing multiple sends at the same time is *not supported* and will result in an *undefined behavior*. You should serialize send operations via whatever mechanism works best for you, for example, by using a lock or a semaphore. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The is not connected. The has been closed. @@ -764,7 +776,9 @@ This operation will not block. The returned o Exactly one send and one receive is supported on each object in parallel. Issuing multiple sends at the same time is *not supported* and will result in an *undefined behavior*. You should serialize send operations via whatever mechanism works best for you, for example, by using a lock or a semaphore. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The is not connected. The has been closed. diff --git a/xml/System.Net.WebSockets/WebSocket.xml b/xml/System.Net.WebSockets/WebSocket.xml index 20061295fd8..9af27a54671 100644 --- a/xml/System.Net.WebSockets/WebSocket.xml +++ b/xml/System.Net.WebSockets/WebSocket.xml @@ -173,7 +173,9 @@ Exactly one send and one receive is supported on each + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -226,7 +228,9 @@ Exactly one send and one receive is supported on each object will complete after the output on the WebSocket has been closed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -771,7 +775,9 @@ Exactly one send and one receive is supported on each object in parallel. Issuing multiple receives at the same time is *not supported* and will result in an *undefined behavior*. You should serialize receive operations via whatever mechanism works best for you, for example, by using a lock or a semaphore. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -807,7 +813,7 @@ Exactly one send and one receive is supported on each The cancellation token to use to cancel the receive operation. Receives data from the connection asynchronously. The task object representing the asynchronous operation. The property on the task object returns a object that represents the received data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -913,7 +919,9 @@ Exactly one send and one receive is supported on each object in parallel. Issuing multiple sends at the same time is *not supported* and will result in an *undefined behavior*. You should serialize send operations via whatever mechanism works best for you, for example, by using a lock or a semaphore. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -954,7 +962,7 @@ Exactly one send and one receive is supported on each The cancellation token to use to cancel the send operation. Sends data over the connection asynchronously. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -989,7 +997,7 @@ Exactly one send and one receive is supported on each The cancellation token to use to cancel the send operation. Sends data over the connection asynchronously. The task object representing the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Net/Dns.xml b/xml/System.Net/Dns.xml index cf7a2a70b46..695ea225220 100644 --- a/xml/System.Net/Dns.xml +++ b/xml/System.Net/Dns.xml @@ -892,7 +892,9 @@ This method queries a DNS server for the IP addresses associated with a host name. If `hostNameOrAddress` is an IP address, this address is returned without querying the DNS server. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -930,7 +932,7 @@ A cancellation token that can be used to signal the asynchronous operation should be canceled. Returns the Internet Protocol (IP) addresses for the specified host as an asynchronous operation. The task object representing the asynchronous operation. The property on the task object returns an array of type that holds the IP addresses for the host that is specified by the parameter. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -962,7 +964,7 @@ A cancellation token that can be used to signal the asynchronous operation should be canceled. Returns the Internet Protocol (IP) addresses for the specified host as an asynchronous operation. The task object representing the asynchronous operation. The property on the task object returns an array of type that holds the IP addresses for the host that is specified by the parameter. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1476,7 +1478,9 @@ > [!NOTE] > This member emits 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 method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1560,7 +1564,9 @@ > [!NOTE] > This member emits 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 method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The length of parameter is greater than 255 characters. @@ -1596,7 +1602,7 @@ A cancellation token that can be used to signal the asynchronous operation should be canceled. Resolves a host name or IP address to an instance as an asynchronous operation. The task object representing the asynchronous operation. The property on the task object returns an instance that contains the address information about the host specified in . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1628,7 +1634,7 @@ A cancellation token that can be used to signal the asynchronous operation should be canceled. Resolves a host name or IP address to an instance as an asynchronous operation. The task object representing the asynchronous operation. The property on the task object returns an instance that contains the address information about the host specified in . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Net/FileWebRequest.xml b/xml/System.Net/FileWebRequest.xml index 8e5eab5c3e3..545ebcfc87c 100644 --- a/xml/System.Net/FileWebRequest.xml +++ b/xml/System.Net/FileWebRequest.xml @@ -812,7 +812,9 @@ > [!NOTE] > In the case of asynchronous requests, the client application is responsible for implementing its own time-out mechanism. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The stream is being used by a previous call to . @@ -916,7 +918,9 @@ The stream already received a response previous to your request. > [!NOTE] > In the case of asynchronous requests, the client application is responsible for implementing its own time-out mechanism. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The stream is already in use by a previous call to . The was aborted. diff --git a/xml/System.Net/HttpListener.xml b/xml/System.Net/HttpListener.xml index 334e7c29e21..e2c14d53821 100644 --- a/xml/System.Net/HttpListener.xml +++ b/xml/System.Net/HttpListener.xml @@ -862,7 +862,9 @@ The following code example demonstrates calling the `Close` method: Before calling this method, you must call the method and add at least one URI prefix to listen for by adding the URI strings to the returned by the property. For a detailed description of prefixes, see the class overview. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Net/HttpListenerContext.xml b/xml/System.Net/HttpListenerContext.xml index 0e93c55c33e..1fa879d1a36 100644 --- a/xml/System.Net/HttpListenerContext.xml +++ b/xml/System.Net/HttpListenerContext.xml @@ -123,7 +123,9 @@ The size of the receive buffer is 16,385 bytes. The WebSocket keep-alive interval is set to the default value of 30,000 (30 seconds). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is an empty string @@ -189,7 +191,9 @@ The size of the receive buffer is 16,385 bytes. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is an empty string @@ -257,7 +261,9 @@ ## Remarks This operation will not block. The returned > object will complete after the WebSocket connection has been accepted. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is an empty string @@ -339,7 +345,9 @@ ## Remarks This operation will not block. The returned object will complete after the WebSocket connection has been accepted. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is an empty string diff --git a/xml/System.Net/HttpListenerRequest.xml b/xml/System.Net/HttpListenerRequest.xml index 85799b65ca4..65eff2790e9 100644 --- a/xml/System.Net/HttpListenerRequest.xml +++ b/xml/System.Net/HttpListenerRequest.xml @@ -594,7 +594,9 @@ If a call to this method to retrieve the client's X.509 v.3 certificate is in progress, then another call to this method cannot be made. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Net/WebClient.xml b/xml/System.Net/WebClient.xml index 18a59d8bf5a..bfcb927527a 100644 --- a/xml/System.Net/WebClient.xml +++ b/xml/System.Net/WebClient.xml @@ -449,7 +449,9 @@ If no asynchronous operation is in progress, this method does nothing. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -741,7 +743,9 @@ > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -811,7 +815,9 @@ > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -961,7 +967,9 @@ The following code example requests data from a server and displays the data returned. It assumes that `remoteUri` contains a valid URI for the requested data. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -1032,7 +1040,9 @@ > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -1291,7 +1301,9 @@ When using this method in an ASP.NET page, you will receive an error if the account that the page executes under does not have permission to access the local file. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -1370,7 +1382,9 @@ When using this method in an ASP.NET page, you will receive an error if the account that the page executes under does not have permission to access the local file. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -1521,7 +1535,9 @@ When using this method in an ASP.NET page, you will receive an error if the account that the page executes under does not have permission to access the local file. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -1603,7 +1619,9 @@ When using this method in an ASP.NET page, you will receive an error if the account that the page executes under does not have permission to access the local file. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -1918,7 +1936,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -1988,7 +2008,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -2137,7 +2159,9 @@ internal class MyWebClient : WebClientProtocol This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -2209,7 +2233,9 @@ internal class MyWebClient : WebClientProtocol This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -3605,7 +3631,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and address is invalid. @@ -3682,7 +3710,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and address is invalid. @@ -3839,7 +3869,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and address is invalid. @@ -3920,7 +3952,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and address is invalid. @@ -4298,7 +4332,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -4365,7 +4401,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -4432,7 +4470,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -4584,7 +4624,9 @@ internal class MyWebClient : WebClientProtocol This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -4660,7 +4702,9 @@ internal class MyWebClient : WebClientProtocol This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -4740,7 +4784,9 @@ internal class MyWebClient : WebClientProtocol This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -4821,7 +4867,9 @@ internal class MyWebClient : WebClientProtocol This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -5428,7 +5476,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -5508,7 +5558,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -5584,7 +5636,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -5740,7 +5794,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -5819,7 +5875,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -5899,7 +5957,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -5979,7 +6039,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . The URI formed by combining and is invalid. @@ -6448,7 +6510,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -6542,7 +6606,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -6632,7 +6698,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -6798,7 +6866,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -6887,7 +6957,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -6979,7 +7051,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -7071,7 +7145,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -7565,7 +7641,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -7645,7 +7723,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -7725,7 +7805,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -7883,7 +7965,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -7960,7 +8044,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -8040,7 +8126,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -8124,7 +8212,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -8595,7 +8685,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -8679,7 +8771,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -8763,7 +8857,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -8910,7 +9006,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -8999,7 +9097,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -9091,7 +9191,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . @@ -9187,7 +9289,9 @@ internal class MyWebClient : WebClientProtocol > [!NOTE] > This member outputs trace information when you enable network tracing in your application. For more information, see [Network Tracing in .NET Framework](/dotnet/framework/network-programming/network-tracing). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The parameter is . diff --git a/xml/System.Net/WebRequest.xml b/xml/System.Net/WebRequest.xml index 33c2660aca9..162a643d8f5 100644 --- a/xml/System.Net/WebRequest.xml +++ b/xml/System.Net/WebRequest.xml @@ -1739,7 +1739,9 @@ This property allows an application to determine which , make sure you close the request stream before you call . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1856,7 +1858,9 @@ This property allows an application to determine which object will complete after a response to an Internet request is available. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Runtime.CompilerServices/ConfiguredAsyncDisposable.xml b/xml/System.Runtime.CompilerServices/ConfiguredAsyncDisposable.xml index 3603e8a31a9..11f7794f13e 100644 --- a/xml/System.Runtime.CompilerServices/ConfiguredAsyncDisposable.xml +++ b/xml/System.Runtime.CompilerServices/ConfiguredAsyncDisposable.xml @@ -82,7 +82,7 @@ Asynchronously releases the unmanaged resources used by the . A task that represents the asynchronous dispose operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Runtime.CompilerServices/ConfiguredCancelableAsyncEnumerable`1+Enumerator.xml b/xml/System.Runtime.CompilerServices/ConfiguredCancelableAsyncEnumerable`1+Enumerator.xml index 8469a174d60..c98c810f75e 100644 --- a/xml/System.Runtime.CompilerServices/ConfiguredCancelableAsyncEnumerable`1+Enumerator.xml +++ b/xml/System.Runtime.CompilerServices/ConfiguredCancelableAsyncEnumerable`1+Enumerator.xml @@ -112,7 +112,7 @@ Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously. A task that represents the asynchronous dispose operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -145,7 +145,7 @@ Advances the enumerator asynchronously to the next element of the collection. A that will complete with a result of if the enumerator was successfully advanced to the next element, or if the enumerator has passed the end of the collection. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Runtime.InteropServices.JavaScript/JSHost.xml b/xml/System.Runtime.InteropServices.JavaScript/JSHost.xml index db6cda2bcef..4002ae8e7f1 100644 --- a/xml/System.Runtime.InteropServices.JavaScript/JSHost.xml +++ b/xml/System.Runtime.InteropServices.JavaScript/JSHost.xml @@ -92,7 +92,7 @@ Downloads and instantiates an ES6 module from the provided URL, via the JavaScript host's dynamic import API. If a module with the provided has previously been instantiated, it will be returned instead. A proxy for the JavaScript object that contains the module's exports. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Security.Cryptography.Cose/CoseMultiSignMessage.xml b/xml/System.Security.Cryptography.Cose/CoseMultiSignMessage.xml index 33820786b67..62732cb27ae 100644 --- a/xml/System.Security.Cryptography.Cose/CoseMultiSignMessage.xml +++ b/xml/System.Security.Cryptography.Cose/CoseMultiSignMessage.xml @@ -162,7 +162,7 @@ One or more of the labels specified in a The token to monitor for cancellation requests. The default value is . Asynchronously adds a signature for the specified content to this message. A task that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is . @@ -524,7 +524,7 @@ One or more of the labels specified in a The token to monitor for cancellation requests. The default value is . Asynchronously signs the specified content and encodes it as a COSE_Sign message with detached content. A task that represents the asynchronous operation. The value of its property contains the encoded message. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is . diff --git a/xml/System.Security.Cryptography.Cose/CoseSign1Message.xml b/xml/System.Security.Cryptography.Cose/CoseSign1Message.xml index 5e5b47ff570..5311934f93a 100644 --- a/xml/System.Security.Cryptography.Cose/CoseSign1Message.xml +++ b/xml/System.Security.Cryptography.Cose/CoseSign1Message.xml @@ -205,7 +205,7 @@ One or more of the labels specified in a The token to monitor for cancellation requests. The default value is . Asynchronously signs the specified content and encodes it as a COSE_Sign1 message with detached content. A task that represents the asynchronous operation. The value of its property contains the encoded message. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is . @@ -591,7 +591,7 @@ The algorithm protected header doesn't match with the algorithms supported by th The token to monitor for cancellation requests. The default value is . Asynchronously verifies that the signature is valid for the content using the specified key. A task whose property is if the signature is valid; otherwise, . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is . diff --git a/xml/System.Security.Cryptography.Cose/CoseSignature.xml b/xml/System.Security.Cryptography.Cose/CoseSignature.xml index 6e4dfc8db14..00565769fd9 100644 --- a/xml/System.Security.Cryptography.Cose/CoseSignature.xml +++ b/xml/System.Security.Cryptography.Cose/CoseSignature.xml @@ -281,7 +281,7 @@ The algorithm protected header doesn't match with the algorithms supported by th The token to monitor for cancellation requests. The default value is . Asynchronously verifies that the signature is valid for the message's content using the specified key. A task whose property is if the signature is valid; otherwise, . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is . diff --git a/xml/System.Security.Cryptography/CryptoStream.xml b/xml/System.Security.Cryptography/CryptoStream.xml index 95d08ffe30f..a3d851c23b5 100644 --- a/xml/System.Security.Cryptography/CryptoStream.xml +++ b/xml/System.Security.Cryptography/CryptoStream.xml @@ -637,7 +637,9 @@ Copying begins at the current position in the current stream, and does not reset Copying begins at the current position in the current stream, and does not reset the position of the destination stream after the copy operation is complete. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -756,7 +758,9 @@ Copying begins at the current position in the current stream, and does not reset Calling `DisposeAsync` allows the resources used by the to be reallocated for other purposes. For more information, see [Cleaning Up Unmanaged Resources](/dotnet/standard/garbage-collection/unmanaged). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1007,7 +1011,9 @@ Copying begins at the current position in the current stream, and does not reset If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The stream has been disposed. @@ -1097,7 +1103,7 @@ Copying begins at the current position in the current stream, and does not reset The token to monitor for cancellation requests. The default value is . Asynchronously updates the underlying data source or repository with the current state of the buffer, then clears the buffer. A task that represents the asynchronous flush operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1348,7 +1354,7 @@ Copying begins at the current position in the current stream, and does not reset The token to monitor for cancellation requests. The default value is . Asynchronously reads a sequence of bytes from the current stream, advances the position within the stream by the number of bytes read, and monitors cancellation requests. A task that represents the asynchronous read operation. The value of its property contains the total number of bytes read into the buffer. The result value can be less than the number of bytes allocated in the buffer if that many bytes are not currently available, or it can be 0 (zero) if the end of the stream has been reached. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The associated with current object does not match the underlying stream. For example, this exception is thrown when using with an underlying stream that is write only. @@ -1408,7 +1414,9 @@ Copying begins at the current position in the current stream, and does not reset If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -1715,7 +1723,7 @@ This member is an explicit interface member implementation. It can be used only The token to monitor for cancellation requests. The default value is . Asynchronously writes a sequence of bytes to the current stream, advances the current position within this stream by the number of bytes written, and monitors cancellation requests. A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The associated with current object does not match the underlying stream. For example, this exception is thrown when using with an underlying stream that is read only. @@ -1775,7 +1783,9 @@ This member is an explicit interface member implementation. It can be used only If the operation is canceled before it completes, the returned task contains the value for the property. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . diff --git a/xml/System.Security.Cryptography/HMACMD5.xml b/xml/System.Security.Cryptography/HMACMD5.xml index 352340d023a..5b400944ba7 100644 --- a/xml/System.Security.Cryptography/HMACMD5.xml +++ b/xml/System.Security.Cryptography/HMACMD5.xml @@ -633,7 +633,7 @@ The default value is . Asynchronously computes the HMAC of a stream using the MD5 algorithm. The HMAC of the data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is . @@ -678,7 +678,7 @@ The default value is . Asynchronously computes the HMAC of a stream using the MD5 algorithm. The HMAC of the data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . @@ -725,7 +725,7 @@ The default value is . Asynchronously computes the HMAC of a stream using the MD5 algorithm. The total number of bytes written to . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . diff --git a/xml/System.Security.Cryptography/HMACSHA1.xml b/xml/System.Security.Cryptography/HMACSHA1.xml index d8d50accceb..769bfc27bfc 100644 --- a/xml/System.Security.Cryptography/HMACSHA1.xml +++ b/xml/System.Security.Cryptography/HMACSHA1.xml @@ -693,7 +693,7 @@ Releases the unmanaged resources used by the . Asynchronously computes the HMAC of a stream using the SHA1 algorithm. The HMAC of the data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is . @@ -732,7 +732,7 @@ Releases the unmanaged resources used by the . Asynchronously computes the HMAC of a stream using the SHA1 algorithm. The HMAC of the data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . @@ -773,7 +773,7 @@ Releases the unmanaged resources used by the . Asynchronously computes the HMAC of a stream using the SHA1 algorithm. The total number of bytes written to . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . diff --git a/xml/System.Security.Cryptography/HMACSHA256.xml b/xml/System.Security.Cryptography/HMACSHA256.xml index 2b23cbc37fd..0ef4b4e74b1 100644 --- a/xml/System.Security.Cryptography/HMACSHA256.xml +++ b/xml/System.Security.Cryptography/HMACSHA256.xml @@ -584,7 +584,7 @@ The default value is . Asynchronously computes the HMAC of a stream using the SHA256 algorithm. The HMAC of the data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is . @@ -623,7 +623,7 @@ The default value is . Asynchronously computes the HMAC of a stream using the SHA256 algorithm. The HMAC of the data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . @@ -664,7 +664,7 @@ The default value is . Asynchronously computes the HMAC of a stream using the SHA256 algorithm. The total number of bytes written to . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . diff --git a/xml/System.Security.Cryptography/HMACSHA384.xml b/xml/System.Security.Cryptography/HMACSHA384.xml index 685b0850950..e2fe144b09e 100644 --- a/xml/System.Security.Cryptography/HMACSHA384.xml +++ b/xml/System.Security.Cryptography/HMACSHA384.xml @@ -583,7 +583,7 @@ The default value is . Asynchronously computes the HMAC of a stream using the SHA384 algorithm. The HMAC of the data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is . @@ -622,7 +622,7 @@ The default value is . Asynchronously computes the HMAC of a stream using the SHA384 algorithm. The HMAC of the data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . @@ -663,7 +663,7 @@ The default value is . Asynchronously computes the HMAC of a stream using the SHA384 algorithm. The total number of bytes written to . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . diff --git a/xml/System.Security.Cryptography/HMACSHA512.xml b/xml/System.Security.Cryptography/HMACSHA512.xml index 64f9150571a..ab6f2f0a584 100644 --- a/xml/System.Security.Cryptography/HMACSHA512.xml +++ b/xml/System.Security.Cryptography/HMACSHA512.xml @@ -583,7 +583,7 @@ The default value is . Asynchronously computes the HMAC of a stream using the SHA512 algorithm. The HMAC of the data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . or is . @@ -622,7 +622,7 @@ The default value is . Asynchronously computes the HMAC of a stream using the SHA512 algorithm. The HMAC of the data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . @@ -663,7 +663,7 @@ The default value is . Asynchronously computes the HMAC of a stream using the SHA512 algorithm. The total number of bytes written to . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . diff --git a/xml/System.Security.Cryptography/HashAlgorithm.xml b/xml/System.Security.Cryptography/HashAlgorithm.xml index b78bc6475e4..476e2d70a76 100644 --- a/xml/System.Security.Cryptography/HashAlgorithm.xml +++ b/xml/System.Security.Cryptography/HashAlgorithm.xml @@ -492,7 +492,7 @@ The following example calculates the The token to monitor for cancellation requests. Asynchronously computes the hash value for the specified object. A task that represents the asynchronous compute hash operation and wraps the computed hash code. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Security.Cryptography/MD5.xml b/xml/System.Security.Cryptography/MD5.xml index 879a5815e7c..7f48da14a44 100644 --- a/xml/System.Security.Cryptography/MD5.xml +++ b/xml/System.Security.Cryptography/MD5.xml @@ -511,7 +511,7 @@ The default value is . Asynchronously computes the hash of a stream using the MD5 algorithm. The hash of the data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . @@ -556,7 +556,7 @@ The default value is . Asynchronously computes the hash of a stream using the MD5 algorithm. The total number of bytes written to . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . diff --git a/xml/System.Security.Cryptography/SHA1.xml b/xml/System.Security.Cryptography/SHA1.xml index e54322782ce..cc80ae905e3 100644 --- a/xml/System.Security.Cryptography/SHA1.xml +++ b/xml/System.Security.Cryptography/SHA1.xml @@ -461,7 +461,7 @@ The default value is . Asynchronously computes the hash of a stream using the SHA1 algorithm. The hash of the data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . @@ -500,7 +500,7 @@ The default value is . Asynchronously computes the hash of a stream using the SHA1 algorithm. The total number of bytes written to . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . diff --git a/xml/System.Security.Cryptography/SHA256.xml b/xml/System.Security.Cryptography/SHA256.xml index fad678db758..06e674cc2a8 100644 --- a/xml/System.Security.Cryptography/SHA256.xml +++ b/xml/System.Security.Cryptography/SHA256.xml @@ -475,7 +475,7 @@ The .NET Framework includes the implementations and their associated hashName va The default value is . Asynchronously computes the hash of a stream using the SHA256 algorithm. The hash of the data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . @@ -514,7 +514,7 @@ The .NET Framework includes the implementations and their associated hashName va The default value is . Asynchronously computes the hash of a stream using the SHA256 algorithm. The total number of bytes written to . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . diff --git a/xml/System.Security.Cryptography/SHA384.xml b/xml/System.Security.Cryptography/SHA384.xml index 71ab329dd71..91218e85b67 100644 --- a/xml/System.Security.Cryptography/SHA384.xml +++ b/xml/System.Security.Cryptography/SHA384.xml @@ -465,7 +465,7 @@ The default value is . Asynchronously computes the hash of a stream using the SHA384 algorithm. The hash of the data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . @@ -504,7 +504,7 @@ The default value is . Asynchronously computes the hash of a stream using the SHA384 algorithm. The total number of bytes written to . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . diff --git a/xml/System.Security.Cryptography/SHA512.xml b/xml/System.Security.Cryptography/SHA512.xml index e253327738f..d9988e6fcce 100644 --- a/xml/System.Security.Cryptography/SHA512.xml +++ b/xml/System.Security.Cryptography/SHA512.xml @@ -474,7 +474,7 @@ The default value is . Asynchronously computes the hash of a stream using the SHA512 algorithm. The hash of the data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . @@ -513,7 +513,7 @@ The default value is . Asynchronously computes the hash of a stream using the SHA512 algorithm. The total number of bytes written to . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is . diff --git a/xml/System.Security.Principal/WindowsIdentity.xml b/xml/System.Security.Principal/WindowsIdentity.xml index b8f3937bc49..e549ee65bd6 100644 --- a/xml/System.Security.Principal/WindowsIdentity.xml +++ b/xml/System.Security.Principal/WindowsIdentity.xml @@ -2054,7 +2054,7 @@ public class ImpersonationDemo The function to run. Runs the specified asynchronous action as the impersonated Windows identity. A task that represents the asynchronous operation of the provided . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.ServiceModel.Activities/WorkflowControlClient.xml b/xml/System.ServiceModel.Activities/WorkflowControlClient.xml index d81208e59c9..e2a178eb743 100644 --- a/xml/System.ServiceModel.Activities/WorkflowControlClient.xml +++ b/xml/System.ServiceModel.Activities/WorkflowControlClient.xml @@ -359,7 +359,7 @@ The workflows instance to abandon. Begins an asynchronous operation that abandons the specified workflow instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -391,7 +391,7 @@ The workflow instance to abandon. The user-defined state data. Begins an asynchronous operation that abandons the specified workflow instance with the specified user-defined data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -423,7 +423,7 @@ The workflow instance to abandon. The reason to abandon the workflow instance. Begins an asynchronous operation that abandons the specified workflow instance with the specified reason. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -451,7 +451,7 @@ The reason to abandon the workflow instance. The user-defined state data. Begins an asynchronous operation that abandons the specified workflow instance with the specified reason and user-defined data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -844,7 +844,7 @@ The workflow instance to cancel. Begins an asynchronous operation that cancels the specified workflow instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -870,7 +870,7 @@ The workflow instance to cancel. The user-defined data. Begins an asynchronous operation that cancels the specified workflow instance with the specified user-defined data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1107,7 +1107,7 @@ The workflow instance to run. Begins an asynchronous operation that runs the specified workflow instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1133,7 +1133,7 @@ The workflow instance to run. The user-defined state data. Begins an asynchronous operation that runs the specified workflow instance with the user-defined state data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1264,7 +1264,7 @@ The workflow instance to suspend. Begins an asynchronous suspend operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1290,7 +1290,7 @@ The workflow instance to suspend. The user-defined state data. Begins an asynchronous suspend operation with the specified workflow instance ID and user-defined state data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1322,7 +1322,7 @@ The workflow instance to suspend. The reason to suspend the workflow instance. Begins an asynchronous suspend operation with the specified workflow instance ID and reason. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1350,7 +1350,7 @@ The reason to suspend the workflow instance. The user-defined state data. Begins an asynchronous suspend operation with the specified workflow instance ID, reason, and user-defined state data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1481,7 +1481,7 @@ The workflow instance to terminate. Begins an asynchronous operation that terminates the specified workflow instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1507,7 +1507,7 @@ The workflow instance to terminate. The user-defined state data. Begins an asynchronous operation that terminates the specified workflow instance with the specified user-defined data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1539,7 +1539,7 @@ The workflow instance to terminate. The reason to terminate the workflow instance. Begins an asynchronous operation that terminates the specified workflow instance with the specified reason. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1567,7 +1567,7 @@ The reason to terminate the workflow instance. The user-defined state data. Begins an asynchronous operation that terminates the specified workflow instance with the specified reason and user-defined data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1660,7 +1660,7 @@ The workflow instance to unsuspend. Begins an asynchronous unsuspend operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1686,7 +1686,7 @@ The workflow instance to unsuspend. The user-defined state data. Begins an asynchronous unsuspend operation with the specified user-defined state data. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.ServiceModel.Activities/WorkflowUpdateableControlClient.xml b/xml/System.ServiceModel.Activities/WorkflowUpdateableControlClient.xml index 8252b907eee..53d815a5cfc 100644 --- a/xml/System.ServiceModel.Activities/WorkflowUpdateableControlClient.xml +++ b/xml/System.ServiceModel.Activities/WorkflowUpdateableControlClient.xml @@ -247,7 +247,7 @@ The workflows instance to abandon. Begins an asynchronous operation that abandons the specified workflow instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -273,7 +273,7 @@ The workflows instance to abandon. A user-defined object that contains state information associated with the asynchronous abandon operation. Begins an asynchronous operation that abandons the specified workflow instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -299,7 +299,7 @@ The workflows instance to abandon. The reason to abandon the workflow instance. Begins an asynchronous operation that abandons the specified workflow instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -327,7 +327,7 @@ The reason to abandon the workflow instance. A user-defined object that contains state information associated with the asynchronous abandon operation. Begins an asynchronous operation that abandons the specified workflow instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -730,7 +730,7 @@ The workflow instance to cancel. Begins an asynchronous operation that cancels the specified workflow instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -756,7 +756,7 @@ The workflow instance to cancel. A user-defined object that contains state information associated with the asynchronous cancel operation. Begins an asynchronous operation that cancels the specified workflow instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1002,7 +1002,7 @@ The workflow instance to run. Begins an asynchronous operation that runs the specified workflow instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1028,7 +1028,7 @@ The workflow instance to run. A user-defined object that contains state information associated with the asynchronous run operation. Begins an asynchronous operation that runs the specified workflow instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1141,7 +1141,7 @@ The workflow instance to suspend. Begins an asynchronous suspend operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1167,7 +1167,7 @@ The workflow instance to suspend. A user-defined object that contains state information associated with the asynchronous suspend operation. Begins an asynchronous suspend operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1193,7 +1193,7 @@ The workflow instance to suspend. The reason to suspend the workflow instance. Begins an asynchronous suspend operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1221,7 +1221,7 @@ The reason to suspend the workflow instance. A user-defined object that contains state information associated with the asynchronous run operation. Begins an asynchronous suspend operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1334,7 +1334,7 @@ The workflow instance to terminate. Begins an asynchronous terminate operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1360,7 +1360,7 @@ The workflow instance to terminate. A user-defined object that contains state information associated with the asynchronous terminate operation. Begins an asynchronous terminate operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1386,7 +1386,7 @@ The workflow instance to terminate. The reason to terminate the workflow instance. Begins an asynchronous terminate operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1414,7 +1414,7 @@ The reason to terminate the workflow instance. A user-defined object that contains state information associated with the asynchronous terminate operation. Begins an asynchronous terminate operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1492,7 +1492,7 @@ The workflow instance to unsuspend. Begins an asynchronous unsuspend operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1518,7 +1518,7 @@ The workflow instance to unsuspend. A user-defined object that contains state information associated with the asynchronous unsuspend operation. Begins an asynchronous unsuspend operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1600,7 +1600,7 @@ The workflow instance to update. The updated workflow identity. Begins an asynchronous update operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1628,7 +1628,7 @@ The updated workflow identity. A user-defined object that contains state information associated with the asynchronous update operation. Begins an asynchronous update operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.ServiceModel.Description/MetadataExchangeClient.xml b/xml/System.ServiceModel.Description/MetadataExchangeClient.xml index ad465a36916..1c9710d0115 100644 --- a/xml/System.ServiceModel.Description/MetadataExchangeClient.xml +++ b/xml/System.ServiceModel.Description/MetadataExchangeClient.xml @@ -586,7 +586,7 @@ Returns an asynchronous metadata set. The asynchronous metadata set. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -611,7 +611,7 @@ The address from which to download the asynchronous metadata. Returns an asynchronous metadata set from the specified address. The asynchronous metadata located at the address. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -638,7 +638,7 @@ The URI address that represents the route a message takes. Returns an asynchronous metadata set from the specified address and on the specified route. The metadata that is downloaded. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -665,7 +665,7 @@ The download mechanism to use. Returns an asynchronous metadata set from the specified address using the specified download mode. The metadata that is downloaded. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.ServiceModel.Discovery/AnnouncementClient.xml b/xml/System.ServiceModel.Discovery/AnnouncementClient.xml index 65126e59dfd..42c12c1bcce 100644 --- a/xml/System.ServiceModel.Discovery/AnnouncementClient.xml +++ b/xml/System.ServiceModel.Discovery/AnnouncementClient.xml @@ -166,7 +166,7 @@ The endpoint discovery metadata. Causes an offline announcement message (Bye) to be sent asynchronously with the specified endpoint discovery metadata. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -192,7 +192,7 @@ The endpoint discovery metadata. The user-defined state data. Causes an offline announcement message (Bye) to be sent asynchronously with the specified endpoint discovery metadata and user-defined state. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -244,7 +244,7 @@ The endpoint discovery metadata. Causes an offline task announcement message (Bye) to be sent asynchronously with the specified endpoint discovery metadata. An offline task announcement message to be sent asynchronously. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -307,7 +307,7 @@ The endpoint discovery metadata. Causes an online announcement (Hello) message to be sent asynchronously with the specified endpoint discovery metadata. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -333,7 +333,7 @@ The endpoint discovery metadata. The user-defined state data. Causes an online announcement (Hello) message to be sent asynchronously with the specified endpoint discovery metadata and user-defined state. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -385,7 +385,7 @@ The endpoint discovery metadata. Causes an online task announcement message (Hello) to be sent asynchronously with the specified endpoint discovery metadata. An online task announcement message to be sent asynchronously. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.ServiceModel.Discovery/DiscoveryClient.xml b/xml/System.ServiceModel.Discovery/DiscoveryClient.xml index 4944e217494..7e806832c13 100644 --- a/xml/System.ServiceModel.Discovery/DiscoveryClient.xml +++ b/xml/System.ServiceModel.Discovery/DiscoveryClient.xml @@ -126,7 +126,9 @@ ## Remarks An is thrown if `userState` is `null`. If multiple or operations are called with the same `userState` value, and is called with that `userState` value, an is thrown. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -281,7 +283,9 @@ ## Remarks Find operations initiated by calling this method cannot be canceled. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -314,7 +318,9 @@ ## Remarks If the `userState` parameter is `null`, the find operation cannot be canceled. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -405,7 +411,7 @@ The criteria for finding services. Begins an asynchronous find task operation with the specified criteria. An asynchronous find task operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -432,7 +438,7 @@ The cancellation token for notification propagation. Begins an asynchronous find task operation with the specified criteria and cancellation token object. An asynchronous find task operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -572,7 +578,9 @@ ## Remarks Resolve operations initiated by calling this method cannot be canceled. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -605,7 +613,9 @@ ## Remarks If the `userState` parameter is null, the resolve operation cannot be canceled. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -661,7 +671,7 @@ The criteria for matching a service endpoint. Begins an asynchronous resolve task operation with the specified criteria. An asynchronous resolve task operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -688,7 +698,7 @@ The cancellation token for notification propagation. Begins an asynchronous resolve task operation with the specified criteria and cancellation token. An asynchronous resolve task operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.ServiceModel/ChannelFactory.xml b/xml/System.ServiceModel/ChannelFactory.xml index cd03cc0e741..5ce9f27aa05 100644 --- a/xml/System.ServiceModel/ChannelFactory.xml +++ b/xml/System.ServiceModel/ChannelFactory.xml @@ -1081,7 +1081,7 @@ To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.ServiceModel/ClientBase`1.xml b/xml/System.ServiceModel/ClientBase`1.xml index 60dea1356af..2e61ae3366a 100644 --- a/xml/System.ServiceModel/ClientBase`1.xml +++ b/xml/System.ServiceModel/ClientBase`1.xml @@ -905,7 +905,7 @@ To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1154,7 +1154,9 @@ ## Remarks Provide a unique value, such as a GUID or hash code, in the `userState` parameter for each call to , and when each operation is completed, your event handler can determine which instance of the operation raised the completion event. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1268,7 +1270,7 @@ To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Speech.Recognition/SpeechRecognitionEngine.xml b/xml/System.Speech.Recognition/SpeechRecognitionEngine.xml index b7cce1adb36..9f103b31315 100644 --- a/xml/System.Speech.Recognition/SpeechRecognitionEngine.xml +++ b/xml/System.Speech.Recognition/SpeechRecognitionEngine.xml @@ -1863,7 +1863,9 @@ namespace SreEmulateRecognizeAsync ``` - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The recognizer has no speech recognition grammars loaded, or the recognizer has an asynchronous recognition operation that is not yet complete. @@ -1911,7 +1913,9 @@ namespace SreEmulateRecognizeAsync The recognizer uses `compareOptions` when it applies grammar rules to the input phrase. The recognizers that ship with Vista and Windows 7 ignore case if the or value is present. The recognizers always ignore the character width and never ignore the Kana type. The recognizers also ignore new lines and extra white space and treat punctuation as literal input. For more information about character width and Kana type, see the enumeration. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The recognizer has no speech recognition grammars loaded, or the recognizer has an asynchronous recognition operation that is not yet complete. @@ -1961,7 +1965,9 @@ namespace SreEmulateRecognizeAsync The recognizer uses `compareOptions` when it applies grammar rules to the input phrase. The recognizers that ship with Vista and Windows 7 ignore case if the or value is present. The recognizers always ignore the character width and never ignore the Kana type. The recognizers also ignore new lines and extra white space and treat punctuation as literal input. For more information about character width and Kana type, see the enumeration. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The recognizer has no speech recognition grammars loaded, or the recognizer has an asynchronous recognition operation that is not yet complete. @@ -2664,7 +2670,9 @@ namespace SpeechRecognitionApp To load a speech recognition grammar synchronously, use the method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -3505,7 +3513,9 @@ namespace AsynchronousRecognition ``` - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -3762,7 +3772,9 @@ namespace AsynchronousRecognition ``` - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Speech.Recognition/SpeechRecognizer.xml b/xml/System.Speech.Recognition/SpeechRecognizer.xml index 4b643bc347b..9f94bcccea9 100644 --- a/xml/System.Speech.Recognition/SpeechRecognizer.xml +++ b/xml/System.Speech.Recognition/SpeechRecognizer.xml @@ -1129,7 +1129,9 @@ namespace SharedRecognizer ``` - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1171,7 +1173,9 @@ namespace SharedRecognizer The recognizer uses the `compareOptions` when it applies grammar rules to the input phrase. The recognizers that ship with Vista and Windows 7 ignore case if the or value is present. The recognizers always ignore the character width and never ignore the Kana type. The recognizers also ignore new lines and extra white space and treats punctuation as literal input. For more information about character width and Kana type, see the enumeration. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1211,7 +1215,9 @@ namespace SharedRecognizer ## Remarks The recognizer uses the `compareOptions` when it applies grammar rules to the input phrase. The recognizers that ship with Vista and Windows 7 ignore case if the or value is present. The recognizers always ignore the character width and never ignore the Kana type. The recognizers also ignore new lines and extra white space and treats punctuation as literal input. For more information about character width and Kana type, see the enumeration. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1644,7 +1650,9 @@ namespace SharedRecognizer To load a speech recognition grammar synchronously, use the method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Speech.Synthesis/SpeechSynthesizer.xml b/xml/System.Speech.Synthesis/SpeechSynthesizer.xml index 756e7d9a941..6b0f2c93e39 100644 --- a/xml/System.Speech.Synthesis/SpeechSynthesizer.xml +++ b/xml/System.Speech.Synthesis/SpeechSynthesizer.xml @@ -1809,7 +1809,9 @@ namespace SampleSynthesis ``` - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1880,7 +1882,9 @@ namespace SampleSynthesis ``` - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1947,7 +1951,9 @@ namespace SampleSynthesis ``` - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -2329,7 +2335,9 @@ namespace SampleSynthesis } ``` - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Text.Json/JsonDocument.xml b/xml/System.Text.Json/JsonDocument.xml index 99ed22f4fa9..60937dae420 100644 --- a/xml/System.Text.Json/JsonDocument.xml +++ b/xml/System.Text.Json/JsonDocument.xml @@ -300,7 +300,7 @@ The value may be used for the entire lifetime o The token to monitor for cancellation requests. Parses a as UTF-8-encoded data representing a single JSON value into a JsonDocument. The stream is read to completion. A task to produce a JsonDocument representation of the JSON value. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . does not represent a valid single JSON value. diff --git a/xml/System.Text.Json/JsonSerializer.xml b/xml/System.Text.Json/JsonSerializer.xml index 3514deaac4c..06d22ee8f6d 100644 --- a/xml/System.Text.Json/JsonSerializer.xml +++ b/xml/System.Text.Json/JsonSerializer.xml @@ -1774,7 +1774,9 @@ The used to create the instance of the For more information, see [How to serialize and deserialize JSON](/dotnet/standard/serialization/system-text-json-how-to). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> or is . @@ -1819,7 +1821,7 @@ There is remaining data in the stream. Reads the UTF-8 encoded text representing a single JSON value into a . The Stream will be read to completion. A representation of the JSON value. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . , , or is . The JSON is invalid, the is not compatible with the JSON, or there is remaining data in the Stream. @@ -2643,7 +2645,9 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa For more information, see [How to serialize and deserialize JSON](/dotnet/standard/serialization/system-text-json-how-to). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is not compatible with . @@ -2682,7 +2686,7 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa The that can be used to cancel the write operation. Converts the provided value to UTF-8 encoded JSON text and write it to the . A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . is not compatible with . diff --git a/xml/System.Text.Json/Utf8JsonWriter.xml b/xml/System.Text.Json/Utf8JsonWriter.xml index 996029e2627..97b4aade780 100644 --- a/xml/System.Text.Json/Utf8JsonWriter.xml +++ b/xml/System.Text.Json/Utf8JsonWriter.xml @@ -269,7 +269,9 @@ In the case of Stream, this writes the data to the stream and flushes it. The instance cannot be reused after disposing. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -343,7 +345,9 @@ In the case of IBufferWriter, this advances the underlying , this writes the data to the stream and flushes it asynchronously, while monitoring cancellation requests. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> This instance has been disposed. diff --git a/xml/System.Threading.Channels/ChannelReader`1.xml b/xml/System.Threading.Channels/ChannelReader`1.xml index d244127991b..a9f6fdfe966 100644 --- a/xml/System.Threading.Channels/ChannelReader`1.xml +++ b/xml/System.Threading.Channels/ChannelReader`1.xml @@ -178,7 +178,9 @@ Each call t returns `false` once no more data is or will ever be available to read. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -208,7 +210,7 @@ Each call t A used to cancel the read operation. Asynchronously reads an item from the channel. A that represents the asynchronous read operation. - If the operation is canceled, the operation will not have removed an item from the channel. + If the operation is canceled, the operation will not have removed an item from the channel.This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -313,7 +315,7 @@ Each call t or with a result when no further data will ever be available to be read due to the channel completing successfully. If the channel completes with an exception, the task will also complete with an exception. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Threading.Channels/ChannelWriter`1.xml b/xml/System.Threading.Channels/ChannelWriter`1.xml index 4ea3060f4d8..97545f2178c 100644 --- a/xml/System.Threading.Channels/ChannelWriter`1.xml +++ b/xml/System.Threading.Channels/ChannelWriter`1.xml @@ -170,7 +170,7 @@ Returns a that will complete when space is available to write an item. A that will complete with a result when space is available to write an item or with a result when no further writing will be permitted. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -201,7 +201,7 @@ A used to cancel the write operation. Asynchronously writes an item to the channel. A that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Threading.Tasks/Task.xml b/xml/System.Threading.Tasks/Task.xml index f89cb7d9633..9ea39658b62 100644 --- a/xml/System.Threading.Tasks/Task.xml +++ b/xml/System.Threading.Tasks/Task.xml @@ -5498,7 +5498,7 @@ timeout is greater than The to monitor for a cancellation request. Gets a that will complete when this completes or when the specified has cancellation requested. The representing the asynchronous wait. It may or may not be the same instance as the current instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -5533,7 +5533,7 @@ timeout is greater than The timeout after which the should be faulted with a if it hasn't otherwise completed. Gets a that will complete when this completes or when the specified timeout expires. The representing the asynchronous wait. It may or may not be the same instance as the current instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -5570,7 +5570,7 @@ timeout is greater than The to monitor for a cancellation request. Gets a that will complete when this completes, when the specified timeout expires, or when the specified has cancellation requested. The representing the asynchronous wait. It may or may not be the same instance as the current instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Threading.Tasks/TaskFactory.xml b/xml/System.Threading.Tasks/TaskFactory.xml index 9e2d894fc54..f850d097013 100644 --- a/xml/System.Threading.Tasks/TaskFactory.xml +++ b/xml/System.Threading.Tasks/TaskFactory.xml @@ -2950,7 +2950,9 @@ The NotOn\* and OnlyOn\* , > [!TIP] > The overloads that take an `asyncResult` parameter are not as efficient as the overloads that take a `beginMethod` parameter. If performance is an issue, use the overloads that provide the `beginMethod`/`endMethod` pattern. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -3015,7 +3017,9 @@ The NotOn\* and OnlyOn\* , ## Remarks The `beginMethod` delegate is started on the thread that is running on. This method throws any exceptions thrown by the `beginMethod`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -3081,7 +3085,9 @@ The NotOn\* and OnlyOn\* , > [!TIP] > The overloads that take an `asyncResult` parameter are not as efficient as the overloads that take a `beginMethod` parameter. If performance is an issue, use the overloads that provide the `beginMethod`/`endMethod` pattern. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -3149,7 +3155,9 @@ The NotOn\* and OnlyOn\* , ## Remarks The `beginMethod` delegate is started on the thread that is running on. This method throws any exceptions thrown by the `beginMethod`. The values , and are all mutually exclusive. In the FromAsync methods, either `LongRunning` or `AttachedToParent` by themselves will cause an to be thrown. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -3219,7 +3227,9 @@ The NotOn\* and OnlyOn\* , > [!TIP] > The overloads that take an `asyncResult` parameter are not as efficient as the overloads that take a `beginMethod` parameter. If performance is an issue, use the overloads that provide the `beginMethod`/`endMethod` pattern. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . diff --git a/xml/System.Threading.Tasks/TaskFactory`1.xml b/xml/System.Threading.Tasks/TaskFactory`1.xml index af9120993a4..fba64c738fe 100644 --- a/xml/System.Threading.Tasks/TaskFactory`1.xml +++ b/xml/System.Threading.Tasks/TaskFactory`1.xml @@ -1780,7 +1780,7 @@ The function delegate that processes the completed . Creates a task that executes an end method function when a specified completes. A that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The argument is . -or- @@ -1843,7 +1843,9 @@ ## Remarks This method throws any exceptions thrown by the `beginMethod`. Exceptions for `endmethod` are thrown when waiting on the returned task. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The argument is . @@ -1900,7 +1902,7 @@ One of the enumeration values that controls the behavior of the created task. Creates a task that executes an end method function when a specified completes. A task that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The argument is . -or- @@ -1966,7 +1968,9 @@ ## Remarks This method throws any exceptions thrown by the `beginMethod`. Exceptions for `endmethod` are thrown when waiting on the returned task. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The argument is . @@ -2026,7 +2030,7 @@ The task scheduler that is used to schedule the task that executes the end method. Creates a task that executes an end method function when a specified completes. The created task that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The argument is . -or- diff --git a/xml/System.Threading.Tasks/Task`1.xml b/xml/System.Threading.Tasks/Task`1.xml index d4ba051196d..33126834c0c 100644 --- a/xml/System.Threading.Tasks/Task`1.xml +++ b/xml/System.Threading.Tasks/Task`1.xml @@ -2190,7 +2190,7 @@ This method is intended for compiler use rather than use directly in code. The to monitor for a cancellation request. Gets a that will complete when this completes or when the specified has cancellation requested. The representing the asynchronous wait. It may or may not be the same instance as the current instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2225,7 +2225,7 @@ This method is intended for compiler use rather than use directly in code. The timeout after which the should be faulted with a if it hasn't otherwise completed. Gets a that will complete when this completes or when the specified timeout expires. The representing the asynchronous wait. It may or may not be the same instance as the current instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2262,7 +2262,7 @@ This method is intended for compiler use rather than use directly in code. The to monitor for a cancellation request. Gets a that will complete when this completes, when the specified timeout expires, or when the specified has cancellation requested. The representing the asynchronous wait. It may or may not be the same instance as the current instance. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Threading/CancellationTokenRegistration.xml b/xml/System.Threading/CancellationTokenRegistration.xml index 193631122d0..778c494d7e6 100644 --- a/xml/System.Threading/CancellationTokenRegistration.xml +++ b/xml/System.Threading/CancellationTokenRegistration.xml @@ -176,7 +176,9 @@ The returned completes once the associated callback is unregistered without having executed or once it's finished executing, except in the degenerate case where the callback is unregistering itself. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Threading/PeriodicTimer.xml b/xml/System.Threading/PeriodicTimer.xml index 64559bbc7c5..4d34445f512 100644 --- a/xml/System.Threading/PeriodicTimer.xml +++ b/xml/System.Threading/PeriodicTimer.xml @@ -140,7 +140,9 @@ This timer is intended to be used only by a single consumer at a time: only one The behaves like an auto-reset event, in that multiple ticks are coalesced into a single tick if they occur between calls to . Similarly, a call to will void any tick not yet consumed. may only be used by one consumer at a time, and may be used concurrently with a single call to . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Threading/SemaphoreSlim.xml b/xml/System.Threading/SemaphoreSlim.xml index 687428949de..7670aa8e0e1 100644 --- a/xml/System.Threading/SemaphoreSlim.xml +++ b/xml/System.Threading/SemaphoreSlim.xml @@ -999,7 +999,7 @@ The that created Asynchronously waits to enter the . A task that will complete when the semaphore has been entered. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The has been disposed. @@ -1050,7 +1050,9 @@ The that created + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The current instance has already been disposed. @@ -1100,7 +1102,7 @@ The that created The token to observe. Asynchronously waits to enter the , while observing a . A task that will complete when the semaphore has been entered. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The current instance has already been disposed. was canceled. @@ -1153,7 +1155,9 @@ The that created + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The current instance has already been disposed. @@ -1213,7 +1217,9 @@ The that created + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is a number other than -1, which represents an infinite timeout. @@ -1275,7 +1281,9 @@ The that created + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is a negative number other than -1, which represents an infinite timeout. diff --git a/xml/System.Threading/Timer.xml b/xml/System.Threading/Timer.xml index f202ea46f53..89028c2882f 100644 --- a/xml/System.Threading/Timer.xml +++ b/xml/System.Threading/Timer.xml @@ -1051,7 +1051,7 @@ Sub TimerCallback(state As Object) Releases all resources used by the current instance of . A that completes when all work associated with the timer has ceased. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Web.Caching/OutputCacheProviderAsync.xml b/xml/System.Web.Caching/OutputCacheProviderAsync.xml index 3ab68bf1d78..078d65c57d6 100644 --- a/xml/System.Web.Caching/OutputCacheProviderAsync.xml +++ b/xml/System.Web.Caching/OutputCacheProviderAsync.xml @@ -61,7 +61,7 @@ The time and date on which the cached entry expires. Asynchronously inserts the specified entry into the output cache. The specified entry. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -86,7 +86,7 @@ A unique identifier for a cached entry in the output cache. Asynchronously returns a reference to the specified entry in the output cache. The value that identifies the specified entry in the cache, or if the specified entry is not in the cache. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -111,7 +111,7 @@ The unique identifier for the entry to remove from the output cache. Asynchronously removes the specified entry from the output cache. The status of the operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -140,7 +140,7 @@ The time and date on which the cached expires. Asynchronously Inserts the specified entry into the output cache, overwriting the entry if it is already cached. The status of the operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Web.Services.Protocols/HttpSimpleClientProtocol.xml b/xml/System.Web.Services.Protocols/HttpSimpleClientProtocol.xml index 12edad4720f..e656c5a7553 100644 --- a/xml/System.Web.Services.Protocols/HttpSimpleClientProtocol.xml +++ b/xml/System.Web.Services.Protocols/HttpSimpleClientProtocol.xml @@ -283,7 +283,7 @@ The parameters to pass to the method. The delegate called when the method invocation has completed. Invokes the specified method asynchronously. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -316,7 +316,7 @@ The delegate called when the method invocation has completed. An object containing associated state information that is passed to the delegate when the method has completed. Invokes the specified method asynchronously while maintaining an associated state. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Web.Services.Protocols/HttpWebClientProtocol.xml b/xml/System.Web.Services.Protocols/HttpWebClientProtocol.xml index 0d46f02271e..6251ebe7700 100644 --- a/xml/System.Web.Services.Protocols/HttpWebClientProtocol.xml +++ b/xml/System.Web.Services.Protocols/HttpWebClientProtocol.xml @@ -139,7 +139,7 @@ The object provided in the last parameter to the asynchronous call of the method. Cancels an asynchronous call to an XML Web service method, unless the call has already completed. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Web.Services.Protocols/SoapHttpClientProtocol.xml b/xml/System.Web.Services.Protocols/SoapHttpClientProtocol.xml index b6a00c3c5ae..b249b004420 100644 --- a/xml/System.Web.Services.Protocols/SoapHttpClientProtocol.xml +++ b/xml/System.Web.Services.Protocols/SoapHttpClientProtocol.xml @@ -472,7 +472,7 @@ The proxy class does not have a binding defined. The parameters to pass to the method. The delegate called when the method invocation has completed. Invokes the specified method asynchronously. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -504,7 +504,7 @@ The proxy class does not have a binding defined. The delegate called when the method invocation has completed. An object used to pass state information into the delegate. Invokes the specified method asynchronously. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Web.SessionState/ISessionStateModule.xml b/xml/System.Web.SessionState/ISessionStateModule.xml index e6287636337..6c636f28e8f 100644 --- a/xml/System.Web.SessionState/ISessionStateModule.xml +++ b/xml/System.Web.SessionState/ISessionStateModule.xml @@ -65,7 +65,7 @@ The for which to release the session state. Asynchronously releases the session state for the specified . A for the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Web.SessionState/SessionStateModule.xml b/xml/System.Web.SessionState/SessionStateModule.xml index 10d1bbfabe1..e2139513310 100644 --- a/xml/System.Web.SessionState/SessionStateModule.xml +++ b/xml/System.Web.SessionState/SessionStateModule.xml @@ -276,7 +276,7 @@ public void Session_OnEnd() The for which to release the session state. Asynchronously releases the session state for the specified . A for the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Web.UI/Page.xml b/xml/System.Web.UI/Page.xml index 9ad5842aa45..83b91fdfb77 100644 --- a/xml/System.Web.UI/Page.xml +++ b/xml/System.Web.UI/Page.xml @@ -233,7 +233,9 @@ [!code-aspx-csharp[PageAddOnPreRenderCompleteAsync#1](~/snippets/csharp/VS_Snippets_WebNet/PageAddOnPreRenderCompleteAsync/CS/pageaddonprerendercompleteasynccs.aspx#1)] [!code-aspx-vb[PageAddOnPreRenderCompleteAsync#1](~/snippets/visualbasic/VS_Snippets_WebNet/PageAddOnPreRenderCompleteAsync/VB/pageaddonprerendercompleteasyncvb.aspx#1)] - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The page directive is not set to . @@ -297,7 +299,9 @@ [!code-aspx-csharp[PageAddOnPreRenderCompleteAsync#1](~/snippets/csharp/VS_Snippets_WebNet/PageAddOnPreRenderCompleteAsync/CS/pageaddonprerendercompleteasynccs.aspx#1)] [!code-aspx-vb[PageAddOnPreRenderCompleteAsync#1](~/snippets/visualbasic/VS_Snippets_WebNet/PageAddOnPreRenderCompleteAsync/VB/pageaddonprerendercompleteasyncvb.aspx#1)] - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The page directive is not set to . diff --git a/xml/System.Web.WebSockets/AspNetWebSocket.xml b/xml/System.Web.WebSockets/AspNetWebSocket.xml index 8cf86d3b2b1..c774acffe34 100644 --- a/xml/System.Web.WebSockets/AspNetWebSocket.xml +++ b/xml/System.Web.WebSockets/AspNetWebSocket.xml @@ -81,7 +81,9 @@ For server-initiated requests, the two methods work differently. The method sends a message to the client to close the connection, waits for a response, and then returns. The server does not wait for any additional data sent by the client. In contrast, the method sends a message to the client to close the connection and returns without waiting for a response. After the method returns, you can call the method and handle either additional data or the acknowledgment that the client sends. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The object was previously disposed. The object is in an aborted state. @@ -129,7 +131,9 @@ For server-initiated requests, the two methods work differently. The method sends a message to the client to close the connection, waits for a response, and then returns. The server does not wait for any additional data sent by the client. In contrast, the method sends a message to the client to close the connection and returns without waiting for a response. After the method returns, you can call the method and handle either additional data or the acknowledgment that the client sends. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The object was previously disposed. The object is in an aborted state. @@ -235,7 +239,7 @@ The object that cancels a pending operation. Receives a single message fragment from a remote client. A reference to the task of receiving a message. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The object was previously disposed. The object is in an aborted state. @@ -273,7 +277,7 @@ The object that cancels a pending operation. Sends a single message fragment to a remote client. A reference to the task of sending a message. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The object is disposed. The object is in an aborted state. diff --git a/xml/System.Web/HttpApplication.xml b/xml/System.Web/HttpApplication.xml index e9359e3c0a1..6699e7bf255 100644 --- a/xml/System.Web/HttpApplication.xml +++ b/xml/System.Web/HttpApplication.xml @@ -261,7 +261,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -290,7 +290,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -333,7 +333,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -362,7 +362,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -405,7 +405,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -434,7 +434,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -477,7 +477,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -506,7 +506,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -549,7 +549,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -578,7 +578,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -628,7 +628,9 @@ ## Remarks is introduced in the .NET Framework version 3.5. For more information, see [Versions and Dependencies](/dotnet/framework/migration-guide/versions-and-dependencies). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -658,7 +660,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -708,7 +710,9 @@ ## Remarks is introduced in the .NET Framework version 3.5. For more information, see [Versions and Dependencies](/dotnet/framework/migration-guide/versions-and-dependencies). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -738,7 +742,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -780,7 +784,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -809,7 +813,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -851,7 +855,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -880,7 +884,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -922,7 +926,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -951,7 +955,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1001,7 +1005,9 @@ ## Remarks is introduced in the .NET Framework version 3.5. For more information, see [Versions and Dependencies](/dotnet/framework/migration-guide/versions-and-dependencies). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1031,7 +1037,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1073,7 +1079,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1102,7 +1108,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous collection. Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1144,7 +1150,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1173,7 +1179,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1216,7 +1222,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1245,7 +1251,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1287,7 +1293,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1316,7 +1322,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1358,7 +1364,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1387,7 +1393,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1430,7 +1436,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1459,7 +1465,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous collection. Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1502,7 +1508,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1531,7 +1537,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1574,7 +1580,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event handler to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1603,7 +1609,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event handler to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1646,7 +1652,7 @@ The that starts asynchronous processing of the . The that ends asynchronous processing of the . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1675,7 +1681,7 @@ The that ends asynchronous processing of the . The associated state to add to the asynchronous . Adds the specified event to the collection of asynchronous event handlers for the current request. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Web/HttpResponse.xml b/xml/System.Web/HttpResponse.xml index e9a2e4165a0..ca8d32ffb6c 100644 --- a/xml/System.Web/HttpResponse.xml +++ b/xml/System.Web/HttpResponse.xml @@ -1537,7 +1537,7 @@ Asynchronously sends all currently buffered output to the client. A that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Web/HttpResponseBase.xml b/xml/System.Web/HttpResponseBase.xml index de0dff73f99..46ffa25d1f1 100644 --- a/xml/System.Web/HttpResponseBase.xml +++ b/xml/System.Web/HttpResponseBase.xml @@ -1137,7 +1137,7 @@ Asynchronously sends all currently buffered output to the client. The task the represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Web/HttpResponseWrapper.xml b/xml/System.Web/HttpResponseWrapper.xml index 82aa1912b55..5cd6a7bb88a 100644 --- a/xml/System.Web/HttpResponseWrapper.xml +++ b/xml/System.Web/HttpResponseWrapper.xml @@ -1102,7 +1102,7 @@ Asynchronously sends all currently buffered output to the client. A object that represents the asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Web/HttpTaskAsyncHandler.xml b/xml/System.Web/HttpTaskAsyncHandler.xml index 22f6f92f26c..60b6596731b 100644 --- a/xml/System.Web/HttpTaskAsyncHandler.xml +++ b/xml/System.Web/HttpTaskAsyncHandler.xml @@ -136,7 +136,9 @@ ## Remarks To create a custom handler for an asynchronous task, override the method. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Windows.Annotations/AnnotationDocumentPaginator.xml b/xml/System.Windows.Annotations/AnnotationDocumentPaginator.xml index 8053004a85e..856c2ddff43 100644 --- a/xml/System.Windows.Annotations/AnnotationDocumentPaginator.xml +++ b/xml/System.Windows.Annotations/AnnotationDocumentPaginator.xml @@ -243,7 +243,7 @@ The unique application-defined identifier passed in the call to start the asynchronous operation. Cancels all asynchronous operations initiated with a given object. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -314,7 +314,9 @@ ## Remarks The `userState` parameter is intended for use with method if the application wishes to cancel the asynchronous operation before completion. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -385,7 +387,9 @@ ## Remarks The `userState` parameter is intended for use with method if the application wishes to cancel the asynchronous operation before completion. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Windows.Documents.Serialization/SerializerWriter.xml b/xml/System.Windows.Documents.Serialization/SerializerWriter.xml index 6a325afd7f3..1f688e6562f 100644 --- a/xml/System.Windows.Documents.Serialization/SerializerWriter.xml +++ b/xml/System.Windows.Documents.Serialization/SerializerWriter.xml @@ -97,7 +97,7 @@ When overridden in a derived class, cancels an asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -782,7 +782,9 @@ ## Remarks The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -822,7 +824,9 @@ ## Remarks The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -862,7 +866,9 @@ ## Remarks The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -902,7 +908,9 @@ ## Remarks The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -942,7 +950,9 @@ ## Remarks The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -986,7 +996,9 @@ The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1038,7 +1050,9 @@ The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1082,7 +1096,9 @@ The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1134,7 +1150,9 @@ The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1178,7 +1196,9 @@ The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1230,7 +1250,9 @@ The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1274,7 +1296,9 @@ The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1326,7 +1350,9 @@ The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1370,7 +1396,9 @@ The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1420,7 +1448,9 @@ The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1476,7 +1506,9 @@ The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1532,7 +1564,9 @@ The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1588,7 +1622,9 @@ The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1644,7 +1680,9 @@ The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1700,7 +1738,9 @@ The output of the write operation is normally specified as a parameter to the constructor of the derived class that implements . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Windows.Documents.Serialization/SerializerWriterCollator.xml b/xml/System.Windows.Documents.Serialization/SerializerWriterCollator.xml index b5d32bb3b35..8e92b5c39c9 100644 --- a/xml/System.Windows.Documents.Serialization/SerializerWriterCollator.xml +++ b/xml/System.Windows.Documents.Serialization/SerializerWriterCollator.xml @@ -133,7 +133,7 @@ When overridden in a derived class, cancels an asynchronous operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -314,7 +314,9 @@ ## Remarks The methods write to the stream associated with the that created the from the call to . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -355,7 +357,9 @@ `userState` is passed to the when the event occurs. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -402,7 +406,9 @@ `printTicket` can be `null` if there are no preferred print settings. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -453,7 +459,9 @@ `userState` is passed to the when the event occurs. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Windows.Documents/DocumentPaginator.xml b/xml/System.Windows.Documents/DocumentPaginator.xml index 788df56e404..02ec896566d 100644 --- a/xml/System.Windows.Documents/DocumentPaginator.xml +++ b/xml/System.Windows.Documents/DocumentPaginator.xml @@ -87,7 +87,9 @@ ## Remarks If `userState` is `null`, then all asynchronous tasks are cancelled. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -166,7 +168,9 @@ ## Remarks The only way to cancel the asynchronous operation of this method is to cancel all asynchronous operations. Contrast this with the other overload of this method: . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -203,7 +207,9 @@ This overload of the method makes it possible to cancel this asynchronous operation without cancelling all asynchronous operations. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -320,7 +326,9 @@ This method raises the event. The is passed to the event as one of the event arguments. See for how to use this method to get the page. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is negative. @@ -373,7 +381,9 @@ 5. Call to retrieve the formatted . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is negative. diff --git a/xml/System.Windows.Documents/DynamicDocumentPaginator.xml b/xml/System.Windows.Documents/DynamicDocumentPaginator.xml index ca5d4ab4132..117838b1a2f 100644 --- a/xml/System.Windows.Documents/DynamicDocumentPaginator.xml +++ b/xml/System.Windows.Documents/DynamicDocumentPaginator.xml @@ -187,7 +187,9 @@ This method raises the event. The page number is passed to the event as one of the event arguments. See for how to use this method to get the page number. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -240,7 +242,9 @@ provides similar functionality as , but for synchronous operation. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Windows.Documents/PageContent.xml b/xml/System.Windows.Documents/PageContent.xml index 6665e0dd093..cc012c98c77 100644 --- a/xml/System.Windows.Documents/PageContent.xml +++ b/xml/System.Windows.Documents/PageContent.xml @@ -234,7 +234,9 @@ For more information about the `` element, see chapter 3 of the XPS specification which you can obtain at [XPS: Specification and License Downloads](https://www.microsoft.com/whdc/xps/downloads.mspx). - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Windows.Forms/PictureBox.xml b/xml/System.Windows.Forms/PictureBox.xml index 12a80bdd104..7bc6eac6576 100644 --- a/xml/System.Windows.Forms/PictureBox.xml +++ b/xml/System.Windows.Forms/PictureBox.xml @@ -262,7 +262,9 @@ :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/PictureBox/CancelAsync/Form1.cs" id="Snippet4"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.TreeViewPictureBoxWhidbeyMembers/VB/Form1.vb" id="Snippet4"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1251,7 +1253,9 @@ ## Remarks Besides calling the method, the property must be set to `false` to load an image asynchronously. When you load an image asynchronously, you can handle the event to determine the progress of an image load or the event to determine when an image load has completed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1294,7 +1298,9 @@ :::code language="csharp" source="~/snippets/csharp/System.Windows.Forms/PictureBox/CancelAsync/Form1.cs" id="Snippet3"::: :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_Winforms/System.Windows.Forms.TreeViewPictureBoxWhidbeyMembers/VB/Form1.vb" id="Snippet3"::: - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Windows.Markup/XamlReader.xml b/xml/System.Windows.Markup/XamlReader.xml index 4996cdbf433..57d9d50c652 100644 --- a/xml/System.Windows.Markup/XamlReader.xml +++ b/xml/System.Windows.Markup/XamlReader.xml @@ -123,7 +123,9 @@ ## Remarks is an asynchronous operation; therefore, some loading may occur before the operation is aborted. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -456,7 +458,9 @@ Only one asynchronous load operation per instance of the class can be performed at a time. If more than one asynchronous operation is attempted on the same instance of the class an is thrown. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -502,7 +506,9 @@ Only one asynchronous load operation per instance of the class can be performed at a time. If more than one asynchronous operation is attempted on the same instance of the class an is thrown. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -536,7 +542,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -579,7 +585,9 @@ Only one asynchronous load operation per instance of the class can be performed at a time. If more than one asynchronous operation is attempted on the same instance of the class an is thrown. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> is . @@ -613,7 +621,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -644,7 +652,7 @@ To be added. To be added. To be added. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Windows.Threading/Dispatcher.xml b/xml/System.Windows.Threading/Dispatcher.xml index 7793c2140d4..022a38731eb 100644 --- a/xml/System.Windows.Threading/Dispatcher.xml +++ b/xml/System.Windows.Threading/Dispatcher.xml @@ -1854,7 +1854,9 @@ The default priority is `DispatcherPriority.Send`. The default priority is `DispatcherPriority.Normal`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1885,7 +1887,7 @@ The default priority is `DispatcherPriority.Normal`. The priority that determines the order in which the specified callback is invoked relative to the other pending operations in the . Executes the specified asynchronously at the specified priority on the thread the is associated with. An object, which is returned immediately after is called, that can be used to interact with the delegate as it is pending execution in the event queue. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1923,7 +1925,7 @@ The default priority is `DispatcherPriority.Normal`. An object that indicates whether to cancel the action. Executes the specified asynchronously at the specified priority on the thread the is associated with. An object, which is returned immediately after is called, that can be used to interact with the delegate as it is pending execution in the event queue. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Windows.Xps.Serialization/XpsSerializationManagerAsync.xml b/xml/System.Windows.Xps.Serialization/XpsSerializationManagerAsync.xml index 1d5ddd67777..855c066f60d 100644 --- a/xml/System.Windows.Xps.Serialization/XpsSerializationManagerAsync.xml +++ b/xml/System.Windows.Xps.Serialization/XpsSerializationManagerAsync.xml @@ -81,7 +81,7 @@ Cancels an asynchronous serialization operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Windows.Xps/VisualsToXpsDocument.xml b/xml/System.Windows.Xps/VisualsToXpsDocument.xml index a920d175b4a..6b7049ef62c 100644 --- a/xml/System.Windows.Xps/VisualsToXpsDocument.xml +++ b/xml/System.Windows.Xps/VisualsToXpsDocument.xml @@ -154,7 +154,9 @@ ## Remarks For example, an exception is thrown if the method is called and a writing operation is not in progress. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> The state of the is not compatible with a operation. @@ -323,7 +325,7 @@ The that is written. Writes a asynchronously to an or a . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -353,7 +355,7 @@ The that is written. An object that contains data that the caller wants to pass to the event handler. Writes a asynchronously to an or a and includes additional information that the caller wants to pass to an event handler. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -395,7 +397,9 @@ ## Remarks This method does not validate or modify the specified `printTicket` for a particular . If necessary, use the method to create a that is specific to the and is valid for a specified printer. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -440,7 +444,9 @@ ## Remarks This method does not validate or modify the specified `printTicket` for a particular . If necessary, use the method to create a that is specific to the and is valid for a specified printer. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Windows.Xps/XpsDocumentWriter.xml b/xml/System.Windows.Xps/XpsDocumentWriter.xml index 3eddcde6295..7cb21abc1c3 100644 --- a/xml/System.Windows.Xps/XpsDocumentWriter.xml +++ b/xml/System.Windows.Xps/XpsDocumentWriter.xml @@ -65,7 +65,7 @@ Cancels the current operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . No asynchronous write operation is in progress. @@ -902,7 +902,9 @@ By design, this `Write` method does not raise the method does not call the event. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -946,7 +948,9 @@ By design, this `Write` method does not raise the + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -995,7 +999,9 @@ By design, this `Write` method does not raise the + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1044,7 +1050,9 @@ By design, this `Write` method does not raise the + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1079,7 +1087,7 @@ By design, this `Write` method does not raise the The page that is written. Writes asynchronously a specified to the target or . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1127,7 +1135,9 @@ By design, this `Write` method does not raise the + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1178,7 +1188,9 @@ By design, this `Write` method does not raise the method does not call the event. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1215,7 +1227,7 @@ By design, this `Write` method does not raise the An object that contains a pointer to unpaginated source material; also contains methods for paginating the material. A user-specified object to identify and associate with the asynchronous operation. Writes asynchronously paginated content from a specified to the target or . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1257,7 +1269,9 @@ By design, this `Write` method does not raise the . If necessary, use the method to create a that is specific to the and is valid for a specified printer. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1300,7 +1314,9 @@ By design, this `Write` method does not raise the class has a singular name, an can be one or a set of multiple documents. This method adds a to the set. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1345,7 +1361,9 @@ By design, this `Write` method does not raise the . If necessary, use the method to create a that is specific to the and is valid for a specified printer. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1388,7 +1406,9 @@ By design, this `Write` method does not raise the class has a singular name, an can be one or a set of multiple documents. This method adds a or a set of elements to the existing set. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1433,7 +1453,9 @@ By design, this `Write` method does not raise the . If necessary, use the method to create a that is specific to the and is valid for a specified printer. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1470,7 +1492,7 @@ By design, this `Write` method does not raise the The page that is written. A user-specified object to identify and associate with the asynchronous operation. Writes asynchronously a specified to the target or . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1512,7 +1534,9 @@ By design, this `Write` method does not raise the . If necessary, use the method to create a that is specific to the and is valid for a specified printer. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1555,7 +1579,9 @@ By design, this `Write` method does not raise the , use . - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1600,7 +1626,9 @@ By design, this `Write` method does not raise the . If necessary, use the method to create a that is specific to the and is valid for a specified printer. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1645,7 +1673,9 @@ By design, this `Write` method does not raise the . If necessary, use the method to create a that is specific to the and is valid for a specified printer. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1692,7 +1722,9 @@ By design, this `Write` method does not raise the . If necessary, use the method to create a that is specific to the and is valid for a specified printer. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1741,7 +1773,9 @@ By design, this `Write` method does not raise the . If necessary, use the method to create a that is specific to the and is valid for a specified printer. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1786,7 +1820,9 @@ By design, this `Write` method does not raise the . If necessary, use the method to create a that is specific to the and is valid for a specified printer. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1833,7 +1869,9 @@ By design, this `Write` method does not raise the . If necessary, use the method to create a that is specific to the and is valid for a specified printer. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> diff --git a/xml/System.Xml.Linq/XCData.xml b/xml/System.Xml.Linq/XCData.xml index f558db0b3a5..a50b50d1cb5 100644 --- a/xml/System.Xml.Linq/XCData.xml +++ b/xml/System.Xml.Linq/XCData.xml @@ -393,7 +393,7 @@ Text A token that can be used to request cancellation of the asynchronous operation. Writes this to the given . A task representing the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Xml.Linq/XComment.xml b/xml/System.Xml.Linq/XComment.xml index 95ab7c911bf..47a1da6c3ea 100644 --- a/xml/System.Xml.Linq/XComment.xml +++ b/xml/System.Xml.Linq/XComment.xml @@ -418,7 +418,7 @@ This is a comment A token that can be used to request cancellation of the asynchronous operation. Writes this to the specified . A task that represents the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Xml.Linq/XDocument.xml b/xml/System.Xml.Linq/XDocument.xml index c16f78740ba..dced1af261b 100644 --- a/xml/System.Xml.Linq/XDocument.xml +++ b/xml/System.Xml.Linq/XDocument.xml @@ -1771,7 +1771,9 @@ Root 1 2 If is set, the underlying property is set to `false`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1820,7 +1822,9 @@ If is set, the property is set to `false`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -1862,7 +1866,7 @@ If A cancellation token. Creates a new containing the contents of the specified . A new XDocument containing the contents of the specified . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -2962,7 +2966,7 @@ Console.WriteLine(File.ReadAllText("Root2.xml")) A cancellation token. Writes this to an . A task representing the asynchronous save operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -3010,7 +3014,9 @@ Console.WriteLine(File.ReadAllText("Root2.xml")) If is set, the output is not indented. If is set, duplicate namespace declarations will be removed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -3059,7 +3065,9 @@ If is set, the output is not indented. If is set, duplicate namespace declarations will be removed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -3193,7 +3201,7 @@ Console.WriteLine(sb.ToString()) A cancellation token. Writes this XDocument's underlying XML tree to the specified . A task representing the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Xml.Linq/XDocumentType.xml b/xml/System.Xml.Linq/XDocumentType.xml index fc7a0b1e6d5..059867c8ac2 100644 --- a/xml/System.Xml.Linq/XDocumentType.xml +++ b/xml/System.Xml.Linq/XDocumentType.xml @@ -909,7 +909,7 @@ SystemId:Pubs.dtd A token that can be used to request cancellation of the asynchronous operation. Writes this to the specified . A task representing the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Xml.Linq/XElement.xml b/xml/System.Xml.Linq/XElement.xml index e772aaa2775..11e9b8598a3 100644 --- a/xml/System.Xml.Linq/XElement.xml +++ b/xml/System.Xml.Linq/XElement.xml @@ -3871,7 +3871,9 @@ Root 1 2 If `options` is set to , then the property is set to `false`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -3920,7 +3922,9 @@ If `options` is set to , th If `options` is set to , then the property is set to `false`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> @@ -3962,7 +3966,7 @@ If `options` is set to , th A token that can be used to request cancellation of the asynchronous operation. Asynchronously creates a new and initializes its underlying XML tree using the specified XML reader, optionally preserving white space. A new containing the contents of the specified reader. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -7954,7 +7958,7 @@ Console.WriteLine(str) A token that can be used to request cancellation of the asynchronous operation. Asynchronously outputs this to an . A task representing the asynchronous save operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -7995,7 +7999,7 @@ Console.WriteLine(str) A token that can be used to request cancellation of the asynchronous operation. Asynchronously outputs this to a . A task representing the asynchronous save operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -8036,7 +8040,7 @@ Console.WriteLine(str) A token that can be used to request cancellation of the asynchronous operation. Asynchronously outputs this to a . A task representing the asynchronous save operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -8743,7 +8747,7 @@ Console.WriteLine(sb.ToString()) A token that can be used to request cancellation of the asynchronous operation. Asynchronously writes this to the specified writer. A task representing the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Xml.Linq/XNode.xml b/xml/System.Xml.Linq/XNode.xml index 157c8b6e35e..82f811b18ae 100644 --- a/xml/System.Xml.Linq/XNode.xml +++ b/xml/System.Xml.Linq/XNode.xml @@ -2797,7 +2797,7 @@ ccc A token that can be used to request cancellation of the asynchronous operation. Creates an from an . The runtime type of the node is determined by the of the first node encountered in the reader. An XNode that contains the nodes read from the reader. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . The is not positioned on a recognized node type. @@ -3517,7 +3517,7 @@ Console.WriteLine(sb.ToString()) A token that can be used to request cancellation of the asynchronous operation. Writes the current node to an . A task representing the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Xml.Linq/XProcessingInstruction.xml b/xml/System.Xml.Linq/XProcessingInstruction.xml index f54851b709e..8706481eef2 100644 --- a/xml/System.Xml.Linq/XProcessingInstruction.xml +++ b/xml/System.Xml.Linq/XProcessingInstruction.xml @@ -488,7 +488,7 @@ xml-stylesheet A token that can be used to request cancellation of the asynchronous operation. Writes this to the specified . A task representing the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Xml.Linq/XText.xml b/xml/System.Xml.Linq/XText.xml index 926a076d4dd..60e1357401e 100644 --- a/xml/System.Xml.Linq/XText.xml +++ b/xml/System.Xml.Linq/XText.xml @@ -474,7 +474,7 @@ Newer text A token that can be used to request cancellation of the asynchronous operation. Asynchronously writes this to the specified . A task representing the asynchronous write operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Xml.Resolvers/XmlPreloadedResolver.xml b/xml/System.Xml.Resolvers/XmlPreloadedResolver.xml index bee8126e65b..3c653cee50d 100644 --- a/xml/System.Xml.Resolvers/XmlPreloadedResolver.xml +++ b/xml/System.Xml.Resolvers/XmlPreloadedResolver.xml @@ -600,7 +600,7 @@ The type of object to return. The supports objects and objects for URIs that were added as . If the requested type is not supported by the resolver, an exception will be thrown. Use the method to determine whether a certain is supported by this resolver. Asynchronously maps a URI to an object that contains the actual resource. A or object that corresponds to the actual source. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Xml/XmlDictionaryWriter.xml b/xml/System.Xml/XmlDictionaryWriter.xml index fbb59e8fd8a..829250ca7db 100644 --- a/xml/System.Xml/XmlDictionaryWriter.xml +++ b/xml/System.Xml/XmlDictionaryWriter.xml @@ -2173,7 +2173,9 @@ binarywriter.WriteEndAttribute(); ## Remarks To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -3029,7 +3031,9 @@ An asynchronous method was calle ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." diff --git a/xml/System.Xml/XmlReader.xml b/xml/System.Xml/XmlReader.xml index 971e3d3d6a8..219ee257196 100644 --- a/xml/System.Xml/XmlReader.xml +++ b/xml/System.Xml/XmlReader.xml @@ -2205,7 +2205,9 @@ String dt4 = reader.GetAttribute("dt",http://www.w3.org/2000/xmlns/); ## Remarks To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress". @@ -3496,7 +3498,9 @@ public class Sample ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -4147,7 +4151,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -4383,7 +4389,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -4523,7 +4531,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -4663,7 +4673,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -5303,7 +5315,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -5424,7 +5438,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -5659,7 +5675,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." -or- @@ -5803,7 +5821,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -5948,7 +5968,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -7217,7 +7239,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -7444,7 +7468,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> 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#) @@ -7840,7 +7866,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -7978,7 +8006,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> 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#) @@ -8934,7 +8964,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." -or- @@ -9243,7 +9275,9 @@ If you have to get the post-schema-validation information set (PSVI) for an elem ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." diff --git a/xml/System.Xml/XmlResolver.xml b/xml/System.Xml/XmlResolver.xml index 940de610fa9..0c4de11239f 100644 --- a/xml/System.Xml/XmlResolver.xml +++ b/xml/System.Xml/XmlResolver.xml @@ -334,7 +334,9 @@ resolver.Credentials = myCache; ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> Asynchronous programming (C#) Asynchronous programming with Async and Await (Visual Basic) diff --git a/xml/System.Xml/XmlSecureResolver.xml b/xml/System.Xml/XmlSecureResolver.xml index 04c9e3dae32..ba395de1f5d 100644 --- a/xml/System.Xml/XmlSecureResolver.xml +++ b/xml/System.Xml/XmlSecureResolver.xml @@ -543,7 +543,7 @@ See the constructor reference topics for examples of these types of restrictions The type of object to return. The current version only returns objects. Asynchronously maps a URI to an object that contains the actual resource. The stream returned by calling on the underlying . If a type other than is specified, the method returns . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Xml/XmlUrlResolver.xml b/xml/System.Xml/XmlUrlResolver.xml index f4cf3457f11..0428ab3f40f 100644 --- a/xml/System.Xml/XmlUrlResolver.xml +++ b/xml/System.Xml/XmlUrlResolver.xml @@ -368,7 +368,7 @@ resolver.Credentials = myCache; The type of object to return. The current implementation only returns objects. Asynchronously maps a URI to an object that contains the actual resource. A stream object or if a type other than stream is specified. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System.Xml/XmlWriter.xml b/xml/System.Xml/XmlWriter.xml index 17b3106493c..d9f2d27cd01 100644 --- a/xml/System.Xml/XmlWriter.xml +++ b/xml/System.Xml/XmlWriter.xml @@ -1217,7 +1217,7 @@ An method was called before a previous asy Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously. A task that represents the asynchronous dispose operation. - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . @@ -1353,7 +1353,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -1650,7 +1652,9 @@ This member may behave differently when it is used in a Portable Class Library p ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -1988,7 +1992,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -2123,7 +2129,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -2263,7 +2271,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -2385,7 +2395,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -2502,7 +2514,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -2637,7 +2651,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -2761,7 +2777,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -2902,7 +2920,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -3204,7 +3224,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -3314,7 +3336,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -3430,7 +3454,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -3550,7 +3576,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -3669,7 +3697,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -3782,7 +3812,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -3899,7 +3931,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -4014,7 +4048,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -4311,7 +4347,9 @@ while (!reader.EOF){ ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -4374,7 +4412,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -4515,7 +4555,9 @@ writer.Close(); ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -4665,7 +4707,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -4897,7 +4941,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -4958,7 +5004,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -5234,7 +5282,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -5451,7 +5501,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -5508,7 +5560,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -5813,7 +5867,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -5994,7 +6050,9 @@ test<item>test ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -6116,7 +6174,9 @@ An asynchronous method was called without ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." @@ -6885,7 +6945,9 @@ An method was called before a previous asy ## Remarks This is the asynchronous version of , with the same functionality. To use this method, you must set the flag to `true`. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]> An method was called before a previous asynchronous operation finished. In this case, is thrown with the message "An asynchronous operation is already in progress." diff --git a/xml/System/BinaryData.xml b/xml/System/BinaryData.xml index 45e56c03a39..27a4eda2678 100644 --- a/xml/System/BinaryData.xml +++ b/xml/System/BinaryData.xml @@ -389,7 +389,7 @@ A token that may be used to cancel the operation. Creates a instance from the specified stream. The stream is not disposed by this method. A value representing all of the data remaining in . - To be added. + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . diff --git a/xml/System/IAsyncDisposable.xml b/xml/System/IAsyncDisposable.xml index 41296aa311f..fbcda3568e8 100644 --- a/xml/System/IAsyncDisposable.xml +++ b/xml/System/IAsyncDisposable.xml @@ -104,7 +104,9 @@ When implementing this method, ensure that all held resources are freed by propa If an object's `DisposeAsync` method is called more than once, the object must ignore all calls after the first one and synchronously return a successfully completed . The object must not throw an exception if its `DisposeAsync` method is called multiple times. Instance methods other than `DisposeAsync` can throw an when resources are already disposed. - ]]> + This method stores all the exceptions that its synchronous counterpart can throw in the task it returns. If an exception is stored during execution, it will be thrown when you await either this method or the task it returns. For the stored exceptions, see the exceptions thrown by . + +]]>