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

Определение

Инициализирует новый экземпляр класса SerialPort.

Перегрузки

SerialPort()

Инициализирует новый экземпляр класса SerialPort.

SerialPort(IContainer)

Инициализирует новый экземпляр класса SerialPort, используя указанный объект IContainer.

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()

Инициализирует новый экземпляр класса 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)

Инициализирует новый экземпляр класса SerialPort, используя указанный объект IContainer.

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

Интерфейс к контейнеру.

Исключения

Не удается найти или открыть указанный порт.

Комментарии

Этот конструктор использует значения свойств по умолчанию, если они не указаны. Например, DataBits свойство по умолчанию имеет значение 8, Parity свойство по умолчанию имеет None значение перечисления, StopBits свойство по умолчанию равно 1 и имя порта com1 по умолчанию.

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

SerialPort(String)

Инициализирует новый экземпляр класса 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).

Исключения

Не удается найти или открыть указанный порт.

Комментарии

Используйте этот конструктор для создания нового экземпляра SerialPort класса, если требуется указать имя порта.

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

SerialPort(String, Int32)

Инициализирует новый экземпляр класса 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

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

Исключения

Не удается найти или открыть указанный порт.

Комментарии

Используйте этот конструктор для создания нового экземпляра SerialPort класса, если требуется указать имя порта и скорость baud.

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

SerialPort(String, Int32, Parity)

Инициализирует новый экземпляр класса 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.

Исключения

Не удается найти или открыть указанный порт.

Комментарии

Используйте этот конструктор для создания нового экземпляра SerialPort класса, если требуется указать имя порта, скорость четности и бит четности.

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

SerialPort(String, Int32, Parity, Int32)

Инициализирует новый экземпляр класса 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

Число битов данных.

Исключения

Не удается найти или открыть указанный порт.

Комментарии

Используйте этот конструктор для создания нового экземпляра SerialPort класса, если требуется указать имя порта, скорость baud, бит четности и биты данных.

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

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

Инициализирует новый экземпляр класса 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.

Исключения

Не удается найти или открыть указанный порт.

Комментарии

Используйте этот конструктор для создания нового экземпляра SerialPort класса, если требуется указать имя порта, скорость baud, бит четности, бит данных и стоп-бит.

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