SerialPort Construtores

Definição

Namespace:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Pacote:

System.IO.Ports v8.0.0

Inicializa uma nova instância da classe SerialPort.

Sobrecargas

SerialPort()	Inicializa uma nova instância da classe SerialPort.
SerialPort(IContainer)	Inicializa uma nova instância da classe SerialPort usando o objeto IContainer especificado.
SerialPort(String)	Inicializa uma nova instância da classe SerialPort, usando o nome da porta especificado.
SerialPort(String, Int32)	Inicializa uma nova instância da classe SerialPort usando a taxa de transmissão e o nome da porta especificadas.
SerialPort(String, Int32, Parity)	Inicializa uma nova instância da classe SerialPort usando o nome da porta, a taxa de transmissão e o bit de paridade especificados.
SerialPort(String, Int32, Parity, Int32)	Inicializa uma nova instância da classe SerialPort usando o nome da porta, a taxa de transmissão, o bit de paridade e os bits de dados especificados.
SerialPort(String, Int32, Parity, Int32, StopBits)	Inicializa uma nova instância da classe SerialPort usando o nome da porta especificado, a taxa de transmissão, o bit de paridade, o bits de dados e o bit de parada.

SerialPort()

Origem:

SerialPort.cs

Inicializa uma nova instância da classe SerialPort.

public:
 SerialPort();

public SerialPort ();

Public Sub New ()

Exemplos

O exemplo de código a seguir demonstra o uso da SerialPort classe para permitir que dois usuários conversem de dois computadores separados conectados por um cabo modem nulo. Neste exemplo, os usuários são solicitados a fornecer as configurações de porta e um nome de usuário antes de conversar. Este exemplo de código faz parte de um exemplo de código maior fornecido para a SerialPort classe .

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

Comentários

Esse construtor usa valores de propriedade padrão quando nenhum é especificado. Por exemplo, a DataBits propriedade usa como padrão 8, a Parity propriedade usa como padrão o None valor de enumeração, a StopBits propriedade usa como padrão 1 e um nome de porta padrão de COM1.

SerialPort(IContainer)

Origem:

SerialPort.cs

Inicializa uma nova instância da classe SerialPort usando o objeto IContainer especificado.

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)

Parâmetros

container

IContainer

Uma interface para um contêiner.

Exceções

IOException

Não foi possível encontrar ou abrir a porta especificada.

Comentários

Esse construtor usa valores de propriedade padrão quando nenhum é especificado. Por exemplo, a DataBits propriedade usa como padrão 8, a Parity propriedade usa como padrão o None valor de enumeração, a StopBits propriedade usa como padrão 1 e um nome de porta padrão de COM1.

SerialPort(String)

Origem:

SerialPort.cs

Inicializa uma nova instância da classe SerialPort, usando o nome da porta especificado.

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)

Parâmetros

portName

String

A porta a ser usada (por exemplo, COM1).

Exceções

IOException

Não foi possível encontrar ou abrir a porta especificada.

Comentários

Use esse construtor para criar uma nova instância da SerialPort classe quando quiser especificar o nome da porta.

SerialPort(String, Int32)

Origem:

SerialPort.cs

Inicializa uma nova instância da classe SerialPort usando a taxa de transmissão e o nome da porta especificadas.

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)

Parâmetros

portName

String

A porta a ser usada (por exemplo, COM1).

baudRate

Int32

A taxa de transmissão.

Exceções

IOException

Não foi possível encontrar ou abrir a porta especificada.

Comentários

Use esse construtor para criar uma nova instância da SerialPort classe quando quiser especificar o nome da porta e a taxa de baud.

SerialPort(String, Int32, Parity)

Origem:

SerialPort.cs

Inicializa uma nova instância da classe SerialPort usando o nome da porta, a taxa de transmissão e o bit de paridade especificados.

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)

Parâmetros

portName

String

A porta a ser usada (por exemplo, COM1).

baudRate

Int32

A taxa de transmissão.

parity

Parity

Um dos valores de Parity.

Exceções

IOException

Não foi possível encontrar ou abrir a porta especificada.

Comentários

Use esse construtor para criar uma nova instância da SerialPort classe quando quiser especificar o nome da porta, a taxa de baud e o bit de paridade.

SerialPort(String, Int32, Parity, Int32)

Origem:

SerialPort.cs

Inicializa uma nova instância da classe SerialPort usando o nome da porta, a taxa de transmissão, o bit de paridade e os bits de dados especificados.

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)

Parâmetros

portName

String

A porta a ser usada (por exemplo, COM1).

baudRate

Int32

A taxa de transmissão.

parity

Parity

Um dos valores de Parity.

dataBits

Int32

O valor de bits dos dados.

Exceções

IOException

Não foi possível encontrar ou abrir a porta especificada.

Comentários

Use esse construtor para criar uma nova instância da SerialPort classe quando quiser especificar o nome da porta, a taxa de baud, o bit de paridade e os bits de dados.

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

Origem:

SerialPort.cs

Inicializa uma nova instância da classe SerialPort usando o nome da porta especificado, a taxa de transmissão, o bit de paridade, o bits de dados e o bit de parada.

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)

Parâmetros

portName

String

A porta a ser usada (por exemplo, COM1).

baudRate

Int32

A taxa de transmissão.

parity

Parity

Um dos valores de Parity.

dataBits

Int32

O valor de bits dos dados.

stopBits

StopBits

Um dos valores de StopBits.

Exceções

IOException

Não foi possível encontrar ou abrir a porta especificada.

Comentários

Use esse construtor para criar uma nova instância da SerialPort classe quando quiser especificar o nome da porta, a taxa de baud, o bit de paridade, os bits de dados e o bit de parada.