FrameworkContentElement.FindResource(Object) FrameworkContentElement.FindResource(Object) FrameworkContentElement.FindResource(Object) FrameworkContentElement.FindResource(Object) Method

Definition

Sucht nach einer Ressource mit dem angegebenen Schlüssel und löst eine Ausnahme aus, wenn die angeforderte Ressource nicht gefunden wird.Searches for a resource with the specified key, and will throw an exception if the requested resource is not found.

public:
 System::Object ^ FindResource(System::Object ^ resourceKey);
public object FindResource (object resourceKey);
member this.FindResource : obj -> obj
Public Function FindResource (resourceKey As Object) As Object

Parameter

resourceKey
Object Object Object Object

Der Schlüsselbezeichner der zu findenden Ressource.Key identifier of the resource to be found.

Gibt zurück

Die gefundene Ressource oder null, wenn keine übereinstimmende Ressource gefunden wurde (bei null wird ebenfalls eine Ausnahme ausgelöst).The found resource, or null if no matching resource was found (but will also throw an exception if null).

Ausnahmen

Der angeforderte Ressourcenschlüssel wurde nicht gefunden.The requested resource key was not found.

Beispiele

Im folgenden Beispiel wird eine Ressource wie in Markup definiert gefunden und auf eine bestimmte Eigenschaft eines Elements als Reaktion auf ein Routing Ereignis angewendet.The following example finds a resource as defined in markup and applies it to a certain property of an element in response to a routed event.

void SetBGByResource(object sender, RoutedEventArgs e)
{
    Block b = sender as Block;
    b.Background = (Brush)this.FindResource("RainbowBrush");
}
Private Sub SetBGByResource(ByVal sender As Object, ByVal e As RoutedEventArgs)
    Dim b As Block = TryCast(sender, Block)
    b.Background = CType(Me.FindResource("RainbowBrush"), Brush)
End Sub

Hinweise

Wichtig

Wenn Sie diese Methode für einen Schlüssel aufgerufen haben, der nicht gefunden werden kann, wird eine Ausnahme ausgelöst.If you call this method for a key that cannot be found, an exception is thrown. Wenn Sie in diesem Fall keine Ausnahmen behandeln möchten, sollten Sie stattdessen TryFindResourceausführen.If you do not want to handle exceptions for this case, you should instead call TryFindResource. TryFindResourcegibt null zurück, wenn keine Ressource gefunden wird und keine Ausnahme auslöst.TryFindResource returns null when no resource is found, and does not throw an exception.

Wenn die Ressource im aufrufenden Element nicht gefunden wird, wird die übergeordnete Struktur mithilfe der logischen Struktur durchsucht, und zwar auf dieselbe Weise, wie die Struktur durchsucht wird, wenn eine Ressource zur Laufzeit von einem Schlüssel angefordert wurde.If the resource is not found on the calling element, the parent tree is searched using the logical tree, in the same way that the tree would be searched if a resource were requested by key at run-time.

In der Regel würden Sie den Rückgabewert sofort in den Typ der Eigenschaft umwandeln, die Sie mit dem zurückgegebenen Ressourcen Wert festlegen wollten.Typically you would immediately cast the return value to the type of the property that you were attempting to set with the returned resource value.

Gilt für: