updateCharacterStream-Methode (int, java.io.Reader, int)

Artikel
06/02/2023

Aktualisiert die angegebene Spalte mit einem Zeichendatenstromwert mit der angegebenen Anzahl von Zeichen.

Syntax

  
public void updateCharacterStream(int columnIndex,  
                                  java.io.Reader readerValue,  
                                  int length)

Parameter

columnIndex

Ein ganzzahliger Wert, der den Spaltenindex angibt.

readerValue

Ein Reader-Objekt

length

Ein ganzzahliger Wert, der die Länge des Streams angibt.

Ausnahmen

SQLServerException

Bemerkungen

Diese updateCharacterStream-Methode wird von der updateCharacterStream-Methode in der java.sql.ResultSet-Schnittstelle angegeben.

Von dieser Methode werden Unicode-Zeichen aus einem Reader-Objekt an ausgewählte Text- und Binärspalten übergeben. Hierzu zählen alle Textspalten sowie Spalten vom Typ binary, varbinary, varbinary(max) , image und xml, jedoch keine udt-Spalten.

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 updateCharacterStream (int, java.io.Reader), wenn die Anwendung versucht, die Spalte aus einem Stream mit unbekannter Länge zu aktualisieren.

Weitere Informationen

updateCharacterStream-Methode (SQLServerResultSet)
SQLServerResultSet-Elemente
SQLServerResultSet-Klasse

Teilen über