Package.CreatePart Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.PackagePartPublic Function CreatePart (partUri As Uri, contentType As String) As PackagePartParamè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.PackagePartPublic Function CreatePart (partUri As Uri, contentType As String, compressionOption As CompressionOption) As PackagePartParamè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.
