SerialPort.WriteTimeout Özellik

Tanım

Ad Alanı:

System.IO.Ports

Bütünleştirilmiş Kod:

System.IO.Ports.dll

Paket:

System.IO.Ports v8.0.0

Kaynak:

SerialPort.cs

Yazma işlemi tamamlanmadığında zaman aşımı gerçekleşmeden önce milisaniye sayısını alır veya ayarlar.

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

public int WriteTimeout { get; set; }

member this.WriteTimeout : int with get, set

Public Property WriteTimeout As Integer

Özellik Değeri

Int32

Zaman aşımı gerçekleşmeden önce milisaniye sayısı. Varsayılan değer: InfiniteTimeout.

Özel durumlar

IOException

Bağlantı noktası geçersiz durumda.

-veya-

Temel alınan bağlantı noktasının durumunu ayarlama girişimi başarısız oldu. Örneğin, bu SerialPort nesneden geçirilen parametreler geçersizdi.

ArgumentOutOfRangeException

WriteTimeout Değer sıfırdan küçüktür ve değerine InfiniteTimeouteşit değildir.

Örnekler

Aşağıdaki kod örneği, iki kullanıcının null modem kablosuyla bağlanan iki ayrı bilgisayardan sohbet etmelerine izin vermek için sınıfının kullanımını SerialPort gösterir. Bu örnekte, sohbet etmeden önce kullanıcılardan bağlantı noktası ayarları ve kullanıcı adı istenir. Bu kod örneği, sınıfı için sağlanan daha büyük bir kod örneğinin SerialPort bir parçasıdır.

public:
    static void Main()
    {
        String^ name;
        String^ message;
        StringComparer^ stringComparer = StringComparer::OrdinalIgnoreCase;
        Thread^ readThread = gcnew Thread(gcnew ThreadStart(PortChat::Read));

        // Create a new SerialPort object with default settings.
        _serialPort = gcnew 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();
    }

    static void Read()
    {
        while (_continue)
        {
            try
            {
                String^ message = _serialPort->ReadLine();
                Console::WriteLine(message);
            }
            catch (TimeoutException ^) { }
        }
    }

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

Açıklamalar

Yazma zaman aşımı değeri başlangıçta Win32 Communications API'sinde 500 milisaniye olarak ayarlanmıştı. Bu özellik, bu değeri ayarlamanıza olanak tanır. Zaman aşımı sıfırdan büyük herhangi bir değere ayarlanabilir veya olarak ayarlanabilir InfiniteTimeout; bu durumda zaman aşımı gerçekleşmez. InfiniteTimeout varsayılan değerdir.

Not

Yönetilmeyen COMMTIMEOUTS yapı kullanıcıları, zaman aşımlarını engellemek için zaman aşımı değerini sıfır olarak ayarlamayı bekleyebilir. Ancak özelliğiyle WriteTimeout zaman aşımlarını engellemek için belirtmelisiniz InfiniteTimeout.

Bu özellik, özelliği tarafından BaseStream döndürülen akışın yöntemini etkilemezBeginWrite.