SerialPort Конструкторы

Определение

Инициализирует новый экземпляр класса SerialPort.Initializes a new instance of the SerialPort class.

Перегрузки

SerialPort()

Инициализирует новый экземпляр класса SerialPort.Initializes a new instance of the SerialPort class.

SerialPort(IContainer)

Инициализирует новый экземпляр класса SerialPort, используя указанный объект IContainer.Initializes a new instance of the SerialPort class using the specified IContainer object.

SerialPort(String)

Инициализирует новый экземпляр класса SerialPort, используя указанное имя порта.Initializes a new instance of the SerialPort class using the specified port name.

SerialPort(String, Int32)

Инициализирует новый экземпляр класса SerialPort, используя указанное имя порта и скорость передачи в бодах.Initializes a new instance of the SerialPort class using the specified port name and baud rate.

SerialPort(String, Int32, Parity)

Инициализирует новый экземпляр класса SerialPort, используя указанное имя порта, скорость передачи в бодах и бит четности.Initializes a new instance of the SerialPort class using the specified port name, baud rate, and parity bit.

SerialPort(String, Int32, Parity, Int32)

Инициализирует новый экземпляр класса SerialPort, используя указанное имя порта, скорость передачи в бодах, бит четности и биты данных.Initializes a new instance of the SerialPort class using the specified port name, baud rate, parity bit, and data bits.

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

Инициализирует новый экземпляр класса SerialPort, используя указанное имя порта, скорость передачи в бодах, бит четности, биты данных и стоп-бит.Initializes a new instance of the SerialPort class using the specified port name, baud rate, parity bit, data bits, and stop bit.

SerialPort()

Инициализирует новый экземпляр класса SerialPort.Initializes a new instance of the SerialPort class.

public:
 SerialPort();
public SerialPort ();
Public Sub New ()

Примеры

В следующем примере кода показано использование SerialPort класса, чтобы два пользователя могли общаться с двух отдельных компьютеров, Соединенных нуль-модемным кабелем.The following code example demonstrates the use of the SerialPort class to allow two users to chat from two separate computers connected by a null modem cable. В этом примере пользователям предлагается ввести параметры порта и имя пользователя перед разговором.In this example, the users are prompted for the port settings and a username before chatting. Этот пример кода является частью более крупного примера кода, SerialPort предоставленного для класса.This code example is part of a larger code example provided for the SerialPort class.

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

Комментарии

Этот конструктор использует значения свойств по умолчанию, если ни одно из них не указано.This constructor uses default property values when none are specified. Например, DataBits свойство по умолчанию равно 8 Parity , None свойство по умолчанию имеет значение перечисления, StopBits свойство по умолчанию равно 1 и имя порта COM1 по умолчанию.For example, the DataBits property defaults to 8, the Parity property defaults to the None enumeration value, the StopBits property defaults to 1, and a default port name of COM1.

SerialPort(IContainer)

Инициализирует новый экземпляр класса SerialPort, используя указанный объект IContainer.Initializes a new instance of the SerialPort class using the specified IContainer object.

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

Интерфейс к контейнеру.An interface to a container.

Исключения

Не удается найти или открыть указанный порт.The specified port could not be found or opened.

Комментарии

Этот конструктор использует значения свойств по умолчанию, если ни одно из них не указано.This constructor uses default property values when none are specified. Например, DataBits свойство по умолчанию равно 8 Parity , None свойство по умолчанию имеет значение перечисления, StopBits свойство по умолчанию равно 1 и имя порта COM1 по умолчанию.For example, the DataBits property defaults to 8, the Parity property defaults to the None enumeration value, the StopBits property defaults to 1, and a default port name of COM1.

SerialPort(String)

Инициализирует новый экземпляр класса SerialPort, используя указанное имя порта.Initializes a new instance of the SerialPort class using the specified port name.

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).The port to use (for example, COM1).

Исключения

Не удается найти или открыть указанный порт.The specified port could not be found or opened.

Комментарии

Используйте этот конструктор для создания нового экземпляра класса, SerialPort если необходимо указать имя порта.Use this constructor to create a new instance of the SerialPort class when you want to specify the port name.

SerialPort(String, Int32)

Инициализирует новый экземпляр класса SerialPort, используя указанное имя порта и скорость передачи в бодах.Initializes a new instance of the SerialPort class using the specified port name and baud rate.

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).The port to use (for example, COM1).

baudRate
Int32

Скорость в бодах.The baud rate.

Исключения

Не удается найти или открыть указанный порт.The specified port could not be found or opened.

Комментарии

Используйте этот конструктор для создания нового экземпляра SerialPort класса, если необходимо указать имя порта и скорость передачи.Use this constructor to create a new instance of the SerialPort class when you want to specify the port name and the baud rate.

SerialPort(String, Int32, Parity)

Инициализирует новый экземпляр класса SerialPort, используя указанное имя порта, скорость передачи в бодах и бит четности.Initializes a new instance of the SerialPort class using the specified port name, baud rate, and parity bit.

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

Параметры

portName
String

Порт для использования (например, COM1).The port to use (for example, COM1).

baudRate
Int32

Скорость в бодах.The baud rate.

parity
Parity

Одно из значений перечисления Parity.One of the Parity values.

Исключения

Не удается найти или открыть указанный порт.The specified port could not be found or opened.

Комментарии

Используйте этот конструктор для создания нового экземпляра SerialPort класса, если необходимо указать имя порта, скорость передачи данных и бит четности.Use this constructor to create a new instance of the SerialPort class when you want to specify the port name, the baud rate, and the parity bit.

SerialPort(String, Int32, Parity, Int32)

Инициализирует новый экземпляр класса SerialPort, используя указанное имя порта, скорость передачи в бодах, бит четности и биты данных.Initializes a new instance of the SerialPort class using the specified port name, baud rate, parity bit, and data bits.

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

Параметры

portName
String

Порт для использования (например, COM1).The port to use (for example, COM1).

baudRate
Int32

Скорость в бодах.The baud rate.

parity
Parity

Одно из значений перечисления Parity.One of the Parity values.

dataBits
Int32

Число битов данных.The data bits value.

Исключения

Не удается найти или открыть указанный порт.The specified port could not be found or opened.

Комментарии

Используйте этот конструктор для создания нового экземпляра SerialPort класса, если необходимо указать имя порта, скорость передачи, бит четности и биты данных.Use this constructor to create a new instance of the SerialPort class when you want to specify the port name, the baud rate, the parity bit, and data bits.

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

Инициализирует новый экземпляр класса SerialPort, используя указанное имя порта, скорость передачи в бодах, бит четности, биты данных и стоп-бит.Initializes a new instance of the SerialPort class using the specified port name, baud rate, parity bit, data bits, and stop bit.

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

Параметры

portName
String

Порт для использования (например, COM1).The port to use (for example, COM1).

baudRate
Int32

Скорость в бодах.The baud rate.

parity
Parity

Одно из значений перечисления Parity.One of the Parity values.

dataBits
Int32

Число битов данных.The data bits value.

stopBits
StopBits

Одно из значений перечисления StopBits.One of the StopBits values.

Исключения

Не удается найти или открыть указанный порт.The specified port could not be found or opened.

Комментарии

Используйте этот конструктор для создания нового экземпляра SerialPort класса, если необходимо указать имя порта, скорость передачи, бит четности, биты данных и бит окончания.Use this constructor to create a new instance of the SerialPort class when you want to specify the port name, the baud rate, the parity bit, data bits, and stop bit.

Применяется к