Freigeben über


AppointmentStore.FindAppointmentsAsync Methode

Definition

Überlädt

FindAppointmentsAsync(DateTime, TimeSpan)

Ruft eine Liste von Terminen im Terminkalender ab, die innerhalb des angegebenen Datumsbereichs liegen.

FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions)

Ruft eine Liste von Terminen im Terminkalender ab, die innerhalb des angegebenen Datumsbereichs liegen und die vom angegebenen FindAppointmentsOptions-Objekt angegebenen Kriterien erfüllen.

FindAppointmentsAsync(DateTime, TimeSpan)

Ruft eine Liste von Terminen im Terminkalender ab, die innerhalb des angegebenen Datumsbereichs liegen.

public:
 virtual IAsyncOperation<IVectorView<Appointment ^> ^> ^ FindAppointmentsAsync(DateTime rangeStart, TimeSpan rangeLength) = FindAppointmentsAsync;
/// [Windows.Foundation.Metadata.Overload("FindAppointmentsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IVectorView<Appointment>> FindAppointmentsAsync(DateTime const& rangeStart, TimeSpan const& rangeLength);
[Windows.Foundation.Metadata.Overload("FindAppointmentsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IReadOnlyList<Appointment>> FindAppointmentsAsync(System.DateTimeOffset rangeStart, System.TimeSpan rangeLength);
function findAppointmentsAsync(rangeStart, rangeLength)
Public Function FindAppointmentsAsync (rangeStart As DateTimeOffset, rangeLength As TimeSpan) As IAsyncOperation(Of IReadOnlyList(Of Appointment))

Parameter

rangeStart
DateTime DateTimeOffset

Der Anfang des Datumsbereichs, für den Termine abgerufen werden.

rangeLength
TimeSpan TimeSpan

Die Länge des Datumsbereichs, für den Termine abgerufen werden. Wenn der rangeLength-Parameter auf 0 festgelegt ist, werden keine Termine zurückgegeben. Selbst wenn termine auf dem Gerät vorhanden sind, die über eine StartTime verfügen, die genau mit dem wert rangeStart identisch ist, ist die zurückgegebene Liste leer.

Gibt zurück

Ein asynchroner Vorgang, der nach erfolgreichem Abschluss eine IVectorView-Liste von Appointment-Objekten zurückgibt.

Attribute

Windows-Anforderungen

App-Funktionen
appointmentsSystem

Weitere Informationen

Gilt für:

FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions)

Ruft eine Liste von Terminen im Terminkalender ab, die innerhalb des angegebenen Datumsbereichs liegen und die vom angegebenen FindAppointmentsOptions-Objekt angegebenen Kriterien erfüllen.

public:
 virtual IAsyncOperation<IVectorView<Appointment ^> ^> ^ FindAppointmentsAsync(DateTime rangeStart, TimeSpan rangeLength, FindAppointmentsOptions ^ options) = FindAppointmentsAsync;
/// [Windows.Foundation.Metadata.Overload("FindAppointmentsAsyncWithOptions")]
IAsyncOperation<IVectorView<Appointment>> FindAppointmentsAsync(DateTime const& rangeStart, TimeSpan const& rangeLength, FindAppointmentsOptions const& options);
[Windows.Foundation.Metadata.Overload("FindAppointmentsAsyncWithOptions")]
public IAsyncOperation<IReadOnlyList<Appointment>> FindAppointmentsAsync(System.DateTimeOffset rangeStart, System.TimeSpan rangeLength, FindAppointmentsOptions options);
function findAppointmentsAsync(rangeStart, rangeLength, options)
Public Function FindAppointmentsAsync (rangeStart As DateTimeOffset, rangeLength As TimeSpan, options As FindAppointmentsOptions) As IAsyncOperation(Of IReadOnlyList(Of Appointment))

Parameter

rangeStart
DateTime DateTimeOffset

Der Anfang des Datumsbereichs, für den Termine abgerufen werden.

rangeLength
TimeSpan TimeSpan

Die Länge des Datumsbereichs, für den Termine abgerufen werden. Wenn der rangeLength-Parameter auf 0 festgelegt ist, werden keine Termine zurückgegeben. Selbst wenn termine auf dem Gerät vorhanden sind, die über eine StartTime verfügen, die genau mit dem wert rangeStart identisch ist, ist die zurückgegebene Liste leer.

options
FindAppointmentsOptions

Ein FindAppointmentsOptions-Objekt , das verwendet wird, um weitere Optionen für diesen Vorgang anzugeben. Sie müssen den Optionsparameter festlegen, um die abzurufenden Werte anzugeben.

Gibt zurück

Ein asynchroner Vorgang, der nach erfolgreichem Abschluss eine IVectorView-Liste von Appointment-Objekten zurückgibt.

Attribute

Windows-Anforderungen

App-Funktionen
appointmentsSystem

Beispiele

Legen Sie FindAppointmentOptions.FetchProperties fest, um die abzurufenden Werte anzugeben.

AppointmentStore calendar = await AppointmentManager.RequestStoreAsync(AppointmentStoreAccessType.AllCalendarsReadOnly);

// Specify which values to retrieve
FindAppointmentsOptions options = new FindAppointmentsOptions(); 
options.FetchProperties.Add(AppointmentProperties.Subject); 
options.FetchProperties.Add(AppointmentProperties.Details); 
options.FetchProperties.Add(AppointmentProperties.DetailsKind);

var iteratingAppointments = await calendar.FindAppointmentsAsync(DateTimeOffset.Now, TimeSpan.FromDays(31), options);

foreach (var i in iteratingAppointments) 
{ 
  // do stuff with each appointment 
}

Hinweise

Wichtig

Aus Leistungsgründen lädt FindAppointmentsAsync die meisten Eigenschaften nicht. Um bestimmte Eigenschaften zu laden, fügen Sie dem FindAppointmentsOptions.FetchProperties-Member im options-Parameter Werte hinzu. Weitere Informationen finden Sie im folgenden Beispiel.

Weitere Informationen

Gilt für: