SerialPort Konstruktoren

Referenz

Definition

Namespace:: System.IO.Ports

Assembly:: System.IO.Ports.dll

Assembly:: System.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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()

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, damit zwei Benutzer von zwei separaten Computern chatten können, 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 werden. Die Eigenschaft ist beispielsweise DataBits standardmäßig auf 8 festgelegt, die Parity Eigenschaft ist standardmäßig auf den None Enumerationswert festgelegt, die StopBits Eigenschaft ist standardmäßig auf 1 festgelegt, und ein Standardportname von COM1.

Gilt für

SerialPort(IContainer)

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

IOException

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

Hinweise

Gilt für

SerialPort(String)

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

IOException

Der angegebene Anschluss wurde nicht gefunden oder konnte nicht 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)

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

IOException

Der angegebene Anschluss wurde nicht gefunden oder konnte nicht 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)

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

IOException

Der angegebene Anschluss wurde nicht gefunden oder konnte nicht 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)

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

IOException

Der angegebene Anschluss wurde nicht gefunden oder konnte nicht 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)

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

IOException

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

Hinweise

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

Gilt für

SerialPort Konstruktoren

Definition

Überlädt

SerialPort()

Beispiele

Hinweise

Gilt für

SerialPort(IContainer)

Parameter

Ausnahmen

Hinweise

Gilt für

SerialPort(String)

Parameter

Ausnahmen

Hinweise

Gilt für

SerialPort(String, Int32)

Parameter

Ausnahmen

Hinweise

Gilt für

SerialPort(String, Int32, Parity)

Parameter

Ausnahmen

Hinweise

Gilt für

SerialPort(String, Int32, Parity, Int32)

Parameter

Ausnahmen

Hinweise

Gilt für

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

Parameter

Ausnahmen

Hinweise

Gilt für

Zusätzliche Ressourcen