Freigeben über


SerialPort Konstruktoren

Definition

Initialisiert eine neue Instanz der SerialPort-Klasse.

Überlädt

Name Beschreibung
SerialPort()

Initialisiert eine neue Instanz der SerialPort-Klasse.

SerialPort(IContainer)

Initialisiert eine neue Instanz der SerialPort Klasse mithilfe des angegebenen IContainer Objekts.

SerialPort(String)

Initialisiert eine neue Instanz der SerialPort Klasse mithilfe des angegebenen Portnamens.

SerialPort(String, Int32)

Initialisiert eine neue Instanz der SerialPort Klasse mithilfe des angegebenen Portnamens und der Baudrate.

SerialPort(String, Int32, Parity)

Initialisiert eine neue Instanz der SerialPort Klasse mithilfe des angegebenen Portnamens, der Baudrate und des Paritätsbits.

SerialPort(String, Int32, Parity, Int32)

Initialisiert eine neue Instanz der SerialPort Klasse mithilfe des angegebenen Portnamens, der Baudrate, des Paritätsbits und der Datenbits.

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

Initialisiert eine neue Instanz der SerialPort Klasse mithilfe des angegebenen Portnamens, der Baudrate, des Paritätsbits, der Datenbits und des Stoppbits.

SerialPort()

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

Initialisiert eine neue Instanz der SerialPort-Klasse.

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

Beispiele

Im folgenden Codebeispiel wird die Verwendung der SerialPort Klasse veranschaulicht, um zwei Benutzern das Chatten von zwei separaten Computern zu ermöglichen, die über ein NULL-Modemkabel 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 = 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 werden. Die Eigenschaft ist standardmäßig DataBits auf 8 festgelegt, die Parity Eigenschaft ist standardmäßig auf den None Enumerationswert festgelegt, die StopBits Eigenschaft ist standardmäßig 1 und ein Standardportname von COM1.

Gilt für:

SerialPort(IContainer)

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

Initialisiert eine neue Instanz der SerialPort Klasse mithilfe des angegebenen IContainer Objekts.

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 Port konnte nicht gefunden oder geöffnet werden.

Hinweise

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

Gilt für:

SerialPort(String)

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

Initialisiert eine neue Instanz der SerialPort Klasse mithilfe des angegebenen Portnamens.

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 Port (z. B. COM1).

Ausnahmen

Der angegebene Port konnte nicht gefunden oder geöffnet werden.

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue Instanz 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
Quelle:
SerialPort.cs

Initialisiert eine neue Instanz der SerialPort Klasse mithilfe des angegebenen Portnamens 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 Port (z. B. COM1).

baudRate
Int32

Der Baudsatz.

Ausnahmen

Der angegebene Port konnte nicht gefunden oder geöffnet werden.

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue Instanz 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
Quelle:
SerialPort.cs

Initialisiert eine neue Instanz der SerialPort Klasse mithilfe des angegebenen Portnamens, der Baudrate und des Paritätsbits.

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 Port (z. B. COM1).

baudRate
Int32

Der Baudsatz.

parity
Parity

Einer der Parity Werte.

Ausnahmen

Der angegebene Port konnte nicht gefunden oder geöffnet werden.

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue Instanz 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
Quelle:
SerialPort.cs

Initialisiert eine neue Instanz der SerialPort Klasse mithilfe des angegebenen Portnamens, der Baudrate, des Paritätsbits und der 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 Port (z. B. COM1).

baudRate
Int32

Der Baudsatz.

parity
Parity

Einer der Parity Werte.

dataBits
Int32

Der Wert der Datenbits.

Ausnahmen

Der angegebene Port konnte nicht gefunden oder geöffnet werden.

Hinweise

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

Gilt für:

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

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

Initialisiert eine neue Instanz der SerialPort Klasse mithilfe des angegebenen Portnamens, der Baudrate, des Paritätsbits, der Datenbits und des 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 Port (z. B. COM1).

baudRate
Int32

Der Baudsatz.

parity
Parity

Einer der Parity Werte.

dataBits
Int32

Der Wert der Datenbits.

stopBits
StopBits

Einer der StopBits Werte.

Ausnahmen

Der angegebene Port konnte nicht gefunden oder geöffnet werden.

Hinweise

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

Gilt für: