ZipArchive.CreateFromDirectory 方法 (String, String, CompressionLevel, Boolean)
在 sourceDirectoryName 指定目錄包含檔案和目錄 destinationArchive 路徑建立 zip 封存。 目錄結構在封存,儲存,而且一次遞迴搜尋完成才能封存的檔案。 封存不能存在。 如果清單是空的,則會傳回空的封存中建立。 如果目錄中的檔案無法加入至封存,封存會留下不完整,不正確的和方法會擲回例外狀況。 這個方法在封存選擇性包含這個基底目錄。 如果發生錯誤,在將檔案加入至項目時,這個方法會處於無效狀態將停止新增檔案並將封存留在。 路徑可以指定相對或絕對的路徑資訊。 相對路徑資訊會被解譯為與目前的工作目錄相對。 如果檔案在封存中不是有效的 zip 時間戳記的最後寫入時間的資料欄位, 1980 年 1 月的值 1 日午夜會使用檔案的上次修改時間的指示器。
命名空間: Microsoft.TeamFoundation.Server.Core
組件: Microsoft.TeamFoundation.Server.Core (在 Microsoft.TeamFoundation.Server.Core.dll 中)
語法
'宣告
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
)
參數
- sourceDirectoryName
類型:System.String
目錄的路徑在要封存的檔案系統。
- destinationArchiveFileName
類型:System.String
要建立之項目的名稱。
- compressionLevel
類型:Microsoft.TeamFoundation.Server.Core.CompressionLevel
壓縮 (速度/記憶體的層級對壓縮大小交易)。
- includeBaseDirectory
類型:System.Boolean
true 表示目錄名稱 sourceDirectoryName 應該是包含在項目的根。表示 false 直接在封存應包含檔案和目錄。sourceDirectoryName。
例外狀況
例外狀況 | 條件 |
---|---|
ArgumentException | sourceDirectoryName 或 destinationArchive 是長度為零的字串、只包含空白字元,或包含一個或多個無效的字元 (如所定義 InvalidPathChars。 |
ArgumentNullException | sourceDirectoryName 或 destinationArchive 是空的。 |
PathTooLongException | 在 sourceDirectoryName 或 destinationArchive,指定的路徑,檔案名稱或兩者都超過系統定義的最大長度。 例如:在 Windows 平台上,路徑必須小於 248 字元,而檔案名稱必須小於 260 字元。 |
DirectoryNotFoundException | destinationArchive 的路徑指定在 sourceDirectoryName 或無效, (例如,位於未對應的磁碟上)。-或- sourceDirectoryName 指定的目錄不存在。 |
IOException | destinationArchive 存在。-或- I/O 錯誤,當開啟要封存中的檔案。 |
UnauthorizedAccessException | destinationArchive 指定了目錄。-或-呼叫端沒有必要的使用權限。 |
NotSupportedException | sourceDirectoryName 或 destinationArchive 的格式無效。 |
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。