ZipArchive.CreateEntryFromFile 方法 (String, String, CompressionLevel)

發行項
07/09/2014

從檔案系統將檔案加入至項目上指定的屬性名稱。新項目會包含在封存檔案的內容。封存項目上次寫入的時間設定為檔案的最後寫入時間在檔案系統中。如果具有指定名稱的項目於項目已經存在，具有相同名稱的第二個輸入將建立。如果指定的原始程式檔有無效的上次修改時間， zip 時間戳記格式 (1980 年 1 月 1 日午夜) 會使用第一個日期時間可以顯示。

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

語法

'宣告
Public Function CreateEntryFromFile ( _
    sourceFileName As String, _
    entryName As String, _
    compressionLevel As CompressionLevel _
) As ZipArchiveEntry

public ZipArchiveEntry CreateEntryFromFile(
    string sourceFileName,
    string entryName,
    CompressionLevel compressionLevel
)

參數

sourceFileName
類型：System.String
檔案的路徑包含檔案系統將複製。路徑可以指定相對或絕對的路徑資訊。相對路徑資訊會被解譯為與目前的工作目錄相對。

entryName
類型：System.String
要建立之項目的名稱。

compressionLevel
類型：Microsoft.TeamFoundation.Server.Core.CompressionLevel
壓縮 (速度/記憶體的層級對壓縮大小交易)。

傳回值

類型：Microsoft.TeamFoundation.Server.Core.ZipArchiveEntry
新建立的項目的包裝函式。

例外狀況

例外狀況	條件
ArgumentException	sourceFileName 是長度為零的字串、只包含空白字元，或包含一個或多個無效的字元 (如所定義 InvalidPathChars。-或- entryName 是長度為零的字串。
ArgumentNullException	sourceFileName 或 entryName 是空的。
PathTooLongException	在 sourceFileName，指定的路徑，檔案名稱或兩者都超過系統定義的最大長度。例如：在 Windows 平台上，路徑必須小於 248 字元，而檔案名稱必須小於 260 字元。
DirectoryNotFoundException	指定的 sourceFileName 無效， (例如，位於未對應的磁碟上)。
IOException	發生 I/O 錯誤，當開啟 sourceFileName 時指定的檔案。
UnauthorizedAccessException	sourceFileName 指定了目錄。-或-呼叫端沒有必要的使用權限。
FileNotFoundException	在 sourceFileName 指定的檔案找不到。
NotSupportedException	sourceFileName 的格式無效或 ZipArchive 不支援寫入。
ObjectDisposedException	ZipArchive 已經關閉。