Package.CreatePart Metoda

Definicja

Przestrzeń nazw:

System.IO.Packaging

Zestaw:

System.IO.Packaging.dll

Pakiet:

System.IO.Packaging v9.0.0-preview.3.24172.9

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

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

PackagePart

Nowa utworzona część.

Wyjątki

ArgumentNullException

partUri lub contentType ma wartość null.

ArgumentException

partUri nie jest prawidłowym PackagePart identyfikatorem URI.

InvalidOperationException

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

ObjectDisposedException

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

IOException

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ż

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

CreatePart(Uri, String, CompressionOption)

Ź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

PackagePart

Nowa utworzona część.

Wyjątki

ArgumentNullException

partUri lub contentType ma wartość null.

ArgumentException

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

InvalidOperationException

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

ArgumentOutOfRangeException

Wartość jest nieprawidłowa compressionOption .

ObjectDisposedException

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

IOException

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ż

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