PackagePart.CreateRelationship メソッド

ソース:

PackagePart.cs

ソース:

PackagePart.cs

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 を示しています。

パッケージの関係の詳細については、https://www.ecma-international.org/publications-and-standards/standards/ecma-376/でダウンロードできる オープン パッケージ規則 (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)
• オープン パッケージ規則の仕様

ソース:

PackagePart.cs

ソース:

PackagePart.cs

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

パラメーター

戻り値

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

例外

注釈

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

• Package内のターゲット PackagePart へのソース PackagePart 間。

• ソース PackagePart パッケージ外のターゲット リソースとの間。

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

id は有効な XML 識別子である必要があります。 id 型は xsd:ID であり、「XML スキーマ パート 2: Datatypes 仕様(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 を示しています。

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

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

こちらもご覧ください

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