PackagePart.CreateRelationship メソッド

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

パラメーター

返品

この PackagePart とターゲット PackagePart または外部リソースの間のパーツ レベルのリレーションシップ。

例外

注釈

パーツ レベルのリレーションシップは、このパーツとターゲット パーツまたはリソースの間の関連付けを定義します。 パート レベルのリレーションシップには、2 つの形式のいずれかを指定できます。

• Package内のターゲット PackagePartへのソース PackagePart間。
• ソース PackagePart パッケージの外部にあるターゲット リソースとの間。

パーツリレーションシップでは、ソース パーツはリレーションシップの "所有者" と見なされます。 ソース パーツが削除されると、パーツが所有するすべてのリレーションシップも削除されます。 リレーションシップを作成または削除するプロセスでは、ターゲットパーツまたはリソースが物理的に変更されることはありません。

CreateRelationshipメソッドは、ソース パーツまたはターゲット パーツまたはリソースを物理的に変更しません。

リレーションシップのターゲットを別のリレーションシップにすることはできません。

targetModeがInternalとして指定されている場合、targetUriは RFC 3986Uniform Resource Identifier (URI) ジェネリック構文の仕様に従って形成された相対 URI である必要があります。 内部相対 URI には、"/page1.xaml" や "/images/picture4.jpg"などのスラッシュ ("/") 文字で始まる絶対パス、または ".などの相対パスを指定できます。/imagespicture1.jpg" は、ベース URI としてパッケージ ルート ("/") に対して解決されます。

targetModeがExternalとして指定されている場合、targetUriは RFC 3986Uniform Resource Identifier (URI) ジェネリック構文仕様に従って形成された絶対 URI または相対 URI のいずれかになります。 "https://www.microsoft.com/page2.xml" は、外部ターゲット リソース "page2.xml" を参照する絶対 URI の例です。 "images/picture1.jpg" は、外部ターゲット リソース "1.jpg" も参照する相対 URI の例ですが、パッケージ自体の URI に対して解決されます。

relationshipType は、 RFC 3986Uniform Resource Identifier (URI) ジェネリック構文 仕様に従って形成された URI である必要があります。 パッケージの種類によって、異なるパーツ レベルのリレーションシップの種類を定義できます。 次の表は、Open XML Paper Specification (XPS) に準拠するドキュメントに対して定義されているパーツ レベルのrelationshipType URI を示しています。

XPS ドキュメント Part-Level リレーションシップ	リレーションシップの種類 URI
デジタル署名の定義	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
必要なリソース	http://schemas.microsoft.com/xps/2005/06/required-resource
制限付きフォント	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

パッケージの関係の詳細については、https://www.ecma-international.org/publications-and-standards/standards/ecma-376/でダウンロードできる Open Packaging Conventions (OPC) 仕様のセクション 1.3 を参照してください。

XPS ドキュメントの詳細については、https://www.ecma-international.org/publications-and-standards/standards/ecma-388/でダウンロードできる Open XML Paper Specification (XPS) を参照してください。

こちらもご覧ください

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• オープン パッケージ規則の仕様

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

パラメーター

返品

この PackagePart とターゲット PackagePart または外部リソースの間のパーツ レベルのリレーションシップ。

例外

注釈

パーツ レベルのリレーションシップは、このパーツとターゲット パーツまたはリソースの間の関連付けを定義します。 パート レベルのリレーションシップには、次の 2 つの形式のいずれかを指定できます。

• Package内のターゲット PackagePartへのソース PackagePart間。
• ソース PackagePart パッケージの外部にあるターゲット リソースとの間。

パーツリレーションシップでは、ソース パーツはリレーションシップの "所有者" と見なされます。 ソース パーツが削除されると、パーツが所有するすべてのリレーションシップも削除されます。 リレーションシップを作成または削除するプロセスでは、ターゲットパーツまたはリソースが物理的に変更されることはありません。

id は有効な XML 識別子である必要があります。 id型は xsd:ID であり、XML スキーマ パート 2: データ型の仕様に規定されている名前付け規則に従う必要があります (https://www.w3.org/TR/xmlschema-2/#IDを参照)。

CreateRelationshipメソッドは、ソース パーツまたはターゲット パーツまたはリソースを物理的に変更しません。

リレーションシップのターゲットを別のリレーションシップにすることはできません。

targetModeがInternalとして指定されている場合、targetUriは RFC 3986Uniform Resource Identifier (URI) ジェネリック構文の仕様に従って形成された相対 URI である必要があります。 内部相対 URI には、"/page1.xaml" や "/images/picture4.jpg"などのスラッシュ ("/") 文字で始まる絶対パス、または ".などの相対パスを指定できます。/imagespicture1.jpg" は、ベース URI としてパッケージ ルート ("/") に対して解決されます。

targetModeがExternalとして指定されている場合、targetUriは RFC 3986Uniform Resource Identifier (URI) ジェネリック構文仕様に従って形成された絶対 URI または相対 URI のいずれかになります。 "https://www.microsoft.com/page2.xml"は、外部ターゲット リソース "page2.xml" を参照する絶対 URI の例です。 "images/picture1.jpg" は、外部ターゲット リソース "1.jpg" も参照する相対 URI の例ですが、パッケージ自体の URI に対して解決されます。

relationshipType は、 RFC 3986Uniform Resource Identifier (URI) ジェネリック構文 仕様に従って形成された URI である必要があります。 パッケージの種類によって、異なるパーツ レベルのリレーションシップの種類を定義できます。 次の表は、Open XML Paper Specification (XPS) に準拠するドキュメントに対して定義されているパーツ レベルのrelationshipType URI を示しています。

XPS ドキュメント Part-Level リレーションシップ	リレーションシップの種類 URI
デジタル署名の定義	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
必要なリソース	http://schemas.microsoft.com/xps/2005/06/required-resource
制限付きフォント	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

パッケージの関係の詳細については、https://www.ecma-international.org/publications-and-standards/standards/ecma-376/でダウンロードできる Open Packaging Conventions (OPC) 仕様のセクション 1.3 を参照してください。

XPS ドキュメントの詳細については、https://www.ecma-international.org/publications-and-standards/standards/ecma-388/でダウンロードできる Open XML Paper Specification (XPS) を参照してください。

こちらもご覧ください

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• オープン パッケージ規則の仕様