Freigeben über


PackagePart.CreateRelationship Methode

Definition

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.

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)

Quelle:
PackagePart.cs
Quelle:
PackagePart.cs
Quelle:
PackagePart.cs
Quelle:
PackagePart.cs
Quelle:
PackagePart.cs

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

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

Ausnahmen

Der Teil wurde gelöscht.

-oder-

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

targetUri oder relationshipType ist null.

Der targetMode-Parameter ist kein gültiger TargetMode Enumerationswert.

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.

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.

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

Gilt für:

CreateRelationship(Uri, TargetMode, String, String)

Quelle:
PackagePart.cs
Quelle:
PackagePart.cs
Quelle:
PackagePart.cs
Quelle:
PackagePart.cs
Quelle:
PackagePart.cs

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

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

Ausnahmen

Der Teil wurde gelöscht.

-oder-

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

targetUri oder relationshipType ist null.

Der targetMode-Parameter ist kein gültiger TargetMode Enumerationswert.

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.

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

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.

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

Gilt für: