Package.CreatePart Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 . Para obtener el ejemplo completo, vea Escribir un ejemplo de paquete.
// 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)
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.PackagePartPublic Function CreatePart (partUri As Uri, contentType As String) As PackagePartPará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 . Para obtener el ejemplo completo, vea Escribir un ejemplo de paquete.
// 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)
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.PackagePartPublic Function CreatePart (partUri As Uri, contentType As String, compressionOption As CompressionOption) As PackagePartPará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 . Para obtener el ejemplo completo, vea Escribir un ejemplo de paquete.
// 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 NotCompressed Normal 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.