Freigeben über


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

JDBC-Treiber herunterladen

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

Syntax

  
public void updateNCharacterStream(int columnIndex,  
                                    java.io.Reader x,  
                                    long length)  

Parameter

columnIndex

Ein ganzzahliger Wert, der den Spaltenindex angibt.

x

Ein Reader-Objekt

length

Die Länge des Datenstroms.

Ausnahmen

SQLServerException

Bemerkungen

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

Diese Methode übergibt Unicode-Zeichen aus einem Reader-Objekt an ausgewählte nchar-, nvarchar(max) -, ntext- und xml-Spalten. Bei Verwendung dieser Methode für andere Datentypspalten wird eine Ausnahme ausgelöst.

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

Weitere Informationen

updateNCharacterStream-Methode (SQLServerResultSet)
SQLServerResultSet-Elemente
SQLServerResultSet-Klasse