Setter.Property Property

Reference

Definition

Namespace:: System.Windows

Assembly:: PresentationFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
 property System::Windows::DependencyProperty ^ Property { System::Windows::DependencyProperty ^ get(); void set(System::Windows::DependencyProperty ^ value); };

[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; }

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Modifiability=System.Windows.Modifiability.Unmodifiable, Readability=System.Windows.Readability.Unreadable)>]
[<System.Windows.Markup.Ambient>]
member this.Property : System.Windows.DependencyProperty with get, set

Public Property Property As DependencyProperty

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.

<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.

<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