TextElement.Name Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets a unique identification for the object. Name can only be set from initial parsing of XAML.

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

Syntax

'Declaration
Public ReadOnly Property Name As String
public string Name { get; }
<textElement Name="xamlNameString" ... />

Property Value

Type: System.String
The unique identifier for the object. This property is read-only for code, but write-only for XAML, due to special parser handling of XAML properties named "Name".

Remarks

See XamlName Grammar for string value restrictions on Name. The value used for Name must conform to this grammar.

TextElement is not a FrameworkElement. FrameworkElement is the class that implements Name support for most other Silverlight objects, such as Canvas, but TextElement cannot be a FrameworkElement because it must function as a true inline for rendering and layout considerations. 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.

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.