NetworkStream.ReadTimeout Eigenschaft

Definition

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Quelle:

NetworkStream.cs

Ruft die Zeitspanne ab, in der ein Lesevorgang während des Wartens auf Daten blockiert wird, oder legt diese fest.

public:
 virtual property int ReadTimeout { int get(); void set(int value); };

public override int ReadTimeout { get; set; }

member this.ReadTimeout : int with get, set

Public Overrides Property ReadTimeout As Integer

Eigenschaftswert

Int32

Ein Int32, das die Zeitspanne in Millisekunden angibt, nach deren Ablauf ein Lesevorgang fehlschlägt. Der Standardwert Infinite gibt an, dass der Lesevorgang über kein Timeout verfügt.

Ausnahmen

ArgumentOutOfRangeException

Der angegebene Wert ist kleiner oder gleich 0 (null) und nicht Infinite.

Beispiele

Im folgenden Codebeispiel wird das Lesetimeout für einen Netzwerkdatenstrom auf 10 Millisekunden festgelegt.

// Create a client that will connect to a
// server listening on the contosoServer computer
// at port 11000.
TcpClient tcpClient = new TcpClient();
tcpClient.Connect("contosoServer", 11000);
// Get the stream used to read the message sent by the server.
NetworkStream networkStream = tcpClient.GetStream();
// Set a 10 millisecond timeout for reading.
networkStream.ReadTimeout = 10;
// Read the server message into a byte buffer.
byte[] bytes = new byte[1024];
networkStream.Read(bytes, 0, 1024);
//Convert the server's message into a string and display it.
string data = Encoding.UTF8.GetString(bytes);
Console.WriteLine("Server sent message: {0}", data);
networkStream.Close();
tcpClient.Close();

Hinweise

Wenn der Lesevorgang nicht innerhalb der von dieser Eigenschaft angegebenen Zeit abgeschlossen wird, löst der Lesevorgang einen aus IOException.

Hinweis

Diese Eigenschaft wirkt sich nur auf synchrone Lesevorgänge aus, die durch Aufrufen der Read -Methode ausgeführt werden. Diese Eigenschaft wirkt sich nicht auf asynchrone Lesevorgänge aus, die durch Aufrufen der BeginRead -Methode oder ReadAsync ausgeführt werden.