SerialPort.Open Metod

Definition

Namnområde:
System.IO.Ports
Sammansättning:
System.dll

Öppnar en ny seriell portanslutning.

public:
 void Open();
public void Open();
member this.Open : unit -> unit
Public Sub Open ()

Undantag

UnauthorizedAccessException

Åtkomst nekas till porten.

-eller-

Den aktuella processen, eller en annan process i systemet, har redan den angivna COM-porten öppen antingen av en SerialPort instans eller i ohanterad kod.

ArgumentOutOfRangeException

En eller flera av egenskaperna för den här instansen är ogiltiga. Egenskaperna , eller är till exempel Parityinte giltiga värden, BaudRate är mindre än eller lika med noll. ReadTimeout Egenskapen eller WriteTimeout är mindre än noll och är inte InfiniteTimeout.HandshakeDataBits

ArgumentException

Portnamnet börjar inte med "COM".

-eller-

Portens filtyp stöds inte.

IOException

Porten är i ett ogiltigt tillstånd.

-eller-

Ett försök att ange tillståndet för den underliggande porten misslyckades. Parametrarna som skickades från det här SerialPort objektet var till exempel ogiltiga.

InvalidOperationException

Den angivna porten på den aktuella instansen SerialPort av är redan öppen.

Exempel

Följande kodexempel visar hur klassen används SerialPort för att tillåta två användare att chatta från två separata datorer som är anslutna med en null-modemkabel. I det här exemplet uppmanas användarna att ange portinställningarna och ett användarnamn innan de chattar. Det här kodexemplet är en del av ett större kodexempel som tillhandahålls SerialPort för klassen.

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

Kommentarer

Endast en öppen anslutning kan finnas per SerialPort objekt.

Det bästa sättet för alla program är att vänta en stund efter att du har anropat Close metoden innan du försöker anropa Open metoden, eftersom porten kanske inte stängs omedelbart.

Gäller för