SerialPort Constructeurs

Définition

Initialise une nouvelle instance de la classe SerialPort.

Surcharges

SerialPort()

Initialise une nouvelle instance de la classe SerialPort.

SerialPort(IContainer)

Initialise une nouvelle instance de la classe SerialPort à l'aide de l'objet IContainer spécifié.

SerialPort(String)

Initialise une nouvelle instance de la classe SerialPort avec le nom de port spécifié.

SerialPort(String, Int32)

Initialise une nouvelle instance de la classe SerialPort avec le nom de port et la vitesse (en bauds) spécifiés.

SerialPort(String, Int32, Parity)

Initialise une nouvelle instance de la classe SerialPort avec le nom de port, la vitesse (en bauds) et le bit de parité spécifiés.

SerialPort(String, Int32, Parity, Int32)

Initialise une nouvelle instance de la classe SerialPort avec le nom de port, la vitesse (en bauds), le bit de parité et les bits de données spécifiés.

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

Initialise une nouvelle instance de la classe SerialPort avec le nom de port, la vitesse (en bauds), le bit de parité, les bits de données et le bit d'arrêt spécifiés.

SerialPort()

Initialise une nouvelle instance de la classe SerialPort.

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

Exemples

L’exemple de code suivant illustre l’utilisation de la SerialPort classe pour permettre à deux utilisateurs de discuter à partir de deux ordinateurs distincts connectés par un câble de modem null. Dans cet exemple, les utilisateurs sont invités à entrer les paramètres du port et un nom d’utilisateur avant de discuter. Cet exemple de code fait partie d’un exemple de code plus volumineux fourni pour la 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

Remarques

Ce constructeur utilise les valeurs de propriété par défaut lorsqu’aucun n’est spécifié. Par exemple, la DataBits propriété est définie par défaut sur 8, la Parity propriété par défaut sur la None valeur d’énumération, la StopBits propriété est par défaut 1 et un nom de port par défaut de COM1.

S’applique à

SerialPort(IContainer)

Initialise une nouvelle instance de la classe SerialPort à l'aide de l'objet IContainer spécifié.

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)

Paramètres

container
IContainer

Interface avec un conteneur.

Exceptions

Le port spécifié est introuvable ou n'a pas pu être ouvert.

Remarques

Ce constructeur utilise les valeurs de propriété par défaut lorsqu’aucun n’est spécifié. Par exemple, la DataBits propriété est définie par défaut sur 8, la Parity propriété par défaut sur la None valeur d’énumération, la StopBits propriété est par défaut 1 et un nom de port par défaut de COM1.

S’applique à

SerialPort(String)

Initialise une nouvelle instance de la classe SerialPort avec le nom de port spécifié.

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)

Paramètres

portName
String

Port à utiliser (par exemple, COM1).

Exceptions

Le port spécifié est introuvable ou n'a pas pu être ouvert.

Remarques

Utilisez ce constructeur pour créer une instance de la SerialPort classe lorsque vous souhaitez spécifier le nom du port.

S’applique à

SerialPort(String, Int32)

Initialise une nouvelle instance de la classe SerialPort avec le nom de port et la vitesse (en bauds) spécifiés.

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)

Paramètres

portName
String

Port à utiliser (par exemple, COM1).

baudRate
Int32

Vitesse en bauds.

Exceptions

Le port spécifié est introuvable ou n'a pas pu être ouvert.

Remarques

Utilisez ce constructeur pour créer une instance de la SerialPort classe lorsque vous souhaitez spécifier le nom du port et le taux de baud.

S’applique à

SerialPort(String, Int32, Parity)

Initialise une nouvelle instance de la classe SerialPort avec le nom de port, la vitesse (en bauds) et le bit de parité spécifiés.

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)

Paramètres

portName
String

Port à utiliser (par exemple, COM1).

baudRate
Int32

Vitesse en bauds.

parity
Parity

Une des valeurs de l'objet Parity.

Exceptions

Le port spécifié est introuvable ou n'a pas pu être ouvert.

Remarques

Utilisez ce constructeur pour créer une instance de la SerialPort classe lorsque vous souhaitez spécifier le nom du port, le taux de baud et le bit de parité.

S’applique à

SerialPort(String, Int32, Parity, Int32)

Initialise une nouvelle instance de la classe SerialPort avec le nom de port, la vitesse (en bauds), le bit de parité et les bits de données spécifiés.

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)

Paramètres

portName
String

Port à utiliser (par exemple, COM1).

baudRate
Int32

Vitesse en bauds.

parity
Parity

Une des valeurs de l'objet Parity.

dataBits
Int32

Valeur des bits de données.

Exceptions

Le port spécifié est introuvable ou n'a pas pu être ouvert.

Remarques

Utilisez ce constructeur pour créer une instance de la SerialPort classe lorsque vous souhaitez spécifier le nom du port, le taux de baud, le bit de parité et les bits de données.

S’applique à

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

Initialise une nouvelle instance de la classe SerialPort avec le nom de port, la vitesse (en bauds), le bit de parité, les bits de données et le bit d'arrêt spécifiés.

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)

Paramètres

portName
String

Port à utiliser (par exemple, COM1).

baudRate
Int32

Vitesse en bauds.

parity
Parity

Une des valeurs de l'objet Parity.

dataBits
Int32

Valeur des bits de données.

stopBits
StopBits

Une des valeurs de l'objet StopBits.

Exceptions

Le port spécifié est introuvable ou n'a pas pu être ouvert.

Remarques

Utilisez ce constructeur pour créer une instance de la SerialPort classe lorsque vous souhaitez spécifier le nom du port, le taux de baud, le bit de parité, les bits de données et les bits d’arrêt.

S’applique à