PackagePart.CreateRelationship Metoda

Definice

Obor názvů:

System.IO.Packaging

Sestavení:

System.IO.Packaging.dll

Balíček:

System.IO.Packaging v9.0.0-preview.6.24327.7

Vytvoří vztah na úrovni části mezi tímto PackagePart k zadanému cílovému PackagePart nebo externímu prostředku.

Přetížení

CreateRelationship(Uri, TargetMode, String)	Vytvoří vztah na úrovni části mezi tímto PackagePart k zadanému cílovému PackagePart nebo externímu prostředku.
CreateRelationship(Uri, TargetMode, String, String)	Vytvoří vztah na úrovni části mezi tímto PackagePart k zadanému cílovému PackagePart nebo externímu prostředku.

Poznámky

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

• Mezi zdrojovým PackagePart do cílového PackagePart uvnitř Package.

• Mezi zdrojovým PackagePart do cílového prostředku mimo balíček.

Ve vztahu části je zdrojová část považována za "vlastníka" relace. Po odstranění zdrojové části se odstraní také všechny relace vlastněné částí. Proces vytvoření nebo odstranění relace nijak nemění cílovou část nebo prostředek.

Metoda CreateRelationship nijak nemění zdrojovou část ani cílovou část nebo prostředek.

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

Další informace o relacích balíčků naleznete v části 1.3 Open Packaging Conventions (OPC) specifikace k dispozici ke stažení na https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

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

CreateRelationship(Uri, TargetMode, String)

Zdroj:

PackagePart.cs

Vytvoří vztah na úrovni části mezi tímto PackagePart k zadanému cílovému PackagePart nebo externímu prostředku.

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 cílová část je uvnitř Package; nebo External, pokud je cílem prostředek mimo Package.

relationshipType

String

Role vztahu.

Návraty

PackageRelationship

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

Výjimky

InvalidOperationException

Část byla odstraněna.

-nebo-

Package není otevřen (Dispose(Boolean) nebo Close() byl volána).

ArgumentNullException

targetUri nebo relationshipType je null.

ArgumentOutOfRangeException

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

ArgumentException

Část identifikovaná targetUri je relace (cíl relace nemůže být jinou relací).

-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. Relace na úrovni části může být jedna ze dvou forem.

• Mezi zdrojovým PackagePart do cílového PackagePart uvnitř Package.

• Mezi zdrojovým PackagePart do cílového prostředku mimo balíček.

Ve vztahu části je zdrojová část považována za "vlastníka" relace. Po odstranění zdrojové části se odstraní také všechny relace vlastněné částí. Proces vytvoření nebo odstranění relace nijak nemění cílovou část nebo prostředek.

Metoda CreateRelationship nijak nemění zdrojovou část ani cílovou část nebo prostředek.

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

Je-li zadán jako , musí být relativní identifikátor URI, který je vytvořen v souladu se specifikací RFC 3986Identifikátor URI (Uniform Resource Identifier). Interní relativní identifikátor URI může být absolutní cesta, která začíná znakem lomítka (/), například /page1.xaml nebo /images/picture4.jpgnebo relativní cestou, například .. /imagespicture1.jpg", která se překládá s kořenem balíčku ("/") jako základní identifikátor URI.

Pokud je targetMode zadán jako External, targetUri může být buď absolutní, nebo relativní identifikátor URI vytvořený v souladu se specifikací RFC 3986 identifikátoru URI (Uniform Resource Identifier). "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říkladem relativního identifikátoru URI, který také odkazuje na externí cílový prostředek "1.jpg", ale který se překládá proti identifikátoru URI samotného balíčku.

relationshipType musí být identifikátor URI, který je vytvořen podle specifikace RFC 3986 identifikátoru URI (Uniform Resource Identifier). Různé typy balíčků mohou definovat různé typy relací na úrovni částí. Následující tabulka ukazuje identifikátory URI na úrovni části definované pro dokumenty, které odpovídajíformátu XPS (Open XML Paper Specification).

Relace Part-Level dokumentu XPS	Identifikátor URI typu relace
Definice digitálního podpisu	http://schemas.microsoft.com/xps/2005/06/signature-definitions
DiscardControl	http://schemas.microsoft.com/xps/2005/06/discard-control
Struktura dokumentů	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
Úvodní část	http://schemas.microsoft.com/xps/2005/06/fixedrepresentation
StoryFragments	http://schemas.microsoft.com/xps/2005/06/storyfragments

Další informace o relacích balíčků naleznete v části 1.3 Open Packaging Conventions (OPC) specifikace k dispozici ke stažení na https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

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

Viz také

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• specifikace konvencí open packaging

CreateRelationship(Uri, TargetMode, String, String)

Zdroj:

PackagePart.cs

Vytvoří vztah na úrovni části mezi tímto PackagePart k zadanému cílovému PackagePart nebo externímu prostředku.

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 cílová část je uvnitř Package; nebo External, pokud je cílem prostředek mimo Package.

relationshipType

String

Role vztahu.

id

String

Jedinečné ID relace.

Návraty

PackageRelationship

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

Výjimky

InvalidOperationException

Část byla odstraněna.

-nebo-

Package není otevřen (Dispose(Boolean) nebo Close() byl volána).

ArgumentNullException

targetUri nebo relationshipType je null.

ArgumentOutOfRangeException

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

ArgumentException

Část identifikovaná targetUri je relace (cíl relace nemůže být jinou relací).

-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. Relace na úrovni části může být jedna ze dvou forem.

• Mezi zdrojovým PackagePart do cílového PackagePart uvnitř Package.

• Mezi zdrojovým PackagePart do cílového prostředku mimo balíček.

Ve vztahu části je zdrojová část považována za "vlastníka" relace. Po odstranění zdrojové části se odstraní také všechny relace vlastněné částí. Proces vytvoření nebo odstranění relace nijak nemění cílovou část nebo prostředek.

id musí být platný identifikátor XML. Typ id je xsd:ID a musí dodržovat zásady vytváření názvů předepsané v části SCHÉMATU XML 2: Specifikace datových typů (viz https://www.w3.org/TR/xmlschema-2/#ID).

Metoda CreateRelationship nijak nemění zdrojovou část ani cílovou část nebo prostředek.

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

Je-li zadán jako , musí být relativní identifikátor URI, který je vytvořen v souladu se specifikací RFC 3986Identifikátor URI (Uniform Resource Identifier). Interní relativní identifikátor URI může být absolutní cesta, která začíná znakem lomítka (/), například /page1.xaml nebo /images/picture4.jpgnebo relativní cestou, například .. /imagespicture1.jpg", která se překládá s kořenem balíčku ("/") jako základní identifikátor URI.

Pokud je targetMode zadán jako External, targetUri může být buď absolutní, nebo relativní identifikátor URI vytvořený v souladu se specifikací RFC 3986 identifikátoru URI (Uniform Resource Identifier). "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říkladem relativního identifikátoru URI, který také odkazuje na externí cílový prostředek "1.jpg", ale který se překládá proti identifikátoru URI samotného balíčku.

relationshipType musí být identifikátor URI, který je vytvořen podle specifikace RFC 3986 identifikátoru URI (Uniform Resource Identifier). Různé typy balíčků mohou definovat různé typy relací na úrovni částí. Následující tabulka ukazuje identifikátory URI na úrovni části definované pro dokumenty, které odpovídajíformátu XPS (Open XML Paper Specification).

Relace Part-Level dokumentu XPS	Identifikátor URI typu relace
Definice digitálního podpisu	http://schemas.microsoft.com/xps/2005/06/signature-definitions
DiscardControl	http://schemas.microsoft.com/xps/2005/06/discard-control
Struktura dokumentů	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
Úvodní část	http://schemas.microsoft.com/xps/2005/06/fixedrepresentation
StoryFragments	http://schemas.microsoft.com/xps/2005/06/storyfragments

Další informace o relacích balíčků naleznete v části 1.3 Open Packaging Conventions (OPC) specifikace k dispozici ke stažení na https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

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

Viz také

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• specifikace konvencí open packaging