Windows アプリ
目次を折りたたむ
目次を展開する
この記事は機械翻訳されたものです。 記事の文章にポインターを重ねると、原文のテキストが表示されます。 詳細情報
訳文
原文
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

FrameworkElement.Resources プロパティ

 

ローカルで定義されたリソース ディクショナリを取得または設定します。

名前空間:   System.Windows
アセンブリ:  PresentationFramework (PresentationFramework.dll 内)

[AmbientAttribute]
public ResourceDictionary Resources { get; set; }

プロパティ値

Type: System.Windows.ResourceDictionary

ローカルで定義された現在のリソース ディクショナリ。各リソースにはキーでアクセスできます。

Extensible Application Markup Language (XAML) の中で完全に、あるいは部分的に定義されたリソース ディクショナリは、プロパティ要素として作成され、通常は個別のページまたはアプリケーションのルート要素に配置されます。 このレベルにリソース ディクショナリを配置すると、ページ内の個々の子要素 (またはアプリケーション内の任意のページ) からの検索が容易になります。ほとんどのアプリケーション シナリオで、スタイルをリソース ディクショナリ内のオブジェクト要素として定義するか、スタイル リソース全体を内部格納できるように外部リソースとして定義することをお勧めします (外部リソースとして定義すると、編集する必要がある物理ファイルを分離することによってデザイナーと開発者の責任を分割できます)。

このプロパティによって返されるのは、その要素内で直接宣言されているリソース ディクショナリだけです。上方への再帰的な検索によって、それぞれの親要素で定義されているリソースに子要素からアクセスできる実際のリソース ルックアップのプロセスとは異なります。

コレクション内のリソースをコードで参照することもできます。ただし、XAML で作成したリソースには、ディクショナリが宣言されている要素で Loaded が発生するまではアクセスできないので注意してください。実際、リソースは非同期に解析されるため、Loaded イベントが発生しても、XAML 定義のリソースを参照できる保証はありません。このため、一般に、XAML 定義のリソースにアクセスするには、ランタイム コードの一部としてアクセスするか、その他の XAML の手法 (スタイルや属性値のリソース拡張参照など) を使用してアクセスするようにしてください。コードでリソースにアクセスする場合、XAML から行う 参照と基本的に同等です。

基になる ResourceDictionary では、コードを使用してコレクション内のリソースを追加、削除、クエリするためのメソッドがサポートされています。 Resources プロパティは、要素のリソース コレクションを新しい (または異なる) ResourceDictionary に完全に置き換えるシナリオをサポートするために、設定可能になっています。

ここに示されている XAML 構文には、ResourceDictionary の要素が含まれていません。これは、暗黙的なコレクション構文の一例で、コレクション要素を表すタグは省略可能です。代わりに、項目としてコレクションに追加する要素を指定します。暗黙的なコレクションと XAML の詳細については、「XAML 構文の詳細」を参照してください。 ResourceDictionary を明示的に要素として指定する場合もあります。たとえば、マージされたディクショナリを導入する場合がこれに該当します。この場合、通常はその ResourceDictionary には子要素がありません。詳細については、「マージされたリソース ディクショナリ」を参照してください。

<object>
  <object.Resources>
    oneOrMoreResourceElements
  </object.Resources>
</object>

oneOrMoreResourceElements

それぞれがリソースを定義する 1 つ以上のオブジェクト要素。ResourceDictionary 内のリソース プロパティ要素は、x:Key ディレクティブの値がそれぞれ一意であることが必要です。この値は、ResourceDictionary から値を取得するときに一意のキーとして機能します。

.NET Framework
3.0 から利用可能
Silverlight
2.0 から利用可能
Windows Phone Silverlight
7.0 から利用可能
トップに戻る
表示:
© 2016 Microsoft