PackagePart.CreateRelationship Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erstellt eine Beziehung auf Partebene zwischen dem PackagePart und einem angegebenen Ziel-PackagePart oder einer angegebenen externen Zielressource.
Überlädt
CreateRelationship(Uri, TargetMode, String) |
Erstellt eine Beziehung auf Partebene zwischen dem PackagePart und einem angegebenen Ziel-PackagePart oder einer angegebenen externen Zielressource. |
CreateRelationship(Uri, TargetMode, String, String) |
Erstellt eine Beziehung auf Partebene zwischen dem PackagePart und einem angegebenen Ziel-PackagePart oder einer angegebenen externen Zielressource. |
Hinweise
Eine Beziehung auf Teilebene definiert eine Zuordnung zwischen diesem Teil und einem Zielteil oder einer Ressource. Eine Beziehung auf Teilebene kann eine von zwei Formen sein.
Zwischen einer Quelle PackagePart und einem Ziel PackagePart innerhalb von Package.
Zwischen einer Quelle PackagePart und einer Zielressource außerhalb des Pakets.
In einer Teilbeziehung wird der Quellteil als "Besitzer" der Beziehung betrachtet. Wenn das Quellteil gelöscht wird, werden alle Beziehungen, die dem Teil gehören, ebenfalls gelöscht. Der Prozess 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 Ressource physisch.
Das Ziel einer Beziehung kann nicht eine andere Beziehung sein.
Weitere Informationen zu Paketbeziehungen finden Sie in Abschnitt 1.3 der OPC-Spezifikation (Open Packaging Conventions), die unter heruntergeladen werden https://www.ecma-international.org/publications-and-standards/standards/ecma-376/kann.
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
Erstellt eine Beziehung auf Partebene zwischen dem PackagePart und einem angegebenen Ziel-PackagePart oder einer angegebenen externen Zielressource.
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 Zielparts.
- targetMode
- TargetMode
Einer der Enumerationswerte. Beispielsweise Internal, wenn sich das Zielpart innerhalb des Package befindet, oder External, wenn das Ziel eine Ressource außerhalb des Package ist.
- relationshipType
- String
Die Rolle der Beziehung.
Gibt zurück
Die Beziehung auf Partebene zwischen dem PackagePart und dem Ziel-PackagePart oder der externen Zielressource.
Ausnahmen
Das Part wurde gelöscht.
- oder -
Das 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.
Das mit dem targetUri
angegebene Part ist eine Beziehung (das Ziel einer Beziehung darf keine andere Beziehung sein).
- oder -
targetMode
wird als Internal angegeben, targetUri
ist jedoch ein absoluter externer URI.
Das Paket ist schreibgeschützt (es kann keine neue Beziehung hinzugefügt werden).
Hinweise
Eine Beziehung auf Teilebene definiert eine Zuordnung zwischen diesem Teil und einem Zielteil oder einer Ressource. Eine Beziehung auf Teilebene kann eine von zwei Formen sein.
Zwischen einer Quelle PackagePart und einem Ziel PackagePart innerhalb von Package.
Zwischen einer Quelle PackagePart und einer Zielressource außerhalb des Pakets.
In einer Teilbeziehung wird der Quellteil als "Besitzer" der Beziehung betrachtet. Wenn das Quellteil gelöscht wird, werden alle Beziehungen, die dem Teil gehören, ebenfalls gelöscht. Der Prozess 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 Ressource physisch.
Das Ziel einer Beziehung kann nicht eine andere Beziehung sein.
Wenn targetMode
als Internalangegeben ist, targetUri
muss es sich um einen relativen URI handeln, der gemäß der spezifikation der generischen Syntax von 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 ein relativer Pfad wie ".. /imagespicture1.jpg", das für den Paketstamm ("/") als Basis-URI aufgelöst wird.
Wenn targetMode
als Externalangegeben ist, targetUri
kann es sich entweder um einen absoluten oder relativen URI handeln, der gemäß der generischen Syntaxspezifikation von 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 "page2.xml" verweist. "images/picture1.jpg" ist ein Beispiel für einen relativen URI, der ebenfalls auf eine externe Zielressource "1.jpg" verweist, die aber 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 Teilebene definieren. Die folgende Tabelle zeigt die URIs auf Teilebene relationshipType
, die für Dokumente definiert sind, die der Open XML Paper Specification (XPS) entsprechen.
XPS-Dokument Part-Level Beziehung | Beziehungstyp-URI |
---|---|
Definitionen für digitale 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 OPC-Spezifikation (Open Packaging Conventions), die unter heruntergeladen werden https://www.ecma-international.org/publications-and-standards/standards/ecma-376/kann.
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)
- Open Packaging Conventions Specification
Gilt für:
CreateRelationship(Uri, TargetMode, String, String)
- Quelle:
- PackagePart.cs
- Quelle:
- PackagePart.cs
- Quelle:
- PackagePart.cs
Erstellt eine Beziehung auf Partebene zwischen dem PackagePart und einem angegebenen Ziel-PackagePart oder einer angegebenen externen Zielressource.
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 Zielparts.
- targetMode
- TargetMode
Einer der Enumerationswerte. Beispielsweise Internal, wenn sich das Zielpart innerhalb des Package befindet, oder External, wenn das Ziel eine Ressource außerhalb des Package ist.
- relationshipType
- String
Die Rolle der Beziehung.
- id
- String
Eine eindeutige ID für die Beziehung.
Gibt zurück
Die Beziehung auf Partebene zwischen dem PackagePart und dem Ziel-PackagePart oder der externen Zielressource.
Ausnahmen
Das Part wurde gelöscht.
- oder -
Das 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.
Das mit dem targetUri
angegebene Part ist eine Beziehung (das Ziel einer Beziehung darf keine andere Beziehung sein).
- oder -
targetMode
wird als Internal angegeben, targetUri
ist jedoch ein absoluter externer URI.
Das Paket ist schreibgeschützt (es kann keine neue Beziehung hinzugefügt werden).
id
ist kein gültiger XML-Bezeichner.
- oder -
Ein Part mit der angegebenen id
ist bereits vorhanden.
Hinweise
Eine Beziehung auf Teilebene definiert eine Zuordnung zwischen diesem Teil und einem Zielteil oder einer Ressource. Eine Beziehung auf Teilebene kann eine von zwei Formen sein.
Zwischen einer Quelle PackagePart und einem Ziel PackagePart innerhalb von Package.
Zwischen einer Quelle PackagePart und einer Zielressource außerhalb des Pakets.
In einer Teilbeziehung wird der Quellteil als "Besitzer" der Beziehung betrachtet. Wenn das Quellteil gelöscht wird, werden alle Beziehungen, die dem Teil gehören, ebenfalls gelöscht. Der Prozess 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 In xml Schema Part 2: Datatypes-Spezifikation vorgeschriebenen Benennungskonventionen entsprechen (siehe https://www.w3.org/TR/xmlschema-2/#ID).
Die CreateRelationship -Methode ändert weder den Quellteil noch den Zielteil oder die Ressource physisch.
Das Ziel einer Beziehung kann nicht eine andere Beziehung sein.
Wenn targetMode
als Internalangegeben ist, targetUri
muss es sich um einen relativen URI handeln, der gemäß der spezifikation der generischen Syntax von 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 ein relativer Pfad wie ".. /imagespicture1.jpg", das für den Paketstamm ("/") als Basis-URI aufgelöst wird.
Wenn targetMode
als Externalangegeben ist, targetUri
kann es sich entweder um einen absoluten oder relativen URI handeln, der gemäß der generischen Syntaxspezifikation von 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 "page2.xml" verweist. "images/picture1.jpg" ist ein Beispiel für einen relativen URI, der ebenfalls auf eine externe Zielressource "1.jpg" verweist, die aber 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 Teilebene definieren. Die folgende Tabelle zeigt die URIs auf Teilebene relationshipType
, die für Dokumente definiert sind, die der Open XML Paper Specification (XPS) entsprechen.
XPS-Dokument Part-Level Beziehung | Beziehungstyp-URI |
---|---|
Definitionen für digitale 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 OPC-Spezifikation (Open Packaging Conventions), die unter heruntergeladen werden https://www.ecma-international.org/publications-and-standards/standards/ecma-376/kann.
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)
- Open Packaging Conventions Specification
Gilt für:
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für