ResourceLoader.GetForCurrentView Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
GetForCurrentView() |
Gets a ResourceLoader object for the Resources subtree of the currently running app's main ResourceMap. This ResourceLoader uses a default context associated with the current view. |
GetForCurrentView(String) |
Gets a ResourceLoader object for the specified ResourceMap. This ResourceLoader uses a default context associated with the current view. |
GetForCurrentView()
Gets a ResourceLoader object for the Resources subtree of the currently running app's main ResourceMap. This ResourceLoader uses a default context associated with the current view.
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
Returns
A resource loader for the Resources subtree of the currently running app's main ResourceMap.
- Attributes
Examples
See the example in ResourceLoader.
Remarks
This method allows access relative to a resource file named "resources" (resources.resjson or resources.resw). The ResourceLoader that is returned uses a default context associated with the current view.
The resource management system for UWP apps supports the tailoring of resources for scale. Starting in Windows 8.1, different views owned by an app are able to display simultaneously on different display devices that may use different scales. In this way, scale is a per-view characteristic.
A ResourceLoader has an implicit context that is used when ResourceLoader methods are used to retrieve a resource. Since a ResourceLoader has an implicit context, and since the scale qualifier of contexts is dependent on an associated view, a ResourceLoader must be associated with a particular view.
Errors
This method fails with an exception if it is called in a windowless thread, or if the main ResourceMap does not have a "resources" subtree.
See also
Applies to
GetForCurrentView(String)
Gets a ResourceLoader object for the specified ResourceMap. This ResourceLoader uses a default context associated with the current view.
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
Parameters
- name
-
String
Platform::String
winrt::hstring
The resource identifier of the ResourceMap that the new resource loader uses for unqualified resource references. The loader can then retrieve resources relative to those references.
Note
The resource identifier is treated as a Uniform Resource Identifier (URI) fragment, subject to Uniform Resource Identifier (URI) semantics. For example, "Caption%20" is treated as "Caption ". Do not use "?" or "#" in resource identifiers, as they terminate the named resource path. For example, "Foo?3" is treated as "Foo".
Returns
A resource loader for the specified ResourceMap.
- Attributes
Examples
See the example in ResourceLoader.
Remarks
This method is typically used to access resources relative to a resource file with the specified resource identifier. For example, GetForCurrentView('Errors');
is relative to errors.resjson or errors.resw.
To construct a resource loader for resources from a library package, a resource reference Uniform Resource Identifier (URI) is used.
The ResourceLoader that is returned uses a default context associated with the current view.
The resource management system for UWP apps supports the tailoring of resources for scale. Starting in Windows 8.1, different views owned by an app are able to display simultaneously on different display devices that may use different scales. In this way, scale is a per-view characteristic.
A ResourceLoader has an implicit context that is used when ResourceLoader methods are used to retrieve a resource. Since a ResourceLoader has an implicit context, and since the scale qualifier of contexts is dependent on an associated view, a ResourceLoader must be associated with a particular view.
Errors
This method fails with an exception if it is called in a windowless thread, or if the specified ResourceMap cannot be found.