FrameworkContentElement.FindResource(Object) Método

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Pesquisa um recurso com a chave especificada e gera uma exceção se o recurso solicitado não é encontrado.

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

O identificador de chave do recurso a ser encontrado.

Retornos

Object

O recurso encontrado ou null, se nenhum recurso correspondente foi encontrado (mas também gera uma exceção se null).

Exceções

ResourceReferenceKeyNotFoundException

A chave do recurso solicitado não foi localizada.

ArgumentNullException

resourceKey é null.

Exemplos

O exemplo a seguir localiza um recurso conforme definido na marcação e o aplica a uma determinada propriedade de um elemento em resposta a um evento roteado.

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

Comentários

Importante

Se você chamar esse método para uma chave que não pode ser encontrada, uma exceção será gerada. Se você não quiser lidar com exceções para esse caso, em vez disso TryFindResource, chame . TryFindResource retorna null quando nenhum recurso é encontrado e não gera uma exceção.

Se o recurso não for encontrado no elemento de chamada, a árvore pai será pesquisada usando a árvore lógica, da mesma forma que a árvore seria pesquisada se um recurso fosse solicitado por chave em tempo de execução.

Normalmente, você converteria imediatamente o valor retornado para o tipo da propriedade que você estava tentando definir com o valor do recurso retornado.