PackagePart.CreateRelationship Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Crea una relazione a livello di parte tra questo PackagePart a una destinazione specificata PackagePart o a una risorsa esterna.
Overload
| CreateRelationship(Uri, TargetMode, String) |
Crea una relazione a livello di parte tra questo PackagePart a una destinazione specificata PackagePart o a una risorsa esterna. |
| CreateRelationship(Uri, TargetMode, String, String) |
Crea una relazione a livello di parte tra questo PackagePart a una destinazione specificata PackagePart o a una risorsa esterna. |
Commenti
Una relazione a livello di parte definisce un'associazione tra questa parte e una parte o una risorsa di destinazione. Una relazione a livello di parte può essere una di due forme.
Tra un PackagePart di origine e un PackagePart di destinazione all'interno del Package.
Tra un PackagePart di origine e una risorsa di destinazione all'esterno del pacchetto.
In una relazione parte la parte di origine viene considerata il "proprietario" della relazione. Quando la parte di origine viene eliminata, vengono eliminate anche tutte le relazioni di proprietà della parte. Il processo di creazione o eliminazione della relazione non modifica fisicamente la parte o la risorsa di destinazione in alcun modo.
Il metodo CreateRelationship non modifica fisicamente la parte di origine o la parte o la risorsa di destinazione in alcun modo.
La destinazione di una relazione non può essere un'altra relazione.
Per altre informazioni sulle relazioni tra pacchetti, vedere la sezione 1.3 della specifica di OPC (Open Packaging Conventions)
Per altre informazioni sui documenti XPS, vedere Open XML Paper Specification (XPS) disponibile per il download all'indirizzo https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.
CreateRelationship(Uri, TargetMode, String)
- Origine:
- PackagePart.cs
- Origine:
- PackagePart.cs
- Origine:
- PackagePart.cs
- Origine:
- PackagePart.cs
Crea una relazione a livello di parte tra questo PackagePart a una destinazione specificata PackagePart o a una risorsa esterna.
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 PackageRelationshipParametri
- targetUri
- Uri
URI della parte di destinazione.
- targetMode
- TargetMode
Uno dei valori di enumerazione. Ad esempio, Internal se la parte di destinazione si trova all'interno del Package; o External se la destinazione è una risorsa esterna al Package.
- relationshipType
- String
Ruolo della relazione.
Restituisce
Relazione a livello di parte tra questo PackagePart e il PackagePart di destinazione o la risorsa esterna.
Eccezioni
La parte è stata eliminata.
-o-
Il Package non è aperto (Dispose(Boolean) o Close() è stato chiamato).
targetUri o relationshipType è null.
Il parametro targetMode non è un valore di enumerazione TargetMode valido.
La parte identificata dal targetUri è una relazione (la destinazione di una relazione non può essere un'altra relazione).
-o-
targetMode viene specificato come Internal, ma targetUri è un URI esterno assoluto.
Il pacchetto è di sola lettura (non è possibile aggiungere una nuova relazione).
Commenti
Una relazione a livello di parte definisce un'associazione tra questa parte e una parte o una risorsa di destinazione. Una relazione a livello di parte può essere una di due forme.
Tra un PackagePart di origine e un PackagePart di destinazione all'interno del Package.
Tra un PackagePart di origine e una risorsa di destinazione all'esterno del pacchetto.
In una relazione parte la parte di origine viene considerata il "proprietario" della relazione. Quando la parte di origine viene eliminata, vengono eliminate anche tutte le relazioni di proprietà della parte. Il processo di creazione o eliminazione della relazione non modifica fisicamente la parte o la risorsa di destinazione in alcun modo.
Il metodo CreateRelationship non modifica fisicamente la parte di origine o la parte o la risorsa di destinazione in alcun modo.
La destinazione di una relazione non può essere un'altra relazione.
Se
Se "https://www.microsoft.com/page2.xml" è un esempio di URI assoluto che fa riferimento a una risorsa di destinazione esterna "page2.xml". "images/picture1.jpg" è un esempio di URI relativo che fa riferimento anche a una risorsa di destinazione esterna "1.jpg" ma che si risolve sull'URI del pacchetto stesso.
| Relazione di Part-Level documento XPS | URI del tipo di relazione |
|---|---|
| Definizioni di firma digitale | 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 |
| Risorsa richiesta | http://schemas.microsoft.com/xps/2005/06/required-resource |
| Tipo di carattere con restrizioni | 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 |
Per altre informazioni sulle relazioni tra pacchetti, vedere la sezione 1.3 della specifica di OPC (Open Packaging Conventions)
Per altre informazioni sui documenti XPS, vedere la xps (Open XML Paper Specification)
Vedi anche
- CreateRelationship
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- specifica open packaging conventions
Si applica a
CreateRelationship(Uri, TargetMode, String, String)
- Origine:
- PackagePart.cs
- Origine:
- PackagePart.cs
- Origine:
- PackagePart.cs
- Origine:
- PackagePart.cs
Crea una relazione a livello di parte tra questo PackagePart a una destinazione specificata PackagePart o a una risorsa esterna.
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 PackageRelationshipParametri
- targetUri
- Uri
URI della parte di destinazione.
- targetMode
- TargetMode
Uno dei valori di enumerazione. Ad esempio, Internal se la parte di destinazione si trova all'interno del Package; o External se la destinazione è una risorsa esterna al Package.
- relationshipType
- String
Ruolo della relazione.
- id
- String
ID univoco per la relazione.
Restituisce
Relazione a livello di parte tra questo PackagePart e il PackagePart di destinazione o la risorsa esterna.
Eccezioni
La parte è stata eliminata.
-o-
Il Package non è aperto (Dispose(Boolean) o Close() è stato chiamato).
targetUri o relationshipType è null.
Il parametro targetMode non è un valore di enumerazione TargetMode valido.
La parte identificata dal targetUri è una relazione (la destinazione di una relazione non può essere un'altra relazione).
-o-
targetMode viene specificato come Internal, ma targetUri è un URI esterno assoluto.
Il pacchetto è di sola lettura (non è possibile aggiungere una nuova relazione).
Commenti
Una relazione a livello di parte definisce un'associazione tra questa parte e una parte o una risorsa di destinazione. Una relazione a livello di parte può essere una di due forme.
Tra un PackagePart di origine e un PackagePart di destinazione all'interno del Package.
Tra un PackagePart di origine e una risorsa di destinazione all'esterno del pacchetto.
In una relazione parte la parte di origine viene considerata il "proprietario" della relazione. Quando la parte di origine viene eliminata, vengono eliminate anche tutte le relazioni di proprietà della parte. Il processo di creazione o eliminazione della relazione non modifica fisicamente la parte o la risorsa di destinazione in alcun modo.
id deve essere un identificatore XML valido. Il tipo id è xsd:ID e deve seguire le convenzioni di denominazione previste nella XML Schema Part 2: Datatypes specification (vedere https://www.w3.org/TR/xmlschema-2/#ID).
Il metodo CreateRelationship non modifica fisicamente la parte di origine o la parte o la risorsa di destinazione in alcun modo.
La destinazione di una relazione non può essere un'altra relazione.
Se
Se
| Relazione di Part-Level documento XPS | URI del tipo di relazione |
|---|---|
| Definizioni di firma digitale | 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 |
| Risorsa richiesta | http://schemas.microsoft.com/xps/2005/06/required-resource |
| Tipo di carattere con restrizioni | 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 |
Per altre informazioni sulle relazioni tra pacchetti, vedere la sezione 1.3 della specifica di OPC (Open Packaging Conventions)
Per altre informazioni sui documenti XPS, vedere la xps (Open XML Paper Specification)
Vedi anche
- CreateRelationship
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- specifica open packaging conventions
Si applica a
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per