Oggetto My.Resources

Fornisce proprietà e classi per accedere alle risorse dell'applicazione.

Note

L'oggetto My.Resources fornisce accesso alle risorse dell'applicazione e consente di recuperarle dinamicamente. Per ulteriori informazioni, vedere Gestione delle risorse delle applicazioni.

L'oggetto My.Resources espone soltanto risorse globali. Non consente di accedere ai file di risorse associati ai form. È necessario accedere alle risorse del form dal form stesso. Per ulteriori informazioni, vedere Procedura dettagliata: localizzazione di Windows Form.

È 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 nel file delle risorse che corrisponde alle impostazioni cultura nella proprietà UICulture. È comunque possibile eseguire l'override di tale comportamento e specificare impostazioni cultura particolari da utilizzare per le risorse. Per ulteriori informazioni, vedere Risorse nelle applicazioni desktop.

Proprietà

Le proprietà dell'oggetto My.Resources forniscono l'accesso di sola lettura alle risorse dell'applicazione. Per aggiungere o rimuovere risorse, utilizzare Progettazione progetti. Per ulteriori informazioni, vedere Procedura: aggiungere o rimuovere risorse. È possibile accedere alle risorse aggiunte mediante Progettazione progetti utilizzando My.Resources.resourceName.

È inoltre possibile aggiungere o rimuovere file di risorse selezionando il progetto in Esplora soluzioni e scegliendo Aggiungi nuovo elemento o Aggiungi elemento esistente dal menu Progetto. È possibile accedere alle risorse aggiunte in tal modo tramite My.Resources.resourceFileName.resourceName.

Per ogni risorsa vengono specificati un nome, una categoria e un valore e queste impostazioni determinano il modo in cui la proprietà che consente l'accesso alla risorsa viene visualizzata nell'oggetto My.Resources. Per le risorse aggiunte in Progettazione progetti:

• Il nome equivale al nome della proprietà,

• I dati della risorsa equivalgono al valore della proprietà,

• La categoria equivale al tipo della proprietà:

Categoria	Tipo di dati della proprietà
Stringhe	String
Immagini	Bitmap
Icone	Icon
Audio	UnmanagedMemoryStream La classe UnmanagedMemoryStream viene derivata dalla classe Stream e può quindi essere utilizzata con metodi che accettano flussi, ad esempio il metodo Play.
File	Stringa per file di testo. Bitmap per file di immagini. Icon per file di icona. UnmanagedMemoryStream per file audio.
Altro	Viene determinato dalle informazioni contenute nella colonna Tipo nella finestra di progettazione.

Classi

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

Esempio

Questo esempio consente di impostare il titolo di un form nella risorsa di tipo stringa denominata Form1Title nel file di risorse dell'applicazione. Per l'esempio funzioni, l'applicazione deve contenere una stringa denominata Form1Title nel file di risorse. Per ulteriori informazioni, vedere Procedura: aggiungere o rimuovere risorse.

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

Nell'esempio seguente l'icona del form viene impostata sull'icona denominata Form1Icon che è memorizzata nel file di risorse dell'applicazione. Per l'esempio funzioni, l'applicazione deve contenere un'icona denominata Form1Icon nel file di risorse.

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

In questo esempio l'immagine di sfondo di un form la risorsa immagine denominata Form1Background, che si trova nel file di risorse dell'applicazione. Per questo esempio funzioni, l'applicazione deve contenere una risorsa immagine denominata Form1Background nel file di risorse.

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

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

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

In questo esempio vengono recuperati dalla versione con impostazioni cultura francesi di una risorsa di tipo stringa dell'applicazione. La risorsa viene denominata Message. Per modificare le impostazioni cultura che My.Resources utilizzo dell'oggetto, gli utilizzi di esempio ChangeUICulture.

Per questo esempio funzioni, l'applicazione deve contenere una stringa denominata Message nel file di risorse e dell'applicazione disponga della versione con impostazioni cultura francesi del file di risorse, corretto. Per ulteriori informazioni, vedere Procedura: aggiungere o rimuovere risorse. Se l'applicazione non dispone della versione con impostazioni cultura francesi del file di risorse, My.Resource l'oggetto recupera la risorsa da un 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

Vedere anche

Attività

Procedura dettagliata: localizzazione di Windows Form

Concetti

Risorse nelle applicazioni desktop

Altre risorse

Procedura: aggiungere o rimuovere risorse

Gestione delle risorse delle applicazioni