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 Paketteil.
Überlädt
| Name | Beschreibung |
|---|---|
| CreatePart(Uri, String) |
Erstellt einen neuen nicht komprimierten Teil mit einem bestimmten URI und Inhaltstyp. |
| CreatePart(Uri, String, CompressionOption) |
Erstellt ein neues Teil mit einem bestimmten URI, Inhaltstyp und Komprimierungsoption. |
Beispiele
Das folgende Beispiel zeigt, wie Sie eine neue PackagePart Datei erstellen und dann Daten in dem Webpart 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 Element für den neuen Teil. Die PackagePart.GetStream Methode kann verwendet werden, um einen Verweis auf die Streaminstanz abzurufen, die dem Teil zugeordnet ist.
Weitere Informationen zu Paketteilen finden Sie in Abschnitt 1.1 der Open Packaging Conventions (OPC)-Spezifikation, die zum Download https://www.ecma-international.org/publications-and-standards/standards/ecma-376/verfügbar ist.
CreatePart(Uri, String)
- Quelle:
- Package.cs
- Quelle:
- Package.cs
- Quelle:
- Package.cs
- Quelle:
- Package.cs
- Quelle:
- Package.cs
- Quelle:
- Package.cs
- Quelle:
- Package.cs
- Quelle:
- Package.cs
Erstellt einen neuen nicht komprimierten Teil mit einem bestimmten 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 Teils.
- contentType
- String
Der Inhaltstyp des Datenstroms.
Gibt zurück
Der neu erstellte Teil.
Ausnahmen
partUri oder contentType ist null.
partUri ist kein gültiger PackagePart URI.
Ein Teil mit der angegebenen partUri Komponente ist bereits im Paket vorhanden.
Das Paket ist nicht geöffnet (Dispose(Boolean) oder Close() wurde aufgerufen).
Das Paket ist schreibgeschützt (ein neuer Teil kann nicht hinzugefügt werden).
Beispiele
Das folgende Beispiel zeigt, wie Sie eine neue PackagePart Datei erstellen und dann Daten in dem Webpart 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 Element für den neuen Teil. Die PackagePart.GetStream Methode kann verwendet werden, um einen Verweis auf die Streaminstanz abzurufen, die dem Teil zugeordnet ist.
Der Teil CompressionOption ist CompressionOption.NotCompressed.
Weitere Informationen zu Paketteilen finden Sie unter Abschnitt 1.1 in der Open Packaging Conventions (OPC)-Spezifikation, die zum Download https://www.ecma-international.org/publications-and-standards/standards/ecma-376/verfügbar ist.
Hinweise für Vererber
CreatePart(Uri, String) ruft intern die Methode der abgeleiteten Klasse CreatePartCore(Uri, String, CompressionOption) auf, um den Teil basierend auf dem in der abgeleiteten Klasse implementierten physischen Format zu erstellen.
Weitere Informationen
Gilt für:
CreatePart(Uri, String, CompressionOption)
- Quelle:
- Package.cs
- Quelle:
- Package.cs
- Quelle:
- Package.cs
- Quelle:
- Package.cs
- Quelle:
- Package.cs
- Quelle:
- Package.cs
- Quelle:
- Package.cs
- Quelle:
- Package.cs
Erstellt ein neues Teil mit einem bestimmten URI, Inhaltstyp und 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 Teils.
- contentType
- String
Der Inhaltstyp des Datenstroms.
- compressionOption
- CompressionOption
Die Komprimierungsoption für den Datenstrom NotCompressed oder Normal die Komprimierung.
Gibt zurück
Der neu erstellte Teil.
Ausnahmen
partUri oder contentType ist null.
partUri ist kein gültiger PackagePart URI (Uniform Resource Identifier).
Ein Teil mit der angegebenen partUri Komponente ist bereits im Paket vorhanden.
Der compressionOption Wert ist ungültig.
Das Paket ist nicht geöffnet (Dispose(Boolean) oder Close() wurde aufgerufen).
Das Paket ist schreibgeschützt (ein neuer Teil kann nicht hinzugefügt werden).
Beispiele
Das folgende Beispiel zeigt, wie Sie eine neue PackagePart Datei erstellen und dann Daten in dem Webpart 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 von der Standard ZipPackage abgeleitete Klasse unterstützt die CreatePart Methode nur zwei compressionOption Werte NotCompressed oder Normal Komprimierung. Andere CompressionOption Werte von Maximum, oder FastSuperFast verwenden KomprimierungNormal.
CreatePart erstellt einen leeren Stream Für den neuen Teil. Die PackagePart.GetStream Methode kann verwendet werden, um einen Verweis auf die Streaminstanz abzurufen, die dem Teil zugeordnet ist.
Weitere Informationen finden Sie in der Opc-Spezifikation (Open Packaging Conventions), die zum Download verfügbar https://www.ecma-international.org/publications-and-standards/standards/ecma-376/ist.
Hinweise für Vererber
CreatePart(Uri, String, CompressionOption) ruft intern die Methode der abgeleiteten Klasse CreatePartCore(Uri, String, CompressionOption) auf, um den Teil basierend auf dem in der abgeleiteten Klasse implementierten physischen Format zu erstellen.
