getValue

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);