ZipArchive.CreateEntry Yöntem

Tanım

Ad Alanı:

System.IO.Compression

Bütünleştirilmiş Kod:

System.IO.Compression.dll

Zip arşivinde boş bir girdi oluşturur.

Aşırı Yüklemeler

CreateEntry(String)	Zip arşivinde belirtilen yola ve giriş adına sahip boş bir giriş oluşturur.
CreateEntry(String, CompressionLevel)	Zip arşivinde belirtilen giriş adına ve sıkıştırma düzeyine sahip boş bir giriş oluşturur.

CreateEntry(String)

Kaynak:

ZipArchive.cs

Zip arşivinde belirtilen yola ve giriş adına sahip boş bir giriş oluşturur.

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

Parametreler

entryName

String

Oluşturulacak girdinin adını belirten, arşivin köküne göre bir yol.

Döndürülenler

ZipArchiveEntry

Zip arşivinde boş bir girdi.

Özel durumlar

ArgumentException

entryName, Empty değeridir.

ArgumentNullException

entryName, null değeridir.

NotSupportedException

Zip arşivi yazmayı desteklemez.

ObjectDisposedException

Zip arşivi atıldı.

Örnekler

Aşağıdaki örnekte, bir girişin nasıl oluşturulacağı ve akış kullanılarak nasıl yazılabileceği gösterilmektedir.

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

Açıklamalar

Dize, entryName zip arşivinde oluşturmak istediğiniz girdinin göreli yolunu yansıtmalıdır. Sağladığınız dize üzerinde herhangi bir kısıtlama yoktur. Ancak, göreli yol olarak biçimlendirilmemişse, girdi oluşturulur, ancak zip arşivinin içeriğini ayıkladığınızda bir özel durum alabilirsiniz. Belirtilen yola ve ada sahip bir girdi arşivde zaten varsa, aynı yol ve ada sahip ikinci bir giriş oluşturulur.

Yeni girişin özelliğinin LastWriteTime değeri geçerli saate ayarlanır. Giriş, temel alınan sıkıştırma algoritmasının varsayılan sıkıştırma düzeyi kullanılarak sıkıştırılır. Farklı bir sıkıştırma düzeyi belirtmek istiyorsanız yöntemini kullanın CreateEntry .

CreateEntry(String, CompressionLevel)

Kaynak:

ZipArchive.cs

Zip arşivinde belirtilen giriş adına ve sıkıştırma düzeyine sahip boş bir giriş oluşturur.

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

Parametreler

entryName

String

Oluşturulacak girdinin adını belirten, arşivin köküne göre bir yol.

compressionLevel

CompressionLevel

Girişi oluştururken hızın mı yoksa sıkıştırma etkinliğinin mi vurgulandığını gösteren numaralandırma değerlerinden biri.

Döndürülenler

ZipArchiveEntry

Zip arşivinde boş bir girdi.

Özel durumlar

ArgumentException

entryName, Empty değeridir.

ArgumentNullException

entryName, null değeridir.

NotSupportedException

Zip arşivi yazmayı desteklemez.

ObjectDisposedException

Zip arşivi atıldı.

Örnekler

Aşağıdaki örnekte, en uygun sıkıştırma düzeyine sahip bir girişin nasıl oluşturulacağı gösterilmektedir. Ayrıca bir akış kullanarak yeni girişe yazar.

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

Açıklamalar

Dize, entryName zip arşivinde oluşturmak istediğiniz girdinin göreli yolunu yansıtmalıdır. Sağladığınız dize üzerinde herhangi bir kısıtlama yoktur. Ancak, göreli yol olarak biçimlendirilmemişse, girdi oluşturulur, ancak zip arşivinin içeriğini ayıkladığınızda bir özel durum alabilirsiniz. Belirtilen ada sahip bir girdi arşivde zaten varsa, aynı ada sahip ikinci bir giriş oluşturulur.

Yeni girişin özelliğinin LastWriteTime değeri geçerli saate ayarlanır. compressionLevel Dosyanın mümkün olduğunca çok sıkıştırılmasını istiyorsanız parametresini Optimal olarak ayarlayın. Parametresini compressionLevelFastest , yalnızca sıkıştırma işleminin senaryonuz için yeterince hızlı tamamlanmayacağı konusunda endişeleriniz varsa olarak ayarlayın.