NetworkStream.WriteAsync Yöntem

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Sockets.dll

Aşırı Yüklemeler

Name	Description
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Salt okunur bellek bayt bellek aralığındaki verileri NetworkStream zaman uyumsuz bir işlem olarak yazar.
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Belirtilen bayt dizisi aralığındaki verileri NetworkStream zaman uyumsuz bir işlem olarak yazar.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Kaynak:

NetworkStream.cs

Salt okunur bellek bayt bellek aralığındaki verileri NetworkStream zaman uyumsuz bir işlem olarak yazar.

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.ValueTask

Public Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parametreler

buffer

ReadOnlyMemory<Byte>

'a yazacak NetworkStreamverileri içeren bellek bölgesi.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç.

Döndürülenler

ValueTask

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

InvalidOperationException

yazmayı NetworkStream desteklemez.

IOException

Yuvaya erişilirken bir hata oluştu.

-veya-

Ağa yazılırken bir hata oluştu.

ObjectDisposedException

Kapalı NetworkStream .

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu yöntem, içindeki tüm baytları buffer ağa gönderir.

Note

özelliğini çağırarak NetworkStream yazılabilir olup olmadığını CanWrite denetleyin. Yazılabilir olmayan bir NetworkStream öğesine yazmaya çalışırsanız, bir InvalidOperationExceptionalırsınız.

Note

bir IOExceptionalırsanız, özelliğine InnerException bir neden SocketExceptionolup olmadığını denetleyin. Bu durumda, belirli bir hata kodunu almak için ErrorCode özelliğini kullanın ve hatanın ayrıntılı açıklaması için Windows Sockets sürüm 2 API hata kodu belgelerine bakın.

WriteAsync(Byte[], Int32, Int32, CancellationToken)

Kaynak:

NetworkStream.cs

Belirtilen bayt dizisi aralığındaki verileri NetworkStream zaman uyumsuz bir işlem olarak yazar.

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task WriteAsync(byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);

override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function WriteAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task

Parametreler

buffer

Byte[]

öğesine yazacak NetworkStreamverileri içeren bir bayt dizisi.

offset

Int32

Veri yazmaya başlanması gereken konum buffer .

count

Int32

öğesine yazacak NetworkStreambayt sayısı.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

ArgumentNullException

buffer parametresi null'dir.

ArgumentOutOfRangeException

offset Parametresi 0'dan küçük.

-veya-

offset parametresi, uzunluğundan bufferbüyüktür.

-veya-

size Parametresi 0'dan küçük.

-veya-

size parametresi, parametresinin değerinden bufferoffset daha uzundur.

InvalidOperationException

yazmayı NetworkStream desteklemez.

IOException

Ağa yazılırken bir hata oluştu.

-veya-

Yuvaya erişilirken bir hata oluştu.

ObjectDisposedException

Kapalı NetworkStream .

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Bu yöntem belirtilen offset konumda başlar ve içindekilerden count ağa bayt gönderirbuffer.

Note

özelliğini çağırarak NetworkStream yazılabilir olup olmadığını CanWrite denetleyin. Yazılabilir olmayan bir NetworkStream öğesine yazmaya çalışırsanız, bir InvalidOperationExceptionalırsınız.

Note

bir IOExceptionalırsanız, özelliğine InnerException bir neden SocketExceptionolup olmadığını denetleyin. Bu durumda, belirli bir hata kodunu almak için ErrorCode özelliğini kullanın ve hatanın ayrıntılı açıklaması için Windows Sockets sürüm 2 API hata kodu belgelerine bakın.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından Write(Byte[], Int32, Int32)oluşan özel durumlara bakın.