Package.CreatePart Metoda

Definice

Obor názvů:

System.IO.Packaging

Sestavení:

System.IO.Packaging.dll

Balíček:

System.IO.Packaging v8.0.0

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. Kompletní ukázku najdete v tématu Vytvoření ukázky balíčku.

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

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

PackagePart

Nově vytvořená část

Výjimky

ArgumentNullException

partUri nebo contentType je null.

ArgumentException

partUri není platný PackagePart identifikátor URI.

InvalidOperationException

Část se zadaným parametrem partUri je již součástí balíčku.

ObjectDisposedException

Balíček není otevřený (Dispose(Boolean) nebo Close() byl volána).

IOException

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. Kompletní ukázku najdete v tématu Vytvoření ukázky balíčku.

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

• DeletePart(Uri)
• CreatePartUri(Uri)
• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)
• ZipPackagePart

CreatePart(Uri, String, CompressionOption)

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

PackagePart

Nově vytvořená část

Výjimky

ArgumentNullException

partUri nebo contentType je null.

ArgumentException

partUri není platný PackagePart identifikátor URI (Uniform Resource Identifier).

InvalidOperationException

Část se zadaným parametrem partUri je již součástí balíčku.

ArgumentOutOfRangeException

Hodnota compressionOption není platná.

ObjectDisposedException

Balíček není otevřený (Dispose(Boolean) nebo Close() byl volána).

IOException

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. Kompletní ukázku najdete v tématu Vytvoření ukázky balíčku.

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

• DeletePart(Uri)
• CreatePartUri(Uri)
• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)
• ZipPackagePart