Teilen über


updateBinaryStream-Methode (int, java.io.InputStream, long)

JDBC-Treiber herunterladen

Aktualisiert die angegebene Spalte mit einem Binärdatenstromwert mit der angegebenen Anzahl von Bytes.

Syntax

  
public void updateBinaryStream(int columnIndex,  
                               java.io.InputStream x,  
                               long length)  

Parameter

columnIndex

Ein ganzzahliger Wert, der den Spaltenindex angibt.

x

Ein InputStream-Objekt

length

Ein Wert vom Typ long zum Angeben der Streamlänge.

Ausnahmen

SQLServerException

Bemerkungen

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

Von dieser Methode werden Bytes aus einem InputStream-Objekt an ausgewählte SQL Server-Binärspalten wie „binary“, „varbinary“, „varbinary(max)“, „image“, „xml“ oder „udt“ übergeben. Das Aktualisieren von Zeichenspalten wird für diese Methode nicht unterstützt. Verwenden Sie die updateAsciiStream-Methode, um Zeichenspalten mit InputStream zu aktualisieren.

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 updateBinaryStream-Methode (int, java.io.InputStream) von JDBC 4.0, wenn die Anwendung die Spalte aus einem Stream mit unbekannter Länge aktualisieren soll.

Weitere Informationen

updateBinaryStream-Methode (SQLServerResultSet)
SQLServerResultSet-Elemente
SQLServerResultSet-Klasse