Funktionsreferenz

_ExcelWriteSheetFromArray

Schreibt ein 2D Array in das aktive Tabellenblatt

#Include <Excel.au3>
_ExcelWriteSheetFromArray($oExcel, ByRef $aArray [, $iStartRow = 1 [, $iStartColumn = 1 [, $iRowBase = 1 [, $iColBase = 1]]]])

 

Parameter

$oExcel Ein Excel Objekt welches durch einen vorherigen Aufruf von _ExcelBookOpen() oder _ExcelBookNew() geöffnet wurde
$aArray Das Array (ByRef) von dem die Daten in die Excel-Datei geschrieben werden sollen (Array ist nicht verändert)
$iStartRow [optional] Die Zeile des Tabellenblattes wo das Array beginnen soll zu schreiben, Standard ist 1
$iStartColumn [optional] Die Spalte des Tabellenblattes wo das Array beginnen soll zu schreiben, Standard ist 1
$iRowBase [optional] Der Basisindex des Arrays für die Zeilen, Standard ist 1
$iColBase [optional] Der Basisindex des Arrays für die Spalten, Standard ist 1

 

Rückgabewert

Erfolg: 1
Fehler: 0 und setzt @error bei Fehlern:
@error: 0 - Kein Fehler
1 - festgelegtes Objekt existiert nicht
2 - Parameter außerhalb des Bereichs
3 - Array ungültig
4 - Basisindex außerhalb des Bereichs
@extended: 0 - Zeile außerhalb des Bereichs
1 - Spalte außerhalb des Bereichs

 

Bemerkungen

Die Standard Basisindizes in dem Array sind beide 1. Dadurch wird die erste Zelle von $aArray[1][1] geschrieben.

 

Verwandte Funktionen

 

Beispiel


; ***************************************************************
; Beispiel 1 – Nach dem öffnen einer Arbeitsmappe und Rückgabe des Objekt-Identifizierers:  Deklariere ein 2-D Array, und fügt Daten in diese Array
; *****************************************************************

#include <Excel.au3>

Local $oExcel = _ExcelBookNew() ; Erstellt eine neue Arbeitsmappe und zeigt sie an

; Deklarieren des Arrays (und einfügen von Daten)
Local $aArray[5][2] = [["LocoDarwin", 1],["Jon", 2],["big_daddy", 3],["DaleHolm", 4],["GaryFrost", 5]] ; 0-basierendes Array
_ExcelWriteSheetFromArray($oExcel, $aArray, 1, 1, 0, 0) ; 0-basierende Array Parameter

MsgBox(0, "Verlassen", "Drücke OK um die Datei zu Speichern und das Programm zu verlassen")
_ExcelBookSaveAs($oExcel, @TempDir & "\Temp.xls", "xls", 0, 1) ; Nun speichern wir die Datei, in eine temporäres Verzeichnis; Möglicherweise werden existierende Dateien dabei überschrieben!
_ExcelBookClose($oExcel) ; Zum Abschluss, verlassen wir das Programm