Package.GetRelationships メソッド

定義

すべてのパッケージ レベル リレーションシップのコレクションを返します。

public:
 System::IO::Packaging::PackageRelationshipCollection ^ GetRelationships();
public System.IO.Packaging.PackageRelationshipCollection GetRelationships ();
member this.GetRelationships : unit -> System.IO.Packaging.PackageRelationshipCollection
Public Function GetRelationships () As PackageRelationshipCollection

戻り値

パッケージに含まれているすべてのパッケージ レベル リレーションシップのコレクション。

例外

パッケージが開いていません (Dispose(Boolean) または Close() が呼び出されました)。

パッケージは書き込み専用です。

注釈

GetRelationships は返 nullされません。ただし、パッケージにパッケージ レベルのリレーションシップが含まれない場合、返されるコレクションには 0 個の要素が含まれる場合があります。

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

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

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

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

適用対象

こちらもご覧ください