PackagePart.CreateRelationship メソッド

定義

名前空間:

System.IO.Packaging

アセンブリ:

System.IO.Packaging.dll

パッケージ:

System.IO.Packaging v8.0.0

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

オーバーロード

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

注釈

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

• ソースPackagePartから 内のターゲットPackagePartPackageまでの間。

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

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

メソッドは CreateRelationship 、ソース パーツ、またはターゲット パーツまたはリソースを物理的に変更することはありません。

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

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

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 つ。 たとえば、ターゲット パーツが Internal の内部の場合は Package、ターゲットが External 外部のリソースの場合は Package です。

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 つのフォームのいずれかを指定できます。

• ソースPackagePartから 内のターゲットPackagePartPackageまでの間。

• パッケージの外部にあるソース PackagePart からターゲット リソースまでの間。

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

メソッドは CreateRelationship 、ソース パーツ、またはターゲット パーツまたはリソースを物理的に変更することはありません。

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

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

が としてExternaltargetUri指定されている場合targetModeは、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

パッケージの関係の詳細については、 Open Packaging Conventions (OPC) 仕様 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/のセクション 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)
• Open Packaging Conventions の仕様

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 つ。 たとえば、ターゲット パーツが Internal の内部の場合は Package、ターゲットが External 外部のリソースの場合は Package です。

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 つのフォームのいずれかを指定できます。

• ソースPackagePartから 内のターゲットPackagePartPackageまでの間。

• パッケージの外部にあるソース PackagePart からターゲット リソースまでの間。

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

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

メソッドは CreateRelationship 、ソース パーツ、またはターゲット パーツまたはリソースを物理的に変更することはありません。

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

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

が としてExternaltargetUri指定されている場合targetModeは、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

パッケージの関係の詳細については、 Open Packaging Conventions (OPC) 仕様 https://www.ecma-international.org/publications-and-standards/standards/ecma-376/のセクション 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)
• Open Packaging Conventions の仕様