My.Resources – objekt

Článek
03/13/2024

Poskytuje vlastnosti a třídy pro přístup k prostředkům aplikace.

Poznámky

Objekt My.Resources poskytuje přístup k prostředkům aplikace a umožňuje dynamicky načítat prostředky pro vaši aplikaci. Další informace naleznete v tématu Správa prostředků aplikace (.NET).

Objekt My.Resources zveřejňuje pouze globální prostředky. Neposkytuje přístup k souborům prostředků přidruženým k formulářům. K prostředkům formuláře je nutné přistupovat z formuláře.

Z objektu My.Resources můžete získat přístup k souborům prostředků specifické pro jazykovou verzi aplikace. Ve výchozím nastavení My.Resources objekt vyhledá prostředky ze souboru prostředku, který odpovídá jazykové verzi ve UICulture vlastnosti. Toto chování však můžete přepsat a určit konkrétní jazykovou verzi, která se má použít pro prostředky. Další informace najdete v tématu Prostředky v aplikacích .NET.

Vlastnosti

Vlastnosti objektu My.Resources poskytují přístup jen pro čtení k prostředkům vaší aplikace. Chcete-li přidat nebo odebrat zdroje, použijte Návrhář projektu. K prostředkům přidaným prostřednictvím Návrháře projektu můžete přistupovat pomocíMy.Resources. resourceName.

Soubory zdrojů můžete také přidat nebo odebrat tak, že vyberete projekt v Průzkumník řešení a v nabídce Projekt kliknete na Přidat novou položku nebo Přidat existující položku. K prostředkům přidaným tímto způsobem můžete přistupovat pomocí My.Resources.resourceFileName resourceName..

Každý prostředek má název, kategorii a hodnotu a tato nastavení prostředků určují, jak se vlastnost pro přístup k prostředku zobrazí v objektu My.Resources . Zdroje přidané v Návrháři projektu:

Název určuje název vlastnosti,
Data o prostředcích jsou hodnotou vlastnosti,
Kategorie určuje typ vlastnosti:

Kategorie	Datový typ vlastnosti
Řetězce	Řetězec
Obrázky	Bitmap
Ikony	Icon
Zvuk	UnmanagedMemoryStream Třída UnmanagedMemoryStream je odvozena od Stream třídy, takže ji lze použít s metodami, které přebírají datové proudy, jako Play je například metoda.
Soubory	- Řetězec pro textové soubory - Bitmap pro soubory obrázků. - Icon pro soubory ikon. - UnmanagedMemoryStream zvukových souborů.
Další	Určuje informace ve sloupci Typ návrháře.

Třídy

Objekt My.Resources zveřejňuje každý soubor prostředků jako třídu se sdílenými vlastnostmi. Název třídy je stejný jako název souboru prostředku. Jak je popsáno v předchozí části, prostředky v souboru prostředků jsou vystaveny jako vlastnosti ve třídě.

Příklad 1

Tento příklad nastaví název formuláře na prostředek řetězce pojmenovaný Form1Title v souboru prostředků aplikace. Aby aplikace fungovala, musí mít v souboru prostředků řetězec s názvem Form1Title .

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

Příklad 2

Tento příklad nastaví ikonu formuláře na ikonu s názvem Form1Icon , která je uložena v souboru prostředků aplikace. Aby aplikace fungovala, musí mít v souboru prostředků ikonu s názvem Form1Icon .

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

Příklad 3

Tento příklad nastaví obrázek pozadí formuláře na prostředek obrázku s názvem Form1Background, který je v souboru prostředků aplikace. Aby tento příklad fungoval, musí mít aplikace ve svém souboru prostředků prostředek image s názvem Form1Background .

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

Příklad 4

Tento příklad přehraje zvuk uložený jako zvukový prostředek pojmenovaný Form1Greeting v souboru prostředků aplikace. Aby aplikace fungovala, musí mít v souboru prostředků zvukový prostředek s názvem Form1Greeting . Metoda My.Computer.Audio.Play je k dispozici pouze pro model Windows Forms aplikace.

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

Příklad 5

Tento příklad načte verzi francouzské jazykové verze řetězcového prostředku aplikace. Zdroj má název Message. Chcete-li změnit jazykovou verzi, kterou My.Resources objekt používá, používá ChangeUICulturepříklad .

Aby tento příklad fungoval, musí mít aplikace v souboru prostředků řetězec s názvem Message a aplikace by měla mít verzi tohoto souboru prostředků ve francouzštině, Resources.fr-FR.resx. Pokud aplikace nemá verzi souboru prostředků ve francouzštině, My.Resource objekt načte prostředek ze souboru prostředků výchozí jazykové verze.

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