FrameworkContentElement.FindResource(Object) Método

Definição

Espaço de Nomes:
System.Windows
Assemblagem:
PresentationFramework.dll

Procura um recurso com a chave especificada e lança uma exceção se o recurso solicitado não for 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

Identificador-chave do recurso a encontrar.

Devoluções

Object

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

Exceções

ResourceReferenceKeyNotFoundException

A chave de recurso solicitada não foi encontrada.

ArgumentNullException

resourceKey é null.

Exemplos

O exemplo seguinte encontra um recurso conforme definido em marcação e aplica-o a uma certa propriedade de um elemento em resposta a um evento encaminhado.

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

Observações

Importante

Se chamar este método para uma chave que não pode ser encontrada, é lançada uma exceção. Se não quiser tratar de exceções neste caso, deve antes ligar TryFindResourcepara . TryFindResource retorna null quando não é encontrado nenhum recurso e não lança exceção.

Se o recurso não for encontrado no elemento que chama, a árvore mãe é 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, seria imediatamente atribuído o valor de retorno ao tipo da propriedade que estava a tentar definir com o valor do recurso devolvido.

Aplica-se a