Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Socket.BeginReceiveMessageFrom-Methode: (Byte[], Int32, Int32, SocketFlags, EndPoint, AsyncCallback, Object)

 

Veröffentlicht: Oktober 2016

Startet die angegebene Anzahl von Datenbytes an der angegebenen Position im Datenpuffer unter Verwendung des angegebenen asynchron empfangen SocketFlags, und speichert die Endpunkt- und Paketinformationen...

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

public IAsyncResult BeginReceiveMessageFrom(
	byte[] buffer,
	int offset,
	int size,
	SocketFlags socketFlags,
	ref EndPoint remoteEP,
	AsyncCallback callback,
	object state
)

Parameter

buffer
Type: System.Byte[]

Ein Array vom Typ Byte den Speicherort für die empfangenen Daten.

offset
Type: System.Int32

Die nullbasierte Position in der buffer -Parameter, um die Daten zu speichern.

size
Type: System.Int32

Die Anzahl der zu empfangenden Bytes.

socketFlags
Type: System.Net.Sockets.SocketFlags

Eine bitweise Kombination der SocketFlags-Werte.

remoteEP
Type: System.Net.EndPoint

Ein EndPoint das die Quelle der Daten darstellt.

callback
Type: System.AsyncCallback

Der AsyncCallback-Delegat.

state
Type: System.Object

Ein Objekt mit Zustandsinformationen für diese Anforderung.

Rückgabewert

Type: System.IAsyncResult

Ein IAsyncResult das auf den asynchronen Lesevorgang verweist.

Exception Condition
ArgumentNullException

buffer ist null.

- oder -

remoteEP ist null.

SocketException

Fehler beim Versuch, auf den Socket zuzugreifen. Weitere Informationen finden Sie im Abschnitt Hinweise.

ArgumentOutOfRangeException

offset ist kleiner als 0.

- oder -

offset ist größer als die Länge des buffer.

- oder -

size ist kleiner als 0.

- oder -

size ist größer als die Länge des buffer minus dem Wert von der offset Parameter.

ObjectDisposedException

Der Socket wurde geschlossen.

NotSupportedException

Das Betriebssystem ist Windows 2000 oder früher, und diese Methode erfordert Windows XP.

Der asynchrone Empfangsvorgang abgeschlossen werden muss, durch Aufrufen der EndReceiveMessageFrom Methode. In der Regel wird die Methode aufgerufen, indem die asyncCallback delegieren.

Diese Methode wird nicht blockiert, bis der Vorgang abgeschlossen ist. Zum Blockieren, bis der Vorgang abgeschlossen ist, verwenden Sie die ReceiveMessageFrom Methode.

Abbrechen einer ausstehenden BeginReceiveMessageFrom, rufen Sie die Close Methode.

Ausführliche Informationen zur Verwendung des asynchronen Programmiermodells finden Sie unter Calling Synchronous Methods Asynchronously

Diese Methode liest Daten in den buffer -Parameter, und zeichnet den Remotehost-Endpunkt, von dem die Daten gesendet werden, sowie Informationen über das empfangene Paket. Informationen zum Abrufen dieses Endpunktes finden Sie unter EndReceiveFrom. Diese Methode ist besonders hilfreich, wenn Sie verbindungslose Datagramme von einem unbekannten Host oder mehreren Hosts asynchron empfangen möchten.

System_CAPS_noteHinweis

Erhalten Sie eine SocketException, verwenden Sie die SocketException.ErrorCode Eigenschaft, um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, finden Sie in der Windows Sockets-Version 2-API-Fehler-Code-Dokumentation in der MSDN Library für eine ausführliche Beschreibung des Fehlers.

System_CAPS_noteHinweis

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

System_CAPS_noteHinweis

Der Ausführungskontext (der Sicherheitskontext, die Identität eines Benutzers und dem aufrufenden Kontext) wird für die asynchrone zwischengespeichert Socket Methoden. Nach der ersten Verwendung eines bestimmten Kontexts (eine bestimmte asynchrone Socket Methode, eine bestimmte Socket -Instanz und ein bestimmter Rückruf), nachfolgenden Verwendungen werden eine Verbesserung der Leistung finden Sie unter.

.NET Framework
Verfügbar seit 2.0
Zurück zum Anfang
Anzeigen: