NetworkStream.Read Yöntem

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kod:

System.Net.Sockets.dll

Aşırı Yüklemeler

Read(Span<Byte>)	dosyasındaki NetworkStream verileri okur ve bellekteki bir bayt aralığına depolar.
Read(Byte[], Int32, Int32)	'den NetworkStream verileri okur ve bir bayt dizisine depolar.

Read(Span<Byte>)

Kaynak:

NetworkStream.cs

dosyasındaki NetworkStream verileri okur ve bellekteki bir bayt aralığına depolar.

public:
 override int Read(Span<System::Byte> buffer);

public override int Read (Span<byte> buffer);

override this.Read : Span<byte> -> int

Public Overrides Function Read (buffer As Span(Of Byte)) As Integer

Parametreler

buffer

Span<Byte>

'den NetworkStreamokunan verileri depolamak için bellek bölgesi.

Döndürülenler

Int32

'den NetworkStreamokunan bayt sayısı.

Özel durumlar

InvalidOperationException

, NetworkStream okumayı desteklemez.

IOException

Yuvaya erişilirken bir hata oluştu.

-veya-

Ağdan okuma hatası var.

ObjectDisposedException

Kapalı NetworkStream .

Açıklamalar

Bu yöntem, parametresinde buffer kullanılabilir olan kadar veri okur ve başarıyla okunan bayt sayısını döndürür.

Not

özelliğini çağırarak CanRead öğesinin NetworkStream okunabilir olup olmadığını denetleyin. Okunamayan bir NetworkStream öğeden okumaya ç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.

Read(Byte[], Int32, Int32)

Kaynak:

NetworkStream.cs

'den NetworkStream verileri okur ve bir bayt dizisine depolar.

public:
 override int Read(cli::array <System::Byte> ^ buffer, int offset, int count);

public override int Read (byte[] buffer, int offset, int count);

override this.Read : byte[] * int * int -> int

Public Overrides Function Read (buffer As Byte(), offset As Integer, count As Integer) As Integer

Parametreler

buffer

Byte[]

bellekteki konumundan Byte okunan NetworkStreamverileri depolamak için kullanılan tür dizisi.

offset

Int32

Verilerin depolanacağını konum buffer .

count

Int32

'den NetworkStreamokunacak bayt sayısı.

Döndürülenler

Int32

'den NetworkStreamokunan bayt sayısı.

Özel durumlar

ArgumentNullException

buffer, null değeridir.

ArgumentOutOfRangeException

offset 0'dan küçüktür.

-veya-

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

-veya-

size 0'dan küçüktür.

-veya-

size, eksi offsetdeğerinden buffer büyük.

InvalidOperationException

, NetworkStream okumayı desteklemez.

IOException

Yuvaya erişilirken bir hata oluştu.

-veya-

Ağdan okuma hatası var.

ObjectDisposedException

Kapalı NetworkStream .

Örnekler

Aşağıdaki kod örneği, verilerin okunmaya uygun olup olmadığını belirlemek için kullanır DataAvailable . Kullanılabilir veriler varsa, veri kaynağından NetworkStreamokur.

byte[] myReadBuffer = new byte[1024];
StringBuilder myCompleteMessage = new StringBuilder();
int numberOfBytesRead = myNetworkStream.Read(myReadBuffer, 0, myReadBuffer.Length);

// Read all the data until the end of stream has been reached.
// The incoming message may be larger than the buffer size.
while (numberOfBytesRead > 0)
{
    myCompleteMessage.Append(Encoding.ASCII.GetString(myReadBuffer, 0, numberOfBytesRead));
    numberOfBytesRead = myNetworkStream.Read(myReadBuffer, 0, myReadBuffer.Length);
}

// Print out the received message to the console.
Console.WriteLine("You received the following message : " + myCompleteMessage);

Açıklamalar

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

Not

özelliğini çağırarak CanRead öğesinin NetworkStream okunabilir olup olmadığını denetleyin. Okunamayan bir NetworkStream öğeden okumaya ç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.

Ayrıca bkz.

• Receive(Byte[], Int32, SocketFlags)
• DataAvailable
• CanRead
• Ağda Akışları Kullanma