getObject-Methode (java.lang.String, java.util.Map) (SQLServerResultSet)

Artikel
06/02/2023

Ruft unter Verwendung des Map-Objekts den Wert des angegebenen Spaltennamens in der aktuellen Zeile dieses SQLServerResultSet-Objekts als Objekt in der Programmiersprache Java ab.

Hinweis

Diese Methode wird von Microsoft JDBC-Treiber für SQL Server derzeit nicht unterstützt. Bei Verwendung dieser Methode wird immer die Standardzuordnung zurückgegeben.

Syntax

  
public java.lang.Object getObject(java.lang.String colName,  
                                  java.util.Map map)

Parameter

colName

Eine Zeichenfolge, die den Spaltennamen enthält.

map

Ein Map-Objekt

Rückgabewert

Ein Object-Wert.

Ausnahmen

SQLServerException

Bemerkungen

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

Von dieser Methode wird der Wert der angegebenen Spalte als Java-Objekt zurückgegeben. Beim Typ des Java-Objekts handelt es sich um den standardmäßigen Java-Objekttyp, der dem SQL-Typ der Spalte entspricht. Die Grundlage hierfür bildet die in der JDBC-Spezifikation angegebene Zuordnung für integrierte Typen. Bei einem SQL-NULL-Wert wird vom Treiber ein Java-NULL-Wert zurückgegeben.

Diese Methode kann auch zum Lesen datenbankspezifischer, abstrakter Datentypen verwendet werden. In der JDBC 2.0-API wird das Verhalten der getObject-Methode erweitert, um Daten von benutzerdefinierten SQL-Typen zu materialisieren. Enthält eine Spalte einen strukturierten oder eindeutigen Wert, entspricht das Verhalten dieser Methode einem Aufruf von getObject(columnIndex, this.getStatement().getConnection().getTypeMap()).

Ab dem JDBC-Treiber 3.0 für SQL Server wird folgendermaßen verfahren:

Ein Date-Wert wird als java.sql.Date-Objekt zurückgegeben.
Ein Time-Wert wird als java.sql.Time-Objekt zurückgegeben.
Ein Datetime2-Wert wird als java.sql.Timestamp-Objekt zurückgegeben.
Ein Datetimeoffset-Wert wird als microsoft.sql.DateTimeOffset-Objekt zurückgegeben.

Weitere Informationen

getObject-Methode (SQLServerResultSet)
SQLServerResultSet-Elemente
SQLServerResultSet-Klasse

Freigeben über