SerialPort 构造函数

定义

命名空间:

System.IO.Ports

程序集:

System.IO.Ports.dll

包:

System.IO.Ports v8.0.0

初始化 SerialPort 类的新实例。

重载

SerialPort()	初始化 SerialPort 类的新实例。
SerialPort(IContainer)	使用指定的 IContainer 对象初始化 SerialPort 类的新实例。
SerialPort(String)	使用指定的端口名初始化 SerialPort 类的新实例。
SerialPort(String, Int32)	使用指定的端口名和波特率初始化 SerialPort 类的新实例。
SerialPort(String, Int32, Parity)	使用指定的端口名、波特率和奇偶校验位初始化 SerialPort 类的新实例。
SerialPort(String, Int32, Parity, Int32)	使用指定的端口名、波特率、奇偶校验位和数据位初始化 SerialPort 类的新实例。
SerialPort(String, Int32, Parity, Int32, StopBits)	使用指定的端口名、波特率、奇偶校验位、数据位和停止位初始化 SerialPort 类的新实例。

SerialPort()

Source:

SerialPort.cs

初始化 SerialPort 类的新实例。

public:
 SerialPort();

public SerialPort ();

Public Sub New ()

示例

下面的代码示例演示了如何使用 SerialPort 类来允许两个用户从两台由 null 调制解调器电缆连接的单独计算机中聊天。 在此示例中，系统会在聊天之前提示用户输入端口设置和用户名。 此代码示例是为 类提供的更大代码示例的 SerialPort 一部分。

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

注解

如果未指定任何值，则此构造函数使用默认属性值。 例如， DataBits 属性默认为 8， Parity 属性默认为 None 枚举值， StopBits 属性默认为 1，默认端口名称为 COM1。

SerialPort(IContainer)

Source:

SerialPort.cs

使用指定的 IContainer 对象初始化 SerialPort 类的新实例。

public:
 SerialPort(System::ComponentModel::IContainer ^ container);

public SerialPort (System.ComponentModel.IContainer container);

new System.IO.Ports.SerialPort : System.ComponentModel.IContainer -> System.IO.Ports.SerialPort

Public Sub New (container As IContainer)

参数

container

IContainer

容器的接口。

例外

IOException

未能找到或打开指定的端口。

注解

如果未指定任何值，则此构造函数使用默认属性值。 例如， DataBits 属性默认为 8， Parity 属性默认为 None 枚举值， StopBits 属性默认为 1，默认端口名称为 COM1。

SerialPort(String)

Source:

SerialPort.cs

使用指定的端口名初始化 SerialPort 类的新实例。

public:
 SerialPort(System::String ^ portName);

public SerialPort (string portName);

new System.IO.Ports.SerialPort : string -> System.IO.Ports.SerialPort

Public Sub New (portName As String)

参数

portName

String

要使用的端口（例如 COM1）。

例外

IOException

未能找到或打开指定的端口。

注解

若要指定端口名称， SerialPort 请使用此构造函数创建 类的新实例。

SerialPort(String, Int32)

Source:

SerialPort.cs

使用指定的端口名和波特率初始化 SerialPort 类的新实例。

public:
 SerialPort(System::String ^ portName, int baudRate);

public SerialPort (string portName, int baudRate);

new System.IO.Ports.SerialPort : string * int -> System.IO.Ports.SerialPort

Public Sub New (portName As String, baudRate As Integer)

参数

portName

String

要使用的端口（例如 COM1）。

baudRate

Int32

波特率。

例外

IOException

未能找到或打开指定的端口。

注解

如果要指定端口名称和波特率，请使用此构造函数创建 类的新实例 SerialPort 。

SerialPort(String, Int32, Parity)

Source:

SerialPort.cs

使用指定的端口名、波特率和奇偶校验位初始化 SerialPort 类的新实例。

public:
 SerialPort(System::String ^ portName, int baudRate, System::IO::Ports::Parity parity);

public SerialPort (string portName, int baudRate, System.IO.Ports.Parity parity);

new System.IO.Ports.SerialPort : string * int * System.IO.Ports.Parity -> System.IO.Ports.SerialPort

Public Sub New (portName As String, baudRate As Integer, parity As Parity)

参数

portName

String

要使用的端口（例如 COM1）。

baudRate

Int32

波特率。

parity

Parity

Parity 值之一。

例外

IOException

未能找到或打开指定的端口。

注解

如果要指定端口名称、波特率和奇偶校验位，请使用此构造函数创建 类的新实例 SerialPort 。

SerialPort(String, Int32, Parity, Int32)

Source:

SerialPort.cs

使用指定的端口名、波特率、奇偶校验位和数据位初始化 SerialPort 类的新实例。

public:
 SerialPort(System::String ^ portName, int baudRate, System::IO::Ports::Parity parity, int dataBits);

public SerialPort (string portName, int baudRate, System.IO.Ports.Parity parity, int dataBits);

new System.IO.Ports.SerialPort : string * int * System.IO.Ports.Parity * int -> System.IO.Ports.SerialPort

Public Sub New (portName As String, baudRate As Integer, parity As Parity, dataBits As Integer)

参数

portName

String

要使用的端口（例如 COM1）。

baudRate

Int32

波特率。

parity

Parity

Parity 值之一。

dataBits

Int32

数据位值。

例外

IOException

未能找到或打开指定的端口。

注解

如果要指定端口名称、波特率、奇偶校验位和数据位，请使用此构造函数创建 类的新实例 SerialPort 。

SerialPort(String, Int32, Parity, Int32, StopBits)

Source:

SerialPort.cs

使用指定的端口名、波特率、奇偶校验位、数据位和停止位初始化 SerialPort 类的新实例。

public:
 SerialPort(System::String ^ portName, int baudRate, System::IO::Ports::Parity parity, int dataBits, System::IO::Ports::StopBits stopBits);

public SerialPort (string portName, int baudRate, System.IO.Ports.Parity parity, int dataBits, System.IO.Ports.StopBits stopBits);

new System.IO.Ports.SerialPort : string * int * System.IO.Ports.Parity * int * System.IO.Ports.StopBits -> System.IO.Ports.SerialPort

Public Sub New (portName As String, baudRate As Integer, parity As Parity, dataBits As Integer, stopBits As StopBits)

参数

portName

String

要使用的端口（例如 COM1）。

baudRate

Int32

波特率。

parity

Parity

Parity 值之一。

dataBits

Int32

数据位值。

stopBits

StopBits

StopBits 值之一。

例外

IOException

未能找到或打开指定的端口。

注解

如果要指定端口名称、波特率、奇偶校验位、数据位和停止位，请使用此构造函数创建 类的新实例 SerialPort 。