This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

DatePicker.BlackoutDates الخاصية

Visual Studio 2010

الحصول أو تعيين مجموعة من التواريخ التي تم وضع علامة كـ غير قابل للتحديد.

مساحة الاسم:  System.Windows.Controls
التجميع:  PresentationFramework (في PresentationFramework.dll)
XMLNS لـ XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation

public CalendarBlackoutDatesCollection BlackoutDates { get; }
<object>
  <object.BlackoutDates>
    oneOrMoreCalendarDateRanges
  </object.BlackoutDates>
</object>

قيم XAML

oneOrMoreCalendarDateRanges

عنصر كائن واحد أو المزيد نوع CalendarDateRange.

قيمة الخاصية

النوع: System.Windows.Controls.CalendarBlackoutDatesCollection
مجموعة من التواريخ التي لا يمكن أن يكون محدد. القيمة افتراضية هو مجموعة فارغ.

تظهر التواريخ في هذه المجموعة كـ معطلة تشغيل المنسدلة-لأسفل تقويم. إذا قام مستخدم بكتابة تاريخ الذي هو غير قابل للتحديد، DateValidationErrorحدث.

إلى جعل الجميع بعد التواريخ غير قابل للتحديد، يمكنك استخدام AddDatesInPastأسلوب الموفر من قبل المجموعة التي تم إرجاعها بواسطة هذه خاصية.

إضافة تاريخ لترتيب هو مجموعة عند هو محددة بالفعل أو إضافة تاريخ خارج النطاق المحدد بواسطة DisplayDateStartو DisplayDateEndسيؤدي ArgumentOutOfRangeException.

يقوم المثال التالي بإنشاء DatePickerالذي يعرض التواريخ في أغسطس 2009 وتحديد أن كل السبت والأحد غير قابل للتحديد.


DatePicker datePickerWithBlackoutDates = new DatePicker();

datePickerWithBlackoutDates.DisplayDateStart = new DateTime(2009, 8, 1);
datePickerWithBlackoutDates.DisplayDateEnd = new DateTime(2009, 8, 31);
datePickerWithBlackoutDates.SelectedDate = new DateTime(2009, 8, 10);

datePickerWithBlackoutDates.BlackoutDates.Add(
    new CalendarDateRange(new DateTime(2009, 8, 1), new DateTime(2009, 8, 2)));
datePickerWithBlackoutDates.BlackoutDates.Add(
    new CalendarDateRange(new DateTime(2009, 8, 8), new DateTime(2009, 8, 9)));
datePickerWithBlackoutDates.BlackoutDates.Add(
    new CalendarDateRange(new DateTime(2009, 8, 15), new DateTime(2009, 8, 16)));
datePickerWithBlackoutDates.BlackoutDates.Add(
    new CalendarDateRange(new DateTime(2009, 8, 22), new DateTime(2009, 8, 23)));
datePickerWithBlackoutDates.BlackoutDates.Add(
    new CalendarDateRange(new DateTime(2009, 8, 29), new DateTime(2009, 8, 30)));

datePickerWithBlackoutDates.DateValidationError +=
    new EventHandler<DatePickerDateValidationErrorEventArgs>(DatePicker_DateValidationError);

// root is a Panel that is defined elsewhere.
root.Children.Add(datePickerWithBlackoutDates);



<DatePicker Name="datePickerWithBlackoutDates"
            DisplayDateStart="8/1/09"
            DisplayDateEnd="8/31/09"
            SelectedDate="8/10/09"
            DateValidationError="DatePicker_DateValidationError">
  <DatePicker.BlackoutDates>
    <CalendarDateRange Start="8/1/09" End="8/2/09"/>
    <CalendarDateRange Start="8/8/09" End="8/9/09"/>
    <CalendarDateRange Start="8/15/09" End="8/16/09"/>
    <CalendarDateRange Start="8/22/09" End="8/23/09"/>
    <CalendarDateRange Start="8/29/09" End="8/30/09"/>
  </DatePicker.BlackoutDates>
</DatePicker>


DatePicker المقابض DateValidationErrorحدث، كما هو موضح فيما يلي تعليمات برمجية. إذا قام مستخدم بإدخال تاريخ الذي هو غير قابل للتحديد، dهوplays المثال إحدى الرسائل. إذا قام مستخدم بإدخال نص الذي هو ليس تاريخاً صحيحاً، باستثناء هو طرح.


// If the text is a valid date, but a part of the 
// BlackoutDates collection, show a message.
// If the text is not a valid date, thow an exception.
private void DatePicker_DateValidationError(object sender,
                DatePickerDateValidationErrorEventArgs e)
{
    DateTime newDate;
    DatePicker datePickerObj = sender as DatePicker;

    if (DateTime.TryParse(e.Text, out newDate))
    {
        if (datePickerObj.BlackoutDates.Contains(newDate))
        {
            MessageBox.Show(String.Format("The date, {0}, cannot be selected.",
                                           e.Text));
        }
    }
    else
    {
        e.ThrowException = true;
    }
}


المثال السابق ينتج مخرج مشابه للرسم التوضيحي التالي.

منتقي التاريخ به تواريخ غير قابلة للتحديد

منتقي التاريخ به تواريخ غير قابلة للتحديد

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008, نظام التشغيل Windows Server 2003

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4

NET Framework. Client Profile

مدعوم في: 4
إظهار: