Application.FindResource(Object) Método

Definição

Procura um recurso de interface de utilizador (UI), como um Style ou Brush, com a chave especificada, e lança uma exceção se o recurso solicitado não for encontrado (ver Recursos XAML).

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 nome do recurso a encontrar.

Devoluções

O objeto de recurso solicitado. Se o recurso solicitado não for encontrado, um ResourceReferenceKeyNotFoundException é lançado.

Exceções

O recurso não pode ser encontrado.

Exemplos

O exemplo seguinte mostra como usar FindResource para encontrar um recurso e como lidar ResourceReferenceKeyNotFoundException caso o recurso não seja encontrado.

void findResourceButton_Click(object sender, RoutedEventArgs e) {
  try {
    object resource = Application.Current.FindResource("UnfindableResource");
  }
  catch (ResourceReferenceKeyNotFoundException ex) {
    MessageBox.Show("Resource not found.");
  }
}
Private Sub findResourceButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
  Try
    Dim resource As Object = Application.Current.FindResource("UnfindableResource")
  Catch ex As ResourceReferenceKeyNotFoundException
    MessageBox.Show("Resource not found.")
  End Try
End Sub

Observações

FindResource Primeiro, procurarei recursos no âmbito da aplicação para o recurso especificado. Os recursos no âmbito da aplicação são geridos por Application, e estão expostos a partir da Resources propriedade. Se o recurso especificado não for encontrado no conjunto de recursos do âmbito da aplicação, FindResource então pesquisa nos recursos do sistema. Recursos do sistema são recursos de shell definidos pelo utilizador e incluem cores, fontes e configurações de shell. Estas são expostas a partir dos SystemColorstipos, SystemFonts, , e SystemParameters , respetivamente, como propriedades estáticas. Para os adquirir FindResource , estes tipos também expõem propriedades de chave de recurso que são concebidas para serem passadas a FindResource; por exemplo, IconWidthKey.

Como FindResource devolve um objeto, deve lançar o valor devolvido para o tipo apropriado se o recurso for encontrado.

Importante

Se chamar este método para uma chave que não pode ser encontrada, é lançada uma exceção. Se não quiser lidar com exceções que resultam de chamar FindResource, chame TryFindResource em vez disso; TryFindResource retorna uma null referência quando um recurso solicitado não pode ser encontrado, e não lança uma exceção.

Este método é seguro para threads e pode ser chamado a partir de qualquer thread.

Aplica-se a

Ver também