ResourceLoader.GetForCurrentView メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
GetForCurrentView() |
現在実行中のアプリの メイン ResourceMap の Resources サブツリーの ResourceLoader オブジェクトを取得します。 この ResourceLoader は、現在のビューに関連付けられている既定のコンテキストを使用します。 |
GetForCurrentView(String) |
指定した ResourceMap の ResourceLoader オブジェクトを取得します。 この ResourceLoader は、現在のビューに関連付けられている既定のコンテキストを使用します。 |
GetForCurrentView()
現在実行中のアプリの メイン ResourceMap の Resources サブツリーの ResourceLoader オブジェクトを取得します。 この ResourceLoader は、現在のビューに関連付けられている既定のコンテキストを使用します。
public:
static ResourceLoader ^ GetForCurrentView();
/// [Windows.Foundation.Metadata.Overload("GetForCurrentView")]
static ResourceLoader GetForCurrentView();
[Windows.Foundation.Metadata.Overload("GetForCurrentView")]
public static ResourceLoader GetForCurrentView();
function getForCurrentView()
Public Shared Function GetForCurrentView () As ResourceLoader
戻り値
現在実行中のアプリの メイン ResourceMap の Resources サブツリーのリソース ローダー。
- 属性
例
ResourceLoader の例を参照してください。
注釈
このメソッドは、"resources" (resources.resjson または resources.resw) という名前のリソース ファイルに対する相対アクセスを許可します。 返される ResourceLoader は、現在のビューに関連付けられている既定のコンテキストを使用します。
UWP アプリ用のリソース管理システムでは、スケーリング用のリソースの調整がサポートされています。 Windows 8.1以降、アプリが所有するさまざまなビューは、異なるスケールを使用する可能性のあるさまざまなディスプレイ デバイスに同時に表示できます。 このように、スケールはビューごとの特性です。
ResourceLoader には、ResourceLoader メソッドを使用してリソースを取得するときに使用される暗黙的なコンテキストがあります。 ResourceLoader には暗黙的なコンテキストがあり、コンテキストのスケール修飾子は関連付けられたビューに依存するため、ResourceLoader は特定のビューに関連付けられている必要があります。
エラー
このメソッドは、ウィンドウレス スレッドで呼び出された場合、または メイン ResourceMap に "resources" サブツリーがない場合、例外で失敗します。
こちらもご覧ください
適用対象
GetForCurrentView(String)
指定した ResourceMap の ResourceLoader オブジェクトを取得します。 この ResourceLoader は、現在のビューに関連付けられている既定のコンテキストを使用します。
public:
static ResourceLoader ^ GetForCurrentView(Platform::String ^ name);
/// [Windows.Foundation.Metadata.Overload("GetForCurrentViewWithName")]
static ResourceLoader GetForCurrentView(winrt::hstring const& name);
[Windows.Foundation.Metadata.Overload("GetForCurrentViewWithName")]
public static ResourceLoader GetForCurrentView(string name);
function getForCurrentView(name)
Public Shared Function GetForCurrentView (name As String) As ResourceLoader
パラメーター
- name
-
String
Platform::String
winrt::hstring
新しいリソース ローダーが非修飾リソース参照に使用する ResourceMap のリソース識別子。 その後、ローダーは、それらの参照に対する相対的なリソースを取得できます。
注意
リソース識別子は、Uniform Resource Identifier (URI) セマンティクスの対象となる Uniform Resource Identifier (URI) フラグメントとして扱われます。 たとえば、"Caption%20" は "Caption" として扱われます。 名前付きリソース パスを終了するため、リソース識別子に "?" または "#" を使用しないでください。 たとえば、"Foo?3" は "Foo" として扱われます。
戻り値
指定した ResourceMap のリソース ローダー。
- 属性
例
ResourceLoader の例を参照してください。
注釈
通常、このメソッドは、指定されたリソース識別子を持つリソース ファイルを基準にしてリソースにアクセスするために使用されます。 たとえば、 GetForCurrentView('Errors');
は errors.resjson または errors.resw に対する相対値です。
ライブラリ パッケージからリソースのリソース ローダーを構築するには、リソース参照 Uniform Resource Identifier (URI) が使用されます。
返される ResourceLoader は、現在のビューに関連付けられている既定のコンテキストを使用します。
UWP アプリ用のリソース管理システムでは、スケーリング用のリソースの調整がサポートされています。 Windows 8.1以降、アプリが所有するさまざまなビューは、異なるスケールを使用する可能性のあるさまざまなディスプレイ デバイスに同時に表示できます。 このように、スケールはビューごとの特性です。
ResourceLoader には、ResourceLoader メソッドを使用してリソースを取得するときに使用される暗黙的なコンテキストがあります。 ResourceLoader には暗黙的なコンテキストがあり、コンテキストのスケール修飾子は関連付けられたビューに依存するため、ResourceLoader は特定のビューに関連付けられている必要があります。
エラー
このメソッドは、ウィンドウレス スレッドで呼び出された場合、または指定された ResourceMap が見つからない場合、例外で失敗します。