My.Computer.Ports.SerialPortNames-Eigenschaft

Aktualisiert: November 2007

Ruft eine Auflistung der Namen der seriellen Anschlüsse am Computer ab.

' Usage
Dim value As System.Collections.Generic.ReadOnlyCollection`1(Of String) = My.Computer.Ports.SerialPortNames
' Declaration
Public ReadOnly Property SerialPortNames As System.Collections.Generic.ReadOnlyCollection`1(Of String)

Rückgabewert

Eine Auflistung der Namen der seriellen Anschlüsse am Computer.

Hinweise

Die My.Computer.Ports.SerialPortNames-Eigenschaft ruft eine Auflistung der Namen der seriellen Anschlüsse am Computer ab.

Hinweis:
Die von My.Computer.Ports.SerialPortNames zurückgegebenen Anschlussnamen sind möglicherweise falsch, wenn die Ausführung unter Windows 98 erfolgt. Um Anwendungsfehler zu verhindern, verwenden Sie Ausnahmebehandlung, z. B. die Try...Catch...Finally-Anweisung oder die Using-Anweisung, wenn Sie die Anschlüsse unter Verwendung von Anschlussnamen öffnen.

Aufgaben

Die folgende Tabelle enthält ein Beispiel für eine Aufgabe mit der My.Computer.Ports.SerialPortNames-Eigenschaft.

Beispiel

In diesem Beispiel werden alle Zeichenfolgen durchlaufen, die von der My.Computer.Ports.SerialPortNames-Eigenschaft zurückgegeben werden. Diese Zeichenfolgen sind die Namen der verfügbaren seriellen Anschlüsse am Computer.

Normalerweise wählt der Benutzer aus der Liste der verfügbaren Anschlüsse den seriellen Anschluss aus, den die Anwendung verwenden soll. In diesem Beispiel werden die Namen der seriellen Anschlüsse in einem ListBox-Steuerelement gespeichert. Weitere Informationen finden Sie unter ListBox-Steuerelement (Windows Forms).

Sub GetSerialPortNames()
    ' Show all available COM ports.
    For Each sp As String In My.Computer.Ports.SerialPortNames
        ListBox1.Items.Add(sp)
    Next
End Sub

Für dieses Beispiel ist Folgendes erforderlich:

• Ein Verweis auf den System-Namespace.

• Das Formular muss über das ListBox-Steuerelement ListBox1 verfügen.

Weitere Informationen finden Sie unter Gewusst wie: Anzeigen von verfügbaren seriellen Anschlüssen in Visual Basic.

Anforderungen

Namespace:Microsoft.VisualBasic.Devices

Klasse: Ports

**Assembly:**Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Berechtigungen

Es sind keine Berechtigungen erforderlich.

Siehe auch

Aufgaben

Gewusst wie: Anzeigen von verfügbaren seriellen Anschlüssen in Visual Basic

Referenz

My.Computer.Ports-Objekt

My.Computer.Ports.OpenSerialPort-Methode

ReadOnlyCollection<T>

Ports.SerialPortNames

Try...Catch...Finally-Anweisung (Visual Basic)

Using-Anweisung (Visual Basic)