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 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)
- 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.PackageRelationshipPublic Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String) As PackageRelationshipParameter
- 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.
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
| 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
Gilt für:
CreateRelationship(Uri, TargetMode, String, String)
- 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.PackageRelationshipPublic Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String, id As String) As PackageRelationshipParameter
- 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.
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
| 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
Gilt für:
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter: https://aka.ms/ContentUserFeedback.
Einreichen und Feedback anzeigen für