ResourceLoader 類別

定義

命名空間:

Windows.ApplicationModel.Resources

提供應用程式資源的簡化存取，例如應用程式 UI 字串。

適用于 UWP 的對等 WinUI 2 API：Microsoft.Windows.ApplicationModel.Resources.ResourceLoader (Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。

public ref class ResourceLoader sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.ApplicationModel.Resources.IResourceLoaderFactory, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class ResourceLoader final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.ApplicationModel.Resources.IResourceLoaderFactory), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class ResourceLoader

function ResourceLoader(name)

Public NotInheritable Class ResourceLoader

繼承

Object Platform::Object IInspectable ResourceLoader

屬性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

使用 ResourceLoader.GetString 方法來取得 「Farewell」 所識別的字串資源。

var resourceLoader = Windows.ApplicationModel.Resources.ResourceLoader.GetForCurrentView();
var text = resourceLoader.GetString("Farewell");

auto resourceLoader{ Windows::ApplicationModel::Resources::ResourceLoader::GetForCurrentView() };
winrt::hstring text{ resourceLoader.GetString(L"Farewell") };

auto resourceLoader = Windows::ApplicationModel::Resources::ResourceLoader::GetForCurrentView();
String^ text = resourceLoader->GetString("Farewell");

備註

ResourceLoader物件會封裝特定的ResourceMap和ResourceCoNtext，並結合在簡單的 API 中。

取得 ResourceLoader 時，可以指定特定的資源對應;如果未指定任何資源對應， ResourceLoader 將會提供應用程式主要資源對應之「資源」子樹的存取權。

一般而言，資源可能會敏感于縮放或其他顯示特性。 因此，資源內容通常會與特定檢視相關聯。 由於 ResourceLoader 會封裝資源內容，因此這也適用于 ResourceLoader。 使用GetForCurrentView取得的ResourceLoader具有與其取得之檢視相關聯的資源內容。 您也可以使用GetForViewIndependentUse取得與檢視無關的 ResourceLoader

• 使用 DisplayInformation 類別而非已被取代的 DisplayProperties 類別，取得目前檢視的縮放比例。
• 設定明確寬度和高度元素的應用程式仍應該正常運作，但可能顯示模糊影像以外的應用程式。
• 透過GetForViewIndependentUse取得ResourceLoader，以取得未與任何檢視相關聯的資源。

另請參閱 螢幕大小和中斷點。

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1903	18362	GetForUICoNtext

建構函式

ResourceLoader()	注意 ResourceLoader () 可能會在Windows 8.1之後變更或無法使用版本。 請改用 GetForCurrentView () 。 建構目前執行中應用程式主要ResourceMap之 「Resources」 子樹的新ResourceLoader物件。 適用于 UWP 的對等 WinUI 2 API：Windows 應用程式 SDK中 WinUI的 ResourceLoader () (，請參閱Windows 應用程式 SDK命名空間) 。
ResourceLoader(String)	注意 ResourceLoader (String) 可能會在Windows 8.1之後變更或無法使用。 請改用 GetForCurrentView (String) 。 為指定的ResourceMap建構新的ResourceLoader物件。 適用于 UWP 的對等 WinUI 2 API：ResourceLoader (String) (for WinUI Windows 應用程式 SDK，請參閱Windows 應用程式 SDK命名空間) 。

方法

GetDefaultPriPath(String)	提供應用程式檔案的位置 resources.pri 。
GetForCurrentView()	取得目前執行中應用程式主要ResourceMap之Resources 子樹的ResourceLoader物件。 此 ResourceLoader 會使用與目前檢視相關聯的預設內容。
GetForCurrentView(String)	取得指定ResourceMap 的 ResourceLoader物件。 此 ResourceLoader 會使用與目前檢視相關聯的預設內容。
GetForUIContext(UIContext)	取得指定之 UICoNtext的ResourceLoader物件。
GetForViewIndependentUse()	取得目前執行中應用程式主要ResourceMap之Resources 子樹的ResourceLoader物件。 此 ResourceLoader 會使用未與任何檢視相關聯的預設內容。
GetForViewIndependentUse(String)	取得指定ResourceMap 的 ResourceLoader物件。 此 ResourceLoader 會使用未與任何檢視相關聯的預設內容。
GetString(String)	針對使用ResourceLoader.GetForCurrentView 取得 ResourceLoader之檢視的預設ResourceCoNtext，傳回資源識別碼所指定的資源最適當的字串值。 適用于 UWP 的對等 WinUI 2 API：Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetString (for WinUI 在Windows 應用程式 SDK中，請參閱Windows 應用程式 SDK命名空間) 。
GetStringForReference(Uri)	注意 GetStringForReference 可能會在Windows 8.1之後變更或無法使用版本。 請改用 GetStringForUri。 針對目前執行中應用程式的預設ResourceCoNtext，傳回資源最適當的字串值，指定為資源識別碼的URI。
GetStringForUri(Uri)	針對目前執行中應用程式的預設 ResourceCoNtext ，傳回資源 (URI) 資源識別碼所指定的資源最適當的字串值。 適用于 UWP 的對等 WinUI 2 API：Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetStringForUri (Windows 應用程式 SDK，請參閱) Windows 應用程式 SDK命名空間。

另請參閱

• GetForCurrentView()
• GetForCurrentView(String)
• GetForViewIndependentUse()
• GetForViewIndependentUse(String)
• ResourceMap
• ResourceContext
• 應用程式資源和資源管理系統
• 應用程式資源和當地語系化範例