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

NetworkStream-Klasse

 

Veröffentlicht: Oktober 2016

Stellt den zugrunde liegenden Datenstrom für das Netzwerk bereit.

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

System.Object
  System.MarshalByRefObject
    System.IO.Stream
      System.Net.Sockets.NetworkStream

public class NetworkStream : Stream

NameBeschreibung
System_CAPS_pubmethodNetworkStream(Socket)

Erstellt eine neue Instanz der NetworkStream -Klasse für den angegebenen Socket.

System_CAPS_pubmethodNetworkStream(Socket, Boolean)

Initialisiert eine neue Instanz von der NetworkStream -Klasse für den angegebenen Socket mit dem angegebenen Socket Besitz.

System_CAPS_pubmethodNetworkStream(Socket, FileAccess)

Erstellt eine neue Instanz der NetworkStream -Klasse für den angegebenen Socket mit den angegebenen Berechtigungen.

System_CAPS_pubmethodNetworkStream(Socket, FileAccess, Boolean)

Erstellt eine neue Instanz von der NetworkStream -Klasse für den angegebenen Socket mit den angegebenen Zugriffsrechten und dem angegebenen Socket Besitz.

NameBeschreibung
System_CAPS_pubpropertyCanRead

Ruft einen Wert, der angibt, ob die NetworkStream Lesevorgänge unterstützt.(Überschreibt Stream.CanRead.)

System_CAPS_pubpropertyCanSeek

Ruft einen Wert, der angibt, ob der Stream Suchvorgänge unterstützt. Diese Eigenschaft wird derzeit nicht unterstützt. Gibt diese Eigenschaft immer false.(Überschreibt Stream.CanSeek.)

System_CAPS_pubpropertyCanTimeout

Gibt an, ob Timeouteigenschaften für verwendet werden können NetworkStream.(Überschreibt Stream.CanTimeout.)

System_CAPS_pubpropertyCanWrite

Ruft einen Wert, der angibt, ob die NetworkStream Schreibvorgänge unterstützt.(Überschreibt Stream.CanWrite.)

System_CAPS_pubpropertyDataAvailable

Ruft einen Wert, der angibt, ob Daten verfügbar ist die NetworkStream gelesen werden.

System_CAPS_pubpropertyLength

Ruft die Länge der verfügbaren Daten im Stream ab. Diese Eigenschaft wird derzeit nicht unterstützt und löst immer eine NotSupportedException.(Überschreibt Stream.Length.)

System_CAPS_pubpropertyPosition

Ruft ab oder legt die aktuelle Position im Stream. Diese Eigenschaft wird derzeit nicht unterstützt und löst immer eine NotSupportedException.(Überschreibt Stream.Position.)

System_CAPS_protpropertyReadable

Ruft ab oder legt einen Wert, der angibt, ob der NetworkStream gelesen werden können.

System_CAPS_pubpropertyReadTimeout

Ruft ab oder legt der Zeitspanne, die ein Lesevorgang blockiert, die auf Daten warten.(Überschreibt Stream.ReadTimeout.)

System_CAPS_protpropertySocket

Ruft die zugrunde liegende Socket ab.

System_CAPS_protpropertyWriteable

Ruft einen Wert, der angibt, ob die NetworkStream geschrieben werden kann.

System_CAPS_pubpropertyWriteTimeout

Ruft ab oder legt der Zeitspanne, die ein Schreibzugriff Vorgang blockiert, die auf Daten warten.(Überschreibt Stream.WriteTimeout.)

NameBeschreibung
System_CAPS_pubmethodBeginRead(Byte[], Int32, Int32, AsyncCallback, Object)

Beginnt einen asynchronen Lesevorgang aus dem NetworkStream.(Überschreibt Stream.BeginRead(Byte[], Int32, Int32, AsyncCallback, Object).)

System_CAPS_pubmethodBeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)

Startet einen asynchronen Schreibvorgang in einen Stream.(Überschreibt Stream.BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object).)

System_CAPS_pubmethodClose()

Schließt den aktuellen Stream und gibt alle dem aktuellen Stream zugeordneten Ressourcen frei (z. B. Sockets und Dateihandles). Anstatt diese Methode aufzurufen, stellen Sie sicher, dass der Stream ordnungsgemäß freigegeben wird.(Geerbt von „Stream“.)

System_CAPS_pubmethodClose(Int32)

Schließt die NetworkStream nach der angegebenen Zeitspanne, in der Daten gesendet werden können.

System_CAPS_pubmethodCopyTo(Stream)

Liest alle Bytes aus dem aktuellen Stream und schreibt sie in einen anderen Datenstrom.(Geerbt von „Stream“.)

System_CAPS_pubmethodCopyTo(Stream, Int32)

Liest alles Bytes aus dem aktuellen Datenstrom und schreibt sie unter Verwendung einer angegebenen Puffergröße in einen anderen Datenstrom.(Geerbt von „Stream“.)

System_CAPS_pubmethodCopyToAsync(Stream)

Liest die Bytes asynchron aus dem aktuellen Stream und schreibt sie in einen anderen Stream.(Geerbt von „Stream“.)

System_CAPS_pubmethodCopyToAsync(Stream, Int32)

Liest die Bytes asynchron aus dem aktuellen Stream und schreibt sie unter Verwendung einer angegebenen Puffergröße in einen anderen Stream.(Geerbt von „Stream“.)

System_CAPS_pubmethodCopyToAsync(Stream, Int32, CancellationToken)

Liest die Bytes asynchron aus dem aktuellen Stream und schreibt sie unter Verwendung einer angegebenen Puffergröße und eines Abbruchtokens in einen anderen Stream.(Geerbt von „Stream“.)

System_CAPS_pubmethodCreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt verwendet die enthält.(Geerbt von „MarshalByRefObject“.)

System_CAPS_protmethodCreateWaitHandle()

Veraltet. Reserviert ein WaitHandle-Objekt.(Geerbt von „Stream“.)

System_CAPS_pubmethodDispose()

Gibt alle vom Stream verwendeten Ressourcen frei.(Geerbt von „Stream“.)

System_CAPS_protmethodDispose(Boolean)

Gibt die von NetworkStream verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.(Überschreibt Stream.Dispose(Boolean).)

System_CAPS_pubmethodEndRead(IAsyncResult)

Behandelt das Ende eines asynchronen Lesevorgangs.(Überschreibt Stream.EndRead(IAsyncResult).)

System_CAPS_pubmethodEndWrite(IAsyncResult)

Behandelt das Ende eines asynchronen Schreibvorgangs.(Überschreibt Stream.EndWrite(IAsyncResult).)

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von „Object“.)

System_CAPS_protmethodFinalize()

Gibt alle vom NetworkStream verwendeten Ressourcen frei.(Überschreibt Object.Finalize().)

System_CAPS_pubmethodFlush()

Löscht Daten aus dem Stream. Diese Methode ist für eine spätere Verwendung vorgesehen.(Überschreibt Stream.Flush().)

System_CAPS_pubmethodFlushAsync()

Löscht sämtliche Puffer für diesen Stream asynchron und veranlasst die Ausgabe aller gepufferten Daten an das zugrunde liegende Gerät.(Geerbt von „Stream“.)

System_CAPS_pubmethodFlushAsync(CancellationToken)

Leert Daten aus dem Stream als asynchronen Vorgang.(Überschreibt Stream.FlushAsync(CancellationToken).)

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetLifetimeService()

Ruft das Dienstobjekt für aktuellen Lebensdauer, das steuert, die lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodInitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von „Object“.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject Objekt.(Geerbt von „MarshalByRefObject“.)

System_CAPS_protmethodObjectInvariant()

Veraltet. Diese API unterstützt die Produkt Infrastruktur und sollte nicht direkt aus dem Code verwendet werden. Bietet Unterstützung für einen Contract.(Geerbt von „Stream“.)

System_CAPS_pubmethodRead(Byte[], Int32, Int32)

Liest Daten aus der NetworkStream.(Überschreibt Stream.Read(Byte[], Int32, Int32).)

System_CAPS_pubmethodReadAsync(Byte[], Int32, Int32)

Liest eine Bytesequenz asynchron aus dem aktuellen Stream und setzt die Position in diesem Stream um die Anzahl der gelesenen Bytes nach vorn.(Geerbt von „Stream“.)

System_CAPS_pubmethodReadAsync(Byte[], Int32, Int32, CancellationToken)

Liest eine Folge von Bytes asynchron aus dem aktuellen Stream, erhöht die Position im Stream um die Anzahl der gelesenen Bytes und überwacht Abbruchanfragen.(Geerbt von „Stream“.)

System_CAPS_pubmethodReadByte()

Liest ein Byte aus dem Stream und erhöht die Position im Stream um ein Byte, oder gibt -1 zurück, wenn das Ende des Streams erreicht ist.(Geerbt von „Stream“.)

System_CAPS_pubmethodSeek(Int64, SeekOrigin)

Legt die aktuelle Position des Streams auf den angegebenen Wert fest. Diese Methode wird derzeit nicht unterstützt und löst immer eine NotSupportedException.(Überschreibt Stream.Seek(Int64, SeekOrigin).)

System_CAPS_pubmethodSetLength(Int64)

Legt die Länge des Streams fest. Diese Methode löst immer eine NotSupportedException.(Überschreibt Stream.SetLength(Int64).)

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von „Object“.)

System_CAPS_pubmethodWrite(Byte[], Int32, Int32)

Schreibt Daten in die NetworkStream.(Überschreibt Stream.Write(Byte[], Int32, Int32).)

System_CAPS_pubmethodWriteAsync(Byte[], Int32, Int32)

Schreibt eine Bytesequenz asynchron in den aktuellen Stream und setzt die aktuelle Position in diesem Stream um die Anzahl der geschriebenen Bytes nach vorn.(Geerbt von „Stream“.)

System_CAPS_pubmethodWriteAsync(Byte[], Int32, Int32, CancellationToken)

Schreibt beim Überschreiben in einer abgeleiteten Klasse eine Folge von Bytes asynchron in den aktuellen Stream und erhöht die aktuelle Position im Stream um die Anzahl der geschriebenen Bytes und überwacht Abbruchanforderungen.(Geerbt von „Stream“.)

System_CAPS_pubmethodWriteByte(Byte)

Schreibt ein Byte an die aktuellen Position im Stream und erhöht die aktuelle Position im Stream um ein Byte.(Geerbt von „Stream“.)

Die NetworkStream -Klasse stellt Methoden zum Senden und Empfangen von Daten über Stream Sockets im blockierenden Modus. Weitere Informationen über blockierende und nicht blockierende Sockets, finden Sie unter Verwenden von asynchronen Clientsockets. Sie können die NetworkStream Klasse für beide synchrone und asynchrone Datenübertragung. Weitere Informationen über die synchrone und asynchrone Kommunikation finden Sie unter Sockets.

Erstellen einer NetworkStream, geben Sie einen verbundenen Socket. Sie können auch angeben, welche FileAccess Berechtigung der NetworkStream verfügt über den angegebenen Socket. Standardmäßig wird beim Schließen der NetworkStream schließt nicht die bereitgestellte Socket. Wenn Sie möchten die NetworkStream auf die Berechtigung zum Schließen des bereitgestellten Socket, müssen Sie angeben true für den Wert des der ownsSocket Parameter.

Verwenden der Write und Read Methoden für einfache einzelne thread synchrone blockierende e/a. Wenn Sie die e/a mit separaten Threads verarbeiten möchten, erwägen Sie die BeginWrite und EndWrite Methoden oder BeginRead und EndRead Methoden für die Kommunikation.

Die NetworkStream wahlfreien Zugriff auf den Netzwerk-Datenstrom nicht unterstützt. Der Wert des der CanSeek -Eigenschaft, die angibt, ob der Stream Suchvorgänge unterstützt, ist immer false; Lesen der Position Lesen-Eigenschaft der Length -Eigenschaft oder das Aufrufen der Seek Methode löst eine NotSupportedException.

Lesen und Schreiben von Vorgänge können gleichzeitig ausgeführt werden, auf eine Instanz der NetworkStream -Klasse ohne die Notwendigkeit einer Synchronisierung. Solange ein eindeutiger Thread für Schreibvorgänge und ein eindeutiger Thread für Lesevorgänge vorhanden sind, es werden keine Cross-Interferenzen zwischen Lese- und Schreibzugriff Threads und keine Synchronisierung erforderlich ist.

Das folgende Codebeispiel veranschaulicht das Erstellen einer NetworkStream aus einer verbundenen StreamSocket und grundlegende synchrone blockierende e/a auszuführen.

// Examples for constructors that do not specify file permission.

// Create the NetworkStream for communicating with the remote host.
NetworkStream myNetworkStream;

if (networkStreamOwnsSocket){
     myNetworkStream = new NetworkStream(mySocket, true);          
}
else{
     myNetworkStream = new NetworkStream(mySocket);     
}

.NET Framework
Verfügbar seit 1.1

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: