PackagePart.CreateRelationship Metoda

Definice

Obor názvů:

System.IO.Packaging

Sestavení:

System.IO.Packaging.dll

Balíček:

System.IO.Packaging v8.0.0

Vytvoří vztah na úrovni části mezi tímto PackagePart a zadaným cílovým PackagePart nebo externím prostředkem.

Přetížení

CreateRelationship(Uri, TargetMode, String)	Vytvoří mezi tím PackagePart vztah na úrovni části s určeným cílovým PackagePart nebo externím prostředkem.
CreateRelationship(Uri, TargetMode, String, String)	Vytvoří mezi tím PackagePart vztah na úrovni části s určeným cílovým PackagePart nebo externím prostředkem.

Poznámky

Vztah na úrovni částí definuje přidružení mezi touto částí a cílovou částí nebo prostředkem. Vztah na úrovni části může mít jednu ze dvou forem.

• Mezi zdrojem PackagePart a cílem PackagePart uvnitř objektu Package.

• Mezi zdrojem PackagePart a cílovým prostředkem mimo balíček.

V relaci části se zdrojová část považuje za vlastníka relace. Při odstranění zdrojové části se odstraní také všechny relace, které tato část vlastní. Proces vytvoření nebo odstranění vztahu nijak fyzicky nemění cílovou část nebo prostředek.

Metoda CreateRelationship žádným způsobem fyzicky nemění ani zdrojovou část, cílovou část nebo prostředek.

Cílem relace nemůže být jiná relace.

Další informace o vztazích mezi balíčky najdete v části 1.3 specifikace OPC (Open Packaging Conventions), která je k dispozici ke stažení na adrese https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Další informace o dokumentech XPS naleznete v dokumentu XPS (Open XML Paper Specification), který je k dispozici ke stažení na adrese https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.

CreateRelationship(Uri, TargetMode, String)

Zdroj:

PackagePart.cs

Vytvoří mezi tím PackagePart vztah na úrovni části s určeným cílovým PackagePart nebo externím prostředkem.

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

Parametry

targetUri

Uri

Identifikátor URI cílové části

targetMode

TargetMode

Jedna z hodnot výčtu Například Internal pokud se cílová část nachází uvnitř objektu Package; nebo External pokud je cílem prostředek mimo Package.

relationshipType

String

Role relace.

Návraty

PackageRelationship

Vztah na úrovni části mezi tímto PackagePart a cílovým PackagePart nebo externím prostředkem.

Výjimky

InvalidOperationException

Část byla odstraněna.

-nebo-

Položka Package není otevřená (Dispose(Boolean) nebo Close() byla volána).

ArgumentNullException

targetUri nebo relationshipType je null.

ArgumentOutOfRangeException

Parametr targetMode není platná TargetMode hodnota výčtu.

ArgumentException

Část identifikovaná parametrem targetUri je relace (cílem relace nemůže být jiná relace).

-nebo-

targetMode je zadán jako Internal , ale targetUri je absolutní externí identifikátor URI.

IOException

Balíček je jen pro čtení (novou relaci nelze přidat).

Poznámky

Vztah na úrovni části definuje přidružení mezi touto částí a cílovou částí nebo prostředkem. Vztah na dílčí úrovni může být jedním ze dvou forem.

• Mezi zdrojem PackagePart a cílem PackagePart uvnitř objektu Package.

• Mezi zdrojem PackagePart a cílovým prostředkem mimo balíček.

V relaci části se zdrojová část považuje za vlastníka relace. Při odstranění zdrojové části se odstraní také všechny relace vlastněné částí. Proces vytvoření nebo odstranění relace fyzicky nemění cílovou část nebo prostředek žádným způsobem.

Metoda CreateRelationship žádným způsobem fyzicky nemění zdrojovou část ani cílovou část nebo prostředek.

Cílem relace nemůže být jiná relace.

Pokud targetMode je zadán jako Internal, targetUri musí být relativní identifikátor URI, který je vytvořen v souladu se specifikací obecné syntaxe identifikátoru URI (Uniform Resource Identifier)RFC 3986. Interní relativní identifikátor URI může být absolutní cesta, která začíná znakem lomítka ("/"), například "/page1.xaml" nebo "/images/picture4.jpg", nebo relativní cestou, například ".. /imagespicture1.jpg", který se překládá proti kořenovému adresáři balíčku ("/") jako základnímu identifikátoru URI.

Pokud targetMode je zadaný jako External, targetUri může to být buď absolutní, nebo relativní identifikátor URI vytvořený v souladu se specifikací obecné syntaxe identifikátoru URI (Uniform Resource Identifier)RFC 3986. "https://www.microsoft.com/page2.xml" je příkladem absolutního identifikátoru URI, který odkazuje na externí cílový prostředek "page2.xml". "images/picture1.jpg" je příklad relativního identifikátoru URI, který také odkazuje na externí cílový prostředek "1.jpg", ale který se překládá na identifikátor URI samotného balíčku.

relationshipTypemusí být identifikátor URI, který je vytvořen podle specifikace obecné syntaxe identifikátoru URI (Uniform Resource Identifier)RFC 3986. Různé typy balíčků můžou definovat různé typy relací na úrovni částí. Následující tabulka uvádí identifikátory URI na úrovni relationshipType částí definované pro dokumenty, které odpovídají specifikaci XPS (Open XML Paper Specification).

Relace Part-Level dokumentů XPS	Identifikátor URI typu relace
Definice digitálních podpisů	http://schemas.microsoft.com/xps/2005/06/signature-definitions
Zahodit Ovládací prvek	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
Požadovaný prostředek	http://schemas.microsoft.com/xps/2005/06/required-resource
Omezené písmo	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

Další informace o vztazích mezi balíčky najdete v části 1.3 specifikace Open Packaging Conventions (OPC), která je k dispozici ke stažení na adrese https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Další informace o dokumentech XPS najdete v souboru XPS (Open XML Paper Specification), který je k dispozici ke stažení na adrese https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.

Viz také

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• Specifikace open packaging conventions

CreateRelationship(Uri, TargetMode, String, String)

Zdroj:

PackagePart.cs

Vytvoří vztah na úrovni části mezi tímto PackagePart a zadaným cílovým PackagePart nebo externím prostředkem.

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

Parametry

targetUri

Uri

Identifikátor URI cílové části

targetMode

TargetMode

Jedna z hodnot výčtu Například Internal pokud se cílová část nachází uvnitř objektu Package; nebo External pokud je cílem prostředek mimo Package.

relationshipType

String

Role relace.

id

String

Jedinečné ID relace.

Návraty

PackageRelationship

Vztah na úrovni části mezi tímto PackagePart a cílovým PackagePart nebo externím prostředkem.

Výjimky

InvalidOperationException

Část byla odstraněna.

-nebo-

Položka Package není otevřená (Dispose(Boolean) nebo Close() byla volána).

ArgumentNullException

targetUri nebo relationshipType je null.

ArgumentOutOfRangeException

Parametr targetMode není platná TargetMode hodnota výčtu.

ArgumentException

Část identifikovaná parametrem targetUri je relace (cílem relace nemůže být jiná relace).

-nebo-

targetMode je zadán jako Internal , ale targetUri je absolutní externí identifikátor URI.

IOException

Balíček je jen pro čtení (novou relaci nelze přidat).

XmlException

id není platný identifikátor XML.

-nebo-

Část se zadaným id již existuje.

Poznámky

Vztah na úrovni části definuje přidružení mezi touto částí a cílovou částí nebo prostředkem. Vztah na dílčí úrovni může být jedním ze dvou forem.

• Mezi zdrojem PackagePart a cílem PackagePart uvnitř objektu Package.

• Mezi zdrojem PackagePart a cílovým prostředkem mimo balíček.

V relaci části se zdrojová část považuje za vlastníka relace. Při odstranění zdrojové části se odstraní také všechny relace vlastněné částí. Proces vytvoření nebo odstranění relace fyzicky nemění cílovou část nebo prostředek žádným způsobem.

id musí být platným identifikátorem XML. Typ id je xsd:ID a musí se řídit konvencemi vytváření názvů stanovenými ve schématu XML Část 2: Specifikace datových typů (viz https://www.w3.org/TR/xmlschema-2/#ID).

Metoda CreateRelationship žádným způsobem fyzicky nemění zdrojovou část ani cílovou část nebo prostředek.

Cílem relace nemůže být jiná relace.

Pokud targetMode je zadán jako Internal, targetUri musí být relativní identifikátor URI, který je vytvořen v souladu se specifikací obecné syntaxe identifikátoru URI (Uniform Resource Identifier)RFC 3986. Interní relativní identifikátor URI může být absolutní cesta, která začíná znakem lomítka ("/"), například "/page1.xaml" nebo "/images/picture4.jpg", nebo relativní cestou, například ".. /imagespicture1.jpg", který se překládá proti kořenovému adresáři balíčku ("/") jako základnímu identifikátoru URI.

Pokud targetMode je zadaný jako External, targetUri může to být buď absolutní, nebo relativní identifikátor URI vytvořený v souladu se specifikací obecné syntaxe identifikátoru URI (Uniform Resource Identifier)RFC 3986. "https://www.microsoft.com/page2.xml" je příkladem absolutního identifikátoru URI, který odkazuje na externí cílový prostředek "page2.xml". "images/picture1.jpg" je příklad relativního identifikátoru URI, který také odkazuje na externí cílový prostředek "1.jpg", ale který se překládá na identifikátor URI samotného balíčku.

relationshipTypemusí být identifikátor URI, který je vytvořen podle specifikace obecné syntaxe identifikátoru URI (Uniform Resource Identifier)RFC 3986. Různé typy balíčků můžou definovat různé typy relací na úrovni částí. Následující tabulka uvádí identifikátory URI na úrovni relationshipType částí definované pro dokumenty, které odpovídají specifikaci XPS (Open XML Paper Specification).

Relace Part-Level dokumentů XPS	Identifikátor URI typu relace
Definice digitálních podpisů	http://schemas.microsoft.com/xps/2005/06/signature-definitions
Zahodit Ovládací prvek	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
Požadovaný prostředek	http://schemas.microsoft.com/xps/2005/06/required-resource
Omezené písmo	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

Další informace o vztazích mezi balíčky najdete v části 1.3 specifikace Open Packaging Conventions (OPC), která je k dispozici ke stažení na adrese https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Další informace o dokumentech XPS naleznete v souboru XPS (Open XML Paper Specification) k dispozici ke stažení na adrese https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.

Viz také

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• Open Packaging Conventions Specification