TextElement.FindName Method
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Gets an object in the Silverlight object model by referencing the object's x:Name or Name attribute value.
Namespace: System.Windows.Documents
Assembly: System.Windows (in System.Windows.dll)
Syntax
'Declaration
Public Function FindName ( _
name As String _
) As Object
public Object FindName(
string name
)
Parameters
- name
Type: System.String
The name of the object to retrieve.
Return Value
Type: System.Object
The object that has the specified name, or nulla null reference (Nothing in Visual Basic) if no object is retrieved.
Remarks
FrameworkElement is the class that implements Name support for most other Silverlight objects, such as Canvas, but TextElement is not a FrameworkElement. Therefore TextElement supports its own Name and FindName implementations so that you can still retrieve XAML-instantiated instances of TextElement classes such as Run at run time, and you can arbitrarily call FindName again on any Silverlight object you retrieved from calling FindName previously. You can use the TextElement-defined FindName to find a named element specified as a FrameworkElement Name,and vice versa. Because FindName relies on all XAML being parsed for the Name attributes, you should not attempt to call FindName until the XAML is loaded. There are limitations across XAML namescopes. For details, see XAML Namescopes.
Version Information
Silverlight
Supported in: 5, 4
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.