Package.CreatePart Methode

Definition

Namespace:

System.IO.Packaging

Assembly:

System.IO.Packaging.dll

Paket:

System.IO.Packaging v8.0.0

Erstellt ein neues Paketpart.

Überlädt

CreatePart(Uri, String)	Erstellt ein neues unkomprimiertes Part mit einem angegebenen URI und Inhaltstyp.
CreatePart(Uri, String, CompressionOption)	Erstellt ein neues Part mit einem angegebenen URI, einem angegebenen Inhaltstyp und einer angegebenen Komprimierungsoption.

Beispiele

Das folgende Beispiel zeigt, wie Sie eine neue PackagePart erstellen und dann Daten im Teil speichern. Das vollständige Beispiel finden Sie unter Schreiben eines Paketbeispiels.

// Add the Document part to the Package
PackagePart packagePartDocument =
    package.CreatePart(partUriDocument,
                   System.Net.Mime.MediaTypeNames.Text.Xml);

// Copy the data to the Document Part
using (FileStream fileStream = new FileStream(
       documentPath, FileMode.Open, FileAccess.Read))
{
    CopyStream(fileStream, packagePartDocument.GetStream());
}// end:using(fileStream) - Close and dispose fileStream.

' Add the Document part to the Package
Dim packagePartDocument As PackagePart = package.CreatePart(partUriDocument, System.Net.Mime.MediaTypeNames.Text.Xml)

' Copy the data to the Document Part
Using fileStream As New FileStream(documentPath, FileMode.Open, FileAccess.Read)
    CopyStream(fileStream, packagePartDocument.GetStream())
End Using ' end:using(fileStream) - Close and dispose fileStream.

Hinweise

CreatePart initialisiert ein leeres Stream für das neue Teil. Die PackagePart.GetStream -Methode kann verwendet werden, um einen Verweis auf den Stream abzurufen, instance dem Teil zugeordnet sind.

Weitere Informationen zu Paketteilen finden Sie in Abschnitt 1.1 der OPC-Spezifikation (Open Packaging Conventions) zum Download unter https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

CreatePart(Uri, String)

Quelle:

Package.cs

Erstellt ein neues unkomprimiertes Part mit einem angegebenen URI und Inhaltstyp.

public:
 System::IO::Packaging::PackagePart ^ CreatePart(Uri ^ partUri, System::String ^ contentType);

public System.IO.Packaging.PackagePart CreatePart (Uri partUri, string contentType);

member this.CreatePart : Uri * string -> System.IO.Packaging.PackagePart

Public Function CreatePart (partUri As Uri, contentType As String) As PackagePart

Parameter

partUri

Uri

Der URI (Uniform Resource Identifier) des neuen Segments.

contentType

String

Der Inhaltstyp des Datenstreams.

Gibt zurück

PackagePart

Das neu erstellte Part.

Ausnahmen

ArgumentNullException

partUri oder contentType ist null.

ArgumentException

partUri ist kein gültiger PackagePart-URI.

InvalidOperationException

Im Paket ist bereits ein Part mit dem angegebenen partUri vorhanden.

ObjectDisposedException

Das Paket ist nicht geöffnet (Dispose(Boolean) oder Close() wurde aufgerufen).

IOException

Das Paket ist schreibgeschützt (es kann kein neues Part hinzugefügt werden).

Beispiele

Das folgende Beispiel zeigt, wie Sie eine neue PackagePart erstellen und dann Daten im Teil speichern. Das vollständige Beispiel finden Sie unter Schreiben eines Paketbeispiels.

// Add the Document part to the Package
PackagePart packagePartDocument =
    package.CreatePart(partUriDocument,
                   System.Net.Mime.MediaTypeNames.Text.Xml);

// Copy the data to the Document Part
using (FileStream fileStream = new FileStream(
       documentPath, FileMode.Open, FileAccess.Read))
{
    CopyStream(fileStream, packagePartDocument.GetStream());
}// end:using(fileStream) - Close and dispose fileStream.

' Add the Document part to the Package
Dim packagePartDocument As PackagePart = package.CreatePart(partUriDocument, System.Net.Mime.MediaTypeNames.Text.Xml)

' Copy the data to the Document Part
Using fileStream As New FileStream(documentPath, FileMode.Open, FileAccess.Read)
    CopyStream(fileStream, packagePartDocument.GetStream())
End Using ' end:using(fileStream) - Close and dispose fileStream.

Hinweise

CreatePart initialisiert ein leeres Stream für das neue Teil. Die PackagePart.GetStream -Methode kann verwendet werden, um einen Verweis auf den Stream abzurufen, instance dem Teil zugeordnet sind.

Der Teil CompressionOption ist CompressionOption.NotCompressed.

Weitere Informationen zu Paketteilen finden Sie in Abschnitt 1.1 der OPC-Spezifikation (Open Packaging Conventions) zum Download unter https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Hinweise für Vererber

CreatePart(Uri, String) ruft intern die Methode der abgeleiteten CreatePartCore(Uri, String, CompressionOption) Klasse auf, um das Teil tatsächlich basierend auf dem physischen Format zu erstellen, das in der abgeleiteten Klasse implementiert ist.

Weitere Informationen

• DeletePart(Uri)
• CreatePartUri(Uri)
• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)
• ZipPackagePart

CreatePart(Uri, String, CompressionOption)

Quelle:

Package.cs

Erstellt ein neues Part mit einem angegebenen URI, einem angegebenen Inhaltstyp und einer angegebenen Komprimierungsoption.

public:
 System::IO::Packaging::PackagePart ^ CreatePart(Uri ^ partUri, System::String ^ contentType, System::IO::Packaging::CompressionOption compressionOption);

public System.IO.Packaging.PackagePart CreatePart (Uri partUri, string contentType, System.IO.Packaging.CompressionOption compressionOption);

member this.CreatePart : Uri * string * System.IO.Packaging.CompressionOption -> System.IO.Packaging.PackagePart

Public Function CreatePart (partUri As Uri, contentType As String, compressionOption As CompressionOption) As PackagePart

Parameter

partUri

Uri

Der URI des neuen Segments.

contentType

String

Der Inhaltstyp des Datenstreams.

compressionOption

CompressionOption

Die Komprimierungsoption für den Datenstream, NotCompressed oder Normal-Komprimierung.

Gibt zurück

PackagePart

Das neu erstellte Part.

Ausnahmen

ArgumentNullException

partUri oder contentType ist null.

ArgumentException

partUri ist kein gültiger PackagePart-URI (Uniform Resource Identifier).

InvalidOperationException

Im Paket ist bereits ein Part mit dem angegebenen partUri vorhanden.

ArgumentOutOfRangeException

Der compressionOption-Wert ist nicht zulässig.

ObjectDisposedException

Das Paket ist nicht geöffnet (Dispose(Boolean) oder Close() wurde aufgerufen).

IOException

Das Paket ist schreibgeschützt (es kann kein neues Part hinzugefügt werden).

Beispiele

Das folgende Beispiel zeigt, wie Sie eine neue PackagePart erstellen und dann Daten im Teil speichern. Das vollständige Beispiel finden Sie unter Schreiben eines Paketbeispiels.

// Add the Document part to the Package
PackagePart packagePartDocument =
    package.CreatePart(partUriDocument,
                   System.Net.Mime.MediaTypeNames.Text.Xml);

// Copy the data to the Document Part
using (FileStream fileStream = new FileStream(
       documentPath, FileMode.Open, FileAccess.Read))
{
    CopyStream(fileStream, packagePartDocument.GetStream());
}// end:using(fileStream) - Close and dispose fileStream.

' Add the Document part to the Package
Dim packagePartDocument As PackagePart = package.CreatePart(partUriDocument, System.Net.Mime.MediaTypeNames.Text.Xml)

' Copy the data to the Document Part
Using fileStream As New FileStream(documentPath, FileMode.Open, FileAccess.Read)
    CopyStream(fileStream, packagePartDocument.GetStream())
End Using ' end:using(fileStream) - Close and dispose fileStream.

Hinweise

Für die abgeleitete Standardklasse ZipPackage unterstützt die CreatePart Methode nur zwei compressionOption Werte oder NotCompressedNormal die Komprimierung. Andere CompressionOption Werte von Maximum, Fastoder SuperFast verwenden Normal die Komprimierung.

CreatePart erstellt eine leere Stream für das neue Teil. Die PackagePart.GetStream -Methode kann verwendet werden, um einen Verweis auf den Stream abzurufen, instance dem Teil zugeordnet sind.

Weitere Informationen finden Sie in der OPC-Spezifikation (Open Packaging Conventions), die unter heruntergeladen werden https://www.ecma-international.org/publications-and-standards/standards/ecma-376/kann.

Hinweise für Vererber

CreatePart(Uri, String, CompressionOption) ruft intern die Methode der abgeleiteten CreatePartCore(Uri, String, CompressionOption) Klasse auf, um das Teil tatsächlich basierend auf dem physischen Format zu erstellen, das in der abgeleiteten Klasse implementiert ist.

Weitere Informationen

• DeletePart(Uri)
• CreatePartUri(Uri)
• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)
• ZipPackagePart