Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. |
Übersetzung
Original
|
FileInfo-Klasse
Aktualisiert: August 2010
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.
Assembly: mscorlib (in mscorlib.dll)
Der FileInfo-Typ macht die folgenden Member verfügbar.
| Name | Beschreibung | |
|---|---|---|
|
FileInfo | Initialisiert eine neue Instanz der FileInfo-Klasse, die als Wrapper für einen Dateipfad fungiert. |
| Name | Beschreibung | |
|---|---|---|
|
Attributes | Ruft die Attribute für die aktuelle Datei oder das aktuelle Verzeichnis ab oder legt diese fest. (Von FileSystemInfo geerbt.) |
|
CreationTime | Ruft den Erstellungszeitpunkt der aktuellen Datei oder des aktuellen Verzeichnisses ab oder legt diesen fest. (Von FileSystemInfo geerbt.) |
|
CreationTimeUtc | Ruft die Erstellungszeit der aktuellen Datei oder des aktuellen Verzeichnisses im UTC-Format (Coordinated Universal Time) ab oder legt diese fest. (Von FileSystemInfo geerbt.) |
|
Directory | Ruft eine Instanz des übergeordneten Verzeichnisses ab. |
|
DirectoryName | Ruft eine Zeichenfolge ab, die den vollständigen Pfad des Verzeichnisses darstellt. |
|
Exists | Ruft einen Wert ab, der angibt, ob eine Datei vorhanden ist. (Überschreibt FileSystemInfo.Exists.) |
|
Extension | Ruft die Zeichenfolge ab, die den Erweiterungsteil der Datei darstellt. (Von FileSystemInfo geerbt.) |
|
FullName | Ruft den vollständigen Pfad des Verzeichnisses oder der Datei ab. (Von FileSystemInfo geerbt.) |
|
IsReadOnly | Ruft einen Wert ab, der bestimmt, ob die aktuelle Datei schreibgeschützt ist, oder legt diesen Wert fest. |
|
LastAccessTime | Ruft den Zeitpunkt des letzten Zugriffs auf die aktuelle Datei oder das aktuelle Verzeichnis ab oder legt diesen fest. (Von FileSystemInfo geerbt.) |
|
LastAccessTimeUtc | 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. (Von FileSystemInfo geerbt.) |
|
LastWriteTime | Ruft den Zeitpunkt des letzten Schreibzugriffs auf die aktuelle Datei oder das aktuelle Verzeichnis ab oder legt diesen fest. (Von FileSystemInfo geerbt.) |
|
LastWriteTimeUtc | 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. (Von FileSystemInfo geerbt.) |
|
Length | Ruft die Größe der aktuellen Datei in Byte ab. |
|
Name | Ruft den Namen der Datei ab. (Überschreibt FileSystemInfo.Name.) |
| Name | Beschreibung | |
|---|---|---|
|
AppendText | Erstellt einen StreamWriter, der der Datei Text hinzufügt, die von dieser Instanz von FileInfo dargestellt wird. |
|
CopyTo(String) | Kopiert eine vorhandene Datei in eine neue Datei, ohne das Überschreiben einer vorhandenen Datei zuzulassen. |
|
CopyTo(String, Boolean) | Kopiert eine vorhandene Datei in eine neue Datei und lässt das Überschreiben einer vorhandenen Datei zu. |
|
Create | Erstellt eine Datei. |
|
CreateObjRef | Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Von MarshalByRefObject geerbt.) |
|
CreateText | Erstellt einen StreamWriter, der eine neue Textdatei erstellt und in diese schreibt. |
|
Decrypt | Entschlüsselt eine Datei, die vom aktuellen Konto mit der Encrypt-Methode verschlüsselt wurde. |
|
Delete | Löscht eine Datei unwiderruflich. (Überschreibt FileSystemInfo.Delete().) |
|
Encrypt | Verschlüsselt eine Datei, sodass sie nur mit dem Konto, mit dem die Datei verschlüsselt wurde, entschlüsselt werden kann. |
|
Equals(Object) | Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.) |
|
Finalize | Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.) |
|
GetAccessControl() | Ruft ein FileSecurity-Objekt ab, das die Einträge in der Zugriffssteuerungsliste für die Datei kapselt, das vom aktuellen FileInfo-Objekt beschrieben wird. |
|
GetAccessControl(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. |
|
GetHashCode | Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.) |
|
GetLifetimeService | Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Von MarshalByRefObject geerbt.) |
|
GetObjectData | Legt das SerializationInfo-Objekt mit dem Dateinamen und zusätzlichen Informationen zur Ausnahme fest. (Von FileSystemInfo geerbt.) |
|
GetType | Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.) |
|
InitializeLifetimeService | Ruft ein Lebensdauerdienstobjekt ab, mit dem die Lebensdauerrichtlinien für diese Instanz gesteuert werden können. (Von MarshalByRefObject geerbt.) |
|
MemberwiseClone() | Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.) |
|
MemberwiseClone(Boolean) | Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Von MarshalByRefObject geerbt.) |
|
MoveTo | Verschiebt eine angegebene Datei an einen neuen Speicherort und ermöglicht das Angeben eines neuen Dateinamens. |
|
Open(FileMode) | Öffnet eine Datei im angegebenen Modus. |
|
Open(FileMode, FileAccess) | Öffnet eine Datei im angegebenen Modus mit Lese-, Schreib- oder Lese-/Schreibzugriff. |
|
Open(FileMode, FileAccess, FileShare) | Öffnet eine Datei im angegebenen Modus mit Lese-, Schreib- oder Lese-/Schreibzugriff und der angegebenen Freigabeoption. |
|
OpenRead | Erstellt einen schreibgeschützten FileStream. |
|
OpenText | Erstellt einen StreamReader mit UTF8-Codierung, der aus einer vorhandenen Textdatei liest. |
|
OpenWrite | Erstellt einen FileStream, der nur über Schreibzugriff verfügt. |
|
Refresh | Aktualisiert den Zustand des Objekts. (Von FileSystemInfo geerbt.) |
|
Replace(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. |
|
Replace(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. |
|
SetAccessControl | Wendet von einem FileSecurity-Objekt beschriebene Einträge in Zugriffssteuerungslisten auf die Datei an, die vom aktuellen FileInfo-Objekt beschrieben wird. |
|
ToString | Gibt den Pfad als Zeichenfolge zurück. (Überschreibt Object.ToString().) |
| Name | Beschreibung | |
|---|---|---|
|
FullPath | Stellt den vollqualifizierten Pfad des Verzeichnisses oder der Datei dar. (Von FileSystemInfo geerbt.) |
|
OriginalPath | Der ursprünglich vom Benutzer angegebene Pfad, relativ oder absolut. (Von FileSystemInfo geerbt.) |
Verwenden Sie die FileInfo-Klasse für typische Operationen, z. B. das Kopieren, Verschieben, Umbenennen, Erstellen, Öffnen, Löschen und Anfügen von Dateien.
Viele FileInfo-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 FileInfo-Membern, z. B. Open, OpenRead, OpenText, CreateText oder Create.
Wenn Sie ein Objekt mehrmals wiederverwenden, verwenden Sie statt der entsprechenden statischen Methoden der File-Klasse die Instanzmethode von FileInfo, da eine 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 zum Anpassen des Verhaltens verschiedener FileInfo-Methoden verwendet werden.
|
Enumeration |
Beschreibungen |
|---|---|
|
Gibt Lese- und Schreibzugriff auf eine Datei an. |
|
|
Gibt die Ebene des gewährten Zugriffs für eine Datei an, die bereits verwendet wird. |
|
|
Gibt an, ob der Inhalt einer vorhandenen Datei beibehalten oder überschrieben wird und ob Anforderungen zum Erstellen einer vorhandenen Datei eine Ausnahme auslösen. |
Hinweis
|
|---|
|
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.
Die FileInfo-Klasse stellt die folgenden Eigenschaften bereit, die Ihnen ermöglichen, Informationen zu einer Datei abzurufen. Ein Beispiel zum Verwenden jeder Eigenschaft finden Sie in den Eigenschaftenseiten.
-
Die Directory-Eigenschaft ruft ein Objekt ab, das das übergeordnete Verzeichnis von einer 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 Vorgängen für sie.
-
Die IsReadOnly-Eigenschaft ruft einen Wert ab oder legt ihn fest, der angibt, ob eine Datei geändert werden kann.
-
Die Length ruft die Größe einer Datei ab.
-
Name ruft den Namen einer Datei ab.
Das folgende Beispiel veranschaulicht einige der wichtigsten Member der FileInfo-Klasse.
Wenn die Eigenschaften zuerst abgerufen werden, ruft FileInfo die Refresh-Methode auf und speichert die Informationen zur Datei zwischen. Bei nachfolgenden Aufrufen müssen Sie Refresh aufrufen, um 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()); } } }
Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Hinweis