My.Resources-Objekt

Stellt Eigenschaften und Klassen für den Zugriff auf die Ressourcen der Anwendung bereit.

Bemerkungen

Das My.Resources Objekt bietet Zugriff auf die Ressourcen der Anwendung und ermöglicht es Ihnen, Ressourcen für Ihre Anwendung dynamisch abzurufen. Weitere Informationen finden Sie unter Verwalten von Anwendungsressourcen (.NET).

Das My.Resources Objekt macht nur globale Ressourcen verfügbar. Es bietet keinen Zugriff auf Ressourcendateien, die Formularen zugeordnet sind. Sie müssen über das Formular auf die Formularressourcen zugreifen.

Sie können auf die kulturspezifischen Ressourcendateien der Anwendung über das My.Resources Objekt zugreifen. Standardmäßig sucht das My.Resources Objekt Ressourcen aus der Ressourcendatei, die der Kultur in der UICulture Eigenschaft entspricht. Sie können dieses Verhalten jedoch außer Kraft setzen und eine bestimmte Kultur angeben, die für die Ressourcen verwendet werden soll. Weitere Informationen finden Sie unter Ressourcen in .NET-Apps.

Eigenschaften

Die Eigenschaften des My.Resources Objekts bieten schreibgeschützten Zugriff auf die Ressourcen Ihrer Anwendung. Um Ressourcen hinzuzufügen oder zu entfernen, verwenden Sie den Project Designer. Sie können mithilfe von My.Resources.resourceName auf Ressourcen zugreifen, die über den Project Designer hinzugefügt wurden.

Sie können ressourcendateien auch hinzufügen oder entfernen, indem Sie im Projektmappen-Explorer ihr Projekt auswählen und im Menü Projekt auf "Neues Element hinzufügen" oder "Vorhandenes Element hinzufügen" klicken. Sie können auf ressourcen zugreifen, die auf diese Weise hinzugefügt wurden, indem My.Resources. Sie resourceFileName resourceName. verwenden.

Jede Ressource verfügt über einen Namen, eine Kategorie und einen Wert, und diese Ressourceneinstellungen bestimmen, wie die Eigenschaft auf die Ressource im My.Resources Objekt zugegriffen werden soll. Für Ressourcen, die im Project Designer hinzugefügt wurden:

• Der Name bestimmt den Namen der Eigenschaft,

• Die Ressourcendaten sind der Wert der Eigenschaft,

• Die Kategorie bestimmt den Typ der Eigenschaft:

Kategorie	Eigenschafts-Datentyp
Zeichenfolgen	String
Bilder	Bitmap
Symbole	Icon
Audio	UnmanagedMemoryStream Die UnmanagedMemoryStream Klasse wird von der Stream Klasse abgeleitet, sodass sie mit Methoden verwendet werden kann, die Datenströme verwenden, z. B. die Play Methode.
Dateien	- Zeichenfolge für Textdateien. - Bitmap für Bilddateien. - Icon für Symboldateien. - UnmanagedMemoryStream für Audiodateien.
Andere	Bestimmt durch die Informationen in der Spalte " Typ " des Designers.

Klassen

Das My.Resources Objekt macht jede Ressourcendatei als Klasse mit freigegebenen Eigenschaften verfügbar. Der Klassenname entspricht dem Namen der Ressourcendatei. Wie im vorherigen Abschnitt beschrieben, werden die Ressourcen in einer Ressourcendatei als Eigenschaften in der Klasse verfügbar gemacht.

Beispiel 1

In diesem Beispiel wird der Titel eines Formulars auf die in der Anwendungsressourcendatei benannte Form1Title Zeichenfolgenressource festgelegt. Damit das Beispiel funktioniert, muss die Anwendung über eine Zeichenfolge verfügen, die in der Ressourcendatei benannt ist Form1Title .

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

Beispiel 2

In diesem Beispiel wird das Symbol des Formulars auf das Symbol Form1Icon festgelegt, das in der Ressourcendatei der Anwendung gespeichert ist. Damit das Beispiel funktioniert, muss die Anwendung über ein Symbol verfügen, das in der Ressourcendatei benannt Form1Icon ist.

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

Beispiel 3

In diesem Beispiel wird das Hintergrundbild eines Formulars auf die Bildressource namens Form1Backgroundfestgelegt, die sich in der Anwendungsressourcendatei befindet. Damit dieses Beispiel funktioniert, muss die Anwendung über eine Bildressource verfügen, die in der Ressourcendatei benannt Form1Background ist.

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

Beispiel 4

In diesem Beispiel wird der Sound wiedergegeben, der als Audioressource Form1Greeting in der Ressourcendatei der Anwendung gespeichert ist. Damit das Beispiel funktioniert, muss die Anwendung über eine Audioressource verfügen, die in der Ressourcendatei benannt Form1Greeting ist. Die My.Computer.Audio.Play Methode ist nur für Windows Forms-Anwendungen verfügbar.

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

Beispiel 5

In diesem Beispiel wird die Französisch-Kulturversion einer Zeichenfolgenressource der Anwendung abgerufen. Die Ressource wird benannt Message. Um die Kultur zu ändern, die das My.Resources Objekt verwendet, wird im Beispiel verwendet ChangeUICulture.

Damit dieses Beispiel funktioniert, muss die Anwendung über eine Zeichenfolge verfügen, die in der Ressourcendatei benannt Message ist, und die Anwendung sollte über die Französisch-Kulturversion dieser Ressourcendatei ,Resources.fr-FR.resx verfügen. Wenn die Anwendung nicht über die Französisch-Kultur-Version der Ressourcendatei verfügt, ruft das My.Resource Objekt die Ressource aus der Ressourcendatei der Standardkultur ab.

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

Siehe auch

• Verwalten von Anwendungsressourcen (.NET)
• Ressourcen in .NET-Apps