Bagikan melalui


Socket.Bind(EndPoint) Metode

Definisi

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

localEPadalah null.

Terjadi kesalahan saat mencoba mengakses soket.

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.

Berlaku untuk

Lihat juga