Creates a new item in a document and optionally sets the item value.
Note In general, replaceItemValue is favored over appendItemValue. If an item of the same name already exists in a document, appendItemValue creates a second item of the same name, and the duplicate items are not accessible except through a work-around. If you are creating a new document, appendItemValue is safe.
Defined in
Document
Syntax
public Item appendItemValue(String name) throws NotesException
public Item appendItemValue(String name, int value) throws NotesException
public Item appendItemValue(String name, double value) throws NotesException
public Item appendItemValue(String name, Object value) throws NotesException
Parameters
String name
Item
To keep the new item, you call save after calling appendItemValue.
If the document already has an item called name, appendItemValue does not replace it. Instead, it creates another item of the same name and gives it the value you specify.
Language cross-reference
AppendItemValue method in LotusScript NotesDocument class
Example See Also