DataWriter Klasse
Definition
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.
Schreibt Daten in einen Ausgabedatenstrom.
public ref class DataWriter sealed : IClosable, IDataWriter/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Storage.Streams.IDataWriterFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DataWriter final : IClosable, IDataWriter/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.Storage.Streams.IDataWriterFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class DataWriter final : IClosable, IDataWriter[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Storage.Streams.IDataWriterFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DataWriter : System.IDisposable, IDataWriter[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Storage.Streams.IDataWriterFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class DataWriter : System.IDisposable, IDataWriterfunction DataWriter(outputStream)Public NotInheritable Class DataWriter
Implements IDataWriter, IDisposable- Vererbung
- Attribute
- Implementiert
Windows-Anforderungen
| Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
Beispiele
Weitere Informationen finden Sie im Codebeispiel im Thema DataReader .
Hinweise
Instanzen von DataWriter-Objekten unterstützen keine gleichzeitigen Schreibvorgänge. Wenn eine Anwendung gleichzeitig einen Datenstrom aus einem DataWriter-instance, der in den Aufruf des Objekts geschrieben wird, schreibt oder trennt, schlägt der Fehler HRESULT_FROM_WIN32(ERROR_INVALID_OPERATION) fehl.
Konstruktoren
| DataWriter() |
Erstellt und initialisiert eine neue instance des Datenschreibers. |
| DataWriter(IOutputStream) |
Erstellt und initialisiert eine neue instance des Datenschreibers in einem Ausgabestream. |
Eigenschaften
| ByteOrder |
Ruft die Bytereihenfolge der Daten im Ausgabestream ab oder legt diese fest. |
| UnicodeEncoding |
Ruft die Unicode-Zeichencodierung für den Ausgabestream ab oder legt diese fest. |
| UnstoredBufferLength |
Ruft die Größe des Puffers ab, der nicht verwendet wurde. |
Methoden
| Close() |
Schließt den aktuellen Stream und gibt Systemressourcen frei. |
| DetachBuffer() |
Trennt den Puffer, der dem Datenschreiber zugeordnet ist. |
| DetachStream() |
Trennt den Stream, der dem Datenschreiber zugeordnet ist. |
| Dispose() |
Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen. |
| FlushAsync() |
Leert Daten asynchron. |
| MeasureString(String) |
Ruft die Größe einer Zeichenfolge ab. |
| StoreAsync() |
Committ Daten im Puffer an den Ausgabedatenstrom. Diese Methode sollte nur aufgerufen werden, wenn der DataWriter in einen Stream schreibt. Es tritt ein Fehler auf, wenn der zugrunde liegende Speicher ein Puffer ist. |
| WriteBoolean(Boolean) |
Schreibt einen booleschen Wert in den Ausgabestream. |
| WriteBuffer(IBuffer) |
Schreibt den Inhalt des angegebenen Puffers in den Ausgabestream. |
| WriteBuffer(IBuffer, UInt32, UInt32) |
Schreibt die angegebenen Bytes aus einem Puffer in den Ausgabestream. |
| WriteByte(Byte) |
Schreibt einen Bytewert in den Ausgabedatenstrom. |
| WriteBytes(Byte[]) |
Schreibt ein Array von Bytewerten in den Ausgabedatenstrom. |
| WriteDateTime(DateTime) |
Schreibt einen Datums- und Uhrzeitwert in den Ausgabedatenstrom. |
| WriteDouble(Double) |
Schreibt einen Gleitkommawert in den Ausgabestream. |
| WriteGuid(Guid) |
Schreibt einen GUID-Wert in den Ausgabestream. |
| WriteInt16(Int16) |
Schreibt einen ganzzahligen 16-Bit-Wert in den Ausgabestream. |
| WriteInt32(Int32) |
Schreibt einen ganzzahligen 32-Bit-Wert in den Ausgabestream. |
| WriteInt64(Int64) |
Schreibt einen ganzzahligen 64-Bit-Wert in den Ausgabestream. |
| WriteSingle(Single) |
Schreibt einen Gleitkommawert in den Ausgabestream. |
| WriteString(String) |
Schreibt einen Zeichenfolgenwert in den Ausgabedatenstrom. |
| WriteTimeSpan(TimeSpan) |
Schreibt einen Zeitintervallwert in den Ausgabedatenstrom. |
| WriteUInt16(UInt16) |
Schreibt einen 16-Bit-Ganzzahlwert ohne Vorzeichen in den Ausgabedatenstrom. |
| WriteUInt32(UInt32) |
Schreibt einen 32-Bit-Ganzzahlwert ohne Vorzeichen in den Ausgabedatenstrom. |
| WriteUInt64(UInt64) |
Schreibt einen 64-Bit-Ganzzahlwert ohne Vorzeichen in den Ausgabedatenstrom. |