ZipArchiveEntry.ExtractToFile-Methode (String)
Erstellt eine Datei im Dateisystem mit dem Inhalt und den angegebenen Namen Eintrags. Das letzte schreiben Zeit der Datei wird festgelegt auf das letzte des Eintrags schreiben Zeit. Diese Methode lässt das Überschreiben einer vorhandenen Datei mit demselben Namen. Der Versuch, explizite Verzeichnisse (Einträge mit Namen, die in den Verzeichnistrennzeichen Beenden), zu extrahieren wird nicht die Erstellung eines Verzeichnisses.
Namespace: Microsoft.TeamFoundation.Server.Core
Assembly: Microsoft.TeamFoundation.Server.Core (in Microsoft.TeamFoundation.Server.Core.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 enthält.Der Pfad ist zulässig, um Informationen des absoluten oder relativen Pfad angeben.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, der Pfad enthält nur Leerzeichen, oder enthält mindestens ungültigen Zeichen, wie durch InvalidPathChars definiert. - oder destinationFileName wird ein Verzeichnis an. |
| ArgumentNullException | destinationFileName ist ungültig. |
| 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 aufweisen. |
| DirectoryNotFoundException | Der Pfad, der im destinationFileName angegeben wird, ist ungültig (beispielsweise, ist er auf einem nicht zugeordneten Laufwerk). |
| IOException | destinationFileName vorhanden ist. - oder ein E/A-Fehler ist aufgetreten. - oder der Eintrag ist zum Schreiben geöffnet. - oder der Eintrag ist aus dem Archiv gelöscht. |
| NotSupportedException | destinationFileName hat ein ungültiges Format - oder das ZipArchive, dass dieser Eintrag gehört, war in einem lesegeschützten Modus geöffnet. |
| InvalidDataException | Der Eintrag fehlt im Archiv oder ist beschädigt und kann nicht gelesen werden - oder der Eintrag ist mit einer Komprimierungsmethode komprimiert wurde, die nicht unterstützt wird. |
| ObjectDisposedException | Das ZipArchive, dass dieser Eintrag gehört, aufgehoben wurde. |
.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.