AppointmentStore.FindAppointmentsAsync Método

Definição

Namespace:

Windows.ApplicationModel.Appointments

Sobrecargas

FindAppointmentsAsync(DateTime, TimeSpan)	Recupera uma lista de compromissos no calendário de compromissos que se enquadram no intervalo de datas especificado.
FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions)	Recupera uma lista de compromissos no calendário de compromissos que se enquadram no intervalo de datas especificado e atendem aos critérios especificados pelo objeto FindAppointmentsOptions fornecido.

FindAppointmentsAsync(DateTime, TimeSpan)

Recupera uma lista de compromissos no calendário de compromissos que se enquadram no intervalo de datas especificado.

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

Parâmetros

rangeStart

DateTime DateTimeOffset

O início do intervalo de datas para o qual os compromissos são recuperados.

rangeLength

TimeSpan TimeSpan

O comprimento do intervalo de datas para o qual os compromissos são recuperados. Se o parâmetro rangeLength estiver definido como 0, nenhum compromisso será retornado. Mesmo que existam compromissos no dispositivo que têm um StartTime exatamente igual ao valor rangeStart , a lista retornada estará vazia.

Retornos

IAsyncOperation<IVectorView<Appointment>>

IAsyncOperation<IReadOnlyList<Appointment>>

Uma operação assíncrona que retorna uma lista IVectorView de objetos Appointment após a conclusão bem-sucedida.

Atributos

OverloadAttribute RemoteAsyncAttribute

Requisitos do Windows

Funcionalidades do aplicativo

appointmentsSystem

Confira também

• FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions)
• Appointment

FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions)

Recupera uma lista de compromissos no calendário de compromissos que se enquadram no intervalo de datas especificado e atendem aos critérios especificados pelo objeto FindAppointmentsOptions fornecido.

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

Parâmetros

rangeStart

DateTime DateTimeOffset

O início do intervalo de datas para o qual os compromissos são recuperados.

rangeLength

TimeSpan TimeSpan

O comprimento do intervalo de datas para o qual os compromissos são recuperados. Se o parâmetro rangeLength estiver definido como 0, nenhum compromisso será retornado. Mesmo que existam compromissos no dispositivo que têm um StartTime exatamente igual ao valor rangeStart , a lista retornada estará vazia.

options

FindAppointmentsOptions

Um objeto FindAppointmentsOptions usado para especificar mais opções para essa operação. Você deve definir o parâmetro de opções para especificar os valores a serem recuperados.

Retornos

IAsyncOperation<IVectorView<Appointment>>

IAsyncOperation<IReadOnlyList<Appointment>>

Uma operação assíncrona que retorna uma lista IVectorView de objetos Appointment após a conclusão bem-sucedida.

Atributos

OverloadAttribute

Requisitos do Windows

Funcionalidades do aplicativo

appointmentsSystem

Exemplos

Defina FindAppointmentOptions.FetchProperties para especificar os valores a serem recuperados.

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 
}

Comentários

Importante

Por motivos de desempenho, FindAppointmentsAsync não carregará a maioria das propriedades. Para carregar propriedades específicas, adicione valores ao membro FindAppointmentsOptions.FetchProperties no parâmetro options . Confira o exemplo abaixo para obter mais informações.

Confira também

• FindAppointmentsAsync(DateTime, TimeSpan)
• Appointment