ZipArchive.CreateEntry 方法

定義

命名空間:

System.IO.Compression

組件:

System.IO.Compression.dll

建立 zip 封存中的空項目。

多載

CreateEntry(String)	在 zip 封存中建立具有指定之路徑和項目名稱的空項目。
CreateEntry(String, CompressionLevel)	在 zip 封存中建立具有指定之項目名稱和壓縮等級的空項目。

CreateEntry(String)

來源:

ZipArchive.cs

在 zip 封存中建立具有指定之路徑和項目名稱的空項目。

public:
 System::IO::Compression::ZipArchiveEntry ^ CreateEntry(System::String ^ entryName);

public System.IO.Compression.ZipArchiveEntry CreateEntry (string entryName);

member this.CreateEntry : string -> System.IO.Compression.ZipArchiveEntry

Public Function CreateEntry (entryName As String) As ZipArchiveEntry

參數

entryName

String

指定要建立之項目的名稱的路徑 (相對於封存的根目錄)。

傳回

ZipArchiveEntry

Zip 封存中的空項目。

例外狀況

ArgumentException

entryName 為 Empty。

ArgumentNullException

entryName 為 null。

NotSupportedException

Zip 封存不支援寫入。

ObjectDisposedException

Zip 封存已經處置。

範例

下列範例示範如何使用數據流來建立專案並寫入該專案。

using System;
using System.IO;
using System.IO.Compression;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            using (FileStream zipToOpen = new FileStream(@"c:\users\exampleuser\release.zip", FileMode.Open))
            {
                using (ZipArchive archive = new ZipArchive(zipToOpen, ZipArchiveMode.Update))
                {
                    ZipArchiveEntry readmeEntry = archive.CreateEntry("Readme.txt");
                    using (StreamWriter writer = new StreamWriter(readmeEntry.Open()))
                    {
                            writer.WriteLine("Information about this package.");
                            writer.WriteLine("========================");
                    }
                }
            }
        }
    }
}

open System.IO
open System.IO.Compression

do
    use zipToOpen = new FileStream(@"c:\users\exampleuser\release.zip", FileMode.Open)

    use archive = new ZipArchive(zipToOpen, ZipArchiveMode.Update)

    let readmeEntry = archive.CreateEntry "Readme.txt"
    use writer = new StreamWriter(readmeEntry.Open())

    writer.WriteLine "Information about this package."
    writer.WriteLine "========================"

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Using zipToOpen As FileStream = New FileStream("c:\users\exampleuser\release.zip", FileMode.Open)
            Using archive As ZipArchive = New ZipArchive(zipToOpen, ZipArchiveMode.Update)
                Dim readmeEntry As ZipArchiveEntry = archive.CreateEntry("Readme.txt")
                Using writer As StreamWriter = New StreamWriter(readmeEntry.Open())
                    writer.WriteLine("Information about this package.")
                    writer.WriteLine("========================")
                End Using
            End Using
        End Using
    End Sub

End Module

備註

字串 entryName 應該反映您想要在 zip 封存內建立之項目的相對路徑。 您提供的字串沒有限制。 不過，如果未將它格式化為相對路徑，則會建立專案，但當您擷取 zip 封存的內容時，可能會發生例外狀況。 如果具有指定路徑和名稱的專案已存在於封存中，則會使用相同的路徑和名稱建立第二個專案。

LastWriteTime新項目的 屬性值會設定為目前時間。 專案會使用基礎壓縮演算法的默認壓縮層級進行壓縮。 如果您想要指定不同的壓縮層級，請使用 CreateEntry 方法。

CreateEntry(String, CompressionLevel)

來源:

ZipArchive.cs

在 zip 封存中建立具有指定之項目名稱和壓縮等級的空項目。

public:
 System::IO::Compression::ZipArchiveEntry ^ CreateEntry(System::String ^ entryName, System::IO::Compression::CompressionLevel compressionLevel);

public System.IO.Compression.ZipArchiveEntry CreateEntry (string entryName, System.IO.Compression.CompressionLevel compressionLevel);

member this.CreateEntry : string * System.IO.Compression.CompressionLevel -> System.IO.Compression.ZipArchiveEntry

Public Function CreateEntry (entryName As String, compressionLevel As CompressionLevel) As ZipArchiveEntry

參數

entryName

String

指定要建立之項目的名稱的路徑 (相對於封存的根目錄)。

compressionLevel

CompressionLevel

其中一個列舉值，指出當建立項目時是否要強調速度或壓縮的效益。

傳回

ZipArchiveEntry

Zip 封存中的空項目。

例外狀況

ArgumentException

entryName 為 Empty。

ArgumentNullException

entryName 為 null。

NotSupportedException

Zip 封存不支援寫入。

ObjectDisposedException

Zip 封存已經處置。

範例

下列範例示範如何建立具有最佳壓縮層級的專案。 它也會使用數據流寫入新專案。

using System;
using System.IO;
using System.IO.Compression;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            using (FileStream zipToOpen = new FileStream(@"c:\users\exampleuser\release.zip", FileMode.Open))
            {
                using (ZipArchive archive = new ZipArchive(zipToOpen, ZipArchiveMode.Update))
                {
                    ZipArchiveEntry readmeEntry = archive.CreateEntry("Readme.txt", CompressionLevel.Optimal);
                    using (StreamWriter writer = new StreamWriter(readmeEntry.Open()))
                    {
                            writer.WriteLine("Information about this package.");
                            writer.WriteLine("========================");
                    }
                }
            }
        }
    }
}

open System.IO
open System.IO.Compression

do
    use zipToOpen = new FileStream(@"c:\users\exampleuser\release.zip", FileMode.Open)

    use archive = new ZipArchive(zipToOpen, ZipArchiveMode.Update)

    let readmeEntry = archive.CreateEntry("Readme.txt", CompressionLevel.Optimal)
    use writer = new StreamWriter(readmeEntry.Open())

    writer.WriteLine "Information about this package."
    writer.WriteLine "========================"

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Using zipToOpen As FileStream = New FileStream("c:\users\exampleuser\release.zip", FileMode.Open)
            Using archive As ZipArchive = New ZipArchive(zipToOpen, ZipArchiveMode.Update)
                Dim readmeEntry As ZipArchiveEntry = archive.CreateEntry("Readme.txt", CompressionLevel.Optimal)
                Using writer As StreamWriter = New StreamWriter(readmeEntry.Open())
                    writer.WriteLine("Information about this package.")
                    writer.WriteLine("========================")
                End Using
            End Using
        End Using
    End Sub

End Module

備註

字串 entryName 應該反映您想要在 zip 封存內建立之項目的相對路徑。 您提供的字串沒有限制。 不過，如果未將它格式化為相對路徑，則會建立專案，但當您擷取 zip 封存的內容時，可能會發生例外狀況。 如果具有指定名稱的專案已存在於封存中，則會使用相同的名稱建立第二個專案。

LastWriteTime新項目的 屬性值會設定為目前時間。 compressionLevel如果您要盡可能壓縮檔案，請將 參數Optimal設定為 。 compressionLevel只有在您擔心壓縮作業無法快速完成案例時，才將 參數Fastest設定為 。