ZipArchive.CreateFromDirectory-Methode (String, String)
Die Pfad-DestinationArchive, die die Dateien und Verzeichnisse im Verzeichnis festgelegten SourceDirectoryName enthält erstellt ein Zip-Archiv. Die Verzeichnisstruktur wird im Archiv beibehalten, und eine rekursive Suche erfolgt für Dateien archiviert werden sollen. Das Archiv muss nicht vorhanden sein. Wenn das Verzeichnis leer ist, wird ein leeres Archiv erstellt.
Wenn eine Datei im Verzeichnis zum Archiv hinzugefügt werden kann, wird das Archiv bleibt unvollständig und ungültig und löst die Methode eine Ausnahme. Diese Methode beinhaltet nicht das Basisverzeichnis im Archiv.
Wenn beim Hinzufügen von Dateien in das Archiv ein Fehler aufgetreten ist, wird diese Methode keine weiteren Dateien und das Archiv in einem ungültigen Zustand belassen. Die Pfade dürfen relative oder absolute Pfadinformationen angegeben werden. Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert. Wenn eine Datei im Archiv Daten im Feld Letzte Schreibzugriff keine gültige Zip-Zeitstempel ist, wird eine Indikatorwert um Mitternacht 1. Januar 1980 für die Datei zuletzt geändert verwendet werden. Wenn ein Eintrag mit dem angegebenen Namen bereits im Archiv auftritt, wird ein zweiter Eintrag erstellt werden, die den gleichen Namen hat.
Da keine CompressionLevel angegeben wird, werden standardmäßig mit der Implementierung der zugrunde liegenden Komprimierungsalgorithmus verwendet; die ZipArchivewill, nicht über einen standardmäßigen auferlegen.
Die zugrunde liegende Kompressionsalgorithmus wird derzeit von der System.IO.Compression.DeflateStreamclass bereitgestellt.
Namespace: Microsoft.TeamFoundation.Framework.Server
Assembly: Microsoft.TeamFoundation.Framework.Server (in Microsoft.TeamFoundation.Framework.Server.dll)
Syntax
'Declaration
Public Shared Sub CreateFromDirectory ( _
sourceDirectoryName As String, _
destinationArchiveFileName As String _
)
public static void CreateFromDirectory(
string sourceDirectoryName,
string destinationArchiveFileName
)
Parameter
- sourceDirectoryName
Typ: System.String
Der Pfad des Verzeichnisses im Dateisystem archiviert werden sollen.
- destinationArchiveFileName
Typ: System.String
Der Name des Archivs erstellt werden.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentException | SourceDirectoryName oder DestinationArchive ist eine Zeichenfolge der Länge 0 (null), oder enthält nur Leerzeichen, er enthält ein oder mehrere ungültige Zeichen durch InvalidPathChars definiert. |
| ArgumentNullException | SourceDirectoryName oder DestinationArchive ist null. |
| PathTooLongException | SourceDirectoryName oder DestinationArchive überschreiten den angegebenen Pfad, Dateiname oder beide vom System definierte maximale Länge. Beispielsweise müssen Pfade auf Windows-Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen haben. |
| DirectoryNotFoundException | SourceDirectoryName oder DestinationArchive angegebene Pfad ungültig ist, (z. B. es ist auf einem nicht zugeordneten Laufwerk), oder durch SourceDirectoryName angegebene Verzeichnis ist nicht vorhanden. |
| IOException | DestinationArchive vorhanden ist, oder e/a-Fehler beim Öffnen Sie einer Datei archiviert werden sollen. |
| UnauthorizedAccessException | DestinationArchive hat ein Verzeichnis angegeben, oder der Aufrufer verfügt nicht über die erforderliche Berechtigung. |
| NotSupportedException | SourceDirectoryName oder DestinationArchive ist ein ungültiges Format. |
.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.