8.6.7 findColumn(String columnName)
- 〈この項の構成〉
(1) 機能
指定した列名の列番号を返します。
(2) 形式
public synchronized int findColumn(String columnName) throws SQLException
(3) 引数
- String columnName:
-
列名を指定します。この列名に対応する列番号が返却されます。
列名指定時の注意事項を次に示します。
-
大文字と小文字を区別しません。
-
指定した文字列すべてを列名として扱うため,文字列に二重引用符(")が含まれている場合,二重引用符(")も列名の一部として扱われます。
-
指定した列名が複数ある場合,列番号が小さい列が優先されます。
-
(4) 戻り値
指定した列名に対応する列番号が返却されます。
(5) 発生する例外
次に示す場合にSQLExceptionが投入されます。
-
このResultSetオブジェクトがクローズされている場合
このResultSetオブジェクトを生成したStatementオブジェクトがクローズされたことによって,ResultSetオブジェクトがクローズされた場合も含みます。
-
このResultSetオブジェクトを生成したStatementオブジェクトを作成したConnectionがクローズされている場合
-
トランザクションの決着によってResultSetオブジェクトが無効になった場合
-
指定した列がない場合
-
columnNameにnullを指定するか,または長さ0の文字列を指定した場合