My.Resources-Objekt (Visual Basic)
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 Anwendungen.
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 |
|
Bildern |
|
Symbole |
|
Audio |
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.
Aufgaben
In der folgenden Tabelle werden Beispiele für Aufgaben mit dem My.Resources-Objekt aufgeführt.
To |
Siehe |
Abrufen einer Zeichenfolgenressource |
Gewusst wie: Abrufen von Zeichenfolgenressourcen in Visual Basic |
Abrufen einer Bildressource |
|
Abrufen einer Symbolressource |
|
Abrufen einer Audioressource |
|
Abrufen einer lokalisierten Ressource |
Gewusst wie: Abrufen von lokalisierten Ressourcen in Visual Basic |
Beispiel
In diesem Beispiel wird das Symbol des Formulars auf das Symbol Form1Icon festgelegt, das in der Ressourcendatei der Anwendung gespeichert ist.
Sub SetFormIcon()
Me.Icon = My.Resources.Form1Icon
End Sub
Damit dieses Beispiel ausgeführt werden kann, muss in der Ressourcendatei der Anwendung das Symbol Form1Icon vorhanden sein. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen oder Entfernen von Ressourcen.
Siehe auch
Aufgaben
Gewusst wie: Abrufen von Zeichenfolgenressourcen in Visual Basic
Gewusst wie: Abrufen von Bildressourcen in Visual Basic
Gewusst wie: Abrufen von Symbolressourcen in Visual Basic
Gewusst wie: Abrufen von Audioressourcen in Visual Basic
Gewusst wie: Abrufen von lokalisierten Ressourcen in Visual Basic
Gewusst wie: Hinzufügen oder Entfernen von Ressourcen
Exemplarische Vorgehensweise: Lokalisieren von Windows Forms