Udostępnij za pośrednictwem


Package.CreatePart Metoda

Definicja

Tworzy nową część pakietu.

Przeciążenia

CreatePart(Uri, String)

Tworzy nową nieskompresowaną część z danym identyfikatorem URI i typem zawartości.

CreatePart(Uri, String, CompressionOption)

Tworzy nową część z danym identyfikatorem URI, typem zawartości i opcją kompresji.

Przykłady

W poniższym przykładzie pokazano, jak utworzyć nowe PackagePart , a następnie zapisać dane w części.

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

Uwagi

CreatePart Inicjuje pusty element Stream dla nowej części. Metody PackagePart.GetStream można użyć do uzyskania odwołania do wystąpienia strumienia skojarzonego z częścią.

Aby uzyskać więcej informacji na temat części pakietów, zobacz sekcję 1.1 specyfikacji Open Packaging Conventions (OPC) dostępnej do pobrania na stronie https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

CreatePart(Uri, String)

Źródło:
Package.cs
Źródło:
Package.cs
Źródło:
Package.cs
Źródło:
Package.cs

Tworzy nową nieskompresowaną część z danym identyfikatorem URI i typem zawartości.

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

Jednolity identyfikator zasobu (URI) nowej części.

contentType
String

Typ zawartości strumienia danych.

Zwraca

Nowa utworzona część.

Wyjątki

partUri lub contentType ma wartość null.

partUri nie jest prawidłowym PackagePart identyfikatorem URI.

Część z określonym partUri elementem jest już obecna w pakiecie.

Pakiet nie jest otwarty (Dispose(Boolean) lub Close() został wywołany).

Pakiet jest tylko do odczytu (nie można dodać nowej części).

Przykłady

W poniższym przykładzie pokazano, jak utworzyć nowe PackagePart , a następnie zapisać dane w części.

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

Uwagi

CreatePart Inicjuje pusty element Stream dla nowej części. Metody PackagePart.GetStream można użyć do uzyskania odwołania do wystąpienia strumienia skojarzonego z częścią.

CompressionOption Część to CompressionOption.NotCompressed.

Aby uzyskać dodatkowe informacje o częściach pakietów, zobacz sekcję 1.1 w specyfikacji OPC (Open Packaging Conventions) dostępnej do pobrania pod adresem https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Uwagi dotyczące dziedziczenia

CreatePart(Uri, String) wewnętrznie wywołuje metodę klasy CreatePartCore(Uri, String, CompressionOption) pochodnej, aby rzeczywiście utworzyć część na podstawie formatu fizycznego zaimplementowanego w klasie pochodnej.

Zobacz też

Dotyczy

CreatePart(Uri, String, CompressionOption)

Źródło:
Package.cs
Źródło:
Package.cs
Źródło:
Package.cs
Źródło:
Package.cs

Tworzy nową część z danym identyfikatorem URI, typem zawartości i opcją kompresji.

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

Identyfikator URI nowej części.

contentType
String

Typ zawartości strumienia danych.

compressionOption
CompressionOption

Opcja kompresji strumienia NotCompressed danych lub Normal kompresji.

Zwraca

Nowa utworzona część.

Wyjątki

partUri lub contentType ma wartość null.

partUri nie jest prawidłowym PackagePart jednolitym identyfikatorem zasobu (URI).

Część z określonym partUri elementem jest już obecna w pakiecie.

Wartość jest nieprawidłowa compressionOption .

Pakiet nie jest otwarty (Dispose(Boolean) lub Close() został wywołany).

Pakiet jest tylko do odczytu (nie można dodać nowej części).

Przykłady

W poniższym przykładzie pokazano, jak utworzyć nowe PackagePart , a następnie zapisać dane w części.

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

Uwagi

W przypadku domyślnej ZipPackage klasy CreatePart pochodnej metoda obsługuje tylko dwie compressionOption wartości NotCompressed lub Normal kompresję. Inne CompressionOption wartości Maximum, Fastlub SuperFast używają Normal kompresji.

CreatePart Tworzy pustą Stream część dla nowej części. Metody PackagePart.GetStream można użyć do uzyskania odwołania do wystąpienia strumienia skojarzonego z częścią.

Aby uzyskać dodatkowe informacje, zobacz specyfikację Open Packaging Conventions (OPC) dostępną do pobrania na stronie https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Uwagi dotyczące dziedziczenia

CreatePart(Uri, String, CompressionOption) wewnętrznie wywołuje metodę klasy CreatePartCore(Uri, String, CompressionOption) pochodnej, aby rzeczywiście utworzyć część na podstawie formatu fizycznego zaimplementowanego w klasie pochodnej.

Zobacz też

Dotyczy