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

File-Klasse

 

Veröffentlicht: Oktober 2016

Stellt statische Methoden zum Erstellen, Kopieren, Löschen, Verschieben und Öffnen einer Datei bereit und unterstützt das Erstellen von FileStream-Objekten.

Um den .NET Framework-Quellcode für diesen Typ zu durchsuchen, finden Sie unter der Reference Source.

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


[ComVisibleAttribute(true)]
public static class File

NameBeschreibung
System_CAPS_pubmethodSystem_CAPS_staticAppendAllLines(String, IEnumerable<String>)

Fügt Zeilen an eine Datei an und schließt dann die Datei. Wenn die angegebene Datei nicht vorhanden ist, erstellt diese Methode eine Datei, schreibt die angegebenen Zeilen in die Datei und schließt die Datei dann.

System_CAPS_pubmethodSystem_CAPS_staticAppendAllLines(String, IEnumerable<String>, Encoding)

Fügt Zeilen unter Verwendung einer angegebenen Codierung an eine Datei an und schließt dann die Datei. Wenn die angegebene Datei nicht vorhanden ist, erstellt diese Methode eine Datei, schreibt die angegebenen Zeilen in die Datei und schließt die Datei dann.

System_CAPS_pubmethodSystem_CAPS_staticAppendAllText(String, String)

Öffnet eine Datei, fügt die angegebene Zeichenfolge an die Datei an und schließt dann die Datei. Wenn die Datei nicht vorhanden ist, erstellt diese Methode eine Datei, schreibt die angegebene Zeichenfolge in die Datei und schließt die Datei dann.

System_CAPS_pubmethodSystem_CAPS_staticAppendAllText(String, String, Encoding)

Fügt die angegebene Zeichenfolge an die Datei an und erstellt die Datei, wenn sie nicht bereits vorhanden ist.

System_CAPS_pubmethodSystem_CAPS_staticAppendText(String)

Erstellt einen StreamWriter, der UTF-8 codierten Text an eine vorhandene Datei anfügt oder an eine neue Datei, wenn die angegebene Datei nicht vorhanden ist.

System_CAPS_pubmethodSystem_CAPS_staticCopy(String, String)

Kopiert eine vorhandene Datei in eine neue Datei. Das Überschreiben einer gleichnamigen Datei ist nicht zulässig.

System_CAPS_pubmethodSystem_CAPS_staticCopy(String, String, Boolean)

Kopiert eine vorhandene Datei in eine neue Datei. Das Überschreiben einer gleichnamigen Datei ist zulässig.

System_CAPS_pubmethodSystem_CAPS_staticCreate(String)

Erstellt oder überschreibt eine Datei im angegebenen Pfad.

System_CAPS_pubmethodSystem_CAPS_staticCreate(String, Int32)

Erstellt oder überschreibt die angegebene Datei.

System_CAPS_pubmethodSystem_CAPS_staticCreate(String, Int32, FileOptions)

Erstellt oder überschreibt die angegebene Datei und gibt eine Puffergröße sowie einen FileOptions-Wert an, der beschreibt, wie die Datei erstellt oder überschrieben werden soll.

System_CAPS_pubmethodSystem_CAPS_staticCreate(String, Int32, FileOptions, FileSecurity)

Erstellt oder überschreibt die angegebene Datei mit der angegebenen Puffergröße, den Ordneroptionen und der Dateisicherheit.

System_CAPS_pubmethodSystem_CAPS_staticCreateText(String)

Erstellt oder öffnet eine Datei zum Schreiben von UTF-8 codiertem Text.

System_CAPS_pubmethodSystem_CAPS_staticDecrypt(String)

Entschlüsselt eine Datei, die vom aktuellen Konto mit der Encrypt-Methode verschlüsselt wurde.

System_CAPS_pubmethodSystem_CAPS_staticDelete(String)

Löscht die angegebene Datei.

System_CAPS_pubmethodSystem_CAPS_staticEncrypt(String)

Verschlüsselt eine Datei, sodass sie nur mit dem Konto, mit dem die Datei verschlüsselt wurde, entschlüsselt werden kann.

System_CAPS_pubmethodSystem_CAPS_staticExists(String)

Bestimmt, ob die angegebene Datei vorhanden ist.

System_CAPS_pubmethodSystem_CAPS_staticGetAccessControl(String)

Ruft ein FileSecurity-Objekt ab, das die ACL-Einträge für eine angegebene Datei kapselt.

System_CAPS_pubmethodSystem_CAPS_staticGetAccessControl(String, AccessControlSections)

Ruft ein FileSecurity-Objekt ab, das die angegebenen Typen von ACL-Einträgen für eine bestimmte Datei kapselt.

System_CAPS_pubmethodSystem_CAPS_staticGetAttributes(String)

Ruft die FileAttributes der Datei in dem Pfad ab.

System_CAPS_pubmethodSystem_CAPS_staticGetCreationTime(String)

Gibt das Erstellungsdatum und den Erstellungszeitpunkt für die angegebene Datei bzw. das angegebene Verzeichnis zurück.

System_CAPS_pubmethodSystem_CAPS_staticGetCreationTimeUtc(String)

Gibt das Erstellungsdatum und den Erstellungszeitpunkt der angegebenen Datei bzw. des angegebenen Verzeichnisses im UTC-Format (Coordinated Universal Time) zurück.

System_CAPS_pubmethodSystem_CAPS_staticGetLastAccessTime(String)

Gibt das Datum und die Uhrzeit des letzten Zugriffs auf die angegebene Datei bzw. das angegebene Verzeichnis zurück.

System_CAPS_pubmethodSystem_CAPS_staticGetLastAccessTimeUtc(String)

Gibt das Datum und den Zeitpunkt im UTC-Format (Coordinated Universal Time) des letzten Zugriffs auf die angegebene Datei bzw. das angegebene Verzeichnis zurück.

System_CAPS_pubmethodSystem_CAPS_staticGetLastWriteTime(String)

Gibt das Datum und die Uhrzeit des letzten Schreibvorgangs in die angegebene Datei bzw. das angegebene Verzeichnis zurück.

System_CAPS_pubmethodSystem_CAPS_staticGetLastWriteTimeUtc(String)

Gibt das Datum und den Zeitpunkt des letzten Schreibzugriffs auf die angegebenen Datei bzw. das angegebene Verzeichnis im UTC-Format (Coordinated Universal Time) zurück.

System_CAPS_pubmethodSystem_CAPS_staticMove(String, String)

Verschiebt eine angegebene Datei an einen neuen Speicherort und ermöglicht das Angeben eines neuen Dateinamens.

System_CAPS_pubmethodSystem_CAPS_staticOpen(String, FileMode)

Öffnet einen FileStream für den angegebenen Pfad mit Lese- und Schreibzugriff.

System_CAPS_pubmethodSystem_CAPS_staticOpen(String, FileMode, FileAccess)

Öffnet einen FileStream unter dem angegebenen Pfad mit dem angegebenen Modus und Zugriff.

System_CAPS_pubmethodSystem_CAPS_staticOpen(String, FileMode, FileAccess, FileShare)

Öffnet einen FileStream auf dem angegebenen Pfad, der über den angegebenen Modus mit Lese-, Schreib- oder Lese-/Schreibzugriff und die angegebene Freigabeoption verfügt.

System_CAPS_pubmethodSystem_CAPS_staticOpenRead(String)

Öffnet eine vorhandene Datei zum Lesen.

System_CAPS_pubmethodSystem_CAPS_staticOpenText(String)

Öffnet eine vorhandene UTF-8-codierte Textdatei zum Lesen.

System_CAPS_pubmethodSystem_CAPS_staticOpenWrite(String)

Öffnet eine vorhandene Datei oder erstellt eine neue Datei zum Schreiben.

System_CAPS_pubmethodSystem_CAPS_staticReadAllBytes(String)

Öffnet eine Binärdatei, liest den Inhalt der Datei in ein Bytearray ein und schließt dann die Datei.

System_CAPS_pubmethodSystem_CAPS_staticReadAllLines(String)

Öffnet eine Textdatei, liest alle Zeilen der Datei und schließt dann die Datei.

System_CAPS_pubmethodSystem_CAPS_staticReadAllLines(String, Encoding)

Öffnet eine Datei, liest alle Zeilen der Datei mit der angegebenen Codierung und schließt dann die Datei.

System_CAPS_pubmethodSystem_CAPS_staticReadAllText(String)

Öffnet eine Textdatei, liest alle Zeilen der Datei und schließt dann die Datei.

System_CAPS_pubmethodSystem_CAPS_staticReadAllText(String, Encoding)

Öffnet eine Datei, liest alle Zeilen der Datei mit der angegebenen Codierung und schließt dann die Datei.

System_CAPS_pubmethodSystem_CAPS_staticReadLines(String)

Liest die Zeilen einer Datei.

System_CAPS_pubmethodSystem_CAPS_staticReadLines(String, Encoding)

Liest die Zeilen einer Datei mit einer angegebenen Codierung.

System_CAPS_pubmethodSystem_CAPS_staticReplace(String, String, String)

Ersetzt den Inhalt einer angegebenen Datei mit dem Inhalt einer anderen Datei, löscht die ursprüngliche Datei und erstellt eine Sicherung der ersetzten Datei.

System_CAPS_pubmethodSystem_CAPS_staticReplace(String, String, String, Boolean)

Ersetzt den Inhalt einer angegebenen Datei mit dem Inhalt einer anderen Datei, löscht die ursprüngliche Datei, erstellt eine Sicherung der ersetzten Datei und ignoriert optional Fehler beim Zusammenführen.

System_CAPS_pubmethodSystem_CAPS_staticSetAccessControl(String, FileSecurity)

Wendet von einem FileSecurity-Objekt beschriebene Einträge von Zugriffssteuerungslisten (Access Control List, ACL) auf die angegebene Datei an.

System_CAPS_pubmethodSystem_CAPS_staticSetAttributes(String, FileAttributes)

Legt die angegebenen FileAttributes der Datei im angegebenen Pfad fest.

System_CAPS_pubmethodSystem_CAPS_staticSetCreationTime(String, DateTime)

Legt das Datum und die Uhrzeit fest, zu der die Datei erstellt wurde.

System_CAPS_pubmethodSystem_CAPS_staticSetCreationTimeUtc(String, DateTime)

Legt das Datum und die Uhrzeit der Erstellung der Datei im UTC-Format (Coordinated Universal Time) fest.

System_CAPS_pubmethodSystem_CAPS_staticSetLastAccessTime(String, DateTime)

Legt das Datum und die Uhrzeit des letzten Zugriffs auf die angegebene Datei fest.

System_CAPS_pubmethodSystem_CAPS_staticSetLastAccessTimeUtc(String, DateTime)

Legt das Datum und den Zeitpunkt des letzten Zugriffs auf die angegebene Datei im UTC-Format (Coordinated Universal Time) fest.

System_CAPS_pubmethodSystem_CAPS_staticSetLastWriteTime(String, DateTime)

Legt das Datum und die Uhrzeit des letzten Schreibvorgangs in die angegebene Datei fest.

System_CAPS_pubmethodSystem_CAPS_staticSetLastWriteTimeUtc(String, DateTime)

Legt das Datum und den Zeitpunkt des letzten Schreibzugriffs auf die angegebene Datei im UTC-Format (Coordinated Universal Time) fest.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllBytes(String, Byte[])

Erstellt eine neue Datei, schreibt das angegebene Bytearray in die Datei und schließt die Datei dann. Ist die Zieldatei bereits vorhanden, wird sie überschrieben.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, IEnumerable<String>)

Erstellt eine neue Datei, schreibt eine Auflistung von Zeichenfolgen in die Datei und schließt dann die Datei.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, IEnumerable<String>, Encoding)

Erstellt eine neue Datei unter Verwendung der angegebenen Codierung, schreibt eine Auflistung von Zeichenfolgen in die Datei und schließt dann die Datei.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, String[])

Erstellt eine neue Datei, schreibt das angegebene Zeichenfolgenarray in die Datei und schließt die Datei dann.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllLines(String, String[], Encoding)

Erstellt eine neue Datei, schreibt das angegebene Zeichenfolgenarray unter Verwendung der angegebenen Codierung in die Datei und schließt dann die Datei.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllText(String, String)

Erstellt eine neue Datei, schreibt die angegebene Zeichenfolge in die Datei und schließt die Datei dann. Ist die Zieldatei bereits vorhanden, wird sie überschrieben.

System_CAPS_pubmethodSystem_CAPS_staticWriteAllText(String, String, Encoding)

Erstellt eine neue Datei, schreibt die angegebene Zeichenfolge mit der angegebenen Codierung in die Datei und schließt die Datei dann. Ist die Zieldatei bereits vorhanden, wird sie überschrieben.

System_CAPS_noteHinweis

Die .NET Framework-Quellcodes für diesen Typ finden Sie unter der Reference Source. Sie können den Quellcode online Durchsuchen, Referenz für die Offlineanzeige herunterladen und schrittweise durchlaufen (inklusive Patches und Updates) während des Debuggens; see instructions.

Verwenden der File Klasse für normale Vorgänge wie das Kopieren, verschieben, umbenennen, erstellen, öffnen, löschen und Anfügen an eine einzelne Datei zu einem Zeitpunkt. Sie können auch die File zum Abrufen und Festlegen von Dateiattributen oder DateTime Informationen im Zusammenhang mit der Erstellung, Zugriff auf und Schreiben einer Datei. Wenn Sie Vorgänge für mehrere Dateien ausführen möchten, finden Sie unter Directory.GetFiles oder DirectoryInfo.GetFiles.

Viele der File Methoden andere e/a-Typen zurückgeben, beim Erstellen oder Öffnen von Dateien. Diese können anderen Typen Dateien weiter bearbeiten. Weitere Informationen finden Sie unter bestimmten File Elemente wie z. B. OpenText, CreateText, oder Create.

Da alle File Methoden sind statisch, es möglicherweise effizienter, eine File -Methode, anstatt eine entsprechende FileInfo Instanzmethode, wenn nur eine Aktion ausgeführt werden soll. Alle File Methoden erfordern den Pfad zur Datei, die Sie bearbeiten.

Die statischen Methoden der File Klasse sicherheitsüberprüfungen für alle Methoden ausführen. Wenn Sie ein Objekt mehrmals wiederverwenden möchten, erwägen Sie die entsprechende Instanzmethode des FileInfo stattdessen, da die Sicherheit überprüfen wird nicht immer erforderlich sein.

Standardmäßig wird die vollständige Lese-/Schreibzugriff auf neue Dateien für alle Benutzer gewährt.

In der folgenden Tabelle werden die Enumerationen beschrieben, mit denen das Verhalten der verschiedenen anpassen File Methoden.

Enumeration

Beschreibung

FileAccess

Gibt Lese- und Schreibzugriff auf eine Datei.

FileShare

Gibt die Ebene des Zugriffs für eine Datei, die bereits in Gebrauch ist zulässig.

FileMode

Gibt an, ob der Inhalt einer vorhandenen Datei beibehalten oder überschrieben werden, und gibt an, ob Anforderungen an eine vorhandene Datei erstellen, eine Ausnahme ausgelöst.

System_CAPS_noteHinweis

Bei Membern, die einen Pfad als Eingabezeichenfolge akzeptieren, diesem Pfad muss wohlgeformt sein oder eine Ausnahme ausgelöst. Wenn ein Pfad vollqualifiziert, aber mit einem Leerzeichen beginnt, wird der Pfad beispielsweise nicht in den Methoden der Klasse gekürzt. Aus diesem Grund der Pfad ist ungültig, und eine Ausnahme ausgelöst. Auf ähnliche Weise kann keinen Pfad oder eine Kombination von Pfaden zweimal vollqualifiziert werden. "C:\temp c:\windows" löst beispielsweise auch in den meisten Fällen eine Ausnahme aus. Stellen Sie sicher, dass die Pfade wohlgeformt sind, wenn Sie Methoden verwenden, die eine Pfadzeichenfolge akzeptieren.

Bei Membern, die einen Pfad akzeptieren, kann der Pfad zu einer Datei oder nur ein Verzeichnis verweisen. Der angegebene Pfad kann auch einen relativen Pfad oder einen Universal Naming Convention (UNC)-Pfad für einen Server und Freigabe verweisen. Beispielsweise sind alle folgenden Pfade zulässig:

  • "c:\\MyDir\\MyFile.txt" in c#, oder "c:\MyDir\MyFile.txt" in Visual Basic.

  • "c:\\MyDir" in c# oder "c:\MyDir" in Visual Basic.

  • "MyDir\\MySubdir" in C#- oder "MyDir\MySubDir" in Visual Basic.

  • "\\\MyServer\\MyShare" in c# oder "\\MyServer\MyShare" in Visual Basic.

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

Im folgenden Beispiel wird veranschaulicht, wie die File -Klasse überprüft, ob eine Datei vorhanden ist, und abhängig vom Ergebnis, entweder eine neue Datei erstellen und schreiben, oder die vorhandene Datei zu öffnen und daraus zu lesen. Erstellen Sie vor dem Ausführen des Codes, eine c:\temp Ordner.

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        if (!File.Exists(path))
        {
            // Create a file to write to.
            using (StreamWriter sw = File.CreateText(path))
            {
                sw.WriteLine("Hello");
                sw.WriteLine("And");
                sw.WriteLine("Welcome");
            }
        }

        // Open the file to read from.
        using (StreamReader sr = File.OpenText(path))
        {
            string s = "";
            while ((s = sr.ReadLine()) != null)
            {
                Console.WriteLine(s);
            }
        }
    }
}

Universelle Windows-Plattform
Verfügbar seit 10
.NET Framework
Verfügbar seit 1.1
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0

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: