updateNCharacterStream Method (java.lang.String, java.io.Reader, long)

Updates the designated column with a character stream value, which will have the specified number of bytes.

Nota

This feature is introduced starting with the Microsoft SQL Server JDBC Driver version 2.0.

public void updateNCharacterStream(java.lang.String columnLabel,
                                    java.io.Reader reader,
                                    long length)

Parámetros

columnLabel

A String that contains the column label.

reader

A Reader object.

length

The length of the stream.

Excepciones

SQLServerException

Observaciones

This updateNCharacterStream method is specified by the updateNCharacterStream method in the java.sql.ResultSet interface.

This method passes Unicode characters from a Reader object to selected nchar, nvarchar(max), ntext, and xml columns. Using this method on other data type columns will throw an exception.

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 updateNCharacterStream Method (java.lang.String, java.io.Reader) when the application wants to update the column from a stream whose length is unknown.

Vea también

Referencia

SQLServerResultSet Class

Conceptos

updateNCharacterStream Method (SQLServerResultSet)
SQLServerResultSet Methods
SQLServerResultSet Members