NetworkStream Třída

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

System.Net.Sockets.dll

Sestavení:

System.dll

Sestavení:

netstandard.dll

Poskytuje základní datový proud pro přístup k síti.

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

public class NetworkStream : System.IO.Stream

type NetworkStream = class
    inherit Stream

type NetworkStream = class
    inherit Stream
    interface IDisposable

Public Class NetworkStream
Inherits Stream

Dědičnost

Object

Stream

NetworkStream

Dědičnost

Object

MarshalByRefObject

Stream

NetworkStream

Implementuje

IDisposable

Příklady

Následující příklad kódu ukazuje, jak vytvořit z připojeného NetworkStream a StreamSocket provést základní synchronní blokující vstupně-výstupní operace.

// Examples for constructors that do not specify file permission.
// Create the NetworkStream for communicating with the remote host.
NetworkStream^ myNetworkStream;

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

// 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);
}

' Examples for constructors that do not specify file permission.
' Create the NetworkStream for communicating with the remote host.
Dim myNetworkStream As NetworkStream

If networkStreamOwnsSocket Then
   myNetworkStream = New NetworkStream(mySocket, True)
Else
   myNetworkStream = New NetworkStream(mySocket)
End If

Poznámky

Třída NetworkStream poskytuje metody pro odesílání a příjem dat přes Stream sokety v režimu blokování. Další informace o blokování a neblokování Sockets naleznete v tématu Použití asynchronního klientského soketu. Třídu můžete použít NetworkStream pro synchronní i asynchronní přenos dat. Další informace o synchronní a asynchronní komunikaci najdete v tématu Sokety.

Chcete-li vytvořit NetworkStream, musíte zadat připojenou Socket. Můžete také určit, jaké FileAccess oprávnění má zadané Socketoprávnění NetworkStream . Ve výchozím nastavení zavření zadaného Socketsouboru NetworkStream . Pokud chcete NetworkStream mít oprávnění k zavření zadaného Socketsouboru, musíte zadat true hodnotu parametru ownsSocket .

Write Použijte a Read metody pro jednoduché synchronní vlákno synchronní blokující vstupně-výstupní operace. Pokud chcete zpracovat vstupně-výstupní operace pomocí samostatných vláken, zvažte použití BeginWrite a EndWrite metod a BeginRead EndRead metod komunikace.

Nepodporuje NetworkStream náhodný přístup k síťovému datovému streamu. Hodnota CanSeek vlastnosti, která označuje, zda stream podporuje hledání, je vždy false; čtení Position vlastnosti, čtení Length vlastnosti nebo volání Seek metody vyvolá NotSupportedException.

Operace čtení a zápisu NetworkStream lze provádět současně u instance třídy bez nutnosti synchronizace. Pokud existuje jedno jedinečné vlákno pro operace zápisu a jedno jedinečné vlákno pro operace čtení, nebude mezi vlákny čtení a zápisu žádná křížová interference a není nutná synchronizace.

Konstruktory

NetworkStream(Socket)	Vytvoří novou instanci NetworkStream třídy pro zadanou Socket.
NetworkStream(Socket, Boolean)	Inicializuje novou instanci NetworkStream třídy určené Socket se zadaným Socket vlastnictvím.
NetworkStream(Socket, FileAccess)	Vytvoří novou instanci NetworkStream třídy pro zadanou Socket se zadanými přístupovými právy.
NetworkStream(Socket, FileAccess, Boolean)	Vytvoří novou instanci NetworkStream třídy pro zadané Socket s zadanými přístupovými právy a zadaným Socket vlastnictvím.

Vlastnosti

CanRead	Získá hodnotu, která označuje, zda NetworkStream podporuje čtení.
CanSeek	Získá hodnotu, která označuje, zda datový proud podporuje hledání. Tato vlastnost se v současné době nepodporuje. Tato vlastnost vždy vrátí hodnotu false.
CanTimeout	Určuje, jestli jsou vlastnosti časového limitu použitelné pro NetworkStream.
CanTimeout	Získá hodnotu, která určuje, zda aktuální datový proud může časový limit. (Zděděno od Stream)
CanWrite	Získá hodnotu, která označuje, zda NetworkStream podporuje zápis.
DataAvailable	Získá hodnotu, která označuje, zda jsou data k dispozici pro NetworkStream čtení.
Length	Získá délku dat dostupných ve streamu. Tato vlastnost není aktuálně podporována a vždy vyvolá NotSupportedExceptionchybu .
Position	Získá nebo nastaví aktuální pozici ve streamu. Tato vlastnost není aktuálně podporována a vždy vyvolá NotSupportedExceptionchybu .
Readable	Získá nebo nastaví hodnotu, která označuje, zda NetworkStream lze číst.
ReadTimeout	Získá nebo nastaví dobu, po kterou operace čtení blokuje čekání na data.
ReadTimeout	Získá nebo nastaví hodnotu v milisekundách, která určuje, jak dlouho se datový proud pokusí číst před časovým limitem. (Zděděno od Stream)
Socket	Získá podklad Socket.
Writeable	Získá hodnotu, která označuje, zda NetworkStream je zapisovatelný.
WriteTimeout	Získá nebo nastaví dobu, po kterou operace zápisu blokuje čekání na data.
WriteTimeout	Získá nebo nastaví hodnotu v milisekundách, která určuje, jak dlouho se datový proud před vypršením časového limitu pokusí zapisovat. (Zděděno od Stream)

Metody

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	Začíná asynchronní čtení ze NetworkStreamsouboru .
BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)	Zahájí asynchronní operaci čtení. (Zvažte místo toho ReadAsync(Byte[], Int32, Int32) použití .) (Zděděno od Stream)
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	Zahájí asynchronní zápis do datového proudu.
BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)	Zahájí asynchronní operaci zápisu. (Zvažte místo toho WriteAsync(Byte[], Int32, Int32) použití .) (Zděděno od Stream)
Close()	NetworkStreamZavře .
Close()	Zavře aktuální datový proud a uvolní všechny prostředky (například sokety a popisovače souborů) přidružené k aktuálnímu datovému proudu. Místo volání této metody se ujistěte, že je datový proud správně odstraněn. (Zděděno od Stream)
Close(Int32)	Zavře po NetworkStream čekání na zadaný čas, aby bylo možné odesílat data.
Close(TimeSpan)
CopyTo(Stream)	Přečte bajty z aktuálního datového proudu a zapíše je do jiného datového proudu. (Zděděno od Stream)
CopyTo(Stream, Int32)	Přečte bajty z aktuálního datového proudu a zapíše je do jiného datového proudu pomocí zadané velikosti vyrovnávací paměti. (Zděděno od Stream)
CopyToAsync(Stream)	Asynchronně čte bajty z aktuálního datového proudu a zapisuje je do jiného datového proudu. (Zděděno od Stream)
CopyToAsync(Stream, CancellationToken)	Asynchronně čte bajty z aktuálního datového proudu a zapisuje je do jiného datového proudu pomocí zadaného tokenu zrušení. (Zděděno od Stream)
CopyToAsync(Stream, Int32)	Asynchronně čte bajty z aktuálního datového proudu a zapisuje je do jiného datového proudu pomocí zadané velikosti vyrovnávací paměti. (Zděděno od Stream)
CopyToAsync(Stream, Int32, CancellationToken)	Asynchronně čte bajty z aktuálního datového proudu a zapisuje je do jiného datového proudu pomocí zadané velikosti vyrovnávací paměti a tokenu zrušení. (Zděděno od Stream)
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
CreateWaitHandle()	Zastaralé. Zastaralé. Přidělí WaitHandle objekt . (Zděděno od Stream)
Dispose()	Uvolní všechny prostředky používané v Stream . (Zděděno od Stream)
Dispose(Boolean)	Uvolní nespravované prostředky používané NetworkStream a volitelně uvolní spravované prostředky.
DisposeAsync()	Asynchronně uvolní nespravované prostředky používané objektem Stream . (Zděděno od Stream)
EndRead(IAsyncResult)	Zpracovává konec asynchronního čtení.
EndRead(IAsyncResult)	Čeká na dokončení čekajícího asynchronního čtení. (Zvažte místo toho ReadAsync(Byte[], Int32, Int32) použití .) (Zděděno od Stream)
EndWrite(IAsyncResult)	Zpracovává konec asynchronního zápisu.
EndWrite(IAsyncResult)	Ukončí asynchronní operaci zápisu. (Zvažte místo toho WriteAsync(Byte[], Int32, Int32) použití .) (Zděděno od Stream)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Finalize()	Uvolní všechny prostředky používané nástrojem NetworkStream.
Flush()	Vyprázdní data ze streamu. Tato metoda je vyhrazena pro budoucí použití.
FlushAsync()	Asynchronně vymaže všechny vyrovnávací paměti pro tento datový proud a způsobí zápis všech dat ve vyrovnávací paměti do základního zařízení. (Zděděno od Stream)
FlushAsync(CancellationToken)	Vyprázdní data z datového proudu jako asynchronní operaci.
FlushAsync(CancellationToken)	Asynchronně vymaže všechny vyrovnávací paměti pro tento datový proud, způsobí zápis všech dat ve vyrovnávací paměti do základního zařízení a monitoruje žádosti o zrušení. (Zděděno od Stream)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte aktuální objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří kopii aktuálního objektu bez MarshalByRefObject podmět. (Zděděno od MarshalByRefObject)
ObjectInvariant()	Zastaralé. Poskytuje podporu pro Contract . (Zděděno od Stream)
Read(Byte[], Int32, Int32)	Čte data z pole NetworkStream bajtů a ukládá je do pole bajtů.
Read(Span<Byte>)	Čte data z úložiště NetworkStream a ukládá je do rozsahu bajtů v paměti.
Read(Span<Byte>)	Při přepsání v odvozené třídě přečte sekvence bajtů z aktuálního datového proudu a posune pozici v rámci datového proudu o počet přečtených bajtů. (Zděděno od Stream)
ReadAsync(Byte[], Int32, Int32)	Asynchronně přečte sekvenci bajtů z aktuálního datového proudu a posune pozici v rámci datového proudu o počet přečtených bajtů. (Zděděno od Stream)
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Načte data z a NetworkStream uloží je do zadané oblasti bajtového pole jako asynchronní operace.
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Asynchronně přečte sekvenci bajtů z aktuálního datového proudu, posune pozici v rámci datového proudu o počet přečtených bajtů a monitoruje požadavky zrušení. (Zděděno od Stream)
ReadAsync(Memory<Byte>, CancellationToken)	Načte data z oblasti NetworkStream bajtové paměti a ukládá je jako asynchronní operace.
ReadAsync(Memory<Byte>, CancellationToken)	Asynchronně přečte sekvenci bajtů z aktuálního datového proudu, posune pozici v rámci datového proudu o počet přečtených bajtů a monitoruje požadavky zrušení. (Zděděno od Stream)
ReadByte()	Přečte bajt z NetworkStream datového proudu a posune pozici v rámci datového proudu o jeden bajt nebo vrátí hodnotu -1, pokud je na konci datového proudu.
ReadByte()	Přečte z datového proudu bajtů a posune pozici v rámci datového proudu o jeden bajtů, nebo vrátí hodnotu -1, pokud je na konci datového proudu. (Zděděno od Stream)
Seek(Int64, SeekOrigin)	Nastaví aktuální pozici datového proudu na danou hodnotu. Tato metoda není aktuálně podporována a vždy vyvolá NotSupportedException.
SetLength(Int64)	Nastaví délku streamu. Tato metoda vždy vyvolá NotSupportedException.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
Write(Byte[], Int32, Int32)	Zapisuje data do NetworkStream zadané oblasti bajtového pole.
Write(ReadOnlySpan<Byte>)	Zapisuje data do bajtového rozsahu NetworkStream jen pro čtení.
Write(ReadOnlySpan<Byte>)	Při přepsání v odvozené třídě zapíše sekvenci bajtů do aktuálního datového proudu a posune aktuální pozici v rámci tohoto datového proudu o počet zapsané bajty. (Zděděno od Stream)
WriteAsync(Byte[], Int32, Int32)	Asynchronně zapíše sekvenci bajtů do aktuálního datového proudu a posune aktuální pozici v rámci tohoto datového proudu o počet zapsané bajty. (Zděděno od Stream)
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Zapíše data do NetworkStream zadané oblasti bajtového pole jako asynchronní operace.
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Asynchronně zapíše sekvenci bajtů do aktuálního datového proudu, posune aktuální pozici v rámci tohoto datového proudu o počet zapsané bajty a monitoruje požadavky zrušení. (Zděděno od Stream)
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Zapíše data do oblasti paměti jen pro NetworkStream čtení jako asynchronní operace.
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Asynchronně zapíše sekvenci bajtů do aktuálního datového proudu, posune aktuální pozici v rámci tohoto datového proudu o počet zapsané bajty a monitoruje požadavky zrušení. (Zděděno od Stream)
WriteByte(Byte)	Zapíše bajt na aktuální pozici v bajtu NetworkStream a posune pozici v datovém proudu o jeden bajt.
WriteByte(Byte)	Zapíše bajt na aktuální pozici v datovém proudu a Posune pozici v rámci datového proudu o jeden bajt. (Zděděno od Stream)

Explicitní implementace rozhraní

IDisposable.Dispose()

Toto rozhraní API podporuje produktovou infrastrukturu a není určené k použití přímo z uživatelského kódu. Uvolní všechny prostředky používané nástrojem NetworkStream.

Metody rozšíření

ConfigureAwait(IAsyncDisposable, Boolean)

Nakonfiguruje, jak se čekají na úlohy vrácené z asynchronního jednorázového provedení.

Viz také

• TcpClient