Vistas de libro, conexiones y asignaciones XML
Esta referencia cubre los metadatos de libro editables que se encuentran fuera de la cuadrícula de celdas y deben permanecer coherentes cuando cambian hojas, rangos, filtros y partes del paquete
Vistas personalizadas clásicas
TXLSWorksheet.CustomViews devuelve TXLSCustomViews, cuyos miembros Count, Items, Invalidatey SyncToRaw conservan registros de vista personalizada tipados y desconocidos
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 propiedad de una vista
Ventanas de libro XLSX
TXLSXWorkbook.WorkbookViews posee entradas TXLSXWorkbookView ordenadas 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, Counte Items |
La inserción, eliminación y movimiento de hojas reasignan la pestaña activa y la primera visible de cada ventana conservando la geometría y la configuración de visualización independientes
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 que 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 la fuente de conexión de nivel superior mientras que TextSourceFile almacena la fuente de importación textPr independiente; 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 completos de conexión
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 bases 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 compatible
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 de cálculo
Actualización explícita de tablas de consulta
Consulte 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 operaciones externas
TXLSXWorksheet.RefreshQueryTable selecciona una tabla de consulta existente por nombre o por su índice de colección de base cero, y acepta un TXLSQueryTableProvider propiedad del llamador, un límite AMaxRows positivo que por defecto es 1.000.000 de filas de datos y una devolución de llamada TXLSQueryRefreshProgress opcional
Implemente TXLSQueryTableProvider.Fetch(Connection, Query, MaxRows, out Data, var Abort) para devolver un registro TXLSQueryResultData con ColumnCount y Rows rectangulares de valores Variant escalares; TXLSQueryResultRow es un array de variantes y TXLSQueryResultRows un array de esas filas; las filas excluyen los encabezados existentes y deben coincidir con el ancho del destino; los valores numéricos, las fechas, los booleanos, las cadenas, los errores, los valores vacíos y los nulos conservan su tipo, y las cadenas que empiezan por = siguen siendo valores literales
El proveedor recibe instantáneas desacopladas de metadatos de conexión y consulta válidas solo durante la llamada, y debe respetar el límite de filas; la biblioteca rechaza sin truncamiento las filas en exceso, las matrices irregulares, los tipos de valor no admitidos, los anchos no válidos y los resultados fuera de la cuadrícula de hoja de cálculo de 1.048.576 filas por 16.384 columnas
La actualización conserva los encabezados y el formato de celda existentes, borra la cola de datos antigua de un resultado que se encoge, redimensiona una tabla de Excel adjunta y los rangos de filtro u ordenación admitidos, actualiza los metadatos de la tabla de consulta e invalida los cálculos dependientes; las fórmulas y los estilos fuera del área de resultado permanecen sin cambios
Una consulta deshabilitada, una conexión eliminada, celdas combinadas superpuestas o fórmulas matriciales, otra tabla u otro resultado de consulta, celdas de expansión ocupadas, columnas calculadas de tabla, filas de totales, columnas de número de fila, el comportamiento de fill-formula o columnas sin enlazar impiden la actualización antes de que cambien las celdas de resultado
El progreso se informa antes de la obtención, antes de aplicar los resultados y después de cada fila aplicada o borrada; establezca Abort en el proveedor o en la devolución de llamada de progreso para cancelar, y un valor devuelto 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 de la devolución de llamada restauran las celdas de resultado y los metadatos de consulta o tabla, incluidos los identificadores de celda existentes; los proveedores explícitos del llamador son dueños de su acceso externo; la selección automática para consultas de Texto, ADO, ODBC y Web admitidas 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 TXLSXXmlMapsy TXLSXWorksheet.XmlCellBindings devuelve la colección de enlaces de hoja
| TXLSXXmlDataBinding | Almacena el identificador de relación y los metadatos de actualización que conectan un mapa 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 espacio de nombres, y su DataBinding; import behaviour is configured by RootElement, SchemaId, ShowImportExportValidationErrors, AutoFit, Append, PreserveSortAFLayoutAlmacena la identidad del mapa, 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 un XPath y un identificador de mapa 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 imagen
TXLSXRangeClonePart, TXLSXRangeClonePartsy TXLSXRangeCloneSourceCounts definen la clonación de rangos consciente de dependencias. TXLSXWorksheet.CaptureRangeCloneSourceCounts, AuthorizeRepeatedDisjointRangeClones, ResizeTableRowsy TileRangeAxisMetadata son enganches avanzados de edición estructural usados por la expansión de informes compilados y los participantes personalizados
TXLSXHtmlExportSessionState describe TXLSXHtmlExportSession; use BeginExport, ExportNextSheety Reset, y luego inspeccione State, Active, ExportedSheetCounty TotalSheetCount. Establezca TXLSXHtmlExportOptions.IncludeDrawings para representar los objetos de hoja compatibles en la sesión HTML
TXLSXImage expone Gamma, ShadowColor, ShadowOpacity, ShadowBlur, ShadowOffsetXy ShadowOffsetY para la representación compartida de PDF, SVG, HTML, mapa de bits y metarchivo