Arbeitsmappenansichten, Verbindungen und XML-Zuordnungen

Diese Referenz behandelt bearbeitbare Arbeitsmappen-Metadaten, die außerhalb des Zellrasters liegen und konsistent bleiben müssen, wenn sich Blätter, Bereiche, Filter und Paketteile ändern

Klassische benutzerdefinierte Ansichten

TXLSWorksheet.CustomViews gibt TXLSCustomViewszurück, dessen Elemente Count, Items, Invalidateund SyncToRaw typisierte und unbekannte Datensätze benutzerdefinierter Ansichten erhalten

TXLSCustomView legt ViewId, Zoom, GridColorIndex, ActivePane, ShowPageBreaks, ShowFormulas, ShowGridLines, ShowHeadings, ShowOutlineSymbols, ShowZeroValues, CenterHorizontally, CenterVertically, PrintHeadings, PrintGridLines, FitToPage, FilterMode, AutoFilterVisible, FrozenPanes, FrozenNoSplit, SplitVertically, SplitHorizontally, TopLeftRow, TopLeftColumn, SplitX, SplitY, RightPaneColumn, BottomPaneRow, SelectionCount, Selections, HorizontalPageBreaks, VerticalPageBreaks, HasPageSetup, PaperSize, PrintScale, FirstPageNumber, FitToPagesWide, FitToPagesTall, PageSetupFlagsund HorizontalResolutionoffen VerticalResolution, HeaderMargin, FooterMargin, Copies, FilterFieldCount, FilterActive, FilterCriteria1, FilterCriteria2, FilterOperators, ClearFilterCriteria, RawRecordCount, RawRecordIds, and RawRecordData

TXLSCustomViewCellRange, TXLSCustomViewCellRanges, TXLSCustomViewSelectionInfo, TXLSCustomViewPageBreakund TXLSCustomViewPageBreaks tragen die einer Ansicht gehörenden Auswahl- und Seitenumbruch-Payloads

XLSX-Arbeitsmappenfenster

TXLSXWorkbook.WorkbookViews verwaltet geordnete TXLSXWorkbookView -Einträge, die von TXLSXWorkbookViewVisibility

Das Einfügen, Löschen und Verschieben von Blättern ordnet die aktive und die zuerst sichtbare Registerkarte jedes Fensters neu zu, wobei unabhängige Geometrie- und Anzeigeeinstellungen erhalten bleiben

Auswahlen pro Fensterbereich

TXLSXWorksheet.Selections gibt TXLSXSelectionszurück; TXLSXSelectionPane identifiziert den Zielfensterbereich, und jedes TXLSXSelection speichert Pane, ActiveCell, ActiveCellIdund mehrbereichiges Sqref

TXLSXSelection.Assign kopiert eine Auswahl, während TXLSXSelections.Add, AddSelection, Assign, Clear, Delete, IndexOfPane, Countund Items die geordnete Blattansichts-Sammlung verwalten

Verbindungs-Untermodelle

TXLSConnection erhält Datenbank-, Web-, Text- und OLAP-Metadaten. Sein Webmodell verwendet WebParsePre, WebHtmlTablesund WebTables; sein Festtextmodell verwendet TextSourceFile und TextFields; sein OLAP-Modell verwendet HasOlapProperties, OlapLocal, OlapLocalConnection, OlapLocalRefresh, OlapSendLocale, OlapRowDrillCount, OlapServerFill, OlapServerNumberFormat, OlapServerFont, OlapServerFontColor, OlapExtraAttributesXmlund OlapChildrenXml

SourceFile speichert die Quellverbindung der obersten Ebene, während TextSourceFile die unabhängige textPr -Importquelle speichert; ein leeres TextSourceFile greift aus Kompatibilitätsgründen auf SourceFile zurück

TXLSWebTableSelectorKind konfiguriert TXLSWebTableSelector, dessen Elemente Kind, Name, Index, ExtraAttributesXml, ChildrenXml, Assignund Validate benannte, indizierte und Gesamttabellen-Selektoren erhalten

TXLSWebTableSelectors stellt Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXmlund UnknownChildrenXml

TXLSTextImportFieldType configures TXLSTextImportFieldkonfiguriert FieldType, dessen Elemente Position, ExtraAttributesXml, ChildrenXml, Assignund Validate ein Festtextfeld definieren

TXLSTextImportFields stellt Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXmlund UnknownChildrenXml

Vollständige Verbindungselemente

TXLSConnection sind Id, TypeCode, SourceFile, OdcFile, SingleSignOnId, KeepAlive, Interval, BackgroundRefresh, RefreshOnLoad, SaveData, SavePassword, NewConnection, Deleted, OnlyUseConnectionFile, ReconnectionMethod, RefreshedVersion, MinRefreshableVersion, ConnectionString, CommandText, ServerCommandText, CommandType, Parametersund ExtensionXml

Web-Eigenschaften sind WebUrl, WebPost, WebEditPage, WebHtmlFormat, WebXml, WebSourceData, WebConsecutive, WebFirstRow, WebXl97, WebTextDates, WebXl2000, WebExtraAttributesXmlund WebChildrenXml

Text-Eigenschaften sind TextSourceFile, TextPrompt, TextDelimited, TextCodePage, TextFirstRow, TextCharacterSet, TextQualifier, TextFileType, TextDecimal, TextThousands, TextTab, TextSpace, TextComma, TextSemicolon, TextConsecutive, TextDelimiter, TextExtraAttributesXmlund TextChildrenXml; die Datenbankerhaltung verwendet DbExtraAttributesXml und DbChildrenXml

TXLSConnections.Assign kopiert eine Sammlung, IndexOfId findet eine stabile Verbindungskennung, und RootAttributesXml sowie UnknownChildrenXml erhalten nicht unterstützte Root-Inhalte

Verbindungsparameter

TXLSConnectionParameter verwendet Name, ParameterType, SqlType, RefreshOnChange, Prompt, CellReference, IntegerValue, DoubleValue, BooleanValue, StringValue, ValueKind, ExtraAttributesXmlund Assign

TXLSConnectionParameters stellt Add, AddExisting, Assign, Delete, Clear, Countund Items

Abfragetabellen und -felder

TXLSQueryTable uses Assign, ConnectionId, ResultTableNameverwendet 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, RefreshExtensionXml, UnknownChildrenXml, ExtraAttributesXml, RefreshExtraAttributesXmlund RefreshUnknownChildrenXml

TXLSQueryTableField verwendet Id, Name, TableColumnId, DataBound, RowNumbers, FillFormulas, Clipped, ExtraAttributesXmlund Assign, and Validate

TXLSQueryTableFields provides Add, AddExistingstellt Assign, FindById, FindByTableColumnId, NextId, Validate, Delete, Clear, Countund Itemsbereit; TXLSQueryTables.Assign kopiert die Abfragetabellen-Sammlung des Arbeitsblatts

Expliziter Query-Table-Refresh

Siehe automatische Abfrageprovider für expliziten Refresh ohne Caller-Provider, Registrierung, native Bindings und Grenzen externer Operationen

TXLSXWorksheet.RefreshQueryTable wählt eine vorhandene Query-Tabelle über Namen oder ihren nullbasierten Sammlungsindex und nimmt einen aufrufereigenen TXLSQueryTableProvider, ein positives AMaxRows-Limit mit dem Standard 1.000.000 Datenzeilen sowie einen optionalen TXLSQueryRefreshProgress-Callback entgegen

Implementieren Sie TXLSQueryTableProvider.Fetch(Connection, Query, MaxRows, out Data, var Abort), um einen TXLSQueryResultData-Datensatz mit ColumnCount und rechteckigen Rows aus skalaren Variant-Werten zurückzugeben; TXLSQueryResultRow ist ein Array aus Varianten, TXLSQueryResultRows ein Array dieser Zeilen; Zeilen schließen die vorhandenen Kopfzeilen aus und müssen die Zielbreite treffen — Zahlen, Datumswerte, Booleans, Strings, Fehler, leere Werte und Nullen behalten ihre Typen, und Strings mit führendem = bleiben literale Werte

Der Provider erhält entkoppelte Verbindungs- und Abfrage-Metadaten-Snapshots, die nur während des Aufrufs gültig sind, und muss das Zeilenlimit einhalten; die Bibliothek weist Überzählzeilen, gezackte Matrizen, nicht unterstützte Werttypen, invalide Breiten und Ergebnisse außerhalb des 1.048.576-Zeilen-mal-16.384-Spalten-Arbeitsblattrasters ohne Stutzung zurück

Der Refresh bewahrt vorhandene Kopfzeilen und Zellformatierung, leert den alten Datenschwanz eines schrumpfenden Ergebnisses, passt eine angehängte Excel-Tabelle und unterstützte Filter- oder Sortierbereiche in der Größe an, aktualisiert Query-Table-Metadaten und invalidiert abhängige Berechnungen; Formeln und Stile außerhalb des Ergebnisbereichs bleiben unverändert

Eine deaktivierte Abfrage, eine gelöschte Verbindung, sich überlappende verbundene Zellen oder Array-Formeln, eine andere Tabelle oder ein anderes Abfrageergebnis, belegte Erweiterungszellen, berechnete Tabellenspalten, Summenzeilen, Zeilennummern-Spalten, Fill-Formula-Verhalten oder ungebundene Spalten verhindern den Refresh, bevor Ergebniszellen geändert werden

Fortschritt wird vor dem Abrufen, vor dem Anwenden der Ergebnisse und nach jeder angewendeten oder geleerten Zeile gemeldet; setzen Sie Abort im Provider oder Progress-Callback zum Abbrechen — ein Rückgabewert von 1 bedeutet Erfolg, 0 Abbruch und -1 Fehler, mit den Diagnosecodes 1401 und 1400 für Abbruch und Fehler unter xlsOperationRefresh

Abbruch sowie Provider-, Validierungs- oder Callback-Ausnahmen stellen Ergebniszellen und Query- bzw. Tabellen-Metadaten wieder her, einschließlich vorhandener Zell-Handles; explizite Caller-Provider besitzen ihren externen Zugriff; die automatische Auswahl für unterstützte Windows-Text-, ADO-, ODBC- und Web-Abfragen ist über den Arbeitsmappen-Dispatcher verfügbar, und weder das Öffnen einer Arbeitsmappe noch das Bewahren von RefreshOnLoad-Metadaten ruft einen der beiden Provider-Pfade auf

XML-Zuordnungen und benutzerdefiniertes XML

TXLSXWorkbook.XmlMaps gibt TXLSXXmlMapszurück, und TXLSXWorksheet.XmlCellBindings gibt die Blattbindungs-Sammlung zurück

Erweiterte Klon-, HTML- und Bild-Elemente

TXLSXRangeClonePart, TXLSXRangeClonePartsund TXLSXRangeCloneSourceCounts definieren abhängigkeitsbewusstes Bereichsklonen. TXLSXWorksheet.CaptureRangeCloneSourceCounts, AuthorizeRepeatedDisjointRangeClones, ResizeTableRowsund TileRangeAxisMetadata sind erweiterte Hooks für strukturelle Bearbeitungen, die von der kompilierten Berichtserweiterung und benutzerdefinierten Teilnehmern verwendet werden

TXLSXHtmlExportSessionState beschreibt TXLSXHtmlExportSession; verwenden Sie BeginExport, ExportNextSheetund Resetund prüfen Sie dann State, Active, ExportedSheetCountund TotalSheetCount. Legen Sie TXLSXHtmlExportOptions.IncludeDrawings fest, um unterstützte Arbeitsblattobjekte in die HTML-Sitzung zu rendern

TXLSXImage legt Gamma, ShadowColor, ShadowOpacity, ShadowBlur, ShadowOffsetXund ShadowOffsetY für die gemeinsame PDF-, SVG-, HTML-, Bitmap- und Metadatei-Wiedergabe offen

Siehe auch

• XLSX-Fassaden-Übersicht
• Externe Arbeitsmappenverweise
• Kompilierte Berichts-API