From 95d4d78a2fe3cf57568521e0d1b93d25b7ccec25 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Thu, 29 Dec 2022 10:50:45 -0800
Subject: [PATCH 1/2] add exception remarks to async methods
---
.../DistributedCacheExtensions.xml | 16 +-
.../IDistributedCache.xml | 16 +-
.../MemoryDistributedCache.xml | 16 +-
.../RedisCache.xml | 16 +-
.../SqlServerCache.xml | 16 +-
.../RedisCache.xml | 8 +-
.../AsyncServiceScope.xml | 2 +-
.../ServiceProvider.xml | 2 +-
.../HealthCheckService.xml | 4 +-
.../IHealthCheck.xml | 2 +-
.../IHealthCheckPublisher.xml | 2 +-
.../ConsoleLifetime.xml | 4 +
.../SystemdLifetime.xml | 4 +-
.../WindowsServiceLifetime.xml | 4 +-
.../BackgroundService.xml | 8 +-
...stingAbstractionsHostBuilderExtensions.xml | 2 +-
.../HostingAbstractionsHostExtensions.xml | 6 +-
.../HostingHostBuilderExtensions.xml | 10 +-
xml/Microsoft.Extensions.Hosting/IHost.xml | 4 +-
.../IHostLifetime.xml | 4 +-
.../IHostedService.xml | 4 +-
.../LoggingHttpMessageHandler.xml | 4 +-
.../LoggingScopeHttpMessageHandler.xml | 4 +-
.../PolicyHttpMessageHandler.xml | 6 +-
.../AzureBlobSink.xml | 2 +-
.../BatchingLoggerProvider.xml | 4 +-
.../BlobAppendReferenceWrapper.xml | 6 +
.../BlobLoggerProvider.xml | 8 +-
.../FileLoggerProvider.xml | 2 +-
.../ICloudAppendBlob.xml | 6 +
.../BatchingLoggerProvider.xml | 2 +-
.../IMonoSslStream.xml | 8 +-
xml/System.Activities/WorkflowInvoker.xml | 36 ++-
.../IndentedTextWriter.xml | 30 +--
.../IAsyncEnumerator`1.xml | 2 +-
.../ICommandHandler.xml | 2 +-
.../ParseResultExtensions.xml | 2 +-
.../ParserExtensions.xml | 4 +-
xml/System.CommandLine/CommandExtensions.xml | 4 +-
.../BackgroundWorker.xml | 12 +-
xml/System.Data.Common/DbBatch.xml | 24 +-
xml/System.Data.Common/DbCommand.xml | 44 +++-
xml/System.Data.Common/DbConnection.xml | 38 +++-
xml/System.Data.Common/DbDataReader.xml | 36 ++-
xml/System.Data.Common/DbDataSource.xml | 12 +-
xml/System.Data.Common/DbTransaction.xml | 18 +-
.../SqlAuthenticationProvider.xml | 2 +-
xml/System.Data.SqlClient/SqlBulkCopy.xml | 38 +++-
xml/System.Data.SqlClient/SqlCommand.xml | 34 ++-
xml/System.Data.SqlClient/SqlConnection.xml | 4 +-
xml/System.Data.SqlClient/SqlDataReader.xml | 12 +-
xml/System.Data/DataReaderExtensions.xml | 4 +-
.../CivicAddressResolver.xml | 4 +-
.../ICivicAddressResolver.xml | 4 +-
xml/System.Diagnostics/Process.xml | 4 +-
xml/System.Formats.Tar/TarEntry.xml | 1 +
xml/System.Formats.Tar/TarFile.xml | 6 +-
xml/System.Formats.Tar/TarReader.xml | 4 +-
xml/System.Formats.Tar/TarWriter.xml | 8 +-
xml/System.IO.Compression/BrotliStream.xml | 7 +-
xml/System.IO.Compression/DeflateStream.xml | 28 ++-
xml/System.IO.Compression/GZipStream.xml | 28 ++-
xml/System.IO.Compression/ZLibStream.xml | 14 +-
.../NonCryptographicHashAlgorithm.xml | 2 +-
.../IsolatedStorageFileStream.xml | 16 +-
xml/System.IO.Pipelines/PipeReader.xml | 12 +-
xml/System.IO.Pipelines/PipeWriter.xml | 8 +-
.../StreamPipeExtensions.xml | 2 +-
xml/System.IO.Pipes/NamedPipeClientStream.xml | 10 +-
xml/System.IO.Pipes/NamedPipeServerStream.xml | 8 +-
xml/System.IO.Pipes/PipeStream.xml | 18 +-
xml/System.IO/BinaryWriter.xml | 2 +-
xml/System.IO/BufferedStream.xml | 26 ++-
xml/System.IO/File.xml | 32 +--
xml/System.IO/FileStream.xml | 28 ++-
xml/System.IO/MemoryStream.xml | 18 +-
xml/System.IO/RandomAccess.xml | 16 +-
xml/System.IO/Stream.xml | 64 ++++--
xml/System.IO/StreamReader.xml | 28 ++-
xml/System.IO/StreamWriter.xml | 38 +++-
xml/System.IO/StringReader.xml | 26 ++-
xml/System.IO/StringWriter.xml | 34 ++-
xml/System.IO/TextReader.xml | 28 ++-
xml/System.IO/TextWriter.xml | 52 +++--
xml/System.IO/UnmanagedMemoryStream.xml | 18 +-
.../WindowsRuntimeStorageExtensions.xml | 8 +
.../SecurityTokenProvider.xml | 24 +-
xml/System.Media/SoundPlayer.xml | 4 +-
.../HttpClientJsonExtensions.xml | 28 ++-
.../HttpContentJsonExtensions.xml | 4 +-
xml/System.Net.Http.Json/JsonContent.xml | 4 +-
xml/System.Net.Http/ByteArrayContent.xml | 12 +-
xml/System.Net.Http/CFNetworkHandler.xml | 2 +-
xml/System.Net.Http/DelegatingHandler.xml | 4 +-
xml/System.Net.Http/FormUrlEncodedContent.xml | 4 +-
xml/System.Net.Http/HttpClient.xml | 160 ++++++++++----
xml/System.Net.Http/HttpClientHandler.xml | 4 +-
xml/System.Net.Http/HttpContent.xml | 64 ++++--
xml/System.Net.Http/HttpMessageHandler.xml | 4 +-
xml/System.Net.Http/HttpMessageInvoker.xml | 4 +-
.../MessageProcessingHandler.xml | 4 +-
xml/System.Net.Http/MultipartContent.xml | 16 +-
.../MultipartFormDataContent.xml | 4 +-
xml/System.Net.Http/NSUrlSessionHandler.xml | 2 +-
xml/System.Net.Http/ReadOnlyMemoryContent.xml | 6 +-
xml/System.Net.Http/SocketsHttpHandler.xml | 2 +-
xml/System.Net.Http/StreamContent.xml | 10 +-
xml/System.Net.Http/StringContent.xml | 4 +-
xml/System.Net.Http/WinHttpHandler.xml | 2 +-
xml/System.Net.Mail/SmtpClient.xml | 24 +-
.../IPGlobalProperties.xml | 4 +-
xml/System.Net.NetworkInformation/Ping.xml | 64 ++++--
.../ContactManager.xml | 4 +-
.../Peer.xml | 8 +-
.../PeerContact.xml | 20 +-
.../PeerNearMe.xml | 8 +-
.../PeerNameResolver.xml | 16 +-
.../AuthenticatedStream.xml | 4 +-
xml/System.Net.Security/NegotiateStream.xml | 60 +++--
xml/System.Net.Security/SslStream.xml | 64 ++++--
xml/System.Net.Sockets/NetworkStream.xml | 16 +-
xml/System.Net.Sockets/Socket.xml | 122 +++++-----
.../SocketTaskExtensions.xml | 38 ++--
xml/System.Net.Sockets/TcpClient.xml | 32 ++-
xml/System.Net.Sockets/TcpListener.xml | 16 +-
xml/System.Net.Sockets/UdpClient.xml | 24 +-
xml/System.Net.WebSockets/ClientWebSocket.xml | 30 ++-
xml/System.Net.WebSockets/WebSocket.xml | 22 +-
xml/System.Net/Dns.xml | 20 +-
xml/System.Net/FileWebRequest.xml | 8 +-
xml/System.Net/HttpListener.xml | 4 +-
xml/System.Net/HttpListenerContext.xml | 16 +-
xml/System.Net/HttpListenerRequest.xml | 4 +-
xml/System.Net/WebClient.xml | 208 +++++++++++++-----
xml/System.Net/WebRequest.xml | 8 +-
.../ConfiguredAsyncDisposable.xml | 2 +-
...CancelableAsyncEnumerable`1+Enumerator.xml | 4 +-
.../JSHost.xml | 2 +-
.../CoseMultiSignMessage.xml | 4 +-
.../CoseSign1Message.xml | 4 +-
.../CoseSignature.xml | 2 +-
.../CryptoStream.xml | 26 ++-
xml/System.Security.Cryptography/HMACMD5.xml | 6 +-
xml/System.Security.Cryptography/HMACSHA1.xml | 6 +-
.../HMACSHA256.xml | 6 +-
.../HMACSHA384.xml | 6 +-
.../HMACSHA512.xml | 6 +-
.../HashAlgorithm.xml | 2 +-
xml/System.Security.Cryptography/MD5.xml | 4 +-
xml/System.Security.Cryptography/SHA1.xml | 4 +-
xml/System.Security.Cryptography/SHA256.xml | 4 +-
xml/System.Security.Cryptography/SHA384.xml | 4 +-
xml/System.Security.Cryptography/SHA512.xml | 4 +-
.../WindowsIdentity.xml | 2 +-
.../WorkflowControlClient.xml | 36 +--
.../WorkflowUpdateableControlClient.xml | 40 ++--
.../MetadataExchangeClient.xml | 8 +-
.../AnnouncementClient.xml | 12 +-
.../DiscoveryClient.xml | 28 ++-
xml/System.ServiceModel/ChannelFactory.xml | 2 +-
xml/System.ServiceModel/ClientBase`1.xml | 8 +-
.../SpeechRecognitionEngine.xml | 24 +-
.../SpeechRecognizer.xml | 16 +-
.../SpeechSynthesizer.xml | 16 +-
xml/System.Text.Json/JsonDocument.xml | 2 +-
xml/System.Text.Json/JsonSerializer.xml | 12 +-
xml/System.Text.Json/Utf8JsonWriter.xml | 8 +-
.../ChannelReader`1.xml | 8 +-
.../ChannelWriter`1.xml | 4 +-
xml/System.Threading.Tasks/Task.xml | 6 +-
xml/System.Threading.Tasks/TaskFactory.xml | 20 +-
xml/System.Threading.Tasks/TaskFactory`1.xml | 14 +-
xml/System.Threading.Tasks/Task`1.xml | 6 +-
.../CancellationTokenRegistration.xml | 4 +-
xml/System.Threading/PeriodicTimer.xml | 4 +-
xml/System.Threading/SemaphoreSlim.xml | 20 +-
xml/System.Threading/Timer.xml | 2 +-
.../OutputCacheProviderAsync.xml | 8 +-
.../HttpSimpleClientProtocol.xml | 4 +-
.../HttpWebClientProtocol.xml | 2 +-
.../SoapHttpClientProtocol.xml | 4 +-
.../ISessionStateModule.xml | 2 +-
.../SessionStateModule.xml | 2 +-
xml/System.Web.UI/Page.xml | 8 +-
xml/System.Web.WebSockets/AspNetWebSocket.xml | 12 +-
xml/System.Web/HttpApplication.xml | 86 ++++----
xml/System.Web/HttpResponse.xml | 2 +-
xml/System.Web/HttpResponseBase.xml | 2 +-
xml/System.Web/HttpResponseWrapper.xml | 2 +-
xml/System.Web/HttpTaskAsyncHandler.xml | 4 +-
.../AnnotationDocumentPaginator.xml | 10 +-
.../SerializerWriter.xml | 82 +++++--
.../SerializerWriterCollator.xml | 18 +-
.../DocumentPaginator.xml | 20 +-
.../DynamicDocumentPaginator.xml | 8 +-
xml/System.Windows.Documents/PageContent.xml | 4 +-
xml/System.Windows.Forms/PictureBox.xml | 12 +-
xml/System.Windows.Markup/XamlReader.xml | 22 +-
xml/System.Windows.Threading/Dispatcher.xml | 8 +-
.../XpsSerializationManagerAsync.xml | 2 +-
.../VisualsToXpsDocument.xml | 16 +-
xml/System.Windows.Xps/XpsDocumentWriter.xml | 84 +++++--
xml/System.Xml.Linq/XCData.xml | 2 +-
xml/System.Xml.Linq/XComment.xml | 2 +-
xml/System.Xml.Linq/XDocument.xml | 22 +-
xml/System.Xml.Linq/XDocumentType.xml | 2 +-
xml/System.Xml.Linq/XElement.xml | 18 +-
xml/System.Xml.Linq/XNode.xml | 4 +-
.../XProcessingInstruction.xml | 2 +-
xml/System.Xml.Linq/XText.xml | 2 +-
.../XmlPreloadedResolver.xml | 2 +-
xml/System.Xml/XmlDictionaryWriter.xml | 8 +-
xml/System.Xml/XmlReader.xml | 68 ++++--
xml/System.Xml/XmlResolver.xml | 4 +-
xml/System.Xml/XmlSecureResolver.xml | 2 +-
xml/System.Xml/XmlUrlResolver.xml | 2 +-
xml/System.Xml/XmlWriter.xml | 126 ++++++++---
xml/System/BinaryData.xml | 2 +-
xml/System/IAsyncDisposable.xml | 4 +-
219 files changed, 2365 insertions(+), 1107 deletions(-)
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..2110b8971e9 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..eb1d2683d61 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..2ab91ac2a26 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..ce7f59ec022 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..19c23712ccd 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..334df2263b1 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..37d208b26d6 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..6dc67d5c40b 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..1f29a1e4a35 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..542f53aa1ad 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..8482d87348a 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..d3d9b99ea1a 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..58fd1231b89 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..93e2f74706b 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..bdf01d69133 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..3a1b74d8d15 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..a50c7d080e1 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..70b98f72d17 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..62ec45c1ace 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..7a202943b85 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..0f52440c222 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..b53802ee3da 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..4f8511068f7 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..17eecc484d4 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..dfced910578 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..c3cfdc52e5c 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..03cb155b7d7 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..25f0ab10927 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..26fb410c6e8 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..6258ff71cb4 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..1169f5b7d80 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..f8740701e6e 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..0ba8edade53 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..05e15fb30e7 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..a41c9bd5d85 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..887f68c8270 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..bff14910da4 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..56036d3183e 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..5f38a3d4fb5 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..c2a75f1e13d 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..210a41bb91b 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..6016f3e32cc 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..3c3d3cdf135 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..e1e4dfd023a 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..7c07bfea0e8 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..dfa8091408b 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..1294c6bfdf9 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..c342dee42ba 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..4ba573987fb 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..921c0887e1f 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