AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Funciones estándar / Funciones de archivos XLS
  • Contenido de las celdas: teniendo en cuenta las filas y columnas vacías
  • Gestión de errores
  • Tipo de datos recuperados
WINDEV
WindowsLinuxJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac Catalyst
Otros
Procedimientos almacenados
Recupera el contenido de una celda de un archivo XLS. El resultado depende del modo de apertura del archivo XLS:
  • En modo multihoja, los datos recuperados se encuentran en la hoja de cálculo seleccionada por xlsCurrentWorksheet.
  • En modo compatible, los datos recuperados se encuentran siempre en la primera hoja del libro de trabajo.
Nota: El contenido de una celda de un archivo XLS sólo puede recuperarse si:
  • El archivo XLS existe.
  • Se abre el archivo XLS.
// 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)
Sintaxis

Sintaxis que utiliza el tipo xlsDocument Ocultar los detalles

<Result> = xlsData(<XLS document> , <Row number> , <Column number> [, <Empty rows and columns>])
<Result>: Cadena de caracteres
  • Contenido de la celda especificada.
  • Si el contenido de la celda corresponde a una cadena vacía (""), puede corresponder a un error. En este caso, la variable ErrorOccurred se establece en True y la función xlsMsgError devuelve los detalles del error.
<XLS document>: Variable de tipo xlsDocument
Nombre de la variable de tipo xlsDocument a manipular.
<Row number>: Integro
Número de fila de la celda a leer.
<Column number>: Integro
Número de la columna de la celda a leer.
<Empty rows and columns>: Booleano opcional
Define cómo se tendrán en cuenta las filas y columnas vacías:
FalseSe tienen en cuenta las filas y columnas vacías.
True
(predeterminado)
Las filas y columnas vacías se ignoran.

Sintaxis conservada por motivos de compatibilidad con la versión 12 Ocultar los detalles

<Result> = xlsData(<XLS file identifier> , <Row number> , <Column number> [, <Empty rows and columns>])
<Result>: Cadena de caracteres
  • Contenido de la celda especificada.
  • Si el contenido de la celda corresponde a una cadena vacía (""), puede corresponder a un error. En este caso, la variable ErrorOccurred se establece en True y la función xlsMsgError devuelve los detalles del error.
Nota: Si el archivo Excel se ha abierto en modo compatible, el contenido de la celda no puede superar los 255 caracteres.
<XLS file identifier>: Integro
Identificador del archivo XLS a tratar, devuelto por xlsOpen.
<Row number>: Integro
Número de fila de la celda a leer.
<Column number>: Integro
Número de la columna de la celda a leer.
<Empty rows and columns>: Booleano opcional
Define cómo se tendrán en cuenta las filas y columnas vacías:
FalseSe tienen en cuenta las filas y columnas vacías.
True
(predeterminado)
Las filas y columnas vacías se ignoran.
Observaciones

Contenido de las celdas: teniendo en cuenta las filas y columnas vacías

Las filas y columnas vacías pueden tenerse en cuenta o no. Por ejemplo:
xlsData(XLSFileID, 2, 3, True) 
// Return the content of cell D2: "23"
xlsData(XLSFileID, 2, 3, False) 
// Returns the content of cell C2: ""
En este ejemplo, la columna C (que está totalmente vacía) puede tenerse en cuenta o no.

Gestión de errores

Si se produce un error, la función xlsData devuelve una cadena vacía (""). Para obtener más información sobre el error, utilice la función xlsMsgError o ErrorInfo con la constante errMessage.
La función xlsData genera un error en los siguientes casos:
  • La fila y/o columna especificada está vacía.
  • El archivo XLS especificado no existe.
  • El archivo XLS especificado no está abierto.

Tipo de datos recuperados

La función xlsData devuelve una cadena, independientemente del formato de celda definido en Excel.
Nota: Excel no admite el tipo "Numérico de alta precisión". El valor Numerical recuperado será truncado.
Si el contenido de la celda especificada es del tipo:El resultado se convierte en:
NumericCadena
FechaCadena en formato DD/MM/AAAA
TiempoCadena en formato HH:MM:SS
Componente: wd300xls.dll
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 21/11/2024

Señalar un error o enviar una sugerencia | Ayuda local