ZipFile.OpenRead(String) Yöntem

Tanım

Ad Alanı:

System.IO.Compression

Bütünleştirilmiş Kod:

System.IO.Compression.ZipFile.dll

Kaynak:

ZipFile.Create.cs

Belirtilen yolda okumak için bir zip arşivi açar.

public:
 static System::IO::Compression::ZipArchive ^ OpenRead(System::String ^ archiveFileName);

public static System.IO.Compression.ZipArchive OpenRead (string archiveFileName);

static member OpenRead : string -> System.IO.Compression.ZipArchive

Public Shared Function OpenRead (archiveFileName As String) As ZipArchive

Parametreler

archiveFileName

String

Açılacak arşivin yolu, göreli veya mutlak yol olarak belirtilir. Göreli yol, geçerli çalışma dizinine göre yorumlanır.

Döndürülenler

ZipArchive

Açılan zip arşivi.

Özel durumlar

ArgumentException

archiveFileName , Emptyyalnızca boşluk içerir veya en az bir geçersiz karakter içerir.

ArgumentNullException

archiveFileName, null değeridir.

PathTooLongException

içinde archiveFileName, belirtilen yol, dosya adı veya her ikisi de sistem tanımlı uzunluk üst sınırını aşıyor.

DirectoryNotFoundException

archiveFileName geçersiz veya mevcut değil (örneğin, eşlenmemiş bir sürücüde).

IOException

archiveFileName açılamadı.

-veya-

Dosya açılırken belirtilmemiş bir G/Ç hatası oluştu.

UnauthorizedAccessException

archiveFileName bir dizin belirtir.

-veya-

Çağıranın içinde archiveFileNamebelirtilen dosyaya erişmek için gerekli izni yok.

FileNotFoundException

içinde archiveFileName belirtilen dosya bulunamadı.

NotSupportedException

archiveFileName geçersiz bir biçim içeriyor.

InvalidDataException

archiveFileName zip arşivi olarak yorumlanamadı.

Örnekler

Aşağıdaki örnekte, okuma için zip arşivini açma gösterilmektedir.

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

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

        Console.WriteLine("Provide path where to extract the zip file:");
        string extractPath = Console.ReadLine();

        // Normalizes the path.
        extractPath = Path.GetFullPath(extractPath);

        // Ensures that the last character on the extraction path
        // is the directory separator char.
        // Without this, a malicious zip file could try to traverse outside of the expected
        // extraction path.
        if (!extractPath.EndsWith(Path.DirectorySeparatorChar.ToString(), StringComparison.Ordinal))
            extractPath += Path.DirectorySeparatorChar;

        using (ZipArchive archive = ZipFile.OpenRead(zipPath))
        {
            foreach (ZipArchiveEntry entry in archive.Entries)
            {
                if (entry.FullName.EndsWith(".txt", StringComparison.OrdinalIgnoreCase))
                {
                    // Gets the full path to ensure that relative segments are removed.
                    string destinationPath = Path.GetFullPath(Path.Combine(extractPath, entry.FullName));

                    // Ordinal match is safest, case-sensitive volumes can be mounted within volumes that
                    // are case-insensitive.
                    if (destinationPath.StartsWith(extractPath, StringComparison.Ordinal))
                        entry.ExtractToFile(destinationPath);
                }
            }
        }
    }
}

open System
open System.IO;
open System.IO.Compression;

[<EntryPoint>]
let main _ =
    let zipPath = @".\result.zip"

    printfn "Provide path where to extract the zip file:"
    let extractPath = stdin.ReadLine();

    // Normalizes the path.
    let mutable extractPath = Path.GetFullPath extractPath

    // Ensures that the last character on the extraction path
    // is the directory separator char.
    // Without this, a malicious zip file could try to traverse outside of the expected
    // extraction path.
    if extractPath.EndsWith(Path.DirectorySeparatorChar.ToString(), StringComparison.Ordinal) |> not then
        extractPath <- extractPath + string Path.DirectorySeparatorChar

    use archive = ZipFile.OpenRead zipPath

    for entry in archive.Entries do
        if entry.FullName.EndsWith(".txt", StringComparison.OrdinalIgnoreCase) then
            // Gets the full path to ensure that relative segments are removed.
            let destinationPath = Path.GetFullPath(Path.Combine(extractPath, entry.FullName))

            // Ordinal match is safest, case-sensitive volumes can be mounted within volumes that
            // are case-insensitive.
            if destinationPath.StartsWith(extractPath, StringComparison.Ordinal) then
                entry.ExtractToFile destinationPath
    0

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim zipPath As String = ".\result.zip"

        Console.WriteLine("Provide path where to extract the zip file:")
        Dim extractPath As String = Console.ReadLine()

        ' Normalizes the path.
        extractPath = Path.GetFullPath(extractPath)

        ' Ensures that the last character on the extraction path
        ' is the directory separator char. 
        ' Without this, a malicious zip file could try to traverse outside of the expected
        ' extraction path.
        If Not extractPath.EndsWith(Path.DirectorySeparatorChar.ToString(), StringComparison.Ordinal) Then
            extractPath += Path.DirectorySeparatorChar
        End If

        Using archive As ZipArchive = ZipFile.OpenRead(zipPath)
            For Each entry As ZipArchiveEntry In archive.Entries
                If entry.FullName.EndsWith(".txt", StringComparison.OrdinalIgnoreCase) Then

                    ' Gets the full path to ensure that relative segments are removed.
                    Dim destinationPath As String = Path.GetFullPath(Path.Combine(extractPath, entry.FullName))
                    
                    ' Ordinal match is safest, case-sensitive volumes can be mounted within volumes that
                    ' are case-insensitive.
                    If destinationPath.StartsWith(extractPath, StringComparison.Ordinal) Then 
                        entry.ExtractToFile(destinationPath)
                    End If

                End If
            Next
        End Using
    End Sub

End Module

Açıklamalar

Bu yöntem, yöntemini çağırmak Open ve parametresini olarak ayarlamakla modeReadeşdeğerdir. Arşiv, dosya modu değeri olarak ile FileMode.Open açılır. Arşiv yoksa bir FileNotFoundException özel durum oluşturulur.