Idioma

SerialPort Construtores

Definição

Inicializa uma nova instância da SerialPort classe.

Sobrecargas

Nome Descrição
SerialPort()

Inicializa uma nova instância da SerialPort classe.

SerialPort(IContainer)

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

SerialPort(String)

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

SerialPort(String, Int32)

Inicializa uma nova instância da SerialPort classe usando o nome de porta e a taxa de baud especificados.

SerialPort(String, Int32, Parity)

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

SerialPort(String, Int32, Parity, Int32)

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

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

Inicializa uma nova instância da SerialPort classe usando o nome da porta especificado, taxa de baud, bit de paridade, bits de dados e bit de paragem.

SerialPort()

Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs

Inicializa uma nova instância da SerialPort classe.

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

Exemplos

O exemplo de código seguinte demonstra o uso da SerialPort classe para permitir que dois utilizadores conversem a partir de dois computadores separados ligados por um cabo null modem. Neste exemplo, os utilizadores são solicitados a indicar as definições de port e um nome de utilizador antes de conversar. Este exemplo de código faz parte de um exemplo de código mais amplo fornecido para a SerialPort classe.

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

Observações

Este construtor utiliza valores de propriedade por defeito quando nenhum está especificado. Por exemplo, a DataBits propriedade é padrão 8, a Parity propriedade é o None valor de enumeração, a StopBits propriedade é 1, e o nome de porta padrão é COM1.

Aplica-se a

SerialPort(IContainer)

Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs

Inicializa uma nova instância da SerialPort classe usando o objeto especificado 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)

Parâmetros

container
IContainer

Uma interface para um contentor.

Exceções

A porta especificada não podia ser encontrada nem aberta.

Observações

Este construtor utiliza valores de propriedade por defeito quando nenhum está especificado. Por exemplo, a DataBits propriedade é padrão 8, a Parity propriedade é o None valor de enumeração, a StopBits propriedade é 1, e o nome de porta padrão é COM1.

Aplica-se a

SerialPort(String)

Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs

Inicializa uma nova instância da SerialPort classe 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 usar (por exemplo, COM1).

Exceções

A porta especificada não podia ser encontrada nem aberta.

Observações

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

Aplica-se a

SerialPort(String, Int32)

Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs

Inicializa uma nova instância da SerialPort classe usando o nome de porta e a taxa de baud especificados.

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 usar (por exemplo, COM1).

baudRate
Int32

A taxa de baud.

Exceções

A porta especificada não podia ser encontrada nem aberta.

Observações

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

Aplica-se a

SerialPort(String, Int32, Parity)

Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs

Inicializa uma nova instância da SerialPort classe usando o nome da porta, a taxa de bauds 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 usar (por exemplo, COM1).

baudRate
Int32

A taxa de baud.

parity
Parity

Um dos Parity valores.

Exceções

A porta especificada não podia ser encontrada nem aberta.

Observações

Use este 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.

Aplica-se a

SerialPort(String, Int32, Parity, Int32)

Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs

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

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 usar (por exemplo, COM1).

baudRate
Int32

A taxa de baud.

parity
Parity

Um dos Parity valores.

dataBits
Int32

O valor dos bits de dados.

Exceções

A porta especificada não podia ser encontrada nem aberta.

Observações

Use este 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.

Aplica-se a

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

Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs
Origem:
SerialPort.cs

Inicializa uma nova instância da SerialPort classe usando o nome da porta especificado, taxa de baud, bit de paridade, bits de dados e bit de paragem.

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 usar (por exemplo, COM1).

baudRate
Int32

A taxa de baud.

parity
Parity

Um dos Parity valores.

dataBits
Int32

O valor dos bits de dados.

stopBits
StopBits

Um dos StopBits valores.

Exceções

A porta especificada não podia ser encontrada nem aberta.

Observações

Use este 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 paragem.

Aplica-se a