Vistas de libro, conexiones y asignaciones XML
Esta referencia cubre metadatos de libro editables que quedan fuera de la cuadrícula de celdas y que deben permanecer coherentes cuando cambian las hojas, los rangos, los filtros y las partes del paquete
Vistas personalizadas clásicas
TXLSWorksheet.CustomViews devuelve TXLSCustomViews, cuyos miembros Count, Items, Invalidatey SyncToRaw conservan registros de vista personalizada con y sin tipos
TXLSCustomView exposes ViewId, Zoom, GridColorIndex, ActivePane, ShowPageBreaks, ShowFormulas, ShowGridLines, ShowHeadings, ShowOutlineSymbols, ShowZeroValues, CenterHorizontally, CenterVertically, PrintHeadingsexpone PrintGridLines, FitToPage, FilterMode, AutoFilterVisible, FrozenPanes, FrozenNoSplit, SplitVertically, SplitHorizontally, TopLeftRow, TopLeftColumn, SplitX, SplitY, RightPaneColumn, BottomPaneRow, SelectionCount, Selections, HorizontalPageBreaks, VerticalPageBreaks, HasPageSetup, PaperSize, PrintScale, FirstPageNumber, FitToPagesWide, FitToPagesTall, PageSetupFlags, HorizontalResolution, VerticalResolution, HeaderMargin, FooterMargin, Copies, FilterFieldCount, FilterActive, FilterCriteria1, FilterCriteria2, FilterOperators, ClearFilterCriteria, RawRecordCount, RawRecordIdsy RawRecordData
TXLSCustomViewCellRange, TXLSCustomViewCellRanges, TXLSCustomViewSelectionInfo, TXLSCustomViewPageBreaky TXLSCustomViewPageBreaks transportan las cargas de selección y saltos de página que posee una vista
Ventanas de libro XLSX
TXLSXWorkbook.WorkbookViews posee entradas ordenadas de TXLSXWorkbookView configuradas por TXLSXWorkbookViewVisibility
| TXLSXWorkbookView | Assign, ActiveTab, FirstSheet, Visibility, Minimized, ShowHorizontalScroll, ShowVerticalScroll, ShowSheetTabs, XWindow, YWindow, WindowWidth, WindowHeight, TabRatio, AutoFilterDateGroupingy UnknownAttributes, and Extensions |
| TXLSXWorkbookViews | Add, Insert, Delete, Move, Clear, County Items |
La inserción, eliminación y movimiento de hojas reasignan la pestaña activa y la primera pestaña visible de cada ventana conservando la geometría independiente y las opciones de visualización
Selecciones por panel
TXLSXWorksheet.Selections devuelve TXLSXSelections; TXLSXSelectionPane identifica el panel de destino y cada TXLSXSelection almacena Pane, ActiveCell, ActiveCellIdy Sqref
TXLSXSelection.Assign copia una selección, mientras TXLSXSelections.Add, AddSelection, Assign, Clear, Delete, IndexOfPane, Counte Items mantienen la colección ordenada de vistas de hoja
Submodelos de conexión
TXLSConnection conserva metadatos de base de datos, web, texto y OLAP. Su modelo web usa WebParsePre, WebHtmlTablesy WebTables; su modelo de texto fijo usa TextSourceFile y TextFields; su modelo OLAP usa HasOlapProperties, OlapLocal, OlapLocalConnection, OlapLocalRefresh, OlapSendLocale, OlapRowDrillCount, OlapServerFill, OlapServerNumberFormat, OlapServerFont, OlapServerFontColor, OlapExtraAttributesXmly OlapChildrenXml
SourceFile almacena el origen de conexión de nivel superior mientras TextSourceFile almacena el origen de importación independiente textPr ; un TextSourceFile vacío recurre a SourceFile por compatibilidad
TXLSWebTableSelectorKind configura TXLSWebTableSelector, cuyos miembros Kind, Name, Index, ExtraAttributesXml, ChildrenXml, Assigny Validate conservan selectores con nombre, indexados y de tabla completa
TXLSWebTableSelectors proporciona Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXmly UnknownChildrenXml
TXLSTextImportFieldType configura TXLSTextImportField, cuyos miembros FieldType, Position, ExtraAttributesXml, ChildrenXmly Assigndefinen un campo de texto fijo Validate members define one fixed-text field
TXLSTextImportFields proporciona Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXmly UnknownChildrenXml
Miembros de conexión completos
TXLSConnection son Id, TypeCode, SourceFile, OdcFile, SingleSignOnId, KeepAlive, Interval, BackgroundRefresh, RefreshOnLoad, SaveData, SavePassword, NewConnection, Deleted, OnlyUseConnectionFile, ReconnectionMethod, RefreshedVersion, MinRefreshableVersion, ConnectionString, CommandText, ServerCommandText, CommandType, Parametersy ExtensionXml
Las propiedades web son WebUrl, WebPost, WebEditPage, WebHtmlFormat, WebXml, WebSourceData, WebConsecutive, WebFirstRow, WebXl97, WebTextDates, WebXl2000, WebExtraAttributesXmly WebChildrenXml
Las propiedades de texto son TextSourceFile, TextPrompt, TextDelimited, TextCodePage, TextFirstRow, TextCharacterSet, TextQualifier, TextFileType, TextDecimal, TextThousands, TextTab, TextSpace, TextComma, TextSemicolon, TextConsecutive, TextDelimiter, TextExtraAttributesXmly TextChildrenXml; la conservación de base de datos usa DbExtraAttributesXml y DbChildrenXml
TXLSConnections.Assign copia una colección, IndexOfId encuentra un identificador de conexión estable y RootAttributesXml más UnknownChildrenXml conservan el contenido raíz no admitido
Parámetros de conexión
TXLSConnectionParameter usa Name, ParameterType, SqlType, RefreshOnChange, Prompt, CellReference, IntegerValue, DoubleValue, BooleanValue, StringValue, ValueKind, ExtraAttributesXmly Assign
TXLSConnectionParameters proporciona Add, AddExisting, Assign, Delete, Clear, Counte Items
Tablas de consulta y campos
TXLSQueryTable usa Assign, ConnectionId, ResultTableName, ResultRange, RowNumbers, DisableRefresh, BackgroundRefresh, FirstBackgroundRefresh, RefreshOnLoad, GrowShrinkType, FillFormulas, RemoveDataOnSave, DisableEdit, PreserveFormatting, Intermediate, AutoFormatId, ApplyNumberFormats, ApplyBorderFormats, ApplyFontFormats, ApplyPatternFormats, ApplyAlignmentFormats, ApplyWidthHeightFormats, PreserveSortFilterLayout, FieldIdWrapped, AdjustColumnWidth, HeadersInLastRefresh, MinimumVersion, UnboundColumnsLeft, UnboundColumnsRight, DeletedFields, SortStateXml, ExtensionXml, RefreshExtensionXmly UnknownChildrenXml, ExtraAttributesXml, RefreshExtraAttributesXml, and RefreshUnknownChildrenXml
TXLSQueryTableField uses Idusa Name, TableColumnId, DataBound, RowNumbers, FillFormulas, Clipped, ExtraAttributesXml, Assigny Validate
TXLSQueryTableFields proporciona Add, AddExisting, Assign, FindById, FindByTableColumnId, NextId, Validate, Deletee Clear; Countcopia la colección de tablas de consulta de la hoja de cálculo Items; TXLSQueryTables.Assign copia la colección de tablas de consulta de la hoja
Actualización explícita de tablas de consulta
Consulte los proveedores de consulta automáticos para la actualización explícita sin un proveedor del llamador, el registro, los enlaces nativos y los límites de las operaciones externas
TXLSXWorksheet.RefreshQueryTable selecciona una tabla de consulta existente por nombre o por su índice de base 0 en la colección y acepta un TXLSQueryTableProvider propiedad del llamador, un límite AMaxRows positivo cuyo valor por defecto es 1,000,000 filas de datos y un callback opcional TXLSQueryRefreshProgress
Implemente TXLSQueryTableProvider.Fetch(Connection, Query, MaxRows, out Data, var Abort) para devolver un registro TXLSQueryResultData con ColumnCount y Rows rectangular de valores Variant escalares; TXLSQueryResultRow es un arreglo de variantes y TXLSQueryResultRows es un arreglo de esas filas; las filas excluyen los encabezados existentes y deben coincidir con el ancho del destino; los valores numéricos, las fechas, los Boolean, las cadenas, los errores, los valores vacíos y los null conservan sus tipos, y las cadenas que comienzan con = siguen siendo valores literales
El proveedor recibe instantáneas separadas de los metadatos de conexión y de consulta, válidas solo durante la llamada, y debe respetar el límite de filas; la biblioteca rechaza las filas en exceso, las matrices irregulares, los tipos de valor no soportados, los anchos inválidos y los resultados fuera de la cuadrícula de 1,048,576 filas por 16,384 columnas de la hoja, sin truncar
La actualización conserva los encabezados y el formato de celdas existentes, limpia la cola de datos antiguos de un resultado que se encoge, redimensiona una tabla de Excel adjunta y los rangos de filtro u ordenación soportados, actualiza los metadatos de la tabla de consulta e invalida los cálculos dependientes; las fórmulas y los estilos fuera del área del resultado permanecen sin cambios
Una consulta deshabilitada, una conexión eliminada, celdas combinadas o fórmulas de matriz superpuestas, otra tabla u otro resultado de consulta, celdas de expansión ocupadas, columnas calculadas de tabla, filas de totales, columnas de números de fila, el comportamiento de relleno de fórmulas o las columnas sin vincular impiden la actualización antes de que cambien las celdas del resultado
El progreso se reporta antes de obtener los datos, antes de aplicar los resultados y después de cada fila aplicada o limpiada; asigne Abort en el proveedor o en el callback de progreso para cancelar, y un valor de retorno de 1 indica éxito, 0 cancelación y -1 fallo, con los códigos de diagnóstico 1401 y 1400 identificando la cancelación y el fallo bajo xlsOperationRefresh
La cancelación o las excepciones del proveedor, de la validación o del callback restauran las celdas del resultado y los metadatos de la consulta o de la tabla, incluidos los handles de celdas existentes; los proveedores explícitos del llamador son dueños de su acceso externo; la selección automática para las consultas de texto, ADO, ODBC y Web soportadas de Windows está disponible a través del despachador del libro, y abrir un libro o conservar los metadatos de RefreshOnLoad no invoca ninguna de las dos rutas de proveedor
Asignaciones XML y XML personalizado
TXLSXWorkbook.XmlMaps devuelve TXLSXXmlMaps, y TXLSXWorksheet.XmlCellBindings devuelve la colección de enlaces de la hoja
| TXLSXXmlDataBinding | Almacena el identificador de relación y los metadatos de actualización que conectan una asignación con una parte XML personalizada Enabled, DataBindingName, FileBinding, FileBindingName, ConnectionId, DataBindingLoadMode, and ExtensionXml mirror the OOXML dataBinding attributes |
| TXLSXXmlSchema | Almacena un identificador de esquema, un espacio de nombres y el XML de esquema conservado Id, SchemaRef, NamespaceUri, Language, and Xml round-trip the schema part |
| TXLSXXmlMap | Almacena la identidad del mapa, el elemento raíz y el namespace, y su DataBinding; import behaviour is configured by RootElement, SchemaId, ShowImportExportValidationErrors, AutoFit, Append, PreserveSortAFLayoutAlmacena la identidad de la asignación, el elemento raíz y el espacio de nombres, y su PreserveFormat |
| TXLSXXmlMaps | AddSchema, AddMap, FindSchema, FindMap, DeleteSchema, DeleteMap, Clear, Validate, SelectionNamespacesy SchemaCountTXLSXXmlCellBinding SchemasAsigna un rango de hoja de cálculo a una ruta XPath y a un identificador de asignación XML MapCount |
| TXLSXXmlCellBinding | Sobrecargas de CellReference, XPath, XmlDataType, MapId, XmlCellPropertyIde ConnectionId, and UniqueName preserve the full OOXML binding |
| TXLSXXmlCellBindings | Add overloads, Delete, Clear, Validate, Count, and Items |
| TXLSXCustomXmlPart | AddSchemaRef asocia un elemento XML personalizado con una referencia de esquema; Xml holds the item payload, ItemId the data-store item identifier, and SchemaRefs asocia un elemento XML personalizado con una referencia de esquema |
Miembros avanzados de clonación, HTML e imágenes
TXLSXRangeClonePart, TXLSXRangeClonePartsy TXLSXRangeCloneSourceCounts definen la clonación de rangos con reconocimiento de dependencias. TXLSXWorksheet.CaptureRangeCloneSourceCounts, AuthorizeRepeatedDisjointRangeClones, ResizeTableRowsy TileRangeAxisMetadata son enlaces de edición estructural avanzada usados por la expansión de informes compilados y participantes personalizados
TXLSXHtmlExportSessionState describe TXLSXHtmlExportSession; use BeginExport, ExportNextSheety Reset, y luego inspeccione State, Active, ExportedSheetCounty TotalSheetCount. Establezca TXLSXHtmlExportOptions.IncludeDrawings para representar objetos de hoja de cálculo admitidos en la sesión HTML
TXLSXImage expone Gamma, ShadowColor, ShadowOpacity, ShadowBlur, ShadowOffsetXy ShadowOffsetY para el renderizado compartido de PDF, SVG, HTML, mapa de bits y metarchivo