StorageFileQueryResult.ContentsChanged | contentschanged event

Fires when a file is added to, deleted from, or modified in the folder being queried. This event only fires after GetFilesAsync has been called at least once.

Syntax

function onContentsChanged(eventArgs) { /* Your code */ }
 
// addEventListener syntax
storageFileQueryResult.addEventListener("contentschanged", onContentsChanged);
storageFileQueryResult.removeEventListener("contentschanged", onContentsChanged);
 
- or -

storageFileQueryResult.oncontentschanged = onContentsChanged;

Event information

Remarks

If you register a handler for this event, keep that handler registered while you suspend your app (in response to oncheckpoint or Suspending). Your app will not receive ContentsChanged events while it is suspended and when your app resumes it will receive a single event that aggregates all of the changes if any occurred.

Additionally, keep in mind that registering and removing event handlers are synchronous operations and might cause your app to hang briefly if you execute them on your app's UI thread. Wherever possible, use a thread other than your app's UI thread to register and unregister these event handlers.

Windows Phone 8

This API is not implemented and will throw an exception if called.

Requirements

See also

StorageFileQueryResult

Build date: 2/25/2013