DatePicker.Text 属性

定义

获取由 DatePicker 显示的文本,或设置选定日期。

C#
public string Text { get; set; }

属性值

DatePicker 显示的文本。 默认值为一个空字符串。

示例

以下示例创建一个 DatePicker ,该日期已选择 2009 年 8 月 10 日。 该示例还将 DatePicker.Text 属性绑定到 TextBlock。 由于 属性 SelectedDateFormat 设置为 LongDatePicker 因此, 和 TextBlock 使用星期和月份名称的无缩进日期显示日期,即使用户输入日期的简短形式也是如此。

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

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

注解

用户可以通过在其文本框中键入日期来设置 SelectedDateDatePicker 。 尝试 DatePicker 将此属性中输入的任何字符串分析为日期。 虽然 属性 Text 可以设置为可按 Parse 方法日期分析的任何字符串,但返回的字符串的格式取决于 属性的值 CultureInfo.CurrentCulture 。 这意味着 显示的 DatePicker 字符串可能与用户键入的内容不同。

如果 Text 设置为可选且有效的日期,则会发生该 DateValidationError 事件。 如果处理 事件并将 DateValidationError 属性设置为 ThrowExceptiontrueFormatException 则会引发 或 ArgumentOutOfRangeException

依赖项属性信息

标识符字段 TextProperty
元数据属性设置为 true

XAML 属性用法

<DatePicker Text="dateTimeString"/>  

XAML 值

dateTimeString
采用 DateTime XAML 语法 主题中列出的格式之一的日期。

适用于

产品 版本
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

另请参阅