Package.CreatePart Metoda

Definice

Obor názvů:

System.IO.Packaging

Sestavení:

System.IO.Packaging.dll

Balíček:

System.IO.Packaging v11.0.0-preview.5.26302.115

Vytvoří novou část balíčku.

Přetížení

Name	Description
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 streamu přidruženou k této části.

Další informace o součástech balení naleznete v části 1.1 specifikace Open Packaging Conventions (OPC) 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 zadanou partUri částí již v balíčku existuje.

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.

// 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 streamu přidruženou k této části.

CompressionOption Část je CompressionOption.NotCompressed.

Další informace o součástech balení naleznete v části 1.1 specifikace Open Packaging Conventions (OPC) 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 CreatePartCore(Uri, String, CompressionOption) odvozené třídy, která skutečně vytvoří čá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 zadanou partUri částí již v balíčku existuje.

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.

// 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 nebo Normal kompresi. Jiné CompressionOption hodnoty Maximum, Fastnebo SuperFast použít Normal kompresi.

CreatePart vytvoří prázdnou Stream pro novou část. Metodu PackagePart.GetStream lze použít k získání odkazu na instanci streamu přidruženou k této části.

Další informace naleznete ve specifikaci OPC (Open Packaging Conventions) 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 CreatePartCore(Uri, String, CompressionOption) odvozené třídy, která skutečně vytvoří čá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