Partilhar via


Package.CreatePart Método

Definição

Cria uma nova parte do pacote.

Sobrecargas

CreatePart(Uri, String)

Cria uma nova parte descompactada com um URI e tipo de conteúdo específicos.

CreatePart(Uri, String, CompressionOption)

Cria uma nova parte com um URI, um tipo de conteúdo e uma opção de compactação específicos.

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 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)

Origem:
Package.cs
Origem:
Package.cs
Origem:
Package.cs
Origem:
Package.cs

Cria uma nova parte descompactada com um URI e tipo de conteúdo específicos.

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

A nova parte criada.

Exceções

partUri ou contentType é null.

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

Uma parte com o partUri especificado já existe no pacote.

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

O pacote é somente leitura (não é possível adicionar uma nova parte).

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)

Origem:
Package.cs
Origem:
Package.cs
Origem:
Package.cs
Origem:
Package.cs

Cria uma nova parte com um URI, um tipo de conteúdo e uma opção de compactação específicos.

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 do fluxo de dados, NotCompressed ou compactação Normal.

Retornos

A nova parte criada.

Exceções

partUri ou contentType é null.

partUri não é um URI (Uniform Resource Identifier) PackagePart válido.

Uma parte com o partUri especificado já existe no pacote.

O valor compressionOption não é válido.

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

O pacote é somente leitura (não é possível adicionar uma nova parte).

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ãoZipPackage, o método dá suporte apenas a CreatePart dois compressionOption valores ou NormalNotCompressed compactação. Outros CompressionOption valores de Maximum, Fastou SuperFast usam 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