Socket.Bind(EndPoint) Metode

Definisi

Ruang nama:

System.Net.Sockets

Rakitan:

System.Net.Sockets.dll

Sumber:

Socket.cs

Socket Mengaitkan dengan titik akhir lokal.

public:
 void Bind(System::Net::EndPoint ^ localEP);

public void Bind (System.Net.EndPoint localEP);

member this.Bind : System.Net.EndPoint -> unit

Public Sub Bind (localEP As EndPoint)

Parameter

localEP

EndPoint

Lokal EndPoint untuk dikaitkan dengan Socket.

Pengecualian

ArgumentNullException

localEPadalah null.

SocketException

Terjadi kesalahan saat mencoba mengakses soket.

ObjectDisposedException

Socket Telah ditutup.

SecurityException

Penelepon yang lebih tinggi di tumpukan panggilan tidak memiliki izin untuk operasi yang diminta.

Contoh

Contoh kode berikut mengikat Socket menggunakan titik akhir lokal yang ditentukan.

try
{
   aSocket->Bind( anEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( "Winsock error: {0}", e );
}

try {
    aSocket.Bind(anEndPoint);
}
catch (Exception e) {
    Console.WriteLine("Winsock error: " + e.ToString());
}

Try
    aSocket.Bind(anEndPoint)
Catch e As Exception
    Console.WriteLine("Winsock error: " & e.ToString())
End Try

Keterangan

Bind Gunakan metode jika Anda perlu menggunakan titik akhir lokal tertentu. Anda harus memanggil Bind sebelum dapat memanggil Listen metode . Anda tidak perlu memanggil Bind sebelum menggunakan Connect metode kecuali Anda perlu menggunakan titik akhir lokal tertentu. Anda dapat menggunakan metode pada Bind protokol tanpa koneksi dan berorientasi koneksi.

Sebelum memanggil Bind, Anda harus terlebih dahulu membuat lokal IPEndPoint tempat Anda ingin mengomunikasikan data. Jika Anda tidak peduli alamat lokal mana yang ditetapkan, Anda dapat membuat IPEndPoint penggunaan IPAddress.Any sebagai parameter alamat, dan penyedia layanan yang mendasar akan menetapkan alamat jaringan yang paling tepat. Ini mungkin membantu menyederhanakan aplikasi Anda jika Anda memiliki beberapa antarmuka jaringan. Jika Anda tidak peduli port lokal mana yang digunakan, Anda dapat membuat IPEndPoint menggunakan 0 untuk nomor port. Dalam hal ini, penyedia layanan akan menetapkan nomor port yang tersedia antara 1024 dan 5000.

Jika Anda menggunakan pendekatan di atas, Anda dapat menemukan alamat jaringan lokal dan nomor port apa yang telah ditetapkan dengan memanggil LocalEndPoint. Jika Anda menggunakan protokol berorientasi koneksi, LocalEndPoint tidak akan mengembalikan alamat jaringan yang ditetapkan secara lokal sampai setelah Anda melakukan panggilan ke Connect metode atau EndConnect . Jika Anda menggunakan protokol tanpa koneksi, Anda tidak akan memiliki akses ke informasi ini sampai Anda menyelesaikan pengiriman atau penerimaan.

Jika soket UDP ingin menerima informasi antarmuka tentang paket yang diterima, SetSocketOption metode harus secara eksplisit dipanggil dengan opsi soket diatur ke PacketInformation segera setelah memanggil Bind metode .

Catatan

Jika Anda berniat menerima datagram multicast, Anda harus memanggil Bind metode dengan nomor port multicast.

Catatan

Anda harus memanggil Bind metode jika Anda berniat menerima datagram tanpa koneksi menggunakan metode .ReceiveFrom

Catatan

Jika Anda menerima SocketException saat memanggil Bind metode , 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.

Lihat juga

• IPEndPoint
• Connect(EndPoint)
• Listen(Int32)
• IPAddress
• LocalEndPoint