NetworkStream.Write 메서드

정의

네임스페이스:
System.Net.Sockets
어셈블리:
netstandard.dll, System.Net.Sockets.dll
어셈블리:
System.Net.Sockets.dll
어셈블리:
netstandard.dll
어셈블리:
System.dll

오버로드

Name Description
Write(ReadOnlySpan<Byte>)

읽기 전용 바이트 범위에서 데이터를 NetworkStream 씁니다.
Write(Byte[], Int32, Int32)

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

Write(ReadOnlySpan<Byte>)

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

예외

InvalidOperationException

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

IOException

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

-또는-

네트워크에 쓰는 동안 오류가 발생했습니다.

ObjectDisposedException

NetworkStream 닫혀 있습니다.

설명

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

메모

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

메모

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

적용 대상

Write(Byte[], Int32, Int32)

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

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

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

매개 변수

buffer
Byte[]

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

offset
Int32

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

countsize
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)
{
    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 위치에서 시작하여 해당 콘텐츠 count 에서 네트워크로 바이트를 보냅니 buffer 다. 메서드는 Write 요청된 바이트 수가 전송되거나 throw SocketException 될 때까지 차단됩니다.

메모

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

메모

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

추가 정보

적용 대상