NetworkStream.Write 메서드

정의

네임스페이스:

System.Net.Sockets

어셈블리:

System.Net.Sockets.dll

오버로드

Write(ReadOnlySpan<Byte>)	읽기 전용 바이트 범위에서 에 데이터를 NetworkStream 씁니다.
Write(Byte[], Int32, Int32)	지정된 범위의 바이트 배열에서 NetworkStream에 데이터를 씁니다.

Write(ReadOnlySpan<Byte>)

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에 쓸 데이터입니다.

예외

InvalidOperationException

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

IOException

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

또는

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

ObjectDisposedException

NetworkStream가 닫혔습니다.

설명

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

참고

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

참고

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

Write(Byte[], Int32, Int32)

Source:

NetworkStream.cs

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

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)

매개 변수

buffer

Byte[]

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

offset

Int32

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

count

Int32

NetworkStream에 쓸 바이트 수입니다.

예외

ArgumentNullException

buffer 매개 변수가 null인 경우

ArgumentOutOfRangeException

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

또는

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

또는

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

또는

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

InvalidOperationException

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

IOException

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

또는

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

ObjectDisposedException

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 오류 코드 설명서를 참조하여 오류에 대한 자세한 설명을 참조하세요.

추가 정보

• CanWrite
• Writeable