Setter.Property Property (System.Windows)

Property Property

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2010/.NET Framework 4

Other versions are also available for the following:

.NET Framework Class Library

Setter..::.Property Property

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

Namespace: System.Windows
Assembly: PresentationFramework (in PresentationFramework.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

Syntax

Visual Basic

<LocalizabilityAttribute(LocalizationCategory.None, Modifiability := Modifiability.Unmodifiable,  _
    Readability := Readability.Unreadable)> _
<AmbientAttribute> _
Public Property Property As DependencyProperty
    Get
    Set

[LocalizabilityAttribute(LocalizationCategory.None, Modifiability = Modifiability.Unmodifiable, 
    Readability = Readability.Unreadable)]
[AmbientAttribute]
public DependencyProperty Property { get; set; }

Visual C++

[LocalizabilityAttribute(LocalizationCategory::None, Modifiability = Modifiability::Unmodifiable, 
    Readability = Readability::Unreadable)]
[AmbientAttribute]
public:
property DependencyProperty^ Property {
    DependencyProperty^ get ();
    void set (DependencyProperty^ value);
}

[<LocalizabilityAttribute(LocalizationCategory.None, Modifiability = Modifiability.Unmodifiable, 
    Readability = Readability.Unreadable)>]
[<AmbientAttribute>]
member Property : DependencyProperty with get, set

XAML Attribute Usage

<object Property="DependencyProperty" .../>

Property Value

Type: System.Windows..::.DependencyProperty
A DependencyProperty to which the Value will be applied. The default value is null.

Exceptions

Exception	Condition
ArgumentNullException	The Property property cannot be nullNothingnullptra null reference (Nothing in Visual Basic).
ArgumentException	The specified Property property cannot be read-only.
InvalidOperationException	If the specified Value is not valid for the type of the specified Property.

Remarks

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

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>

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

Setter Class

System.Windows Namespace

Value

Other Resources

Styling and Templating

Data Templating Overview