Storage.CreateNewObject method

The CreateNewObject method creates and initializes a WPDObject to the specified data format.

Syntax

retVal = Storage.CreateNewObject(
  Format
)

Parameters

Format

A string that is the data format of the new WPDObject.

Return value

Returns a Creation Container object that is used to set properties and data. When the Creation Container is passed to the Storage.AddChild method, a new WPDObject containing the properties and data of the specified data format will be added as the child of a Storage object.

Examples

The following JScript example uses the CreateNewObject method to add a newly created storage object (a "VCard2" formatted contact) as a child of another storage object. In this example, contact is the Creation Container that is used to set the properties ContactDisplayName, and ContactMobilePhone. When contact is added as a child of the storage object, it becomes a new WPDObject object that represents a contact on the device, and the property values are persisted.

// Create a new storage object of the "Vcard2" format.
var contact = storage.CreateNewObject("Vcard2");
contact.ContactDisplayName = "Bob";
contact.ContactMobilePhone = "(206)555-1234";

// Add the new contact as a child of the storage object.
// Note that the new object will not be persisted until
// it is added by using this method.
storage.AddChild(contact);

Requirements

See also

Storage Object

WPDObject