Export (0) Print
Expand All

FrameworkElement.TryFindResource Method

Searches for a resource with the specified key, and returns that resource if found.

Namespace:  System.Windows
Assembly:  PresentationFramework (in PresentationFramework.dll)

public Object TryFindResource(
	Object resourceKey
)

Parameters

resourceKey
Type: System.Object
The key identifier of the resource to be found.

Return Value

Type: System.Object
The found resource, or null if no resource with the provided key is found.

If the resource is not found on the calling element, the parent resource tree is searched upward through the logical tree, in the same way that the tree would be searched if a resource were requested by key at run time. The method returns null only if no resource of that key existed anywhere in the resource tree, per the existing conditions of the tree at the time that TryFindResource is called.

Typically you would immediately cast the return value to the type of the property that you were attempting to set with the returned resource value.

The FindResource method has similar behavior, except that it throws an exception if no resource with the provided key was returned.

The following example is implemented as a button handler, where the button being clicked sets its background to a resource-defined brush obtained by calling TryFindResource on itself. This walks the element tree and finds the resource (the resource itself is defined in XAML and is not shown).


void TryFind(object sender, RoutedEventArgs e)  {
    Button b = e.Source as Button;
    b.Background = (Brush)b.TryFindResource("customBrush");
}    


.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2014 Microsoft