My.Resources-object

Artikel
03/13/2024

Biedt eigenschappen en klassen voor toegang tot de resources van de toepassing.

Opmerkingen

Het My.Resources object biedt toegang tot de resources van de toepassing en stelt u in staat om dynamisch resources voor uw toepassing op te halen. Zie Toepassingsresources beheren (.NET) voor meer informatie.

Het My.Resources object maakt alleen globale resources beschikbaar. Het biedt geen toegang tot resourcebestanden die zijn gekoppeld aan formulieren. U moet toegang krijgen tot de formulierbronnen vanuit het formulier.

U hebt toegang tot de cultuurspecifieke bronbestanden van de toepassing vanuit het My.Resources object. Standaard zoekt het My.Resources object resources op uit het resourcebestand dat overeenkomt met de cultuur in de UICulture eigenschap. U kunt dit gedrag echter negeren en een bepaalde cultuur opgeven die moet worden gebruikt voor de resources. Zie Resources in .NET-apps voor meer informatie.

Eigenschappen

De eigenschappen van het My.Resources object bieden alleen-lezentoegang tot de resources van uw toepassing. Als u resources wilt toevoegen of verwijderen, gebruikt u Projectontwerper. U hebt toegang tot resources die zijn toegevoegd via Projectontwerper met behulp vanMy.Resources. resourceName.

U kunt ook resourcebestanden toevoegen of verwijderen door uw project te selecteren in Solution Explorer en te klikken op Nieuw item toevoegen of Bestaand item toevoegen in het menu Project. U kunt op deze manier toegang krijgen tot resources die zijn toegevoegd met behulp van My.Resources.resourceFileName resourceName..

Elke resource heeft een naam, categorie en waarde en deze resource-instellingen bepalen hoe de eigenschap voor toegang tot de resource in het My.Resources object wordt weergegeven. Voor resources die zijn toegevoegd in projectontwerper:

De naam bepaalt de naam van de eigenschap,
De resourcegegevens zijn de waarde van de eigenschap.
De categorie bepaalt het type eigenschap:

Categorie	Gegevenstype eigenschap
Tekenreeksen	Tekenreeks
Afbeeldingen	Bitmap
Pictogrammen	Icon
Audio	UnmanagedMemoryStream De UnmanagedMemoryStream klasse is afgeleid van de Stream klasse, zodat deze kan worden gebruikt met methoden die stromen aannemen, zoals de Play methode.
Bestanden	- Tekenreeks voor tekstbestanden. - Bitmap voor afbeeldingsbestanden. - Icon voor pictogrambestanden. - UnmanagedMemoryStream voor geluidsbestanden.
Overig	Bepaald door de informatie in de kolom Type van de ontwerpfunctie.

Klassen

Het My.Resources object toont elk resourcebestand als een klasse met gedeelde eigenschappen. De klassenaam is hetzelfde als de naam van het resourcebestand. Zoals beschreven in de vorige sectie, worden de resources in een resourcebestand weergegeven als eigenschappen in de klasse.

Voorbeeld 1

In dit voorbeeld wordt de titel van een formulier ingesteld op de tekenreeksresource met de naam Form1Title in het toepassingsresourcebestand. Het voorbeeld werkt alleen als de toepassing een tekenreeks heeft met de naam Form1Title in het resourcebestand.

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

Voorbeeld 2

In dit voorbeeld wordt het pictogram van het formulier ingesteld op het pictogram met de naam Form1Icon dat is opgeslagen in het resourcebestand van de toepassing. Het voorbeeld werkt alleen als de toepassing een pictogram heeft met de naam Form1Icon in het resourcebestand.

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

Voorbeeld 3

In dit voorbeeld wordt de achtergrondafbeelding van een formulier ingesteld op de afbeeldingsresource met de naam Form1Background, die zich in het toepassingsresourcebestand bevindt. Om dit voorbeeld te laten werken, moet de toepassing een installatiekopieënresource hebben met de naam Form1Background in het resourcebestand.

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

Voorbeeld 4

In dit voorbeeld wordt het geluid afgespeeld dat is opgeslagen als een audioresource met de naam Form1Greeting in het resourcebestand van de toepassing. Het voorbeeld werkt alleen als de toepassing een audioresource met de naam Form1Greeting in het resourcebestand heeft. De My.Computer.Audio.Play methode is alleen beschikbaar voor Windows Forms-toepassingen.

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

Voorbeeld 5

In dit voorbeeld wordt de Franse cultuurversie van een tekenreeksresource van de toepassing opgehaald. De resource heeft de naam Message. Als u de cultuur wilt wijzigen die door het My.Resources object wordt gebruikt, wordt in het voorbeeld gebruikgemaakt ChangeUICulturevan .

Om dit voorbeeld te laten werken, moet de toepassing een tekenreeks hebben met de naam Message in het resourcebestand en moet de toepassing de Franse cultuurversie van dat resourcebestand hebben, Resources.fr-FR.resx. Als de toepassing niet beschikt over de Franse cultuurversie van het resourcebestand, haalt het My.Resource object de resource op uit het resourcebestand van de standaardcultuur.

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

Delen via