Package.CreatePart Méthode

Définition

Espace de noms:

System.IO.Packaging

Assembly:

System.IO.Packaging.dll

Paquet:

System.IO.Packaging v8.0.0

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 la partie . Pour obtenir l’exemple complet, consultez Écriture d’un exemple de package.

// 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 le nouveau composant. La PackagePart.GetStream méthode peut être utilisée pour obtenir une référence à l’instance de flux associée à la partie .

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

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

PackagePart

Nouveau composant créé.

Exceptions

ArgumentNullException

partUri ou contentType est null.

ArgumentException

partUri n’est pas un URI de PackagePart valide.

InvalidOperationException

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

ObjectDisposedException

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

IOException

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 la partie . Pour obtenir l’exemple complet, consultez Écriture d’un exemple de package.

// 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 le nouveau composant. La PackagePart.GetStream méthode peut être utilisée pour obtenir une référence à l’instance de flux associée à la partie .

La partie CompressionOption est CompressionOption.NotCompressed.

Pour plus d’informations sur les composants du 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 la partie en fonction du format physique implémenté dans la classe dérivée.

Voir aussi

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

CreatePart(Uri, String, CompressionOption)

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

PackagePart

Nouveau composant créé.

Exceptions

ArgumentNullException

partUri ou contentType est null.

ArgumentException

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

InvalidOperationException

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

ArgumentOutOfRangeException

La valeur compressionOption n'est pas valide.

ObjectDisposedException

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

IOException

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 la partie . Pour obtenir l’exemple complet, consultez Écriture d’un exemple de package.

// 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. Les autres CompressionOption valeurs de Maximum, Fastou SuperFast utilisent la Normal compression.

CreatePart crée un vide Stream pour le nouveau composant. La PackagePart.GetStream méthode peut être utilisée pour obtenir une référence à l’instance de flux associée à la partie .

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 la partie en fonction du format physique implémenté dans la classe dérivée.

Voir aussi

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