PackagePart.CreateRelationship Metodo

Definizione

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.

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)

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.

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.

relationshipTypedeve 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

Si applica a

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.

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.

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.

relationshipTypedeve 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

Si applica a