AppointmentCalendar.FindAppointmentsAsync Метод

Определение

Пространство имен:

Windows.ApplicationModel.Appointments

Перегрузки

FindAppointmentsAsync(DateTime, TimeSpan)	Асинхронно извлекает список встреч, относящихся к текущему AppointmentCalendar , которые соответствуют заданным критериям.
FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions)	Асинхронно извлекает список встреч, относящихся к текущему AppointmentCalendar , которые соответствуют заданным критериям.

FindAppointmentsAsync(DateTime, TimeSpan)

Асинхронно извлекает список встреч, относящихся к текущему AppointmentCalendar , которые соответствуют заданным критериям.

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))

Параметры

rangeStart

DateTime DateTimeOffset

Время начала временного окна, для которого извлекаются встречи.

rangeLength

TimeSpan TimeSpan

Продолжительность периода времени, в течение которого извлекаются встречи. Если параметр rangeLength имеет значение 0, встречи не возвращаются. Даже если на устройстве существуют встречи, у которых время начала совпадает со значением rangeStart , возвращенный список будет пустым.

Возвращаемое значение

IAsyncOperation<IVectorView<Appointment>>

IAsyncOperation<IReadOnlyList<Appointment>>

Асинхронная операция, которая возвращает список объектов AppointmentIVectorView после успешного завершения.

Атрибуты

OverloadAttribute RemoteAsyncAttribute

Требования к Windows

Возможности приложения

appointmentsSystem

См. также раздел

• FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions)
• Appointment

FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions)

Асинхронно извлекает список встреч, относящихся к текущему AppointmentCalendar , которые соответствуют заданным критериям.

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))

Параметры

rangeStart

DateTime DateTimeOffset

Время начала временного окна, для которого извлекаются встречи.

rangeLength

TimeSpan TimeSpan

Продолжительность периода времени, в течение которого извлекаются встречи. Если параметр rangeLength имеет значение 0, встречи не возвращаются. Даже если на устройстве существуют встречи, у которых время начала совпадает со значением rangeStart , возвращенный список будет пустым.

options

FindAppointmentsOptions

Объект FindAppointmentsOptions , используемый для указания дополнительных параметров для этой операции. Чтобы указать извлекаемые значения, необходимо задать параметр options .

Возвращаемое значение

IAsyncOperation<IVectorView<Appointment>>

IAsyncOperation<IReadOnlyList<Appointment>>

Асинхронная операция, которая возвращает список объектов AppointmentIVectorView после успешного завершения.

Атрибуты

OverloadAttribute

Требования к Windows

Возможности приложения

appointmentsSystem

Примеры

Задайте FindAppointmentOptions.FetchProperties , чтобы указать извлекаемые значения.

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 
}

Комментарии

Важно!

По соображениям производительности FindAppointmentsAsync не загружает большинство свойств. Чтобы загрузить определенные свойства, добавьте значения в элемент FindAppointmentsOptions.FetchProperties в параметре options .

См. также раздел

• FindAppointmentsAsync(DateTime, TimeSpan)
• Appointment