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，則不會傳回任何約會。 即使約會存在於 StartTime 與 rangeStart 值完全相同的裝置上，傳回的清單也會是空的。

傳回

IAsyncOperation<IVectorView<Appointment>>

IAsyncOperation<IReadOnlyList<Appointment>>

非同步作業，會在成功完成時傳回Appointment物件的IVectorView清單。

屬性

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，則不會傳回任何約會。 即使約會存在於 StartTime 與 rangeStart 值完全相同的裝置上，傳回的清單也會是空的。

options

FindAppointmentsOptions

FindAppointmentsOptions物件，用來指定此作業的更多選項。 您必須設定 options 參數，以指定要擷取的值。

傳回

IAsyncOperation<IVectorView<Appointment>>

IAsyncOperation<IReadOnlyList<Appointment>>

非同步作業，會在成功完成時傳回Appointment物件的IVectorView清單。

屬性

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 不會載入大部分的屬性。 若要載入特定屬性，請將值新增至options參數中的FindAppointmentsOptions.FetchProperties成員。

另請參閱

• FindAppointmentsAsync(DateTime, TimeSpan)
• Appointment