다음을 통해 공유


NetworkStream.Write 메서드

정의

오버로드

Write(ReadOnlySpan<Byte>)

읽기 전용 바이트 범위에서 에 데이터를 NetworkStream 씁니다.

Write(Byte[], Int32, Int32)

지정된 범위의 바이트 배열에서 NetworkStream에 데이터를 씁니다.

Write(ReadOnlySpan<Byte>)

Source:
NetworkStream.cs
Source:
NetworkStream.cs
Source:
NetworkStream.cs

읽기 전용 바이트 범위에서 에 데이터를 NetworkStream 씁니다.

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

매개 변수

buffer
ReadOnlySpan<Byte>

NetworkStream에 쓸 데이터입니다.

예외

NetworkStream에서 쓰기를 지원하지 않습니다.

소켓에 액세스할 때 오류가 발생했습니다.

또는

네트워크에 쓰는 동안 오류가 발생한 경우

설명

이 메서드는 의 모든 바이트를 buffer 네트워크에 보냅니다. 메서드는 Write 요청된 바이트 수가 전송되거나 SocketException 이 throw될 때까지 차단됩니다.

참고

속성을 호출 CanWrite 하여 이 NetworkStream 쓰기 가능한지 확인합니다. 쓸 수 없는 에 NetworkStream 쓰려고 하면 가 InvalidOperationException표시됩니다.

참고

를 수신하는 IOException경우 속성을 검사 InnerException 속성이 로 SocketException인해 발생했는지 확인합니다. 그렇다면 속성을 사용하여 ErrorCode 특정 오류 코드를 가져오고 Windows 소켓 버전 2 API 오류 코드 설명서를 참조하여 오류에 대한 자세한 설명을 참조하세요.

적용 대상

Write(Byte[], Int32, Int32)

Source:
NetworkStream.cs
Source:
NetworkStream.cs
Source:
NetworkStream.cs

지정된 범위의 바이트 배열에서 NetworkStream에 데이터를 씁니다.

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)

매개 변수

buffer
Byte[]

Byte에 쓸 데이터를 포함하는 NetworkStream 형식의 배열입니다.

offset
Int32

데이터를 쓰기 시작할 buffer 내의 위치입니다.

sizecount
Int32

NetworkStream에 쓸 바이트 수입니다.

예외

buffer 매개 변수가 null인 경우

offset 매개 변수가 0보다 작은 경우

또는

offset 매개 변수가 buffer의 길이보다 큰 경우

또는

size 매개 변수가 0보다 작은 경우

또는

size 매개 변수가 buffer의 길이에서 offset 매개 변수의 값을 뺀 값보다 큰 경우

NetworkStream에서 쓰기를 지원하지 않습니다.

소켓에 액세스할 때 오류가 발생했습니다.

또는

네트워크에 쓰는 동안 오류가 발생한 경우

예제

다음 코드 예제는 를 쓸 수 있는지 여부를 NetworkStream 확인합니다. Write 이 경우 는 작은 메시지를 작성하는 데 사용됩니다.

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

설명

이 메서드는 지정된 offset 에서 시작하고 의 콘텐츠 buffer 에서 네트워크로 바이트를 보냅니 size 다. 메서드는 Write 요청된 바이트 수가 전송되거나 SocketException 이 throw될 때까지 차단됩니다.

참고

속성을 호출 CanWrite 하여 이 NetworkStream 쓰기 가능한지 확인합니다. 쓸 수 없는 에 NetworkStream 쓰려고 하면 가 InvalidOperationException표시됩니다.

참고

를 수신하는 IOException경우 속성을 검사 InnerException 속성이 로 SocketException인해 발생했는지 확인합니다. 그렇다면 속성을 사용하여 ErrorCode 특정 오류 코드를 가져오고 Windows 소켓 버전 2 API 오류 코드 설명서를 참조하여 오류에 대한 자세한 설명을 참조하세요.

추가 정보

적용 대상