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 oggetto e una destinazione PackagePart o una risorsa esterna specificata.
Overload
| Nome | Descrizione |
|---|---|
| CreateRelationship(Uri, TargetMode, String) |
Crea una relazione a livello di parte tra questo PackagePart oggetto e una destinazione PackagePart o una risorsa esterna specificata. |
| CreateRelationship(Uri, TargetMode, String, String) |
Crea una relazione a livello di parte tra questo PackagePart oggetto e una destinazione PackagePart o una risorsa esterna specificata. |
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'origine PackagePart e una destinazione PackagePart all'interno di Package.
Tra un'origine PackagePart 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 CreateRelationship metodo 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 Open Packaging Conventions (OPC) disponibile per il download all'indirizzo https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
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
- Origine:
- PackagePart.cs
- Origine:
- PackagePart.cs
- Origine:
- PackagePart.cs
- Origine:
- PackagePart.cs
Crea una relazione a livello di parte tra questo PackagePart oggetto e una destinazione PackagePart o una risorsa esterna specificata.
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 di Packageo External se la destinazione è una risorsa esterna a Package.
- relationshipType
- String
Ruolo della relazione.
Valori restituiti
Relazione a livello di parte tra questo PackagePart oggetto e la risorsa di destinazione PackagePart o esterna.
Eccezioni
La parte è stata eliminata.
oppure
l'oggetto Package non è aperto (Dispose(Boolean) o Close() è stato chiamato ).
targetUri o relationshipType è null.
Il targetMode parametro non è un valore di enumerazione valido TargetMode .
La parte identificata da targetUri è una relazione (la destinazione di una relazione non può essere un'altra relazione).
oppure
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'origine PackagePart e una destinazione PackagePart all'interno di Package.
- Tra un'origine PackagePart 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 CreateRelationship metodo 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 targetMode viene specificato come Internal, targetUri deve essere un URI relativo formato in base alla specifica della sintassi generica RFC 3986Uniform Resource Identifier (URI). L'URI relativo interno può essere un percorso assoluto che inizia con una barra ("/") come "/page1.xaml" o "/images/picture4.jpg" o un percorso relativo, ad esempio ".. /imagespicture1.jpg" che si risolve nella radice del pacchetto ("/") come URI di base.
Se targetMode viene specificato come External, targetUri può essere un URI assoluto o relativo formato in base alla specifica della sintassi generica RFC 3986Uniform Resource Identifier (URI).
"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.
relationshipTypedeve essere un URI formato in base alla specifica della sintassi generica RFC 3986Uniform Resource Identifier (URI). Tipi di pacchetti diversi possono definire tipi di relazione a livello di parte diversi. Nella tabella seguente vengono illustrati gli URI a livello relationshipType di parte definiti per i documenti conformi alla specifica XPS (Open XML Paper Specification).
| 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 Open Packaging Conventions (OPC) disponibile per il download all'indirizzo https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
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/.
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
- Origine:
- PackagePart.cs
- Origine:
- PackagePart.cs
- Origine:
- PackagePart.cs
- Origine:
- PackagePart.cs
Crea una relazione a livello di parte tra questo PackagePart oggetto e una destinazione PackagePart o una risorsa esterna specificata.
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 di Packageo External se la destinazione è una risorsa esterna a Package.
- relationshipType
- String
Ruolo della relazione.
- id
- String
ID univoco per la relazione.
Valori restituiti
Relazione a livello di parte tra questo PackagePart oggetto e la risorsa di destinazione PackagePart o esterna.
Eccezioni
La parte è stata eliminata.
oppure
l'oggetto Package non è aperto (Dispose(Boolean) o Close() è stato chiamato ).
targetUri o relationshipType è null.
Il targetMode parametro non è un valore di enumerazione valido TargetMode .
La parte identificata da targetUri è una relazione (la destinazione di una relazione non può essere un'altra relazione).
oppure
targetMode viene specificato come Internal ma targetUri è un URI esterno assoluto.
Il pacchetto è di sola lettura (non è possibile aggiungere una nuova relazione).
id non è un identificatore XML valido.
oppure
Esiste già una parte con l'oggetto specificato id .
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 delle due forme seguenti:
- Tra un'origine PackagePart e una destinazione PackagePart all'interno di Package.
- Tra un'origine PackagePart 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 id tipo è xsd:ID e deve seguire le convenzioni di denominazione previste nella specifica XML Schema Part 2: Datatypes (vedere https://www.w3.org/TR/xmlschema-2/#ID).
Il CreateRelationship metodo 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 targetMode viene specificato come Internal, targetUri deve essere un URI relativo formato in base alla specifica della sintassi generica RFC 3986Uniform Resource Identifier (URI). L'URI relativo interno può essere un percorso assoluto che inizia con una barra ("/") come "/page1.xaml" o "/images/picture4.jpg" o un percorso relativo, ad esempio ".. /imagespicture1.jpg" che si risolve nella radice del pacchetto ("/") come URI di base.
Se targetMode viene specificato come External, targetUri può essere un URI assoluto o relativo formato in base alla specifica della sintassi generica RFC 3986Uniform Resource Identifier (URI). "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.
relationshipTypedeve essere un URI formato in base alla specifica della sintassi generica RFC 3986Uniform Resource Identifier (URI). Tipi di pacchetti diversi possono definire tipi di relazione a livello di parte diversi. Nella tabella seguente vengono illustrati gli URI a livello relationshipType di parte definiti per i documenti conformi alla specifica XPS (Open XML Paper Specification).
| 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 Open Packaging Conventions (OPC) disponibile per il download all'indirizzo https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Per altre informazioni sui documenti XPS, vedere la specifica xps (Open XML Paper Specification) disponibile per il download all'indirizzo https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.
Vedi anche
- CreateRelationship
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- Specifica open packaging conventions
