Home >	Contents >	Index >

Expanded TOC   |    Accordion TOC   |    Annotated TOC   |    Index

ICS.RegisterList

Registers an IList by name with Content Server.

Syntax

public boolean 
RegisterList(String listname,
             IList ilist)

Parameters

listname

The name that ContentServer will use to refer to this list.

IList

The IList to be registered.

Description

The RegisterList method registers an IList by name with Content Server. The registration of the IList persists only for the duration of the current page evaluation. The registered name of the IList is not persistent across page requests. Once registered, the IList can be referenced from an XML tag or by using the GetList() method.

If the supplied name is in use in the current scope, this list will replace the existing list object. If the value of the IList parameter is null, the specified list will be unregistered.

Note that any IList created by Content Server is already registered. This method is primarily used to register instances of new IList types implemented by the user. If Content Server is to manipulate these lists created by new implementations of the interface, the name of the list must be registered with Content Server first.

Returns

Boolean value indicating the list item was added. An error will be returned if the added list is empty (no rows) or invalid (no columns).

Errno

Use GetErrno () to view the error number.

Example

The following example registers an IList with Content Server:

String idVal = "10";  
ics.SetVar("id", idVal);
StringBuffer bf = new StringBuffer();
IList ads = ics.SelectTo("NewPortalImage",
                         "urlpicture,href,alttext", "id", null, 
                         1, "imagelist", true, bf);
ics.ClearErrno();
ics.RegisterList("image", ads);
int listErr = ics.GetErrno();

See Also

CopyList , GetList , RenameList

 

		Home >	Contents >	Index >
	FatWire JAVA Reference Copyright 2005 by FatWire Software All rights reserved.