AppointmentStore.FindAppointmentsAsync Метод

Определение

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

Windows.ApplicationModel.Appointments

Перегрузки

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

FindAppointmentsAsync(DateTime, TimeSpan)

Извлекает список встреч в календаре встреч, попадающих в указанный диапазон дат.

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)

Извлекает список встреч в календаре встреч, которые входят в указанный диапазон дат и соответствуют критериям, заданным предоставленным объектом FindAppointmentsOptions ..

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