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

Определение

Пространство имен:

System.IO.Ports

Сборка:

System.IO.Ports.dll

Пакет:

System.IO.Ports v8.0.0

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

Исходный код:

SerialPort.cs

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

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

Исключения

IOException

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

Комментарии

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

SerialPort(String)

Исходный код:

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)

Исходный код:

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)

Исходный код:

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)

Исходный код:

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)

Исходный код:

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 если требуется указать имя порта, скорость передачи данных, бит четности, бит данных и стоп-бит.