ZipArchive.CreateEntry Yöntem

Tanım

Ad Alanı:

System.IO.Compression

Bütünleştirilmiş Kodlar:

netstandard.dll, System.IO.Compression.dll

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

Aşırı Yüklemeler

Name	Description
CreateEntry(String)	Zip arşivinde belirtilen yolu ve giriş adını içeren boş bir girdi oluşturur.
CreateEntry(String, CompressionLevel)	Zip arşivinde belirtilen giriş adına ve sıkıştırma düzeyine sahip boş bir girdi oluşturur.

CreateEntry(String)

Kaynak:

ZipArchive.cs

Zip arşivinde belirtilen yolu ve giriş adını içeren boş bir girdi 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 girişin 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'e eşittir.

ArgumentNullException

entryName, null'e eşittir.

NotSupportedException

Zip arşivi yazmayı desteklemiyor.

ObjectDisposedException

Zip arşivi atıldı.

Örnekler

Aşağıdaki örnekte, bir girişin nasıl oluşturulacağı ve akış kullanılarak bu girdiye 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 durumla karşılaşabilirsiniz. Belirtilen yol ve ada sahip bir girdi arşivde zaten varsa, aynı yol ve ada sahip ikinci bir girdi oluşturulur.

Yeni girişin LastWriteTime özelliğinin 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 girdi 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 girişin adını belirten, arşivin köküne göre bir yol.

compressionLevel

CompressionLevel

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

Döndürülenler

ZipArchiveEntry

Zip arşivinde boş bir girdi.

Özel durumlar

ArgumentException

entryName, Empty'e eşittir.

ArgumentNullException

entryName, null'e eşittir.

NotSupportedException

Zip arşivi yazmayı desteklemiyor.

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 girdiye 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 durumla karşılaşabilirsiniz. Belirtilen ada sahip bir girdi arşivde zaten varsa, aynı ada sahip ikinci bir giriş oluşturulur.

Yeni girişin LastWriteTime özelliğinin değeri geçerli saate ayarlanır. compressionLevel Dosyanın mümkün olduğunca 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.