Freigeben über


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

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

Hinweis

Diese Funktion wird mit Version 2.0 von Microsoft SQL Server JDBC Driver eingeführt.

Syntax

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

Parameter

columnIndex

Ein Wert vom Typ int zum Angeben des Spaltenindex.

x

Ein InputStream-Objekt.

length

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

Ausnahmen

SQLServerException

Hinweise

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 einem InputStream zu aktualisieren.

Entspricht die Länge des Datenstroms 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 Datenstroms nicht bekannt, kann der length-Parameter auf "-1" festgelegt werden, um anzugeben, dass der Datenstrom unabhängig von seiner Länge akzeptiert werden soll. Bei "sqljdbc4.jar" empfiehlt sich die Verwendung der JDBC 4.0-Methode updateBinaryStream-Methode (int, java.io.InputStream), wenn von der Anwendung versucht wird, die Spalte aus einem Datenstrom mit unbekannter Länge zu aktualisieren.

Siehe auch

Verweis

SQLServerResultSet-Klasse

Konzepte

updateBinaryStream-Methode (ISQLServerResultSet)
ISQLServerResultSet-Elemente