AppointmentCalendar.FindAppointmentsAsync Método

Definição

Namespace:

Windows.ApplicationModel.Appointments

Sobrecargas

FindAppointmentsAsync(DateTime, TimeSpan)	Recupera de forma assíncrona uma lista de compromissos pertencentes ao AppointmentCalendar atual que atendem aos critérios especificados.
FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions)	Recupera de forma assíncrona uma lista de compromissos pertencentes ao AppointmentCalendar atual que atendem aos critérios especificados.

FindAppointmentsAsync(DateTime, TimeSpan)

Recupera de forma assíncrona uma lista de compromissos pertencentes ao AppointmentCalendar atual que atendem aos critérios especificados.

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

A hora de início da janela de tempo para a qual os compromissos são recuperados.

rangeLength

TimeSpan TimeSpan

O comprimento da janela de tempo para a 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 de forma assíncrona uma lista de compromissos pertencentes ao AppointmentCalendar atual que atendem aos critérios especificados.

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

A hora de início da janela de tempo para a qual os compromissos são recuperados.

rangeLength

TimeSpan TimeSpan

O comprimento da janela de tempo para a 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 também

• FindAppointmentsAsync(DateTime, TimeSpan)
• Appointment