FileStream-Klasse

Verwenden Sie die FileStream-Klasse, um von zu lesen, schreiben Sie zu, und schließen Dateien in einem Dateisystem, und andere dateibezogenes Betriebssystem zu bearbeiten behandelt, einschließlich Pipes, Standardeingabe und die Standardausgabe. Sie können Read, Write, CopyTo und Flush-Methoden verwenden, um synchronen Operationen oder ReadAsync, WriteAsync, CopyToAsync und FlushAsync-Methoden auszuführen, um asynchrone Vorgänge auszuführen. Verwenden Sie die asynchronen Methoden, um ressourcenintensive Dateioperationen ausführen, ohne den Hauptthread zu blockieren. Diese Leistungsüberlegung ist in einer Windows Store App oder in Desktop App besonders wichtig, in der ein zeitaufwendiger Streamvorgang den UI-Thread blockieren und die App angezeigt werden kann, als ob er nicht funktioniert. FileStream puffert Eingabe und Ausgabe zur besseren Leistung.

Die IsAsync-Eigenschaft erkennt, ob das Dateihandle asynchron geöffnet wurde. Sie geben diesen Wert an, wenn Sie eine Instanz der - Klasse FileStream mithilfe eines Konstruktors erstellen, der isAsync, useAsync oder options-Parameter verfügt. Wenn die - Eigenschaft true ist, verwendet der Stream überlappende E/A, um Dateioperationen asynchron auszuführen. muss jedoch die IsAsync-Eigenschaft nicht true sein, um ReadAsync, des WriteAsync oder der CopyToAsync-Methode aufzurufen. Wenn die - Eigenschaft IsAsyncfalse ist und Sie die asynchronen Lese- und Schreibvorgänge die aufrufen, wird der UI-Thread noch nicht blockiert, aber der tatsächliche E/A-Vorgang wird synchron ausgeführt.

Die Seek-Methode unterstützt wahlfreien Zugriff auf Dateien. Seek ermöglicht das Verschieben der Lese-/Schreibposition an eine beliebige Stelle in der Datei. Dies erfolgt durch Parameter für den Bezugspunkt des Byteoffset. Der Byteoffset ist relativ zum SuchenBezugspunkt, der der Anfang, die aktuelle Position oder das Ende der zugrunde liegenden Datei sein kann, wie von den drei SeekOrigin-Member der - Enumeration dargestellt.

Hinweis
Datenträgerdateien unterstützen immer den wahlfreien Zugriff. Zum Zeitpunkt der Erstellung wird der CanSeek-Eigenschaftswert zu true oder zu false je nach dem zugrunde liegenden Dateityp festgelegt. Wenn der zugrunde liegende Dateityp FILE_TYPE_DISK ist, wie in winbase.h definiert, ist der CanSeek-Eigenschaftswert true. Andernfalls ist der CanSeek-Eigenschaftswert false.

Wenn ein Prozess mit einer teilweise gesperrten Datei beendet wird oder eine Datei mit ausstehenden Sperren schließt, ist das Verhalten nicht definiert.

Für Verzeichnisvorgänge und weitere Dateioperationen finden, File, Directory und Path-Klassen. Die File-Klasse ist eine Hilfsprogrammklasse, die statische Methoden hauptsächlich für die Erstellung von FileStream-Objekte auf Grundlage Dateipfade verfügt. Die - Klasse stellt MemoryStream einen Stream von einem Bytearray erstellt und ist zur FileStream-Klasse vergleichbar.

Eine Liste der Gemeinsame Dateien und Verzeichnisvorgängen, finden Sie unter Allgemeine E/A-Aufgaben.

Erkennung von Streampositions-Änderungen

Im folgenden Beispiel werden einige der FileStream-Konstruktoren veranschaulicht.

using System;
using System.IO;
using System.Text;

class Test
{

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

        // Delete the file if it exists.
        if (File.Exists(path))
        {
            File.Delete(path);
        }

        //Create the file.
        using (FileStream fs = File.Create(path))
        {
            AddText(fs, "This is some text");
            AddText(fs, "This is some more text,");
            AddText(fs, "\r\nand this is on a new line");
            AddText(fs, "\r\n\r\nThe following is a subset of characters:\r\n");

            for (int i=1;i < 120;i++)
            {
                AddText(fs, Convert.ToChar(i).ToString());

            }
        }

        //Open the stream and read it back.
        using (FileStream fs = File.OpenRead(path))
        {
            byte[] b = new byte[1024];
            UTF8Encoding temp = new UTF8Encoding(true);
            while (fs.Read(b,0,b.Length) > 0)
            {
                Console.WriteLine(temp.GetString(b));
            }
        }
    }

    private static void AddText(FileStream fs, string value)
    {
        byte[] info = new UTF8Encoding(true).GetBytes(value);
        fs.Write(info, 0, info.Length);
    }
}

Im folgenden Beispiel wird gezeigt, wie in eine Datei schreibt asynchron.

using System;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.IO;

namespace WpfApplication1
{
    public partial class MainWindow : Window
    {
        public MainWindow()
        {
            InitializeComponent();
        }

        private async void Button_Click(object sender, RoutedEventArgs e)
        {
            UnicodeEncoding uniencoding = new UnicodeEncoding();
            string filename = @"c:\Users\exampleuser\Documents\userinputlog.txt";

            byte[] result = uniencoding.GetBytes(UserInput.Text);

            using (FileStream SourceStream = File.Open(filename, FileMode.OpenOrCreate))
            {
                SourceStream.Seek(0, SeekOrigin.End);
                await SourceStream.WriteAsync(result, 0, result.Length);
            }
        }
    }
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Referenz

Weitere Ressourcen