NetworkStream Osztály

Definíció

Névtér:

System.Net.Sockets

Szerelvények:

netstandard.dll, System.Net.Sockets.dll

Forrás:

NetworkStream.cs

A hálózati hozzáférés alapjául szolgáló adatstreamet biztosítja.

public ref class NetworkStream : System::IO::Stream

public class NetworkStream : System.IO.Stream

type NetworkStream = class
    inherit Stream

Public Class NetworkStream
Inherits Stream

Öröklődés

Object

MarshalByRefObject

Stream

NetworkStream

Megjegyzések

Az NetworkStream osztály metódusokat biztosít az adatok szoftvercsatornákon keresztüli Stream küldésére és fogadására blokkoló módban. További információ a blokkolásról és a tiltás Socketnélküli szoftvercsatornákról: Aszinkron ügyfélcsatorna használata. Az NetworkStream osztályt szinkron és aszinkron adatátvitelhez is használhatja. A szinkron és aszinkron kommunikációval kapcsolatos további információkért lásd: Sockets.

A létrehozáshoz NetworkStreammeg kell adnia egy csatlakoztatott elemet Socket. Azt is megadhatja, hogy a FileAccess megadott NetworkStreamengedély milyen Socket jogosultsággal rendelkezik. Alapértelmezés szerint a NetworkStream bezárás nem zárja be a megadott Socketértéket. Ha azt szeretné, hogy a NetworkStream megadott Socketérték bezáruljon, meg kell adnia true a ownsSocket paraméter értékét.

Használja az Write egyszerű egyszálas szinkron blokkoló I/O-t és Read metódusokat. Ha aszinkron módon szeretné feldolgozni az I/O-t, fontolja meg a vagy Taska -based metódusok ValueTask és ReadAsynca WriteAsync .

Ez NetworkStream nem támogatja a hálózati adatfolyamhoz való véletlenszerű hozzáférést. A tulajdonság értéke CanSeek , amely azt jelzi, hogy a stream támogatja-e a keresést, mindig false; a Position tulajdonság beolvasása, a Length tulajdonság beolvasása vagy a Seek metódus meghívása egy NotSupportedException.

Az olvasási és írási NetworkStream műveletek az osztály egy példányán is elvégezhetők szinkronizálás nélkül. Mindaddig, amíg az írási műveletekhez egy egyedi szál és egy egyedi szál tartozik az olvasási műveletekhez, az olvasási és írási szálak között nincs kereszt-interferencia, és nincs szükség szinkronizálásra.

Konstruktorok

Name	Description
NetworkStream(Socket, Boolean)	Inicializálja a NetworkStream megadott osztály új példányát a megadott SocketSocket tulajdonossal.
NetworkStream(Socket, FileAccess, Boolean)	Létrehozza a NetworkStream megadott osztály új példányát a megadott Socket hozzáférési jogosultságokkal és a megadott Socket tulajdonjoggal.
NetworkStream(Socket, FileAccess)	Létrehoz egy új példányt a NetworkStream megadott Socket osztályhoz a megadott hozzáférési jogosultságokkal.
NetworkStream(Socket)	Létrehozza az NetworkStream osztály új példányát a megadotthoz Socket.

Tulajdonságok

Name	Description
CanRead	Olyan értéket kap, amely jelzi, hogy a függvény támogatja-e az NetworkStream olvasást.
CanSeek	Olyan értéket kap, amely jelzi, hogy a stream támogatja-e a keresést. Ez a tulajdonság jelenleg nem támogatott. Ez a tulajdonság mindig ad vissza false.
CanTimeout	Azt jelzi, hogy az időtúllépési tulajdonságok használhatók-e.NetworkStream
CanWrite	Olyan értéket kap, amely jelzi, hogy a szöveg támogatja-e az NetworkStream írást.
DataAvailable	Egy olyan értéket kap, amely jelzi, hogy az adatok elérhetők-e az NetworkStream azonnal olvashatón.
Length	Lekéri a streamen elérhető adatok hosszát. Ez a tulajdonság jelenleg nem támogatott, és mindig egy NotSupportedException.
Position	Lekéri vagy beállítja az aktuális pozíciót a streamben. Ez a tulajdonság jelenleg nem támogatott, és mindig egy NotSupportedException.
Readable	Lekéri vagy beállít egy értéket, amely jelzi, hogy az NetworkStream olvasható-e.
ReadTimeout	Lekéri vagy beállítja, hogy egy olvasási művelet mennyi ideig blokkolja az adatokra való várakozást.
Socket	Lekéri a mögöttes Socket.
Writeable	Olyan értéket kap, amely jelzi, hogy írható-e NetworkStream .
WriteTimeout	Lekéri vagy beállítja, hogy egy írási művelet mennyi ideig blokkolja az adatokra való várakozást.

Metódusok

Name	Description
BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	Aszinkron olvasást kezd a NetworkStream.
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	Aszinkron írást kezd egy streambe.
Close()	Bezárja az aktuális streamet, és felszabadítja az aktuális adatfolyamhoz társított összes erőforrást (például szoftvercsatornákat és fájlfogópontokat). A metódus meghívása helyett győződjön meg arról, hogy a stream megfelelően van elosztva. (Öröklődés forrása Stream)
Close(Int32)	A megadott idő elteltével bezárja az NetworkStream adatok küldését.
Close(TimeSpan)	Bezárja a NetworkStream megadott időtartamot az adatok elküldésének engedélyezéséhez.
CopyTo(Stream, Int32)	Beolvassa a bájtokat az aktuális streamből, és egy megadott pufferméret használatával egy másik streambe írja őket. Mindkét streampozíciót a másolt bájtok száma emeli ki. (Öröklődés forrása Stream)
CopyTo(Stream)	Beolvassa a bájtokat az aktuális streamből, és egy másik streambe írja őket. Mindkét streampozíciót a másolt bájtok száma emeli ki. (Öröklődés forrása Stream)
CopyToAsync(Stream, CancellationToken)	Aszinkron módon beolvassa a bájtokat az aktuális streamből, és egy megadott lemondási jogkivonat használatával egy másik streambe írja őket. Mindkét streampozíciót a másolt bájtok száma emeli ki. (Öröklődés forrása Stream)
CopyToAsync(Stream, Int32, CancellationToken)	Aszinkron módon beolvassa a bájtokat az aktuális streamből, és egy megadott pufferméret és lemondási jogkivonat használatával egy másik streambe írja őket. Mindkét streampozíciót a másolt bájtok száma emeli ki. (Öröklődés forrása Stream)
CopyToAsync(Stream, Int32)	Aszinkron módon beolvassa a bájtokat az aktuális adatfolyamból, és egy megadott puffermérettel egy másik streambe írja őket. Mindkét streampozíciót a másolt bájtok száma emeli ki. (Öröklődés forrása Stream)
CopyToAsync(Stream)	Aszinkron módon beolvassa a bájtokat az aktuális streamből, és egy másik streambe írja őket. Mindkét streampozíciót a másolt bájtok száma emeli ki. (Öröklődés forrása Stream)
CreateWaitHandle()	Elavult. Objektum lefoglalása WaitHandle . (Öröklődés forrása Stream)
Dispose()	Felszabadítja a .-hez használt összes erőforrást Stream. (Öröklődés forrása Stream)
Dispose(Boolean)	Felszabadítja a felügyelt erőforrások által NetworkStream használt nem felügyelt erőforrásokat, és opcionálisan felszabadítja a felügyelt erőforrásokat.
DisposeAsync()	Aszinkron módon felszabadítja a nem felügyelt erőforrásokat, amelyeket a Stream. (Öröklődés forrása Stream)
EndRead(IAsyncResult)	Az aszinkron olvasás végét kezeli.
EndWrite(IAsyncResult)	Az aszinkron írás végét kezeli.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
Finalize()	Felszabadítja a .-hez használt összes erőforrást NetworkStream.
Flush()	Adatok kiürítése a streamből. Ez a módszer későbbi használatra van fenntartva.
FlushAsync()	Aszinkron módon törli az adatfolyam összes pufferét, és a pufferelt adatokat a mögöttes eszközre írja. (Öröklődés forrása Stream)
FlushAsync(CancellationToken)	Az adatokat aszinkron műveletként üríti ki a streamből.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetLifetimeService()	Elavult. Lekéri a példány élettartamszabályzatát vezérlő aktuális élettartam-szolgáltatásobjektumot. (Öröklődés forrása MarshalByRefObject)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
InitializeLifetimeService()	Elavult. Beolvas egy élettartam-szolgáltatásobjektumot a példány élettartam-szabályzatának szabályozásához. (Öröklődés forrása MarshalByRefObject)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
MemberwiseClone(Boolean)	Az aktuális MarshalByRefObject objektum sekély másolatát hozza létre. (Öröklődés forrása MarshalByRefObject)
ObjectInvariant()	Elavult. Támogatja a Contract. (Öröklődés forrása Stream)
Read(Byte[], Int32, Int32)	Beolvassa az adatokat a NetworkStream fájlból, és egy bájttömbbe tárolja.
Read(Span<Byte>)	Beolvassa az adatokat a NetworkStream memóriából, és több bájtnyi memóriába tárolja.
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Beolvassa az adatokat, NetworkStream és egy bájttömb megadott tartományában tárolja aszinkron műveletként.
ReadAsync(Byte[], Int32, Int32)	Aszinkron módon beolvassa az aktuális adatfolyamból származó bájtok sorozatát, és az olvasási bájtok számával előrelépteti a streamen belüli pozíciót. (Öröklődés forrása Stream)
ReadAsync(Memory<Byte>, CancellationToken)	Beolvassa az adatokat, NetworkStream és bájtmemóriatartományban tárolja aszinkron műveletként.
ReadAtLeast(Span<Byte>, Int32, Boolean)	Legalább egy bájtot olvas be az aktuális adatfolyamból, és az olvasási bájtok számával előrelép a streamen belül. (Öröklődés forrása Stream)
ReadAtLeastAsync(Memory<Byte>, Int32, Boolean, CancellationToken)	Aszinkron módon legalább egy minimális bájtszámot olvas be az aktuális streamből, az olvasási bájtok számával előrelép a streamen belül, és figyeli a lemondási kérelmeket. (Öröklődés forrása Stream)
ReadByte()	Beolvassa a bájtot a NetworkStream streamből, és egy bájttal előrelép a streamben, vagy -1 ad vissza, ha a stream végén van.
ReadExactly(Byte[], Int32, Int32)	Beolvassa a bájtok count számát az aktuális streamből, és előrelép a streamen belüli pozíción. (Öröklődés forrása Stream)
ReadExactly(Span<Byte>)	Beolvassa a bájtokat az aktuális adatfolyamból, és a streamen belüli pozíciót a feltöltésig buffer előrelépteti. (Öröklődés forrása Stream)
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	Aszinkron módon beolvassa a bájtok count számát az aktuális streamből, előrelép a streamben, és figyeli a lemondási kérelmeket. (Öröklődés forrása Stream)
ReadExactlyAsync(Memory<Byte>, CancellationToken)	Aszinkron módon beolvassa a bájtokat az aktuális adatfolyamból, a streamen belüli pozíciót a feltöltésig buffer , és figyeli a lemondási kérelmeket. (Öröklődés forrása Stream)
Seek(Int64, SeekOrigin)	A stream aktuális pozícióját a megadott értékre állítja. Ez a módszer jelenleg nem támogatott, és mindig egy NotSupportedException.
SetLength(Int64)	Beállítja a stream hosszát. Ez a módszer mindig egy NotSupportedException.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
Write(Byte[], Int32, Int32)	Adatokat ír egy NetworkStream bájttömb megadott tartományából.
Write(ReadOnlySpan<Byte>)	Írási adatok írása írásvédett NetworkStream bájttartományból.
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Adatokat ír a NetworkStream bájttömb megadott tartományából aszinkron műveletként.
WriteAsync(Byte[], Int32, Int32)	Aszinkron módon bájtok sorozatát írja az aktuális adatfolyamba, és a megírt bájtok számával előrelépteti a stream aktuális pozícióját. (Öröklődés forrása Stream)
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Adatokat ír egy NetworkStream írásvédett memória bájt memóriatartományából aszinkron műveletként.
WriteByte(Byte)	Bájtot ír az aktuális pozícióba a NetworkStream streamben, és egy bájttal előrelép a streamben.

Bővítő metódusok

Name	Description
ConfigureAwait(IAsyncDisposable, Boolean)	Konfigurálja, hogy az aszinkron eldobható feladatok hogyan lesznek végrehajtva.
CopyToAsync(Stream, PipeWriter, CancellationToken)	Aszinkron módon beolvassa a bájtokat a Stream megadottból, és egy lemondási jogkivonat használatával írja őket a megadottba PipeWriter.

Lásd még

• TcpClient