Werkmapweergaven, verbindingen en XML-toewijzingen

Deze referentie behandelt bewerkbare werkmapmetagegevens die buiten het celraster liggen en consistent moeten blijven wanneer bladen, bereiken, filters en pakketonderdelen veranderen

Klassieke aangepaste weergaven

TXLSWorksheet.CustomViews retourneert TXLSCustomViews, waarvan de leden Count, Items, Invalidateen SyncToRaw getypeerde en onbekende records van aangepaste weergaven bewaren

TXLSCustomView stelt 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, PageSetupFlagsen HorizontalResolutionbeschikbaar VerticalResolution, HeaderMargin, FooterMargin, Copies, FilterFieldCount, FilterActive, FilterCriteria1, FilterCriteria2, FilterOperators, ClearFilterCriteria, RawRecordCount, RawRecordIds, and RawRecordData

TXLSCustomViewCellRange, TXLSCustomViewCellRanges, TXLSCustomViewSelectionInfo, TXLSCustomViewPageBreaken TXLSCustomViewPageBreaks dragen de selectie- en pagina-eindeladingen die eigendom van een weergave zijn

XLSX-werkmapvensters

TXLSXWorkbook.WorkbookViews beheert geordende TXLSXWorkbookView -items die door TXLSXWorkbookViewVisibility

Het invoegen, verwijderen en verplaatsen van bladen wijst in elk venster het actieve en eerst zichtbare tabblad opnieuw toe, terwijl onafhankelijke geometrie- en weergave-instellingen behouden blijven

Selecties per deelvenster

TXLSXWorksheet.Selections retourneert TXLSXSelections; TXLSXSelectionPane identificeert het doelvenster en elke TXLSXSelection slaat Pane, ActiveCell, ActiveCellIden uit meerdere gebieden bestaande Sqref

TXLSXSelection.Assign kopieert één selectie, terwijl TXLSXSelections.Add, AddSelection, Assign, Clear, Delete, IndexOfPane, Counten Items de geordende bladweergaveverzameling onderhouden

Verbindingssubmodellen

TXLSConnection bewaart database-, web-, tekst- en OLAP-metagegevens. Het webmodel gebruikt WebParsePre, WebHtmlTablesen WebTables; het vaste-tekstmodel gebruikt TextSourceFile en TextFields; het OLAP-model gebruikt HasOlapProperties, OlapLocal, OlapLocalConnection, OlapLocalRefresh, OlapSendLocale, OlapRowDrillCount, OlapServerFill, OlapServerNumberFormat, OlapServerFont, OlapServerFontColor, OlapExtraAttributesXmlen OlapChildrenXml

SourceFile slaat de verbindingsbron op het hoogste niveau op, terwijl TextSourceFile de onafhankelijke textPr -importbron opslaat; een lege TextSourceFile valt voor compatibiliteit terug op SourceFile for compatibility

TXLSWebTableSelectorKind configureert TXLSWebTableSelector, waarvan de leden Kind, Name, Index, ExtraAttributesXml, ChildrenXml, Assignen Validate benoemde, geïndexeerde en volledige-tabelselectors bewaren

TXLSWebTableSelectors biedt Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXmlen UnknownChildrenXml

TXLSTextImportFieldType configureert TXLSTextImportField, waarvan de leden FieldType, Position, ExtraAttributesXml, ChildrenXmlen Assignéén vast-tekstveld definiëren Validate members define one fixed-text field

TXLSTextImportFields biedt Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXmlen UnknownChildrenXml

Volledige verbindingsleden

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

De webeigenschappen zijn WebUrl, WebPost, WebEditPage, WebHtmlFormat, WebXml, WebSourceData, WebConsecutive, WebFirstRow, WebXl97, WebTextDates, WebXl2000, WebExtraAttributesXmlen WebChildrenXml

De teksteigenschappen zijn TextSourceFile, TextPrompt, TextDelimited, TextCodePage, TextFirstRow, TextCharacterSet, TextQualifier, TextFileType, TextDecimal, TextThousands, TextTab, TextSpace, TextComma, TextSemicolon, TextConsecutive, TextDelimiter, TextExtraAttributesXmlen TextChildrenXml; het behoud van databases gebruikt DbExtraAttributesXml en DbChildrenXml

TXLSConnections.Assign kopieert een verzameling, IndexOfId vindt een stabiele verbindingsidentificatie, en RootAttributesXml plus UnknownChildrenXml bewaren niet-ondersteunde inhoud van het hoofdniveau

Verbindingsparameters

TXLSConnectionParameter gebruikt Name, ParameterType, SqlType, RefreshOnChange, Prompt, CellReference, IntegerValue, DoubleValue, BooleanValue, StringValue, ValueKind, ExtraAttributesXmlen Assign

TXLSConnectionParameters biedt Add, AddExisting, Assign, Delete, Clear, Counten Items

Querytabellen en -velden

TXLSQueryTable gebruikt 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, RefreshExtensionXmlen UnknownChildrenXml, ExtraAttributesXml, RefreshExtraAttributesXml, and RefreshUnknownChildrenXml

TXLSQueryTableField uses Idgebruikt Name, TableColumnId, DataBound, RowNumbers, FillFormulas, Clipped, ExtraAttributesXml, Assignen Validate

TXLSQueryTableFields biedt Add, AddExisting, Assign, FindById, FindByTableColumnId, NextId, Validate, Deleteen Clear; Countkopieert de querytabelverzameling van het werkblad Items; TXLSQueryTables.Assign kopieert de collectie querytabellen van het werkblad

Expliciete querytabel-refresh

Zie automatische query-providers voor expliciete refresh zonder provider van de aanroeper, registratie, native bindings en limieten voor externe operaties

TXLSXWorksheet.RefreshQueryTable kiest een bestaande querytabel op naam of via zijn nulgebaseerde verzamelingsindex en accepteert een TXLSQueryTableProvider in beheer van de aanroeper, een positieve AMaxRows-limiet die standaard op 1.000.000 datarijen staat, en een optionele TXLSQueryRefreshProgress-callback

Implementeer TXLSQueryTableProvider.Fetch(Connection, Query, MaxRows, out Data, var Abort) om een TXLSQueryResultData-record terug te geven met ColumnCount en rechthoekige Rows van scalaire Variant-waarden; TXLSQueryResultRow is een array van variants en TXLSQueryResultRows is een array van die rijen; rijen sluiten de bestaande koppen uit en moeten de doelbreedte hebben, numerieke waarden, datums, Booleans, strings, fouten, lege waarden en nulls behouden hun typen, en strings die met = beginnen blijven letterlijke waarden

De provider ontvangt losse connection- en query-metadata-snapshots die alleen tijdens de aanroep geldig zijn en moet de rijlimiet respecteren; de bibliotheek wijst overtollige rijen, kartelige matrices, niet-ondersteunde waardetypen, ongeldige breedtes en resultaten buiten het raster van 1.048.576 rijen bij 16.384 kolommen af zonder af te kappen

Refresh behoudt bestaande koppen en celopmaak, ruimt de oude datastaart van een gekrompen resultaat op, herschaalt een gekoppelde Excel-tabel en ondersteunde filter- of sorteerbereiken, werkt querytabel-metadata bij en maakt afhankelijke berekeningen ongeldig; formules en stijlen buiten het resultaatgebied blijven ongewijzigd

Een uitgeschakelde query, verwijderde verbinding, overlappende samengevoegde cellen of array-formules, een andere tabel of queryresultaat, bezette expansiecellen, berekende tabelkolommen, totalenrijen, rijnummerkolommen, fill-formula-gedrag of niet-gebonden kolommen verhinderen de refresh voordat resultaatcellen veranderen

Voortgang wordt gerapporteerd vóór het ophalen, vóór het toepassen van resultaten en na elke toegepaste of gewiste rij; zet Abort in de provider of progress-callback om te annuleren, en een retourwaarde van 1 betekent succes, 0 annulering en -1 fout, met diagnostische codes 1401 en 1400 die respectievelijk annulering en fout identificeren onder xlsOperationRefresh

Annulering of provider-, validatie- of callback-exceptions herstellen resultaatcellen en query- of tabelmetadata, inclusief bestaande celhandles; expliciete providers van de aanroeper zijn eigenaar van hun externe toegang; automatische selectie voor ondersteunde Windows Text-, ADO-, ODBC- en Web-query's verloopt via de werkmapdispatcher, en het openen van een werkmap of het behouden van RefreshOnLoad-metadata roept geen van beide providerpaden aan

XML-toewijzingen en aangepaste XML

TXLSXWorkbook.XmlMaps retourneert TXLSXXmlMaps, en TXLSXWorksheet.XmlCellBindings retourneert de bladbindingverzameling

Geavanceerde clone-, HTML- en afbeeldingsleden

TXLSXRangeClonePart, TXLSXRangeClonePartsen TXLSXRangeCloneSourceCounts definiëren afhankelijkheidsbewust bereikklonen. TXLSXWorksheet.CaptureRangeCloneSourceCounts, AuthorizeRepeatedDisjointRangeClones, ResizeTableRowsen TileRangeAxisMetadata zijn geavanceerde hooks voor structurele bewerkingen die worden gebruikt door gecompileerde rapportexpansie en aangepaste deelnemers

TXLSXHtmlExportSessionState beschrijft TXLSXHtmlExportSession; gebruik BeginExport, ExportNextSheeten Reset, en inspecteer daarna State, Active, ExportedSheetCounten TotalSheetCount. Stel TXLSXHtmlExportOptions.IncludeDrawings in om ondersteunde werkmapobjecten in de HTML-sessie te renderen

TXLSXImage stelt Gamma, ShadowColor, ShadowOpacity, ShadowBlur, ShadowOffsetXen ShadowOffsetY beschikbaar voor gedeelde PDF-, SVG-, HTML-, bitmap- en metabestandsrendering

Zie ook

• Overzicht van de XLSX-facade
• Externe werkmapverwijzingen
• Gecompileerde rapportage-API