Package.CreatePart Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.PackagePartPublic Function CreatePart (partUri As Uri, contentType As String) As PackagePartParâ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.PackagePartPublic Function CreatePart (partUri As Uri, contentType As String, compressionOption As CompressionOption) As PackagePartParâ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.
