Package.CreatePart Método

Definição

Namespace:

System.IO.Packaging

Assembly:

System.IO.Packaging.dll

Pacote:

System.IO.Packaging v8.0.0

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 . Para obter o exemplo completo, consulte Escrevendo um exemplo de pacote.

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

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

PackagePart

A nova parte criada.

Exceções

ArgumentNullException

partUri ou contentType é null.

ArgumentException

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

InvalidOperationException

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

ObjectDisposedException

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

IOException

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 . Para obter o exemplo completo, consulte Escrevendo um exemplo de pacote.

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

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

CreatePart(Uri, String, CompressionOption)

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

PackagePart

A nova parte criada.

Exceções

ArgumentNullException

partUri ou contentType é null.

ArgumentException

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

InvalidOperationException

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

ArgumentOutOfRangeException

O valor compressionOption não é válido.

ObjectDisposedException

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

IOException

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 . Para obter o exemplo completo, consulte Escrevendo um exemplo de pacote.

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

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