AppointmentCalendar.FindAppointmentsAsync Método

Definición

Espacio de nombres:

Windows.ApplicationModel.Appointments

Sobrecargas

FindAppointmentsAsync(DateTime, TimeSpan)	Recupera de forma asincrónica una lista de citas que pertenecen al objeto AppointmentCalendar actual que cumple los criterios especificados.
FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions)	Recupera de forma asincrónica una lista de citas que pertenecen al objeto AppointmentCalendar actual que cumple los criterios especificados.

FindAppointmentsAsync(DateTime, TimeSpan)

Recupera de forma asincrónica una lista de citas que pertenecen al objeto AppointmentCalendar actual que cumple los criterios 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

Hora de inicio del período de tiempo para el que se recuperan las citas.

rangeLength

TimeSpan TimeSpan

La duración del período de tiempo 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 de forma asincrónica una lista de citas que pertenecen al objeto AppointmentCalendar actual que cumple los criterios 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

Hora de inicio del período de tiempo para el que se recuperan las citas.

rangeLength

TimeSpan TimeSpan

La duración del período de tiempo 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 también

• FindAppointmentsAsync(DateTime, TimeSpan)
• Appointment