ZipArchive.CreateFromDirectory 方法 (String, String)
在 sourceDirectoryName 指定目錄包含檔案和目錄 destinationArchive 路徑建立 zip 封存。 目錄結構在封存，儲存，而且一次遞迴搜尋完成才能封存的檔案。 封存不能存在。 如果清單是空的，則會傳回空的封存中建立。 如果目錄中的檔案無法加入至封存，封存會留下不完整，不正確的和方法會擲回例外狀況。 這個方法不會在封存包含這個基底目錄。 如果發生錯誤，在將檔案加入至項目時，這個方法會處於無效狀態將停止新增檔案並將封存留在。 路徑可以指定相對或絕對的路徑資訊。 相對路徑資訊會被解譯為與目前的工作目錄相對。 如果檔案在封存中不是有效的 zip 時間戳記的最後寫入時間的資料欄位， 1980 年 1 月的值 1 日午夜會使用檔案的上次修改時間的指示器。
如果具有指定名稱的項目於項目已經存在，具有相同名稱的第二個輸入將建立。 因為沒有指定 CompressionLevel ，將會使用基礎壓縮演算法的實作所提供的預設值; ZipArchive 不會強制其預設值。(目前， System.IO.Compression.DeflateStream 類別提供基本的壓縮演算法。)
命名空間： Microsoft.TeamFoundation.Server.Core
組件： Microsoft.TeamFoundation.Server.Core (在 Microsoft.TeamFoundation.Server.Core.dll 中)
語法
'宣告
Public Shared Sub CreateFromDirectory ( _
sourceDirectoryName As String, _
destinationArchiveFileName As String _
)
public static void CreateFromDirectory(
string sourceDirectoryName,
string destinationArchiveFileName
)
參數
- sourceDirectoryName
類型：System.String
目錄的路徑在要封存的檔案系統。
- destinationArchiveFileName
類型：System.String
要建立之項目的名稱。
例外狀況
| 例外狀況 | 條件 |
|---|---|
| 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 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。