Oggetto My.Resources

Articolo
04/02/2024

Specifica proprietà e classi per l'accesso alle risorse dell'applicazione.

Osservazioni:

L'oggetto My.Resources fornisce l'accesso alle risorse dell'applicazione e consente di recuperarle in modo dinamico. Per altre informazioni, vedere Gestione delle risorse di un'applicazione (.NET).

L'oggetto My.Resources espone solo le risorse globali. Non fornisce l'accesso ai file di risorse associati ai moduli. È necessario accedere alle risorse del modulo dal modulo.

È possibile accedere ai file di risorse specifici delle impostazioni cultura dell'applicazione dall'oggetto My.Resources. Per impostazione predefinita, l'oggetto My.Resources cerca le risorse dal file di risorse che corrisponde alle impostazioni cultura nella proprietà UICulture. Tuttavia, è possibile eseguire l'override di questo comportamento e specificare impostazioni cultura specifiche da usare per le risorse. Per altre informazioni, vedere Risorse nelle applicazioni .NET.

Proprietà

Le proprietà dell'oggetto My.Resources forniscono l'accesso in sola lettura alle risorse dell'applicazione. Per aggiungere o rimuovere risorse, usare Creazione progetti. È possibile accedere alle risorse aggiunte tramite Creazione progetti usando My.Resources.resourceName.

È anche possibile aggiungere o rimuovere file di risorse selezionando il progetto in Esplora soluzioni e facendo clic su Aggiungi nuovo elemento o Aggiungi elemento esistente dal menu Progetto. È possibile accedere alle risorse aggiunte in questo modo usando My.Resources.resourceFileName.resourceName.

Ogni risorsa ha un nome, una categoria e un valore e queste impostazioni delle risorse determinano come la proprietà per accedere alla risorsa viene visualizzata nell'oggetto My.Resources. Per le risorse aggiunte in Creazione progetti:

Il nome determina il nome della proprietà,
I dati della risorsa sono il valore della proprietà,
La categoria determina il tipo della proprietà:

Categoria	Tipo di dati proprietà
Stringhe	Stringa
Immagini	Bitmap
Icone	Icon
Audio	UnmanagedMemoryStream La classe UnmanagedMemoryStream deriva dalla classe Stream, quindi può essere usata con metodi che accettano flussi, ad esempio il metodo Play.
File	- Stringa per i file di testo. - Bitmap per i file di immagine. - Icon per i file icona. - UnmanagedMemoryStream per i file audio.
Altro	Determinato dalle informazioni nella colonna Tipo della finestra di progettazione.

Classi

L'oggetto My.Resources espone ogni file di risorse come classe con proprietà condivise. Il nome della classe corrisponde al nome del file di risorse. Come descritto nella sezione precedente, le risorse in un file di risorse vengono esposte come proprietà nella classe.

Esempio 1

In questo esempio il titolo di un modulo viene impostato sulla risorsa stringa denominata Form1Title nel file di risorse dell'applicazione. Per il funzionamento dell'esempio, l'applicazione deve avere una stringa denominata Form1Title nel relativo file di risorse.

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

Esempio 2

In questo esempio viene impostata l'icona del modulo sull'icona denominata Form1Icon archiviata nel file di risorse dell'applicazione. Per il funzionamento dell'esempio, l'applicazione deve avere un'icona denominata Form1Icon nel relativo file di risorse.

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

Esempio 3

In questo esempio l'immagine di sfondo di un modulo viene impostata sulla risorsa immagine denominata Form1Background, che si trova nel file di risorse dell'applicazione. Per il funzionamento di questo esempio, l'applicazione deve avere una risorsa immagine denominata Form1Background nel relativo file di risorse.

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

Esempio 4

In questo esempio viene riprodotto il suono archiviato come risorsa audio denominata Form1Greeting nel file di risorse dell'applicazione. Per il funzionamento dell'esempio, l'applicazione deve avere una risorsa audio denominata Form1Greeting nel relativo file di risorse. Il metodo My.Computer.Audio.Play è disponibile solo per le applicazioni Windows Forms.

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

Esempio 5

In questo esempio viene recuperata la versione delle impostazioni cultura francese di una risorsa stringa dell'applicazione. La risorsa è denominata Message. Per modificare le impostazioni cultura utilizzate dall'oggetto My.Resources, nell'esempio viene utilizzato ChangeUICulture.

Per il funzionamento di questo esempio, l'applicazione deve avere una stringa denominata Message nel file di risorse e deve avere la versione delle impostazioni cultura francese del file di risorse Resources.fr-FR.resx. Se l'applicazione non dispone della versione delle impostazioni cultura francese del file di risorse, l'oggetto My.Resource recupera la risorsa dal file di risorse delle impostazioni cultura predefinite.

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