Arbetsboksryer, anslutningar och XML Maps

Denna referens täcker redigerbar arbetsboksmetadata som ligger utanför cellrutnätet och som måste förbli konsekvent när blad, intervall, filter och paketdelar ändras

Klassiska anpassade vyer

TXLSWorksheet.CustomViews returnerar TXLSCustomViews, vars Count, Items, Invalidateoch SyncToRaw -medlemmar bevarar typsatta och okända poster för anpassade vyer

TXLSCustomView exposes ViewId, Zoom, GridColorIndex, ActivePane, ShowPageBreaks, ShowFormulas, ShowGridLines, ShowHeadings, ShowOutlineSymbols, ShowZeroValues, CenterHorizontally, CenterVertically, PrintHeadingsexponerar 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, RawRecordIdsoch RawRecordData

TXLSCustomViewCellRange, TXLSCustomViewCellRanges, TXLSCustomViewSelectionInfo, TXLSCustomViewPageBreakoch TXLSCustomViewPageBreaks bär de markeringar och sidbrytningsnyttolaster som ägs av en vy

XLSX-arbetsboksfönster

TXLSXWorkbook.WorkbookViews äger ordnade TXLSXWorkbookView -poster som konfigureras av TXLSXWorkbookViewVisibility

Bladinfogning, -radering och -förflyttning mappar om varje fönsters aktiva och först synliga flik samtidigt som oberoende geometri och visningsinställningar bevaras

Markeringar per ruta

TXLSXWorksheet.Selections returnerar TXLSXSelections; TXLSXSelectionPane identifierar målrutan och varje TXLSXSelection lagrar Pane, ActiveCell, ActiveCellIdoch multi-områdes- Sqref

TXLSXSelection.Assign kopierar en markering, medan TXLSXSelections.Add, AddSelection, Assign, Clear, Delete, IndexOfPane, Countoch Items underhåller den ordnade bladvy-samlingen

Delmodeller för anslutningar

TXLSConnection bevarar metadata för databas, webb, text och OLAP. Dess webbmodell använder WebParsePre, WebHtmlTablesoch WebTables; dess fasttextmodell använder TextSourceFile och TextFields; dess OLAP-modell använder HasOlapProperties, OlapLocal, OlapLocalConnection, OlapLocalRefresh, OlapSendLocale, OlapRowDrillCount, OlapServerFill, OlapServerNumberFormat, OlapServerFont, OlapServerFontColor, OlapExtraAttributesXmloch OlapChildrenXml

SourceFile lagrar den överordnade anslutningskällan medan TextSourceFile lagrar den oberoende textPr -importkällan; en tom TextSourceFile faller tillbaka till SourceFile för kompatibilitet

TXLSWebTableSelectorKind konfigurerar TXLSWebTableSelector, vars Kind, Name, Index, ExtraAttributesXml, ChildrenXml, Assignoch Validate -medlemmar bevarar namngivna, indexerade och kompletta tabellväljare

TXLSWebTableSelectors tillhandahåller Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXmloch UnknownChildrenXml

TXLSTextImportFieldType configures TXLSTextImportFieldkonfigurerar FieldType, vars Position, ExtraAttributesXml, ChildrenXml, Assignoch Validate -medlemmar definierar ett fasttextfält

TXLSTextImportFields tillhandahåller Add, AddExisting, Assign, Validate, Delete, Clear, Count, Items, ExtraAttributesXmloch UnknownChildrenXml

Kompletta anslutningsmedlemmar

TXLSConnection vanliga egenskaper är Id, TypeCode, SourceFile, OdcFile, SingleSignOnId, KeepAlive, Interval, BackgroundRefresh, RefreshOnLoad, SaveData, SavePassword, NewConnection, Deleted, OnlyUseConnectionFile, ReconnectionMethod, RefreshedVersion, MinRefreshableVersion, ConnectionString, CommandText, ServerCommandText, CommandType, Parametersoch ExtensionXml

Webbegenskaper är WebUrl, WebPost, WebEditPage, WebHtmlFormat, WebXml, WebSourceData, WebConsecutive, WebFirstRow, WebXl97, WebTextDates, WebXl2000, WebExtraAttributesXmloch WebChildrenXml

Textegenskaper är TextSourceFile, TextPrompt, TextDelimited, TextCodePage, TextFirstRow, TextCharacterSet, TextQualifier, TextFileType, TextDecimal, TextThousands, TextTab, TextSpace, TextComma, TextSemicolon, TextConsecutive, TextDelimiter, TextExtraAttributesXmloch TextChildrenXml; databasbevarande använder DbExtraAttributesXml och DbChildrenXml

TXLSConnections.Assign kopierar en samling, IndexOfId hittar en stabil anslutningsidentifierare, och RootAttributesXml plus UnknownChildrenXml bevarar ostött rotinnehåll

Anslutningsparametrar

TXLSConnectionParameter använder Name, ParameterType, SqlType, RefreshOnChange, Prompt, CellReference, IntegerValue, DoubleValue, BooleanValue, StringValue, ValueKind, ExtraAttributesXmloch Assign

TXLSConnectionParameters tillhandahåller Add, AddExisting, Assign, Delete, Clear, Countoch Items

Frågetabeller och fält

TXLSQueryTable använder 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, RefreshExtensionXmloch UnknownChildrenXml, ExtraAttributesXml, RefreshExtraAttributesXml, and RefreshUnknownChildrenXml

TXLSQueryTableField uses Idanvänder Name, TableColumnId, DataBound, RowNumbers, FillFormulas, Clipped, ExtraAttributesXml, Assignoch Validate

TXLSQueryTableFields tillhandahåller Add, AddExisting, Assign, FindById, FindByTableColumnId, NextId, Validate, Deleteoch Clear; Countkopierar arbetsbladets frågetabellsamling Items; TXLSQueryTables.Assign kopierar kalkylbladets samling av frågetabeller

Explicit uppdatering av frågetabeller

Se automatiska frågeproviders för explicit uppdatering utan en anroparprovider, registrering, inbyggda bindningar och gränser för externa operationer

TXLSXWorksheet.RefreshQueryTable väljer en befintlig frågetabell efter namn eller dess nollbaserade samlingsindex och accepterar en anroparägd TXLSQueryTableProvider, en positiv gräns AMaxRows som har 1 000 000 datarader som standard, samt en valfri återanropsfunktionen TXLSQueryRefreshProgress

Implementera TXLSQueryTableProvider.Fetch(Connection, Query, MaxRows, out Data, var Abort) så att den returnerar en TXLSQueryResultData-post med ColumnCount och rektangulära Rows av skalära Variant-värden; TXLSQueryResultRow är en matris av variants och TXLSQueryResultRows en matris av de raderna; raderna utesluter befintliga rubriker och måste matcha målbredden, numeriska värden, datum, booleska värden, strängar, fel, tomma värden och null behåller sina typer, och strängar som börjar med = förblir literala värden

Providern tar emot fristående ögonblicksbilder av anslutnings- och frågemetadata som bara är giltiga under anropet och måste respektera radgränsen; biblioteket avvisar överflödiga rader, ojämna matriser, värdetyper som inte stöds, ogiltiga bredder och resultat utanför rutnätet på 1 048 576 rader gånger 16 384 kolumner, utan trunkering

Uppdateringen bevarar befintliga rubriker och cellformatering, rensar en krympande results gamla datasvans, storleksanpassar en bifogad Excel-tabell och stödda filter- eller sorteringsområden, uppdaterar frågetabellmetadata och ogiltigförklarar beroende beräkningar; formler och stilar utanför resultatområdet förblir oförändrade

En inaktiverad fråga, en borttagen anslutning, överlappande sammanslagna celler eller matrisformler, en annan tabell eller ett annat frågeresultat, upptagna expansionsceller, beräknade tabellkolumner, totalsrader, radnummerkolumner, beteende för fyllnad av formler eller obundna kolumner förhindrar uppdateringen innan resultatcellerna ändras

Progress rapporteras innan hämtning, innan resultaten tillämpas och efter varje tillämpad eller rensad rad; sätt Abort i providern eller progress-återanropet för att avbryta, och ett returvärde på 1 anger framgång, 0 avbrott och -1 fel, med diagnostikkoderna 1401 och 1400 som identifierar avbrott respektive fel under xlsOperationRefresh

Avbrott eller undantag i provider, validering eller återanrop återställer resultatceller och metadata för fråga eller tabell, inklusive befintliga cellhandtag; explicita anroparproviders äger sin externa åtkomst; automatiskt val av stödda Windows-text-, ADO-, ODBC- och webbfrågor är tillgängligt via arbetsbokens dispatcher, och att öppna en arbetsbok eller bevara RefreshOnLoad-metadata anropar inte någon av provider-vägarna

XML Maps och anpassad XML

TXLSXWorkbook.XmlMaps returnerar TXLSXXmlMaps, och TXLSXWorksheet.XmlCellBindings returnerar bladets bindningssamling

Avancerade medlemmar för kloning, HTML och bilder

TXLSXRangeClonePart, TXLSXRangeClonePartsoch TXLSXRangeCloneSourceCounts definierar beroendemedveten intervallkloning. TXLSXWorksheet.CaptureRangeCloneSourceCounts, AuthorizeRepeatedDisjointRangeClones, ResizeTableRowsoch TileRangeAxisMetadata är avancerade strukturella redigeringskrokar som används av kompilerad rapportexpansion och anpassade deltagare

TXLSXHtmlExportSessionState beskriver TXLSXHtmlExportSession; använd BeginExport, ExportNextSheetoch Reset, inspektera sedan State, Active, ExportedSheetCountoch TotalSheetCount. Ställ in TXLSXHtmlExportOptions.IncludeDrawings för att rendera stödda arbetsbladsobjekt i HTML-sessionen

TXLSXImage exponerar Gamma, ShadowColor, ShadowOpacity, ShadowBlur, ShadowOffsetXoch ShadowOffsetY för delad PDF-, SVG-, HTML-, bitmapps- och metafilrendering

Se även

• Översikt över XLSX-fasad
• Externa arbetsboksreferenser
• API för kompilerad rapportering