Share via


ResourceLoader.GetForCurrentView Method

Definition

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.

See also

Applies to