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 au niveau du composant entre ce PackagePart et un PackagePart cible spécifié ou une ressource externe.
Surcharges
CreateRelationship(Uri, TargetMode, String) |
Crée une relation au niveau du composant entre ce PackagePart et un PackagePart cible spécifié ou une ressource externe. |
CreateRelationship(Uri, TargetMode, String, String) |
Crée une relation au niveau du composant entre ce PackagePart et un PackagePart cible spécifié ou une ressource 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 suivantes.
Entre une source PackagePart et une cible PackagePart à l’intérieur de Package.
Entre une source PackagePart et 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 le composant source est supprimé, 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 pas physiquement la partie ou la ressource cible de quelque manière que ce soit.
La CreateRelationship méthode ne modifie physiquement ni la partie source, ni la partie ou la ressource cible 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 OPC (Open Packaging Conventions) disponible en téléchargement à l’adresse 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 à l’adresse https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.
CreateRelationship(Uri, TargetMode, String)
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
Crée une relation au niveau du composant entre ce PackagePart et un PackagePart cible spécifié ou une ressource 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.PackageRelationship
Public Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String) As PackageRelationship
Paramètres
- targetUri
- Uri
URI du composant cible.
- targetMode
- TargetMode
Une des valeurs de l'énumération. Par exemple, Internal si le composant cible est à l'intérieur du Package ; ou External si la cible est une ressource à l'extérieur du Package.
- relationshipType
- String
Rôle de la relation.
Retours
Relation au niveau du composant entre ce PackagePart et le PackagePart cible ou la ressource externe.
Exceptions
Le composant a été supprimé.
- ou -
Le Package n'est pas ouvert (Dispose(Boolean) ou Close() a été appelée).
targetUri
ou relationshipType
est null
.
Le paramètre targetMode
n'est pas une valeur d'énumération TargetMode valide.
Le composant identifié 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 suivantes.
Entre une source PackagePart et une cible PackagePart à l’intérieur du Package.
Entre une source PackagePart et 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 pas physiquement la partie ou la ressource cible de quelque manière que ce soit.
La CreateRelationship méthode ne modifie physiquement ni la partie source, ni la partie ou la ressource cible de quelque manière que ce soit.
La cible d’une relation ne peut pas être une autre relation.
Si targetMode
est spécifié en tant que Internal, targetUri
doit être un URI relatif formé conformément à la spécification de syntaxe générique de l’URI (Uniform Resource Identifier)RFC 3986. L’URI relatif interne peut être un chemin d’accès 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é en tant que External, targetUri
peut être un URI absolu ou relatif formé conformément à la spécification de syntaxe générique de l’URI (Uniform Resource Identifier)RFC 3986. "https://www.microsoft.com/page2.xml"
est un exemple d’URI absolu qui 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 externe « 1.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 de syntaxe générique de l’URI (Uniform Resource Identifier)RFC 3986. Différents types de package peuvent définir différents types de relations au niveau de la partie. Le tableau suivant présente les URI de niveau relationshipType
partie définis pour les documents conformes à la spécification de papier Open XML (XPS).
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 OPC (Open Packaging Conventions) disponible en téléchargement à l’adresse 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 à l’adresse https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.
Voir aussi
- CreateRelationship
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- Spécification d’Open Packaging Conventions
S’applique à
CreateRelationship(Uri, TargetMode, String, String)
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
Crée une relation au niveau du composant entre ce PackagePart et un PackagePart cible spécifié ou une ressource 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.PackageRelationship
Public Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String, id As String) As PackageRelationship
Paramètres
- targetUri
- Uri
URI du composant cible.
- targetMode
- TargetMode
Une des valeurs de l'énumération. Par exemple, Internal si le composant cible est à l'intérieur du Package ; ou External si la cible est une ressource à l'extérieur du Package.
- relationshipType
- String
Rôle de la relation.
- id
- String
ID unique pour la relation.
Retours
Relation au niveau du composant entre ce PackagePart et le PackagePart cible ou la ressource externe.
Exceptions
Le composant a été supprimé.
- ou -
Le Package n'est pas ouvert (Dispose(Boolean) ou Close() a été appelée).
targetUri
ou relationshipType
est null
.
Le paramètre targetMode
n'est pas une valeur d'énumération TargetMode valide.
Le composant identifié 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 -
Un composant avec l'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 suivantes.
Entre une source PackagePart et une cible PackagePart à l’intérieur du Package.
Entre une source PackagePart et 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 pas physiquement la partie ou la ressource cible de quelque manière que ce soit.
id
doit être un identificateur XML valide. Le id
type est xsd :ID et doit suivre les conventions d’affectation de noms prescrites dans la spécification de schéma XML Part 2 : Datatypes (voir https://www.w3.org/TR/xmlschema-2/#ID).
La CreateRelationship méthode ne modifie physiquement ni la partie source, ni la partie ou la ressource cible de quelque manière que ce soit.
La cible d’une relation ne peut pas être une autre relation.
Si targetMode
est spécifié en tant que Internal, targetUri
doit être un URI relatif formé conformément à la spécification de syntaxe générique de l’URI (Uniform Resource Identifier)RFC 3986. L’URI relatif interne peut être un chemin d’accès 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é en tant que External, targetUri
peut être un URI absolu ou relatif formé conformément à la spécification de syntaxe générique de l’URI (Uniform Resource Identifier)RFC 3986. "https://www.microsoft.com/page2.xml" est un exemple d’URI absolu qui 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 externe « 1.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 de syntaxe générique de l’URI (Uniform Resource Identifier)RFC 3986. Différents types de package peuvent définir différents types de relations au niveau de la partie. Le tableau suivant présente les URI de niveau relationshipType
partie définis pour les documents conformes à la spécification de papier Open XML (XPS).
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 OPC (Open Packaging Conventions) disponible en téléchargement à l’adresse 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 à l’adresse https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.
Voir aussi
- CreateRelationship
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- Spécification des conventions d’emballage open
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour