updateAsciiStream-Methode (java.lang.String, java.io.InputStream, int)

Artikel
06/02/2023

Aktualisiert den angegebenen Spaltenamen mit einem ASCII-Datenstromwert mit der angegebenen Anzahl von Bytes.

Syntax

  
public void updateAsciiStream(java.lang.String columnName,  
                              java.io.InputStream x,  
                              int length)

Parameter

columnName

Eine Zeichenfolge, die den Spaltennamen enthält.

Ein InputStream-Objekt

length

Ein ganzzahliger Wert, der die Länge des Streams angibt.

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 (java.lang.String, 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

Teilen über