PackagePart.CreateRelationship Methode

Definition

Namespace:

System.IO.Packaging

Assembly:

System.IO.Packaging.dll

Paket:

System.IO.Packaging v11.0.0-preview.4.26230.115

Erstellt eine Part-Level-Beziehung zwischen dieser PackagePart zu einem angegebenen Ziel PackagePart oder einer externen Ressource.

Überlädt

Name	Beschreibung
CreateRelationship(Uri, TargetMode, String)	Erstellt eine Part-Level-Beziehung zwischen dieser PackagePart zu einem angegebenen Ziel PackagePart oder einer externen Ressource.
CreateRelationship(Uri, TargetMode, String, String)	Erstellt eine Part-Level-Beziehung zwischen dieser PackagePart zu einem angegebenen Ziel PackagePart oder einer externen Ressource.

Hinweise

Eine Part-Level-Beziehung definiert eine Zuordnung zwischen diesem Teil und einem Zielteil oder einer Ressource. Eine Part-Level-Beziehung kann eine von zwei Formen sein.

• Zwischen einer Quelle PackagePart zu einem Ziel PackagePart innerhalb der Package.

• Zwischen einer Quelle PackagePart und einer Zielressource außerhalb des Pakets.

In einer Teilbeziehung wird der Quellteil als "Besitzer" der Beziehung betrachtet. Wenn der Quellteil gelöscht wird, werden alle Beziehungen, die dem Teil gehören, ebenfalls gelöscht. Der Vorgang zum Erstellen oder Löschen der Beziehung ändert den Zielteil oder die Zielressource in keiner Weise.

Die CreateRelationship Methode ändert weder den Quellteil noch den Zielteil oder die Zielressource in irgendeiner Weise.

Das Ziel einer Beziehung kann keine andere Beziehung sein.

Weitere Informationen zu Paketbeziehungen finden Sie im Abschnitt 1.3 der Open Packaging Conventions (OPC) -Spezifikation, die zum Download verfügbar https://www.ecma-international.org/publications-and-standards/standards/ecma-376/ist.

Weitere Informationen zu XPS-Dokumenten finden Sie in der Open XML Paper Specification (XPS), die zum Download verfügbar https://www.ecma-international.org/publications-and-standards/standards/ecma-388/ist.

CreateRelationship(Uri, TargetMode, String)

Quelle:

PackagePart.cs

Erstellt eine Part-Level-Beziehung zwischen dieser PackagePart zu einem angegebenen Ziel PackagePart oder einer externen Ressource.

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

Parameter

targetUri

Uri

Der URI des Zielteils.

targetMode

TargetMode

Einer der Enumerationswerte. Wenn sich z Internal . B. der Zielteil innerhalb des Package; befindet oder External das Ziel eine Ressource außerhalb der Package.

relationshipType

String

Die Rolle der Beziehung.

Gibt zurück

PackageRelationship

Die Part-Level-Beziehung zwischen dieser PackagePart zu der Ziel PackagePart - oder externen Ressource.

Ausnahmen

InvalidOperationException

Der Teil wurde gelöscht.

-oder-

Das Package ist nicht geöffnet (Dispose(Boolean) oder Close() wurde aufgerufen).

ArgumentNullException

targetUri oder relationshipType ist null.

ArgumentOutOfRangeException

Der targetMode Parameter ist kein gültiger TargetMode Enumerationswert.

ArgumentException

Der durch die targetUri Beziehung identifizierte Teil ist eine Beziehung (das Ziel einer Beziehung kann keine andere Beziehung sein).

-oder-

targetMode wird als Internal absoluter targetUri externer URI angegeben.

IOException

Das Paket ist schreibgeschützt (eine neue Beziehung kann nicht hinzugefügt werden).

Hinweise

Eine Part-Level-Beziehung definiert eine Zuordnung zwischen diesem Teil und einem Zielteil oder einer Ressource. Eine Part-Level-Beziehung kann eine von zwei Formen sein.

• Zwischen einer Quelle PackagePart zu einem Ziel PackagePart innerhalb der Package.
• Zwischen einer Quelle PackagePart und einer Zielressource außerhalb des Pakets.

In einer Teilbeziehung wird der Quellteil als "Besitzer" der Beziehung betrachtet. Wenn der Quellteil gelöscht wird, werden alle Beziehungen, die dem Teil gehören, ebenfalls gelöscht. Der Vorgang zum Erstellen oder Löschen der Beziehung ändert den Zielteil oder die Zielressource in keiner Weise.

Die CreateRelationship Methode ändert weder den Quellteil noch den Zielteil oder die Zielressource in irgendeiner Weise.

Das Ziel einer Beziehung kann keine andere Beziehung sein.

Wenn targetMode angegeben Internalals , targetUri muss es sich um einen relativen URI handeln, der gemäß der generischen Syntaxspezifikation RFC 3986(Uniform Resource Identifier, URI) gebildet wird. Der interne relative URI kann entweder ein absoluter Pfad sein, der mit einem Schrägstrich ("/") beginnt, z. B. "/page1.xaml" oder "/images/picture4.jpg", oder mit einem relativen Pfad wie ".". /imagespicture1.jpg", das im Paketstamm ("/") als Basis-URI aufgelöst wird.

Wenn targetMode angegeben Externalals , kann es sich um einen absoluten oder relativen URI handeln, targetUri der gemäß der Generischen Syntaxspezifikation RFC 3986(Uniform Resource Identifier, URI) gebildet wird. "https://www.microsoft.com/page2.xml" ist ein Beispiel für einen absoluten URI, der auf eine externe Zielressource verweist "page2.xml". "images/picture1.jpg" ist ein Beispiel für einen relativen URI, der auch auf eine externe Zielressource verweist "1.jpg", die jedoch mit dem URI des Pakets selbst aufgelöst wird.

relationshipType muss ein URI sein, der gemäß der generischen Syntaxspezifikation von RFC 3986(Uniform Resource Identifier, URI) gebildet wird. Verschiedene Pakettypen können unterschiedliche Beziehungstypen auf Partebene definieren. In der folgenden Tabelle sind die partiell relationshipType definierten URIs für Dokumente aufgeführt, die der Open XML Paper Specification (XPS) entsprechen.

XPS-Dokument Part-Level Beziehung	Beziehungstyp-URI
Definitionen digitaler Signaturen	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
Erforderliche Ressource	http://schemas.microsoft.com/xps/2005/06/required-resource
Eingeschränkte Schriftart	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

Weitere Informationen zu Paketbeziehungen finden Sie im Abschnitt 1.3 der Open Packaging Conventions (OPC) -Spezifikation, die zum Download verfügbar https://www.ecma-international.org/publications-and-standards/standards/ecma-376/ist.

Weitere Informationen zu XPS-Dokumenten finden Sie in der Open XML Paper Specification (XPS), die zum Download verfügbar https://www.ecma-international.org/publications-and-standards/standards/ecma-388/ist.

Weitere Informationen

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• Spezifikation der Open Packaging-Konventionen

CreateRelationship(Uri, TargetMode, String, String)

Quelle:

PackagePart.cs

Erstellt eine Part-Level-Beziehung zwischen dieser PackagePart zu einem angegebenen Ziel PackagePart oder einer externen Ressource.

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

Parameter

targetUri

Uri

Der URI des Zielteils.

targetMode

TargetMode

Einer der Enumerationswerte. Wenn sich z Internal . B. der Zielteil innerhalb des Package; befindet oder External das Ziel eine Ressource außerhalb der Package.

relationshipType

String

Die Rolle der Beziehung.

id

String

Eine eindeutige ID für die Beziehung.

Gibt zurück

PackageRelationship

Die Part-Level-Beziehung zwischen dieser PackagePart zu der Ziel PackagePart - oder externen Ressource.

Ausnahmen

InvalidOperationException

Der Teil wurde gelöscht.

-oder-

Das Package ist nicht geöffnet (Dispose(Boolean) oder Close() wurde aufgerufen).

ArgumentNullException

targetUri oder relationshipType ist null.

ArgumentOutOfRangeException

Der targetMode Parameter ist kein gültiger TargetMode Enumerationswert.

ArgumentException

Der durch die targetUri Beziehung identifizierte Teil ist eine Beziehung (das Ziel einer Beziehung kann keine andere Beziehung sein).

-oder-

targetMode wird als Internal absoluter targetUri externer URI angegeben.

IOException

Das Paket ist schreibgeschützt (eine neue Beziehung kann nicht hinzugefügt werden).

XmlException

id ist kein gültiger XML-Bezeichner.

-oder-

Ein Teil mit dem angegebenen id ist bereits vorhanden.

Hinweise

Eine Part-Level-Beziehung definiert eine Zuordnung zwischen diesem Teil und einem Zielteil oder einer Ressource. Eine Part-Level-Beziehung kann eine von zwei Formen sein:

• Zwischen einer Quelle PackagePart zu einem Ziel PackagePart innerhalb der Package.
• Zwischen einer Quelle PackagePart und einer Zielressource außerhalb des Pakets.

In einer Teilbeziehung wird der Quellteil als "Besitzer" der Beziehung betrachtet. Wenn der Quellteil gelöscht wird, werden alle Beziehungen, die dem Teil gehören, ebenfalls gelöscht. Der Vorgang zum Erstellen oder Löschen der Beziehung ändert den Zielteil oder die Zielressource in keiner Weise.

id muss ein gültiger XML-Bezeichner sein. Der id Typ ist "xsd:ID" und muss den im XML-Schemateil 2 vorgeschriebenen Benennungskonventionen entsprechen ( siehe https://www.w3.org/TR/xmlschema-2/#ID).

Die CreateRelationship Methode ändert weder den Quellteil noch den Zielteil oder die Zielressource in irgendeiner Weise.

Das Ziel einer Beziehung kann keine andere Beziehung sein.

Wenn targetMode angegeben Internalals , targetUri muss es sich um einen relativen URI handeln, der gemäß der generischen Syntaxspezifikation RFC 3986(Uniform Resource Identifier, URI) gebildet wird. Der interne relative URI kann entweder ein absoluter Pfad sein, der mit einem Schrägstrich ("/") beginnt, z. B. "/page1.xaml" oder "/images/picture4.jpg", oder mit einem relativen Pfad wie ".". /imagespicture1.jpg", das im Paketstamm ("/") als Basis-URI aufgelöst wird.

Wenn targetMode angegeben Externalals , kann es sich um einen absoluten oder relativen URI handeln, targetUri der gemäß der Generischen Syntaxspezifikation RFC 3986(Uniform Resource Identifier, URI) gebildet wird. "https://www.microsoft.com/page2.xml" ist ein Beispiel für einen absoluten URI, der auf eine externe Zielressource verweist "page2.xml". "images/picture1.jpg" ist ein Beispiel für einen relativen URI, der auch auf eine externe Zielressource verweist "1.jpg", die jedoch mit dem URI des Pakets selbst aufgelöst wird.

relationshipType muss ein URI sein, der gemäß der generischen Syntaxspezifikation von RFC 3986(Uniform Resource Identifier, URI) gebildet wird. Verschiedene Pakettypen können unterschiedliche Beziehungstypen auf Partebene definieren. In der folgenden Tabelle sind die partiell relationshipType definierten URIs für Dokumente aufgeführt, die der Open XML Paper Specification (XPS) entsprechen.

XPS-Dokument Part-Level Beziehung	Beziehungstyp-URI
Definitionen digitaler Signaturen	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
Erforderliche Ressource	http://schemas.microsoft.com/xps/2005/06/required-resource
Eingeschränkte Schriftart	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

Weitere Informationen zu Paketbeziehungen finden Sie im Abschnitt 1.3 der Open Packaging Conventions (OPC) -Spezifikation, die zum Download verfügbar https://www.ecma-international.org/publications-and-standards/standards/ecma-376/ist.

Weitere Informationen zu XPS-Dokumenten finden Sie unter open XML Paper Specification (XPS), das zum Download verfügbar https://www.ecma-international.org/publications-and-standards/standards/ecma-388/ist.

Weitere Informationen

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• Spezifikation der Open Packaging-Konventionen