SharArchive.CreateEntry

CreateEntry(string, FileInfo, bool)

Einzelner Eintrag im Archiv erstellen.

public SharEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)
ParameterTypBeschreibung
nameStringDer Name des Eintrags.
fileInfoFileInfoDie Metadaten der zu komprimierenden Datei oder des Ordners.
openImmediatelyBooleanWahr, wenn die Datei sofort geöffnet wird, andernfalls die Datei beim Archivspeichern öffnen.

Rückgabewert

Instanz des Shar-Eintrags.

Ausnahmen

AusnahmeBedingung
ArgumentNullExceptionname ist Null.
ArgumentExceptionname ist leer.
ArgumentNullExceptionfileInfo ist Null.

Bemerkungen

Wird die Datei sofort mit geöffnetopenImmediatelyParameter wird es blockiert, bis das Archiv entsorgt wird.

Beispiele

FileInfo fileInfo = new FileInfo("data.bin");
using (var archive = new SharArchive())
{
    archive.CreateEntry("test.bin", fileInfo);
    archive.Save("archive.shar");
}

Siehe auch


CreateEntry(string, string, bool)

Einzelner Eintrag im Archiv erstellen.

public SharEntry CreateEntry(string name, string sourcePath, bool openImmediately = false)
ParameterTypBeschreibung
nameStringDer Name des Eintrags.
sourcePathStringPfad zur zu komprimierenden Datei.
openImmediatelyBooleanWahr, wenn die Datei sofort geöffnet wird, andernfalls die Datei beim Archivspeichern öffnen.

Rückgabewert

Instanz des Shar-Eintrags.

Ausnahmen

AusnahmeBedingung
ArgumentNullExceptionsourcePath ist Null.
SecurityExceptionDer Anrufer verfügt nicht über die erforderliche Zugriffsberechtigung.
ArgumentExceptionDersourcePath leer ist, nur Leerzeichen enthält oder ungültige Zeichen enthält. - oder - Dateiname, als Teil vonname, überschreitet 100 Symbole.
UnauthorizedAccessExceptionZugriff auf DateisourcePath ist abgelehnt.
PathTooLongExceptionDie angegebenesourcePath , Dateiname oder beide überschreiten die vom System definierte maximale Länge. Beispielsweise müssen auf Windows-basierten Plattformen Pfade weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen umfassen. - oder -name ist zu lang für Shar.
NotSupportedExceptionDatei untersourcePath enthält einen Doppelpunkt (:) in der Mitte der Zeichenfolge.

Bemerkungen

Der Eintragsname wird ausschließlich innerhalb gesetztname Parameter. Der Dateiname, der in bereitgestellt wirdsourcePath Parameter wirkt sich nicht auf den Eintragsnamen aus.

Wird die Datei sofort mit geöffnetopenImmediatelyParameter wird es blockiert, bis das Archiv entsorgt wird.

Beispiele

using (var archive = new SharArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.shar");
}

Siehe auch


CreateEntry(string, Stream)

Einzelner Eintrag im Archiv erstellen.

public SharEntry CreateEntry(string name, Stream source)
ParameterTypBeschreibung
nameStringDer Name des Eintrags.
sourceStreamDer Eingabestream für den Eintrag.

Rückgabewert

Instanz des Shar-Eintrags.

Ausnahmen

AusnahmeBedingung
ArgumentNullExceptionname ist Null.
ArgumentNullExceptionsource ist Null.
ArgumentExceptionname ist leer.

Beispiele

using (var archive = new SharArchive())
{
    archive.CreateEntry("data.bin", File.OpenRead("data.bin"));
    archive.Save("archive.shar");
}

Siehe auch