Socket.Bind(EndPoint) Metod

Definition

Namnområde:
System.Net.Sockets
Sammansättningar:
System.dll, System.Net.Sockets.dll
Sammansättning:
System.dll
Sammansättning:
System.Net.Sockets.dll
Sammansättning:
netstandard.dll

Associerar en Socket med en lokal slutpunkt.

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)

Parametrar

localEP
EndPoint

Den lokala EndPoint som ska associeras Socketmed .

Undantag

ArgumentNullException

localEP är null.

SocketException

Ett fel uppstod vid försök att komma åt socketen.

ObjectDisposedException

Har Socket stängts.

SecurityException

En anropare högre i anropsstacken har inte behörighet för den begärda åtgärden.

Exempel

Följande kodexempel binder en Socket med den angivna lokala slutpunkten.

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

Kommentarer

Bind Använd metoden om du behöver använda en specifik lokal slutpunkt. Du måste anropa Bind innan du kan anropa Listen metoden. Du behöver inte anropa Bind innan du använder Connect metoden om du inte behöver använda en specifik lokal slutpunkt. Du kan använda metoden för Bind både anslutningslösa och anslutningsorienterade protokoll.

Innan du anropar Bindmåste du först skapa den lokala IPEndPoint plats som du tänker kommunicera data från. Om du inte bryr dig om vilken lokal adress som tilldelas kan du skapa en IPEndPoint med som IPAddress.Any adressparameter, och den underliggande tjänstleverantören tilldelar den lämpligaste nätverksadressen. Detta kan förenkla programmet om du har flera nätverksgränssnitt. Om du inte bryr dig om vilken lokal port som används kan du skapa en IPEndPoint med 0 för portnumret. I det här fallet tilldelar tjänstleverantören ett tillgängligt portnummer mellan 1024 och 5 000.

Om du använder metoden ovan kan du identifiera vilken lokal nätverksadress och portnummer som har tilldelats genom att anropa LocalEndPoint. Om du använder ett anslutningsorienterat protokoll LocalEndPoint returnerar inte den lokalt tilldelade nätverksadressen förrän du har gjort ett anrop till Connect metoden eller EndConnect . Om du använder ett anslutningslöst protokoll har du inte åtkomst till den här informationen förrän du har slutfört en sändning eller mottagning.

Om en UDP-socket vill ta emot gränssnittsinformation om mottagna paket ska metoden uttryckligen anropas med socketalternativet inställt på omedelbart efter att PacketInformation metoden anropats.SetSocketOptionBind

Note

Om du tänker ta emot multicast-datagram måste du anropa Bind metoden med ett multicast-portnummer.

Note

Du måste anropa Bind metoden om du tänker ta emot anslutningslösa datagram med hjälp av ReceiveFrom metoden.

Note

Om du får en SocketException när du anropar Bind metoden använder du SocketException.ErrorCode egenskapen för att hämta den specifika felkoden. När du har fått den här koden läser du felkoden Windows Sockets version 2 för en detaljerad beskrivning av felet.

Note

Den här medlemmen matar ut spårningsinformation när du aktiverar nätverksspårning i ditt program. Mer information finns i Network Tracing in .NET Framework.

Gäller för

Se även