TcpClient.GetStream Methode

public:
 System::Net::Sockets::NetworkStream ^ GetStream();

public System.Net.Sockets.NetworkStream GetStream ();

member this.GetStream : unit -> System.Net.Sockets.NetworkStream

Public Function GetStream () As NetworkStream

Gibt zurück

Der zugrundeliegende NetworkStream.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird GetStream verwendet, um die zugrunde liegende NetworkStreamabzurufen. Nach dem Abrufen von NetworkStreamsendet und empfängt es mit seinen Write Methoden und Read .

TcpClient^ tcpClient = gcnew TcpClient;

// Uses the GetStream public method to return the NetworkStream.
NetworkStream^ netStream = tcpClient->GetStream();
if ( netStream->CanWrite )
{
   array<Byte>^sendBytes = Encoding::UTF8->GetBytes( "Is anybody there?" );
   netStream->Write( sendBytes, 0, sendBytes->Length );
}
else
{
   Console::WriteLine( "You cannot write data to this stream." );
   tcpClient->Close();
   
   // Closing the tcpClient instance does not close the network stream.
   netStream->Close();
   return;
}

if ( netStream->CanRead )
{
   
   // Reads NetworkStream into a byte buffer.
   array<Byte>^bytes = gcnew array<Byte>(tcpClient->ReceiveBufferSize);
   
   // Read can return anything from 0 to numBytesToRead. 
   // This method blocks until at least one byte is read.
   netStream->Read( bytes, 0, (int)tcpClient->ReceiveBufferSize );
   
   // Returns the data received from the host to the console.
   String^ returndata = Encoding::UTF8->GetString( bytes );
   Console::WriteLine( "This is what the host returned to you: {0}", returndata );
}
else
{
   Console::WriteLine( "You cannot read data from this stream." );
   tcpClient->Close();
   
   // Closing the tcpClient instance does not close the network stream.
   netStream->Close();
   return;
}

using TcpClient tcpClient = new TcpClient();
tcpClient.ConnectAsync("contoso.com", 5000);

using NetworkStream netStream = tcpClient.GetStream();

// Send some data to the peer.
byte[] sendBuffer = Encoding.UTF8.GetBytes("Is anybody there?");
netStream.Write(sendBuffer);

// Receive some data from the peer.
byte[] receiveBuffer = new byte[1024];
int bytesReceived = netStream.Read(receiveBuffer);
string data = Encoding.UTF8.GetString(receiveBuffer.AsSpan(0, bytesReceived));

Console.WriteLine($"This is what the peer sent to you: {data}");

     Dim tcpClient As New TcpClient()
     ' Uses the GetStream public method to return the NetworkStream.

        Dim netStream As NetworkStream = tcpClient.GetStream()
        If netStream.CanWrite Then
           Dim sendBytes As [Byte]() = Encoding.UTF8.GetBytes("Is anybody there?")
           netStream.Write(sendBytes, 0, sendBytes.Length)
        Else
           Console.WriteLine("You cannot write data to this stream.")
           tcpClient.Close()
           ' Closing the tcpClient instance does not close the network stream.
           netStream.Close()
           Return
        End If
        If netStream.CanRead Then
           
           ' Reads the NetworkStream into a byte buffer.
           Dim bytes(tcpClient.ReceiveBufferSize) As Byte
           ' Read can return anything from 0 to numBytesToRead. 
           ' This method blocks until at least one byte is read.
           netStream.Read(bytes, 0, CInt(tcpClient.ReceiveBufferSize))
           
           ' Returns the data received from the host to the console.
           Dim returndata As String = Encoding.ASCII.GetString(bytes)
           Console.WriteLine(("This is what the host returned to you: " + returndata))
        Else
           Console.WriteLine("You cannot read data from this stream.")
           tcpClient.Close()
           ' Closing the tcpClient instance does not close the network stream.
           netStream.Close()
           Return
        End If

     ' Uses the Close public method to close the network stream and socket.
     tcpClient.Close()
  End Sub

Hinweise

Die GetStream -Methode gibt eine NetworkStream zurück, die Sie zum Senden und Empfangen von Daten verwenden können. Die NetworkStream -Klasse erbt von der Stream -Klasse, die eine umfassende Sammlung von Methoden und Eigenschaften bereitstellt, die zur Erleichterung der Netzwerkkommunikation verwendet werden.

Sie müssen zuerst die Connect -Methode aufrufen, sonst löst die GetStream -Methode einen aus InvalidOperationException. Nachdem Sie die NetworkStreamabgerufen haben, rufen Sie die Write -Methode auf, um Daten an den Remotehost zu senden. Rufen Sie die Read -Methode auf, um Vom Remotehost eingehende Daten zu empfangen. Beide Methoden blockieren, bis der angegebene Vorgang ausgeführt wird. Sie können das Blockieren eines Lesevorgangs vermeiden, indem Sie die DataAvailable -Eigenschaft überprüfen. Ein true Wert bedeutet, dass Daten vom Remotehost eingetroffen sind und zum Lesen verfügbar sind. In diesem Fall ist garantiert, Read dass sie sofort abgeschlossen wird. Wenn der Remotehost seine Verbindung heruntergefahren hat, Read wird sofort mit null Bytes zurückgegeben.

Gilt für:

Weitere Informationen

• NetworkStream
• Write(Byte[], Int32, Int32)
• Read(Byte[], Int32, Int32)
• DataAvailable
• Stream
• Connect(String, Int32)