Package.CreatePart Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.PackagePartPublic Function CreatePart (partUri As Uri, contentType As String) As PackagePartParameter
- 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.PackagePartPublic Function CreatePart (partUri As Uri, contentType As String, compressionOption As CompressionOption) As PackagePartParameter
- 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.
