setCharacterStream-Methode (int, java.io.Reader, long)

Artikel
06/02/2023

Legt den angegebenen Parameter auf das java.io.Reader-Objekt fest, dessen Länge der angegebenen Zeichenanzahl entspricht.

Syntax

  
public final void setCharacterStream(int parameterIndex,  
                                    java.io.Reader reader,  
                                    long length)

Parameter

parameterIndex

Ein Wert ganzzahliger Wert zum Angeben der Parameternummer.

reader

Das java.io.Reader-Objekt, das die Unicodedaten enthält.

length

Ein Wert vom Typ long zum Angeben der Anzahl von Zeichen im Datenstrom.

Ausnahmen

SQLServerException

Bemerkungen

Diese setCharacterStream-Methode wird von der setCharacterStream-Methode in der java.sql.PreparedStatement-Schnittstelle angegeben.

Entspricht die Länge des Streams nicht der Angabe im length-Parameter, wird vom JDBC-Treiber beim Aktualisieren oder Einfügen der Zeile eine Ausnahme ausgelöst.

Ist die Länge des Streams nicht bekannt, kann der length-Parameter auf „–1“ festgelegt werden, um anzugeben, dass der Stream unabhängig von seiner Länge akzeptiert werden soll. Bei „sqljdbc4.jar“ empfiehlt sich die Verwendung der JDBC 4.0-Methode setCharacterStream-Methode (int, java.io.Reader), wenn von der Anwendung versucht wird, die Spalte aus einem Stream mit unbekannter Länge zu aktualisieren.

Weitere Informationen

setCharacterStream-Methode (SQLServerPreparedStatement)
SQLServerPreparedStatement-Elemente

Teilen über