PackagePart.CreateRelationship Metodo

Definizione

Spazio dei nomi:

System.IO.Packaging

Assembly:

System.IO.Packaging.dll

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

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

PackageRelationship

Relazione a livello di parte tra questo PackagePart e il PackagePart di destinazione o la risorsa esterna.

Eccezioni

InvalidOperationException

La parte è stata eliminata.

-o-

Il Package non è aperto (Dispose(Boolean) o Close() è stato chiamato).

ArgumentNullException

targetUri o relationshipType è null.

ArgumentOutOfRangeException

Il parametro targetMode non è un valore di enumerazione TargetMode valido.

ArgumentException

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.

IOException

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

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• specifica open packaging conventions

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.

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

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

PackageRelationship

Relazione a livello di parte tra questo PackagePart e il PackagePart di destinazione o la risorsa esterna.

Eccezioni

InvalidOperationException

La parte è stata eliminata.

-o-

Il Package non è aperto (Dispose(Boolean) o Close() è stato chiamato).

ArgumentNullException

targetUri o relationshipType è null.

ArgumentOutOfRangeException

Il parametro targetMode non è un valore di enumerazione TargetMode valido.

ArgumentException

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.

IOException

Il pacchetto è di sola lettura (non è possibile aggiungere una nuova relazione).

XmlException

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.

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

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• specifica open packaging conventions