setString(String) - Teradata Database - Teradata Vantage NewSQL Engine

目的

このSQLXMLインスタンスによって指定されるXML値を指定された文字列表現に設定します。

構文規則

void setString(String  value)
                throws SQLException

パラメータ

value

XML値の文字列表現。

文字列の形式はorg.xml.sax.InputSourceによって定義されます。この場合、XML 1.0仕様のセクション2と付録Bに従って、ストリームの文字はXMLのUnicodeコード ポイントを表わします。

Unicode以外のエンコーディング宣言が存在する可能性がありますが、文字列のエンコーディングはUnicodeです。

使用上の注意

ResultSetの指定の列にSQLXMLのjava.sql.Types型がある場合、このメソッドの動作はResultSet.updateString()と同じです。

このメソッドを呼び出すとSQL XMLオブジェクトは書き込み不能になり、実装によっては読み取り不能になる場合もあります。

例外

XML値の処理エラーがある場合、SQLExceptionをスローします。例外のgetCause()メソッドは、ストリームに有効な文字が含まれていない場合など、より詳細な例外を提供できます。

状態が書き込み可能でない場合、例外がスローされます。データベース固有コード"9752 (ERRUDFJAVAXML) <Error processing XML value in setString>"が返されます。