updateBinaryStream (int, java.io.InputStream, long) メソッド
指定された列をバイナリ ストリーム値で更新します。バイナリ ストリーム値は、指定されたバイト数を持ちます。
注意
この機能は、Microsoft SQL Server JDBC Driver Version 2.0 から導入されました。
構文
public void updateBinaryStream(int columnIndex,
java.io.InputStream x,
long length)
パラメーター
columnIndex
列インデックスを示す int です。
x
InputStream オブジェクトです。
length
ストリームの長さを示す long です。
例外
解説
updateBinaryStream メソッドは、java.sql.ResultSet インターフェイスの updateBinaryStream メソッドで規定されています。
このメソッドは、InputStream オブジェクトからのバイトを、binary、varbinary、varbinary(max)、image、xml、udt など、選択した SQL Server バイナリ列に渡します。このメソッドでは、文字型の列の更新はサポートされていません。InputStream で文字型の列を更新するには、updateAsciiStream メソッドを使用します。
ストリームの長さが、length パラメーターで指定された長さと異なる場合は、行の更新または挿入時に JDBC ドライバーが例外をスローします。
ストリームの長さが不明である場合、length パラメーターを -1 に設定して、ドライバーが長さに関係なくストリームを受け入れるように指定できます。sqljdbc4.jar を使用する場合、アプリケーションで長さが不明なストリームを使用して列を更新するときには、JDBC 4.0 メソッドの updateBinaryStream (int, java.io.InputStream) メソッドを使用することをお勧めします。
参照
リファレンス
概念
updateBinaryStream メソッド (ISQLServerResultSet)
ISQLServerResultSet のメンバー