Replaces all items of the specified name with one new item, which is assigned custom data from an object. If the document does not contain an item with the specified name, this method creates a new item and adds it to the document.

Note This method is new with Release 6.

Defined in

Document

Syntax

public void replaceItemValueCustomData(String itemname, Object userobj)
   throws NotesException
   throws java.io.IOException

public void replaceItemValueCustomData(String itemname, String datatypename, Object userobj)
   throws NotesException
   throws java.io.IOException

Parameters

String itemname

The name of the item.

An object that contains the custom data. The class that defines this object must implement Serializable. If desired, you can override readObject and writeObject.

A name for the data type. When getting custom data, use this name for verification.

The new item replaces all previous items with the same name.

To keep the changes, you must call save after calling replaceItemValueCustomData.

The custom data cannot exceed 64K.

If you intend to get the custom data through a language binding other than Java, use a "Bytes" method.

For methods that get custom data, see:

• getItemValueCustomData
• getItemValueCustomDataBytes
• Item.getValueCustomData
• Item.getValueCustomDataBytes

• replaceItemValueCustomDataBytes
• Item.setValueCustomData
• Item.setValueCustomDataBytes

Working with custom data

Glossary