FrameworkContentElement.FindResource(Object) Metoda

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationFramework.dll

Wyszukuje zasób z określonym kluczem i zgłasza wyjątek, jeśli żądany zasób nie zostanie znaleziony.

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

Parametry

resourceKey

Object

Identyfikator klucza zasobu do znalezienia.

Zwraca

Object

Znaleziony zasób lub null jeśli nie znaleziono pasującego zasobu (ale również zgłosi wyjątek, jeśli null).

Wyjątki

ResourceReferenceKeyNotFoundException

Nie można odnaleźć żądanego klucza zasobu.

ArgumentNullException

resourceKey to null.

Przykłady

Poniższy przykład znajduje zasób zdefiniowany w znacznikach i stosuje go do określonej właściwości elementu w odpowiedzi na zdarzenie kierowane.

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

Uwagi

Ważne

Jeśli wywołasz tę metodę dla klucza, którego nie można odnaleźć, zostanie zgłoszony wyjątek. Jeśli nie chcesz obsługiwać wyjątków dla tego przypadku, należy wywołać metodę TryFindResource. TryFindResource zwraca wartość null , gdy nie znaleziono zasobu i nie zgłasza wyjątku.

Jeśli zasób nie zostanie znaleziony w elemecie wywołującym, drzewo nadrzędne jest przeszukiwane przy użyciu drzewa logicznego, w taki sam sposób, w jaki drzewo zostanie przeszukane, jeśli zasób został żądany przez klucz w czasie wykonywania.

Zazwyczaj zwracana wartość jest natychmiast rzutowana na typ właściwości, którą próbowano ustawić przy użyciu zwróconej wartości zasobu.