Aracılığıyla paylaş


NetworkStream.Write Yöntem

Tanım

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
Kaynak:
NetworkStream.cs
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

Yuvaya erişilirken bir hata oluştu.

-veya-

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

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.

Şunlara uygulanır

Write(Byte[], Int32, Int32)

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

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

public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int size);
public:
 override void Write(cli::array <System::Byte> ^ buffer, int offset, int count);
public override void Write (byte[] buffer, int offset, int size);
public override void Write (byte[] buffer, int offset, int count);
override this.Write : byte[] * int * int -> unit
override this.Write : byte[] * int * int -> unit
Public Overrides Sub Write (buffer As Byte(), offset As Integer, size As Integer)
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 .

sizecount
Int32

öğesine yazacak NetworkStreambayt sayısı.

Özel durumlar

buffer parametresidirnull.

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.

Yuvaya erişilirken bir hata oluştu.

-veya-

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

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

Şunlara uygulanır