Package.CreatePart Methode

Definition

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.

// 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
Quelle:
Package.cs
Quelle:
Package.cs
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

Das neu erstellte Part.

Ausnahmen

partUri oder contentType ist null.

partUri ist kein gültiger PackagePart-URI.

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

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

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.

// 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

Gilt für:

CreatePart(Uri, String, CompressionOption)

Quelle:
Package.cs
Quelle:
Package.cs
Quelle:
Package.cs
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

Das neu erstellte Part.

Ausnahmen

partUri oder contentType ist null.

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

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

Der compressionOption-Wert ist nicht zulässig.

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

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.

// 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

Gilt für: