Updates the designated column with an ASCII stream value given the column index.

public void updateAsciiStream(int index,
                              java.io.InputStream x,
                              int length)

Parameters

index

An integer that indicates the column index.

x

An InputStream object.

length

An integer that indicates the length of the stream.

Exceptions

SQLServerException

Remarks

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

This method passes ASCII characters (bytes) from an InputStream object to convertible character columns, which are the ASCII range [0x00 – 0x7F] of Unicode, and 874, 932, 936, 949, 950, and 1250 through 1258 code pages. This method performs a conversion to the destination collation page. Trying to update an unconvertible destination column will cause an exception to be thrown. For binary columns, raw bytes are passed.

When the length is set to -1, the stream is allowed, but a specific length is not required. If the InputStream passes a stream of a different length than what is specified, the JDBC driver will stop the update while it tries to preserve the connection and the current transaction.

See Also