ZipArchive 類別

繼承階層架構

System.Object
  Microsoft.TeamFoundation.Server.Core.ZipArchive

命名空間：  Microsoft.TeamFoundation.Server.Core
組件：  Microsoft.TeamFoundation.Server.Core (在 Microsoft.TeamFoundation.Server.Core.dll 中)

語法

'宣告
Public Class ZipArchive _
    Implements IDisposable

public class ZipArchive : IDisposable

ZipArchive 類型會公開下列成員。

建構函式

	名稱	描述
	ZipArchive(Stream)	初始化 ZipArchive 新的執行個體會在指定的資料流讀取。
	ZipArchive(String)	開啟位於指定路徑的 ZipArchive 讀取。指定檔案開啟 FileMode.Open。
	ZipArchive(Stream, ZipArchiveMode)	初始化 ZipArchive 新的執行個體會在指定的資料流上以指定的模式。
	ZipArchive(String, ZipArchiveMode)	開啟位於指定路徑的 ZipArchive 在指定的 ZipArchiveMode 模式。
	ZipArchive(Stream, ZipArchiveMode, Boolean)	是否 ZipArchive 初始化新的執行個體會在指定的資料流上以指定的模式，指定讓資料流保持開啟。

回頁首

屬性

	名稱	描述
	Entries	目前在 ZipArchive 項目的集合。這可能不正確地表示存在於基礎檔案或資料流的實際項目。
	Mode	ZipArchiveMode ZipArchive 用來初始化此物件。

回頁首

方法

	名稱	描述
	CreateEntry(String)	具有指定之項目名稱的 zip 封存中建立空白項目。不需要項目名稱的限制。輸入的最後寫入時間設定為目前的時間。如果具有指定名稱的項目於項目已經存在，具有相同名稱的第二個輸入將建立。因為沒有指定 CompressionLevel ，將會使用基礎壓縮演算法的實作所提供的預設值; ZipArchive 不會強制其預設值。(目前， System.IO.Compression.DeflateStream 類別提供基本的壓縮演算法。)
	CreateEntry(String, CompressionLevel)	具有指定之項目名稱的 zip 封存中建立空白項目。不需要項目名稱的限制。輸入的最後寫入時間設定為目前的時間。如果具有指定名稱的項目於項目已經存在，具有相同名稱的第二個輸入將建立。
	CreateEntryFromFile(String, String)	從檔案系統將檔案加入至項目上指定的屬性名稱。新項目會包含在封存檔案的內容。封存項目上次寫入的時間設定為檔案的最後寫入時間在檔案系統中。如果具有指定名稱的項目於項目已經存在，具有相同名稱的第二個輸入將建立。如果指定的原始程式檔有無效的上次修改時間， zip 時間戳記格式 (1980 年 1 月 1 日午夜) 會使用第一個日期時間可以顯示。 如果具有指定名稱的項目於項目已經存在，具有相同名稱的第二個輸入將建立。因為沒有指定 CompressionLevel ，將會使用基礎壓縮演算法的實作所提供的預設值; ZipArchive 不會強制其預設值。(目前， System.IO.Compression.DeflateStream 類別提供基本的壓縮演算法。)
	CreateEntryFromFile(String, String, CompressionLevel)	從檔案系統將檔案加入至項目上指定的屬性名稱。新項目會包含在封存檔案的內容。封存項目上次寫入的時間設定為檔案的最後寫入時間在檔案系統中。如果具有指定名稱的項目於項目已經存在，具有相同名稱的第二個輸入將建立。如果指定的原始程式檔有無效的上次修改時間， zip 時間戳記格式 (1980 年 1 月 1 日午夜) 會使用第一個日期時間可以顯示。
	CreateFromDirectory(String, String)	在 sourceDirectoryName 指定目錄包含檔案和目錄 destinationArchive 路徑建立 zip 封存。目錄結構在封存，儲存，而且一次遞迴搜尋完成才能封存的檔案。封存不能存在。如果清單是空的，則會傳回空的封存中建立。如果目錄中的檔案無法加入至封存，封存會留下不完整，不正確的和方法會擲回例外狀況。這個方法不會在封存包含這個基底目錄。如果發生錯誤，在將檔案加入至項目時，這個方法會處於無效狀態將停止新增檔案並將封存留在。路徑可以指定相對或絕對的路徑資訊。相對路徑資訊會被解譯為與目前的工作目錄相對。如果檔案在封存中不是有效的 zip 時間戳記的最後寫入時間的資料欄位， 1980 年 1 月的值 1 日午夜會使用檔案的上次修改時間的指示器。 如果具有指定名稱的項目於項目已經存在，具有相同名稱的第二個輸入將建立。因為沒有指定 CompressionLevel ，將會使用基礎壓縮演算法的實作所提供的預設值; ZipArchive 不會強制其預設值。(目前， System.IO.Compression.DeflateStream 類別提供基本的壓縮演算法。)
	CreateFromDirectory(String, String, CompressionLevel, Boolean)	在 sourceDirectoryName 指定目錄包含檔案和目錄 destinationArchive 路徑建立 zip 封存。目錄結構在封存，儲存，而且一次遞迴搜尋完成才能封存的檔案。封存不能存在。如果清單是空的，則會傳回空的封存中建立。如果目錄中的檔案無法加入至封存，封存會留下不完整，不正確的和方法會擲回例外狀況。這個方法在封存選擇性包含這個基底目錄。如果發生錯誤，在將檔案加入至項目時，這個方法會處於無效狀態將停止新增檔案並將封存留在。路徑可以指定相對或絕對的路徑資訊。相對路徑資訊會被解譯為與目前的工作目錄相對。如果檔案在封存中不是有效的 zip 時間戳記的最後寫入時間的資料欄位， 1980 年 1 月的值 1 日午夜會使用檔案的上次修改時間的指示器。
	Dispose()	寫入 ZipArchive 使用的所有資源物件添加的封存和版本的結束，，除非物件建構時 leaveOpen 為 true。因為基礎資料流關閉，從開啟項目的所有資料流中開啟的 ZipArchive 將擲回在後續寫入的例外狀況。
	Dispose(Boolean)	ZipArchive 釋放使用的 Unmanaged 資源和選擇性地完成寫入封存並釋放 Managed 資源。
	Equals	判斷指定的物件是否等於目前物件。 (繼承自 Object)。
	ExtractToDirectory(String)	擷取所有檔案在保存到檔案系統上的目錄。指定的目錄不能存在。這個方法會建立所有子目錄和指定的目錄。如果發生錯誤，在擷取時封存，封存保持部分擷取。每個項目要擷取這類解壓縮檔案具有相同相對路徑做為輸入必須封存根目錄的 destinationDirectoryName。如果要封存的檔案有無效的上次修改時間， zip 時間戳記格式 (1980 年 1 月 1 日午夜) 會使用第一個日期時間可以顯示。
	ExtractToDirectory(String, String)	擷取所有位於指定的封存到檔案系統上的目錄。指定的目錄不能存在。這個方法會建立所有子目錄和指定的目錄。如果發生錯誤，在擷取時封存，封存保持部分擷取。每個項目要擷取這類解壓縮檔案具有相同相對路徑做為輸入必須封存的 destinationDirectoryName。路徑可以指定相對或絕對的路徑資訊。相對路徑資訊會被解譯為與目前的工作目錄相對。如果要封存的檔案有無效的上次修改時間， zip 時間戳記格式 (1980 年 1 月 1 日午夜) 會使用第一個日期時間可以顯示。
	Finalize	允許物件在記憶體回收進行回收之前，嘗試釋放資源並執行其他清除作業。 (繼承自 Object)。
	GetEntry	具有指定之名稱的封存擷取檔案項目的包裝函式。使用序數比較，名稱進行比較。如果有多個項目具有指定之名稱的封存，找到第一個會傳回。
	GetHashCode	做為預設雜湊函式。 (繼承自 Object)。
	GetType	取得目前執行個體的 Type。 (繼承自 Object)。
	MemberwiseClone	建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
	ToString	傳回表示目前物件的字串。 (繼承自 Object)。

回頁首

執行緒安全

這個類型的任何 Public static (在 Visual Basic 中為 Shared) 成員都是安全執行緒。不保證任何執行個體成員是安全執行緒。

請參閱

參考

Microsoft.TeamFoundation.Server.Core 命名空間