PackagePart.CreateRelationship 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 une relation de niveau partie entre cette PackagePart à une ressource cible spécifiée PackagePart ou externe.
Surcharges
| CreateRelationship(Uri, TargetMode, String) |
Crée une relation de niveau partie entre cette PackagePart à une ressource cible spécifiée PackagePart ou externe. |
| CreateRelationship(Uri, TargetMode, String, String) |
Crée une relation de niveau partie entre cette PackagePart à une ressource cible spécifiée PackagePart ou externe. |
Remarques
Une relation de niveau partie définit une association entre cette partie et une partie ou une ressource cible. Une relation de niveau partie peut être l’une des deux formes.
Entre une PackagePart source vers une PackagePart cible à l’intérieur du Package.
Entre une source PackagePart à une ressource cible en dehors du package.
Dans une relation de partie, le composant source est considéré comme le « propriétaire » de la relation. Lorsque la partie source est supprimée, toutes les relations détenues par le composant sont également supprimées. Le processus de création ou de suppression de la relation ne modifie physiquement aucune partie ou ressource cible.
La méthode CreateRelationship ne modifie pas physiquement la partie source, la partie cible ou la ressource de quelque manière que ce soit.
La cible d’une relation ne peut pas être une autre relation.
Pour plus d’informations sur les relations de package, consultez la section 1.3 de la spécification Open Packaging Conventions (OPC) disponible pour le téléchargement à https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Pour plus d’informations sur les documents XPS, consultez la spécification de papier Open XML (XPS) disponible en téléchargement à https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.
CreateRelationship(Uri, TargetMode, String)
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
Crée une relation de niveau partie entre cette PackagePart à une ressource cible spécifiée PackagePart ou externe.
public:
System::IO::Packaging::PackageRelationship ^ CreateRelationship(Uri ^ targetUri, System::IO::Packaging::TargetMode targetMode, System::String ^ relationshipType);public System.IO.Packaging.PackageRelationship CreateRelationship (Uri targetUri, System.IO.Packaging.TargetMode targetMode, string relationshipType);member this.CreateRelationship : Uri * System.IO.Packaging.TargetMode * string -> System.IO.Packaging.PackageRelationshipPublic Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String) As PackageRelationshipParamètres
- targetUri
- Uri
URI du composant cible.
- targetMode
- TargetMode
Une des valeurs d’énumération. Par exemple, Internal si la partie cible se trouve à l’intérieur du Package; ou External si la cible est une ressource en dehors du Package.
- relationshipType
- String
Rôle de la relation.
Retours
Relation de niveau partie entre cette PackagePart à la ressource cible PackagePart ou externe.
Exceptions
La partie a été supprimée.
-ou-
Le Package n’est pas ouvert (Dispose(Boolean) ou Close() a été appelé).
targetUri ou relationshipType est null.
Le paramètre targetMode n’est pas une valeur d’énumération TargetMode valide.
La partie identifiée par l'targetUri est une relation (la cible d’une relation ne peut pas être une autre relation).
-ou-
targetMode est spécifié comme Internal, mais targetUri est un URI externe absolu.
Le package est en lecture seule (une nouvelle relation ne peut pas être ajoutée).
Remarques
Une relation de niveau partie définit une association entre cette partie et une partie ou une ressource cible. Une relation de niveau partie peut être l’une des deux formes.
Entre une PackagePart source vers une PackagePart cible à l’intérieur du Package.
Entre une source PackagePart à une ressource cible en dehors du package.
Dans une relation de partie, le composant source est considéré comme le « propriétaire » de la relation. Lorsque la partie source est supprimée, toutes les relations détenues par le composant sont également supprimées. Le processus de création ou de suppression de la relation ne modifie physiquement aucune partie ou ressource cible.
La méthode CreateRelationship ne modifie pas physiquement la partie source, la partie cible ou la ressource de quelque manière que ce soit.
La cible d’une relation ne peut pas être une autre relation.
Si targetMode est spécifié comme Internal, targetUri doit être un URI relatif formé conformément à la spécification RFC 3986Uniform Resource Identifier (URI). L’URI relatif interne peut être un chemin absolu qui commence par une barre oblique (« / ») caractère tel que « /page1.xaml » ou « /images/picture4.jpg« , ou un chemin relatif tel que « .. /imagespicture1.jpg« qui se résout par rapport à la racine du package (« / ») en tant qu’URI de base.
Si targetMode est spécifié comme External, targetUri peut être un URI absolu ou relatif formé conformément à la spécification RFC 3986Uniform Resource Identifier (URI).
"https://www.microsoft.com/page2.xml" est un exemple d’URI absolu qui fait référence à une ressource cible externe «page2.xml». « images/picture1.jpg» est un exemple d’URI relatif qui fait également référence à une ressource cible externe1.jpg», mais qui se résout par rapport à l’URI du package lui-même.
relationshipType doit être un URI formé conformément à la spécification RFC 3986Uniform Resource Identifier (URI). Différents types de package peuvent définir différents types de relation au niveau du composant. Le tableau suivant présente les URI de niveau partie
| Relation de Part-Level de document XPS | URI de type de relation |
|---|---|
| Définitions de signature numérique | http://schemas.microsoft.com/xps/2005/06/signature-definitions |
| DiscardControl | http://schemas.microsoft.com/xps/2005/06/discard-control |
| DocumentStructure | http://schemas.microsoft.com/xps/2005/06/documentstructure |
| PrintTicket | http://schemas.microsoft.com/xps/2005/06/printticket |
| Ressource requise | http://schemas.microsoft.com/xps/2005/06/required-resource |
| Police restreinte | http://schemas.microsoft.com/xps/2005/06/restricted-font |
| StartPart | http://schemas.microsoft.com/xps/2005/06/fixedrepresentation |
| StoryFragments | http://schemas.microsoft.com/xps/2005/06/storyfragments |
Pour plus d’informations sur les relations de package, consultez la section 1.3 de la spécification Open Packaging Conventions (OPC) disponible pour le téléchargement à https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Pour plus d’informations sur les documents XPS, consultez la
Voir aussi
- CreateRelationship
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- spécification open packaging conventions
S’applique à
CreateRelationship(Uri, TargetMode, String, String)
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
Crée une relation de niveau partie entre cette PackagePart à une ressource cible spécifiée PackagePart ou externe.
public:
System::IO::Packaging::PackageRelationship ^ CreateRelationship(Uri ^ targetUri, System::IO::Packaging::TargetMode targetMode, System::String ^ relationshipType, System::String ^ id);public System.IO.Packaging.PackageRelationship CreateRelationship (Uri targetUri, System.IO.Packaging.TargetMode targetMode, string relationshipType, string? id);public System.IO.Packaging.PackageRelationship CreateRelationship (Uri targetUri, System.IO.Packaging.TargetMode targetMode, string relationshipType, string id);member this.CreateRelationship : Uri * System.IO.Packaging.TargetMode * string * string -> System.IO.Packaging.PackageRelationshipPublic Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String, id As String) As PackageRelationshipParamètres
- targetUri
- Uri
URI du composant cible.
- targetMode
- TargetMode
Une des valeurs d’énumération. Par exemple, Internal si la partie cible se trouve à l’intérieur du Package; ou External si la cible est une ressource en dehors du Package.
- relationshipType
- String
Rôle de la relation.
- id
- String
ID unique de la relation.
Retours
Relation de niveau partie entre cette PackagePart à la ressource cible PackagePart ou externe.
Exceptions
La partie a été supprimée.
-ou-
Le Package n’est pas ouvert (Dispose(Boolean) ou Close() a été appelé).
targetUri ou relationshipType est null.
Le paramètre targetMode n’est pas une valeur d’énumération TargetMode valide.
La partie identifiée par l'targetUri est une relation (la cible d’une relation ne peut pas être une autre relation).
-ou-
targetMode est spécifié comme Internal, mais targetUri est un URI externe absolu.
Le package est en lecture seule (une nouvelle relation ne peut pas être ajoutée).
id n’est pas un identificateur XML valide.
-ou-
Une partie avec le id spécifié existe déjà.
Remarques
Une relation de niveau partie définit une association entre cette partie et une partie ou une ressource cible. Une relation de niveau partie peut être l’une des deux formes.
Entre une PackagePart source vers une PackagePart cible à l’intérieur du Package.
Entre une source PackagePart à une ressource cible en dehors du package.
Dans une relation de partie, le composant source est considéré comme le « propriétaire » de la relation. Lorsque la partie source est supprimée, toutes les relations détenues par le composant sont également supprimées. Le processus de création ou de suppression de la relation ne modifie physiquement aucune partie ou ressource cible.
id doit être un identificateur XML valide. Le type id est xsd :ID et doit suivre les conventions d’affectation de noms prescrites dans la partie 2 du schéma XML : Spécification des types de données (voir https://www.w3.org/TR/xmlschema-2/#ID).
La méthode CreateRelationship ne modifie pas physiquement la partie source, la partie cible ou la ressource de quelque manière que ce soit.
La cible d’une relation ne peut pas être une autre relation.
Si targetMode est spécifié comme Internal, targetUri doit être un URI relatif formé conformément à la spécification RFC 3986Uniform Resource Identifier (URI). L’URI relatif interne peut être un chemin absolu qui commence par une barre oblique (« / ») caractère tel que « /page1.xaml » ou « /images/picture4.jpg« , ou un chemin relatif tel que « .. /imagespicture1.jpg« qui se résout par rapport à la racine du package (« / ») en tant qu’URI de base.
Si targetMode est spécifié comme External, targetUri peut être un URI absolu ou relatif formé conformément à la spécification RFC 3986Uniform Resource Identifier (URI). "https://www.microsoft.com/page2.xml" est un exemple d’URI absolu qui fait référence à une ressource cible externe «page2.xml». « images/picture1.jpg» est un exemple d’URI relatif qui fait également référence à une ressource cible externe1.jpg», mais qui se résout par rapport à l’URI du package lui-même.
relationshipType doit être un URI formé conformément à la spécification RFC 3986Uniform Resource Identifier (URI). Différents types de package peuvent définir différents types de relation au niveau du composant. Le tableau suivant présente les URI de niveau partie
| Relation de Part-Level de document XPS | URI de type de relation |
|---|---|
| Définitions de signature numérique | http://schemas.microsoft.com/xps/2005/06/signature-definitions |
| DiscardControl | http://schemas.microsoft.com/xps/2005/06/discard-control |
| DocumentStructure | http://schemas.microsoft.com/xps/2005/06/documentstructure |
| PrintTicket | http://schemas.microsoft.com/xps/2005/06/printticket |
| Ressource requise | http://schemas.microsoft.com/xps/2005/06/required-resource |
| Police restreinte | http://schemas.microsoft.com/xps/2005/06/restricted-font |
| StartPart | http://schemas.microsoft.com/xps/2005/06/fixedrepresentation |
| StoryFragments | http://schemas.microsoft.com/xps/2005/06/storyfragments |
Pour plus d’informations sur les relations de package, consultez la section 1.3 de la spécification Open Packaging Conventions (OPC) disponible pour le téléchargement à https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Pour plus d’informations sur les documents XPS, consultez l' open XML Paper Specification (XPS)
Voir aussi
- CreateRelationship
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- spécification open packaging conventions
