PackagePart.CreateRelationship Methode

Definition

Namespace:

System.IO.Packaging

Assembly:

System.IO.Packaging.dll

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

Überlädt

CreateRelationship(Uri, TargetMode, String)	Erstellt eine Part-Level-Beziehung zwischen diesem PackagePart zu einem angegebenen Ziel PackagePart oder einer externen Ressource.
CreateRelationship(Uri, TargetMode, String, String)	Erstellt eine Part-Level-Beziehung zwischen diesem 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 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 in Abschnitt 1.3 der Open Packaging Conventions (OPC) Spezifikation, die zum Download unter https://www.ecma-international.org/publications-and-standards/standards/ecma-376/zur Verfügung steht.

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

CreateRelationship(Uri, TargetMode, String)

Erstellt eine Part-Level-Beziehung zwischen diesem 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. Beispiel: Internal, wenn sich der Zielteil innerhalb des Packagebefindet; oder External, wenn das Ziel eine Ressource außerhalb des Packageist.

relationshipType

String

Die Rolle der Beziehung.

Gibt zurück

PackageRelationship

Die Part-Level-Beziehung zwischen diesem PackagePart zum Ziel PackagePart oder einer externen Ressource.

Ausnahmen

InvalidOperationException

Der Teil wurde gelöscht.

-oder-

Die 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 vom targetUri identifizierte Teil ist eine Beziehung (das Ziel einer Beziehung kann keine andere Beziehung sein).

-oder-

targetMode wird als Internal angegeben, aber targetUri ist ein absoluter externer URI.

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 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 als Internalangegeben ist, muss targetUri ein relativer URI sein, der gemäß der RFC 3986URI (Uniform Resource Identifier) Generic Syntax Spezifikation 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 als Externalangegeben ist, kann targetUri entweder ein absoluter oder relativer URI sein, der gemäß der spezifikation RFC 3986Uniform Resource Identifier (URI) generic syntax gebildet wird. "https://www.microsoft.com/page2.xml" ist ein Beispiel für einen absoluten URI, der auf eine externe Zielressource verweistpage2.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 RFC 3986URI (Uniform Resource Identifier) Generic Syntax Spezifikation gebildet wird. Verschiedene Pakettypen können unterschiedliche Beziehungstypen auf Partebene definieren. In der folgenden Tabelle sind die partiell URIs aufgeführt, die für Dokumente definiert sind, die denOpen 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 in Abschnitt 1.3 der Open Packaging Conventions (OPC) Spezifikation, die zum Download unter https://www.ecma-international.org/publications-and-standards/standards/ecma-376/zur Verfügung steht.

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

Weitere Informationen

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

CreateRelationship(Uri, TargetMode, String, String)

Erstellt eine Part-Level-Beziehung zwischen diesem 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. Beispiel: Internal, wenn sich der Zielteil innerhalb des Packagebefindet; oder External, wenn das Ziel eine Ressource außerhalb des Packageist.

relationshipType

String

Die Rolle der Beziehung.

id

String

Eine eindeutige ID für die Beziehung.

Gibt zurück

PackageRelationship

Die Part-Level-Beziehung zwischen diesem PackagePart zum Ziel PackagePart oder einer externen Ressource.

Ausnahmen

InvalidOperationException

Der Teil wurde gelöscht.

-oder-

Die 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 vom targetUri identifizierte Teil ist eine Beziehung (das Ziel einer Beziehung kann keine andere Beziehung sein).

-oder-

targetMode wird als Internal angegeben, aber targetUri ist ein absoluter externer URI.

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 der 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 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: Datentypen Spezifikation (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 als Internalangegeben ist, muss targetUri ein relativer URI sein, der gemäß der RFC 3986URI (Uniform Resource Identifier) Generic Syntax Spezifikation 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 als Externalangegeben ist, kann targetUri entweder ein absoluter oder relativer URI sein, der gemäß der spezifikation RFC 3986Uniform Resource Identifier (URI) generic syntax 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 RFC 3986URI (Uniform Resource Identifier) Generic Syntax Spezifikation gebildet wird. Verschiedene Pakettypen können unterschiedliche Beziehungstypen auf Partebene definieren. In der folgenden Tabelle sind die partiell URIs aufgeführt, die für Dokumente definiert sind, die denOpen 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 in Abschnitt 1.3 der Open Packaging Conventions (OPC) Spezifikation, die zum Download unter https://www.ecma-international.org/publications-and-standards/standards/ecma-376/zur Verfügung steht.

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

Weitere Informationen

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