ZipArchive.CreateEntryFromFile-Methode (String, String, CompressionLevel)
Fügt einer Datei vom Dateisystem dem Archiv unter dem angegebenen Eintragsnamen hinzu. Der neue Eintrag im Archiv enthält den Inhalt der Datei. Das letzte schreiben Zeit des Archiveintrags wird festgelegt auf das letzte schreiben Zeit der Datei im Dateisystem. Wenn ein Eintrag mit dem angegebenen Namen bereits im Archiv vorhanden, wird ein zweiter Eintrag erstellt, die einen identischen Namen. Wenn die angegebene Quelldatei eine ungültige Zeitpunkt der letzten Änderung verfügt, wird das erste Datum-Zeit-darstellbare im ZIPtimestampformat (Mitternacht am 1. Januar 1980) verwendet.
Namespace: Microsoft.TeamFoundation.Server.Core
Assembly: Microsoft.TeamFoundation.Server.Core (in Microsoft.TeamFoundation.Server.Core.dll)
Syntax
'Declaration
Public Function CreateEntryFromFile ( _
sourceFileName As String, _
entryName As String, _
compressionLevel As CompressionLevel _
) As ZipArchiveEntry
public ZipArchiveEntry CreateEntryFromFile(
string sourceFileName,
string entryName,
CompressionLevel compressionLevel
)
Parameter
- sourceFileName
Typ: System.String
Der Pfad zur Datei auf dem von Dateisystem, kopiert werden.Der Pfad ist zulässig, um Informationen des absoluten oder relativen Pfad angeben.Relative Pfadinformationen werden relativ zum aktuellen Arbeitsverzeichnis interpretiert.
- entryName
Typ: System.String
Der Name des zu erstellenden Eintrags.
- compressionLevel
Typ: Microsoft.TeamFoundation.Server.Core.CompressionLevel
Das eine Komprimierungsebene (Geschwindigkeit/Arbeitsspeicher für komprimierten Größenkompromiß).
Rückgabewert
Typ: Microsoft.TeamFoundation.Server.Core.ZipArchiveEntry
Ein Wrapper für den neu erstellten Eintrag.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentException | sourceFileName 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 entryName ist eine Zeichenfolge der Länge 0 (null). |
| ArgumentNullException | sourceFileName oder entryName ist ungültig. |
| PathTooLongException | Im sourceFileName überschreiten der angegebene Pfad, Dateiname oder beide die systemdefinierte maximale Länge. Beispielsweise müssen Pfade auf Windows-Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen aufweisen. |
| DirectoryNotFoundException | Das angegebene sourceFileName ist ungültig, (beispielsweise, ist es für einen nicht zugeordneten Laufwerk). |
| IOException | Ein E/A-Fehler beim Öffnen der Datei, die von sourceFileName angegeben wurde. |
| UnauthorizedAccessException | sourceFileName wurde ein Verzeichnis an. - oder der Aufrufer verfügt nicht über die erforderliche Berechtigung. |
| FileNotFoundException | Die Datei, die im sourceFileName angegeben wurde, wurde nicht gefunden. |
| NotSupportedException | sourceFileName hat ein ungültiges Format, oder das ZipArchive unterstützt keine Schreibvorgänge. |
| ObjectDisposedException | Das ZipArchive ist bereits geschlossen. |
.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.