ZipArchiveEntry.ExtractToFile-Methode (String)
Erstellt eine Datei im Dateisystem mit den Eintrag Inhalt und dem angegebenen Namen. Zeitpunkt des letzte Schreibzugriffs auf die Datei wird auf den Eintrag Zeitpunkt des letzten Schreibzugriffs festgelegt. Diese Methode lässt sich nicht für das Überschreiben einer vorhandenen Datei, die den gleichen Namen hat. Versuchen, explizite Verzeichnisse (Einträge mit Namen, die die Endung Verzeichnistrennzeichen) zu extrahieren, wird ein Verzeichnis nicht erstellen.
Namespace: Microsoft.TeamFoundation.Framework.Server
Assembly: Microsoft.TeamFoundation.Framework.Server (in Microsoft.TeamFoundation.Framework.Server.dll)
Syntax
'Declaration
Public Sub ExtractToFile ( _
destinationFileName As String _
)
public void ExtractToFile(
string destinationFileName
)
Parameter
- destinationFileName
Typ: System.String
Der Name der Datei, die den Inhalt des Eintrags halten wird.Der Pfad dürfen relative oder absolute Pfadinformationen angegeben werden.Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| UnauthorizedAccessException | Der Aufrufer verfügt nicht über die erforderliche Berechtigung. |
| ArgumentException | DestinationFileName ist eine Zeichenfolge der Länge 0 (null), oder enthält nur Leerzeichen, er enthält ein oder mehrere ungültige Zeichen durch InvalidPathChars definierte oder DestinationFileName gibt ein Verzeichnis. |
| ArgumentNullException | DestinationFileName ist null. |
| PathTooLongException | Der angegebene Pfad und/oder der Dateiname überschreiten die vom System vorgegebene Höchstlänge. Beispielsweise müssen Pfade auf Windows-Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen haben. |
| DirectoryNotFoundException | In DestinationFileName angegebene Pfad ist ungültig (es ist beispielsweise auf einem nicht zugeordneten Laufwerk). |
| IOException | DestinationFileName vorhanden ist. – oder – ein e/a-Fehler ist aufgetreten. – oder – der Eintrag gegenwärtig zum Schreiben geöffnet ist. – oder – der Eintrag aus dem Archiv gelöscht wurde. |
| NotSupportedException | DestinationFileName ist in einem ungültigen Format – oder – die ZipArchive, zu der dieser Eintrag gehört in eine Nur-Schreiben-Modus geöffnet wurde. |
| InvalidDataException | Der Eintrag aus dem Archiv fehlt oder ist beschädigt und kann nicht gelesen werden - oder - der Eintrag ist mit eine Komprimierungsmethode, die nicht unterstützt wird komprimiert. |
| ObjectDisposedException | Die ZipArchive, die dieser Posten gehört, wurde verworfen. |
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.