Sdílet prostřednictvím


Package.CreatePart Metoda

Definice

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.PackagePart
Public Function CreatePart (partUri As Uri, contentType As String) As PackagePart

Parametry

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.PackagePart
Public Function CreatePart (partUri As Uri, contentType As String, compressionOption As CompressionOption) As PackagePart

Parametry

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ě.

Viz také

Platí pro