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

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 x,  
                                  long length)

Parameter

columnIndex

Ein ganzzahliger Wert, der den Spaltenindex angibt.

Ein Reader-Objekt

length

Die Länge des Datenstroms.

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", aber 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