目的
このメソッドは、SQLXMLオブジェクトを閉じ、保持しているリソースを解放します。
構文
void free()
throws SQLException
使用上の注意
SQL XMLオブジェクトは無効になり、このメソッドが呼び出されたときに読み取りや書き込みはできなくなります。
freeの呼び出し後に、free以外のメソッドを呼び出そうとすると、SQLExceptionがスローされます。freeが複数回呼び出されると、freeへの後続の呼び出しがno-opとして扱われます。
例外
XML値を解放しようとしたときにエラーが発生した場合、SQLExceptionをスローします。データベース固有コード"9752 (ERRUDFJAVAXML) <Failed to free XML object>"が返されます。