Teilen über

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

  • Artikel

JDBC-Treiber herunterladen

Aktualisiert die angegebene Spalte mit einem ASCII-Datenstromwert mit der angegebenen Anzahl von Bytes.

Syntax

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

Parameter

columnIndex

Ein ganzzahliger Wert, der den Spaltenindex angibt.

x

Ein InputStream-Objekt

length

Die Länge des Datenstroms.

Ausnahmen

SQLServerException

Bemerkungen

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

Von dieser Methode werden ASCII-Zeichen (Bytes) von einem InputStream-Objekt an konvertierbare Zeichenspalten übergeben, bei denen es sich um den ASCII-Bereich „[0x00 – 0x7F]“ von Unicode sowie um die Codepages 874, 932, 936, 949, 950 und 1250 bis 1258 handelt. Von dieser Methode wird eine Konvertierung zur Zielsortierseite vorgenommen. Beim Versuch, eine nicht konvertierbare Zielspalte zu aktualisieren, wird eine Ausnahme ausgelöst. Für Binärspalten werden Rohbytes übergeben.

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 updateAsciiStream (int, java.io.InputStream), wenn von der Anwendung versucht wird, die Spalte aus einem Stream mit unbekannter Länge zu aktualisieren.

Weitere Informationen

updateAsciiStream-Methode (SQLServerResultSet)
SQLServerResultSet-Elemente
SQLServerResultSet-Klasse