NetworkStream.ReadAsync 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
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 belirtilen bayt dizisi aralığına depolar.

ReadAsync(Memory<Byte>, CancellationToken)

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<Int32>

ValueTask<TResult> Zaman uyumsuz okuma işlemini temsil eden bir. özelliğinin Result değeri, sıfır (0) arasında okunan buffer toplam bayt sayısını ve istenen bayt sayısını içerir. Sonuç değeri yalnızca sıfır bayt istendiyse veya eş yuva düzgün bir kapatma gerçekleştirdiğinden daha fazla bayt yoksa sıfırdır (0). Sıfır bayt istenirse, okuma işlemleri hemen tamamlanabilir veya en az bir bayt kullanılabilir olana kadar (ancak herhangi bir veri kullanılmadan) tamamlanmayabilir.

Özel durumlar

InvalidOperationException

NetworkStream, okumayı desteklemez.

IOException

Yuvaya erişilirken bir hata oluştu.

-veya-

Ağdan okuma hatası 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çin kullanılabilir buffer olduğu kadar çok veri okur ve başarıyla okunan bayt sayısını döndürür.

Note

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

Note

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

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

Kaynak:

NetworkStream.cs

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

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 count, System.Threading.CancellationToken cancellationToken);

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

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

Parametreler

buffer

Byte[]

Verileri yazacak arabellek.

offset

Int32

Verilerin depolanacağını konum buffer .

count

Int32

'den NetworkStreamokunacak bayt sayısı.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç.

Döndürülenler

Task<Int32>

Zaman uyumsuz okuma işlemini temsil eden görev. özelliğinin Result değeri, sıfır (0) arasında okunan buffer toplam bayt sayısını ve istenen bayt sayısını içerir. Sonuç değeri yalnızca sıfır bayt istendiyse veya eş yuva düzgün bir kapatma gerçekleştirdiğinden daha fazla bayt yoksa sıfırdır (0). Sıfır bayt istenirse, okuma işlemleri hemen tamamlanabilir veya en az bir bayt kullanılabilir olana kadar (ancak herhangi bir veri kullanılmadan) tamamlanmayabilir.

Özel durumlar

InvalidOperationException

NetworkStream, okumayı desteklemez.

IOException

Yuvaya erişilirken bir hata oluştu.

-veya-

Ağdan okuma hatası 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 verileri içine buffer okur ve başarıyla okunan bayt sayısını döndürür. İşlem ReadAsync , parametresi tarafından count belirtilen bayt sayısına kadar kullanılabilir olduğu kadar veri okur.

Note

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

Note

bir IOExceptionalırsanız, özelliğine InnerException bir neden SocketExceptionolup olmadığını denetleyin. Bu durumda, ErrorCode özelliğini kullanarak belirli bir hata kodunu alı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 Read(Byte[], Int32, Int32)oluşan özel durumlara bakın.