SerialPort.BaseStream Eigenschaft

Definition

Namespace:

System.IO.Ports

Assembly:

System.IO.Ports.dll

Paket:

System.IO.Ports v8.0.0

Quelle:

SerialPort.cs

Ruft das zugrunde liegende Stream-Objekt für ein SerialPort-Objekt ab.

public:
 property System::IO::Stream ^ BaseStream { System::IO::Stream ^ get(); };

public System.IO.Stream BaseStream { get; }

member this.BaseStream : System.IO.Stream

Public ReadOnly Property BaseStream As Stream

Eigenschaftswert

Stream

Ein Stream-Objekt.

Ausnahmen

InvalidOperationException

Der Stream ist geschlossen. Dies kann dadurch verursacht werden, dass die Open()-Methode nicht aufgerufen bzw. die Close()-Methode aufgerufen wurde.

NotSupportedException

Der Stream befindet sich in einer .NET Compact Framework-Anwendung, und es wurde eine der folgenden Methoden aufgerufen:

BeginRead(Byte[], Int32, Int32, AsyncCallback, Object)BeginWrite(Byte[], Int32, Int32, AsyncCallback, Object)EndRead(IAsyncResult)EndWrite(IAsyncResult)

.NET Compact Framework unterstützt das asynchrone Modell mit Basisstreams nicht.

Hinweise

Verwenden Sie diese Eigenschaft für explizite asynchrone E/A-Vorgänge oder um das SerialPort Objekt an eine Stream Wrapperklasse wie StreamWriterzu übergeben.

Die Eigenschaft eines BaseStream offenen seriellen Ports gibt ein Objekt zurück, das von der abstrakten Stream Klasse abgeleitet ist, und implementiert Lese- und Schreibmethoden mithilfe der von der Stream Klasse geerbten Prototypen: BeginRead, , BeginWrite, Read, ReadByte, Writeund WriteByte. Diese Methoden können nützlich sein, wenn eine umschlossene serielle Ressource an eine Stream Wrapperklasse übergeben wird.

Aufgrund der Unzugänglichkeit des umschlossenen Dateihandles werden die Length Eigenschaften und Position nicht unterstützt, und die Seek Methoden und SetLength werden nicht unterstützt.