8.4.14 setBinaryStream(int parameterIndex, InputStream x, int length)
- Organization of this subsection
(1) Function
Sets the value of a specified InputStream object as a dynamic parameter value.
(2) Format
public synchronized void setBinaryStream(int parameterIndex, InputStream x, int length) throws SQLException
(3) Arguments
- int parameterIndex
-
Specifies the number of a dynamic parameter.
- InputStream x
-
Specifies the java.io.InputStream object that contains the value to be set in the specified dynamic parameter.
- int length
-
Specifies the number of bytes to be set.
(4) Return value
None.
(5) Exceptions
The JDBC driver throws an SQLException in the following cases:
-
The PreparedStatement object is closed.
-
The Connection object that created this PreparedStatement object is closed.
-
A value less than 0 was specified for length.
-
A nonexistent dynamic parameter number was specified.
-
This method does not support the HADB data type specified in the dynamic parameter.
-
The specified value is outside the range of data types for the column or in a format that cannot be converted.
(6) Notes
The setBinaryStream method does not execute the close method on x, even after input from x has been completed.