SelectedDatesCollection-Klasse

Artikel
08/20/2007

Kapselt eine Auflistung von System.DateTime-Objekten, die die ausgewählten Datumsangaben in einem Calendar-Steuerelement darstellen. Diese Klasse kann nicht vererbt werden.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public NotInheritable Class SelectedDatesCollection
    Implements ICollection, IEnumerable
'Usage
Dim instance As SelectedDatesCollection

public sealed class SelectedDatesCollection : ICollection, IEnumerable

public ref class SelectedDatesCollection sealed : ICollection, IEnumerable

public final class SelectedDatesCollection implements ICollection, IEnumerable

public final class SelectedDatesCollection implements ICollection, IEnumerable

Hinweise

Diese Klasse ermöglicht das programmgesteuerte Verwalten einer Auflistung von System.DateTime-Objekten, die die ausgewählten Datumsangaben in einem Calendar-Steuerelement darstellen. Mit dieser Klasse werden in der Regel Datumsangaben der Auflistung hinzugefügt oder aus ihr gelöscht.

Diese Auflistung speichert nur ganze Datumsangaben. In jeder System.DateTime wird der Teil für die Uhrzeit entfernt. Die Datumsangaben werden in aufsteigender Reihenfolge gespeichert. Wenn doppelte Datumsangaben vorliegen, wird nur eine Datumsangabe in der Auflistung gespeichert.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie durch programmgesteuerte Verwendung der SelectedDatesCollection-Klasse Datumsangaben im Calendar-Steuerelement ausgewählt werden.

<%@ Page Language="VB"%>
 
<script runat="server">
 
  Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
 
    DisplayCalendar.VisibleDate = DisplayCalendar.TodaysDate
    
  End Sub

  Sub SelectButton_Click(ByVal sender As Object, ByVal e As EventArgs)

    Dim current_day As Integer = DisplayCalendar.VisibleDate.Day
    Dim current_month As Integer = DisplayCalendar.VisibleDate.Month
    Dim current_year As Integer = DisplayCalendar.VisibleDate.Year

    DisplayCalendar.SelectedDates.Clear()
   
    ' Iterate through the current month and add all Wednesdays to the 
    ' SelectedDates collection of the Calendar control.
    Dim i As Integer
    For i = 1 To System.DateTime.DaysInMonth(current_year, current_month)
    
      Dim currentDate As New DateTime(current_year, current_month, i)
      If currentDate.DayOfWeek = DayOfWeek.Wednesday Then
       
        DisplayCalendar.SelectedDates.Add(currentDate)
        
      End If
      
    Next

    MessageLabel.Text = "Selection Count = " + DisplayCalendar.SelectedDates.Count.ToString()
 
  End Sub

  Sub DisplayCalendar_SelectionChanged(ByVal sender As Object, ByVal e As EventArgs)
  
    MessageLabel.Text = "Selection Count = " & DisplayCalendar.SelectedDates.Count.ToString()
  
  End Sub
 
</script> 
 
<html>
  <body>
    <form runat="server">
 
      <asp:calendar id="DisplayCalendar" runat="server"  
        selectionmode="DayWeekMonth" 
        onselectionchanged="DisplayCalendar_SelectionChanged" />
 
      <hr>
 
      <asp:button id="SelectButton"
        text="Select All Weds in Month" 
        onclick="SelectButton_Click"  
        runat=server/> 
        
      <br/>
 
      <asp:label id="MessageLabel" 
        runat=server />
 
    </form>
  </body>
</html>

<%@ Page Language="C#"%>
 
<script runat="server">
 
  void Page_Load(Object sender, EventArgs e) 
  {
    DisplayCalendar.VisibleDate = DisplayCalendar.TodaysDate;
  }

  void SelectButton_Click(Object sender, EventArgs e) 
  {

    int current_day = DisplayCalendar.VisibleDate.Day;
    int current_month = DisplayCalendar.VisibleDate.Month;
    int current_year = DisplayCalendar.VisibleDate.Year;

    DisplayCalendar.SelectedDates.Clear();
   
    // Iterate through the current month and add all Wednesdays to the 
    // SelectedDates collection of the Calendar control.
    for (int i = 1; i <= System.DateTime.DaysInMonth(current_year, current_month); i++)
    {
       DateTime currentDate = new DateTime(current_year, current_month, i);
       if (currentDate.DayOfWeek == DayOfWeek.Wednesday)
       {
         DisplayCalendar.SelectedDates.Add(currentDate);
       }
    }

     MessageLabel.Text = "Selection Count = " + DisplayCalendar.SelectedDates.Count.ToString();
 
  }

  void DisplayCalendar_SelectionChanged(Object sender, EventArgs e) 
  {
    MessageLabel.Text = "Selection Count = " + DisplayCalendar.SelectedDates.Count.ToString();
  }
 
</script> 
 
<html>
  <body>
    <form runat="server">
 
      <asp:calendar id="DisplayCalendar" runat="server"  
        selectionmode="DayWeekMonth" 
        onselectionchanged="DisplayCalendar_SelectionChanged" />
 
      <hr>
 
      <asp:button id="SelectButton"
        text="Select All Weds in Month" 
        onclick="SelectButton_Click"  
        runat=server/> 
        
      <br/>
 
      <asp:label id="MessageLabel" 
        runat=server />
 
    </form>
  </body>
</html>

Vererbungshierarchie

System.Object
System.Web.UI.WebControls.SelectedDatesCollection

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

SelectedDatesCollection-Member
System.Web.UI.WebControls-Namespace
Calendar-Klasse
Calendar.SelectedDates-Eigenschaft
System.DateTime

Freigeben über