PackagePart.CreateRelationship メソッド

定義

名前空間:

System.IO.Packaging

アセンブリ:

System.IO.Packaging.dll

パッケージ:

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

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

オーバーロード

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

注釈

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

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

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

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

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 と、指定したターゲット 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

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

戻り値

PackageRelationship

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

例外

InvalidOperationException

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

-又は-

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

ArgumentNullException

targetUri または relationshipType が null。

ArgumentOutOfRangeException

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

ArgumentException

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

-又は-

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

IOException

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

注釈

パーツ レベルのリレーションシップは、このパーツとターゲット パーツまたはリソースの間の関連付けを定義します。 パート レベルのリレーションシップには、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/でダウンロードできる オープン パッケージ規則 (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)
• オープン パッケージ規則の仕様

CreateRelationship(Uri, TargetMode, String, String)

ソース:

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);

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。

戻り値

PackageRelationship

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

例外

InvalidOperationException

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

-又は-

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

ArgumentNullException

targetUri または relationshipType が null。

ArgumentOutOfRangeException

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

ArgumentException

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

-又は-

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

IOException

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

XmlException

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

-又は-

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

注釈

パーツ レベルのリレーションシップは、このパーツとターゲット パーツまたはリソースの間の関連付けを定義します。 パート レベルのリレーションシップには、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 を示しています。

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/を参照してください。

こちらもご覧ください

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