NetworkStream.WriteAsync Yöntem

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kod:

System.Net.Sockets.dll

Aşırı Yüklemeler

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Salt okunur bellek bayt bellek aralığındaki NetworkStream verileri zaman uyumsuz bir işlem olarak yazar.
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Zaman uyumsuz bir işlem olarak belirtilen bayt dizisi aralığından öğesine veri NetworkStream yazar.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Kaynak:

NetworkStream.cs

Salt okunur bellek bayt bellek aralığındaki NetworkStream verileri 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 istekleri için izlenecek 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 buffer tüm baytları ağa gönderir.

Not

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

Not

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

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

Kaynak:

NetworkStream.cs

Zaman uyumsuz bir işlem olarak belirtilen bayt dizisi aralığından öğesine veri NetworkStream 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şlayabileceğiniz konum buffer .

count

Int32

öğesine yazacak NetworkStreambayt sayısı.

cancellationToken

CancellationToken

İptal istekleri için izlenecek belirteç.

Döndürülenler

Task

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

Özel durumlar

ArgumentNullException

buffer parametresidirnull.

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 konumunda başlar ve içindeki buffer baytları ağa gönderirsize.

Not

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

Not

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

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Write(Byte[], Int32, Int32)özel durumlara bakın.