ResourceLoader Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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.Activatable(Windows.ApplicationModel.Resources.IResourceLoaderFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class ResourceLoader final
/// [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.Activatable(typeof(Windows.ApplicationModel.Resources.IResourceLoaderFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class ResourceLoader
[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
- Atribut
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 |
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). |