Bagikan melalui


Socket.Available Properti

Definisi

Mendapatkan jumlah data yang telah diterima dari jaringan dan tersedia untuk dibaca.

public:
 property int Available { int get(); };
public int Available { get; }
member this.Available : int
Public ReadOnly Property Available As Integer

Nilai Properti

Jumlah byte data yang diterima dari jaringan dan tersedia untuk dibaca.

Pengecualian

Terjadi kesalahan saat mencoba mengakses soket.

Contoh

Contoh kode berikut membandingkan hasil panggilan IOControl dengan FIONREAD dan properti Tersedia.

// 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;
 }

Keterangan

Jika Anda menggunakan non-pemblokiran Socket, Available adalah cara yang baik untuk menentukan apakah data diantrekan untuk dibaca, sebelum memanggil Receive. Data yang tersedia adalah jumlah total data yang diantrekan dalam buffer jaringan untuk dibaca. Jika tidak ada data yang diantrekan di buffer jaringan, Available mengembalikan 0.

Jika host jarak jauh dimatikan atau menutup koneksi, Available dapat melempar SocketException. Jika Anda menerima SocketException, gunakan SocketException.ErrorCode properti untuk mendapatkan kode kesalahan tertentu. Setelah Anda mendapatkan kode ini, lihat dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.

Catatan

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.

Berlaku untuk

Lihat juga