Setter.Property Property

Definition

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Gets or sets the property to which the Value will be applied.

C#

[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Modifiability=System.Windows.Modifiability.Unmodifiable, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.Ambient]
public System.Windows.DependencyProperty Property { get; set; }

Property Value

DependencyProperty

A DependencyProperty to which the Value will be applied. The default value is null.

Attributes

LocalizabilityAttribute AmbientAttribute

Exceptions

ArgumentNullException

The Property property cannot be null.

ArgumentException

The specified Property property cannot be read-only.

InvalidOperationException

If the specified Value is not valid for the type of the specified Property.

Examples

The following example defines a style that will be applied to every TextBlock element.

XAML

<Style TargetType="{x:Type TextBlock}">
  <Setter Property="FontFamily" Value="Segoe Black" />
  <Setter Property="HorizontalAlignment" Value="Center" />
  <Setter Property="FontSize" Value="12pt" />
  <Setter Property="Foreground" Value="#777777" />
</Style>

The following example shows a style declaration that will affect the Background property of a Control. Note that property name in this example is qualified with the name of the class (Control) because the Style does not specify a TargetType.

XAML

<Style x:Key="Style1">
  <Setter Property="Control.Background" Value="Yellow"/>
</Style>

Remarks

Note that you must specify both the Property and Value properties on a Setter or an exception will be thrown.

Applies to

See also

• Value