PipeStream.WriteAsync Yöntem

Tanım

Ad Alanı:

System.IO.Pipes

Bütünleştirilmiş Kod:

System.IO.Pipes.dll

Aşırı Yüklemeler

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Zaman uyumsuz olarak geçerli akışa bir bayt dizisi yazar, bu akıştaki geçerli konumu yazılan bayt sayısına göre ilerletir ve iptal isteklerini izler.
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Belirtilen konumdan başlayan bir bayt dizisinden zaman uyumsuz olarak belirtilen sayıda bayt yazar, bu akıştaki geçerli konumu yazılan bayt sayısına göre ilerletir ve iptal isteklerini izler.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Kaynak:

PipeStream.Unix.cs

Zaman uyumsuz olarak geçerli akışa bir bayt dizisi yazar, bu akıştaki geçerli konumu yazılan bayt sayısına göre ilerletir ve iptal isteklerini izler.

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>

Veri yazacak bellek bölgesi.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç. None varsayılan değerdir.

Döndürülenler

ValueTask

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

Özel durumlar

NotSupportedException

Stream yazmayı desteklemez.

ObjectDisposedException

Kapalı kanala erişilemiyor.

IOException

Boru bozuk.

InvalidOperationException

Boru henüz bağlanmadı.

-veya-

Borunun bağlantısı kesilmiş durumda.

-veya-

Boru tutamacı ayarlanmadı. (Uygulamanız PipeStream çağrı InitializeHandle(SafePipeHandle, Boolean, Boolean)yaptı mı?

OperationCanceledException

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

Açıklamalar

yöntemi, WriteAsync ana iş parçacığını engellemeden yoğun kaynak kullanımlı G/Ç işlemleri gerçekleştirmenizi sağlar. Bu performans değerlendirmesi, zaman alan bir akış işleminin kullanıcı arabirimi iş parçacığını engellediği ve uygulamanızın çalışmıyor gibi görünmesini sağlayabildiği uygulamalarda özellikle önemlidir. Zaman uyumsuz yöntemler, Visual Basic ve C# içindeki ve await anahtar sözcükleriyle async birlikte kullanılır.

CanWrite Geçerli örneğin yazmayı destekleyip desteklemediğini belirlemek için özelliğini kullanın.

İşlem tamamlanmadan önce iptal edilirse, döndürülen görev özelliğin CanceledStatus değerini içerir.

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

Kaynak:

PipeStream.Unix.cs

Belirtilen konumdan başlayan bir bayt dizisinden zaman uyumsuz olarak belirtilen sayıda bayt yazar, bu akıştaki geçerli konumu yazılan bayt sayısına göre ilerletir ve iptal isteklerini izler.

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[]

Veri yazacak arabellek.

offset

Int32

Baytları akışa kopyalamaya başlayacağı sıfır tabanlı bayt uzaklığı buffer .

count

Int32

Yazacak en fazla bayt sayısı.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç. None varsayılan değerdir.

Döndürülenler

Task

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

Özel durumlar

ArgumentNullException

buffer, null değeridir.

ArgumentOutOfRangeException

offset negatiftir.

-veya-

count negatiftir.

ArgumentException

buffer. Uzunluk - offset değerinden countküçüktür.

NotSupportedException

Stream yazmayı desteklemez.

ObjectDisposedException

Kapalı kanala erişilemiyor.

IOException

Boru bozuk.

InvalidOperationException

Boru henüz bağlanmadı.

-veya-

Borunun bağlantısı kesilmiş durumda.

-veya-

Boru tutamacı ayarlanmadı. (Uygulamanız PipeStream çağrı InitializeHandle(SafePipeHandle, Boolean, Boolean)yaptı mı?

OperationCanceledException

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

Açıklamalar

yöntemi, WriteAsync ana iş parçacığını engellemeden yoğun kaynak kullanımlı G/Ç işlemleri gerçekleştirmenizi sağlar. Bu performans değerlendirmesi, zaman alan bir akış işleminin kullanıcı arabirimi iş parçacığını engellediği ve uygulamanızın çalışmıyor gibi görünmesini sağlayabildiği uygulamalarda özellikle önemlidir. Zaman uyumsuz yöntemler, Visual Basic ve C# içindeki ve await anahtar sözcükleriyle async birlikte kullanılır.

CanWrite Geçerli örneğin yazmayı destekleyip desteklemediğini belirlemek için özelliğini kullanın.

İşlem tamamlanmadan önce iptal edilirse, döndürülen görev özelliğin TaskStatus.CanceledStatus değerini içerir.

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