Package.CreatePart Método

Definición

Crea un nuevo elemento del paquete.

Sobrecargas

CreatePart(Uri, String)

Crea un nuevo elemento sin comprimir con un URI y el tipo de contenido especificados.

CreatePart(Uri, String, CompressionOption)

Crea un nuevo elemento con un URI, tipo de contenido y opción de compresión especificados.

Ejemplos

En el ejemplo siguiente se muestra cómo crear un nuevo PackagePart y, a continuación, almacenar datos en el elemento .

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

Comentarios

CreatePart inicializa un vacío Stream para la nueva parte. El PackagePart.GetStream método se puede usar para obtener una referencia a la instancia de flujo asociada a la parte.

Para obtener más información sobre las partes del paquete, vea la sección 1.1 de la especificación De convenciones de empaquetado abierto (OPC) disponible para su descarga en https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

CreatePart(Uri, String)

Source:
Package.cs
Source:
Package.cs
Source:
Package.cs
Source:
Package.cs

Crea un nuevo elemento sin comprimir con un URI y el tipo de contenido especificados.

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

Identificador uniforme de recursos (URI) del nuevo elemento.

contentType
String

Tipo de contenido del flujo de datos.

Devoluciones

El nuevo elemento creado.

Excepciones

partUri o contentType es null.

partUri no es un URI de PackagePart válido.

Un elemento con el partUri especificado ya está presente en el paquete.

El paquete no está abierto (se ha llamado a Dispose(Boolean) o Close()).

El paquete es de sólo lectura (no se puede agregar ningún elemento nuevo).

Ejemplos

En el ejemplo siguiente se muestra cómo crear un nuevo PackagePart y, a continuación, almacenar datos en el elemento .

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

Comentarios

CreatePart inicializa un vacío Stream para la nueva parte. El PackagePart.GetStream método se puede usar para obtener una referencia a la instancia de flujo asociada a la parte.

La parte CompressionOption es CompressionOption.NotCompressed.

Para obtener información adicional sobre las partes del paquete, vea la sección 1.1 en la especificación De convenciones de empaquetado abierto (OPC) disponible para su descarga en https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Notas a los desarrolladores de herederos

CreatePart(Uri, String) llama internamente al método de CreatePartCore(Uri, String, CompressionOption) la clase derivada para crear realmente el elemento en función del formato físico implementado en la clase derivada.

Consulte también

Se aplica a

CreatePart(Uri, String, CompressionOption)

Source:
Package.cs
Source:
Package.cs
Source:
Package.cs
Source:
Package.cs

Crea un nuevo elemento con un URI, tipo de contenido y opción de compresión especificados.

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

URI del nuevo elemento.

contentType
String

Tipo de contenido del flujo de datos.

compressionOption
CompressionOption

La opción de compresión del flujo de datos, compresión NotCompressed o Normal.

Devoluciones

El nuevo elemento creado.

Excepciones

partUri o contentType es null.

partUri no es un identificador uniforme de recursos (URI) de PackagePart válido.

Un elemento con el partUri especificado ya está presente en el paquete.

El valor compressionOption no es válido.

El paquete no está abierto (se ha llamado a Dispose(Boolean) o Close()).

El paquete es de sólo lectura (no se puede agregar ningún elemento nuevo).

Ejemplos

En el ejemplo siguiente se muestra cómo crear un nuevo PackagePart y, a continuación, almacenar datos en el elemento .

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

Comentarios

Para la clase derivada predeterminada ZipPackage , el CreatePart método solo admite dos compressionOption valores o NotCompressedNormal compresión. Otros CompressionOption valores de Maximum, Fasto SuperFast usan Normal compresión.

CreatePart crea un vacío Stream para el nuevo elemento. El PackagePart.GetStream método se puede usar para obtener una referencia a la instancia de flujo asociada a la parte.

Para obtener más información, consulte la especificación De convenciones de empaquetado abierto (OPC) disponible para su descarga en https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Notas a los desarrolladores de herederos

CreatePart(Uri, String, CompressionOption) llama internamente al método de CreatePartCore(Uri, String, CompressionOption) la clase derivada para crear realmente el elemento en función del formato físico implementado en la clase derivada.

Consulte también

Se aplica a