Socket.Bind(EndPoint) Methode

Definition

Ordnet einem Socket einen lokalen Endpunkt zu.Associates a Socket with a local endpoint.

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

Der lokale EndPoint, der dem Socket zugeordnet werden soll.The local EndPoint to associate with the Socket.

Ausnahmen

localEP ist null.localEP is null.

Fehler beim Versuch, auf den Socket zuzugreifen.An error occurred when attempting to access the socket.

Der Socket wurde geschlossen.The Socket has been closed.

Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.A caller higher in the call stack does not have permission for the requested operation.

Beispiele

Im folgenden Codebeispiel wird eine Socket mit dem angegebenen lokalen Endpunkt gebunden.The following code example binds a Socket using the specified local endpoint.

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

Hinweise

Verwenden Sie die Bind-Methode, wenn Sie einen bestimmten lokalen Endpunkt verwenden müssen.Use the Bind method if you need to use a specific local endpoint. Sie müssen Bind abrufen, bevor Sie die Listen-Methode abrufen können.You must call Bind before you can call the Listen method. Sie müssen Bind nicht vor der Verwendung der Connect-Methode anrufen, es sei denn, Sie müssen einen bestimmten lokalen Endpunkt verwenden.You do not need to call Bind before using the Connect method unless you need to use a specific local endpoint. Sie können die Bind-Methode für verbindungslose und Verbindungs orientierte Protokolle verwenden.You can use the Bind method on both connectionless and connection-oriented protocols.

Vor dem Aufrufen von Bindmüssen Sie zuerst den lokalen IPEndPoint erstellen, von dem aus Sie Daten übermitteln möchten.Before calling Bind, you must first create the local IPEndPoint from which you intend to communicate data. Wenn Sie nicht sicher sind, welche lokale Adresse zugewiesen ist, können Sie eine IPEndPoint mit IPAddress.Any als Adress Parameter erstellen, und der zugrunde liegende Dienstanbieter weist die am besten geeignete Netzwerkadresse zu.If you do not care which local address is assigned, you can create an IPEndPoint using IPAddress.Any as the address parameter, and the underlying service provider will assign the most appropriate network address. Dies kann dazu beitragen, Ihre Anwendung zu vereinfachen, wenn Sie über mehrere Netzwerkschnittstellen verfügen.This might help simplify your application if you have multiple network interfaces. Wenn Sie nicht sicher sind, welcher lokale Port verwendet wird, können Sie eine IPEndPoint mit 0 für die Portnummer erstellen.If you do not care which local port is used, you can create an IPEndPoint using 0 for the port number. In diesem Fall weist der Dienstanbieter eine verfügbare Portnummer zwischen 1024 und 5000 zu.In this case, the service provider will assign an available port number between 1024 and 5000.

Wenn Sie den oben genannten Ansatz verwenden, können Sie ermitteln, welche Adresse und Portnummer des lokalen Netzwerks zugewiesen wurden, indem Sie den LocalEndPointaufrufen.If you use the above approach, you can discover what local network address and port number has been assigned by calling the LocalEndPoint. Wenn Sie ein Verbindungs orientiertes Protokoll verwenden, gibt LocalEndPoint die lokal zugewiesene Netzwerkadresse erst zurück, nachdem Sie die Connect oder EndConnect-Methode aufgerufen haben.If you are using a connection-oriented protocol, LocalEndPoint will not return the locally assigned network address until after you have made a call to the Connect or EndConnect method. Wenn Sie ein verbindungsloses Protokoll verwenden, haben Sie erst dann Zugriff auf diese Informationen, wenn Sie einen Sende-oder Empfangsvorgang abgeschlossen haben.If you are using a connectionless protocol, you will not have access to this information until you have completed a send or receive.

Wenn ein UDP-Socket Schnittstellen Informationen zu empfangenen Paketen empfangen möchte, sollte die SetSocketOption Methode explizit aufgerufen werden, wobei die Socketoption auf PacketInformation unmittelbar nach dem Aufrufen der Bind-Methode festgelegt ist.If a UDP socket wants to receive interface information on received packets, the SetSocketOption method should be explicitly called with the socket option set to PacketInformation immediately after calling the Bind method.

Hinweis

Wenn Sie beabsichtigen, Multicast Datagramme zu empfangen, müssen Sie die Bind-Methode mit einer Multicast Portnummer abrufen.If you intend to receive multicast datagrams, you must call the Bind method with a multicast port number.

Hinweis

Sie müssen die Bind-Methode abrufen, wenn Sie verbindungslose Datagramme mithilfe der ReceiveFrom-Methode empfangen möchten.You must call the Bind method if you intend to receive connectionless datagrams using the ReceiveFrom method.

Hinweis

Wenn Sie beim Aufrufen der Bind-Methode eine SocketException erhalten, verwenden Sie die SocketException.ErrorCode-Eigenschaft, um den spezifischen Fehlercode abzurufen.If you receive a SocketException when calling the Bind method, use the SocketException.ErrorCode property to obtain the specific error code. Nachdem Sie diesen Code abgerufen haben, finden Sie in der API-Fehlercode Dokumentation der Windows Sockets, Version 2 , eine ausführliche Beschreibung des Fehlers.After you have obtained this code, refer to the Windows Sockets version 2 API error code documentation for a detailed description of the error.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren.This member outputs trace information when you enable network tracing in your application. Weitere Informationen finden Sie unter Netzwerk Ablauf Verfolgung in der .NET Framework.For more information, see Network Tracing in the .NET Framework.

Sicherheit

SocketPermission
zum Akzeptieren von Verbindungen von dem Host, der durch localEPdefiniert wird.for accepting connections from the host defined by localEP. Zugehörige Enumeration: AcceptAssociated enumeration: Accept

Gilt für:

Siehe auch