getValue
Versionshinweise | 17.2.06, 18.1 |
---|
Code
Object getValue(Spreadsheet spreadsheet, String cellName) throws Exception
Object getValue(Spreadsheet spreadsheet, int column, int row) throws Exception
Beschreibung
Liefert den Wert der angegebene Zelle in der übergebenen Tabellenkalkulationsdatei.
Parameter
- spreadsheet
Repräsentiert die Tabellenkalkulationsdatei - cellName
Name der benannten Zelle (z.B. "CONF_SEARCHDIALOG") oder eine Zellenangabe in der A1-Schreibweise (z.B. "A3") - column
Numerischer Spaltenindex der Zelle (erste Spalte beginnt mit 1) - row
Numerischer Zeilenindex der Zelle (erste Zeile beginnt mit 1)
Rückgabe
Wert der angegebene Zelle in der übergebenen Tabellenkalkulationsdatei. Folgende Typen werden zurückgegeben:
- null - die Zelle ist leer
- java.lang.Boolean - Zelle enthält einen logischen Wert, wie z.B. WAHR oder FALSCH
- java.lang.Double - Zelle enthält einen Gleitkommawert, wie z.B. 1.23
- java.lang.Integer - Zelle enthält eine "ganze" Zahl, wie z.B. 10
- java.util.Date - Zelle enthält einen Datumswert, wie z.B. 03.10.2017
- java.util.Date - Zelle enthält eine Zeitangabe, wie z.B. 11:23
Die Uhrzeit wird in Kombination mit dem Datum 31.12.1899 zurückgegeben. - java.lang.String - Zelle enthält eine alphanumerische Zeichenfolge.
Exception
Wird im Regelfall geworfen, wenn die angegebene benannte Zelle nicht vorhanden ist.
Beispiele
ISpreadsheetResultOpen openResult = SpreadsheetUtils.openFile("C:\\Work\\myFirstSpreadsheet.xlsm");
if (!openResult.isSuccessful())
{
ScriptUtils.debug("Error: " + openResult.getFileName() + " - " + openResult.getErrorCode());
/** do furthermore */
...
return;
}
Spreadsheet excel = openResult.getSpreadsheet();
Object valuePerColumnRowIndex = SpreadsheetUtils.getValue(excel, 3, 4);
Object valuePerA1Format = SpreadsheetUtils.getValue(excel, "B7");
/** do furthermore with values */
...
String nameOfCell = "CONF_SEARCHNAME";
if (SpreadsheetUtils.existsCellName(excel, nameOfCell))
{
Object valuePerCellName = SpreadsheetUtils.getValue(excel, nameOfCell);
/** do furthermore */
...
}
SpreadsheetUtils.close(excel);