NetworkStream.Write Метод

Определение

Пространство имен:

System.Net.Sockets

Сборки:

netstandard.dll, System.Net.Sockets.dll

Перегрузки

Имя	Описание
Write(ReadOnlySpan<Byte>)	Записывает данные NetworkStream в диапазон байтов только для чтения.
Write(Byte[], Int32, Int32)	Записывает данные NetworkStream в указанный диапазон массива байтов.

Write(ReadOnlySpan<Byte>)

Исходный код:

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 не будет создано.

Note

Проверьте, является ли NetworkStream запись доступной CanWrite для записи путем вызова свойства. Если вы пытаетесь написать NetworkStream в недоступную запись, вы получите InvalidOperationException.

Note

Если вы получаете IOExceptionсвойство, проверьте InnerException , было ли оно вызвано SocketException. В этом случае используйте свойство ErrorCode для получения определенного кода ошибки и ознакомьтесь с документацией по коду ошибки Windows Sockets версии 2 API для подробного описания ошибки.

Write(Byte[], Int32, Int32)

Исходный код:

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)
{
    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 блокируется до тех пор, пока запрошенное число байтов не будет отправлено или SocketException не будет создано.

Note

Проверьте, является ли NetworkStream запись доступной CanWrite для записи путем вызова свойства. Если вы пытаетесь написать NetworkStream в недоступную запись, вы получите InvalidOperationException.

Note

Если вы получаете IOExceptionсвойство, проверьте InnerException , было ли оно вызвано SocketException. В этом случае используйте свойство ErrorCode для получения определенного кода ошибки и ознакомьтесь с документацией по коду ошибки Windows Sockets версии 2 API для подробного описания ошибки.

См. также раздел

• CanWrite
• Writeable