AddItem Method

Inserts a new item into the beginning of an RSS feed.

Syntax

rss.addItem(title, description, link, [callback])

Callback

The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).

The callback for this method is defined as:

function(err){ }

'err' is the error that occurred. If there was no error, then 'err' is 'null'.

'err' has 2 properties which hold detailed information:

err.code
err.message

Remarks

This method assumes that the items are new and more important than existing items and thus adds the item to the beginning of the current item list. This method requires the three standard fields Title, Description, and Link to be specified.

Example (Add a New Item)

RSSControl.AddItem("New Item Title", "Item Description", "http://www.itemsource.com")
RSSControl.WriteFile(filename)

RSSControl.ItemCount = 1
RSSControl.ItemTitle(0) = "New Item Title"
RSSControl.ItemDescription(0) = "Item Description"
RSSControl.ItemLink(0) = "http://www.itemsource.com"
RSSControl.WriteFile(filename)