replaceItemValueCustomDataBytes (Document - Java)

Replaces all items of the specified name with one new item, which is assigned custom data from a byte array. 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



public void replaceItemValueCustomDataBytes(String itemname, String datatypename, byte[] bytearray)
    throws NotesException


String itemname

The name of the item.

String datatypename

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

byte[] bytearray

A byte array that contains the custom data.


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.

Use this method if you intend to get the custom data through a language binding other than Java.

For methods that get custom data, see:

For other methods that write custom data to an item, see: