NetworkStream.Write Yöntem

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kod:

System.Net.Sockets.dll

Aşırı Yüklemeler

Write(ReadOnlySpan<Byte>)	Salt okunur bayt aralığından NetworkStream öğesine 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 öğesine 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 buffer tüm baytları ağa gönderir. yöntemi, Write istenen bayt sayısı gönderilene veya bir atılana SocketException kadar engeller.

Not

özelliğini çağırarak CanWrite yazılabilir olup olmadığını NetworkStream denetleyin. Yazılabilir olmayan bir NetworkStream öğesine yazmaya ç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.

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

öğesine yazacak NetworkStreamverileri içeren tür Byte dizisi.

offset

Int32

Veri yazmaya başlayabileceğiniz konum buffer .

count

Int32

öğesine yazacak NetworkStreambayt sayısı.

Özel durumlar

ArgumentNullException

buffer parametresidirnull.

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 )
{
   array<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)
{
    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 konumunda başlar ve içindeki buffer baytları ağa gönderirsize. yöntemi, Write istenen bayt sayısı gönderilene veya bir atılana SocketException kadar engeller.

Not

özelliğini çağırarak CanWrite yazılabilir olup olmadığını NetworkStream denetleyin. Yazılabilir olmayan bir NetworkStream öğesine yazmaya ç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.

• CanWrite
• Writeable