Freigeben über

Socket.Bind-Methode

  • Artikel

Ordnet einem Socket einen lokalen Endpunkt zu.

Namespace: System.Net.Sockets
Assembly: System (in system.dll)

Syntax

'Declaration
Public Sub Bind ( _
    localEP As EndPoint _
)
'Usage
Dim instance As Socket
Dim localEP As EndPoint

instance.Bind(localEP)

public void Bind (
    EndPoint localEP
)

public:
void Bind (
    EndPoint^ localEP
)

public void Bind (
    EndPoint localEP
)

public function Bind (
    localEP : EndPoint
)

Parameter

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

localEP ist NULL (Nothing in Visual Basic).

SocketException

Fehler beim Zugriff auf den Socket. Weitere Informationen finden Sie im Abschnitt Hinweise.

ObjectDisposedException

Der Socket wurde geschlossen.

SecurityException

Ein in der Aufrufliste übergeordneter Aufrufer hat keine Berechtigung für den angeforderten Vorgang.

Hinweise

Mit der Bind-Methode können Sie einen bestimmten lokalen Endpunkt angeben. Vor dem Aufruf der Listen-Methode müssen Sie die Bind-Methode aufrufen. Vor der Verwendung der Connect-Methode müssen Sie Bind nur dann aufrufen, wenn ein bestimmter lokaler Endpunkt verwendet werden muss. Die Bind-Methode ist sowohl für verbindungslose als auch für verbindungsorientierte Protokolle verwendbar.

Erstellen Sie zuerst den lokalen IPEndPoint für die Datenkommunikation, bevor Sie Bind aufrufen. Wenn unwichtig ist, welche lokale Adresse zugewiesen wird, können Sie einen IPEndPoint mit IPAddress.Any als Adressparameter erstellen. In diesem Fall weist der Dienstanbieter die am besten geeignete Netzwerkadresse zu. Dadurch wird die Anwendung bei der Verwendung mehrerer Netzwerkschnittstellen einfacher. Wenn unwichtig ist, welcher lokale Anschluss verwendet wird, können Sie einen IPEndPoint mit 0 als Anschlussnummer erstellen. In diesem Fall weist der Dienstanbieter eine verfügbare Anschlussnummer zwischen 1024 und 5000 zu.

Wenn Sie auf diese Weise verfahren, können Sie die zugewiesene lokale Netzwerkadresse und Anschlussnummer über einen Aufruf von LocalEndPoint feststellen. Bei einem verbindungsorientierten Protokoll gibt LocalEndPoint die lokal zugewiesene Netzwerkadresse erst zurück, wenn Sie die Connect-Methode oder die EndConnect-Methode aufgerufen haben. Wenn Sie ein verbindungsloses Protokoll verwenden, können Sie erst auf diese Informationen zugreifen, wenn Sie einen Sende- oder Empfangsvorgang abgeschlossen haben.

Hinweis

Wenn Sie Multicastdatagramme empfangen möchten, müssen Sie die Bind-Methode mit einer Multicast-Anschlussnummer aufrufen.

Hinweis

Wenn Sie verbindungslose Datagramme mit der ReceiveFrom-Methode empfangen möchten, müssen Sie die Bind-Methode aufrufen.

Hinweis

Wenn beim Aufrufen der Bind-Methode eine SocketException ausgelöst wird, können Sie den spezifischen Fehlercode mit der SocketException.ErrorCode-Eigenschaft abrufen. Nachdem Sie diesen Code abgerufen haben, finden Sie in der Dokumentation der MSDN Library zu API-Fehlercodes unter Windows Sockets, Version 2, eine ausführliche Beschreibung des Fehlers.

Hinweis

Dieser Member gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in der Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung.

Beispiel

Im folgenden Codebeispiel wird ein Socket unter Verwendung des angegebenen lokalen Endpunktes gebunden.

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

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

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

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

.NET Framework-Sicherheit

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Socket-Klasse
Socket-Member
System.Net.Sockets-Namespace
IPEndPoint-Klasse
Connect
Listen
IPAddress-Klasse
LocalEndPoint