StreamReader Konstruktoren

Definition

Namespace:: System.IO

Assemblys:: mscorlib.dll, System.IO.dll

Assemblys:: netstandard.dll, System.Runtime.dll

Assembly:: System.IO.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

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.

Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Datenstrom.

Überlädt

Name	Beschreibung
StreamReader(Stream)	Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Datenstrom.
StreamReader(Stream, Encoding, Boolean, Int32, Boolean)	Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Datenstrom basierend auf der angegebenen Zeichencodierung, der Erkennungsoption für Bytereihenfolgezeichen und der Puffergröße und lässt optional den Datenstrom geöffnet.
StreamReader(String, Encoding, Boolean, FileStreamOptions)	Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Dateipfad mit der angegebenen Zeichencodierung, der Erkennungsoption für Bytereihenfolgezeichen und der Konfiguration mit dem angegebenen FileStreamOptions Objekt.
StreamReader(String, Encoding, Boolean, Int32)	Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Dateinamen mit der angegebenen Zeichencodierung, der Erkennungsoption für Bytereihenfolgezeichen und der Puffergröße.
StreamReader(Stream, Encoding, Boolean, Int32)	Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Datenstrom mit der angegebenen Zeichencodierung, der Erkennungsoption für Bytereihenfolgezeichen und der Puffergröße.
StreamReader(Stream, Encoding, Boolean)	Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Datenstrom mit der angegebenen Zeichencodierung und der Erkennungsoption für Bytereihenfolgenzeichen.
StreamReader(String, Encoding, Boolean)	Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Dateinamen mit der angegebenen Zeichencodierung und der Erkennungsoption für Bytereihenfolgenzeichen.
StreamReader(String, FileStreamOptions)	Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Dateipfad, wobei die Standardcodierung verwendet wird, wodurch die Erkennung von Bytereihenfolgemarkierungen am Anfang der Datei aktiviert und mit dem angegebenen FileStreamOptions Objekt konfiguriert wird.
StreamReader(String, Boolean)	Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Dateinamen mit der angegebenen Bytereihenfolgenmarkerkennungsoption.
StreamReader(Stream, Encoding)	Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Datenstrom mit der angegebenen Zeichencodierung.
StreamReader(Stream, Boolean)	Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Datenstrom mit der angegebenen Bytereihenfolgenmarkerkennungsoption.
StreamReader(String)	Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Dateinamen.
StreamReader(String, Encoding)	Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Dateinamen mit der angegebenen Zeichencodierung.

StreamReader(Stream)

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Datenstrom.

public:
 StreamReader(System::IO::Stream ^ stream);

public StreamReader(System.IO.Stream stream);

new System.IO.StreamReader : System.IO.Stream -> System.IO.StreamReader

Public Sub New (stream As Stream)

Parameter

stream: Stream

Der zu lesende Datenstrom.

Ausnahmen

ArgumentException

stream das Lesen wird nicht unterstützt.

ArgumentNullException

stream ist null.

Beispiele

Im folgenden Codebeispiel wird dieser StreamReader Konstruktor veranschaulicht.

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        try
        {
            if (File.Exists(path))
            {
                File.Delete(path);
            }

            using (StreamWriter sw = new StreamWriter(new FileStream(path, FileMode.CreateNew)))
            {
                sw.WriteLine("This");
                sw.WriteLine("is some text");
                sw.WriteLine("to test");
                sw.WriteLine("reading");
            }

            using (StreamReader sr = new StreamReader(new FileStream(path, FileMode.Open)))
            {
                while (sr.Peek() >= 0)
                {
                    Console.WriteLine(sr.ReadLine());
                }
            }
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

Imports System.IO

Public Class Test

    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"

        Try
            If File.Exists(path) Then
                File.Delete(path)
            End If

            Dim sw As StreamWriter = New StreamWriter(path)
            sw.WriteLine("This")
            sw.WriteLine("is some text")
            sw.WriteLine("to test")
            sw.WriteLine("Reading")
            sw.Close()

            Dim fs As FileStream = New FileStream(path, FileMode.Open)

            Dim sr As StreamReader = New StreamReader(fs)

            Do While sr.Peek() >= 0
                Console.WriteLine(sr.ReadLine())
            Loop
            sr.Close()
            fs.Close()
        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

Hinweise

Dieser Konstruktor initialisiert die Codierung in UTF8Encoding, die BaseStream Eigenschaft mit dem stream Parameter und die interne Puffergröße auf 1024 Byte.

Das StreamReader Objekt ruft Dispose() das bereitgestellte Stream Objekt auf, wenn StreamReader.Dispose es aufgerufen wird.

Vorsicht

Wenn Sie eine Reihe von Zeichen mit einer bestimmten kulturellen Einstellung kompilieren und dieselben Zeichen mit einer anderen kulturellen Einstellung abrufen, können die Zeichen möglicherweise nicht interpretiert werden und eine Ausnahme ausgelöst werden.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

Gilt für:

StreamReader(Stream, Encoding, Boolean, Int32, Boolean)

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Datenstrom basierend auf der angegebenen Zeichencodierung, der Erkennungsoption für Bytereihenfolgezeichen und der Puffergröße und lässt optional den Datenstrom geöffnet.

public:
 StreamReader(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding, bool detectEncodingFromByteOrderMarks, int bufferSize, bool leaveOpen);

public StreamReader(System.IO.Stream stream, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, int bufferSize, bool leaveOpen);

public StreamReader(System.IO.Stream stream, System.Text.Encoding? encoding = default, bool detectEncodingFromByteOrderMarks = true, int bufferSize = -1, bool leaveOpen = false);

new System.IO.StreamReader : System.IO.Stream * System.Text.Encoding * bool * int * bool -> System.IO.StreamReader

Public Sub New (stream As Stream, encoding As Encoding, detectEncodingFromByteOrderMarks As Boolean, bufferSize As Integer, leaveOpen As Boolean)

Public Sub New (stream As Stream, Optional encoding As Encoding = Nothing, Optional detectEncodingFromByteOrderMarks As Boolean = true, Optional bufferSize As Integer = -1, Optional leaveOpen As Boolean = false)

Parameter

stream: Stream

Der zu lesende Datenstrom.

encoding: Encoding

Die zu verwendende Zeichencodierung.

detectEncodingFromByteOrderMarks: Boolean

truenach Bytereihenfolgezeichen am Anfang der Datei zu suchen; andernfalls . false

bufferSize: Int32

Die minimale Puffergröße in Byte.

leaveOpen: Boolean

true wenn der Datenstrom geöffnet bleibt, nachdem das StreamReader Objekt verworfen wurde; andernfalls false.

Hinweise

Wenn Sie den leaveOpen Parameter nicht festlegen, wird das StreamReader Objekt beim StreamReader.Dispose Aufrufen des angegebenen Stream Objekts aufgerufen Dispose()true.

Die Puffergröße in Byte wird durch den bufferSize Parameter festgelegt. Wenn bufferSize die zulässige Mindestgröße (128 Byte) kleiner ist, wird die zulässige Mindestgröße verwendet.

Mit diesem Konstruktor können Sie die Codierung beim ersten Lesen des StreamReader Objekts ändern. Wenn der detectEncodingFromByteOrderMarks Parameter lautet true, erkennt der Konstruktor die Codierung, indem er die ersten vier Bytes des Datenstroms betrachtet. Es erkennt automatisch UTF-8, Little-Endian UTF-16, Big-Endian UTF-16, Little-Endian UTF-32 und Big-Endian UTF-32-Text, wenn die Datei mit den entsprechenden Bytereihenfolgenzeichen beginnt. Andernfalls wird die vom Benutzer bereitgestellte Codierung verwendet. Weitere Informationen finden Sie in der Encoding.GetPreamble Methode.

Hinweis

Beim Lesen aus einem StreamDatenstrom ist es effizienter, einen Puffer zu verwenden, der die gleiche Größe wie der interne Puffer des Datenstroms aufweist.

Vorsicht

Wenn Sie eine Reihe von Zeichen mit einer bestimmten kulturellen Einstellung kompilieren und dieselben Zeichen mit einer anderen kulturellen Einstellung abrufen, werden die Zeichen möglicherweise nicht richtig interpretiert und können zu einer Ausnahme führen.

Gilt für:

StreamReader(String, Encoding, Boolean, FileStreamOptions)

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Dateipfad mit der angegebenen Zeichencodierung, der Erkennungsoption für Bytereihenfolgezeichen und der Konfiguration mit dem angegebenen FileStreamOptions Objekt.

public:
 StreamReader(System::String ^ path, System::Text::Encoding ^ encoding, bool detectEncodingFromByteOrderMarks, System::IO::FileStreamOptions ^ options);

public StreamReader(string path, System.Text.Encoding? encoding, bool detectEncodingFromByteOrderMarks, System.IO.FileStreamOptions options);

public StreamReader(string path, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, System.IO.FileStreamOptions options);

new System.IO.StreamReader : string * System.Text.Encoding * bool * System.IO.FileStreamOptions -> System.IO.StreamReader

Public Sub New (path As String, encoding As Encoding, detectEncodingFromByteOrderMarks As Boolean, options As FileStreamOptions)

Parameter

path: String

Der vollständige Dateipfad, der gelesen werden soll.

encoding: Encoding

Die zu verwendende Zeichencodierung.

detectEncodingFromByteOrderMarks: Boolean

Gibt an, ob am Anfang der Datei nach Bytereihenfolgemarkierungen gesucht werden soll.

options: FileStreamOptions

Ein Objekt, das die Konfigurationsoptionen für die zugrunde liegende FileStream.

Ausnahmen

ArgumentException

path ist nicht lesbar.

      -or-

path ist eine leere Zeichenfolge ("").

ArgumentNullException

pathoder encodingoptions ist .null

FileNotFoundException

Die Datei wurde nicht gefunden.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. auf einem nicht zugeordneten Laufwerk.

NotSupportedException

path enthält eine falsche oder ungültige Syntax für Dateinamen, Verzeichnisname oder Volumebezeichnung.

Weitere Informationen

Gilt für:

StreamReader(String, Encoding, Boolean, Int32)

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Dateinamen mit der angegebenen Zeichencodierung, der Erkennungsoption für Bytereihenfolgezeichen und der Puffergröße.

public:
 StreamReader(System::String ^ path, System::Text::Encoding ^ encoding, bool detectEncodingFromByteOrderMarks, int bufferSize);

public StreamReader(string path, System.Text.Encoding? encoding, bool detectEncodingFromByteOrderMarks, int bufferSize);

public StreamReader(string path, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, int bufferSize);

new System.IO.StreamReader : string * System.Text.Encoding * bool * int -> System.IO.StreamReader

Public Sub New (path As String, encoding As Encoding, detectEncodingFromByteOrderMarks As Boolean, bufferSize As Integer)

Parameter

path: String

Der vollständige Dateipfad, der gelesen werden soll.

encoding: Encoding

Die zu verwendende Zeichencodierung.

detectEncodingFromByteOrderMarks: Boolean

Gibt an, ob am Anfang der Datei nach Bytereihenfolgemarkierungen gesucht werden soll.

bufferSize: Int32

Die minimale Puffergröße in Byte.

Ausnahmen

ArgumentException

path ist eine leere Zeichenfolge ("").

ArgumentNullException

path oder encoding ist null.

FileNotFoundException

Die Datei wurde nicht gefunden.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. auf einem nicht zugeordneten Laufwerk.

NotSupportedException

path enthält eine falsche oder ungültige Syntax für Dateinamen, Verzeichnisname oder Volumebezeichnung.

ArgumentOutOfRangeException

bufferSize ist kleiner oder gleich Null, mit Ausnahme von -1, das die Standardpuffergröße angeben darf.

Beispiele

Im folgenden Codebeispiel wird dieser StreamReader Konstruktor veranschaulicht.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Hinweise

Dieser Konstruktor initialisiert die Codierung gemäß der Angabe durch den encoding Parameter.

Mit diesem Konstruktor können Sie die Codierung beim ersten Lesen des StreamReader Objekts ändern. Der detectEncodingFromByteOrderMarks Parameter erkennt die Codierung, indem die ersten vier Bytes des Datenstroms betrachtet werden. Es erkennt automatisch UTF-8, Little-Endian UTF-16, Big-Endian UTF-16, Little-Endian UTF-32 und Big-Endian UTF-32-Text, wenn die Datei mit den entsprechenden Bytereihenfolgenzeichen beginnt. Andernfalls wird die vom Benutzer bereitgestellte Codierung verwendet. Weitere Informationen finden Sie in der Encoding.GetPreamble Methode.

Die Puffergröße in Byte wird durch den bufferSize Parameter festgelegt. Wenn bufferSize die zulässige Mindestgröße (128 Byte) kleiner ist, wird die zulässige Mindestgröße verwendet.

Der path Parameter kann ein Dateiname sein, einschließlich einer Datei auf einer UNC-Freigabe (Universal Naming Convention).

Der path Parameter ist nicht erforderlich, um eine Auf dem Datenträger gespeicherte Datei zu sein. Er kann ein beliebiger Teil eines Systems sein, das den Zugriff mithilfe von Datenströmen unterstützt.

Vorsicht

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

Gilt für:

StreamReader(Stream, Encoding, Boolean, Int32)

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Datenstrom mit der angegebenen Zeichencodierung, der Erkennungsoption für Bytereihenfolgezeichen und der Puffergröße.

public:
 StreamReader(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding, bool detectEncodingFromByteOrderMarks, int bufferSize);

public StreamReader(System.IO.Stream stream, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks, int bufferSize);

public StreamReader(System.IO.Stream stream, System.Text.Encoding? encoding, bool detectEncodingFromByteOrderMarks, int bufferSize);

new System.IO.StreamReader : System.IO.Stream * System.Text.Encoding * bool * int -> System.IO.StreamReader

Public Sub New (stream As Stream, encoding As Encoding, detectEncodingFromByteOrderMarks As Boolean, bufferSize As Integer)

Parameter

stream: Stream

Der zu lesende Datenstrom.

encoding: Encoding

Die zu verwendende Zeichencodierung.

detectEncodingFromByteOrderMarks: Boolean

Gibt an, ob am Anfang der Datei nach Bytereihenfolgemarkierungen gesucht werden soll.

bufferSize: Int32

Die minimale Puffergröße in Byte.

Ausnahmen

ArgumentException

Der Datenstrom unterstützt das Lesen nicht.

ArgumentNullException

stream oder encoding ist null.

ArgumentOutOfRangeException

bufferSize ist kleiner oder gleich Null, mit Ausnahme von -1, das die Standardpuffergröße angeben darf.

Beispiele

Im folgenden Codebeispiel wird dieser StreamReader Konstruktor veranschaulicht.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Hinweise

Die Puffergröße in Byte wird durch den bufferSize Parameter festgelegt. Wenn bufferSize die zulässige Mindestgröße (128 Byte) kleiner ist, wird die zulässige Mindestgröße verwendet.

Das StreamReader Objekt ruft Dispose() das bereitgestellte Stream Objekt auf, wenn StreamReader.Dispose es aufgerufen wird.

Hinweis

Beim Lesen aus einem StreamDatenstrom ist es effizienter, einen Puffer zu verwenden, der die gleiche Größe wie der interne Puffer des Datenstroms aufweist.

Vorsicht

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

Gilt für:

StreamReader(Stream, Encoding, Boolean)

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Datenstrom mit der angegebenen Zeichencodierung und der Erkennungsoption für Bytereihenfolgenzeichen.

public:
 StreamReader(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding, bool detectEncodingFromByteOrderMarks);

public StreamReader(System.IO.Stream stream, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks);

public StreamReader(System.IO.Stream stream, System.Text.Encoding? encoding, bool detectEncodingFromByteOrderMarks);

new System.IO.StreamReader : System.IO.Stream * System.Text.Encoding * bool -> System.IO.StreamReader

Public Sub New (stream As Stream, encoding As Encoding, detectEncodingFromByteOrderMarks As Boolean)

Parameter

stream: Stream

Der zu lesende Datenstrom.

encoding: Encoding

Die zu verwendende Zeichencodierung.

detectEncodingFromByteOrderMarks: Boolean

Gibt an, ob am Anfang der Datei nach Bytereihenfolgemarkierungen gesucht werden soll.

Ausnahmen

ArgumentException

stream das Lesen wird nicht unterstützt.

ArgumentNullException

stream oder encoding ist null.

Beispiele

Im folgenden Codebeispiel wird dieser StreamReader Konstruktor veranschaulicht.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Hinweise

Dieser Konstruktor initialisiert die Codierung gemäß der Angabe durch den encoding Parameter, die BaseStream Eigenschaft mit dem stream Parameter und die interne Puffergröße auf 1024 Byte.

Der detectEncodingFromByteOrderMarks Parameter erkennt die Codierung, indem die ersten vier Bytes des Datenstroms betrachtet werden. Es erkennt automatisch UTF-8, Little-Endian UTF-16, Big-Endian UTF-16, Little-Endian UTF-32 und Big-Endian UTF-32-Text, wenn die Datei mit den entsprechenden Bytereihenfolgenzeichen beginnt. Andernfalls wird die vom Benutzer bereitgestellte Codierung verwendet. Weitere Informationen finden Sie in der Encoding.GetPreamble Methode.

Das StreamReader Objekt ruft Dispose() das bereitgestellte Stream Objekt auf, wenn StreamReader.Dispose es aufgerufen wird.

Vorsicht

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

Gilt für:

StreamReader(String, Encoding, Boolean)

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Dateinamen mit der angegebenen Zeichencodierung und der Erkennungsoption für Bytereihenfolgenzeichen.

public:
 StreamReader(System::String ^ path, System::Text::Encoding ^ encoding, bool detectEncodingFromByteOrderMarks);

public StreamReader(string path, System.Text.Encoding? encoding, bool detectEncodingFromByteOrderMarks);

public StreamReader(string path, System.Text.Encoding encoding, bool detectEncodingFromByteOrderMarks);

new System.IO.StreamReader : string * System.Text.Encoding * bool -> System.IO.StreamReader

Public Sub New (path As String, encoding As Encoding, detectEncodingFromByteOrderMarks As Boolean)

Parameter

path: String

Der vollständige Dateipfad, der gelesen werden soll.

encoding: Encoding

Die zu verwendende Zeichencodierung.

detectEncodingFromByteOrderMarks: Boolean

Gibt an, ob am Anfang der Datei nach Bytereihenfolgemarkierungen gesucht werden soll.

Ausnahmen

ArgumentException

path ist eine leere Zeichenfolge ("").

ArgumentNullException

path oder encoding ist null.

FileNotFoundException

Die Datei wurde nicht gefunden.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. auf einem nicht zugeordneten Laufwerk.

NotSupportedException

path enthält eine falsche oder ungültige Syntax für Dateinamen, Verzeichnisname oder Volumebezeichnung.

Beispiele

Im folgenden Codebeispiel wird dieser StreamReader Konstruktor veranschaulicht.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Hinweise

Dieser Konstruktor initialisiert die Codierung gemäß der Angabe durch den encoding Parameter und die interne Puffergröße auf 1024 Byte.

Der path Parameter kann ein Dateiname sein, einschließlich einer Datei auf einer UNC-Freigabe (Universal Naming Convention).

Vorsicht

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

Gilt für:

StreamReader(String, FileStreamOptions)

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Dateipfad, wobei die Standardcodierung verwendet wird, wodurch die Erkennung von Bytereihenfolgemarkierungen am Anfang der Datei aktiviert und mit dem angegebenen FileStreamOptions Objekt konfiguriert wird.

public:
 StreamReader(System::String ^ path, System::IO::FileStreamOptions ^ options);

public StreamReader(string path, System.IO.FileStreamOptions options);

new System.IO.StreamReader : string * System.IO.FileStreamOptions -> System.IO.StreamReader

Public Sub New (path As String, options As FileStreamOptions)

Parameter

path: String

Der vollständige Dateipfad, der gelesen werden soll.

options: FileStreamOptions

Ein Objekt, das die Konfigurationsoptionen für die zugrunde liegende FileStream.

Ausnahmen

ArgumentException

path ist nicht lesbar.

- oder -

      <code data-dev-comment-type="paramref">path</code> is an empty string ("").

ArgumentNullException

path oder options ist null.

FileNotFoundException

Die Datei wurde nicht gefunden.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. auf einem nicht zugeordneten Laufwerk.

IOException

path enthält eine falsche oder ungültige Syntax für Dateinamen, Verzeichnisname oder Volumebezeichnung.

Weitere Informationen

Gilt für:

StreamReader(String, Boolean)

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Dateinamen mit der angegebenen Bytereihenfolgenmarkerkennungsoption.

public:
 StreamReader(System::String ^ path, bool detectEncodingFromByteOrderMarks);

public StreamReader(string path, bool detectEncodingFromByteOrderMarks);

new System.IO.StreamReader : string * bool -> System.IO.StreamReader

Public Sub New (path As String, detectEncodingFromByteOrderMarks As Boolean)

Parameter

path: String

Der vollständige Dateipfad, der gelesen werden soll.

detectEncodingFromByteOrderMarks: Boolean

Gibt an, ob am Anfang der Datei nach Bytereihenfolgemarkierungen gesucht werden soll.

Ausnahmen

ArgumentException

path ist eine leere Zeichenfolge ("").

ArgumentNullException

path ist null.

FileNotFoundException

Die Datei wurde nicht gefunden.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. auf einem nicht zugeordneten Laufwerk.

IOException

path enthält eine falsche oder ungültige Syntax für Dateinamen, Verzeichnisname oder Volumebezeichnung.

Beispiele

Im folgenden Codebeispiel wird dieser StreamReader Konstruktor veranschaulicht.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Hinweise

Dieser Konstruktor initialisiert die Codierung in UTF8Encoding, die BaseStream Eigenschaft mit dem stream Parameter und die interne Puffergröße auf 1024 Byte.

Der path Parameter kann ein Dateiname sein, einschließlich einer Datei auf einer UNC-Freigabe (Universal Naming Convention).

Der detectEncodingFromByteOrderMarks Parameter erkennt die Codierung, indem die ersten vier Bytes des Datenstroms betrachtet werden. Es erkennt automatisch UTF-8, Little-Endian UTF-16, Big-Endian UTF-16, Little-Endian UTF-32 und Big-Endian UTF-32-Text, wenn die Datei mit den entsprechenden Bytereihenfolgenzeichen beginnt. Andernfalls wird dies UTF8Encoding verwendet. Weitere Informationen finden Sie in der Encoding.GetPreamble Methode.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

Gilt für:

StreamReader(Stream, Encoding)

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Datenstrom mit der angegebenen Zeichencodierung.

public:
 StreamReader(System::IO::Stream ^ stream, System::Text::Encoding ^ encoding);

public StreamReader(System.IO.Stream stream, System.Text.Encoding encoding);

public StreamReader(System.IO.Stream stream, System.Text.Encoding? encoding);

new System.IO.StreamReader : System.IO.Stream * System.Text.Encoding -> System.IO.StreamReader

Public Sub New (stream As Stream, encoding As Encoding)

Parameter

stream: Stream

Der zu lesende Datenstrom.

encoding: Encoding

Die zu verwendende Zeichencodierung.

Ausnahmen

ArgumentException

stream das Lesen wird nicht unterstützt.

ArgumentNullException

stream oder encoding ist null.

Beispiele

Im folgenden Codebeispiel wird dieser StreamReader Konstruktor veranschaulicht.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Hinweise

Die Zeichencodierung wird durch den encoding Parameter festgelegt, und die Puffergröße wird auf 1024 Byte festgelegt. Das StreamReader Objekt versucht, die Codierung zu erkennen, indem die ersten vier Bytes des Datenstroms betrachtet werden. Es erkennt automatisch UTF-8, Little-Endian UTF-16, Big-Endian UTF-16, Little-Endian UTF-32 und Big-Endian UTF-32-Text, wenn die Datei mit den entsprechenden Bytereihenfolgenzeichen beginnt. Andernfalls wird die vom Benutzer bereitgestellte Codierung verwendet. Weitere Informationen finden Sie in der Encoding.GetPreamble Methode.

Das StreamReader Objekt ruft Dispose() das bereitgestellte Stream Objekt auf, wenn StreamReader.Dispose es aufgerufen wird.

Vorsicht

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

Gilt für:

StreamReader(Stream, Boolean)

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Datenstrom mit der angegebenen Bytereihenfolgenmarkerkennungsoption.

public:
 StreamReader(System::IO::Stream ^ stream, bool detectEncodingFromByteOrderMarks);

public StreamReader(System.IO.Stream stream, bool detectEncodingFromByteOrderMarks);

new System.IO.StreamReader : System.IO.Stream * bool -> System.IO.StreamReader

Public Sub New (stream As Stream, detectEncodingFromByteOrderMarks As Boolean)

Parameter

stream: Stream

Der zu lesende Datenstrom.

detectEncodingFromByteOrderMarks: Boolean

Gibt an, ob am Anfang der Datei nach Bytereihenfolgemarkierungen gesucht werden soll.

Ausnahmen

ArgumentException

stream das Lesen wird nicht unterstützt.

ArgumentNullException

stream ist null.

Beispiele

Im folgenden Codebeispiel wird dieser StreamReader Konstruktor veranschaulicht.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Hinweise

Dieser Konstruktor initialisiert die Codierung in UTF8Encoding, die BaseStream Eigenschaft mit dem stream Parameter und die interne Puffergröße auf 1024 Byte.

Der detectEncodingFromByteOrderMarks Parameter erkennt die Codierung, indem die ersten vier Bytes des Datenstroms betrachtet werden. Es erkennt automatisch UTF-8, Little-Endian UTF-16, Big-Endian UTF-16, Little-Endian UTF-32 und Big-Endian UTF-32-Text, wenn die Datei mit den entsprechenden Bytereihenfolgenzeichen beginnt. Weitere Informationen finden Sie in der Encoding.GetPreamble Methode.

Das StreamReader Objekt ruft Dispose() das bereitgestellte Stream Objekt auf, wenn StreamReader.Dispose es aufgerufen wird.

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

Gilt für:

StreamReader(String)

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Dateinamen.

public:
 StreamReader(System::String ^ path);

public StreamReader(string path);

new System.IO.StreamReader : string -> System.IO.StreamReader

Public Sub New (path As String)

Parameter

path: String

Der vollständige Dateipfad, der gelesen werden soll.

Ausnahmen

ArgumentException

path ist eine leere Zeichenfolge ("").

ArgumentNullException

path ist null.

FileNotFoundException

Die Datei wurde nicht gefunden.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. auf einem nicht zugeordneten Laufwerk.

IOException

path enthält eine falsche oder ungültige Syntax für Dateinamen, Verzeichnisname oder Volumebezeichnung.

Beispiele

Im folgenden Codebeispiel wird dieser StreamReader Konstruktor veranschaulicht.

using System;
using System.IO;

class Test
{
    
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";

        try
        {
            if (File.Exists(path))
            {
                File.Delete(path);
            }

            using (StreamWriter sw = new StreamWriter(path))
            {
                sw.WriteLine("This");
                sw.WriteLine("is some text");
                sw.WriteLine("to test");
                sw.WriteLine("Reading");
            }

            using (StreamReader sr = new StreamReader(path))
            {
                while (sr.Peek() >= 0)
                {
                    Console.WriteLine(sr.ReadLine());
                }
            }
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

Imports System.IO

Public Class Test

    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"

        Try
            If File.Exists(path) Then
                File.Delete(path)
            End If

            Dim sw As StreamWriter = New StreamWriter(path)
            sw.WriteLine("This")
            sw.WriteLine("is some text")
            sw.WriteLine("to test")
            sw.WriteLine("Reading")
            sw.Close()

            Dim sr As StreamReader = New StreamReader(path)

            Do While sr.Peek() >= 0
                Console.WriteLine(sr.ReadLine())
            Loop
            sr.Close()
        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

Hinweise

Der vollständige Dateipfad wird durch den path Parameter angegeben. Dieser Konstruktor initialisiert die Codierung und UTF8Encoding die Puffergröße auf 1024 Byte.

Der path Parameter kann ein Dateiname sein, einschließlich einer Datei auf einer UNC-Freigabe (Universal Naming Convention).

Vorsicht

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

Gilt für:

StreamReader(String, Encoding)

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Quelle:: StreamReader.cs

Initialisiert eine neue Instanz der StreamReader Klasse für den angegebenen Dateinamen mit der angegebenen Zeichencodierung.

public:
 StreamReader(System::String ^ path, System::Text::Encoding ^ encoding);

public StreamReader(string path, System.Text.Encoding? encoding);

public StreamReader(string path, System.Text.Encoding encoding);

new System.IO.StreamReader : string * System.Text.Encoding -> System.IO.StreamReader

Public Sub New (path As String, encoding As Encoding)

Parameter

path: String

Der vollständige Dateipfad, der gelesen werden soll.

encoding: Encoding

Die zu verwendende Zeichencodierung.

Ausnahmen

ArgumentException

path ist eine leere Zeichenfolge ("").

ArgumentNullException

path oder encoding ist null.

FileNotFoundException

Die Datei wurde nicht gefunden.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. auf einem nicht zugeordneten Laufwerk.

NotSupportedException

path enthält eine falsche oder ungültige Syntax für Dateinamen, Verzeichnisname oder Volumebezeichnung.

Beispiele

Im folgenden Codebeispiel wird dieser StreamReader Konstruktor veranschaulicht.

private void getNewStreamReader()
{
    //Get a new StreamReader in ASCII format from a
    //file using a buffer and byte order mark detection
    StreamReader srAsciiFromFileFalse512 =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //file with byte order mark detection = false
    StreamReader srAsciiFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a file
    StreamReader srAsciiFromFile =
        new StreamReader("C:\\Temp\\Test.txt",
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //file with byte order mark detection = false
    StreamReader srFromFileFalse =
        new StreamReader("C:\\Temp\\Test.txt", false);
    //Get a new StreamReader from a file
    StreamReader srFromFile =
        new StreamReader("C:\\Temp\\Test.txt");
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false and a buffer
    StreamReader srAsciiFromStreamFalse512 = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false, 512);
    //Get a new StreamReader in ASCII format from a
    //FileStream with byte order mark detection = false
    StreamReader srAsciiFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII, false);
    //Get a new StreamReader in ASCII format from a FileStream
    StreamReader srAsciiFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        System.Text.Encoding.ASCII);
    //Get a new StreamReader from a
    //FileStream with byte order mark detection = false
    StreamReader srFromStreamFalse = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"),
        false);
    //Get a new StreamReader from a FileStream
    StreamReader srFromStream = new StreamReader(
        (System.IO.Stream)File.OpenRead("C:\\Temp\\Test.txt"));
}

Private Sub getNewStreamReader()
    Dim S As Stream = File.OpenRead("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'file using a buffer and byte order mark detection
    Dim SrAsciiFromFileFalse512 As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'file with byte order mark detection = false
    Dim SrAsciiFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a file 
    Dim SrAsciiFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt", _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'file with byte order mark detection = false        
    Dim SrFromFileFalse As StreamReader = New StreamReader("C:\Temp\Test.txt", False)
    'Get a new StreamReader from a file
    Dim SrFromFile As StreamReader = New StreamReader("C:\Temp\Test.txt")
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false and a buffer
    Dim SrAsciiFromStreamFalse512 As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII, False, 512)
    'Get a new StreamReader in ASCII format from a
    'FileStream with byte order mark detection = false
    Dim SrAsciiFromStreamFalse = New StreamReader(S, _
        System.Text.Encoding.ASCII, False)
    'Get a new StreamReader in ASCII format from a FileStream
    Dim SrAsciiFromStream As StreamReader = New StreamReader(S, _
        System.Text.Encoding.ASCII)
    'Get a new StreamReader from a
    'FileStream with byte order mark detection = false
    Dim SrFromStreamFalse As StreamReader = New StreamReader(S, False)
    'Get a new StreamReader from a FileStream
    Dim SrFromStream As StreamReader = New StreamReader(S)

End Sub

Hinweise

Dieser Konstruktor initialisiert die Codierung gemäß der Angabe durch den encoding Parameter und die interne Puffergröße auf 1024 Byte. Das StreamReader Objekt versucht, die Codierung zu erkennen, indem die ersten vier Bytes des Datenstroms betrachtet werden. Es erkennt automatisch UTF-8, Little-Endian UTF-16, Big-Endian UTF-16, Little-Endian UTF-32 und Big-Endian UTF-32-Text, wenn die Datei mit den entsprechenden Bytereihenfolgenzeichen beginnt. Andernfalls wird die vom Benutzer bereitgestellte Codierung verwendet. Weitere Informationen finden Sie in der Encoding.GetPreamble Methode.

Der path Parameter kann ein Dateiname sein, einschließlich einer Datei auf einer UNC-Freigabe (Universal Naming Convention).

Vorsicht

Eine Liste allgemeiner E/A-Aufgaben finden Sie unter "Allgemeine E/A-Aufgaben".

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?

Freigeben über

StreamReader Konstruktoren

Definition

Überlädt

StreamReader(Stream)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StreamReader(Stream, Encoding, Boolean, Int32, Boolean)

Parameter

Hinweise

Gilt für:

StreamReader(String, Encoding, Boolean, FileStreamOptions)

Parameter

Ausnahmen

Weitere Informationen

Gilt für:

StreamReader(String, Encoding, Boolean, Int32)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StreamReader(Stream, Encoding, Boolean, Int32)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StreamReader(Stream, Encoding, Boolean)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StreamReader(String, Encoding, Boolean)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StreamReader(String, FileStreamOptions)

Parameter

Ausnahmen

Weitere Informationen

Gilt für:

StreamReader(String, Boolean)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StreamReader(Stream, Encoding)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StreamReader(Stream, Boolean)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

StreamReader(String)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen