Package.CreatePart Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vytvoří novou část balíčku.
Přetížení
| CreatePart(Uri, String) |
Vytvoří novou nekomprimovanou část s daným identifikátorem URI a typem obsahu. |
| CreatePart(Uri, String, CompressionOption) |
Vytvoří novou část s daným identifikátorem URI, typem obsahu a možností komprese. |
Příklady
Následující příklad ukazuje, jak vytvořit nový PackagePart a pak uložit data do části.
// 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.
Poznámky
CreatePart inicializuje prázdnou Stream pro novou část. Metodu PackagePart.GetStream lze použít k získání odkazu na instanci datového proudu přidružené k části.
Další informace o součástech balení najdete v části 1.1 specifikace Open Packaging Conventions (OPC), která je k dispozici ke stažení na adrese https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
CreatePart(Uri, String)
- Zdroj:
- Package.cs
- Zdroj:
- Package.cs
- Zdroj:
- Package.cs
- Zdroj:
- Package.cs
Vytvoří novou nekomprimovanou část s daným identifikátorem URI a typem obsahu.
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 PackagePartParametry
- partUri
- Uri
Identifikátor URI (Uniform Resource Identifier) nové části.
- contentType
- String
Typ obsahu datového streamu.
Návraty
Nově vytvořená část
Výjimky
partUri nebo contentType je null.
partUri není platný PackagePart identifikátor URI.
Část se zadaným parametrem partUri je již součástí balíčku.
Balíček není otevřený (Dispose(Boolean) nebo Close() byl volána).
Balíček je jen pro čtení (novou část nelze přidat).
Příklady
Následující příklad ukazuje, jak vytvořit nový PackagePart a pak uložit data do části.
// 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.
Poznámky
CreatePart inicializuje prázdnou Stream pro novou část. Metodu PackagePart.GetStream lze použít k získání odkazu na instanci datového proudu přidružené k části.
CompressionOption Část je CompressionOption.NotCompressed.
Další informace o součástech balení najdete v části 1.1 specifikace Open Packaging Conventions (OPC), která je k dispozici ke stažení na adrese https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Poznámky pro dědice
CreatePart(Uri, String) interně volá metodu odvozené třídy CreatePartCore(Uri, String, CompressionOption) skutečně vytvořit část na základě fyzického formátu implementovaného v odvozené třídě.
Viz také
Platí pro
CreatePart(Uri, String, CompressionOption)
- Zdroj:
- Package.cs
- Zdroj:
- Package.cs
- Zdroj:
- Package.cs
- Zdroj:
- Package.cs
Vytvoří novou část s daným identifikátorem URI, typem obsahu a možností komprese.
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 PackagePartParametry
- partUri
- Uri
Identifikátor URI nové části
- contentType
- String
Typ obsahu datového streamu.
- compressionOption
- CompressionOption
Možnost komprese datového streamu NotCompressed nebo Normal komprese.
Návraty
Nově vytvořená část
Výjimky
partUri nebo contentType je null.
partUri není platný PackagePart identifikátor URI (Uniform Resource Identifier).
Část se zadaným parametrem partUri je již součástí balíčku.
Hodnota compressionOption není platná.
Balíček není otevřený (Dispose(Boolean) nebo Close() byl volána).
Balíček je jen pro čtení (novou část nelze přidat).
Příklady
Následující příklad ukazuje, jak vytvořit nový PackagePart a pak uložit data do části.
// 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.
Poznámky
Pro výchozí ZipPackage odvozenou třídu CreatePart metoda podporuje pouze dvě compressionOption hodnoty, NotCompressed neboli Normal kompresi. Jiné CompressionOption hodnoty Maximum, Fastnebo SuperFast použijte Normal kompresi.
CreatePart vytvoří prázdnou Stream pro novou část. Metodu PackagePart.GetStream lze použít k získání odkazu na instanci datového proudu přidružené k části.
Další informace najdete ve specifikaci OPC (Open Packaging Conventions), která je k dispozici ke stažení na adrese https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Poznámky pro dědice
CreatePart(Uri, String, CompressionOption) interně volá metodu odvozené třídy CreatePartCore(Uri, String, CompressionOption) skutečně vytvořit část na základě fyzického formátu implementovaného v odvozené třídě.
