BinaryWriter Klasse
Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

BinaryWriter-Klasse

 

Schreibt primitive Typen binär in einen Datenstrom und unterstützt das Schreiben von Zeichenfolgen in einer bestimmten Codierung.

Namespace:   System.IO
Assembly:  mscorlib (in mscorlib.dll)

System.Object
  System.IO.BinaryWriter

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class BinaryWriter : IDisposable

NameBeschreibung
System_CAPS_protmethodBinaryWriter()

Initialisiert eine neue Instanz der BinaryWriter -Klasse, die in einen Stream schreibt.

System_CAPS_pubmethodBinaryWriter(Stream)

Initialisiert eine neue Instanz der auf dem bereitgestellten Stream basierenden BinaryWriter-Klasse mit einer spezifischen Stream- und Zeichencodierung unter Verwendung von UTF-8.

System_CAPS_pubmethodBinaryWriter(Stream, Encoding)

Initialisiert eine neue Instanz der auf dem bereitgestellten Stream basierenden BinaryWriter-Klasse mit einer spezifischen Stream- und Zeichencodierung.

System_CAPS_pubmethodBinaryWriter(Stream, Encoding, Boolean)

Initialisiert eine neue Instanz der BinaryWriter-Klasse auf Grundlage des angegebenen Streams und der Zeichencodierung und lässt den Stream optional geöffnet.

NameBeschreibung
System_CAPS_pubpropertyBaseStream

Ruft den zugrunde liegenden Stream von der BinaryWriter.

NameBeschreibung
System_CAPS_pubmethodClose()

Schließt das aktuelle BinaryWriter und den zugrunde liegenden Stream.

System_CAPS_pubmethodDispose()

Gibt alle von der aktuellen Instanz der BinaryWriter-Klasse verwendeten Ressourcen frei.

System_CAPS_protmethodDispose(Boolean)

Gibt die von BinaryWriter verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.

System_CAPS_pubmethodEquals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.(Geerbt von Object.)

System_CAPS_protmethodFinalize()

Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Geerbt von Object.)

System_CAPS_pubmethodFlush()

Löscht sämtliche Puffer für den aktuellen Writer und veranlasst die Ausgabe aller gepufferten Daten an das zugrunde liegende Gerät.

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von Object.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von Object.)

System_CAPS_protmethodMemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.(Geerbt von Object.)

System_CAPS_pubmethodSeek(Int32, SeekOrigin)

Legt die Position im aktuellen Stream fest.

System_CAPS_pubmethodToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.(Geerbt von Object.)

System_CAPS_pubmethodWrite(Boolean)

Schreibt einen 1-Byte Boolean Wert, der den aktuellen Stream, wobei 0 darstellt false und 1 true.

System_CAPS_pubmethodWrite(Byte)

Schreibt ein Byte ohne Vorzeichen in den aktuellen Stream und erhöht die Position im Stream um 1 Byte.

System_CAPS_pubmethodWrite(Byte[])

Schreibt ein Bytearray in den zugrunde liegenden Stream.

System_CAPS_pubmethodWrite(Byte[], Int32, Int32)

Schreibt einen Bereich eines Bytearrays in den aktuellen Stream.

System_CAPS_pubmethodWrite(Char)

Schreibt ein Unicode-Zeichen in den aktuellen Stream und erhöht die aktuelle Position im Stream in Abhängigkeit von der Encoding verwendet und der Zeichen in den Stream geschrieben werden.

System_CAPS_pubmethodWrite(Char[])

Schreibt ein Zeichenarray in den aktuellen Stream und erhöht die aktuelle Position im Stream in Abhängigkeit von der Encoding verwendet und der Zeichen in den Stream geschrieben werden.

System_CAPS_pubmethodWrite(Char[], Int32, Int32)

Schreibt einen Bereich eines Arrays von Zeichen in den aktuellen Stream und erhöht die aktuelle Position im Stream in Abhängigkeit von der Encoding verwendet, und vielleicht der Zeichen in den Stream geschrieben werden.

System_CAPS_pubmethodWrite(Decimal)

Schreibt einen Dezimalwert in den aktuellen Stream und erhöht die Position im Stream um 16 Bytes.

System_CAPS_pubmethodWrite(Double)

Schreibt eine 8-Byte-Gleitkommawert in den aktuellen Stream und erhöht die Position im Stream um 8 Bytes.

System_CAPS_pubmethodWrite(Int16)

Schreibt eine 2-Byte-Ganzzahl mit Vorzeichen in den aktuellen Stream und erhöht die Position im Stream um 2 Bytes.

System_CAPS_pubmethodWrite(Int32)

Schreibt eine 4-Byte-Ganzzahl mit Vorzeichen in den aktuellen Stream und erhöht die Position im Stream um 4 Bytes.

System_CAPS_pubmethodWrite(Int64)

Schreibt eine 8-Byte-Ganzzahl mit Vorzeichen in den aktuellen Stream und erhöht die Position im Stream um 8 Bytes.

System_CAPS_pubmethodWrite(SByte)

Schreibt ein Byte mit Vorzeichen in den aktuellen Stream und erhöht die Position im Stream um 1 Byte.

System_CAPS_pubmethodWrite(Single)

Schreibt einen 4-Byte-Gleitkommawert in den aktuellen Stream und erhöht die Position im Stream um 4 Bytes.

System_CAPS_pubmethodWrite(String)

Schreibt eine Zeichenfolge mit Längenpräfix in diesem Stream in der aktuellen Codierung von der BinaryWriter, und erhöht die aktuelle Position des Streams gemäß der verwendeten Codierung und der Zeichen in den Stream geschrieben werden.

System_CAPS_pubmethodWrite(UInt16)

Schreibt eine 2-Byte-Ganzzahl ohne Vorzeichen in den aktuellen Stream und erhöht die Position im Stream um 2 Bytes.

System_CAPS_pubmethodWrite(UInt32)

Schreibt eine 4-Byte-Ganzzahl ohne Vorzeichen in den aktuellen Stream und erhöht die Position im Stream um 4 Bytes.

System_CAPS_pubmethodWrite(UInt64)

Schreibt eine 8-Byte-Ganzzahl ohne Vorzeichen in den aktuellen Stream und erhöht die Position im Stream um 8 Bytes.

System_CAPS_protmethodWrite7BitEncodedInt(Int32)

Schreibt eine 32-Bit-Ganzzahl in komprimiertem Format.

NameBeschreibung
System_CAPS_pubfieldSystem_CAPS_staticNull

Gibt eine BinaryWriter ohne Sicherungsspeicher.

System_CAPS_protfieldOutStream

Enthält den zugrunde liegenden Stream.

Die BinaryWriter -Klasse enthält Methoden, die primitive Datentypen in einen Stream schreiben vereinfachen. Beispielsweise können Sie die Write Methode, um einen booleschen Wert in den Stream als ein-Byte-Wert zu schreiben. Die Klasse enthält die Write-Methoden, die unterschiedliche Datentypen unterstützen.

Beim Erstellen einer neuen Instanz von der BinaryWriter -Klasse, Sie geben den Stream zu schreiben, und geben Sie optional den Typ der Codierung und angibt, ob den Stream bleiben öffnen nach dem Verwerfen der BinaryWriter Objekt. Wenn Sie einen Typ der Codieren nicht angeben, wird UTF-8 verwendet.

System_CAPS_importantWichtig

Dieser Typ implementiert die IDisposable Schnittstelle. Wenn Sie mit dem Datentyp haben, sollten Sie es entweder direkt oder indirekt freigeben. Damit des Typs direkt freigegeben werden, rufen Sie seine Dispose -Methode in eine try/catch Block. Verwenden, um es indirekt freigegeben werden, z. B. ein Sprachkonstrukt using (in c#) oder Using (in Visual Basic). Weitere Informationen finden Sie im Abschnitt "Verwenden eines Objekts, die implementiert IDisposable" in der IDisposable Thema zur Schnittstelle.

Eine abgeleitete Klasse kann die Methoden dieser Klasse, geben Sie eindeutige zeichencodierungen überschreiben.

Im folgenden Codebeispiel wird veranschaulicht, wie zum Speichern und Abrufen von Anwendungseinstellungen in einer Datei.

using System;
using System.IO;

class ConsoleApplication
{
    const string fileName = "AppSettings.dat";

    static void Main()
    {
        WriteDefaultValues();
        DisplayValues();
    }

    public static void WriteDefaultValues()
    {
        using (BinaryWriter writer = new BinaryWriter(File.Open(fileName, FileMode.Create)))
        {
            writer.Write(1.250F);
            writer.Write(@"c:\Temp");
            writer.Write(10);
            writer.Write(true);
        }
    }

    public static void DisplayValues()
    {
        float aspectRatio;
        string tempDirectory;
        int autoSaveTime;
        bool showStatusBar;

        if (File.Exists(fileName))
        {
            using (BinaryReader reader = new BinaryReader(File.Open(fileName, FileMode.Open)))
            {
                aspectRatio = reader.ReadSingle();
                tempDirectory = reader.ReadString();
                autoSaveTime = reader.ReadInt32();
                showStatusBar = reader.ReadBoolean();
            }

            Console.WriteLine("Aspect ratio set to: " + aspectRatio);
            Console.WriteLine("Temp directory is: " + tempDirectory);
            Console.WriteLine("Auto save time set to: " + autoSaveTime);
            Console.WriteLine("Show status bar: " + showStatusBar);
        }
    }
}

Universal Windows Platform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portable Class Library
Unterstützt in: portable .NET platforms
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1

Öffentliche statische (in Visual Basic freigegebene) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Zurück zum Anfang
Anzeigen:
© 2016 Microsoft