Socket.Available 属性

public:
 property int Available { int get(); };

public int Available { get; }

member this.Available : int

Public ReadOnly Property Available As Integer

属性值

从网络接收的、可供读取的数据的字节数。

例外

示例

下面的代码示例将调用 IOControl 的结果与 FIONREAD 和 Available 属性进行比较。

// FIONREAD is also available as the "Available" property.
const int FIONREAD = 0x4004667F;

void DisplayPendingByteCount( Socket^ s )
{
   array<Byte>^ outValue = BitConverter::GetBytes( 0 );
   
   // Check how many bytes have been received.
   s->IOControl( FIONREAD, nullptr, outValue );

   UInt32 bytesAvailable = BitConverter::ToUInt32( outValue, 0 );
   Console::WriteLine( "server has {0} bytes pending. Available property says {1}.",
      bytesAvailable, s->Available );

   return;
}

 // FIONREAD is also available as the "Available" property.
public const int FIONREAD   = 0x4004667F;

static void DisplayPendingByteCount(Socket s)
 {
     byte[] outValue = BitConverter.GetBytes(0);

     // Check how many bytes have been received.
     s.IOControl(FIONREAD, null, outValue);

     uint bytesAvailable = BitConverter.ToUInt32(outValue, 0);
     Console.WriteLine("server has {0} bytes pending. Available property says {1}.",
         bytesAvailable, s.Available);

     return;
 }

注解

如果使用非阻止 Socket， Available 是在调用 Receive之前确定数据是否排队等待读取的好方法。 可用数据是在网络缓冲区中排队等待读取的数据总量。 如果网络缓冲区中没有数据排队， Available 则返回 0。

如果远程主机关闭或关闭连接， Available 可能会引发 SocketException。 如果收到 ， SocketException请使用 SocketException.ErrorCode 属性获取特定的错误代码。 获取此代码后，请参阅 Windows 套接字版本 2 API 错误代码 文档，了解错误的详细说明。

适用于

另请参阅

• Receive(Byte[], Int32, SocketFlags)
• Stream
• Dgram