Socket.Receive Methode

Quelle:

Socket.cs

Quelle:

Socket.cs

Quelle:

Socket.cs

public:
 int Receive(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode);

public int Receive (byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode);

member this.Receive : byte[] * int * int * System.Net.Sockets.SocketFlags * SocketError -> int

Public Function Receive (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, ByRef errorCode As SocketError) As Integer

Parameter

Gibt zurück

Die Anzahl der empfangenen Bytes.

Ausnahmen

Hinweise

Die Receive -Methode liest Daten in den Pufferparameter und gibt die Anzahl der bytes zurück, die erfolgreich gelesen wurden. Sie können sowohl verbindungsorientierte als auch verbindungslose Sockets aufrufen Receive .

Wenn Sie ein verbindungsorientiertes Protokoll verwenden, müssen Sie entweder aufrufen Connect , um eine Remotehostverbindung herzustellen, oder Accept um eine eingehende Verbindung zu akzeptieren, bevor Sie aufrufen Receive. Die Receive -Methode liest nur Daten, die von dem Remotehost empfangen werden, der in der - oder Accept -ConnectMethode eingerichtet wurde. Wenn Sie ein verbindungsloses Protokoll verwenden, können Sie auch die ReceiveFrom -Methode verwenden. ReceiveFrom ermöglicht es Ihnen, Daten zu empfangen, die von einem beliebigen Host empfangen werden.

Wenn keine Daten zum Lesen verfügbar sind, blockiert die Receive -Methode, bis Daten verfügbar sind, es sei denn, ein Timeoutwert wurde mithilfe Socket.ReceiveTimeoutvon festgelegt. Wenn der Timeoutwert überschritten wurde, löst der Receive Aufruf eine aus SocketException. Wenn Sie sich im nicht blockierenden Modus befinden und keine Daten im Protokollstapelpuffer verfügbar sind, wird die Receive -Methode sofort abgeschlossen und löst eine aus SocketException. Fehler beim Versuch, auf den Socket zuzugreifen. Weitere Informationen finden Sie weiter unten in den Hinweisen. Sie können die Available -Eigenschaft verwenden, um zu bestimmen, ob Daten zum Lesen verfügbar sind. Wenn Available ungleich 0 ist, wiederholen Sie den Empfangsvorgang.

Wenn Sie ein verbindungsorientiertes Socketverwenden, liest die Receive -Methode so viele daten, wie verfügbar sind, bis zu der Anzahl von Bytes, die vom size-Parameter angegeben werden. Wenn der Remotehost die Verbindung mit der SocketShutdown -Methode beendet und alle verfügbaren Daten empfangen wurden, wird die Receive Methode sofort abgeschlossen und gibt null Bytes zurück.

Wenn Sie ein verbindungsloses Socketverwenden, Receive liest das erste Datagramm in der Warteschlange aus der Zieladresse, die Sie in der Connect -Methode angeben. Wenn das empfangene Datagramm größer als die Größe des buffer Parameters ist, buffer mit dem ersten Teil der Nachricht gefüllt wird, gehen die überschüssigen Daten verloren, und es wird ein SocketException ausgelöst.

Weitere Informationen

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Quelle:

Socket.cs

Quelle:

Socket.cs

Quelle:

Socket.cs

public:
 int Receive(Span<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode);

public int Receive (Span<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode);

member this.Receive : Span<byte> * System.Net.Sockets.SocketFlags * SocketError -> int

Public Function Receive (buffer As Span(Of Byte), socketFlags As SocketFlags, ByRef errorCode As SocketError) As Integer

Parameter

Gibt zurück

Die Anzahl der empfangenen Bytes.

Ausnahmen

Hinweise

Die Receive -Methode liest Daten in den Pufferparameter und gibt die Anzahl der bytes zurück, die erfolgreich gelesen wurden. Sie können sowohl verbindungsorientierte als auch verbindungslose Sockets aufrufen Receive .

Für diese Überladung müssen Sie nur einen Empfangspuffer bereitstellen. Der Pufferoffset ist standardmäßig 0, die Größe ist standardmäßig die Länge des Pufferparameters, und der SocketFlags Wert ist standardmäßig auf None.

Wenn Sie ein verbindungsorientiertes Protokoll verwenden, müssen Sie entweder aufrufen Connect , um eine Remotehostverbindung herzustellen, oder Accept um eine eingehende Verbindung zu akzeptieren, bevor Sie aufrufen Receive. Die Receive -Methode liest nur Daten, die von dem Remotehost empfangen werden, der in der - oder Accept -ConnectMethode eingerichtet wurde. Wenn Sie ein verbindungsloses Protokoll verwenden, können Sie auch die ReceiveFrom -Methode verwenden. ReceiveFrom ermöglicht es Ihnen, Daten zu empfangen, die von einem beliebigen Host empfangen werden.

Wenn keine Daten zum Lesen verfügbar sind, blockiert die Receive -Methode, bis Daten verfügbar sind, es sei denn, ein Timeoutwert wurde mithilfe Socket.ReceiveTimeoutvon festgelegt. Wenn der Timeoutwert überschritten wird, löst der Receive Aufruf eine aus SocketException. Wenn Sie sich im nicht blockierenden Modus befinden und keine Daten im Protokollstapelpuffer verfügbar sind, wird die Receive -Methode sofort abgeschlossen und löst eine aus SocketException. Sie können die Available -Eigenschaft verwenden, um zu bestimmen, ob Daten zum Lesen verfügbar sind. Wenn Available ungleich 0 ist, wiederholen Sie den Empfangsvorgang.

Wenn Sie einen verbindungsorientierten Socketverwenden, liest die Receive -Methode bis zur Größe des Puffers so viele Daten, wie verfügbar sind. Wenn der Remotehost die Verbindung mit der SocketShutdown -Methode beendet und alle verfügbaren Daten empfangen wurden, wird die Receive Methode sofort abgeschlossen und gibt null Bytes zurück.

Wenn Sie ein verbindungsloses Socketverwenden, Receive liest das erste Datagramm in der Warteschlange aus der Zieladresse, die Sie in der Connect -Methode angeben. Wenn das empfangene Datagramm größer als die Größe des buffer Parameters ist, buffer mit dem ersten Teil der Nachricht gefüllt wird, gehen die überschüssigen Daten verloren, und es wird ein SocketException ausgelöst.

Weitere Informationen

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Quelle:

Socket.cs

Quelle:

Socket.cs

Quelle:

Socket.cs

public:
 int Receive(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode);

public int Receive (System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode);

member this.Receive : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags * SocketError -> int

Public Function Receive (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags, ByRef errorCode As SocketError) As Integer

Parameter

Gibt zurück

Die Anzahl der empfangenen Bytes.

Ausnahmen

Hinweise

Diese Methode liest Daten in den buffers Parameter und gibt die Anzahl der erfolgreich gelesenen Bytes zurück. Sie können sowohl verbindungsorientierte als auch verbindungslose Sockets aufrufen.

Für diese Überladung müssen Sie einen oder mehrere Empfangspuffer bereitstellen. Der SocketFlags Wert ist Nonestandardmäßig .

Wenn Sie ein verbindungsorientiertes Protokoll verwenden, müssen Sie entweder aufrufen Connect , um eine Remotehostverbindung herzustellen, oder Accept um eine eingehende Verbindung zu akzeptieren, bevor Sie aufrufen Receive. Die Receive -Methode liest nur Daten, die von der Remotehostverbindung empfangen werden, die in der - oder Accept -ConnectMethode eingerichtet wurde. Wenn Sie ein verbindungsloses Protokoll verwenden, können Sie auch die ReceiveFrom -Methode verwenden. ReceiveFrom ermöglicht es Ihnen, Daten zu empfangen, die von einem beliebigen Host empfangen werden.

Wenn keine Daten zum Lesen verfügbar sind, blockiert die Receive -Methode, bis Daten verfügbar sind, es sei denn, ein Timeoutwert wurde mithilfe Socket.ReceiveTimeoutvon festgelegt. Wenn der Timeoutwert überschritten wurde, löst der Receive Aufruf eine aus SocketException. Wenn Sie sich im nicht blockierenden Modus befinden und keine Daten im Protokollstapelpuffer verfügbar sind, wird die Receive -Methode sofort abgeschlossen und löst eine aus SocketException. Sie können die Available -Eigenschaft verwenden, um zu bestimmen, ob Daten zum Lesen verfügbar sind. Wenn Available ungleich 0 ist, wiederholen Sie den Empfangsvorgang.

Wenn Sie ein verbindungsorientiertes Socketverwenden, liest die Receive -Methode bis zur Größe des Puffers so viele Daten, wie verfügbar sind. Wenn der Remotehost die Verbindung mit der SocketShutdown -Methode beendet und alle verfügbaren Daten empfangen wurden, wird die Receive Methode sofort abgeschlossen und gibt null Bytes zurück.

Wenn Sie ein verbindungsloses Socketverwenden,Receive liest das erste Datagramm in der Warteschlange aus der Zieladresse, die Sie in der Connect -Methode angeben. Wenn das empfangene Datagramm größer als die Größe des buffers Parameters ist, buffers mit dem ersten Teil der Nachricht gefüllt wird, gehen die überschüssigen Daten verloren, und es wird ein SocketException ausgelöst.

Weitere Informationen

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Quelle:

Socket.cs

Quelle:

Socket.cs

Quelle:

Socket.cs

public:
 int Receive(cli::array <System::Byte> ^ buffer, int size, System::Net::Sockets::SocketFlags socketFlags);

public int Receive (byte[] buffer, int size, System.Net.Sockets.SocketFlags socketFlags);

member this.Receive : byte[] * int * System.Net.Sockets.SocketFlags -> int

Public Function Receive (buffer As Byte(), size As Integer, socketFlags As SocketFlags) As Integer

Parameter

Gibt zurück

Die Anzahl der empfangenen Bytes.

Ausnahmen

Beispiele

Im Folgenden werden die in buffergefundenen Daten empfangen und für SocketFlagsangegebenNone.

// Receive the host home page content and loop until all the data is received.
Int32 bytes = s->Receive( RecvBytes, RecvBytes->Length, SocketFlags::None );
strRetPage =  "Default HTML page on ";
strRetPage->Concat( server,  ":\r\n", ASCII->GetString( RecvBytes, 0, bytes ) );
while ( bytes > 0 )
{
   bytes = s->Receive( RecvBytes, RecvBytes->Length, SocketFlags::None );
   strRetPage->Concat( ASCII->GetString( RecvBytes, 0, bytes ) );
}

// Receive the host home page content and loop until all the data is received.
Int32 bytes = s.Receive(RecvBytes, RecvBytes.Length, 0);
strRetPage = "Default HTML page on " + server + ":\r\n";
strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes);

while (bytes > 0)
{
  bytes = s.Receive(RecvBytes, RecvBytes.Length, 0);
  strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes);
}

' Receive the host home page content and loop until all the data is received.

'Dim bytes As Int32 = s.Receive(RecvBytes, RecvBytes.Length, 0)
Dim bytes As Int32 = s.Receive(RecvBytes, RecvBytes.Length, 0)

strRetPage = "Default HTML page on " + server + ":\r\n"
strRetPage = "Default HTML page on " + server + ":" + ControlChars.Lf + ControlChars.NewLine

Dim i As Integer

While bytes > 0

  bytes = s.Receive(RecvBytes, RecvBytes.Length, 0)

  strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes)

End While

Hinweise

Die Receive -Methode liest Daten in den buffer Parameter und gibt die Anzahl der erfolgreich gelesenen Bytes zurück. Sie können sowohl verbindungsorientierte als auch verbindungslose Sockets aufrufen Receive .

Diese Überladung erfordert nur, dass Sie einen Empfangspuffer, die Anzahl der Bytes, die Sie empfangen möchten, und die erforderliche SocketFlagsangeben.

Wenn Sie ein verbindungsorientiertes Protokoll verwenden, müssen Sie entweder aufrufen Connect , um eine Remotehostverbindung herzustellen, oder Accept um eine eingehende Verbindung zu akzeptieren, bevor Sie aufrufen Receive. Die Receive -Methode liest nur Daten, die von dem Remotehost empfangen werden, der in der - oder Accept -ConnectMethode eingerichtet wurde. Wenn Sie ein verbindungsloses Protokoll verwenden, können Sie auch die ReceiveFrom -Methode verwenden. ReceiveFrom ermöglicht es Ihnen, Daten zu empfangen, die von einem beliebigen Host empfangen werden.

Wenn keine Daten zum Lesen verfügbar sind, blockiert die Receive -Methode, bis Daten verfügbar sind, es sei denn, ein Timeoutwert wurde mithilfe Socket.ReceiveTimeoutvon festgelegt. Wenn der Timeoutwert überschritten wurde, löst der Receive Aufruf eine aus SocketException. Wenn Sie sich im nicht blockierenden Modus befinden und keine Daten im Protokollstapelpuffer verfügbar sind, wird die Receive -Methode sofort abgeschlossen und löst eine aus SocketException. Sie können die Available -Eigenschaft verwenden, um zu bestimmen, ob Daten zum Lesen verfügbar sind. Wenn Available ungleich 0 (null) ist, wiederholen Sie den Empfangsvorgang.

Wenn Sie eine verbindungsorientierte Socketverwenden, liest die Receive -Methode so viele Daten, wie verfügbar sind, bis zu der Anzahl von Bytes, die size vom Parameter angegeben werden. Wenn der Remotehost die Verbindung mit der SocketShutdown -Methode beendet und alle verfügbaren Daten empfangen wurden, wird die Receive Methode sofort abgeschlossen und gibt null Bytes zurück.

Wenn Sie ein verbindungsloses Socketverwenden, Receive liest das erste Datagramm in der Warteschlange aus der Zieladresse, die Sie in der Connect -Methode angeben. Wenn das empfangene Datagramm größer als die Größe des buffer Parameters ist, buffer mit dem ersten Teil der Nachricht gefüllt wird, gehen die überschüssigen Daten verloren, und es wird ein SocketException ausgelöst.

Weitere Informationen

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Quelle:

Socket.cs

Quelle:

Socket.cs

Quelle:

Socket.cs

public:
 int Receive(Span<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags);

public int Receive (Span<byte> buffer, System.Net.Sockets.SocketFlags socketFlags);

member this.Receive : Span<byte> * System.Net.Sockets.SocketFlags -> int

Public Function Receive (buffer As Span(Of Byte), socketFlags As SocketFlags) As Integer

Parameter

Gibt zurück

Die Anzahl der empfangenen Bytes.

Ausnahmen

Hinweise

Die Receive -Methode liest Daten in den Pufferparameter und gibt die Anzahl der bytes zurück, die erfolgreich gelesen wurden. Sie können sowohl verbindungsorientierte als auch verbindungslose Sockets aufrufen Receive .

Für diese Überladung müssen Sie nur einen Empfangspuffer bereitstellen. Der Pufferoffset ist standardmäßig 0, die Größe ist standardmäßig die Länge des Pufferparameters, und der SocketFlags Wert ist standardmäßig auf None.

Wenn Sie ein verbindungsorientiertes Protokoll verwenden, müssen Sie entweder aufrufen Connect , um eine Remotehostverbindung herzustellen, oder Accept um eine eingehende Verbindung zu akzeptieren, bevor Sie aufrufen Receive. Die Receive -Methode liest nur Daten, die von dem Remotehost empfangen werden, der in der - oder Accept -ConnectMethode eingerichtet wurde. Wenn Sie ein verbindungsloses Protokoll verwenden, können Sie auch die ReceiveFrom -Methode verwenden. ReceiveFrom ermöglicht es Ihnen, Daten zu empfangen, die von einem beliebigen Host empfangen werden.

Wenn keine Daten zum Lesen verfügbar sind, blockiert die Receive -Methode, bis Daten verfügbar sind, es sei denn, ein Timeoutwert wurde mithilfe Socket.ReceiveTimeoutvon festgelegt. Wenn der Timeoutwert überschritten wird, löst der Receive Aufruf eine aus SocketException. Wenn Sie sich im nicht blockierenden Modus befinden und keine Daten im Protokollstapelpuffer verfügbar sind, wird die Receive -Methode sofort abgeschlossen und löst eine aus SocketException. Sie können die Available -Eigenschaft verwenden, um zu bestimmen, ob Daten zum Lesen verfügbar sind. Wenn Available ungleich 0 ist, wiederholen Sie den Empfangsvorgang.

Wenn Sie einen verbindungsorientierten Socketverwenden, liest die Receive -Methode bis zur Größe des Puffers so viele Daten, wie verfügbar sind. Wenn der Remotehost die Verbindung mit der SocketShutdown -Methode beendet und alle verfügbaren Daten empfangen wurden, wird die Receive Methode sofort abgeschlossen und gibt null Bytes zurück.

Wenn Sie ein verbindungsloses Socketverwenden, Receive liest das erste Datagramm in der Warteschlange aus der Zieladresse, die Sie in der Connect -Methode angeben. Wenn das empfangene Datagramm größer als die Größe des buffer Parameters ist, buffer mit dem ersten Teil der Nachricht gefüllt wird, gehen die überschüssigen Daten verloren, und ein SocketException wird ausgelöst.

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

Weitere Informationen

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Quelle:

Socket.cs

Quelle:

Socket.cs

Quelle:

Socket.cs

public:
 int Receive(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags);

public int Receive (byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags);

member this.Receive : byte[] * int * int * System.Net.Sockets.SocketFlags -> int

Public Function Receive (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags) As Integer

Parameter

Gibt zurück

Die Anzahl der empfangenen Bytes.

Ausnahmen

Beispiele

Das folgende Codebeispiel gibt einen Datenpuffer, einen Offset, eine Größe und ein Socketflag an, bevor Daten auf einem verbundenen Socketempfangen werden.

// Displays sending with a connected socket
// using the overload that takes a buffer, offset, message size, and socket flags.
int SendReceiveTest4( Socket^ server )
{
   array<Byte>^ msg = Encoding::UTF8->GetBytes( "This is a test" );
   array<Byte>^ bytes = gcnew array<Byte>(256);
   try
   {
      
      // Blocks until send returns.
      int byteCount = server->Send( msg, 0, msg->Length, SocketFlags::None );
      Console::WriteLine( "Sent {0} bytes.", byteCount.ToString() );
      
      // Get reply from the server.
      byteCount = server->Receive( bytes, 0, server->Available,
         SocketFlags::None );
      if ( byteCount > 0 )
      {
         Console::WriteLine( Encoding::UTF8->GetString( bytes ) );
      }
   }
   catch ( SocketException^ e ) 
   {
      Console::WriteLine(  "{0} Error code: {1}.", e->Message, e->ErrorCode.ToString() );
      return (e->ErrorCode);
   }
   return 0;
}

// Displays sending with a connected socket
// using the overload that takes a buffer, offset, message size, and socket flags.
public static int SendReceiveTest4(Socket server)
{
    byte[] msg = Encoding.UTF8.GetBytes("This is a test");
    byte[] bytes = new byte[256];
    try
    {
        // Blocks until send returns.
        int byteCount = server.Send(msg, 0, msg.Length, SocketFlags.None);
        Console.WriteLine("Sent {0} bytes.", byteCount);

        // Get reply from the server.
        byteCount = server.Receive(bytes, 0, bytes.Length, SocketFlags.None);

        if (byteCount > 0)
            Console.WriteLine(Encoding.UTF8.GetString(bytes, 0, byteCount));
    }
    catch (SocketException e)
    {
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode);
        return (e.ErrorCode);
    }
    return 0;
}

' Displays sending with a connected socket
' using the overload that takes a buffer, offset, message size, and socket flags.
Public Shared Function SendReceiveTest4(ByVal server As Socket) As Integer 
    Dim msg As Byte() = Encoding.UTF8.GetBytes("This is a test")
    Dim bytes(255) As Byte
    Try
        ' Blocks until send returns.
        Dim byteCount As Integer = server.Send(msg, 0, msg.Length, SocketFlags.None)
        Console.WriteLine("Sent {0} bytes.", byteCount)
        
        ' Get reply from the server.
        byteCount = server.Receive(bytes, 0, server.Available, SocketFlags.None)
        
        If byteCount > 0 Then
            Console.WriteLine(Encoding.UTF8.GetString(bytes))
        End If
    Catch e As SocketException
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode)
        Return e.ErrorCode
    End Try
    Return 0

End Function 'SendReceiveTest4

Hinweise

Die Receive Methode liest Daten in den Pufferparameter und gibt die Anzahl der Bytes zurück, die erfolgreich gelesen wurden. Sie können sowohl verbindungsorientierte als auch verbindungslose Sockets aufrufen Receive .

Wenn Sie ein verbindungsorientiertes Protokoll verwenden, müssen Sie entweder aufrufen Connect , um eine Remotehostverbindung herzustellen, oder Accept um eine eingehende Verbindung zu akzeptieren, bevor Sie aufrufen Receive. Die Receive -Methode liest nur Daten, die von dem Remotehost empfangen werden, der in der Connect -Methode oder Accept eingerichtet ist. Wenn Sie ein verbindungsloses Protokoll verwenden, können Sie auch die ReceiveFrom -Methode verwenden. ReceiveFrom ermöglicht es Ihnen, Daten zu empfangen, die von einem beliebigen Host eintreffen.

Wenn keine Daten zum Lesen verfügbar sind, blockiert die Receive -Methode, bis Daten verfügbar sind, es sei denn, ein Timeoutwert wurde mithilfe Socket.ReceiveTimeoutvon festgelegt. Wenn der Timeoutwert überschritten wurde, löst der Receive Aufruf einen aus SocketException. Wenn Sie sich im nicht blockierenden Modus befinden und keine Daten im Protokollstapelpuffer verfügbar sind, wird die Receive -Methode sofort abgeschlossen und löst einen aus SocketException. Fehler beim Versuch, auf den Socket zuzugreifen. Weitere Informationen finden Sie unter Hinweise. Sie können die Available -Eigenschaft verwenden, um zu bestimmen, ob Daten zum Lesen verfügbar sind. Wenn Available ungleich 0 ist, wiederholen Sie den Empfangsvorgang.

Wenn Sie eine verbindungsorientierte SocketMethode verwenden, liest die Receive -Methode so viele Daten, wie verfügbar sind, bis zur Anzahl von Bytes, die durch den Size-Parameter angegeben werden. Wenn der Remotehost die Verbindung mit der SocketShutdown -Methode beendet und alle verfügbaren Daten empfangen wurden, wird die Receive Methode sofort abgeschlossen und gibt null Bytes zurück.

Wenn Sie ein verbindungsloses Socketverwenden, Receive liest das erste Datagramm in der Warteschlange aus der Zieladresse, die Sie in der Connect -Methode angeben. Wenn das empfangene Datagramm größer als die Größe des buffer Parameters ist, buffer wird mit dem ersten Teil der Nachricht gefüllt, gehen die überschüssigen Daten verloren und ein SocketException wird ausgelöst.

Weitere Informationen

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Quelle:

Socket.cs

Quelle:

Socket.cs

Quelle:

Socket.cs

public:
 int Receive(cli::array <System::Byte> ^ buffer, System::Net::Sockets::SocketFlags socketFlags);

public int Receive (byte[] buffer, System.Net.Sockets.SocketFlags socketFlags);

member this.Receive : byte[] * System.Net.Sockets.SocketFlags -> int

Public Function Receive (buffer As Byte(), socketFlags As SocketFlags) As Integer

Parameter

Gibt zurück

Die Anzahl der empfangenen Bytes.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird ein Datenpuffer und SocketFlags für den Empfang von Daten für eine verbundene Socketangegeben.

// Displays sending with a connected socket
// using the overload that takes a buffer and socket flags.
int SendReceiveTest2( Socket^ server )
{
   array<Byte>^ msg = Encoding::UTF8->GetBytes( "This is a test" );
   array<Byte>^ bytes = gcnew array<Byte>(256);
   try
   {
      // Blocks until send returns.
      int byteCount = server->Send( msg, SocketFlags::None );
      Console::WriteLine( "Sent {0} bytes.", byteCount.ToString() );
      
      // Get reply from the server.
      byteCount = server->Receive( bytes, SocketFlags::None );
      if ( byteCount > 0 )
      {
         Console::WriteLine( Encoding::UTF8->GetString( bytes ) );
      }
   }
   catch ( SocketException^ e ) 
   {
      Console::WriteLine( "{0} Error code: {1}.", e->Message, e->ErrorCode.ToString() );
      return (e->ErrorCode);
   }
   return 0;
}

// Displays sending with a connected socket
// using the overload that takes a buffer and socket flags.
public static int SendReceiveTest2(Socket server)
{
    byte[] msg = Encoding.UTF8.GetBytes("This is a test");
    byte[] bytes = new byte[256];
    try
    {
        // Blocks until send returns.
        int byteCount = server.Send(msg, SocketFlags.None);
        Console.WriteLine("Sent {0} bytes.", byteCount);

        // Get reply from the server.
        byteCount = server.Receive(bytes, SocketFlags.None);
        if (byteCount > 0)
            Console.WriteLine(Encoding.UTF8.GetString(bytes));
    }
    catch (SocketException e)
    {
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode);
        return (e.ErrorCode);
    }
    return 0;
}

' Displays sending with a connected socket
' using the overload that takes a buffer and socket flags.
Public Shared Function SendReceiveTest2(ByVal server As Socket) As Integer 
    Dim msg As Byte() = Encoding.UTF8.GetBytes("This is a test")
    Dim bytes(255) As Byte
    Try
        ' Blocks until send returns.
        Dim byteCount As Integer = server.Send(msg, SocketFlags.None)
        Console.WriteLine("Sent {0} bytes.", byteCount)
        
        ' Get reply from the server.
        byteCount = server.Receive(bytes, SocketFlags.None)
        If byteCount > 0 Then
            Console.WriteLine(Encoding.UTF8.GetString(bytes))
        End If
    Catch e As SocketException
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode)
        Return e.ErrorCode
    End Try
    Return 0

End Function 'SendReceiveTest2

Hinweise

Die Receive Methode liest Daten in den Pufferparameter und gibt die Anzahl der Bytes zurück, die erfolgreich gelesen wurden. Sie können sowohl verbindungsorientierte als auch verbindungslose Sockets aufrufen Receive .

Für diese Überladung müssen Sie nur einen Empfangspuffer und die erforderlichen SocketFlagsbereitstellen. Der Pufferoffset ist standardmäßig 0, und die Größe wird standardmäßig auf die Länge des Byteparameters festgelegt.

Wenn Sie ein verbindungsorientiertes Protokoll verwenden, müssen Sie entweder aufrufen Connect , um eine Remotehostverbindung herzustellen, oder Accept um eine eingehende Verbindung zu akzeptieren, bevor Sie aufrufen Receive. Die Receive -Methode liest nur Daten, die von dem Remotehost empfangen werden, der in der Connect -Methode oder Accept eingerichtet ist. Wenn Sie ein verbindungsloses Protokoll verwenden, können Sie auch die ReceiveFrom -Methode verwenden. ReceiveFrom ermöglicht es Ihnen, Daten zu empfangen, die von einem beliebigen Host eintreffen.

Wenn keine Daten zum Lesen verfügbar sind, wird die Receive -Methode blockiert, bis Daten verfügbar sind. Wenn Sie sich im nicht blockierenden Modus befinden und keine Daten im Protokollstapelpuffer verfügbar sind, wird die Receive -Methode sofort abgeschlossen und löst einen aus SocketException. Sie können die Available -Eigenschaft verwenden, um zu bestimmen, ob Daten zum Lesen verfügbar sind. Wenn Available ungleich 0 ist, wiederholen Sie den Empfangsvorgang.

Wenn Sie eine verbindungsorientierte SocketMethode verwenden, liest die Receive Methode so viele Daten, wie verfügbar sind, bis zur Größe des Puffers. Wenn der Remotehost die Verbindung mit der SocketShutdown -Methode beendet und alle verfügbaren Daten empfangen wurden, wird die Receive Methode sofort abgeschlossen und gibt null Bytes zurück.

Wenn Sie ein verbindungsloses Socketverwenden, Receive liest das erste queuierte Datagramm aus der Zieladresse, die Sie in der Connect -Methode angeben. Wenn das empfangene Datagramm größer als die Größe des buffer Parameters ist, buffer wird mit dem ersten Teil der Nachricht gefüllt, gehen die überschüssigen Daten verloren und ein SocketException wird ausgelöst.

Weitere Informationen

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Quelle:

Socket.cs

Quelle:

Socket.cs

Quelle:

Socket.cs

public:
 int Receive(Span<System::Byte> buffer);

public int Receive (Span<byte> buffer);

member this.Receive : Span<byte> -> int

Public Function Receive (buffer As Span(Of Byte)) As Integer

Parameter

Gibt zurück

Die Anzahl der empfangenen Bytes.

Ausnahmen

Hinweise

Die Receive Methode liest Daten in den Pufferparameter und gibt die Anzahl der Bytes zurück, die erfolgreich gelesen wurden. Sie können sowohl verbindungsorientierte als auch verbindungslose Sockets aufrufen Receive .

Für diese Überladung müssen Sie nur einen Empfangspuffer bereitstellen. Der Pufferoffset ist standardmäßig 0, die Größe wird standardmäßig auf die Länge des Pufferparameters festgelegt, und der SocketFlags Wert ist standardmäßig auf None.

Wenn Sie ein verbindungsorientiertes Protokoll verwenden, müssen Sie entweder aufrufen Connect , um eine Remotehostverbindung herzustellen, oder Accept um eine eingehende Verbindung zu akzeptieren, bevor Sie aufrufen Receive. Die Receive -Methode liest nur Daten, die von dem Remotehost empfangen werden, der in der Connect -Methode oder Accept eingerichtet ist. Wenn Sie ein verbindungsloses Protokoll verwenden, können Sie auch die ReceiveFrom -Methode verwenden. ReceiveFrom ermöglicht es Ihnen, Daten zu empfangen, die von einem beliebigen Host eintreffen.

Wenn keine Daten zum Lesen verfügbar sind, blockiert die Receive -Methode, bis Daten verfügbar sind, es sei denn, ein Timeoutwert wurde mithilfe Socket.ReceiveTimeoutvon festgelegt. Wenn der Timeoutwert überschritten wird, löst der Receive Aufruf einen aus SocketException. Wenn Sie sich im nicht blockierenden Modus befinden und im Protokollstapelpuffer keine Daten verfügbar sind, wird die Receive -Methode sofort abgeschlossen und löst einen aus SocketException. Sie können die Available -Eigenschaft verwenden, um zu bestimmen, ob Daten zum Lesen verfügbar sind. Wenn Available ungleich 0 ist, wiederholen Sie den Empfangsvorgang.

Wenn Sie eine verbindungsorientierte SocketMethode verwenden, liest die Receive Methode so viele Daten, wie verfügbar sind, bis zur Größe des Puffers. Wenn der Remotehost die Verbindung mit der SocketShutdown -Methode beendet und alle verfügbaren Daten empfangen wurden, wird die Receive Methode sofort abgeschlossen und gibt null Bytes zurück.

Wenn Sie ein verbindungsloses Socketverwenden, Receive liest das erste Datagramm in der Warteschlange von der Zieladresse, die Sie in der Connect -Methode angeben. Wenn das empfangene Datagramm größer als die Größe des buffer Parameters ist, buffer wird mit dem ersten Teil der Nachricht gefüllt, die überschüssigen Daten gehen verloren, und ein SocketException wird ausgelöst.

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

Weitere Informationen

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Quelle:

Socket.cs

Quelle:

Socket.cs

Quelle:

Socket.cs

public:
 int Receive(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers);

public int Receive (System.Collections.Generic.IList<ArraySegment<byte>> buffers);

member this.Receive : System.Collections.Generic.IList<ArraySegment<byte>> -> int

Public Function Receive (buffers As IList(Of ArraySegment(Of Byte))) As Integer

Parameter

Gibt zurück

Die Anzahl der empfangenen Bytes.

Ausnahmen

Hinweise

Diese Methode liest Daten in den Pufferparameter ein und gibt die Anzahl der Bytes zurück, die erfolgreich gelesen wurden. Sie können sowohl verbindungsorientierte als auch verbindungslose Sockets aufrufen.

Für diese Überladung müssen Sie mindestens einen Empfangspuffer bereitstellen.

Wenn Sie ein verbindungsorientiertes Protokoll verwenden, müssen Sie entweder aufrufen Connect , um eine Remotehostverbindung herzustellen, oder Accept um eine eingehende Verbindung zu akzeptieren, bevor Sie aufrufen Receive. Die Receive -Methode liest nur Daten, die von der Remotehostverbindung empfangen werden, die in der - oder Accept -ConnectMethode eingerichtet wurde. Wenn Sie ein verbindungsloses Protokoll verwenden, können Sie auch die ReceiveFrom -Methode verwenden. ReceiveFrom ermöglicht es Ihnen, Daten zu empfangen, die von einem beliebigen Host empfangen werden.

Wenn keine Daten zum Lesen verfügbar sind, blockiert die Receive -Methode, bis Daten verfügbar sind, es sei denn, ein Timeoutwert wurde mithilfe Socket.ReceiveTimeoutvon festgelegt. Wenn der Timeoutwert überschritten wurde, löst der Receive Aufruf eine aus SocketException. Wenn Sie sich im nicht blockierenden Modus befinden und keine Daten im Protokollstapelpuffer verfügbar sind, wird die Receive -Methode sofort abgeschlossen und löst eine aus SocketException. Sie können die Available -Eigenschaft verwenden, um zu bestimmen, ob Daten zum Lesen verfügbar sind. Wenn Available ungleich 0 ist, wiederholen Sie den Empfangsvorgang.

Wenn Sie ein verbindungsorientiertes Socketverwenden, liest die Receive -Methode bis zur Größe des Puffers so viele Daten, wie verfügbar sind. Wenn der Remotehost die Verbindung mit der SocketShutdown -Methode beendet und alle verfügbaren Daten empfangen wurden, wird die Receive Methode sofort abgeschlossen und gibt null Bytes zurück.

Wenn Sie ein verbindungsloses Socketverwenden, Receive liest das erste in die Warteschlange eingereihte Datagramm aus der Zieladresse, die Sie in der Connect -Methode angeben. Wenn das empfangene Datagramm größer als die Größe des buffers Parameters ist, buffers mit dem ersten Teil der Nachricht gefüllt wird, gehen die überschüssigen Daten verloren, und es wird ein SocketException ausgelöst.

Hinweis Dieses Mitglied gibt Ablaufverfolgungsinformationen aus, wenn Sie die Netzwerkablaufverfolgung in Ihrer Anwendung aktivieren. Weitere Informationen finden Sie unter Netzwerkablaufverfolgung in .NET Framework.

Quelle:

Socket.cs

Quelle:

Socket.cs

Quelle:

Socket.cs

public:
 int Receive(cli::array <System::Byte> ^ buffer);

public int Receive (byte[] buffer);

member this.Receive : byte[] -> int

Public Function Receive (buffer As Byte()) As Integer

Parameter

Gibt zurück

Die Anzahl der empfangenen Bytes.

Ausnahmen

Beispiele

Im folgenden Codebeispiel werden Daten für eine verbundene Socketempfangen.

// Displays sending with a connected socket
// using the overload that takes a buffer.
int SendReceiveTest1( Socket^ server )
{
   array<Byte>^ msg = Encoding::UTF8->GetBytes( "This is a test" );
   array<Byte>^ bytes = gcnew array<Byte>(256);
   try
   {
      // Blocks until send returns.
      int byteCount = server->Send( msg );
      Console::WriteLine( "Sent {0} bytes.", byteCount.ToString() );
      
      // Get reply from the server.
      byteCount = server->Receive( bytes );
      if ( byteCount > 0 )
      {
         Console::WriteLine( Encoding::UTF8->GetString( bytes ) );
      }
   }
   catch ( SocketException^ e ) 
   {
      Console::WriteLine( "{0} Error code: {1}.", e->Message, e->ErrorCode.ToString() );
      return ( e->ErrorCode );
   }
   return 0;
}

// Displays sending with a connected socket
// using the overload that takes a buffer.
public static int SendReceiveTest1(Socket server)
{
    byte[] msg = Encoding.UTF8.GetBytes("This is a test");
    byte[] bytes = new byte[256];
    try
    {
        // Blocks until send returns.
        int i = server.Send(msg);
        Console.WriteLine("Sent {0} bytes.", i);

        // Get reply from the server.
        i = server.Receive(bytes);
        Console.WriteLine(Encoding.UTF8.GetString(bytes));
    }
    catch (SocketException e)
    {
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode);
        return (e.ErrorCode);
    }
    return 0;
}

' Displays sending with a connected socket
' using the overload that takes a buffer.
Public Shared Function SendReceiveTest1(ByVal server As Socket) As Integer 
    Dim msg As Byte() = Encoding.UTF8.GetBytes("This is a test")
    Dim bytes(255) As Byte
    Try
        ' Blocks until send returns.
        Dim i As Integer = server.Send(msg)
        Console.WriteLine("Sent {0} bytes.", i)
        
        ' Get reply from the server.
        i = server.Receive(bytes)
        Console.WriteLine(Encoding.UTF8.GetString(bytes))
    Catch e As SocketException
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode)
        Return e.ErrorCode
    End Try
    Return 0

End Function 'SendReceiveTest1

Hinweise

Die Receive -Methode liest Daten in den Pufferparameter und gibt die Anzahl der bytes zurück, die erfolgreich gelesen wurden. Sie können sowohl verbindungsorientierte als auch verbindungslose Sockets aufrufen Receive .

Für diese Überladung müssen Sie nur einen Empfangspuffer bereitstellen. Der Pufferoffset ist standardmäßig 0, die Größe ist standardmäßig die Länge des Pufferparameters, und der SocketFlags Wert ist standardmäßig auf None.

Wenn Sie ein verbindungsorientiertes Protokoll verwenden, müssen Sie entweder aufrufen Connect , um eine Remotehostverbindung herzustellen, oder Accept um eine eingehende Verbindung zu akzeptieren, bevor Sie aufrufen Receive. Die Receive -Methode liest nur Daten, die von dem Remotehost empfangen werden, der in der - oder Accept -ConnectMethode eingerichtet wurde. Wenn Sie ein verbindungsloses Protokoll verwenden, können Sie auch die ReceiveFrom -Methode verwenden. ReceiveFrom ermöglicht es Ihnen, Daten zu empfangen, die von einem beliebigen Host empfangen werden.

Wenn keine Daten zum Lesen verfügbar sind, blockiert die Receive -Methode, bis Daten verfügbar sind, es sei denn, ein Timeoutwert wurde mithilfe Socket.ReceiveTimeoutvon festgelegt. Wenn der Timeoutwert überschritten wurde, löst der Receive Aufruf eine aus SocketException. Wenn Sie sich im nicht blockierenden Modus befinden und keine Daten im Protokollstapelpuffer verfügbar sind, wird die Receive -Methode sofort abgeschlossen und löst eine aus SocketException. Sie können die Available -Eigenschaft verwenden, um zu bestimmen, ob Daten zum Lesen verfügbar sind. Wenn Available ungleich 0 ist, wiederholen Sie den Empfangsvorgang.

Wenn Sie ein verbindungsorientiertes Socketverwenden, liest die Receive -Methode bis zur Größe des Puffers so viele Daten, wie verfügbar sind. Wenn der Remotehost die Verbindung mit der SocketShutdown -Methode beendet und alle verfügbaren Daten empfangen wurden, wird die Receive Methode sofort abgeschlossen und gibt null Bytes zurück.

Wenn Sie ein verbindungsloses Socketverwenden, Receive liest das erste Datagramm in der Warteschlange aus der Zieladresse, die Sie in der Connect -Methode angeben. Wenn das empfangene Datagramm größer als die Größe des buffer Parameters ist, buffer mit dem ersten Teil der Nachricht gefüllt wird, gehen die überschüssigen Daten verloren, und es wird ein SocketException ausgelöst.

Weitere Informationen

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Quelle:

Socket.cs

Quelle:

Socket.cs

Quelle:

Socket.cs

public:
 int Receive(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags);

public int Receive (System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags);

member this.Receive : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags -> int

Public Function Receive (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags) As Integer

Parameter

Gibt zurück

Die Anzahl der empfangenen Bytes.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Daten auf einem verbundenen Socketempfangen werden.

// Build the buffers for the receive.
List<ArraySegment<Byte> >^ receiveBuffers = 
    gcnew List<ArraySegment<Byte> >(2);

array<Byte>^ bigBuffer = gcnew array<Byte>(1024);

// Specify the first buffer segment (2 bytes, starting 
// at the 4th element of bigBuffer)
receiveBuffers->Add(ArraySegment<Byte>(bigBuffer, 4, 2));

// Specify the second buffer segment (500 bytes, starting
// at the 20th element of bigBuffer)
receiveBuffers->Add(
    ArraySegment<Byte>(bigBuffer, 20, 500));

tcpSocket->Receive(receiveBuffers);

Console::WriteLine("{0}", 
    asciiEncoding->GetString(bigBuffer));

// Build the buffers for the receive.
List<ArraySegment<byte>> recvBuffers =
                         new List<ArraySegment<byte>>(2);

byte[] bigBuffer = new byte[1024];

// Specify the first buffer segment (2 bytes, starting
// at the 4th element of bigBuffer)
recvBuffers.Add(new ArraySegment<byte>(bigBuffer, 4, 2));

// Specify the second buffer segment (500 bytes, starting
// at the 20th element of bigBuffer)
recvBuffers.Add(new ArraySegment<byte>(bigBuffer, 20, 500));

int bytesReceived = mySocket.Receive(recvBuffers);

Console.WriteLine("{0}", ASCII.GetString(bigBuffer));

Hinweise

Diese Methode liest Daten in den buffers Parameter und gibt die Anzahl der erfolgreich gelesenen Bytes zurück. Sie können sowohl verbindungsorientierte als auch verbindungslose Sockets aufrufen.

Für diese Überladung müssen Sie einen oder mehrere Empfangspuffer bereitstellen. Der SocketFlags Wert ist Nonestandardmäßig .

Wenn Sie ein verbindungsorientiertes Protokoll verwenden, müssen Sie entweder aufrufen Connect , um eine Remotehostverbindung herzustellen, oder Accept um eine eingehende Verbindung zu akzeptieren, bevor Sie aufrufen Receive. Die Receive -Methode liest nur Daten, die von der Remotehostverbindung empfangen werden, die in der - oder Accept -ConnectMethode eingerichtet wurde. Wenn Sie ein verbindungsloses Protokoll verwenden, können Sie auch die ReceiveFrom -Methode verwenden. ReceiveFrom ermöglicht es Ihnen, Daten zu empfangen, die von einem beliebigen Host empfangen werden.

Wenn keine Daten zum Lesen verfügbar sind, blockiert die Receive -Methode, bis Daten verfügbar sind, es sei denn, ein Timeoutwert wurde mithilfe Socket.ReceiveTimeoutvon festgelegt. Wenn der Timeoutwert überschritten wurde, löst der Receive Aufruf eine aus SocketException. Wenn Sie sich im nicht blockierenden Modus befinden und keine Daten im Protokollstapelpuffer verfügbar sind, wird die Receive -Methode sofort abgeschlossen und löst eine aus SocketException. Sie können die Available -Eigenschaft verwenden, um zu bestimmen, ob Daten zum Lesen verfügbar sind. Wenn Available ungleich 0 ist, wiederholen Sie den Empfangsvorgang.

Wenn Sie ein verbindungsorientiertes Socketverwenden, liest die Receive -Methode bis zur Größe des Puffers so viele Daten, wie verfügbar sind. Wenn der Remotehost die Verbindung mit der SocketShutdown -Methode beendet und alle verfügbaren Daten empfangen wurden, wird die Receive Methode sofort abgeschlossen und gibt null Bytes zurück.

Wenn Sie ein verbindungsloses Socketverwenden, Receive liest das erste in die Warteschlange eingereihte Datagramm aus der Zieladresse, die Sie in der Connect -Methode angeben. Wenn das empfangene Datagramm größer als die Größe des buffers Parameters ist, buffers mit dem ersten Teil der Nachricht gefüllt wird, gehen die überschüssigen Daten verloren, und es wird ein SocketException ausgelöst.

Weitere Informationen

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()