NetworkStream.WriteAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Överlagringar
| Name | Description |
|---|---|
| WriteAsync(ReadOnlyMemory<Byte>, CancellationToken) |
Skriver data till NetworkStream från ett skrivskyddat minnesbyteminnesintervall som en asynkron åtgärd. |
| WriteAsync(Byte[], Int32, Int32, CancellationToken) |
Skriver data till NetworkStream från det angivna intervallet för en bytematris som en asynkron åtgärd. |
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)
Skriver data till NetworkStream från ett skrivskyddat minnesbyteminnesintervall som en asynkron åtgärd.
public override System.Threading.Tasks.ValueTask WriteAsync(ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTaskPublic Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParametrar
- buffer
- ReadOnlyMemory<Byte>
En region med minne som innehåller de data som ska skrivas NetworkStreamtill .
- cancellationToken
- CancellationToken
Token som ska övervakas för annulleringsbegäranden.
Returer
En uppgift som representerar den asynkrona skrivåtgärden.
Undantag
Stöder NetworkStream inte skrivning.
Ett fel uppstod vid åtkomst till socketen.
-eller-
Det uppstod ett fel när du skrev till nätverket.
Är NetworkStream stängd.
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
Den här metoden skickar alla byte till buffer nätverket.
Note
Kontrollera om NetworkStream är skrivbart genom att anropa egenskapen CanWrite . Om du försöker skriva till en NetworkStream som inte kan skrivas får du en InvalidOperationException.
Note
Om du får en IOExceptionkontrollerar du InnerException egenskapen för att avgöra om den orsakades av en SocketException. I så fall använder du egenskapen ErrorCode för att hämta den specifika felkoden och läser dokumentationen om api-felkoden Windows Sockets version 2 för en detaljerad beskrivning av felet.
Gäller för
WriteAsync(Byte[], Int32, Int32, CancellationToken)
Skriver data till NetworkStream från det angivna intervallet för en bytematris som en asynkron åtgärd.
public:
override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int size, System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task WriteAsync(byte[] buffer, int offset, int size, System.Threading.CancellationToken cancellationToken);abstract member WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Taskoverride this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Overrides Function WriteAsync (buffer As Byte(), offset As Integer, size As Integer, cancellationToken As CancellationToken) As TaskParametrar
- buffer
- Byte[]
En bytematris som innehåller de data som ska skrivas NetworkStreamtill .
- offset
- Int32
Den plats buffer där du vill börja skriva data.
- countsize
- Int32
Antalet byte som ska skrivas till NetworkStream.
- cancellationToken
- CancellationToken
Token som ska övervakas för annulleringsbegäranden.
Returer
En uppgift som representerar den asynkrona skrivåtgärden.
Undantag
Parametern buffer är null.
Parametern offset är mindre än 0.
-eller-
Parametern offset är större än längden på buffer.
-eller-
Parametern size är mindre än 0.
-eller-
Parametern size är större än längden buffer på minus värdet för parametern offset .
Stöder NetworkStream inte skrivning.
Det uppstod ett fel när du skrev till nätverket.
-eller-
Ett fel uppstod vid åtkomst till socketen.
Är NetworkStream stängd.
Annulleringstoken avbröts. Det här undantaget lagras i den returnerade aktiviteten.
Kommentarer
Den här metoden börjar vid den angivna offset och skickar count byte från innehållet i buffer nätverket.
Note
Kontrollera om NetworkStream är skrivbart genom att anropa egenskapen CanWrite . Om du försöker skriva till en NetworkStream som inte kan skrivas får du en InvalidOperationException.
Note
Om du får en IOExceptionkontrollerar du InnerException egenskapen för att avgöra om den orsakades av en SocketException. I så fall använder du egenskapen ErrorCode för att hämta den specifika felkoden och läser dokumentationen om api-felkoden Windows Sockets version 2 för en detaljerad beskrivning av felet.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Write(Byte[], Int32, Int32).