Package.CreatePart Méthode

Définition

Crée un nouveau composant de package.

Surcharges

CreatePart(Uri, String)

Crée un nouveau composant non compressé avec un URI et un type de contenu donnés.

CreatePart(Uri, String, CompressionOption)

Crée un nouveau composant avec un URI, un type de contenu et une option de compression donnés.

Exemples

L’exemple suivant montre comment créer un nouveau PackagePart , puis stocker des données dans le composant.

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

Remarques

CreatePart initialise un vide Stream pour la nouvelle partie. La PackagePart.GetStream méthode peut être utilisée pour obtenir une référence au flux instance associé au composant.

Pour plus d’informations sur les composants de package, consultez la section 1.1 de la spécification OPC (Open Packaging Conventions) disponible en téléchargement à l’adresse 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

Crée un nouveau composant non compressé avec un URI et un type de contenu donnés.

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

Paramètres

partUri
Uri

URI (Uniform Resource Identifier) du nouveau composant.

contentType
String

Type de contenu du flux de données.

Retours

Nouveau composant créé.

Exceptions

partUri ou contentType est null.

partUri n’est pas un URI de PackagePart valide.

Un composant avec le partUri spécifié est déjà présent dans le package.

Le package n'est pas ouvert (Dispose(Boolean) ou Close() a été appelée).

Le package est en lecture seule (un nouveau composant ne peut pas être ajouté).

Exemples

L’exemple suivant montre comment créer un nouveau PackagePart , puis stocker des données dans le composant.

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

Remarques

CreatePart initialise un vide Stream pour la nouvelle partie. La PackagePart.GetStream méthode peut être utilisée pour obtenir une référence au flux instance associé au composant.

La partie CompressionOption est CompressionOption.NotCompressed.

Pour plus d’informations sur les composants de package, consultez la section 1.1 de la spécification OPC (Open Packaging Conventions) disponible en téléchargement à l’adresse https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Notes pour les héritiers

CreatePart(Uri, String) appelle en interne la méthode de CreatePartCore(Uri, String, CompressionOption) la classe dérivée pour créer le composant en fonction du format physique implémenté dans la classe dérivée.

Voir aussi

S’applique à

CreatePart(Uri, String, CompressionOption)

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

Crée un nouveau composant avec un URI, un type de contenu et une option de compression donnés.

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

Paramètres

partUri
Uri

URI du nouveau composant.

contentType
String

Type de contenu du flux de données.

compressionOption
CompressionOption

Option de compression pour le flux de données, NotCompressed ou compression Normal.

Retours

Nouveau composant créé.

Exceptions

partUri ou contentType est null.

partUri n’est pas un URI (Uniform Resource Identifier) de PackagePart valide.

Un composant avec le partUri spécifié est déjà présent dans le package.

La valeur compressionOption n'est pas valide.

Le package n'est pas ouvert (Dispose(Boolean) ou Close() a été appelée).

Le package est en lecture seule (un nouveau composant ne peut pas être ajouté).

Exemples

L’exemple suivant montre comment créer un nouveau PackagePart , puis stocker des données dans le composant.

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

Remarques

Pour la classe dérivée par défaut ZipPackage , la CreatePart méthode prend uniquement en charge deux compressionOption valeurs, NotCompressed ou Normal compression. D’autres CompressionOption valeurs de Maximum, Fastou SuperFast utilisent la Normal compression.

CreatePart crée un vide Stream pour la nouvelle partie. La PackagePart.GetStream méthode peut être utilisée pour obtenir une référence au flux instance associé au composant.

Pour plus d’informations, consultez la spécification Opc (Open Packaging Conventions) disponible en téléchargement à l’adresse https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Notes pour les héritiers

CreatePart(Uri, String, CompressionOption) appelle en interne la méthode de CreatePartCore(Uri, String, CompressionOption) la classe dérivée pour créer le composant en fonction du format physique implémenté dans la classe dérivée.

Voir aussi

S’applique à