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

BinaryReader-Klasse

 

Veröffentlicht: Oktober 2016

Liest primitive Datentypen als Binärwerte in einer spezifischen Codierung.

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

System.Object
  System.IO.BinaryReader

[ComVisibleAttribute(true)]
public class BinaryReader : IDisposable

NameBeschreibung
System_CAPS_pubmethodBinaryReader(Stream)

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

System_CAPS_pubmethodBinaryReader(Stream, Encoding)

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

System_CAPS_pubmethodBinaryReader(Stream, Encoding, Boolean)

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

NameBeschreibung
System_CAPS_pubpropertyBaseStream

Gewährt Zugriff auf den zugrunde liegenden Stream von BinaryReader.

NameBeschreibung
System_CAPS_pubmethodClose()

Schließt den aktuellen Reader und den zugrunde liegenden Stream.

System_CAPS_pubmethodDispose()

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

System_CAPS_protmethodDispose(Boolean)

Gibt die von der BinaryReader-Klasse verwendeten nicht verwalteten Ressourcen frei und gibt (optional) auch die verwalteten Ressourcen frei.

System_CAPS_pubmethodEquals(Object)

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

System_CAPS_protmethodFillBuffer(Int32)

Füllt den internen Puffer mit der angegebenen Anzahl von Bytes, die aus dem Stream gelesen wurden.

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

Gibt das nächste verfügbare Zeichen zurück, ohne die Byte- oder Zeichenposition zu erhöhen.

System_CAPS_pubmethodRead()

Liest Zeichen aus dem zugrunde liegenden Stream und erhöht die aktuelle Position im Stream in Abhängigkeit von der verwendeten Encoding und dem aus dem Stream gelesenen Zeichen.

System_CAPS_pubmethodRead(Byte[], Int32, Int32)

Liest die angegebene Anzahl von Bytes beginnend bei einem angegebenen Punkt im Bytearray aus dem Stream.

System_CAPS_pubmethodRead(Char[], Int32, Int32)

Liest die angegebene Anzahl von Zeichen beginnend bei einem angegebenen Punkt im Zeichenarray aus dem Stream.

System_CAPS_protmethodRead7BitEncodedInt()

Liest eine 32-Bit-Ganzzahl in komprimiertem Format.

System_CAPS_pubmethodReadBoolean()

Liest einen Boolean-Wert aus dem aktuellen Stream und erhöht die aktuelle Position im Stream um 1 Byte.

System_CAPS_pubmethodReadByte()

Liest das nächste Byte aus dem aktuellen Stream und erhöht die aktuelle Position im Stream um 1 Byte.

System_CAPS_pubmethodReadBytes(Int32)

Liest die angegebene Anzahl von Bytes aus dem aktuellen Stream in ein Bytearray und erhöht die aktuelle Position um diese Anzahl von Bytes.

System_CAPS_pubmethodReadChar()

Liest das nächste Zeichen aus dem aktuellen Stream und erhöht die aktuelle Position im Stream in Abhängigkeit von der verwendeten Encoding und dem aus dem Stream gelesenen Zeichen.

System_CAPS_pubmethodReadChars(Int32)

Liest die angegebene Anzahl von Zeichen aus dem aktuellen Stream, gibt die Daten in einem Zeichenarray zurück und erhöht die aktuelle Position in Abhängigkeit von der verwendeten Encoding und dem aus dem Stream gelesenen Zeichen.

System_CAPS_pubmethodReadDecimal()

Liest einen Dezimalwert aus dem aktuellen Stream und erhöht die aktuelle Position im Stream um 16 Bytes.

System_CAPS_pubmethodReadDouble()

Liest einen 8-Byte-Gleitkommawert aus dem aktuellen Stream und erhöht die aktuelle Position im Stream um 8 Bytes.

System_CAPS_pubmethodReadInt16()

Liest eine 2-Byte-Ganzzahl mit Vorzeichen aus dem aktuellen Stream und erhöht die aktuelle Position im Stream um 2 Bytes.

System_CAPS_pubmethodReadInt32()

Liest eine 4-Byte-Ganzzahl mit Vorzeichen aus dem aktuellen Stream und erhöht die aktuelle Position im Stream um 4 Bytes.

System_CAPS_pubmethodReadInt64()

Liest eine 8-Byte-Ganzzahl mit Vorzeichen aus dem aktuellen Stream und erhöht die aktuelle Position im Stream um 8 Bytes.

System_CAPS_pubmethodReadSByte()

Liest ein Byte mit Vorzeichen aus dem aktuellen Stream und erhöht die aktuelle Position im Stream um ein Byte.

System_CAPS_pubmethodReadSingle()

Liest einen 4-Byte-Gleitkommawert aus dem aktuellen Stream und erhöht die aktuelle Position im Stream um 4 Bytes.

System_CAPS_pubmethodReadString()

Liest eine Zeichenfolge aus dem aktuellen Stream. Die Zeichenfolge weist ein Präfix mit der Länge auf, die als Ganzzahl mit jeweils 7 Bits codiert ist.

System_CAPS_pubmethodReadUInt16()

Liest eine 2-Byte-Ganzzahl ohne Vorzeichen mithilfe einer Little-Endian-Codierung aus dem aktuellen Stream und erhöht die aktuelle Position im Stream um 2 Bytes.

System_CAPS_pubmethodReadUInt32()

Liest eine 4-Byte-Ganzzahl ohne Vorzeichen aus dem aktuellen Stream und erhöht die Position des Streams um 4 Bytes.

System_CAPS_pubmethodReadUInt64()

Liest eine 8-Byte-Ganzzahl ohne Vorzeichen aus dem aktuellen Stream und erhöht die Position des Streams um 8 Bytes.

System_CAPS_pubmethodToString()

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

Die BinaryReader -Klasse enthält Methoden, die primitive Datentypen aus einem Stream lesen vereinfachen. Beispielsweise können Sie die ReadBoolean -Methode zum Lesen von des nächsten Bytes als ein boolescher Wert, und setzen die aktuelle Position im Stream um ein Byte. Die Klasse enthält die read-Methoden, die unterschiedliche Datentypen unterstützen.

Beim Erstellen einer neuen Instanz von der BinaryReader -Klasse, Sie geben den Stream gelesen, und geben Sie optional den Typ der Codierung und angibt, ob den Stream bleiben öffnen nach dem Verwerfen der BinaryReader 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.

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);
        }
    }
}

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1

Alle öffentlichen statischen Member ( Shared in Visual Basic) dieses Typs sind threadsicher. Die Threadsicherheit für Instanzmember ist nicht garantiert.

Zurück zum Anfang
Anzeigen: