TextBlock.Text Property

Definition

Gets or sets the text contents of a TextBlock.

C#
[System.Windows.Localizability(System.Windows.LocalizationCategory.Text)]
public string Text { get; set; }

Property Value

The text contents of this TextBlock. Note that all non-text content is stripped out, resulting in a plain text representation of the TextBlock contents. The default is Empty.

Attributes

Examples

The following example shows how to set the Text attribute of a TextBlock element.

XAML
<TextBlock Text="The text contents of this TextBlock element."/>

Alternately, the contents of a text run may simply be contained by TextBlock element tags.

The following example shows how to set the Text property programmatically.

C#
TextBlock textBlock = new TextBlock();
textBlock.Text = "The text contents of this TextBlock.";

Remarks

Use this property when you want to show plain text in a TextBlock. When you need to format the text, add Inline objects to the Inlines property.

Dependency Property Information

Item Value
Identifier field TextProperty
Metadata properties set to true AffectsMeasure, AffectsRender

Applies to

Product Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9, 10