CreateObject Method

Creates a specified object and returns a reference to it.

XAML
Cannot use methods in XAML.
Scripting
retval = silverlightObject.CreateObject(objectType)

Parameters

objectType

string

The type of object to create.

Return Value

object

An object reference if the object was successfully created; otherwise, null.

Remarks

The Downloader object is the only object that can be specified by name as the objectType parameter for the CreateObject method. If you specify an invalid objectType parameter, the CreateObject method throws an exception.

Examples

The following JavaScript example shows how to invoke the CreateObject method and create a Downloader:

JavaScript
// Event handler for initializing and executing a download request.
function onMouseLeftButtonUp(sender, eventArgs)
{
    // Retrieve a reference to the plug-in.
    var slPlugin = sender.getHost();

    // Create a Downloader object.
    var downloader = slPlugin.createObject("downloader");

    // Add DownloadProgressChanged and Completed events.
    downloader.addEventListener("downloadProgressChanged", onDownloadProgressChanged);
    downloader.addEventListener("completed", onCompleted);

    // Initialize the Downloader request.
    // NOTE: downloader APIs disallow file:\\ scheme
    // you must run this sample over localhost: or off a server or the following call will fail

    downloader.open("GET", "promo.png");

    // Execute the Downloader request.
    downloader.send();
}

Applies To

Silverlight Plug-in

See Also

Downloader
CreateFromXaml

Community Additions

Show: