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 l'oggetto PackagePart e un oggetto PackagePart o una risorsa esterna di destinazione specificati.
Overload
CreateRelationship(Uri, TargetMode, String) |
Crea una relazione a livello di parte tra l'oggetto PackagePart e un oggetto PackagePart o una risorsa esterna di destinazione specificati. |
CreateRelationship(Uri, TargetMode, String, String) |
Crea una relazione a livello di parte tra l'oggetto PackagePart e un oggetto PackagePart o una risorsa esterna di destinazione specificati. |
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.
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 di 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 OPC (Open Packaging Conventions) 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
Crea una relazione a livello di parte tra l'oggetto PackagePart e un oggetto PackagePart o una risorsa esterna di destinazione specificati.
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
Parametri
- targetUri
- Uri
URI della parte di destinazione.
- targetMode
- TargetMode
Uno dei valori di enumerazione. Ad esempio, Internal se la parte di destinazione è all'interno dell'oggetto Package; oppure External se la destinazione è rappresentata da una risorsa all'esterno dell'oggetto Package.
- relationshipType
- String
Ruolo della relazione.
Restituisce
Relazione a livello di parte tra l'oggetto PackagePart e l'oggetto PackagePart o la risorsa esterna di destinazione.
Eccezioni
La parte è stata eliminata.
-oppure-
L'oggetto Package non è aperto (è stato chiamato l'oggetto Dispose(Boolean) o Close()).
targetUri
o relationshipType
è null
.
Il parametro targetMode
non è un valore di enumerazione TargetMode valido.
La parte identificata da targetUri
rappresenta 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 package è 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 delle 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 di 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 cambia fisicamente la parte di origine o la parte di destinazione o la risorsa 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 conformità alla specifica di sintassi generica RFC 3986Uniform Resource Identifier (URI). L'URI relativo interno può essere un percorso assoluto che inizia con una barra ("/") carattere come "/page1.xaml" o "/images/picture4.jpg" o un percorso relativo, ad esempio ".. /imagespicture1.jpg" che viene risolto rispetto alla radice del pacchetto ("/") come URI di base.
Se targetMode
viene specificato come External, targetUri
può essere un URI assoluto o relativo formato in conformità alla specifica 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 viene risolta con l'URI del pacchetto stesso.
relationshipType
deve essere un URI formato in base alla specifica Sintassi generica RFC 3986Uniform Resource Identifier (URI). Diversi tipi di pacchetto possono definire diversi tipi di relazione a livello di parte. Nella tabella seguente vengono illustrati gli URI a livello relationshipType
di parte definiti per i documenti conformi alla specifica di carta Open XML (XPS).
Relazione di Part-Level documento XPS | URI del tipo di relazione |
---|---|
Definizioni di firma digitale | http://schemas.microsoft.com/xps/2005/06/signature-definitions |
RimuoviControl | 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 |
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 in 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 in 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
Crea una relazione a livello di parte tra l'oggetto PackagePart e un oggetto PackagePart o una risorsa esterna di destinazione specificati.
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
Parametri
- targetUri
- Uri
URI della parte di destinazione.
- targetMode
- TargetMode
Uno dei valori di enumerazione. Ad esempio, Internal se la parte di destinazione è all'interno dell'oggetto Package; oppure External se la destinazione è rappresentata da una risorsa all'esterno dell'oggetto Package.
- relationshipType
- String
Ruolo della relazione.
- id
- String
ID univoco per la relazione.
Restituisce
Relazione a livello di parte tra l'oggetto PackagePart e l'oggetto PackagePart o la risorsa esterna di destinazione.
Eccezioni
La parte è stata eliminata.
-oppure-
L'oggetto Package non è aperto (è stato chiamato l'oggetto Dispose(Boolean) o Close()).
targetUri
o relationshipType
è null
.
Il parametro targetMode
non è un valore di enumerazione TargetMode valido.
La parte identificata da targetUri
rappresenta 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 package è di sola lettura (non è possibile aggiungere una nuova relazione).
id
non è un identificatore XML valido.
-oppure-
Una parte con il parametro id
specificato esiste già.
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.
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 di 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 Parte 2: Tipi di dati (vedere https://www.w3.org/TR/xmlschema-2/#ID).
Il CreateRelationship metodo non cambia fisicamente la parte di origine o la parte di destinazione o la risorsa 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 conformità alla specifica di sintassi generica RFC 3986Uniform Resource Identifier (URI). L'URI relativo interno può essere un percorso assoluto che inizia con una barra ("/") carattere come "/page1.xaml" o "/images/picture4.jpg" o un percorso relativo, ad esempio ".. /imagespicture1.jpg" che viene risolto rispetto alla radice del pacchetto ("/") come URI di base.
Se targetMode
viene specificato come External, targetUri
può essere un URI assoluto o relativo formato in conformità alla specifica 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 viene risolta con l'URI del pacchetto stesso.
relationshipType
deve essere un URI formato in base alla specifica Sintassi generica RFC 3986Uniform Resource Identifier (URI). Diversi tipi di pacchetto possono definire diversi tipi di relazione a livello di parte. Nella tabella seguente vengono illustrati gli URI a livello relationshipType
di parte definiti per i documenti conformi alla specifica di carta Open XML (XPS).
Relazione di Part-Level documento XPS | URI del tipo di relazione |
---|---|
Definizioni di firma digitale | http://schemas.microsoft.com/xps/2005/06/signature-definitions |
RimuoviControl | 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 |
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 in 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 in 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
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
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, vedereInvia e visualizza il feedback per