FrameworkContentElement.FindResource(Object) Método

Definición

Espacio de nombres:

System.Windows

Ensamblado:

PresentationFramework.dll

Busca un recurso con la clave especificada e inicia una excepción si no se encuentra el recurso solicitado.

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

Parámetros

resourceKey

Object

Identificador de clave del recurso que se debe encontrar.

Devoluciones

Object

Recurso encontrado, o null si no se encontró ningún recurso coincidente (pero también se iniciará una excepción si null).

Excepciones

ResourceReferenceKeyNotFoundException

No se encontró la clave de recurso solicitada.

ArgumentNullException

resourceKey es null.

Ejemplos

En el ejemplo siguiente se busca un recurso como se define en el marcado y se aplica a una propiedad determinada de un elemento en respuesta a un evento enrutado.

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

Comentarios

Importante

Si llama a este método para una clave que no se encuentra, se produce una excepción. Si no desea controlar las excepciones de este caso, debe llamar a TryFindResource. TryFindResource devuelve null cuando no se encuentra ningún recurso y no produce una excepción.

Si el recurso no se encuentra en el elemento que realiza la llamada, se busca en el árbol primario mediante el árbol lógico, de la misma manera que se buscaría en el árbol si la clave solicitase un recurso en tiempo de ejecución.

Normalmente, debería convertir inmediatamente el valor devuelto al tipo de la propiedad que estaba intentando establecer con el valor de recurso devuelto.