This documentation is archived and is not being maintained.

DatePicker.SelectedDate Property

Gets or sets the currently selected date.

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

member SelectedDate : Nullable<DateTime> with get, set

<DatePicker SelectedDate="dateTimeString"/>

XAML Values

dateTimeString

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

Property Value

Type: System.Nullable(DateTime)
The date currently selected. The default is a null reference (Nothing in Visual Basic).

ExceptionCondition
ArgumentOutOfRangeException

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

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

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>


.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

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