ResourceLoader Kelas

Definisi

Ruang nama:

Windows.ApplicationModel.Resources

Menyediakan akses yang disederhanakan ke sumber daya aplikasi seperti string UI aplikasi.

API WinUI 2 yang setara untuk UWP: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

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

Warisan

Object Platform::Object IInspectable ResourceLoader

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Gunakan metode ResourceLoader.GetString untuk mendapatkan sumber daya string yang diidentifikasi oleh "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");

Keterangan

Objek ResourceLoader merangkum ResourceMap tertentu dan ResourceContext, dikombinasikan dalam API sederhana.

Peta sumber daya tertentu dapat ditentukan ketika ResourceLoader diperoleh; jika tidak ada peta sumber daya yang ditentukan, ResourceLoader akan menyediakan akses ke subtree "Sumber Daya" dari peta sumber daya utama aplikasi.

Secara umum, sumber daya dapat sensitif terhadap skala atau karakteristik tampilan lainnya. Untuk alasan itu, konteks sumber daya umumnya dikaitkan dengan tampilan tertentu. Karena ResourceLoader merangkum konteks sumber daya, ini juga berlaku untuk ResourceLoader. ResourceLoader yang diperoleh menggunakan GetForCurrentView memiliki konteks sumber daya yang terkait dengan tampilan di mana ia diperoleh. ResourceLoader yang independen tampilan juga dapat diperoleh menggunakan GetForViewIndependentUse

• Dapatkan faktor skala untuk tampilan saat ini dengan menggunakan kelas DisplayInformation alih-alih kelas DisplayProperties yang tidak digunakan lagi.
• Aplikasi yang mengatur lebar eksplisit dan tinggi elemen harus tetap berfungsi dengan baik, selain mungkin menampilkan gambar yang buram.
• Dapatkan sumber daya yang tidak terkait dengan tampilan apa pun dengan mendapatkan ResourceLoader melalui GetForViewIndependentUse.

Lihat juga Ukuran layar dan titik henti.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1903	18362	GetForUIContext

Konstruktor

ResourceLoader()	Catatan ResourceLoader() dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan GetForCurrentView(). Membuat objek ResourceLoader baru untuk subtree "Sumber Daya" dari ResourceMap utama aplikasi yang sedang berjalan. API WinUI 2 yang setara untuk UWP: ResourceLoader() (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
ResourceLoader(String)	Catatan ResourceLoader(String) dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan GetForCurrentView(String). Membuat objek ResourceLoader baru untuk ResourceMap yang ditentukan. API WinUI 2 yang setara untuk UWP: ResourceLoader(String) (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Metode

GetDefaultPriPath(String)	Menyediakan lokasi resources.pri file untuk aplikasi.
GetForCurrentView()	Mendapatkan objek ResourceLoader untuk subtree Sumber Daya dari ResourceMap utama aplikasi yang sedang berjalan. ResourceLoader ini menggunakan konteks default yang terkait dengan tampilan saat ini.
GetForCurrentView(String)	Mendapatkan objek ResourceLoader untuk ResourceMap yang ditentukan. ResourceLoader ini menggunakan konteks default yang terkait dengan tampilan saat ini.
GetForUIContext(UIContext)	Mendapatkan objek ResourceLoader untuk UIContext yang ditentukan.
GetForViewIndependentUse()	Mendapatkan objek ResourceLoader untuk subtree Sumber Daya dari ResourceMap utama aplikasi yang sedang berjalan. ResourceLoader ini menggunakan konteks default yang tidak terkait dengan tampilan apa pun.
GetForViewIndependentUse(String)	Mendapatkan objek ResourceLoader untuk ResourceMap yang ditentukan. ResourceLoader ini menggunakan konteks default yang tidak terkait dengan tampilan apa pun.
GetString(String)	Mengembalikan nilai string sumber daya yang paling tepat, yang ditentukan oleh pengidentifikasi sumber daya, untuk ResourceContext default tampilan tempat ResourceLoader diperoleh menggunakan ResourceLoader.GetForCurrentView. API WinUI 2 yang setara untuk UWP: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetString (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).
GetStringForReference(Uri)	Catatan GetStringForReference dapat diubah atau tidak tersedia untuk rilis setelah Windows 8.1. Sebagai gantinya, gunakan GetStringForUri. Mengembalikan nilai string sumber daya yang paling tepat, yang ditentukan sebagai Uri untuk pengidentifikasi sumber daya, untuk ResourceContext default dari aplikasi yang sedang berjalan.
GetStringForUri(Uri)	Mengembalikan nilai string sumber daya yang paling tepat, yang ditentukan oleh pengidentifikasi sumber daya Pengidentifikasi Sumber Daya Seragam (URI), untuk ResourceContext default dari aplikasi yang sedang berjalan. API WinUI 2 yang setara untuk UWP: Microsoft.Windows.ApplicationModel.Resources.ResourceLoader.GetStringForUri (untuk WinUI di SDK Aplikasi Windows, lihat namespace SDK Aplikasi Windows).

Lihat juga

• GetForCurrentView()
• GetForCurrentView(String)
• GetForViewIndependentUse()
• GetForViewIndependentUse(String)
• ResourceMap
• ResourceContext
• Sumber daya aplikasi dan Sistem Manajemen Sumber Daya
• Sumber daya aplikasi dan sampel pelokalan