NetworkStream.Write 方法

定义

命名空间:
System.Net.Sockets
程序集:
netstandard.dll, System.Net.Sockets.dll
程序集:
System.Net.Sockets.dll
程序集:
netstandard.dll
程序集:
System.dll

重载

名称 说明
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 会阻止发送请求的字节数或 SocketException 引发字节数。

注释

通过调用NetworkStream属性来检查该属性是否CanWrite可写。 如果尝试写入不可写的， NetworkStream 你将获得一个 InvalidOperationException。

注释

如果收到一个 IOException属性，请检查该 InnerException 属性以确定它是否是由 a SocketException引起的。 如果是这样，请使用 ErrorCode 属性获取特定的错误代码，并参阅 Windows 套接字版本 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 会阻止发送请求的字节数或 SocketException 引发字节数。

注释

通过调用NetworkStream属性来检查该属性是否CanWrite可写。 如果尝试写入不可写的， NetworkStream 你将获得一个 InvalidOperationException。

注释

如果收到一个 IOException属性，请检查该 InnerException 属性以确定它是否是由 a SocketException引起的。 如果是这样，请使用 ErrorCode 属性获取特定的错误代码，并参阅 Windows 套接字版本 2 API 错误代码文档，获取错误的详细说明。

另请参阅

适用于