次の方法で共有


PackagePart.CreateRelationship メソッド

定義

この PackagePart と、指定したターゲット PackagePart または外部リソースとの間にパート レベルのリレーションシップを作成します。

オーバーロード

CreateRelationship(Uri, TargetMode, String)

この PackagePart と、指定したターゲット PackagePart または外部リソースとの間にパート レベルのリレーションシップを作成します。

CreateRelationship(Uri, TargetMode, String, String)

この PackagePart と、指定したターゲット PackagePart または外部リソースとの間にパート レベルのリレーションシップを作成します。

注釈

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

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

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

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

パッケージの関係の詳細については、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(Uri, TargetMode, String)

ソース:
PackagePart.cs
ソース:
PackagePart.cs
ソース:
PackagePart.cs
ソース:
PackagePart.cs
ソース:
PackagePart.cs

この PackagePart と、指定したターゲット PackagePart または外部リソースとの間にパート レベルのリレーションシップを作成します。

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

パラメーター

targetUri
Uri

ターゲット パーツの URI。

targetMode
TargetMode

列挙値の 1 つ。 たとえば、ターゲット パーツが Package内にある場合に Internal します。ターゲットが Package外のリソースであるかどうかを External します。

relationshipType
String

リレーションシップのロール。

戻り値

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

例外

パーツが削除されました。

-又は-

Package が開いていません (Dispose(Boolean) または Close() が呼び出されました)。

targetUri または relationshipTypenull

targetMode パラメーターが有効な TargetMode 列挙値ではありません。

targetUri によって識別される部分はリレーションシップです (リレーションシップのターゲットを別のリレーションシップにすることはできません)。

-又は-

targetModeInternal として指定されていますが、targetUri は絶対外部 URI です。

パッケージは読み取り専用です (新しいリレーションシップを追加できません)。

注釈

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

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

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

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

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

targetModeExternalとして指定されている場合、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/でダウンロードできる オープン パッケージ規則 (OPC) 仕様のセクション 1.3 を参照してください。

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

こちらもご覧ください

適用対象

CreateRelationship(Uri, TargetMode, String, String)

ソース:
PackagePart.cs
ソース:
PackagePart.cs
ソース:
PackagePart.cs
ソース:
PackagePart.cs
ソース:
PackagePart.cs

この PackagePart と、指定したターゲット PackagePart または外部リソースとの間にパート レベルのリレーションシップを作成します。

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

パラメーター

targetUri
Uri

ターゲット パーツの URI。

targetMode
TargetMode

列挙値の 1 つ。 たとえば、ターゲット パーツが Package内にある場合に Internal します。ターゲットが Package外のリソースであるかどうかを External します。

relationshipType
String

リレーションシップのロール。

id
String

リレーションシップの一意の ID。

戻り値

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

例外

パーツが削除されました。

-又は-

Package が開いていません (Dispose(Boolean) または Close() が呼び出されました)。

targetUri または relationshipTypenull

targetMode パラメーターが有効な TargetMode 列挙値ではありません。

targetUri によって識別される部分はリレーションシップです (リレーションシップのターゲットを別のリレーションシップにすることはできません)。

-又は-

targetModeInternal として指定されていますが、targetUri は絶対外部 URI です。

パッケージは読み取り専用です (新しいリレーションシップを追加できません)。

id は有効な XML 識別子ではありません。

-又は-

指定した id を持つパーツが既に存在します。

注釈

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

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

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

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

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

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

targetModeExternalとして指定されている場合、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/でダウンロードできる オープン パッケージ規則 (OPC) 仕様のセクション 1.3 を参照してください。

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

こちらもご覧ください

適用対象