getItemValueString (Document - Java™)

文字列値を 1 つだけ持つアイテムの値を返します。

定義位置

Document

構文

public String getItemValueString(String name)
    throws NotesException

パラメータ

String name

アイテムの名前です。

戻り値

String

アイテムの値です。

使用法

複数のアイテムが同じ名前を持つ場合は、このメソッドは最初のアイテムの値を返します。

アイテムに値がない場合、または値が数値か日時である場合、Domino Designer 6.5 以前のリリースでは NULL が返され、Domino Designer 6.55 以降のリリースでは空の Java 文字列が返されます。空の Java 文字列をテストするには、長さのプロパティを使用します。

指定した名前のアイテムが存在しない場合、Domino Designer 6.5 以前のリリースでは NULL が返され、Domino Designer 6.55 以降のリリースでは空の Java 文字列が返されます。例外はスローされません。アイテムの存在を確認するには hasItem を使用します。

このメソッドは、プレーンテキストにレンダリングされたリッチテキストアイテムを返します。書式や埋め込みオブジェクトは失われます。

アイテムが複数の値を保持している場合、このメソッドは最初の値を返します。