Package.CreatePart Método

Definição

Espaço de Nomes:
System.IO.Packaging
Assemblagem:
WindowsBase.dll

Cria uma nova parte do pacote.

Sobrecargas

Name Description
CreatePart(Uri, String)

Cria uma nova parte não comprimida com um determinado URI e tipo de conteúdo.
CreatePart(Uri, String, CompressionOption)

Cria uma nova peça com um determinado URI, tipo de conteúdo e opção de compressão.

Exemplos

O exemplo seguinte mostra como criar um novo PackagePart e depois armazenar dados na peça.

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

Observações

CreatePart inicializa um vazio Stream para a nova peça. O PackagePart.GetStream método pode ser usado para obter uma referência à instância do fluxo associada à peça.

Para mais informações sobre peças de embalagem, consulte a secção 1.1 da especificação Open Packaging Conventions (OPC) disponível para download em https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

CreatePart(Uri, String)

Cria uma nova parte não comprimida com um determinado URI e tipo de conteúdo.

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

Parâmetros

partUri
Uri

O identificador uniforme de recurso (URI) da nova peça.

contentType
String

O tipo de conteúdo do fluxo de dados.

Devoluções

PackagePart

A parte nova criada.

Exceções

ArgumentNullException

partUri ou contentType é null.

ArgumentException

partUri não é um URI válido PackagePart .

InvalidOperationException

Uma peça com o especificado partUri já está presente na embalagem.

ObjectDisposedException

O pacote não está aberto (Dispose(Boolean) ou Close() já foi chamado).

IOException

O pacote é apenas leitura (não pode ser adicionada uma nova parte).

Exemplos

O exemplo seguinte mostra como criar um novo PackagePart e depois armazenar dados na peça.

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

Observações

CreatePart inicializa um vazio Stream para a nova peça. O PackagePart.GetStream método pode ser usado para obter uma referência à instância do fluxo associada à peça.

A parte CompressionOption é CompressionOption.NotCompressed.

Para informações adicionais sobre peças de embalagem, consulte a secção 1.1 da especificação Open Packaging Conventions (OPC) disponível para download em https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Notas para Herdeiros

CreatePart(Uri, String) internamente chama o método da CreatePartCore(Uri, String, CompressionOption) classe derivada para realmente criar a peça com base no formato físico implementado na classe derivada.

Ver também

Aplica-se a

CreatePart(Uri, String, CompressionOption)

Cria uma nova peça com um determinado URI, tipo de conteúdo e opção de compressão.

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

Parâmetros

partUri
Uri

O URI da nova peça.

contentType
String

O tipo de conteúdo do fluxo de dados.

compressionOption
CompressionOption

A opção de compressão para o fluxo de dados, NotCompressed ou Normal compressão.

Devoluções

PackagePart

A parte nova criada.

Exceções

ArgumentNullException

partUri ou contentType é null.

ArgumentException

partUri não é um identificador uniforme de recurso (URI) válido PackagePart .

InvalidOperationException

Uma peça com o especificado partUri já está presente na embalagem.

ArgumentOutOfRangeException

O compressionOption valor não é válido.

ObjectDisposedException

O pacote não está aberto (Dispose(Boolean) ou Close() já foi chamado).

IOException

O pacote é apenas leitura (não pode ser adicionada uma nova parte).

Exemplos

O exemplo seguinte mostra como criar um novo PackagePart e depois armazenar dados na peça.

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

Observações

Para a classe derivada por defeito ZipPackage , o CreatePart método suporta apenas dois compressionOption valores, NotCompressed ou Normal compressão. Outros CompressionOption valores de Maximum, Fast, ou SuperFast usam Normal compressão.

CreatePart cria um vazio Stream para a nova peça. O PackagePart.GetStream método pode ser usado para obter uma referência à instância do fluxo associada à peça.

Para informações adicionais, consulte a especificação Open Packaging Conventions (OPC) disponível para download em https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Notas para Herdeiros

CreatePart(Uri, String, CompressionOption) internamente chama o método da CreatePartCore(Uri, String, CompressionOption) classe derivada para realmente criar a peça com base no formato físico implementado na classe derivada.

Ver também

Aplica-se a