Freigeben über

My.Resources-Objekt

  • Artikel

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

Hinweise

Das My.Resources-Objekt ermöglicht den Zugriff auf die Ressourcen der Anwendung und das dynamische Abrufen von Ressourcen für die Anwendung.Weitere Informationen finden Sie unter Verwalten von Anwendungsressourcen.

Das My.Resources-Objekt macht nur globale Ressourcen verfügbar.Es stellt keinen Zugriff auf Formularen zugeordnete Ressourcendateien bereit.Sie müssen auf die Formularressourcen vom Formular aus zugreifen.Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Lokalisieren von Windows Forms.

Sie können auf die kulturspezifischen Ressourcendateien der Anwendung über das My.Resources-Objekt zugreifen.Das My.Resources-Objekt sucht standardmäßig nach Ressourcen aus der Ressourcendatei, die mit der Kultur in der UICulture-Eigenschaft übereinstimmt.Sie können dieses Verhalten jedoch überschreiben und eine bestimmte Kultur angeben, die für die Ressourcen verwendet werden soll.Weitere Informationen finden Sie unter Ressourcen in Desktop-Apps.

Eigenschaften

Die Eigenschaften des My.Resources-Objekts stellen schreibgeschützten Zugriff auf die Ressourcen der Anwendung bereit.Um Ressourcen hinzuzufügen oder zu entfernen, verwenden Sie den Projekt-Designer.Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen oder Entfernen von Ressourcen.Der Zugriff auf Ressourcen, die mit dem Projekt-Designer hinzugefügt wurden, erfolgt unter Verwendung von My.Resources.resourceName.

Sie können Ressourcendateien auch hinzufügen oder entfernen, indem Sie im Projektmappen-Explorer das Projekt auswählen und im Menü Projekt auf Neues Element hinzufügen oder Vorhandenes Element hinzufügen klicken.Der Zugriff auf Ressourcen, die auf diese Weise hinzugefügt wurden, erfolgt unter Verwendung von My.Resources.resourceFileName.resourceName.

Jede Ressource verfügt über einen Namen, eine Kategorie und einen Wert, und diese Ressourceneinstellungen bestimmen, wie die Eigenschaft für den Zugriff auf die Ressource im My.Resources-Objekt dargestellt wird.Für im Projekt-Designer hinzugefügte Ressourcen gelten folgende Bedingungen:

  • Der Name bestimmt den Namen der Eigenschaft.

  • Die Ressourcendaten sind der Wert der Eigenschaft.

  • Die Kategorie bestimmt den Typ der Eigenschaft:

Kategorie

Datentyp der Eigenschaft

Zeichenfolgen

Zeichenfolge

Bilder

Bitmap

Symbole

Icon

Audio

UnmanagedMemoryStream

Die UnmanagedMemoryStream-Klasse wird von der Stream-Klasse abgeleitet und kann daher für Methoden verwendet werden, die Streams akzeptieren, z. B. für die Play-Methode.

Dateien

Andere

Hängt von den Informationen in der Spalte Typ des Designers ab.

Klassen

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

Beispiel

In diesem Beispiel wird der Titel eines Formulars zur Zeichenfolgenressource fest, die Form1Title in der Anwendungsressourcendatei benannt ist.Damit das Beispiel für die Anwendung ausgeführt werden kann, muss eine Zeichenfolge in der Ressourcendatei der Form1Title .Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen oder Entfernen von Ressourcen.

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

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

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

In diesem Beispiel wird das Hintergrundbild eines Formulars zur Bildressource fest, die Form1Background, die in der Anwendungsressourcendatei ist.Für dieses Beispiel muss die Anwendung eine Bildressource verfügen, die Form1Background in der Ressourcendatei bezeichnet wird.

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

Dieses Beispiel gibt den Sound als Audiodaten Ressource gespeichert ist, die Form1Greeting in der Ressourcendatei der Anwendung.Damit das Beispiel für die Anwendung muss eine Audio- Ressource verfügen, die Form1Greeting in der Ressourcendatei bezeichnet wird.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

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

Für dieses Beispiel muss die Anwendung über eine Zeichenfolge Message , die in der Ressourcendatei erstellt, und die Anwendung sollte die Französisch-Kultur Version der Ressourcendatei, Resources.fr-FR.resx haben.Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen oder Entfernen von Ressourcen.Wenn die Anwendung keine Französisch-Kultur Version der Ressourcendatei verfügt, ruft das My.Resource-Objekt die Ressource aus der Ressourcendatei ab. Kultur DEFAULT

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

Aufgaben

Gewusst wie: Hinzufügen oder Entfernen von Ressourcen

Exemplarische Vorgehensweise: Lokalisieren von Windows Forms

Konzepte

Ressourcen in Desktop-Apps

Weitere Ressourcen

Verwalten von Anwendungsressourcen