InsertItem method: Pagelet collection

Syntax

InsertItem(PageletName, Label, NodeName, URL)

Description

The InsertItem method inserts the pagelet object identified by PageletName into the pagelet Collection.

Note:

The portal registry classes execute some methods "interactively", that is, as they happen. The item won't be marked for insertion, then actually inserted later. The item is inserted into the database as soon as the method is executed.

Parameters

Parameter Description

PageletName

Specify the name of a new pagelet. This parameter takes a string value. If you specify a name that already exists in the collection, you receive an error.

Label

Specify the label for the new pagelet. This parameter takes a string value.

NodeName

Specify a node. This parameter takes a string value. If you specify a fully qualified URL, you can specify a Null (that is, two quotation marks with no space between them ("")).

URL

Specify a URL that contains the content. The format of this parameter depends on other properties, such as the type of pagelet, where the data is stored, and so on.

Returns

A reference to the new pagelet object if the method executed successfully, NULL otherwise.

Related Topics