ZipArchiveEntry.FullName Eigenschaft

Definition

Namespace:

System.IO.Compression

Assembly:

System.IO.Compression.dll

Quelle:

ZipArchiveEntry.cs

Ruft den relativen Pfad des Eintrags im ZIP-Archiv ab.

C#

public string FullName { get; }

Eigenschaftswert

String

Der relative Pfad des Eintrags im Zip-Archiv.

Hinweise

Die FullName -Eigenschaft enthält den relativen Pfad einschließlich der Unterverzeichnishierarchie eines Eintrags in einem ZIP-Archiv. (Im Gegensatz dazu enthält die Name -Eigenschaft nur den Namen des Eintrags und nicht die Unterverzeichnishierarchie.) Wenn Sie beispielsweise zwei Einträge in einem ZIP-Archiv mithilfe der CreateEntryFromFile -Methode erstellen und als Namen für den ersten Eintrag und AddedFolder\\NewEntry.txt für den zweiten Eintrag angebenNewEntry.txt, werden NewEntry.txt beide Einträge in der Name -Eigenschaft enthalten. Der erste Eintrag enthält ebenfalls NewEntry.txt in der FullName -Eigenschaft, aber der zweite Eintrag wird in der FullName -Eigenschaft enthalten AddedFolder\\NewEntry.txt sein.

Sie können eine beliebige Zeichenfolge als Pfad eines Eintrags angeben, einschließlich Zeichenfolgen, die ungültige und absolute Pfade angeben. Daher kann die FullName -Eigenschaft einen Wert enthalten, der nicht ordnungsgemäß formatiert ist. Ein ungültiger oder absoluter Pfad kann zu einer Ausnahme führen, wenn Sie den Inhalt des ZIP-Archivs extrahieren.

Beispiele

Das folgende Beispiel zeigt, wie Sie den Inhalt einer .zip-Datei durchlaufen und Dateien extrahieren, die die erweiterung .txt enthalten.

C#

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);
                }
            }
        }
    }
}

Gilt für: