(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

File-Klasse

Stellt statische Methoden zum Erstellen, Kopieren, Löschen, Verschieben und Öffnen einer Datei bereit, und Helfer bei der Erstellung von FileStream-Objekten.

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

[ComVisibleAttribute(true)]
public static class File

Der File-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeStatischer MemberAppendAllLines(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.
Öffentliche MethodeStatischer MemberAppendAllLines(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.
Öffentliche MethodeStatischer MemberAppendAllText(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.
Öffentliche MethodeStatischer MemberAppendAllText(String, String, Encoding)Fügt die angegebene Zeichenfolge an die Datei an und erstellt die Datei, wenn sie nicht bereits vorhanden ist.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkAppendTextErstellt StreamWriter, die UTF-8 codierten Text zu einer vorhandenen Datei angefügt, oder einer neuen Datei, wenn die angegebene Datei nicht vorhanden ist.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkCopy(String, String)Kopiert eine vorhandene Datei in eine neue Datei. Das Überschreiben einer gleichnamigen Datei ist nicht zulässig.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkCopy(String, String, Boolean)Kopiert eine vorhandene Datei in eine neue Datei. Das Überschreiben einer gleichnamigen Datei ist zulässig.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkCreate(String)Erstellt oder überschreibt eine Datei im angegebenen Pfad.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkCreate(String, Int32)Erstellt oder überschreibt die angegebene Datei.
Öffentliche MethodeStatischer MemberCreate(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.
Öffentliche MethodeStatischer MemberCreate(String, Int32, FileOptions, FileSecurity)Erstellt oder überschreibt die angegebene Datei mit der angegebenen Puffergröße, den Ordneroptionen und der Dateisicherheit.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkCreateTextErstellt oder öffnet eine Datei zum Schreiben von UTF-8 codiertem Text.
Öffentliche MethodeStatischer MemberDecryptEntschlüsselt eine Datei, die vom aktuellen Konto mit der Encrypt-Methode verschlüsselt wurde.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkDeleteLöscht die angegebene Datei.
Öffentliche MethodeStatischer MemberEncryptVerschlüsselt eine Datei, sodass sie nur mit dem Konto, mit dem die Datei verschlüsselt wurde, entschlüsselt werden kann.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkExistsBestimmt, ob die angegebene Datei vorhanden ist.
Öffentliche MethodeStatischer MemberGetAccessControl(String)Ruft ein FileSecurity-Objekt ab, das die ACL-Einträge für eine angegebene Datei kapselt.
Öffentliche MethodeStatischer MemberGetAccessControl(String, AccessControlSections)Ruft ein FileSecurity-Objekt ab, das die angegebenen Typen von ACL-Einträgen für eine bestimmte Datei kapselt.
Öffentliche MethodeStatischer MemberGetAttributesRuft die FileAttributes der Datei in dem Pfad ab.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkGetCreationTimeGibt das Erstellungsdatum und den Erstellungszeitpunkt für die angegebene Datei bzw. das angegebene Verzeichnis zurück.
Öffentliche MethodeStatischer MemberGetCreationTimeUtcGibt das Erstellungsdatum und den Erstellungszeitpunkt im UTC-Format (Coordinated Universal Time) der angegebenen Datei bzw. des angegebenen Verzeichnisses zurück.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkGetLastAccessTimeGibt das Datum und die Uhrzeit des letzten Zugriffs auf die angegebene Datei bzw. das angegebene Verzeichnis zurück.
Öffentliche MethodeStatischer MemberGetLastAccessTimeUtcGibt das Datum und den Zeitpunkt im UTC-Format (Coordinated Universal Time) des letzten Zugriffs auf die angegebene Datei bzw. das angegebene Verzeichnis zurück.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkGetLastWriteTimeGibt das Datum und die Uhrzeit des letzten Schreibvorgangs in die angegebene Datei bzw. das angegebene Verzeichnis zurück.
Öffentliche MethodeStatischer MemberGetLastWriteTimeUtcGibt das Datum und den Zeitpunkt im UTC-Format (Coordinated Universal Time) des letzten Schreibzugriffs auf die angegebenen Datei bzw. das angegebene Verzeichnis zurück.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkMoveVerschiebt eine angegebene Datei an einen neuen Speicherort und ermöglicht das Angeben eines neuen Dateinamens.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkOpen(String, FileMode)Öffnet einen FileStream für den angegebenen Pfad mit Lese- und Schreibzugriff.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkOpen(String, FileMode, FileAccess)Öffnet einen FileStream unter dem angegebenen Pfad, mit dem angegebenen Modus und Zugriff.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkOpen(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.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkOpenReadÖffnet eine vorhandene Datei zum Lesen.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkOpenTextÖffnet eine vorhandene UTF-8-codierte Textdatei zum Lesen.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkOpenWriteÖffnet eine vorhandene Datei oder erstellt eine neue Datei zum Schreiben.
Öffentliche MethodeStatischer MemberReadAllBytesÖffnet eine Binärdatei, liest den Inhalt der Datei in ein Bytearray ein und schließt dann die Datei.
Öffentliche MethodeStatischer MemberReadAllLines(String)Öffnet eine Textdatei, liest alle Zeilen der Datei und schließt dann die Datei.
Öffentliche MethodeStatischer MemberReadAllLines(String, Encoding)Öffnet eine Datei, liest alle Zeilen der Datei mit der angegebenen Codierung und schließt dann die Datei.
Öffentliche MethodeStatischer MemberReadAllText(String)Öffnet eine Textdatei, liest alle Zeilen der Datei und schließt dann die Datei.
Öffentliche MethodeStatischer MemberReadAllText(String, Encoding)Öffnet eine Datei, liest alle Zeilen der Datei mit der angegebenen Codierung und schließt dann die Datei.
Öffentliche MethodeStatischer MemberReadLines(String)Liest die Zeilen einer Datei.
Öffentliche MethodeStatischer MemberReadLines(String, Encoding)Liest die Zeilen einer Datei mit einer angegebenen Codierung.
Öffentliche MethodeStatischer MemberReplace(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.
Öffentliche MethodeStatischer MemberReplace(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.
Öffentliche MethodeStatischer MemberSetAccessControlWendet von einem FileSecurity-Objekt beschriebene Einträge von Zugriffssteuerungslisten (Access Control List, ACL) auf die angegebene Datei an.
Öffentliche MethodeStatischer MemberSetAttributesLegt die angegebenen FileAttributes der Datei im angegebenen Pfad fest.
Öffentliche MethodeStatischer MemberSetCreationTimeLegt das Datum und die Uhrzeit fest, zu der die Datei erstellt wurde.
Öffentliche MethodeStatischer MemberSetCreationTimeUtcLegt das Datum und die Uhrzeit im UTC-Format (Coordinated Universal Time) der Erstellung der Datei fest.
Öffentliche MethodeStatischer MemberSetLastAccessTimeLegt das Datum und die Uhrzeit des letzten Zugriffs auf die angegebene Datei fest.
Öffentliche MethodeStatischer MemberSetLastAccessTimeUtcLegt das Datum und den Zeitpunkt im UTC-Format (Coordinated Universal Time) des letzten Zugriffs auf die angegebene Datei fest.
Öffentliche MethodeStatischer MemberSetLastWriteTimeLegt das Datum und die Uhrzeit des letzten Schreibvorgangs in die angegebene Datei fest.
Öffentliche MethodeStatischer MemberSetLastWriteTimeUtcLegt das Datum und den Zeitpunkt im UTC-Format (Coordinated Universal Time) des letzten Schreibzugriffs auf die angegebene Datei fest.
Öffentliche MethodeStatischer MemberWriteAllBytesErstellt eine neue Datei, schreibt das angegebene Bytearray in die Datei und schließt die Datei dann. Ist die Zieldatei bereits vorhanden, wird sie überschrieben.
Öffentliche MethodeStatischer MemberWriteAllLines(String, IEnumerable<String>)Erstellt eine neue Datei, schreibt eine Auflistung von Zeichenfolgen in die Datei und schließt dann die Datei.
Öffentliche MethodeStatischer MemberWriteAllLines(String, String[])Erstellt eine neue Datei, schreibt das angegebene Zeichenfolgenarray in die Datei und schließt die Datei dann.
Öffentliche MethodeStatischer MemberWriteAllLines(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.
Öffentliche MethodeStatischer MemberWriteAllLines(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.
Öffentliche MethodeStatischer MemberWriteAllText(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.
Öffentliche MethodeStatischer MemberWriteAllText(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.
Zum Seitenanfang

Verwenden Sie die File-Klasse für typische Operationen wie Kopieren, Verschieben, Umbenennen, Erstellen, Öffnen, Löschen und zu einer Datei jeweils anfügen. Sie können mithilfe der File-Klasse auch Dateiattribute oder DateTime-Informationen in Bezug auf den Dateizugriff, die Dateierstellung sowie das Schreiben in Dateien abrufen und festlegen. Wenn mehrere Operationen für Dateien ausführen möchten, finden Sie unter GetFiles oder GetFiles.

Viele File-Methoden geben beim Erstellen oder Öffnen von Dateien andere E/A-Typen zurück. Sie können mithilfe dieser anderen Typen Dateien weiter bearbeiten. Weitere Informationen finden Sie unter bestimmten File-Membern, z. B. OpenText, CreateText oder Create.

Da alle File-Methoden statisch sind, kann die Verwendung einer File-Methode effektiver als die Verwendung einer entsprechenden FileInfo-Instanzmethode sein, wenn nur eine Aktion ausgeführt werden soll. Für alle File-Methoden ist der Pfad zur bearbeiteten Datei erforderlich.

Die statischen Methoden der File-Klasse führen Sicherheitsüberprüfungen für alle Methoden durch. Wenn Sie ein Objekt mehrmals wiederverwenden, verwenden Sie stattdessen die entsprechende Instanzmethode von FileInfo, da die Sicherheitsüberprüfung nicht immer erforderlich ist.

In der Standardeinstellung wird allen Benutzern voller Lese- und Schreibzugriff für alle neuen Dateien gewährt.

In der folgenden Tabelle werden die Enumerationen beschrieben, die zur Anpassung des Verhaltens verschiedener File-Methoden verwendet werden.

Enumeration

Beschreibung

FileAccess

Gibt Lese- und Schreibzugriff auf eine Datei an.

FileShare

Gibt die Ebene des gewährten Zugriffs für eine Datei an, die bereits verwendet wird.

FileMode

Gibt an, ob der Inhalt einer vorhandenen Datei beibehalten oder überschrieben wird und ob Anforderungen zum Erstellen einer vorhandenen Datei eine Ausnahme auslösen.

HinweisHinweis

Bei Membern, die einen Pfad als Eingabezeichenfolge akzeptieren, muss dieser Pfad wohlgeformt sein. Andernfalls wird eine Ausnahme ausgelöst. Wenn beispielsweise ein Pfad voll gekennzeichnet ist, aber mit einem Leerzeichen beginnt, wird der Pfad in Methoden der Klasse nicht gekürzt. Daher ist der Pad falsch formatiert, und es wird eine Ausnahme ausgelöst. Ebenso kann ein Pfad oder eine Kombination von Pfaden nicht zweimal voll gekennzeichnet werden. Auch "c:\temp c:\windows" löst beispielsweise in den meisten Fällen eine Ausnahme aus. Bei der Verwendung von Methoden, die eine Pfadzeichenfolge akzeptieren, müssen Sie sicherstellen, dass die Pfade wohlgeformt sind.

Bei Membern, die einen Pfad akzeptieren, kann der Pfad auf eine Datei oder nur auf ein Verzeichnis verweisen. Der angegebene Pfad kann auch auf einen relativen Pfad oder auf einen UNC-Pfad (Universal Naming Convention) für einen Server- und Freigabenamen 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.

Das folgende Beispiel zeigt, wie die File-Klasse verwendet wird, um zu überprüfen, ob eine Datei vorhanden ist, und sie je nach Ergebnis entweder zu erstellen und darin zu schreiben, oder sie zu öffnen und darin zu lesen.


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


.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

.NET für Windows Phone-Apps

Unterstützt in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, 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)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft