AppointmentStore.FindAppointmentsAsync Método

Definición

Espacio de nombres:

Windows.ApplicationModel.Appointments

Sobrecargas

FindAppointmentsAsync(DateTime, TimeSpan)	Recupera una lista de citas en el calendario de citas que se encuentran dentro del intervalo de fechas especificado.
FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions)	Recupera una lista de citas en el calendario de citas que se encuentran dentro del intervalo de fechas especificado y cumple los criterios especificados por el objeto FindAppointmentsOptions proporcionado.

FindAppointmentsAsync(DateTime, TimeSpan)

Recupera una lista de citas en el calendario de citas que se encuentran dentro del intervalo de fechas 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

Inicio del intervalo de fechas para el que se recuperan las citas.

rangeLength

TimeSpan TimeSpan

Longitud del intervalo de fechas para el que se recuperan las citas. Si el parámetro rangeLength se establece en 0, no se devolverá ninguna cita. Incluso si existen citas en el dispositivo que tienen un Valor StartTime que es exactamente el mismo que el valor rangeStart , la lista devuelta estará vacía.

Devoluciones

IAsyncOperation<IVectorView<Appointment>>

IAsyncOperation<IReadOnlyList<Appointment>>

Una operación asincrónica que devuelve una lista IVectorView de objetos Appointment tras la finalización correcta.

Atributos

OverloadAttribute RemoteAsyncAttribute

Requisitos de Windows

Características de aplicaciones

appointmentsSystem

Consulte también

• FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions)
• Appointment

FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions)

Recupera una lista de citas en el calendario de citas que se encuentran dentro del intervalo de fechas especificado y cumple los criterios especificados por el objeto FindAppointmentsOptions proporcionado.

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

Inicio del intervalo de fechas para el que se recuperan las citas.

rangeLength

TimeSpan TimeSpan

Longitud del intervalo de fechas para el que se recuperan las citas. Si el parámetro rangeLength se establece en 0, no se devolverá ninguna cita. Incluso si existen citas en el dispositivo que tienen un Valor StartTime que es exactamente el mismo que el valor rangeStart , la lista devuelta estará vacía.

options

FindAppointmentsOptions

Objeto FindAppointmentsOptions que se usa para especificar más opciones para esta operación. Debe establecer el parámetro options para especificar los valores que se van a recuperar.

Devoluciones

IAsyncOperation<IVectorView<Appointment>>

IAsyncOperation<IReadOnlyList<Appointment>>

Una operación asincrónica que devuelve una lista IVectorView de objetos Appointment tras la finalización correcta.

Atributos

OverloadAttribute

Requisitos de Windows

Características de aplicaciones

appointmentsSystem

Ejemplos

Establezca FindAppointmentOptions.FetchProperties para especificar los valores que se van a recuperar.

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 
}

Comentarios

Importante

Por motivos de rendimiento, FindAppointmentsAsync no cargará la mayoría de las propiedades. Para cargar propiedades específicas, agregue valores al miembro FindAppointmentsOptions.FetchProperties en el parámetro options . Consulte el ejemplo siguiente para obtener más información.

Consulte también

• FindAppointmentsAsync(DateTime, TimeSpan)
• Appointment