setNCharacterStream Method (int, java.io.Reader, long)
Sets the designated parameter to the specified Reader object.
Syntax
public final void setNCharacterStream(int parameterIndex,
java.io.Reader value,
long length)
Parameters
parameterIndex
An int that indicates the parameter index.
value
A Reader object that contains the parameter value.
length
A long that indicates the number of characters in the parameter value.
Exceptions
Remarks
This setNCharacterStream method is specified by the setNCharacterStream method in the java.sql.PreparedStatement interface.
This method should be used for NCHAR, NVARCHAR, NTEXT, and XML data types.
If the length of the stream is different than what is 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 setNCharacterStream Method (int, java.io.Reader) when the application wants to update the column from a stream whose length is unknown.
See Also
setNCharacterStream Method (SQLServerPreparedStatement)
SQLServerPreparedStatement Members