DatePicker.SelectedDate Property

Reference

Definition

Namespace:: System.Windows.Controls

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 currently selected date.

public:
 property Nullable<DateTime> SelectedDate { Nullable<DateTime> get(); void set(Nullable<DateTime> value); };

public DateTime? SelectedDate { get; set; }

member this.SelectedDate : Nullable<DateTime> with get, set

Public Property SelectedDate As Nullable(Of DateTime)

Property Value

Nullable<DateTime>

The date currently selected. The default is null.

Exceptions

ArgumentOutOfRangeException

The specified date is not in the range defined by DisplayDateStart and DisplayDateEnd, or the specified date is in the BlackoutDates collection.

Examples

The following example creates a DatePicker that has the date August 10, 2009 selected. The example also binds the DatePicker.Text property to a TextBlock.

<StackPanel>
  <DatePicker Name="datePicker"
              SelectedDate="8/10/09"
              SelectedDateFormat="Long"/>

  <TextBlock Text="{Binding ElementName=datePicker, Path=Text}"/>
</StackPanel>

Remarks

This property affects the Calendar of the DatePicker. For more information, see the Calendar.SelectedDate property.

Dependency Property Information

Item	Value
Identifier field	SelectedDateProperty
Metadata properties set to `true`	BindsTwoWayByDefault

XAML Attribute Usage

<DatePicker SelectedDate="dateTimeString"/>

XAML Values

dateTimeString A date that is in one of the formats that are listed in the DateTime XAML Syntax topic.

Applies to

Jaa