updateCharacterStream-Methode (java.lang.String, 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(java.lang.String columnLabel,  
                                  java.io.Reader reader,  
                                  long length)

Parameter

columnLabel

Eine Zeichenfolge, die die Spaltenbezeichnung enthält.

reader

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 (java.lang.String, java.io.Reader), wenn die Anwendung die Spalte aus einem Stream mit unbekannter Länge aktualisieren möchte.

Weitere Informationen

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

Teilen über