Condividi tramite


PackagePart.CreateRelationship Metodo

Definizione

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.

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) disponibile per il download all'indirizzo .

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

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.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 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.

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 viene specificato come , deve essere un URI relativo formato in conformità alla specifica RFC 3986sintassi generica URI (Uniform Resource Identifier). 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 viene specificato come , può essere un URI assoluto o relativo in base alla specifica Sintassi generica RFC 3986RFC 3986. "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.

deve essere un URI formato in base alla specifica Sintassi generica RFC 3986URI (Uniform Resource Identifier). Tipi di pacchetti diversi possono definire tipi di relazione a livello di parte diversi. Nella tabella seguente vengono illustrati gli URI di a livello di parte definiti per i documenti conformi all'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 di OPC (Open Packaging Conventions) disponibile per il download all'indirizzo .

Per altre informazioni sui documenti XPS, vedere la xps (Open XML Paper Specification) disponibile per il download all'indirizzo .

Vedi anche

Si applica a

CreateRelationship(Uri, TargetMode, String, String)

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 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.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 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).

id non è un identificatore XML valido.

-o-

Esiste già una parte con il id specificato.

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.

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 viene specificato come , deve essere un URI relativo formato in conformità alla specifica RFC 3986sintassi generica URI (Uniform Resource Identifier). 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 viene specificato come , può essere un URI assoluto o relativo in base alla specifica Sintassi generica RFC 3986RFC 3986. "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.

deve essere un URI formato in base alla specifica Sintassi generica RFC 3986URI (Uniform Resource Identifier). Tipi di pacchetti diversi possono definire tipi di relazione a livello di parte diversi. Nella tabella seguente vengono illustrati gli URI di a livello di parte definiti per i documenti conformi all'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 di OPC (Open Packaging Conventions) disponibile per il download all'indirizzo .

Per altre informazioni sui documenti XPS, vedere la xps (Open XML Paper Specification) disponibile per il download all'indirizzo .

Vedi anche

Si applica a