|
- Content of the cells: taking the empty rows and columns into account
- Error management
- Type of data retrieved
xlsData (Function) In french: xlsDonnée Retrieves the content of a cell found in an XLS file. The result depends on the opening mode of XLS file: - In multi-sheet mode, the data retrieved is found on the worksheet selected by xlsCurrentWorksheet.
- In compatible mode, the data retrieved is always found on the first worksheet of the workbook.
The performance of this function was improved in version 14. Note: The content of a cell found in an XLS file can be retrieved if: - The XLS file exists.
- The XLS file is opened.
// Declare the variables ResData is string XLSFileID is int
// Open an XLS file XLSFileID = xlsOpen("C:\MyDirectory\File.XLS") IF XLSFileID <> -1 THEN // Retrieve the value of a cell ResData = xlsData(XLSFileID, 3, 4) ... END
cMyXLSFile is xlsDocument cMyXLSFile = xlsOpen(sMyFile, xlsWrite) IF ErrorOccurred = False THEN Azz is int = xlsCurrentWorksheet(cMyXLSFile) Info("Current worksheet in the Excel file: " + Azz) // Change worksheet IF xlsCurrentWorksheet(cMyXLSFile, 2) = True THEN Info("The current worksheet was modified.") // Read a cell for test Info(xlsData(cMyXLSFile, 11, 2)) ELSE Error("The selected file does not include a second worksheet!") END ELSE Error(ErrorInfo(errFullDetails)) END xlsClose(cMyXLSFile)
Syntax
Syntax that is using the xlsDocument type Hide the details
<Result> = xlsData(<XLS document> , <Row number> , <Column number> [, <Empty rows and columns>])
<Result>: Character string - Content of specified cell.
- If the cell content corresponds to an empty string (""), this may correspond to an error. In this case, the ErrorOccurred variable is set to True and xlsMsgError returns the error details.
<XLS document>: xlsDocument variable Name of xlsDocument variable to use. <Row number>: Integer Number of the row for the cell to read. <Column number>: Integer Number of the column for the cell to read. <Empty rows and columns>: Optional boolean Defines how the empty rows and columns will be taken into account:
| | True (by default) | The empty rows and columns are ignored. | False | The empty rows and columns are taken into account. |
Syntax kept for backward compatibility with version 12 Hide the details
<Result> = xlsData(<Identifier of XLS file> , <Row number> , <Column number> [, <Empty rows and columns>])
<Result>: Character string - Content of specified cell.
- If the cell content corresponds to an empty string (""), this may correspond to an error. In this case, the ErrorOccurred variable is set to True and xlsMsgError returns the error details.
Note: If the Excel file was opened in compatible mode, the content of the cell cannot exceed 255 characters.
<Identifier of XLS file>: Integer Identifier of XLS file to handle, returned by xlsOpen. <Row number>: Integer Number of the row for the cell to read. <Column number>: Integer Number of the column for the cell to read. <Empty rows and columns>: Optional boolean Defines how the empty rows and columns will be taken into account:
| | True (by default) | The empty rows and columns are ignored. | False | The empty rows and columns are taken into account. |
Remarks Content of the cells: taking the empty rows and columns into account The empty rows and columns can be taken into account or not. For example:
xlsData(XLSFileID, 2, 3, True) // Return the content of D2 cell: "23" xlsData(XLSFileID, 2, 3, False) // Return the content of C2 cell: ""
In this example, the column C (that is entirely empty) can be taken into account or not. Error management If an error occurs, xlsData returns an empty string (""). To find out the error details, use xlsMsgError or ErrorInfo associated with the errMessage constant. xlsData generates an error in the following cases: - The specified row and/or column is empty.
- The specified XLS file does not exist.
- The specified XLS file is not opened.
Type of data retrieved xlsData returns a string, regardless of the cell format defined in Excel. Caution: The "High-precision numeric" type is not supported by Excel: the value of the numeric that is retrieved will be truncated. | | If the content of the specified cell has the following type: | The result is converted into: | Numeric | String | Date | String in DD/MM/YYYY format | Time | String in HH:MM:SS format |
This page is also available for…
|
|
|
| |
| | https://youtu.be/Xz9Lpy4_7SA
https://windevdesenvolvimento.blogspot.com/2019/05/dicas-2123-windev-webdev-mobile-excel-9.html
//btn_abrir_excel TableDeleteAll(TABLE_EXCEL) nABRE_EXCEL is int=xlsOpen(EDT_PROCURA_ARQUIVO_eXCEL) IF nABRE_EXCEL<>-1 THEN nNUMERO_LINHAS is int=xlsNbRow(nABRE_EXCEL) nCONTADOR is int=0 FOR nCONTADOR=2 TO nNUMERO_LINHAS POSICAO is int=TableAddLine(TABLE_EXCEL) Message(nCONTADOR+"/"+nNUMERO_LINHAS) TABLE_EXCEL[POSICAO].COL_01_A_CODE=xlsData(nABRE_EXCEL,nCONTADOR,1) TABLE_EXCEL[POSICAO].COL_02_B=xlsData(nABRE_EXCEL,nCONTADOR,2) END END
|
|
|
|
| |
| |
| |
|
| | n_abre_excel is int=xlsOpen("nome_excel.xls") n_numero_linhas is int=xlsNbRow(n_abre_excel) n_contador is int=0 FOR n_contador = 2 TO n_numero_linhas HReset(nota_rps_servico) s_codigo_municipio is string=xlsData(n_abre_excel,n_contador,3) nota_rps_servico.codigo_municipio=s_codigo_municipio HAdd(nota_rps_servico) END Info("Final da Gravacao") //----------------------------------------------------------- //Blog com Video e Exemplo http://windevdesenvolvimento.blogspot.com.br/2016/01/curso-windev-excel-001-ler-planilha.html |
|
|
|
| |
| |
| |
| |
| |
| |
| | |
| |