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

FileInfo-Klasse

 

Veröffentlicht: Oktober 2016

Stellt Eigenschaften und Instanzmethoden zum Erstellen, Kopieren, Löschen, Verschieben und Öffnen von Dateien bereit und unterstützt das Erstellen von FileStream-Objekten. Diese Klasse kann nicht vererbt werden.

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)


[SerializableAttribute]
[ComVisibleAttribute(true)]
public sealed class FileInfo : FileSystemInfo

NameBeschreibung
System_CAPS_pubmethodFileInfo(String)

Initialisiert eine neue Instanz der FileInfo-Klasse, die als Wrapper für einen Dateipfad fungiert.

NameBeschreibung
System_CAPS_pubpropertyAttributes

Ruft die Attribute für die aktuelle Datei oder das aktuelle Verzeichnis ab oder legt diese fest.(Geerbt von „FileSystemInfo“.)

System_CAPS_pubpropertyCreationTime

Ruft den Erstellungszeitpunkt der aktuellen Datei oder des aktuellen Verzeichnisses ab oder legt diesen fest.(Geerbt von „FileSystemInfo“.)

System_CAPS_pubpropertyCreationTimeUtc

Ruft die Erstellungszeit der aktuellen Datei oder des aktuellen Verzeichnisses im UTC-Format (Coordinated Universal Time) ab oder legt diese fest.(Geerbt von „FileSystemInfo“.)

System_CAPS_pubpropertyDirectory

Ruft eine Instanz des übergeordneten Verzeichnisses ab.

System_CAPS_pubpropertyDirectoryName

Ruft eine Zeichenfolge ab, die den vollständigen Pfad des Verzeichnisses darstellt.

System_CAPS_pubpropertyExists

Ruft einen Wert ab, der angibt, ob eine Datei vorhanden ist.(Überschreibt FileSystemInfo.Exists.)

System_CAPS_pubpropertyExtension

Ruft die Zeichenfolge ab, die den Erweiterungsteil der Datei darstellt.(Geerbt von „FileSystemInfo“.)

System_CAPS_pubpropertyFullName

Ruft den vollständigen Pfad des Verzeichnisses oder der Datei ab.(Geerbt von „FileSystemInfo“.)

System_CAPS_pubpropertyIsReadOnly

Ruft einen Wert ab, der bestimmt, ob die aktuelle Datei schreibgeschützt ist, oder legt diesen Wert fest.

System_CAPS_pubpropertyLastAccessTime

Ruft den Zeitpunkt des letzten Zugriffs auf die aktuelle Datei oder das aktuelle Verzeichnis ab oder legt diesen fest.(Geerbt von „FileSystemInfo“.)

System_CAPS_pubpropertyLastAccessTimeUtc

Ruft den Zeitpunkt des letzten Zugriffs auf die aktuelle Datei bzw. das aktuelle Verzeichnis im UTC-Format (Coordinated Universal Time) ab oder legt diesen fest.(Geerbt von „FileSystemInfo“.)

System_CAPS_pubpropertyLastWriteTime

Ruft den Zeitpunkt des letzten Schreibzugriffs auf die aktuelle Datei oder das aktuelle Verzeichnis ab oder legt diesen fest.(Geerbt von „FileSystemInfo“.)

System_CAPS_pubpropertyLastWriteTimeUtc

Ruft den Zeitpunkt des letzten Schreibens in die aktuelle Datei oder das aktuelle Verzeichnis im UTC-Format (Coordinated Universal Time) ab oder legt diesen fest.(Geerbt von „FileSystemInfo“.)

System_CAPS_pubpropertyLength

Ruft die Größe der aktuellen Datei in Byte ab.

System_CAPS_pubpropertyName

Ruft den Namen der Datei ab.(Überschreibt FileSystemInfo.Name.)

NameBeschreibung
System_CAPS_pubmethodAppendText()

Erstellt einen StreamWriter, der der Datei Text hinzufügt, die von dieser Instanz von FileInfo dargestellt wird.

System_CAPS_pubmethodCopyTo(String)

Kopiert eine vorhandene Datei in eine neue Datei, ohne das Überschreiben einer vorhandenen Datei zuzulassen.

System_CAPS_pubmethodCopyTo(String, Boolean)

Kopiert eine vorhandene Datei in eine neue Datei und lässt das Überschreiben einer vorhandenen Datei zu.

System_CAPS_pubmethodCreate()

Erstellt eine Datei.

System_CAPS_pubmethodCreateObjRef(Type)

Erstellt ein Objekt, das alle relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt verwendet die enthält.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodCreateText()

Erstellt einen StreamWriter, der eine neue Textdatei erstellt und in diese schreibt.

System_CAPS_pubmethodDecrypt()

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

System_CAPS_pubmethodDelete()

Löscht eine Datei unwiderruflich.(Überschreibt FileSystemInfo.Delete().)

System_CAPS_pubmethodEncrypt()

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

System_CAPS_pubmethodEquals(Object)

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

System_CAPS_pubmethodGetAccessControl()

Ruft ein FileSecurity-Objekt ab, das die Einträge in der Zugriffssteuerungsliste für die Datei kapselt, das vom aktuellen FileInfo-Objekt beschrieben wird.

System_CAPS_pubmethodGetAccessControl(AccessControlSections)

Ruft ein FileSecurity-Objekt ab, das den angegebenen Typ der Einträge in der Zugriffssteuerungsliste für die Datei kapselt, die vom aktuellen FileInfo-Objekt beschrieben wird.

System_CAPS_pubmethodGetHashCode()

Fungiert als die Standardhashfunktion.(Geerbt von „Object“.)

System_CAPS_pubmethodGetLifetimeService()

Ruft das Dienstobjekt für aktuellen Lebensdauer, das steuert, die lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodGetObjectData(SerializationInfo, StreamingContext)

Legt das SerializationInfo-Objekt mit dem Dateinamen und zusätzlichen Informationen zur Ausnahme fest.(Geerbt von „FileSystemInfo“.)

System_CAPS_pubmethodGetType()

Ruft den Type der aktuellen Instanz ab.(Geerbt von „Object“.)

System_CAPS_pubmethodInitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.(Geerbt von „MarshalByRefObject“.)

System_CAPS_pubmethodMoveTo(String)

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

System_CAPS_pubmethodOpen(FileMode)

Öffnet eine Datei im angegebenen Modus.

System_CAPS_pubmethodOpen(FileMode, FileAccess)

Öffnet eine Datei im angegebenen Modus mit Lese-, Schreib- oder Lese-/Schreibzugriff.

System_CAPS_pubmethodOpen(FileMode, FileAccess, FileShare)

Öffnet eine Datei im angegebenen Modus mit Lese-, Schreib- oder Lese-/Schreibzugriff und der angegebenen Freigabeoption.

System_CAPS_pubmethodOpenRead()

Erstellt einen schreibgeschützten FileStream.

System_CAPS_pubmethodOpenText()

Erstellt einen StreamReader mit UTF8-Codierung, der aus einer vorhandenen Textdatei liest.

System_CAPS_pubmethodOpenWrite()

Erstellt einen lesegeschützten FileStream.

System_CAPS_pubmethodRefresh()

Aktualisiert den Zustand des Objekts.(Geerbt von „FileSystemInfo“.)

System_CAPS_pubmethodReplace(String, String)

Ersetzt den Inhalt einer angegebenen Datei durch die vom aktuellen FileInfo-Objekt beschriebene Datei, löscht die ursprüngliche Datei und erstellt eine Sicherungskopie der ersetzten Datei.

System_CAPS_pubmethodReplace(String, String, Boolean)

Ersetzt den Inhalt einer angegebenen Datei durch die vom aktuellen FileInfo-Objekt beschriebene Datei, löscht die ursprüngliche Datei und erstellt eine Sicherungskopie der ersetzten Datei. Gibt auch an, ob Zusammenführungsfehler ignoriert werden sollen.

System_CAPS_pubmethodSetAccessControl(FileSecurity)

Wendet von einem FileSecurity-Objekt beschriebene Einträge in Zugriffssteuerungslisten auf die Datei an, die vom aktuellen FileInfo-Objekt beschrieben wird.

System_CAPS_pubmethodToString()

Gibt den Pfad als Zeichenfolge zurück.(Überschreibt Object.ToString().)

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 FileInfo Klasse für normale Vorgänge wie das Kopieren, verschieben, umbenennen, erstellen, öffnen, löschen und Anfügen von Dateien.

Falls Sie mehrere Vorgänge in derselben Datei ausführen, es kann effizienter sein, verwenden FileInfo Instanzmethoden anstelle der entsprechenden statischen Methoden für die File Klasse, da der Aufrufer nicht immer notwendig sein.

Viele der FileInfo 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 FileInfo Elemente wie z. B. Open, OpenRead, OpenText, CreateText, oder Create.

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 FileInfo 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.

Die FileInfo -Klasse stellt die folgenden Eigenschaften, mit denen Sie Informationen zu einer Datei abrufen können. Ein Beispiel zur Verwendung der einzelnen Eigenschaften finden Sie unter den Eigenschaftenseiten.

  • Die Directory -Eigenschaft ruft ein Objekt, das das übergeordnete Verzeichnis eine Datei darstellt.

  • Die DirectoryName -Eigenschaft ruft den vollständigen Pfad des übergeordneten Verzeichnisses einer Datei ab.

  • Die Exists -Eigenschaft überprüft das Vorhandensein einer Datei vor dem Ausführen von Operationen.

  • Die IsReadOnly Eigenschaft ruft ab oder legt einen Wert, der angibt, ob eine Datei geändert werden kann.

  • Die Length Ruft die Größe einer Datei ab.

  • Die Name Ruft den Namen einer Datei ab.

Das folgende Beispiel veranschaulicht einige der wichtigsten Elemente der FileInfo Klasse.

Wenn die Eigenschaften zuerst abgerufen werden, FileInfo Aufrufe der Refresh -Methode und speichert die Informationen über die Datei. Bei nachfolgenden Aufrufen, rufen Sie Refresh auf die aktuellste Kopie der Informationen abzurufen.

using System;
using System.IO;

class Test 
{

    public static void Main() 
    {
        string path = Path.GetTempFileName();
        FileInfo fi1 = new FileInfo(path);

        //Create a file to write to.
        using (StreamWriter sw = fi1.CreateText()) 
        {
            sw.WriteLine("Hello");
            sw.WriteLine("And");
            sw.WriteLine("Welcome");
        }	

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

        try 
        {
            string path2 = Path.GetTempFileName();
            FileInfo fi2 = new FileInfo(path2);

            //Ensure that the target does not exist.
            fi2.Delete();

            //Copy the file.
            fi1.CopyTo(path2);
            Console.WriteLine("{0} was copied to {1}.", path, path2);

            //Delete the newly created file.
            fi2.Delete();
            Console.WriteLine("{0} was successfully deleted.", path2);

        } 
        catch (Exception e) 
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

In diesem Beispiel wird die Ausgabe ähnlich der folgenden.

Hello
And
Welcome
C:\Users\userName\AppData\Local\Temp\tmp70AB.tmp was copied to C:\Users\userName\AppData\Local\Temp\tmp70CB.tmp.
C:\Users\userName\AppData\Local\Temp\tmp70CB.tmp was successfully deleted.

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: