ZipArchive.CreateFromDirectory-Methode (String, String, CompressionLevel, Boolean)
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 schließt das Basisverzeichnis optional in das 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.
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, _
compressionLevel As CompressionLevel, _
includeBaseDirectory As Boolean _
)
public static void CreateFromDirectory(
string sourceDirectoryName,
string destinationArchiveFileName,
CompressionLevel compressionLevel,
bool includeBaseDirectory
)
Parameter
- sourceDirectoryName
Typ: System.String
Der Pfad des Verzeichnisses im Dateisystem archiviert werden sollen.
- destinationArchiveFileName
Typ: System.String
Der Name des Archivs erstellt werden.
- compressionLevel
Typ: Microsoft.TeamFoundation.Framework.Server.CompressionLevel
Die Komprimierungsebene (Speed-Speicher-VS. Größe Kompromiss komprimiert).
- includeBaseDirectory
Typ: System.Boolean
True, um anzugeben, dass ein Verzeichnis namens SourceDirectoryName im Stammverzeichnis des Archivs eingeschlossen werden sollen.False, um anzugeben, dass die Dateien und Verzeichnisse in SourceDirectoryName direkt in das Archiv aufgenommen werden sollten.
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.