ResourceLoader.GetForCurrentView メソッド

  • リファレンス

定義

名前空間:
Windows.ApplicationModel.Resources

オーバーロード

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

戻り値

ResourceLoader

現在実行中のアプリの メイン ResourceMap の Resources サブツリーのリソース ローダー。

属性
OverloadAttribute

例

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" として扱われます。

戻り値

ResourceLoader

指定した ResourceMap のリソース ローダー。

属性
OverloadAttribute

例

ResourceLoader の例を参照してください。

注釈

通常、このメソッドは、指定されたリソース識別子を持つリソース ファイルを基準にしてリソースにアクセスするために使用されます。 たとえば、 GetForCurrentView('Errors'); は errors.resjson または errors.resw に対する相対値です。

ライブラリ パッケージからリソースのリソース ローダーを構築するには、リソース参照 Uniform Resource Identifier (URI) が使用されます。

返される ResourceLoader は、現在のビューに関連付けられている既定のコンテキストを使用します。

UWP アプリ用のリソース管理システムでは、スケーリング用のリソースの調整がサポートされています。 Windows 8.1以降、アプリが所有するさまざまなビューは、異なるスケールを使用する可能性のあるさまざまなディスプレイ デバイスに同時に表示できます。 このように、スケールはビューごとの特性です。

ResourceLoader には、ResourceLoader メソッドを使用してリソースを取得するときに使用される暗黙的なコンテキストがあります。 ResourceLoader には暗黙的なコンテキストがあり、コンテキストのスケール修飾子は関連付けられたビューに依存するため、ResourceLoader は特定のビューに関連付けられている必要があります。

エラー

このメソッドは、ウィンドウレス スレッドで呼び出された場合、または指定された ResourceMap が見つからない場合、例外で失敗します。

こちらもご覧ください

適用対象