IClob.SetCharacterStream(Int64) Method

Definition

Retrieves a stream to be used to write a stream of Unicode characters to the CLOB value that this Clob object represents, at position pos.

[Android.Runtime.Register("setCharacterStream", "(J)Ljava/io/Writer;", "GetSetCharacterStream_JHandler:Java.Sql.IClobInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")]
public Java.IO.Writer? SetCharacterStream (long pos);
[<Android.Runtime.Register("setCharacterStream", "(J)Ljava/io/Writer;", "GetSetCharacterStream_JHandler:Java.Sql.IClobInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null")>]
abstract member SetCharacterStream : int64 -> Java.IO.Writer

Parameters

pos
Int64

the position at which to start writing to the CLOB value; The first position is 1

Returns

a stream to which Unicode encoded characters can be written

Attributes

Exceptions

if an error occurs accessing the Clob.

Remarks

Retrieves a stream to be used to write a stream of Unicode characters to the CLOB value that this Clob object represents, at position pos. Characters written to the stream will overwrite the existing characters in the Clob object starting at the position pos. If the end of the Clob value is reached while writing characters to the stream, then the length of the Clob value will be increased to accomodate the extra characters.

<b>Note:</b> If the value specified for pos is greater then the length+1 of the CLOB value then the behavior is undefined. Some JDBC drivers may throw a SQLException while other drivers may support this operation.

Added in 1.4.

Java documentation for java.sql.Clob.setCharacterStream(long).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to