ZipFile.CreateFromDirectory Metódus

Definíció

Létrehoz egy zip-archívumot, amely a megadott könyvtár fájljait és könyvtárát tartalmazza.

Túlterhelések

Name Description
CreateFromDirectory(String, Stream)

Létrehoz egy zip-archívumot a megadott streamben, amely a megadott könyvtár fájljait és könyvtárát tartalmazza.

CreateFromDirectory(String, String)

Létrehoz egy zip-archívumot, amely a megadott könyvtár fájljait és könyvtárát tartalmazza.

CreateFromDirectory(String, Stream, CompressionLevel, Boolean)

Létrehoz egy zip-archívumot a megadott streamben, amely tartalmazza a megadott könyvtár fájljait és könyvtárát, a megadott tömörítési szintet használja, és opcionálisan az alapkönyvtárat is tartalmazza.

CreateFromDirectory(String, String, CompressionLevel, Boolean)

Létrehoz egy zip-archívumot, amely tartalmazza a megadott könyvtár fájljait és könyvtárát, a megadott tömörítési szintet használja, és opcionálisan az alapkönyvtárat is tartalmazza.

CreateFromDirectory(String, Stream, CompressionLevel, Boolean, Encoding)

Létrehoz egy zip-archívumot a megadott streamben, amely tartalmazza a megadott könyvtár fájljait és könyvtárait, a megadott tömörítési szintet és karakterkódolást használja a bejegyzésnevekhez és megjegyzésekhez, és opcionálisan tartalmazza az alapkönyvtárat is.

CreateFromDirectory(String, String, CompressionLevel, Boolean, Encoding)

Létrehoz egy zip-archívumot, amely tartalmazza a megadott könyvtár fájljait és könyvtárait, a megadott tömörítési szintet és karakterkódolást használja a bejegyzésnevekhez és megjegyzésekhez, és opcionálisan tartalmazza az alapkönyvtárat is.

CreateFromDirectory(String, Stream)

Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs

Létrehoz egy zip-archívumot a megadott streamben, amely a megadott könyvtár fájljait és könyvtárát tartalmazza.

public:
 static void CreateFromDirectory(System::String ^ sourceDirectoryName, System::IO::Stream ^ destination);
public static void CreateFromDirectory(string sourceDirectoryName, System.IO.Stream destination);
static member CreateFromDirectory : string * System.IO.Stream -> unit
Public Shared Sub CreateFromDirectory (sourceDirectoryName As String, destination As Stream)

Paraméterek

sourceDirectoryName
String

Az archiválandó könyvtár elérési útja relatív vagy abszolút elérési útként megadva. A relatív elérési út az aktuális munkakönyvtárhoz képest értelmezve van.

destination
Stream

Az a stream, amelyben a zip-archívumot tárolni kell.

Kivételek

sourceDirectoryName is Empty, csak üres szóközt tartalmaz, vagy legalább egy érvénytelen karaktert tartalmaz.

-vagy-

A destination stream nem támogatja az írást.

sourceDirectoryName vagy destination az null.

A sourceDirectoryNamemegadott elérési út, fájlnév vagy mindkettő meghaladja a rendszer által megadott maximális hosszt.

sourceDirectoryName érvénytelen vagy nem létezik (például egy nem leképezett meghajtón).

A megadott könyvtárban lévő fájl nem nyitható meg.

-vagy-

I/O-hiba történt az archiválni kívánt fájl megnyitásakor.

sourceDirectoryName érvénytelen formátumot tartalmaz.

Megjegyzések

A fájlrendszer könyvtárszerkezete megmarad az archívumban. Ha a könyvtár üres, egy üres archívum jön létre. Ez a metódus túlterhelés nem tartalmazza az alapkönyvtárat az archívumban, és nem teszi lehetővé a tömörítési szint megadását. Ha meg szeretné adni az alapkönyvtárat, vagy tömörítési szintet szeretne megadni, hívja meg a metódus túlterhelését CreateFromDirectory(String, Stream, CompressionLevel, Boolean) . Ha a könyvtárban lévő fájl nem vehető fel az archívumba, az archívum hiányos és érvénytelen marad, és a metódus kivételt IOException jelez.

A következőre érvényes:

CreateFromDirectory(String, String)

Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs

Létrehoz egy zip-archívumot, amely a megadott könyvtár fájljait és könyvtárát tartalmazza.

public:
 static void CreateFromDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationArchiveFileName);
public static void CreateFromDirectory(string sourceDirectoryName, string destinationArchiveFileName);
static member CreateFromDirectory : string * string -> unit
Public Shared Sub CreateFromDirectory (sourceDirectoryName As String, destinationArchiveFileName As String)

Paraméterek

sourceDirectoryName
String

Az archiválandó könyvtár elérési útja relatív vagy abszolút elérési útként megadva. A relatív elérési út az aktuális munkakönyvtárhoz képest értelmezve van.

destinationArchiveFileName
String

A létrehozandó archívum elérési útja relatív vagy abszolút elérési útként megadva. A relatív elérési út az aktuális munkakönyvtárhoz képest értelmezve van.

Kivételek

sourceDirectoryName vagy destinationArchiveFileName csak Emptyüres szóközt tartalmaz, vagy legalább egy érvénytelen karaktert tartalmaz.

sourceDirectoryName vagy destinationArchiveFileName az null.

sourceDirectoryNameA destinationArchiveFileName megadott elérési út, fájlnév vagy mindkettő meghaladja a rendszer által megadott maximális hosszt.

sourceDirectoryName érvénytelen vagy nem létezik (például egy nem leképezett meghajtón).

destinationArchiveFileName már létezik.

-vagy-

A megadott könyvtárban lévő fájl nem nyitható meg.

-vagy-

I/O-hiba történt az archiválni kívánt fájl megnyitásakor.

destinationArchiveFileName egy könyvtárat határoz meg.

-vagy-

A hívó nem rendelkezik a szükséges engedéllyel a megadott sourceDirectoryName könyvtár vagy a megadott destinationArchiveFileNamefájl eléréséhez.

sourceDirectoryName vagy destinationArchiveFileName érvénytelen formátumot tartalmaz.

-vagy-

A zip archívum nem támogatja az írást.

Példák

Ez a példa bemutatja, hogyan hozhat létre és nyerhet ki zip-archívumot az ZipFile osztály használatával. Tömöríti egy mappa tartalmát egy zip-archívumba, majd kinyeri a tartalmat egy új mappába. Az ZipFile osztály használatához hivatkoznia kell a System.IO.Compression.FileSystem projekt szerelvényére.

using System;
using System.IO.Compression;

class Program
{
    static void Main(string[] args)
    {
        string startPath = @".\start";
        string zipPath = @".\result.zip";
        string extractPath = @".\extract";

        ZipFile.CreateFromDirectory(startPath, zipPath);

        ZipFile.ExtractToDirectory(zipPath, extractPath);
    }
}
open System.IO.Compression

let startPath = @".\start"
let zipPath = @".\result.zip"
let extractPath = @".\extract"

ZipFile.CreateFromDirectory(startPath, zipPath)

ZipFile.ExtractToDirectory(zipPath, extractPath)
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim startPath As String = ".\start"
        Dim zipPath As String = ".\result.zip"
        Dim extractPath As String = ".\extract"

        ZipFile.CreateFromDirectory(startPath, zipPath)

        ZipFile.ExtractToDirectory(zipPath, extractPath)
    End Sub

End Module

Megjegyzések

A fájlrendszer könyvtárszerkezete megmarad az archívumban. Ha a könyvtár üres, egy üres archívum jön létre. Ez a metódus túlterhelés nem tartalmazza az alapkönyvtárat az archívumban, és nem teszi lehetővé a tömörítési szint megadását. Ha meg szeretné adni az alapkönyvtárat, vagy tömörítési szintet szeretne megadni, hívja meg a metódus túlterhelését CreateFromDirectory(String, String, CompressionLevel, Boolean) .

Ha az archívum már létezik, kivétel IOException keletkezik. Ha a megadott névvel rendelkező bejegyzés már létezik az archívumban, a második bejegyzés azonos névvel jön létre.

Ha a könyvtárban lévő fájl nem vehető fel az archívumba, az archívum hiányos és érvénytelen marad, és a metódus kivételt IOException jelez.

A következőre érvényes:

CreateFromDirectory(String, Stream, CompressionLevel, Boolean)

Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs

Létrehoz egy zip-archívumot a megadott streamben, amely tartalmazza a megadott könyvtár fájljait és könyvtárát, a megadott tömörítési szintet használja, és opcionálisan az alapkönyvtárat is tartalmazza.

public:
 static void CreateFromDirectory(System::String ^ sourceDirectoryName, System::IO::Stream ^ destination, System::IO::Compression::CompressionLevel compressionLevel, bool includeBaseDirectory);
public static void CreateFromDirectory(string sourceDirectoryName, System.IO.Stream destination, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory);
static member CreateFromDirectory : string * System.IO.Stream * System.IO.Compression.CompressionLevel * bool -> unit
Public Shared Sub CreateFromDirectory (sourceDirectoryName As String, destination As Stream, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean)

Paraméterek

sourceDirectoryName
String

Az archiválandó könyvtár elérési útja relatív vagy abszolút elérési útként megadva. A relatív elérési út az aktuális munkakönyvtárhoz képest értelmezve van.

destination
Stream

Az a stream, amelyben a zip-archívumot tárolni kell.

compressionLevel
CompressionLevel

Az egyik számbavételi érték, amely azt jelzi, hogy a bejegyzés létrehozásakor a sebesség vagy a tömörítés hatékonyságát kell-e hangsúlyozni.

includeBaseDirectory
Boolean

true a címtár nevét sourceDirectoryName az archívum gyökerétől kell megadni; false hogy csak a könyvtár tartalmát tartalmazza.

Kivételek

sourceDirectoryName is Empty, csak üres szóközt tartalmaz, vagy legalább egy érvénytelen karaktert tartalmaz.

-vagy-

A destination stream nem támogatja az írást.

sourceDirectoryName vagy destination az null.

A sourceDirectoryNamemegadott elérési út, fájlnév vagy mindkettő meghaladja a rendszer által megadott maximális hosszt.

sourceDirectoryName érvénytelen vagy nem létezik (például egy nem leképezett meghajtón).

A megadott könyvtárban lévő fájl nem nyitható meg.

-vagy-

I/O-hiba történt az archiválni kívánt fájl megnyitásakor.

sourceDirectoryName érvénytelen formátumot tartalmaz.

compressionLevel érvénytelen CompressionLevel érték.

Megjegyzések

A fájlrendszer könyvtárszerkezete megmarad az archívumban. Ha a könyvtár üres, egy üres archívum jön létre. Ezzel a metódussal megadhatja a tömörítési szintet, valamint azt, hogy az alapkönyvtárat belefoglalja-e az archívumba. Ha a könyvtárban lévő fájl nem vehető fel az archívumba, az archívum hiányos és érvénytelen marad, és a metódus kivételt IOException jelez.

A következőre érvényes:

CreateFromDirectory(String, String, CompressionLevel, Boolean)

Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs

Létrehoz egy zip-archívumot, amely tartalmazza a megadott könyvtár fájljait és könyvtárát, a megadott tömörítési szintet használja, és opcionálisan az alapkönyvtárat is tartalmazza.

public:
 static void CreateFromDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationArchiveFileName, System::IO::Compression::CompressionLevel compressionLevel, bool includeBaseDirectory);
public static void CreateFromDirectory(string sourceDirectoryName, string destinationArchiveFileName, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory);
static member CreateFromDirectory : string * string * System.IO.Compression.CompressionLevel * bool -> unit
Public Shared Sub CreateFromDirectory (sourceDirectoryName As String, destinationArchiveFileName As String, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean)

Paraméterek

sourceDirectoryName
String

Az archiválandó könyvtár elérési útja relatív vagy abszolút elérési útként megadva. A relatív elérési út az aktuális munkakönyvtárhoz képest értelmezve van.

destinationArchiveFileName
String

A létrehozandó archívum elérési útja relatív vagy abszolút elérési útként megadva. A relatív elérési út az aktuális munkakönyvtárhoz képest értelmezve van.

compressionLevel
CompressionLevel

Az egyik számbavételi érték, amely azt jelzi, hogy a bejegyzés létrehozásakor a sebesség vagy a tömörítés hatékonyságát kell-e hangsúlyozni.

includeBaseDirectory
Boolean

true a címtár nevét sourceDirectoryName az archívum gyökerétől kell megadni; false hogy csak a könyvtár tartalmát tartalmazza.

Kivételek

sourceDirectoryName vagy destinationArchiveFileName csak Emptyüres szóközt tartalmaz, vagy legalább egy érvénytelen karaktert tartalmaz.

sourceDirectoryName vagy destinationArchiveFileName az null.

sourceDirectoryNameA destinationArchiveFileName megadott elérési út, fájlnév vagy mindkettő meghaladja a rendszer által megadott maximális hosszt.

sourceDirectoryName érvénytelen vagy nem létezik (például egy nem leképezett meghajtón).

destinationArchiveFileName már létezik.

-vagy-

A megadott könyvtárban lévő fájl nem nyitható meg.

-vagy-

I/O-hiba történt az archiválni kívánt fájl megnyitásakor.

destinationArchiveFileName egy könyvtárat határoz meg.

-vagy-

A hívó nem rendelkezik a szükséges engedéllyel a megadott sourceDirectoryName könyvtár vagy a megadott destinationArchiveFileNamefájl eléréséhez.

sourceDirectoryName vagy destinationArchiveFileName érvénytelen formátumot tartalmaz.

-vagy-

A zip archívum nem támogatja az írást.

Példák

Ez a példa bemutatja, hogyan hozhat létre és nyerhet ki zip-archívumot az ZipFile osztály használatával. Tömöríti egy mappa tartalmát egy zip-archívumba, majd kinyeri a tartalmat egy új mappába. Az archívum tömörítésekor a rendszer tartalmazza az alapkönyvtárat, és a tömörítési szint úgy van beállítva, hogy a művelet sebessége nagyobb legyen a hatékonyságnál. Az ZipFile osztály használatához hivatkoznia kell a System.IO.Compression.FileSystem projekt szerelvényére.

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string startPath = @"c:\example\start";
            string zipPath = @"c:\example\result.zip";
            string extractPath = @"c:\example\extract";

            ZipFile.CreateFromDirectory(startPath, zipPath, CompressionLevel.Fastest, true);

            ZipFile.ExtractToDirectory(zipPath, extractPath);
        }
    }
}
open System.IO.Compression

let startPath = @"c:\example\start"
let zipPath = @"c:\example\result.zip"
let extractPath = @"c:\example\extract"

ZipFile.CreateFromDirectory(startPath, zipPath, CompressionLevel.Fastest, true)

ZipFile.ExtractToDirectory(zipPath, extractPath)
Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim startPath As String = "c:\example\start"
        Dim zipPath As String = "c:\example\result.zip"
        Dim extractPath As String = "c:\example\extract"

        ZipFile.CreateFromDirectory(startPath, zipPath, CompressionLevel.Fastest, True)

        ZipFile.ExtractToDirectory(zipPath, extractPath)
    End Sub

End Module

Megjegyzések

A fájlrendszer könyvtárszerkezete megmarad az archívumban. Ha a könyvtár üres, egy üres archívum jön létre. Ezzel a metódussal megadhatja a tömörítési szintet, valamint azt, hogy az alapkönyvtárat belefoglalja-e az archívumba.

Ha az archívum már létezik, kivétel IOException keletkezik. Ha a megadott névvel rendelkező bejegyzés már létezik az archívumban, a második bejegyzés azonos névvel jön létre.

Ha a könyvtárban lévő fájl nem vehető fel az archívumba, az archívum hiányos és érvénytelen marad, és a metódus kivételt IOException jelez.

A következőre érvényes:

CreateFromDirectory(String, Stream, CompressionLevel, Boolean, Encoding)

Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs

Létrehoz egy zip-archívumot a megadott streamben, amely tartalmazza a megadott könyvtár fájljait és könyvtárait, a megadott tömörítési szintet és karakterkódolást használja a bejegyzésnevekhez és megjegyzésekhez, és opcionálisan tartalmazza az alapkönyvtárat is.

public:
 static void CreateFromDirectory(System::String ^ sourceDirectoryName, System::IO::Stream ^ destination, System::IO::Compression::CompressionLevel compressionLevel, bool includeBaseDirectory, System::Text::Encoding ^ entryNameEncoding);
public static void CreateFromDirectory(string sourceDirectoryName, System.IO.Stream destination, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Text.Encoding? entryNameEncoding);
static member CreateFromDirectory : string * System.IO.Stream * System.IO.Compression.CompressionLevel * bool * System.Text.Encoding -> unit
Public Shared Sub CreateFromDirectory (sourceDirectoryName As String, destination As Stream, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, entryNameEncoding As Encoding)

Paraméterek

sourceDirectoryName
String

Az archiválandó könyvtár elérési útja relatív vagy abszolút elérési útként megadva. A relatív elérési út az aktuális munkakönyvtárhoz képest értelmezve van.

destination
Stream

Az a stream, amelyben a zip-archívumot tárolni kell.

compressionLevel
CompressionLevel

Az egyik számbavételi érték, amely azt jelzi, hogy a bejegyzés létrehozásakor a sebesség vagy a tömörítés hatékonyságát kell-e hangsúlyozni.

includeBaseDirectory
Boolean

true a címtár nevét sourceDirectoryName az archívum gyökerétől kell megadni; false hogy csak a könyvtár tartalmát tartalmazza.

entryNameEncoding
Encoding

Az archívumban lévő bejegyzésnevek és megjegyzések olvasásához vagy írásához használandó kódolás. Csak akkor adjon meg értéket ehhez a paraméterhez, ha kódolásra van szükség a bejegyzésnevek és megjegyzések UTF-8 kódolását nem támogató zip archív eszközökkel és kódtárakkal való együttműködéshez.

Kivételek

sourceDirectoryName is Empty, csak üres szóközt tartalmaz, vagy legalább egy érvénytelen karaktert tartalmaz.

-vagy-

A destination stream nem támogatja az írást.

sourceDirectoryName vagy destination az null.

A sourceDirectoryNamemegadott elérési út, fájlnév vagy mindkettő meghaladja a rendszer által megadott maximális hosszt.

sourceDirectoryName érvénytelen vagy nem létezik (például egy nem leképezett meghajtón).

A megadott könyvtárban lévő fájl nem nyitható meg.

-vagy-

I/O-hiba történt az archiválni kívánt fájl megnyitásakor.

sourceDirectoryName érvénytelen formátumot tartalmaz.

compressionLevel érvénytelen CompressionLevel érték.

Megjegyzések

A fájlrendszer könyvtárszerkezete megmarad az archívumban. Ha a könyvtár üres, egy üres archívum jön létre. Ezzel a metódussal megadhatja a tömörítési szintet és a karakterkódolást, valamint azt, hogy az alapkönyvtárat belefoglalja-e az archívumba. Ha a könyvtárban lévő fájl nem vehető fel az archívumba, az archívum hiányos és érvénytelen marad, és a metódus kivételt IOException jelez.

A következőre érvényes:

CreateFromDirectory(String, String, CompressionLevel, Boolean, Encoding)

Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs
Forrás:
ZipFile.Create.cs

Létrehoz egy zip-archívumot, amely tartalmazza a megadott könyvtár fájljait és könyvtárait, a megadott tömörítési szintet és karakterkódolást használja a bejegyzésnevekhez és megjegyzésekhez, és opcionálisan tartalmazza az alapkönyvtárat is.

public:
 static void CreateFromDirectory(System::String ^ sourceDirectoryName, System::String ^ destinationArchiveFileName, System::IO::Compression::CompressionLevel compressionLevel, bool includeBaseDirectory, System::Text::Encoding ^ entryNameEncoding);
public static void CreateFromDirectory(string sourceDirectoryName, string destinationArchiveFileName, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Text.Encoding entryNameEncoding);
public static void CreateFromDirectory(string sourceDirectoryName, string destinationArchiveFileName, System.IO.Compression.CompressionLevel compressionLevel, bool includeBaseDirectory, System.Text.Encoding? entryNameEncoding);
static member CreateFromDirectory : string * string * System.IO.Compression.CompressionLevel * bool * System.Text.Encoding -> unit
Public Shared Sub CreateFromDirectory (sourceDirectoryName As String, destinationArchiveFileName As String, compressionLevel As CompressionLevel, includeBaseDirectory As Boolean, entryNameEncoding As Encoding)

Paraméterek

sourceDirectoryName
String

Az archiválandó könyvtár elérési útja relatív vagy abszolút elérési útként megadva. A relatív elérési út az aktuális munkakönyvtárhoz képest értelmezve van.

destinationArchiveFileName
String

A létrehozandó archívum elérési útja relatív vagy abszolút elérési útként megadva. A relatív elérési út az aktuális munkakönyvtárhoz képest értelmezve van.

compressionLevel
CompressionLevel

Az egyik számbavételi érték, amely azt jelzi, hogy a bejegyzés létrehozásakor a sebesség vagy a tömörítés hatékonyságát kell-e hangsúlyozni.

includeBaseDirectory
Boolean

true a címtár nevét sourceDirectoryName az archívum gyökerétől kell megadni; false hogy csak a könyvtár tartalmát tartalmazza.

entryNameEncoding
Encoding

Az archívumban lévő bejegyzésnevek és megjegyzések olvasásához vagy írásához használandó kódolás. Csak akkor adjon meg értéket ehhez a paraméterhez, ha kódolásra van szükség a bejegyzésnevek és megjegyzések UTF-8 kódolását nem támogató zip archív eszközökkel és kódtárakkal való együttműködéshez.

Kivételek

sourceDirectoryName vagy destinationArchiveFileName csak Emptyüres szóközt tartalmaz, vagy legalább egy érvénytelen karaktert tartalmaz.

-vagy-

entryNameEncoding az UTF-8-tól eltérő Unicode-kódolásra van beállítva.

sourceDirectoryName vagy destinationArchiveFileName az null.

sourceDirectoryNameA destinationArchiveFileName megadott elérési út, fájlnév vagy mindkettő meghaladja a rendszer által megadott maximális hosszt.

sourceDirectoryName érvénytelen vagy nem létezik (például egy nem leképezett meghajtón).

destinationArchiveFileName már létezik.

-vagy-

A megadott könyvtárban lévő fájl nem nyitható meg.

-vagy-

I/O-hiba történt az archiválni kívánt fájl megnyitásakor.

destinationArchiveFileName egy könyvtárat határoz meg.

-vagy-

A hívó nem rendelkezik a szükséges engedéllyel a megadott sourceDirectoryName könyvtár vagy a megadott destinationArchiveFileNamefájl eléréséhez.

sourceDirectoryName vagy destinationArchiveFileName érvénytelen formátumot tartalmaz.

-vagy-

A zip archívum nem támogatja az írást.

Megjegyzések

A fájlrendszer könyvtárszerkezete megmarad az archívumban. Ha a könyvtár üres, egy üres archívum jön létre. Ezzel a metódussal megadhatja a tömörítési szintet és a karakterkódolást, valamint azt, hogy az alapkönyvtárat belefoglalja-e az archívumba.

Ha az archívum már létezik, kivétel IOException keletkezik. Ha a megadott névvel rendelkező bejegyzés már létezik az archívumban, a második bejegyzés azonos névvel jön létre.

Ha a könyvtárban lévő fájl nem vehető fel az archívumba, az archívum hiányos és érvénytelen marad, és a metódus kivételt IOException jelez.

Ha entryNameEncoding nem értékre nullvan beállítva, a bejegyzésnevek és megjegyzések kódolása a megadott kódolással történik. Ha a megadott kódolás egy UTF-8 kódolás, a nyelvi kódolás jelzője (a helyi fájlfejléc általános célú bitjelölőjében) minden bejegyzéshez be van állítva.

Ha entryNameEncoding be van állítva null, a bejegyzésnevek és a megjegyzések a következő szabályok szerint vannak kódolva:

  • Az ASCII-tartományon kívüli karaktereket tartalmazó bejegyzésnevekhez és megjegyzésekhez be van állítva a nyelvkódoló jelző, az UTF-8 pedig a bejegyzés nevének és megjegyzésének kódolására szolgál.

  • A csak ASCII-karaktereket tartalmazó bejegyzésnevek és megjegyzések esetében nincs beállítva a nyelvkódoló jelző, és a rendszer jelenlegi alapértelmezett kódlapja a bejegyzésnevek és megjegyzések kódolására szolgál.

A következőre érvényes: