NetworkStream.Write 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
Write(ReadOnlySpan<Byte>)	Salt okunur bayt aralığından NetworkStream 'a veri yazar.
Write(Byte[], Int32, Int32)	Belirtilen bayt dizisi aralığından öğesine veri NetworkStream yazar.

Write(ReadOnlySpan<Byte>)

Kaynak:

NetworkStream.cs

Salt okunur bayt aralığından NetworkStream 'a veri yazar.

public:
 override void Write(ReadOnlySpan<System::Byte> buffer);

public override void Write(ReadOnlySpan<byte> buffer);

override this.Write : ReadOnlySpan<byte> -> unit

Public Overrides Sub Write (buffer As ReadOnlySpan(Of Byte))

Parametreler

buffer

ReadOnlySpan<Byte>

öğesine yazacak NetworkStreamveriler.

Ö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 .

Açıklamalar

Bu yöntem, içindeki tüm baytları buffer ağa gönderir. yöntemi, Write istenen bayt sayısı gönderilene veya bir atılana SocketException kadar engeller.

Note

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

Note

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

Write(Byte[], Int32, Int32)

Kaynak:

NetworkStream.cs

Belirtilen bayt dizisi aralığından öğesine veri NetworkStream yazar.

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

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

override this.Write : byte[] * int * int -> unit

Public Overrides Sub Write (buffer As Byte(), offset As Integer, count As Integer)

Parametreler

buffer

Byte[]

türüne Byte yazacak NetworkStreamverileri içeren bir dizi.

offset

Int32

Veri yazmaya başlanması gereken konum buffer .

count

Int32

öğesine yazacak NetworkStreambayt sayısı.

Özel durumlar

ArgumentNullException

buffer parametresi null'dir.

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

Yuvaya erişilirken bir hata oluştu.

-veya-

Ağa yazılırken bir hata oluştu.

ObjectDisposedException

Kapalı NetworkStream .

Örnekler

Aşağıdaki kod örneği yazılabilir olup olmadığını NetworkStream denetler. Bu durumda, Write küçük bir ileti yazmak için kullanılır.

// Examples for CanWrite, and CanWrite
// Check to see if this NetworkStream is writable.
if (myNetworkStream.CanWrite)
{
    byte[] myWriteBuffer = Encoding.ASCII.GetBytes("Are you receiving this message?");
    myNetworkStream.Write(myWriteBuffer, 0, myWriteBuffer.Length);
}
else
{
    Console.WriteLine("Sorry.  You cannot write to this NetworkStream.");
}

' Examples for CanWrite, and CanWrite  
' Check to see if this NetworkStream is writable.
If myNetworkStream.CanWrite Then
   
   Dim myWriteBuffer As Byte() = Encoding.ASCII.GetBytes("Are you receiving this message?")
   myNetworkStream.Write(myWriteBuffer, 0, myWriteBuffer.Length)
Else
   Console.WriteLine("Sorry.  You cannot write to this NetworkStream.")
End If

Açıklamalar

Bu yöntem belirtilen offset konumda başlar ve içindekilerden count ağa bayt gönderirbuffer. yöntemi, Write istenen bayt sayısı gönderilene veya bir atılana SocketException kadar engeller.

Note

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

Note

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

Ayrıca bkz.

• CanWrite
• Writeable