Freigeben über


SerialPort Konstruktoren

Definition

Initialisiert eine neue Instanz der SerialPort-Klasse.

Überlädt

SerialPort()

Initialisiert eine neue Instanz der SerialPort-Klasse.

SerialPort(IContainer)

Initialisiert eine neue Instanz der SerialPort-Klasse mit dem angegebenen IContainer-Objekt.

SerialPort(String)

Initialisiert eine neue Instanz der SerialPort-Klasse unter Verwendung des angegebenen Anschlussnamens.

SerialPort(String, Int32)

Initialisiert eine neue Instanz der SerialPort-Klasse unter Verwendung des angegebenen Anschlussnamens und der Baudrate.

SerialPort(String, Int32, Parity)

Initialisiert eine neue Instanz der SerialPort-Klasse mit dem angegebenen Anschlussnamen, der Baudrate und dem Paritätsbit.

SerialPort(String, Int32, Parity, Int32)

Initialisiert eine neue Instanz der SerialPort-Klasse mit dem angegebenen Anschlussnamen, der Baudrate, dem Paritätsbit und Datenbits.

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

Initialisiert eine neue Instanz der SerialPort-Klasse mit dem angegebenen Anschlussnamen, der Baudrate, dem Paritätsbit, den Datenbits und Stoppbits.

SerialPort()

Quelle:
SerialPort.cs
Quelle:
SerialPort.cs
Quelle:
SerialPort.cs

Initialisiert eine neue Instanz der SerialPort-Klasse.

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

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung der SerialPort -Klasse, um zwei Benutzern das Chatten von zwei separaten Computern zu ermöglichen, die über ein Nullmodemkabel verbunden sind. In diesem Beispiel werden die Benutzer vor dem Chatten zur Eingabe der Porteinstellungen und eines Benutzernamens aufgefordert. Dieses Codebeispiel ist Teil eines größeren Codebeispiels, das für die SerialPort -Klasse bereitgestellt wird.

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

Hinweise

Dieser Konstruktor verwendet Standardeigenschaftenwerte, wenn keine angegeben sind. Die Eigenschaft ist beispielsweise DataBits standardmäßig auf 8 festgelegt, die Parity Eigenschaft standardmäßig auf den None Enumerationswert, die StopBits Eigenschaft standardmäßig auf 1 und der Standardportname COM1.

Gilt für:

SerialPort(IContainer)

Quelle:
SerialPort.cs
Quelle:
SerialPort.cs
Quelle:
SerialPort.cs

Initialisiert eine neue Instanz der SerialPort-Klasse mit dem angegebenen IContainer-Objekt.

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)

Parameter

container
IContainer

Eine Schnittstelle zu einem Container.

Ausnahmen

Der angegebene Anschluss wurde nicht gefunden oder konnte nicht geöffnet werden.

Hinweise

Dieser Konstruktor verwendet Standardeigenschaftenwerte, wenn keine angegeben sind. Die Eigenschaft ist beispielsweise DataBits standardmäßig auf 8 festgelegt, die Parity Eigenschaft standardmäßig auf den None Enumerationswert, die StopBits Eigenschaft standardmäßig auf 1 und der Standardportname COM1.

Gilt für:

SerialPort(String)

Quelle:
SerialPort.cs
Quelle:
SerialPort.cs
Quelle:
SerialPort.cs

Initialisiert eine neue Instanz der SerialPort-Klasse unter Verwendung des angegebenen Anschlussnamens.

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)

Parameter

portName
String

Der zu verwendende Anschluss (z. B. COM1).

Ausnahmen

Der angegebene Anschluss wurde nicht gefunden oder konnte nicht geöffnet werden.

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue instance der SerialPort -Klasse zu erstellen, wenn Sie den Portnamen angeben möchten.

Gilt für:

SerialPort(String, Int32)

Quelle:
SerialPort.cs
Quelle:
SerialPort.cs
Quelle:
SerialPort.cs

Initialisiert eine neue Instanz der SerialPort-Klasse unter Verwendung des angegebenen Anschlussnamens und der Baudrate.

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)

Parameter

portName
String

Der zu verwendende Anschluss (z. B. COM1).

baudRate
Int32

Die Baudrate.

Ausnahmen

Der angegebene Anschluss wurde nicht gefunden oder konnte nicht geöffnet werden.

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue instance der SerialPort Klasse zu erstellen, wenn Sie den Portnamen und die Baudrate angeben möchten.

Gilt für:

SerialPort(String, Int32, Parity)

Quelle:
SerialPort.cs
Quelle:
SerialPort.cs
Quelle:
SerialPort.cs

Initialisiert eine neue Instanz der SerialPort-Klasse mit dem angegebenen Anschlussnamen, der Baudrate und dem Paritätsbit.

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)

Parameter

portName
String

Der zu verwendende Anschluss (z. B. COM1).

baudRate
Int32

Die Baudrate.

parity
Parity

Einer der Parity-Werte.

Ausnahmen

Der angegebene Anschluss wurde nicht gefunden oder konnte nicht geöffnet werden.

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue instance der SerialPort -Klasse zu erstellen, wenn Sie den Portnamen, die Baudrate und das Paritätsbit angeben möchten.

Gilt für:

SerialPort(String, Int32, Parity, Int32)

Quelle:
SerialPort.cs
Quelle:
SerialPort.cs
Quelle:
SerialPort.cs

Initialisiert eine neue Instanz der SerialPort-Klasse mit dem angegebenen Anschlussnamen, der Baudrate, dem Paritätsbit und Datenbits.

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)

Parameter

portName
String

Der zu verwendende Anschluss (z. B. COM1).

baudRate
Int32

Die Baudrate.

parity
Parity

Einer der Parity-Werte.

dataBits
Int32

Der Datenbitwert.

Ausnahmen

Der angegebene Anschluss wurde nicht gefunden oder konnte nicht geöffnet werden.

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue instance der SerialPort -Klasse zu erstellen, wenn Sie den Portnamen, die Baudrate, das Paritätsbit und die Datenbits angeben möchten.

Gilt für:

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

Quelle:
SerialPort.cs
Quelle:
SerialPort.cs
Quelle:
SerialPort.cs

Initialisiert eine neue Instanz der SerialPort-Klasse mit dem angegebenen Anschlussnamen, der Baudrate, dem Paritätsbit, den Datenbits und Stoppbits.

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)

Parameter

portName
String

Der zu verwendende Anschluss (z. B. COM1).

baudRate
Int32

Die Baudrate.

parity
Parity

Einer der Parity-Werte.

dataBits
Int32

Der Datenbitwert.

stopBits
StopBits

Einer der StopBits-Werte.

Ausnahmen

Der angegebene Anschluss wurde nicht gefunden oder konnte nicht geöffnet werden.

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue instance der SerialPort -Klasse zu erstellen, wenn Sie den Portnamen, die Baudrate, das Paritätsbit, datenbits und das Stoppbit angeben möchten.

Gilt für: