다음을 통해 공유


AppointmentCalendar.FindAppointmentsAsync 메서드

정의

오버로드

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 값과 정확히 동일한 StartTime이 있는 디바이스에 약속이 있더라도 반환된 목록은 비어 있습니다.

반환

성공적으로 완료되면 Appointment 개체의 IVectorView 목록을 반환하는 비동기 작업입니다.

특성

Windows 요구 사항

앱 기능
appointmentsSystem

추가 정보

적용 대상

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 값과 정확히 동일한 StartTime이 있는 디바이스에 약속이 있더라도 반환된 목록은 비어 있습니다.

options
FindAppointmentsOptions

이 작업에 대한 추가 옵션을 지정하는 데 사용되는 FindAppointmentsOptions 개체입니다. 검색할 값을 지정하려면 options 매개 변수를 설정해야 합니다.

반환

성공적으로 완료되면 Appointment 개체의 IVectorView 목록을 반환하는 비동기 작업입니다.

특성

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 멤버에 값을 추가합니다.

추가 정보

적용 대상