Creation Container object

The Creation Container object is used to temporarily hold properties and data that must be set during the creation of a new object. It does not represent an actual object on the device.

A Creation Container object is created when the Storage.CreateNewObject method or the Service.CreateNewObject method is called. The properties of the Creation Container are used to set property values and data for the creation of a new WPDObject. However, a new object is not created, and the values and data set in the Creation Container are not persisted until the Creation Container is passed as a parameter to the AddChild method.

This JScript example demonstrates creating a Creation Container, setting the properties and data in the Creation Container, and persisting the properties and data by calling the Service.AddChild method.

var createContainer = serviceObject.CreateNewObject("Mp3");

// Set the value of some service-defined properties.
createContainer.MusicAlbum = "Album Name";
createContainer.MusicArtist = "Artist Name";

// Receive object data from a completed XML HTTP Request and use the
// Data property to assign it to the createContainer.
var stream = xmlHttpRequest.getResponseStream();
createContainer.Data = stream;

// This method creates a new WPDObject (in this case, a Service object)
// using the properties and data in the createContainer, and adds it to
// the parent object.
serviceObject.AddChild(createContainer);

Members

The Creation Container object has these types of members:

• Events
• Properties

Events

The Creation Container object has these events.

Properties

The Creation Container object has these properties.

Requirements

See also

About the Creation Container Object

Service Object

Storage Object

WPD Automation Reference

WPDObject