Click or drag to resize

DataTable Methods

The DataTable type exposes the following members.

Methods
 NameDescription
Protected methodAccumulateChangeData
(Inherited from SuspendableDocumentNodeWithSetOfEventArgs)
Protected methodAccumulatedChangeData_SetBackAfterResumeAndSuspend
(Inherited from SuspendableDocumentNodeWithSetOfEventArgs)
Protected methodAccumulatedEventData_Clear Clears the accumulated event data.
(Inherited from SuspendableDocumentNodeWithSetOfEventArgs)
Protected methodAccumulatedEventData_HasZeroOrOneEventArg Determines whether there is no or only one single event arg accumulated. If this is the case, the return value is true. If there is one event arg accumulated, it is returned in the argument singleEventArg. The return value is false if there is more than one event arg accumulated. In this case the singleEventArg is null on return, and the calling function should use AccumulatedEventData to enumerate all accumulated event args.
(Inherited from SuspendableDocumentNodeWithSetOfEventArgs)
Public methodAppendAllColumnsWithSpace Appends data columns from DataTable src to the data in this table leaving some rows free inbetween.
Public methodAppendAllDataColumns Appends data columns from DataTable src to the data in this table.
Public methodAppendAllDataColumnsToPosition Appends data columns from DataTable src to the data in this table by copying the new data to a specified row.
Public methodChangeColumnPosition Moves the selected columns along with their corresponding property values to a new position.
Protected methodChildCloneFromT Clones a node that is intended to use as child node of this instance (e.g. in collections). Consider using ChildCloneToMemberT(T, T) instead if the child node is stored in a member of this instance.
(Inherited from SuspendableDocumentNode)
Protected methodChildCloneToMemberT Sets a member variable that holds a child with a cloned instance of another variable. If an old instance member (provided in myChild exists and can not be used, it is disposed first. The node is then cloned using System.ICloneable. The resulting node's ParentObject is then set to this instance in order to maintain the parent-child relationship.
(Inherited from SuspendableDocumentNode)
Protected methodChildCloneToMemberAltT Set a member variable that holds a child node of this instance. The child node may or may not implement IDocumentLeafNode. The value to set may or may not implement ICloneable. If it implements ICloneable, then the member variable is set to a clone of the value. Otherwise, the member variable is set directly with the value. It helps to ensure the correct order: first, the child node is set to the new instance and then the old child node is disposed.
(Inherited from SuspendableDocumentNode)
Protected methodChildCopyToMemberT Copies a document node from another source into a member of this instance. If an old instance member (provided in myChild exists and can not be used, it is disposed first. The node is then copied using either Main.ICopyFrom or System.ICloneable. The resulting node's ParentObject is then set to this instance in order to maintain the parent-child relationship.
(Inherited from SuspendableDocumentNode)
Protected methodChildCopyToMemberOrCreateNewT Copies a document node from another source into a member of this instance. If an old instance member (provided in myChild exists and can not be used, it is disposed first. If the node is not null, the node is then copied using either Main.ICopyFrom or System.ICloneable. If the node is null, a new node is created using the provided generation function. The resulting node's ParentObject is then set to this instance in order to maintain the parent-child relationship.
(Inherited from SuspendableDocumentNode)
Protected methodChildDisposeMemberT Helper function to dispose a child node of this instance. It helps to ensure the correct order: first, the child node is set to null and only then the child node is disposed.
(Inherited from SuspendableDocumentNodeBase)
Protected methodChildSetMemberT Set a member variable that holds a child node of this instance. It helps to ensure the correct order: first, the child node is set to the new instance and then the old child node is disposed.
(Inherited from SuspendableDocumentNode)
Protected methodChildSetMemberAltT Set a member variable that holds a child node of this instance. The child node may or may not implement IDocumentLeafNode. It helps to ensure the correct order: first, the child node is set to the new instance and then the old child node is disposed.
(Inherited from SuspendableDocumentNode)
Public methodClone Clones the table.
Public methodContainsColumn Tests if the table contains a data column with the provided name.
Public methodContainsDataColumn Tests if the table contains a data column with the provided name.
Public methodContainsPropertyColumn Tests if the table contains a property column with the provided name.
Public methodCopyDataAndPropertyColumnsFrom(DataTable) Deletes all data and property columns in the table, and then copy all data and property columns from the source table.
Public methodCopyDataAndPropertyColumnsFrom(DataTable, Boolean, Boolean) Deletes all data and property columns in the table, and then copy all data and property columns, from the source table. As you can specify, this can be done with or without the data.
Public methodCopyDataColumnsFrom Deletes all data columns in the table, and then copy all data columns from the source table.
Public methodCopyOrReplaceOrAdd Copies data to the data column with the provided index if both columns are of the same type. If they are not of the same type, the column is replaced by the provided column. If the index is beyoind the limit, the provided column is added.
Public methodCountEvent Counts the number of events during the suspend state. Every call to this function will increment the event counter by 1 (but only in the suspended state). The event counter will be reset to zero when the object is resumed.
(Inherited from SuspendableDocumentNode)
Public methodDispose Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
(Inherited from SuspendableDocumentNodeBase)
Protected methodDispose(Boolean)
(Inherited from SuspendableDocumentNode)
Public methodEhChildChanged Used by childs of this object to inform us about a change in their state.
(Inherited from SuspendableDocumentNode)
Public methodEhParentTunnelingEventHappened Is called by the parent when a tunneling event happened in the parent.
(Inherited from SuspendableDocumentNode)
Protected methodEhSelfChanged Called if some (simple) member or property of this instance itself has changed.
(Inherited from SuspendableDocumentNode)
Public methodEhSelfTunnelingEventHappened(TunnelingEventArgs) Is called by this instance if a tunneling event happened into this instance. The tunneling event triggers the TunneledEvent and is additionally distributed to all childs of this instance.
(Inherited from SuspendableDocumentNodeBase)
Public methodEhSelfTunnelingEventHappened(TunnelingEventArgs, Boolean) Is called by this instance if a tunneling event happened into this instance. The tunneling event triggers the TunneledEvent and is - depending on the provided parameter - also distributed to all childs of this instance.
(Inherited from SuspendableDocumentNode)
Public methodEnumerateFromHereToLeaves Enumerates all document node including this node, its child nodes, its child-child nodes up to the leaf nodes.
(Inherited from SuspendableDocumentNode)
Public methodEqualsDetermines whether the specified object is equal to the current object.
(Inherited from Object)
Protected methodFinalize Finalizes an instance of the SuspendableDocumentNodeBase class.
(Inherited from SuspendableDocumentNodeBase)
Public methodGetChildObjectNamed Retrieves the child node of this instance with the name
C#
name
.
(Inherited from SuspendableDocumentNode)
Protected methodGetDocumentNodeChildrenWithName
(Overrides SuspendableDocumentNodeGetDocumentNodeChildrenWithName)
Public methodGetHashCodeServes as the default hash function.
(Inherited from Object)
Public methodGetNameOfChildObject Gets the name of child node.
(Inherited from SuspendableDocumentNode)
Public methodStatic memberGetParentDataTableOf(DataColumn) Gets the parent data table of the DataColumn column.
Public methodStatic memberGetParentDataTableOf(DataColumnCollection) Get the parent data table of a DataColumnCollection.
Public methodStatic memberGetParentDataTableOf(IDocumentLeafNode) Gets the parent data table of a child object.
Public methodGetTableProperty Gets an arbitrary object that was stored as table property by SetTableProperty(String, Object).
Public methodGetTypeGets the Type of the current instance.
(Inherited from Object)
Protected methodHandleHighPriorityChildChangeCases Handles the case when a child changes, and a reaction is neccessary independently on the suspend state of the table.
(Inherited from SuspendableDocumentNode)
Protected methodHandleLowPriorityChildChangeCases Processes the event args e when this object is not suspended. This function serves two purposes: i) updating some cached data of this object by processing the event args of the child, and ii) optional transforming the event args, for instance to a new type, which afterwards is send to the parent and is used as event args in the [E:Changed] event of this object. The transformed event args is not used if this object is suspended (in this case the original event args is used).
(Inherited from SuspendableDocumentNode)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object.
(Inherited from Object)
Protected methodNotifyChildrenTunnelingEventHappened Notifies the child nodes of this instance that a tunneling event has happened.
(Inherited from SuspendableDocumentNode)
Protected methodOnAboutToBeResumed
(Overrides SuspendableDocumentNodeOnAboutToBeResumed(Int32))
Protected methodOnChanged Fires the change event with the EventArgs provided in the argument.
(Overrides SuspendableDocumentNodeBaseOnChanged(EventArgs))
Protected methodOnNameChanged Fires both a Changed and a TunnelingEvent when the name has changed. The event arg of the Changed event is an instance of NamedObjectCollectionChangedEventArgs. The event arg of the Tunneling event is an instance of DocumentPathChangedEventArgs.
Protected methodOnResume Is called when the object is resumed, i.e. change notifications are allowed again. During the execution of this function, the [P:IsResumeInProgress] property will return true to indicate that the resume is currently in progress.
(Inherited from SuspendableDocumentNode)
Protected methodOnResumeSilently Is called when the suspend level falls down from 1 to zero by a call to ResumeSilently. This implementation disarma the suspendTokens of the childs of this object, deletes any accumulated events, and does not send any change event to the parent or the listeners of the Change event.
(Inherited from SuspendableDocumentNode)
Protected methodOnSuspended Called when the suspend level has just gone from 0 to 1, i.e. the object was suspended.
(Inherited from SuspendableDocumentNode)
Protected methodOnTunnelingEvent Fires the TunneledEvent event.
(Inherited from SuspendableDocumentNodeBase)
Public methodRemoveColumns(IAscendingIntegerCollection) Remove the selected data columns and the corresponding property rows.
Public methodRemoveColumns(Int32, Int32) Remove the data columns and the corresponding property rows beginning at index nFirstColumn.
Public methodRemoveTableProperty Remove a table property, key is a string
Public methodResume(ISuspendToken) Resumes changed events by calling Resume for the provided suspend token, and setting the reference to the suspend token to null. If Event data were accumulated during the suspended state, a changed event is triggered for each event data.
(Inherited from SuspendableDocumentNodeBase)
Public methodResume(ISuspendToken, EventFiring) Resumes changed events, either with taking the accumulated event data into account (see Resume(ISuspendToken)) or discarding the accumulated event data (see ResumeSilently(ISuspendToken), depending on the provided argument eventFiring.
(Inherited from SuspendableDocumentNodeBase)
Public methodResumeCompleteTemporarily Resumes the object completely for only a short time. Thus, if object was suspended before, it will be suspended again when the function returns.
(Inherited from SuspendableDocumentNode)
Public methodResumeCompleteTemporarilyGetToken Resumes the object completely for the time the returned token is referenced and not disposed. The return value is a token that had 'absorbed' the suspend count of the object, resulting in the suspend count of the object dropped to 0 (zero). When the returned token is finally disposed, the suspend count of the object is increased again by the 'absorbed' suspend count.
(Inherited from SuspendableDocumentNode)
Public methodResumeSilently Resumes changed events by calling Resume for the provided suspend token, and setting the reference to the suspend token to null. All event data accumulated during the suspended state are discarded, and thus no change event is triggered even if the instance has changed during the suspended state.
(Inherited from SuspendableDocumentNodeBase)
Public methodSetDisposeInProgress Sets the flag that dispose is in progress for this node and all child nodes recursively.
(Inherited from SuspendableDocumentNode)
Protected methodSetMemberAndRaiseSelfChangedT(NullableT, NullableT) Sets a member variable of this instance and raise a change event with Empty if the new value is different from the old value. The comparison is done using the IEquatableT interface of the member variable. Note: to set members that implement IDocumentNode please use the Child... functions.
(Inherited from SuspendableDocumentNodeBase)
Protected methodSetMemberAndRaiseSelfChangedT(T, T) Sets a member variable of this instance and raise a change event with Empty if the new value is different from the old value. The comparison is done using the IEquatableT interface of the member variable. Note: to set members that implement IDocumentNode please use the Child... functions.
(Inherited from SuspendableDocumentNodeBase)
Protected methodSetMemberEnumAndRaiseSelfChangedT Sets a member variable (which is an Enum) of this instance and raise a change event with Empty if the new value is different from the old value. The comparison is done using the IEquatableT interface of the member variable. Note: to set members that implement IDocumentNode please use the Child... functions.
(Inherited from SuspendableDocumentNodeBase)
Public methodSetTableProperty The table properties, key is a string, val is a object you want to store here.
Public methodSuspendGetToken Suspend will increase the SuspendLevel.
(Inherited from SuspendableDocumentNode)
Public methodToStringReturns a string that represents the current object.
(Inherited from Object)
Public methodTryGetName Tests if this item already has a name.
(Overrides SuspendableDocumentNodeBaseTryGetName(String))
Public methodUpdateTableFromTableDataSource Updates the data in the table from the table data source. If the options specify that the worksheet script should be exectuted after this, it is executed then. The table is locked during the operation, and the exceptions will be catched. Use the return result to see if an error has occured.
Public methodUpdateTableFromTableDataSourceAsUserCancellable Updates the data in the table from the table data source. If the options specify that the worksheet script should be exectuted after this, it is executed then. The table is locked during the operation, and the exceptions will be catched. Use the return result to see if an error has occured.
Public methodVisitDocumentReferences Has to enumerate all references to other items in the project (DocNodeProxy) which are used in this project item and in all childs of this project item. The references has to be reported to the ProxyProcessing function. This function is responsible for processing of the proxies, for instance to relocated the path.
Top
Extension Methods
 NameDescription
Public Extension MethodAddDataColumnsWithPropertiesFrom Adds to the destination table selected columns from another table. Additionally, the properties of those columns will be added to the destination table.
(Defined by MergeTables)
Public Extension MethodAddStandardColumns
(Defined by DataTableCommands)
Public Extension MethodChangeRowsToPropertyColumns Copies selected rows into newly created property columns and deletes the rows afterwards.
(Defined by RowCommands)
Public Extension MethodCreateHistogramOnColumns Calculates statistics of selected columns. Returns a new table where the statistical data will be written to.
(Defined by HistogramCreation)
Public Extension MethodDoMakeActionWithoutDialog Creates a matrix from three selected columns. This must be a x-column, a y-column, and a value column.
(Defined by ConvertXYVToMatrixActions)
Public Extension MethodDoStatisticsOnColumns Calculates statistics of selected columns. Returns a new table where the statistical data will be written to.
(Defined by Statistics)
Public Extension MethodDoStatisticsOnRows Calculates statistics of selected columns. Creates a new table where the statistical data will be written to.
(Defined by Statistics)
Public Extension MethodGetProjectFolderPropertyDocuments Gets the project folder property documents down the project folder hierarchie.
(Defined by PropertyExtensions)
Public Extension MethodGetPropertyBags Gets the property bags in the hierarchy. The first bag in the enumeration is the bag that owns the owner. Then the bags of the folders in which the owner is located, its parent folders, and then UserSettings, ApplicationSettings, and BuiltinSettings follow.
(Defined by PropertyExtensions)
Public Extension MethodGetPropertyContext Gets the property context of the document node. If the provided node is not implementing IPropertyBagOwner, the parent nodes of this node are searched, until a node which implements IPropertyBagOwner is found.
(Defined by PropertyExtensions)
Public Extension MethodGetPropertyHierarchy Gets the property bags in the hierarchal order. The first bag in the enumeration is the bag that owns the owner. Then the bags of the folders in which the owner is located, its parent folders, and then UserSettings, ApplicationSettings, and BuiltinSettings follow.
(Defined by PropertyExtensions)
Public Extension MethodGetPropertyValueT Gets the property value. The property is searched in the provided owner, then in the containing folder, and then the hierarchy down to the built-in property bag.
(Defined by PropertyExtensions)
Public Extension MethodGetPropertyValueT Gets the property value. The property is searched in the provided owner, then in the containing folder, and then the hierarchy down to the built-in property bag.
(Defined by PropertyExtensions)
Public Extension MethodImportAscii Imports Ascii data from a stream into the data table.
(Defined by FileCommands)
Public Extension MethodImportAsciiToSingleWorksheetHorizontally Imports multiple Ascii files into a single data table, horizontally, i.e. in subsequent columns.
(Defined by FileCommands)
Public Extension MethodImportAsciiToSingleWorksheetVertically Imports multiple Ascii files into a single data table, vertically, i.e. in subsequent rows.
(Defined by FileCommands)
Public Extension MethodImportFromAsciiFile Imports from an ASCII file into an existing table.
(Defined by AsciiImporter)
Public Extension MethodImportFromAsciiFile Imports from an ASCII file into an existing table. The import options have to be known already.
(Defined by AsciiImporter)
Public Extension MethodImportFromAsciiFile Imports from an ASCII file into an existing table.
(Defined by AsciiImporter)
Public Extension MethodImportFromAsciiStream Imports Ascii data from a stream into the data table.
(Defined by AsciiImporter)
Public Extension MethodImportFromAsciiStream Imports an Ascii stream into a table. The import options have to be known already.
(Defined by AsciiImporter)
Public Extension MethodImportFromAsciiStream Imports Ascii data from a stream into the data table.
(Defined by AsciiImporter)
Public Extension MethodImportFromAsciiText Imports from an ASCII text provided as string into an existing table.
(Defined by AsciiImporter)
Public Extension MethodImportFromAsciiText Imports from an ASCII text provided as string into an existing table. The import options have to be known already.
(Defined by AsciiImporter)
Public Extension MethodImportFromAsciiText Imports from an ASCII text provided as string into an existing table.
(Defined by AsciiImporter)
Public Extension MethodMergeTable Merges two tables by fractional index.
(Defined by MergeTables)
Public Extension MethodMergeTable Merges two tables by corresponding x-columns.
(Defined by MergeTables)
Public Extension MethodSetColumnGroupNumber
(Defined by ColumnCommands)
Public Extension MethodShowActionDialog
(Defined by ConvertXYVToMatrixActions)
Public Extension MethodShowDecomposeByColumnContentDialog
(Defined by DecomposeByColumnContentActions)
Public Extension MethodShowExpandCyclingVariableColumnDialog
(Defined by ExpandCyclingVariableColumnActions)
Public Extension MethodShowExportAsciiDialog Asks for a file name and exports the table data into that file as Ascii.
(Defined by FileCommands)
Public Extension MethodShowExportGalacticSPCDialog Shows the dialog for Galactic SPC file export, and exports the data of the table using the options provided in that dialog.
(Defined by FileCommands)
Public Extension MethodShowImportAsciiDialog Asks for file name(s) and imports the file(s) into multiple worksheets.
(Defined by FileCommands)
Public Extension MethodShowImportAsciiDialog Asks for file name(s) and imports the file(s) into one or multiple worksheets.
(Defined by FileCommands)
Public Extension MethodShowImportAsciiDialogAndOptions Asks for file name(s) and imports the file(s) into multiple worksheets.
(Defined by FileCommands)
Public Extension MethodShowImportAsciiDialogAndOptions Asks for file name(s) and imports the file(s) into one or multiple worksheets. After the user chooses one or multiple files, one of the chosen files is used for analysis. The result of the structure analysis of this file is then presented to the user. The user may change some of the options and starts a re-analysis. Finally, the import options are confirmed by the user and the import process can start.
(Defined by FileCommands)
Public Extension MethodShowImportDatabaseDialog
(Defined by DatabaseCommands)
Public Extension MethodShowImportGalacticSPCDialog Asks for file names, and imports one or more Galactic SPC files into a single data table.
(Defined by FileCommands)
Public Extension MethodShowImportImageDialog Asks for a file name of an image file, and imports the image data into a data table.
(Defined by FileCommands)
Public Extension MethodShowImportJcampDialog Asks for file names, and imports one or more Jcamp files into a single data table.
(Defined by FileCommands)
Public Extension MethodShowImportRenishawWdfDialog Asks for file names, and imports one or more Renishaw .wdf files (Raman spectroscopy) into a single data table.
(Defined by FileCommands)
Public Extension MethodShowPropertyDialog Shows the property dialog for this data table.
(Defined by WorksheetCommands)
Public Extension MethodShowRenameDialog Shows a dialog to rename the table.
(Defined by DataTableOtherActions)
Public Extension MethodShowSetColumnGroupNumberDialog Sets the group number of the selected column
(Defined by ColumnCommands)
Public Extension MethodSortDataColumnsByPropertyColumn Sort the order of the data columns (not rows!) of a table based on a specified property column. The relationship of property data to data columns is maintained.
(Defined by Sorting)
Public Extension MethodSortDataColumnsByPropertyColumn Sort the order of the data columns (not rows!) of a table based on a specified property column. The relationship of property data to data columns is maintained.
(Defined by Sorting)
Public Extension MethodSortDataRows Sorts the data rows of a table (more accurate: of all columns belonging to a column group, see below), using the data of column col to determine the order.
(Defined by Sorting)
Public Extension MethodSortDataRows Sorts the data rows of a table (more accurate: of all columns belonging to a column group, see below), using multiple specified column.
(Defined by Sorting)
Public Extension MethodTranspose Transpose transpose the table, i.e. exchange columns and rows this can only work if all columns in the table are of the same type
(Defined by Transposing)
Public Extension MethodTransposeIsPossible Tests if the transpose of a table is possible.
(Defined by Transposing)
Public Extension MethodTryImportFromMultipleAsciiFilesHorizontally Imports multiple Ascii files into the provided table in horizontal order, i.e. in new columns. The provided importOptions are used to import the files. The first column of each file is considered to be the x-column, and if they match another x-column, the newly imported columns will get the same column group.
(Defined by AsciiImporter)
Public Extension MethodTryImportFromMultipleAsciiFilesHorizontally Imports multiple Ascii files into the provided table in horizontal order, i.e. in new columns. The import options are determined from the first file, and then used to import all other files. The first column of each file is considered to be the x-column, and if they match another x-column, the newly imported columns will get the same column group.
(Defined by AsciiImporter)
Public Extension MethodTryImportFromMultipleAsciiFilesHorizontally Imports multiple Ascii files into the provided table in horizontal order, i.e. in new columns. Depending on the value of determineImportOptionsSeparatelyForEachFile, the import options are either deterimined from the first file and then used for all other files, or determined separately for each file. The first column of each file is considered to be the x-column, and if they match another x-column, the newly imported columns will get the same column group.
(Defined by AsciiImporter)
Public Extension MethodTryImportFromMultipleAsciiFilesVertically Imports multiple Ascii files into the provided table in vertical order, i.e. in new rows. The provided importOptions are used to import the files. If the names of the subsequently imported table columns match, the data will be written in the matching column. Otherwise new columns with the unmatched column names were created. Property columns will only be imported from the first table.
(Defined by AsciiImporter)
Public Extension MethodTryImportFromMultipleAsciiFilesVertically Imports multiple Ascii files into the provided table in vertical order, i.e. in new rows.. The import options are determined from the first file, and then used to import all other files. If the names of the subsequently imported table columns match, the data will be written in the matching column. Otherwise new columns with the unmatched column names were created. Property columns will only be imported from the first table.
(Defined by AsciiImporter)
Public Extension MethodTryImportFromMultipleAsciiFilesVertically Imports multiple Ascii files into the provided table in vertical order, i.e. in new rows.. Depending on the value of determineImportOptionsSeparatelyForEachFile, the import options are either deterimined from the first file and then used for all other files, or determined separately for each file. If the names of the subsequently imported table columns match, the data will be written in the matching column. Otherwise new columns with the unmatched column names were created. Property columns will only be imported from the first table.
(Defined by AsciiImporter)
Top
See Also