AppointmentStore AppointmentStore AppointmentStore AppointmentStore Class

Definition

Some information relates to pre-released product which may be substantially modified before it’s commercially released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Prerelease APIs are identified by a Prerelease label.

[Contains prerelease APIs.]
Represents a store that contains appointments.

public : sealed class AppointmentStore : IAppointmentStore, IAppointmentStore2public sealed class AppointmentStore : IAppointmentStore, IAppointmentStore2Public NotInheritable Class AppointmentStore Implements IAppointmentStore, IAppointmentStore2// You can use this class in JavaScript.
Attributes
Windows 10 requirements
Device family
Windows 10 (introduced v10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v1)

Properties

ChangeTracker ChangeTracker ChangeTracker ChangeTracker

Returns the AppointmentStoreChangeTracker associated with the appointment store.

public : AppointmentStoreChangeTracker ChangeTracker { get; }public AppointmentStoreChangeTracker ChangeTracker { get; }Public ReadOnly Property ChangeTracker As AppointmentStoreChangeTracker// You can use this property in JavaScript.

Methods

CreateAppointmentCalendarAsync(String) CreateAppointmentCalendarAsync(String) CreateAppointmentCalendarAsync(String) CreateAppointmentCalendarAsync(String)

Asynchronously creates a new AppointmentCalendar within the appointment store using the specified parameters.

public : IAsyncOperation<AppointmentCalendar> CreateAppointmentCalendarAsync(PlatForm::String name)public IAsyncOperation<AppointmentCalendar> CreateAppointmentCalendarAsync(String name)Public Function CreateAppointmentCalendarAsync(name As String) As IAsyncOperation( Of AppointmentCalendar )// You can use this method in JavaScript.
Parameters
name
PlatForm::String String String String

The name for the new AppointmentCalendar.

Returns
See Also

CreateAppointmentCalendarAsync(String, String) CreateAppointmentCalendarAsync(String, String) CreateAppointmentCalendarAsync(String, String) CreateAppointmentCalendarAsync(String, String)

Asynchronously creates a new AppointmentCalendar within the appointment store with the specified name and user data account ID.

public : IAsyncOperation<AppointmentCalendar> CreateAppointmentCalendarAsync(PlatForm::String name, PlatForm::String userDataAccountId)public IAsyncOperation<AppointmentCalendar> CreateAppointmentCalendarAsync(String name, String userDataAccountId)Public Function CreateAppointmentCalendarAsync(name As String, userDataAccountId As String) As IAsyncOperation( Of AppointmentCalendar )// You can use this method in JavaScript.
Parameters
name
PlatForm::String String String String

The name for the new AppointmentCalendar.

userDataAccountId
PlatForm::String String String String

The identifier for the user data account used to create the AppointmentCalendar.

Returns
See Also

FindAppointmentCalendarsAsync() FindAppointmentCalendarsAsync() FindAppointmentCalendarsAsync() FindAppointmentCalendarsAsync()

Retrieves a list of all of the appointment calendars in the appointment store.

public : IAsyncOperation<IVectorView<AppointmentCalendar>> FindAppointmentCalendarsAsync()public IAsyncOperation<IReadOnlyList<AppointmentCalendar>> FindAppointmentCalendarsAsync()Public Function FindAppointmentCalendarsAsync() As IAsyncOperation( Of IReadOnlyListAppointmentCalendar )// You can use this method in JavaScript.
Returns
IAsyncOperation<IVectorView<AppointmentCalendar>> IAsyncOperation<IReadOnlyList<AppointmentCalendar>> IAsyncOperation<IReadOnlyList<AppointmentCalendar>> IAsyncOperation<IReadOnlyList<AppointmentCalendar>>

An asynchronous operation that returns an IVectorView upon successful completion.

See Also

FindAppointmentCalendarsAsync(FindAppointmentCalendarsOptions) FindAppointmentCalendarsAsync(FindAppointmentCalendarsOptions) FindAppointmentCalendarsAsync(FindAppointmentCalendarsOptions) FindAppointmentCalendarsAsync(FindAppointmentCalendarsOptions)

Retrieves a list of appointment calendars in the appointment store that meet the criteria specified by the supplied FindAppointmentCalendarsOptions object..

public : IAsyncOperation<IVectorView<AppointmentCalendar>> FindAppointmentCalendarsAsync(FindAppointmentCalendarsOptions options)public IAsyncOperation<IReadOnlyList<AppointmentCalendar>> FindAppointmentCalendarsAsync(FindAppointmentCalendarsOptions options)Public Function FindAppointmentCalendarsAsync(options As FindAppointmentCalendarsOptions) As IAsyncOperation( Of IReadOnlyListAppointmentCalendar )// You can use this method in JavaScript.
Parameters
options
FindAppointmentCalendarsOptions FindAppointmentCalendarsOptions FindAppointmentCalendarsOptions FindAppointmentCalendarsOptions

The object that specifies the criteria that determines which appointment calendars are returned.

Returns
IAsyncOperation<IVectorView<AppointmentCalendar>> IAsyncOperation<IReadOnlyList<AppointmentCalendar>> IAsyncOperation<IReadOnlyList<AppointmentCalendar>> IAsyncOperation<IReadOnlyList<AppointmentCalendar>>

An asynchronous operation that returns an IVectorView upon successful completion.

See Also

FindAppointmentsAsync(DateTime, TimeSpan) FindAppointmentsAsync(DateTime, TimeSpan) FindAppointmentsAsync(DateTime, TimeSpan) FindAppointmentsAsync(DateTime, TimeSpan)

Retrieves a list of appointments in the appointment calendar that fall within the specified date range.

public : IAsyncOperation<IVectorView<Appointment>> FindAppointmentsAsync(DateTime rangeStart, TimeSpan rangeLength)public IAsyncOperation<IReadOnlyList<Appointment>> FindAppointmentsAsync(DateTimeOffset rangeStart, TimeSpan rangeLength)Public Function FindAppointmentsAsync(rangeStart As DateTimeOffset, rangeLength As TimeSpan) As IAsyncOperation( Of IReadOnlyListAppointment )// You can use this method in JavaScript.
Parameters
rangeStart
DateTime DateTimeOffset DateTimeOffset DateTimeOffset

The start of the date range for which appointments are retrieved.

rangeLength
TimeSpan TimeSpan TimeSpan TimeSpan

The length of the date range for which appointments are retrieved. If the rangeLength parameter is set to 0, no appointments will be returned. Even if appointments exist on the device that have a StartTime that is exactly the same as the rangeStart value, the returned list will be empty.

Returns
IAsyncOperation<IVectorView<Appointment>> IAsyncOperation<IReadOnlyList<Appointment>> IAsyncOperation<IReadOnlyList<Appointment>> IAsyncOperation<IReadOnlyList<Appointment>>

An asynchronous operation that returns an IVectorView list of Appointment objects upon successful completion.

See Also

FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions) FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions) FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions) FindAppointmentsAsync(DateTime, TimeSpan, FindAppointmentsOptions)

Retrieves a list of appointments in the appointment calendar that fall within the specified date range and meet the criteria specified by the supplied FindAppointmentsOptions object..

public : IAsyncOperation<IVectorView<Appointment>> FindAppointmentsAsync(DateTime rangeStart, TimeSpan rangeLength, FindAppointmentsOptions options)public IAsyncOperation<IReadOnlyList<Appointment>> FindAppointmentsAsync(DateTimeOffset rangeStart, TimeSpan rangeLength, FindAppointmentsOptions options)Public Function FindAppointmentsAsync(rangeStart As DateTimeOffset, rangeLength As TimeSpan, options As FindAppointmentsOptions) As IAsyncOperation( Of IReadOnlyListAppointment )// You can use this method in JavaScript.
Parameters
rangeStart
DateTime DateTimeOffset DateTimeOffset DateTimeOffset

The start of the date range for which appointments are retrieved.

rangeLength
TimeSpan TimeSpan TimeSpan TimeSpan

The length of the date range for which appointments are retrieved. If the rangeLength parameter is set to 0, no appointments will be returned. Even if appointments exist on the device that have a StartTime that is exactly the same as the rangeStart value, the returned list will be empty.

options
FindAppointmentsOptions FindAppointmentsOptions FindAppointmentsOptions FindAppointmentsOptions

A FindAppointmentsOptions object that is used to specify more options for this operation. You must set the options parameter to specify the values to retrieve.

Returns
IAsyncOperation<IVectorView<Appointment>> IAsyncOperation<IReadOnlyList<Appointment>> IAsyncOperation<IReadOnlyList<Appointment>> IAsyncOperation<IReadOnlyList<Appointment>>

An asynchronous operation that returns an IVectorView list of Appointment objects upon successful completion.

Examples

Set FindAppointmentOptions.FetchProperties to specify the values to retrieve.

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 
}

Remarks

Important

For performance reasons, FindAppointmentsAsync will not load most properties. To load specific properties, add values to the FindAppointmentsOptions.FetchProperties member in the options parameter. See the example below for more info.

See Also

FindConflictAsync(Appointment) FindConflictAsync(Appointment) FindConflictAsync(Appointment) FindConflictAsync(Appointment)

Returns an AppointmentConflictResult representing a conflict between the specified appointment and an existing appointment in the appointment store.

public : IAsyncOperation<AppointmentConflictResult> FindConflictAsync(Appointment appointment)public IAsyncOperation<AppointmentConflictResult> FindConflictAsync(Appointment appointment)Public Function FindConflictAsync(appointment As Appointment) As IAsyncOperation( Of AppointmentConflictResult )// You can use this method in JavaScript.
Parameters
appointment
Appointment Appointment Appointment Appointment

The appointment for which a conflict is sought.

Returns
See Also

FindConflictAsync(Appointment, DateTime) FindConflictAsync(Appointment, DateTime) FindConflictAsync(Appointment, DateTime) FindConflictAsync(Appointment, DateTime)

Returns an AppointmentConflictResult representing a conflict between the specified appointment and an existing appointment instance in the appointment store.

public : IAsyncOperation<AppointmentConflictResult> FindConflictAsync(Appointment appointment, DateTime instanceStartTime)public IAsyncOperation<AppointmentConflictResult> FindConflictAsync(Appointment appointment, DateTimeOffset instanceStartTime)Public Function FindConflictAsync(appointment As Appointment, instanceStartTime As DateTimeOffset) As IAsyncOperation( Of AppointmentConflictResult )// You can use this method in JavaScript.
Parameters
appointment
Appointment Appointment Appointment Appointment

The appointment for which a conflict is sought.

instanceStartTime
DateTime DateTimeOffset DateTimeOffset DateTimeOffset

The start time of the appointment instance for which a conflict is sought.

Returns
See Also

FindLocalIdsFromRoamingIdAsync(String) FindLocalIdsFromRoamingIdAsync(String) FindLocalIdsFromRoamingIdAsync(String) FindLocalIdsFromRoamingIdAsync(String)

Returns a list of LocalId values for appointment instances with the specified RoamingId value.

public : IAsyncOperation<IVectorView<PlatForm::String>> FindLocalIdsFromRoamingIdAsync(PlatForm::String roamingId)public IAsyncOperation<IReadOnlyList<string>> FindLocalIdsFromRoamingIdAsync(String roamingId)Public Function FindLocalIdsFromRoamingIdAsync(roamingId As String) As IAsyncOperation( Of IReadOnlyListstring )// You can use this method in JavaScript.
Parameters
roamingId
PlatForm::String String String String

The RoamingId value for which local ID values are sought.

Returns
IAsyncOperation<IVectorView<PlatForm::String>> IAsyncOperation<IReadOnlyList<string>> IAsyncOperation<IReadOnlyList<string>> IAsyncOperation<IReadOnlyList<string>>

An asynchronous operation that returns an IVectorView upon successful completion.

GetAppointmentAsync(String) GetAppointmentAsync(String) GetAppointmentAsync(String) GetAppointmentAsync(String)

Retrieves the Appointment with the specified LocalId.

public : IAsyncOperation<Appointment> GetAppointmentAsync(PlatForm::String localId)public IAsyncOperation<Appointment> GetAppointmentAsync(String localId)Public Function GetAppointmentAsync(localId As String) As IAsyncOperation( Of Appointment )// You can use this method in JavaScript.
Parameters
localId
PlatForm::String String String String

The LocalId of the appointment to be retrieved.

Returns

GetAppointmentCalendarAsync(String) GetAppointmentCalendarAsync(String) GetAppointmentCalendarAsync(String) GetAppointmentCalendarAsync(String)

Retrieves the AppointmentCalendar with the specified LocalId.

public : IAsyncOperation<AppointmentCalendar> GetAppointmentCalendarAsync(PlatForm::String calendarId)public IAsyncOperation<AppointmentCalendar> GetAppointmentCalendarAsync(String calendarId)Public Function GetAppointmentCalendarAsync(calendarId As String) As IAsyncOperation( Of AppointmentCalendar )// You can use this method in JavaScript.
Parameters
calendarId
PlatForm::String String String String

The LocalId of the AppointmentCalendar to be retrieved.

Returns

GetAppointmentInstanceAsync(String, DateTime) GetAppointmentInstanceAsync(String, DateTime) GetAppointmentInstanceAsync(String, DateTime) GetAppointmentInstanceAsync(String, DateTime)

Retrieves the instance of the Appointment with the specified LocalId and the specified start time.

public : IAsyncOperation<Appointment> GetAppointmentInstanceAsync(PlatForm::String localId, DateTime instanceStartTime)public IAsyncOperation<Appointment> GetAppointmentInstanceAsync(String localId, DateTimeOffset instanceStartTime)Public Function GetAppointmentInstanceAsync(localId As String, instanceStartTime As DateTimeOffset) As IAsyncOperation( Of Appointment )// You can use this method in JavaScript.
Parameters
localId
PlatForm::String String String String

The LocalId of the appointment instance to be retrieved.

instanceStartTime
DateTime DateTimeOffset DateTimeOffset DateTimeOffset

The start time of the appointment instance to be retrieved. The value of this parameter must be the original start date of the instance.

Returns

GetChangeTracker(String) GetChangeTracker(String) GetChangeTracker(String) GetChangeTracker(String)

Prerelease. Gets a AppointmentStoreChangeTracker that provides functionality for monitoring changes to Appointment objects in the AppointmentStore.

public : AppointmentStoreChangeTracker GetChangeTracker(PlatForm::String identity)public AppointmentStoreChangeTracker GetChangeTracker(String identity)Public Function GetChangeTracker(identity As String) As AppointmentStoreChangeTracker// You can use this method in JavaScript.
Parameters
identity
PlatForm::String String String String

A string that identifies the AppointmentStoreChangeTracker instance in the store.

Returns
Additional features and requirements
Device family
Windows 10 Insider Preview (introduced v10.0.16257.0)
API contract
Windows.Foundation.UniversalApiContract (introduced v5)

Remarks

You can create multiple AppointmentStoreChangeTracker instances by using this method. If you pass in a string that identifies a AppointmentStoreChangeTracker that already exists in the store, this method returns that instance. If the string that you pass into this method does not identify an existing an existing AppointmentStoreChangeTracker, this method returns a new AppointmentStoreChangeTracker.

You can use the IsTracking property of the AppointmentStoreChangeTracker to determine whether change tracking is enabled for the AppointmentStoreChangeTracker.

MoveAppointmentAsync(Appointment, AppointmentCalendar) MoveAppointmentAsync(Appointment, AppointmentCalendar) MoveAppointmentAsync(Appointment, AppointmentCalendar) MoveAppointmentAsync(Appointment, AppointmentCalendar)

Moves the specified Appointment object to the specified AppointmentCalendar.

public : IAsyncAction MoveAppointmentAsync(Appointment appointment, AppointmentCalendar destinationCalendar)public IAsyncAction MoveAppointmentAsync(Appointment appointment, AppointmentCalendar destinationCalendar)Public Function MoveAppointmentAsync(appointment As Appointment, destinationCalendar As AppointmentCalendar) As IAsyncAction// You can use this method in JavaScript.
Parameters
appointment
Appointment Appointment Appointment Appointment

The appointment to be moved.

destinationCalendar
AppointmentCalendar AppointmentCalendar AppointmentCalendar AppointmentCalendar

The appointment calendar to which the appointment is moved.

Returns

ShowAddAppointmentAsync(Appointment, Rect) ShowAddAppointmentAsync(Appointment, Rect) ShowAddAppointmentAsync(Appointment, Rect) ShowAddAppointmentAsync(Appointment, Rect)

Shows the Appointments provider Add Appointment UI, to enable the user to add an appointment.

public : IAsyncOperation<PlatForm::String> ShowAddAppointmentAsync(Appointment appointment, Rect selection)public IAsyncOperation<string> ShowAddAppointmentAsync(Appointment appointment, Rect selection)Public Function ShowAddAppointmentAsync(appointment As Appointment, selection As Rect) As IAsyncOperation( Of string )// You can use this method in JavaScript.
Parameters
appointment
Appointment Appointment Appointment Appointment

The object representing the information for the appointment to add.

selection
Rect Rect Rect Rect

The Rect is the rectangular area of user selection (for example, pressing a button), around which the operating system displays the Add Appointment UI, not within that rectangular area. For example, if an app uses a button to show the Rect, pass the Rect of the button so the Add Appointment UI displays around the button, not overlapping it.

Returns

When this method completes, it returns a String object that represents the RoamingId of the appointment. If the appointment identifier returned is an empty string, the appointment was not added to the Appointments provider app.

Remarks

For Windows Phone Store app, this method behaves the same as ShowEditNewAppointmentAsync, in that the fields in the Add Appointment UI are editable by the user.

ShowAppointmentDetailsAsync(String) ShowAppointmentDetailsAsync(String) ShowAppointmentDetailsAsync(String) ShowAppointmentDetailsAsync(String)

Shows the Appointments provider Appointment Details UI, to enable the user to view the specified appointment.

public : IAsyncAction ShowAppointmentDetailsAsync(PlatForm::String localId)public IAsyncAction ShowAppointmentDetailsAsync(String localId)Public Function ShowAppointmentDetailsAsync(localId As String) As IAsyncAction// You can use this method in JavaScript.
Parameters
localId
PlatForm::String String String String

The LocalId of the appointment to be displayed.

Returns
See Also

ShowAppointmentDetailsAsync(String, DateTime) ShowAppointmentDetailsAsync(String, DateTime) ShowAppointmentDetailsAsync(String, DateTime) ShowAppointmentDetailsAsync(String, DateTime)

Shows the Appointments provider Appointment Details UI, to enable the user to view the specified appointment.

public : IAsyncAction ShowAppointmentDetailsAsync(PlatForm::String localId, DateTime instanceStartDate)public IAsyncAction ShowAppointmentDetailsAsync(String localId, DateTimeOffset instanceStartDate)Public Function ShowAppointmentDetailsAsync(localId As String, instanceStartDate As DateTimeOffset) As IAsyncAction// You can use this method in JavaScript.
Parameters
localId
PlatForm::String String String String

The LocalId of the appointment to be displayed.

instanceStartDate
DateTime DateTimeOffset DateTimeOffset DateTimeOffset

A DateTime object with the start time of the appointment instance to be displayed. This parameter must be the original start date of the instance.

Returns
See Also

ShowEditNewAppointmentAsync(Appointment) ShowEditNewAppointmentAsync(Appointment) ShowEditNewAppointmentAsync(Appointment) ShowEditNewAppointmentAsync(Appointment)

Shows the Appointments provider Add Appointment UI including the full edit experience, to enable the user to add an appointment.

public : IAsyncOperation<PlatForm::String> ShowEditNewAppointmentAsync(Appointment appointment)public IAsyncOperation<string> ShowEditNewAppointmentAsync(Appointment appointment)Public Function ShowEditNewAppointmentAsync(appointment As Appointment) As IAsyncOperation( Of string )// You can use this method in JavaScript.
Parameters
appointment
Appointment Appointment Appointment Appointment

The appointment to be added.

Returns

When this method completes, it returns a String object that represents the RoamingId of the appointment. If the appointment identifier returned is an empty string, the appointment was not added to the Appointments provider app.

ShowRemoveAppointmentAsync(String, Rect) ShowRemoveAppointmentAsync(String, Rect) ShowRemoveAppointmentAsync(String, Rect) ShowRemoveAppointmentAsync(String, Rect)

Shows the Appointments provider Remove Appointment UI, to enable the user to remove an appointment.

public : IAsyncOperation<PlatForm::Boolean> ShowRemoveAppointmentAsync(PlatForm::String localId, Rect selection)public IAsyncOperation<bool> ShowRemoveAppointmentAsync(String localId, Rect selection)Public Function ShowRemoveAppointmentAsync(localId As String, selection As Rect) As IAsyncOperation( Of bool )// You can use this method in JavaScript.
Parameters
localId
PlatForm::String String String String

The LocalId of the appointment to be removed.

selection
Rect Rect Rect Rect

The Rect is the rectangular area of user selection (for example, pressing a button), around which the operating system displays the Remove Appointment UI, not within that rectangular area. For example, if an app uses a button to show the Rect, pass the Rect of the button so the Remove Appointment UI displays around the button, not overlapping it.

Returns

When this method completes, it returns a Boolean value that indicates whether the Appointment provider app removed the appointment.

See Also

ShowRemoveAppointmentAsync(String, Rect, Placement, DateTime) ShowRemoveAppointmentAsync(String, Rect, Placement, DateTime) ShowRemoveAppointmentAsync(String, Rect, Placement, DateTime) ShowRemoveAppointmentAsync(String, Rect, Placement, DateTime)

Shows the Appointments provider Remove Appointment UI, to enable the user to remove an appointment.

public : IAsyncOperation<PlatForm::Boolean> ShowRemoveAppointmentAsync(PlatForm::String localId, Rect selection, Placement preferredPlacement, DateTime instanceStartDate)public IAsyncOperation<bool> ShowRemoveAppointmentAsync(String localId, Rect selection, Placement preferredPlacement, DateTimeOffset instanceStartDate)Public Function ShowRemoveAppointmentAsync(localId As String, selection As Rect, preferredPlacement As Placement, instanceStartDate As DateTimeOffset) As IAsyncOperation( Of bool )// You can use this method in JavaScript.
Parameters
localId
PlatForm::String String String String

The LocalId of the appointment to be removed.

selection
Rect Rect Rect Rect

The Rect is the rectangular area of user selection (for example, pressing a button), around which the operating system displays the Remove Appointment UI, not within that rectangular area. For example, if an app uses a button to show the Rect, pass the Rect of the button so the Remove Appointment UI displays around the button, not overlapping it.

preferredPlacement
Placement Placement Placement Placement

The Placement that describes the preferred placement of the Remove Appointment UI.

instanceStartDate
DateTime DateTimeOffset DateTimeOffset DateTimeOffset

The start date and time of the appointment instance to remove. This parameter must be the original start date of the instance.

Returns

When this method completes, it returns a Boolean value that indicates whether the Appointment provider app removed the appointment.

See Also

ShowReplaceAppointmentAsync(String, Appointment, Rect) ShowReplaceAppointmentAsync(String, Appointment, Rect) ShowReplaceAppointmentAsync(String, Appointment, Rect) ShowReplaceAppointmentAsync(String, Appointment, Rect)

Shows the Appointments provider Replace Appointment UI, to enable the user to replace an appointment.

public : IAsyncOperation<PlatForm::String> ShowReplaceAppointmentAsync(PlatForm::String localId, Appointment appointment, Rect selection)public IAsyncOperation<string> ShowReplaceAppointmentAsync(String localId, Appointment appointment, Rect selection)Public Function ShowReplaceAppointmentAsync(localId As String, appointment As Appointment, selection As Rect) As IAsyncOperation( Of string )// You can use this method in JavaScript.
Parameters
localId
PlatForm::String String String String

The LocalId of the appointment to be replaced.

appointment
Appointment Appointment Appointment Appointment

The object representing the appointment to replace the existing appointment.

selection
Rect Rect Rect Rect

The Rect is the rectangular area of user selection (for example, pressing a button), around which the operating system displays the Replace Appointment UI, not within that rectangular area. For example, if an app uses a button to show the Rect, pass the Rect of the button so the Replace Appointment UI displays around the button, not overlapping it.

Returns

When this method completes, it returns a String object that represents the RoamingId of the appointment that replaced the existing appointment.

See Also

ShowReplaceAppointmentAsync(String, Appointment, Rect, Placement, DateTime) ShowReplaceAppointmentAsync(String, Appointment, Rect, Placement, DateTime) ShowReplaceAppointmentAsync(String, Appointment, Rect, Placement, DateTime) ShowReplaceAppointmentAsync(String, Appointment, Rect, Placement, DateTime)

Shows the Appointments provider Replace Appointment UI, to enable the user to replace an appointment.

public : IAsyncOperation<PlatForm::String> ShowReplaceAppointmentAsync(PlatForm::String localId, Appointment appointment, Rect selection, Placement preferredPlacement, DateTime instanceStartDate)public IAsyncOperation<string> ShowReplaceAppointmentAsync(String localId, Appointment appointment, Rect selection, Placement preferredPlacement, DateTimeOffset instanceStartDate)Public Function ShowReplaceAppointmentAsync(localId As String, appointment As Appointment, selection As Rect, preferredPlacement As Placement, instanceStartDate As DateTimeOffset) As IAsyncOperation( Of string )// You can use this method in JavaScript.
Parameters
localId
PlatForm::String String String String

The LocalId of the appointment to be replaced.

appointment
Appointment Appointment Appointment Appointment

The object representing the appointment to replace the existing appointment.

selection
Rect Rect Rect Rect

The Rect is the rectangular area of user selection (for example, pressing a button), around which the operating system displays the Replace Appointment UI, not within that rectangular area. For example, if an app uses a button to show the Rect, pass the Rect of the button so the Replace Appointment UI displays around the button, not overlapping it.

preferredPlacement
Placement Placement Placement Placement

The Placement that describes the preferred placement of the Replace Appointment UI.

instanceStartDate
DateTime DateTimeOffset DateTimeOffset DateTimeOffset

The start date and time of the appointment instance to replace.

Returns

When this method completes, it returns a String object that represents the RoamingId of the appointment that replaced the existing appointment.

Remarks

The instanceStartTime parameter must be the original start date of the instance.

See Also

Events

StoreChanged StoreChanged StoreChanged StoreChanged

Occurs when the AppointmentStore changes.

public : event TypedEventHandler StoreChanged<AppointmentStore,  AppointmentStoreChangedEventArgs>public event TypedEventHandler StoreChanged<AppointmentStore,  AppointmentStoreChangedEventArgs>Public Event StoreChanged<AppointmentStore,  AppointmentStoreChangedEventArgs>// You can use this event in JavaScript.