Edit

Share via

setCharacterStream Method (java.lang.String, java.io.Reader, int)

  • Article

Download JDBC driver

Sets the designated parameter to the specifiedReader object, which is the specifiednumber of characters long.

Syntax

  
public final void setCharacterStream(java.lang.String parameterName,  
                              java.io.Reader value,  
                              int length)

Parameters

parameterName

A String that contains the name of the parameter.

value

A Reader object that contains the Unicode data.

length

An int that indicates the length in number of characters.

Exceptions

SQLServerException

Remarks

This setCharacterStream method is specified by the setCharacterStream method in the java.sql.CallableStatement interface.

If the length of the stream is different than that specified in the length parameter, the JDBC driver throws an exception when the row is updated or inserted.

If the length of the stream is unknown, the length parameter may be set to -1 to indicate that the driver should accept the stream regardless of its length. With sqljdbc4.jar, we recommend that you use the JDBC 4.0 method setCharacterStream Method (java.lang.String, java.io.Reader) when the application wants to update the column from a stream whose length is unknown.

See Also

SQLServerCallableStatement Members
SQLServerCallableStatement Class