SerialPort.WriteTimeout Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o número de milissegundos antes de ocorrer um time-out quando uma operação de escrita não termina.
public:
property int WriteTimeout { int get(); void set(int value); };
public int WriteTimeout { get; set; }
[System.ComponentModel.Browsable(true)]
public int WriteTimeout { get; set; }
member this.WriteTimeout : int with get, set
[<System.ComponentModel.Browsable(true)>]
member this.WriteTimeout : int with get, set
Public Property WriteTimeout As Integer
Valor de Propriedade
O número de milissegundos antes de ocorrer um tempo morto. A predefinição é InfiniteTimeout.
- Atributos
Exceções
A porta está em estado inválido.
-ou-
Uma tentativa de definir o estado da porta subjacente falhou. Por exemplo, os parâmetros passados por este SerialPort objeto eram inválidos.
O WriteTimeout valor é menor que zero e não é igual a InfiniteTimeout.
Exemplos
O exemplo de código seguinte demonstra o uso da SerialPort classe para permitir que dois utilizadores conversem a partir de dois computadores separados ligados por um cabo null modem. Neste exemplo, os utilizadores são solicitados a indicar as definições de port e um nome de utilizador antes de conversar. Este exemplo de código faz parte de um exemplo de código mais amplo fornecido para a SerialPort classe.
public static void Main()
{
string name;
string message;
StringComparer stringComparer = StringComparer.OrdinalIgnoreCase;
Thread readThread = new Thread(Read);
// Create a new SerialPort object with default settings.
_serialPort = new SerialPort();
// Allow the user to set the appropriate properties.
_serialPort.PortName = SetPortName(_serialPort.PortName);
_serialPort.BaudRate = SetPortBaudRate(_serialPort.BaudRate);
_serialPort.Parity = SetPortParity(_serialPort.Parity);
_serialPort.DataBits = SetPortDataBits(_serialPort.DataBits);
_serialPort.StopBits = SetPortStopBits(_serialPort.StopBits);
_serialPort.Handshake = SetPortHandshake(_serialPort.Handshake);
// Set the read/write timeouts
_serialPort.ReadTimeout = 500;
_serialPort.WriteTimeout = 500;
_serialPort.Open();
_continue = true;
readThread.Start();
Console.Write("Name: ");
name = Console.ReadLine();
Console.WriteLine("Type QUIT to exit");
while (_continue)
{
message = Console.ReadLine();
if (stringComparer.Equals("quit", message))
{
_continue = false;
}
else
{
_serialPort.WriteLine(
String.Format("<{0}>: {1}", name, message));
}
}
readThread.Join();
_serialPort.Close();
}
public static void Read()
{
while (_continue)
{
try
{
string message = _serialPort.ReadLine();
Console.WriteLine(message);
}
catch (TimeoutException) { }
}
}
Public Shared Sub Main()
Dim name As String
Dim message As String
Dim stringComparer__1 As StringComparer = StringComparer.OrdinalIgnoreCase
Dim readThread As New Thread(AddressOf Read)
' Create a new SerialPort object with default settings.
_serialPort = New SerialPort()
' Allow the user to set the appropriate properties.
_serialPort.PortName = SetPortName(_serialPort.PortName)
_serialPort.BaudRate = SetPortBaudRate(_serialPort.BaudRate)
_serialPort.Parity = SetPortParity(_serialPort.Parity)
_serialPort.DataBits = SetPortDataBits(_serialPort.DataBits)
_serialPort.StopBits = SetPortStopBits(_serialPort.StopBits)
_serialPort.Handshake = SetPortHandshake(_serialPort.Handshake)
' Set the read/write timeouts
_serialPort.ReadTimeout = 500
_serialPort.WriteTimeout = 500
_serialPort.Open()
_continue = True
readThread.Start()
Console.Write("Name: ")
name = Console.ReadLine()
Console.WriteLine("Type QUIT to exit")
While _continue
message = Console.ReadLine()
If stringComparer__1.Equals("quit", message) Then
_continue = False
Else
_serialPort.WriteLine([String].Format("<{0}>: {1}", name, message))
End If
End While
readThread.Join()
_serialPort.Close()
End Sub
Public Shared Sub Read()
While _continue
Try
Dim message As String = _serialPort.ReadLine()
Console.WriteLine(message)
Catch generatedExceptionName As TimeoutException
End Try
End While
End Sub
Observações
O valor do tempo de espera de escrita foi originalmente definido em 500 milissegundos na API de Comunicações Win32. Esta propriedade permite-lhe definir este valor. O time-out pode ser definido para qualquer valor superior a zero, ou para InfiniteTimeout, caso em que não ocorre time-out. InfiniteTimeout é o padrão.
Note
Os utilizadores da estrutura não gerida COMMTIMEOUTS podem esperar definir o valor de time-out a zero para suprimir os time-outs. Para suprimir tempos de espera com a WriteTimeout propriedade, no entanto, deve especificar InfiniteTimeout.
Esta propriedade não afeta o BeginWrite método do fluxo de água devolvido pela BaseStream propriedade.