ZipFile.Open メソッド

ソース:

ZipFile.Create.cs

ソース:

ZipFile.Create.cs

ソース:

ZipFile.Create.cs

ソース:

ZipFile.Create.cs

ソース:

ZipFile.Create.cs

public:
 static System::IO::Compression::ZipArchive ^ Open(System::String ^ archiveFileName, System::IO::Compression::ZipArchiveMode mode);

public static System.IO.Compression.ZipArchive Open(string archiveFileName, System.IO.Compression.ZipArchiveMode mode);

static member Open : string * System.IO.Compression.ZipArchiveMode -> System.IO.Compression.ZipArchive

Public Shared Function Open (archiveFileName As String, mode As ZipArchiveMode) As ZipArchive

パラメーター

返品

開かれた zip アーカイブ。

例外

例

次の例は、更新モードで zip アーカイブを開き、アーカイブにエントリを追加する方法を示しています。

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

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string zipPath = @"c:\users\exampleuser\start.zip";
            string extractPath = @"c:\users\exampleuser\extract";
            string newFile = @"c:\users\exampleuser\NewFile.txt";

            using (ZipArchive archive = ZipFile.Open(zipPath, ZipArchiveMode.Update))
            {
                archive.CreateEntryFromFile(newFile, "NewEntry.txt");
                archive.ExtractToDirectory(extractPath);
            }
        }
    }
}

open System.IO.Compression

let zipPath = @"c:\users\exampleuser\start.zip"
let extractPath = @"c:\users\exampleuser\extract"
let newFile = @"c:\users\exampleuser\NewFile.txt"

do
    use archive = ZipFile.Open(zipPath, ZipArchiveMode.Update)
    archive.CreateEntryFromFile(newFile, "NewEntry.txt") |> ignore
    archive.ExtractToDirectory extractPath

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim zipPath As String = "c:\users\exampleuser\end.zip"
        Dim extractPath As String = "c:\users\exampleuser\extract"
        Dim newFile As String = "c:\users\exampleuser\NewFile.txt"

        Using archive As ZipArchive = ZipFile.Open(zipPath, ZipArchiveMode.Update)
            archive.CreateEntryFromFile(newFile, "NewEntry.txt", CompressionLevel.Fastest)
            archive.ExtractToDirectory(extractPath)
        End Using
    End Sub

End Module

注釈

mode パラメーターを Read に設定すると、ファイル モードの値としてOpen列挙体のFileModeでアーカイブが開かれます。 アーカイブが存在しない場合は、 FileNotFoundException 例外がスローされます。 mode パラメーターを Read に設定することは、OpenRead メソッドの呼び出しと同じです。

mode パラメーターを Create に設定すると、ファイル モード値としてFileMode.CreateNewでアーカイブが開かれます。 アーカイブが既に存在する場合は、 IOException がスローされます。

mode パラメーターを Update に設定すると、ファイル モード値としてFileMode.OpenOrCreateでアーカイブが開かれます。 アーカイブが存在する場合は開かれます。 既存のエントリを変更し、新しいエントリを作成できます。 アーカイブが存在しない場合は、新しいアーカイブが作成されます。ただし、 Update モードでの zip アーカイブの作成は、 Create モードでの作成ほど効率的ではありません。

ソース:

ZipFile.Create.cs

ソース:

ZipFile.Create.cs

ソース:

ZipFile.Create.cs

ソース:

ZipFile.Create.cs

ソース:

ZipFile.Create.cs

public:
 static System::IO::Compression::ZipArchive ^ Open(System::String ^ archiveFileName, System::IO::Compression::ZipArchiveMode mode, System::Text::Encoding ^ entryNameEncoding);

public static System.IO.Compression.ZipArchive Open(string archiveFileName, System.IO.Compression.ZipArchiveMode mode, System.Text.Encoding entryNameEncoding);

public static System.IO.Compression.ZipArchive Open(string archiveFileName, System.IO.Compression.ZipArchiveMode mode, System.Text.Encoding? entryNameEncoding);

static member Open : string * System.IO.Compression.ZipArchiveMode * System.Text.Encoding -> System.IO.Compression.ZipArchive

Public Shared Function Open (archiveFileName As String, mode As ZipArchiveMode, entryNameEncoding As Encoding) As ZipArchive

パラメーター

返品

開かれた zip アーカイブ。

例外

注釈

mode パラメーターを Read に設定すると、ファイル モード値としてFileMode.Openでアーカイブが開かれます。 アーカイブが存在しない場合は、 FileNotFoundException 例外がスローされます。 mode パラメーターを Read に設定することは、OpenRead メソッドの呼び出しと同じです。

mode パラメーターを Create に設定すると、ファイル モード値としてFileMode.CreateNewでアーカイブが開かれます。 アーカイブが既に存在する場合は、 IOException がスローされます。

mode パラメーターを Update に設定すると、ファイル モード値としてFileMode.OpenOrCreateでアーカイブが開かれます。 アーカイブが存在する場合は開かれます。 既存のエントリを変更し、新しいエントリを作成できます。 アーカイブが存在しない場合は、新しいアーカイブが作成されます。ただし、 Update モードでの zip アーカイブの作成は、 Create モードでの作成ほど効率的ではありません。

読み取り用の zip アーカイブ ファイルを開き、 entryNameEncoding が null に設定されている場合、エントリ名とコメントは次の規則に従ってデコードされます。

• 言語エンコード フラグ (ローカル ファイル ヘッダーの汎用ビット フラグ) が設定されていない場合、現在のシステムの既定のコード ページを使用してエントリ名とコメントをデコードします。
• 言語エンコード フラグが設定されている場合、UTF-8 を使用してエントリ名とコメントをデコードします。

読み取り用の zip アーカイブ ファイルを開き、 entryNameEncoding が null 以外の値に設定されている場合、エントリ名とコメントは次の規則に従ってデコードされます。

• 言語エンコード フラグが設定されていない場合は、指定した entryNameEncoding を使用してエントリ名とコメントをデコードします。
• 言語エンコード フラグが設定されている場合、UTF-8 を使用してエントリ名とコメントをデコードします。

アーカイブ ファイルに書き込み、 entryNameEncoding を null に設定すると、エントリ名とコメントは次の規則に従ってエンコードされます。

• ASCII 範囲外の文字を含むエントリ名またはコメントの場合、言語エンコード フラグが設定され、エントリ名とコメントは UTF-8 を使用してエンコードされます。
• ASCII 文字のみを含むエントリ名またはコメントの場合、言語エンコード フラグは設定されず、現在のシステムの既定のコード ページを使用してエントリ名とコメントがエンコードされます。

アーカイブ ファイルに書き込み、 entryNameEncoding が null 以外の値に設定されている場合、指定した entryNameEncoding を使用して、エントリ名とコメントをバイトにエンコードします。 言語エンコード フラグ (ローカル ファイル ヘッダーの汎用ビット フラグ) は、指定したエンコードが UTF-8 エンコードの場合にのみ設定されます。