(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

FrameworkElement.FindResource-Methode

Sucht eine Ressource mit dem angegebenen Schlüssel und löst eine Ausnahme aus, wenn die angeforderte Ressource nicht gefunden wird.

Namespace:  System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

public Object FindResource(
	Object resourceKey
)

Parameter

resourceKey
Typ: System.Object
Der Schlüsselbezeichner für die angeforderte Ressource.

Rückgabewert

Typ: System.Object
Die angeforderte Ressource. Wenn keine Ressource mit dem angegebenen Schlüssel gefunden wurde, wird eine Ausnahme ausgelöst. Bei einer Ausnahme kann auch ein UnsetValue-Wert zurückgegeben werden.

AusnahmeBedingung
ResourceReferenceKeyNotFoundException

resourceKey wurde nicht gefunden, und ein Ereignishandler ist für das UnhandledException-Ereignis nicht vorhanden.

- oder -

resourceKey wurde nicht gefunden und die Handled-Eigenschaft lautet false im UnhandledException-Ereignis.

ArgumentNullException

resourceKey ist null.

Wichtiger HinweisWichtig

Wenn Sie diese Methode für einen Schlüssel aufrufen, der nicht gefunden werden kann, wird eine Ausnahme ausgelöst. Wenn Sie keine Ausnahmen behandeln möchten, die auf das Aufrufen von FindResource zurückzuführen sind, rufen Sie stattdessen TryFindResource auf. TryFindResource gibt null zurück, wenn eine angeforderte Ressource nicht gefunden werden kann, und löst keine Ausnahme aus.

Wenn die Ressource im aufrufenden Element nicht gefunden werden kann, wird anschließend das übergeordnete Element in der logischen Struktur durchsucht, dann die Anwendung, die Designs und schließlich die Systemressourcen. Diese Suchmethodik entspricht dem Suchvorgang in der Struktur, wenn eine Ressource von einem dynamischen Ressourcenverweis in Markup angefordert wurde. Weitere Informationen zur Ressourcensuche finden Sie unter XAML-Ressourcen.

Ein FindResource-Rückgabewert wird i. d. R. unmittelbar in den Typ der Eigenschaft umgewandelt, die Sie mit dem zurückgegebenen Ressourcenwert festlegen.

Ressourcenschlüssel sind nicht unbedingt Zeichenfolgen. Beispielsweise können Stile für Steuerelemente auf Designebene absichtlich mit dem Type des Steuerelements verknüpft werden, und Anwendungs- oder Seitenstile für Steuerelemente verwenden i. d. R. die gleiche Schlüsselkonvention. Details zu diesem Thema finden Sie unter Erstellen von Formaten und Vorlagen oder XAML-Ressourcen.

Im folgenden Beispiel wird eine benannte Ressource abgerufen und zum Füllen einer Eigenschaft in einen geeigneten Typ umgewandelt.


void SetBGByResource(object sender, RoutedEventArgs e)
{
  Button b = sender as Button;
  b.Background = (Brush)this.FindResource("RainbowBrush");
}


.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft