NetworkStream.ReadAsync Yöntem

Tanım

Aşırı Yüklemeler

ReadAsync(Memory<Byte>, CancellationToken)

içindeki NetworkStream verileri okur ve zaman uyumsuz bir işlem olarak bayt bellek aralığında depolar.

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

'den NetworkStream verileri okur ve zaman uyumsuz bir işlem olarak belirli bir bayt dizisi aralığına depolar.

ReadAsync(Memory<Byte>, CancellationToken)

Kaynak:
NetworkStream.cs
Kaynak:
NetworkStream.cs
Kaynak:
NetworkStream.cs

içindeki NetworkStream verileri okur ve zaman uyumsuz bir işlem olarak bayt bellek aralığında depolar.

public override System.Threading.Tasks.ValueTask<int> ReadAsync (Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);
override this.ReadAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
Public Overrides Function ReadAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parametreler

buffer
Memory<Byte>

Verileri yazacak arabellek.

cancellationToken
CancellationToken

İptal isteklerini izlemek için belirteç.

Döndürülenler

ValueTask<TResult> Zaman uyumsuz okuma işlemini temsil eden bir. özelliğinin Result değeri, içinde bufferokunan toplam bayt sayısını içerir.

Özel durumlar

NetworkStream, okumayı desteklemez.

Yuvaya erişilirken bir hata oluştu.

-veya-

Ağdan okuma hatası var.

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

Açıklamalar

Bu yöntem, için kullanılabilir buffer olduğu kadar çok veri okur ve başarıyla okunan bayt sayısını döndürür.

Not

özelliğini çağırarak CanRead okunabilir olup olmadığını NetworkStream denetleyin. Okunamayan bir NetworkStream öğeden okumaya çalışırsanız, bir InvalidOperationExceptionalırsınız.

Not

bir alırsanız IOException, özelliğini denetleyerek InnerException bunun 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.

Şunlara uygulanır

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

Kaynak:
NetworkStream.cs
Kaynak:
NetworkStream.cs
Kaynak:
NetworkStream.cs

'den NetworkStream verileri okur ve zaman uyumsuz bir işlem olarak belirli bir bayt dizisi aralığına depolar.

public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int size, System::Threading::CancellationToken cancellationToken);
public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<int> ReadAsync (byte[] buffer, int offset, int size, System.Threading.CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<int> ReadAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);
override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
Public Overrides Function ReadAsync (buffer As Byte(), offset As Integer, size As Integer, cancellationToken As CancellationToken) As Task(Of Integer)
Public Overrides Function ReadAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task(Of Integer)

Parametreler

buffer
Byte[]

Verilerin yazlýlýp yazýlýldýrýlýr.

offset
Int32

Verilerin depolanacağını konum buffer .

sizecount
Int32

'den NetworkStreamokunacak bayt sayısı.

cancellationToken
CancellationToken

İptal isteklerini izlemek için belirteç.

Döndürülenler

Zaman uyumsuz okuma işlemini temsil eden görev. özelliğinin Result değeri, içinde bufferokunan toplam bayt sayısını içerir.

Özel durumlar

NetworkStream, okumayı desteklemez.

Yuvaya erişilirken bir hata oluştu.

-veya-

Ağdan okuma hatası var.

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

Açıklamalar

Bu yöntem verileri içine buffer okur ve başarıyla okunan bayt sayısını döndürür. İşlem ReadAsync , parametresi tarafından size belirtilen bayt sayısına kadar mümkün olduğunca çok veri okur.

Not

özelliğini çağırarak CanRead okunabilir olup olmadığını NetworkStream denetleyin. Okunamayan bir NetworkStream öğeden okumaya çalışırsanız, bir InvalidOperationExceptionalırsınız.

Not

bir alırsanız IOException, özelliğini denetleyerek InnerException bunun 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, 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 Read(Byte[], Int32, Int32)özel durumlara bakın.

Şunlara uygulanır