Objek My.Resources

Artikel
04/08/2023

Menyediakan properti dan kelas untuk mengakses sumber daya aplikasi.

Keterangan

Objek My.Resources menyediakan akses ke sumber daya aplikasi dan memungkinkan Anda mengambil sumber daya secara dinamis untuk aplikasi Anda. Untuk informasi selengkapnya, lihat Mengelola Pengaturan Aplikasi (.NET).

Objek My.Resources hanya mengekspos sumber daya global. Ini tidak menyediakan akses ke file sumber daya yang terkait dengan formulir. Anda harus mengakses sumber daya formulir dari formulir.

Anda dapat mengakses file sumber daya khusus budaya aplikasi objek My.Resources. Secara default, objek My.Resources mencari sumber daya dari file sumber daya yang cocok dengan budaya di properti UICulture. Namun, Anda dapat mengambil alih perilaku ini dan menentukan budaya tertentu yang akan digunakan untuk sumber daya. Untuk informasi selengkapnya, lihat Sumber Daya di aplikasi .NET.

Properti

Properti objek My.Resources menyediakan akses ke pengaturan aplikasi Anda. Untuk menambah atau menghapus sumber daya, gunakan Project Designer. Anda dapat mengakses sumber daya yang ditambahkan melalui Project Designer menggunakan My.Resources.resourceName.

Anda juga dapat menambah atau menghapus file sumber daya dengan memilih proyek Anda di Penjelajah Solusi dan mengklik Tambahkan Item Baru atau Tambahkan Item yang Ada dari menu Project. Anda dapat mengakses sumber daya yang ditambahkan dengan cara ini menggunakan My.Resources.resourceFile.NameresourceName.

Setiap sumber daya memiliki nama, kategori, dan nilai, dan pengaturan sumber daya ini menentukan bagaimana properti untuk mengakses sumber daya muncul di objek My.Resources. Untuk sumber daya yang ditambahkan di Project Designer:

Nama menentukan nama properti,
Data sumber daya adalah nilai properti,
Kategori menentukan jenis properti:

Kategori	Jenis data properti
String	String
Citra	Bitmap
Ikon	Icon
Audio	UnmanagedMemoryStream Kelas UnmanagedMemoryStream ini berasal dari kelas Stream, sehingga dapat digunakan dengan metode yang mengambil aliran, seperti metode Play.
File	- String untuk file teks. - Bitmap untuk file gambar. - Icon untuk file ikon. - UnmanagedMemoryStream untul file sound.
Lainnya	Ditentukan oleh informasi di kolom Jenis perancang.

Kelas

Objek My.Resources mengekspos setiap file sumber daya sebagai kelas dengan properti bersama. Nama kelas sama dengan nama file sumber daya. Seperti yang dijelaskan di bagian sebelumnya, sumber daya dalam file sumber daya diekspos sebagai properti di kelas.

Contoh 1

Contoh ini menetapkan judul formulir ke sumber daya string bernama Form1Title dalam file sumber daya aplikasi. Agar contoh berfungsi, aplikasi harus memiliki string bernama Form1Title dalam file sumber dayanya.

Sub SetFormTitle()
    Me.Text = My.Resources.Form1Title
End Sub

Contoh 2

Contoh ini mengatur ikon formulir ke ikon bernama Form1Icon yang disimpan dalam file sumber daya aplikasi. Agar contoh berfungsi, aplikasi harus memiliki ikon bernama Form1Icon dalam file sumber dayanya.

Sub SetFormIcon()
    Me.Icon = My.Resources.Form1Icon
End Sub

Contoh 3

Contoh ini mengatur gambar latar belakang formulir ke sumber daya gambar bernama Form1Background, yang ada dalam file sumber daya aplikasi. Agar contoh ini berfungsi, aplikasi harus memiliki sumber daya gambar bernama Form1Background dalam file sumber dayanya.

Sub SetFormBackgroundImage()
    Me.BackgroundImage = My.Resources.Form1Background
End Sub

Contoh 4

Contoh ini memutar suara yang disimpan sebagai sumber daya audio bernama Form1Greeting dalam file sumber daya aplikasi. Agar contoh ini berfungsi, aplikasi harus memiliki sumber daya audio bernama Form1Greeting dalam file sumber dayanya. Metode My.Computer.Audio.Play ini hanya tersedia untuk aplikasi Formulir Windows.

Sub PlayFormGreeting()
    My.Computer.Audio.Play(My.Resources.Form1Greeting, 
        AudioPlayMode.Background)
End Sub

Contoh 5

Contoh ini mengambil versi budaya Prancis dari sumber daya string aplikasi. Sumber daya diberi nama Message. Untuk mengubah budaya yang digunakan objek My.Resources, contohnya menggunakan ChangeUICulture.

Agar contoh ini berfungsi, aplikasi harus memiliki string bernama Message dalam file sumber dayanya, dan aplikasi harus memiliki versi budaya Prancis dari file sumber daya tersebut, Resources.fr-FR.resx. Jika aplikasi tidak memiliki versi budaya Prancis dari file sumber daya, objek My.Resource mengambil sumber daya dari file sumber daya kultur default.

Sub ShowLocalizedMessage()
    Dim culture As String = My.Application.UICulture.Name
    My.Application.ChangeUICulture("fr-FR")
    MsgBox(My.Resources.Message)
    My.Application.ChangeUICulture(culture)
End Sub