PackagePart.CreateRelationship メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この 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.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 つ。 たとえば、ターゲット パーツが Internal の内部の場合は Package、ターゲットが External 外部のリソースの場合は Package です。
- relationshipType
- String
リレーションシップのロール。
戻り値
この PackagePart およびターゲット PackagePart、外部リソース間のパーツ レベル リレーションシップ。
例外
targetUri
または relationshipType
が null
です。
targetMode
パラメーターが、有効な TargetMode 列挙値でありません。
targetUri
で識別されるパーツはリレーションシップです (リレーションシップのターゲットは別のリレーションシップになることができません)。
- または -
targetMode
は Internal として指定されますが、targetUri
は外部の絶対 URI です。
パッケージは読み取り専用です (新しいリレーションシップを追加できません)。
注釈
パーツ レベルのリレーションシップは、このパーツとターゲット パーツまたはリソースの間の関連付けを定義します。 パートレベルのリレーションシップには、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.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 つ。 たとえば、ターゲット パーツが Internal の内部の場合は Package、ターゲットが External 外部のリソースの場合は Package です。
- relationshipType
- String
リレーションシップのロール。
- id
- String
リレーションシップの一意の ID。
戻り値
この PackagePart およびターゲット PackagePart、外部リソース間のパーツ レベル リレーションシップ。
例外
targetUri
または relationshipType
が null
です。
targetMode
パラメーターが、有効な TargetMode 列挙値でありません。
targetUri
で識別されるパーツはリレーションシップです (リレーションシップのターゲットは別のリレーションシップになることができません)。
- または -
targetMode
は Internal として指定されますが、targetUri
は外部の絶対 URI です。
パッケージは読み取り専用です (新しいリレーションシップを追加できません)。
注釈
パーツ レベルのリレーションシップは、このパーツとターゲット パーツまたはリソースの間の関連付けを定義します。 パートレベルのリレーションシップには、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 の仕様
適用対象
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示