Teilen über


setNCharacterStream-Methode (java.lang.String, java.io.Reader, long)

JDBC-Treiber herunterladen

Legt den angegebenen Parameter auf das angegebene Readerobjekt fest, dessen Länge der angegebenen Zeichenanzahl entspricht.

Syntax

  
public final void setNCharacterStream(java.lang.String parameterName,  
                     java.io.Reader value,  
                     long length)  

Parameter

parameterName

Eine Zeichenfolge zum Angeben des Parameternamens.

value

Ein Reader-Objekt

length

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

Ausnahmen

SQLServerException

Bemerkungen

Diese setNCharacterStream-Methode wird von der setNCharacterStream-Methode in der java.sql.CallableStatement-Schnittstelle angegeben.

Diese Methode sollte für die Datentypen NCHAR, NVARCHAR, NTEXT und XML verwendet werden.

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

Weitere Informationen

setNCharacterStream-Methode (SQLServerCallableStatement)
SQLServerCallableStatement-Elemente