Package.CreatePart Método

Definição

Namespace:
System.IO.Packaging
Assembly:
WindowsBase.dll

Cria uma nova parte do pacote.

Sobrecargas

Nome Description
CreatePart(Uri, String)

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

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

Exemplos

O exemplo a seguir mostra como criar um novo PackagePart e, em seguida, armazenar dados na parte.

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

Comentários

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

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

CreatePart(Uri, String)

Cria uma nova parte descompactada com um determinado URI e um 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 URI (uniform resource identifier) da nova parte.

contentType
String

O tipo de conteúdo do fluxo de dados.

Retornos

PackagePart

A nova parte criada.

Exceções

ArgumentNullException

partUri ou contentType é null.

ArgumentException

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

InvalidOperationException

Uma parte com o especificado partUri já está presente no pacote.

ObjectDisposedException

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

IOException

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

Exemplos

O exemplo a seguir mostra como criar um novo PackagePart e, em seguida, armazenar dados na parte.

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

Comentários

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

A parte CompressionOption é CompressionOption.NotCompressed.

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

Notas aos Herdeiros

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

Confira também

Aplica-se a

CreatePart(Uri, String, CompressionOption)

Cria uma nova parte 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 parte.

contentType
String

O tipo de conteúdo do fluxo de dados.

compressionOption
CompressionOption

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

Retornos

PackagePart

A nova parte criada.

Exceções

ArgumentNullException

partUri ou contentType é null.

ArgumentException

partUri não é um URI (uniform resource identifier) válido PackagePart .

InvalidOperationException

Uma parte com o especificado partUri já está presente no pacote.

ArgumentOutOfRangeException

O compressionOption valor não é válido.

ObjectDisposedException

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

IOException

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

Exemplos

O exemplo a seguir mostra como criar um novo PackagePart e, em seguida, armazenar dados na parte.

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

Comentários

Para a classe derivada padrão ZipPackage , o CreatePart método dá suporte apenas a dois compressionOption valores NotCompressed ou Normal compactação. Outros CompressionOption valores de Maximum, Fastou SuperFast usar Normal compactação.

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

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

Notas aos Herdeiros

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

Confira também

Aplica-se a