Freigeben über


getBinaryStream-Methode (java.lang.String)

JDBC-Treiber herunterladen

Ruft den Wert des angegebenen Spaltennamens in der aktuellen Zeile dieses SQLServerResultSet-Objekts als Binärstream nicht interpretierter Bytes ab.

Syntax

  
public java.io.InputStream getBinaryStream(java.lang.String columnName)  

Parameter

columnName

Eine Zeichenfolge, die den Spaltennamen enthält.

Rückgabewert

Ein InputStream-Objekt

Ausnahmen

SQLServerException

Bemerkungen

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

Diese Methode kann nur mit folgenden SQL Server-Datentypen verwendet werden: binary, varbinary, varbinary(max) und image. Bei Verwendung dieser Methode mit anderen Datentypen wird eine Ausnahme ausgelöst.

Nachdem der Wert von der Methode als Datenstrom empfangen wurde, kann der Wert in Ausschnitten aus dem Strom gelesen werden. Diese Methode ist besonders zum Abrufen umfangreicher LONGVARBINARY-Werte geeignet.

Hinweis

Alle Daten im zurückgegebenen Datenstrom müssen vor dem Abrufen des Werts aus einer anderen Spalte gelesen werden. Der nächste Aufruf einer Getter-Methode schließt den Datenstrom implizit. Ein Datenstrom kann ebenfalls 0 (null) zurückgeben, wenn die InputStream.available-Methode aufgerufen wird, egal ob Daten verfügbar sind oder nicht.

Weitere Informationen

getBinaryStream-Methode (SQLServerResultSet)
SQLServerResultSet-Elemente
SQLServerResultSet-Klasse