getBinaryStream-Methode (int)

Artikel
06/02/2023

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

Syntax

  
public java.io.InputStream getBinaryStream(int columnIndex)

Parameter

columnIndex

Ein ganzzahliger Wert, der den Spaltenindex angibt.

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

Teilen über