NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

DataSet Members

Public:

Constructor

DataSet Constructor Overloaded. Initializes a new instance of the DataSet class.

Properties

CaseSensitive Gets or sets a value indicating whether string comparisons within DataTable objects are case-sensitive.
DataSetName Gets or sets the name of this DataSet.
DefaultView Gets a custom "view" of the data contained by the DataSet, one that allows filtering, searching, and navigating through the custom data view.
EnforceConstraints Gets or sets a value indicating whether constraint rules are followed when attempting any update operation.
ExtendedProperties Gets the collection of custom user information.
HasErrors Gets a value indicating whether there are errors in any of the rows in any of the tables of this DataSet.
Locale Gets or sets the locale information used to compare strings within the table.
Relations Get the collection of relations that link tables, and allow navigation from parent tables to child tables.
Site (inherited from Component) Gets or sets the site of the Component.
Tables Gets the collection of tables contained in the DataSet.
Xml Gets or sets the XML data for the DataSet.
XmlData Gets or sets the XML data for the DataSet.
XmlDocument Gets the XML document for the DataSet.
XmlSchema Gets or sets the XML schema of the DataSet.

Methods

AcceptChanges Commits all the changes made to this DataSet since it was loaded or the last time AcceptChanges was called.
Clear Clears the DataSet of any data by removing all rows in all tables.
Clone Clones the structure of the DataSet, including all DataTable schemas, relations, and constraints.
Copy Copies both the structure and data for this DataSet.
Dispose (inherited from Component) Disposes of the Component.
Equals (inherited from Object) Determines whether the specified Object is the same instance as the current Object. Subclasses are expected to override this method to support value equality (not reference equality).
GetChanges Overloaded. Returns a copy of the DataSet containing all changes made to it since it was last loaded, or since AcceptChanges was called.
GetChildRelations Gets the collection of child relations which belong to a specified table.
GetContainer (inherited from Component) Returns the IContainer that contains the Component.
GetDesignMode (inherited from Component) Gets a value indicating whether the Component is currently in design mode.
GetHashCode (inherited from Object) Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table.
GetParentRelations Gets the collection of parent relations which belong to a specified table.
GetServiceObject (inherited from Component) Returns an object representing a service provided by the Component.
GetType (inherited from Object) Gets the Type of the Object.
HasChanges Overloaded. Gets a value indicating whether the DataSet has changes, including new, deleted, or modified rows.
InferSchema Overloaded. Instructs the DataSet to infer a schema from a source.
LoadDiffGram Loads a specially formatted XML document that includes all changes, including before and after data, from a IDataReader.
Merge Overloaded. Merges this DataSet into a specified DataSet.
ReadDiffGram Overloaded. Reads a specially formatted XML document that includes all changes, including before and after data.
RejectChanges This method rolls back all the changes to have been made to this DataSet since it was loaded or the last time AcceptChanges was called. Any rows still in edit-mode cancel their edits. New rows get removed. Modified and Deleted rows return back to their original state.
ResetLocale Resets the Locale property to the current system locale.
ResetRelations Clears the collection of relations.
ResetTables [To be supplied.]
SaveDiffGram Saves a specially formatted XML document that includes all changes, including before and after data, to a specified TextWriter.
ShouldPersistLocale Indicates whether the locale property should be persisted. This is true if the user ever explicitly sets the locale property and doesn't call ResetLocale.
ShouldPersistRelations [To be supplied.]
ShouldPersistTables [To be supplied.]
ToString (inherited from Component) Returns a String containing the name of the Component, if any. This method should not be overridden. For internal use only.
WriteDiffGram Writes a specially formatted XML document that includes all changes, including before and after data, into the specfied XmlWriter.

Events

MergeFailed Occurs when attempting to merge schemas for two tables with the same name.
PropertyChanged Occurs when a property value changes.

Protected:

Methods

Finalize (inherited from Object) Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by the Garbage Collector (GC). This method may be ignored by the runtime; therefore, necessary cleanup operations should be done elsewhere.
MemberwiseClone (inherited from Object) Creates a shallow copy of the current Object.
OnPropertyChanged Raises the PropertyChanged event.
OnRemoveRelation This method should be overriden by subclasses to restrict tables being removed.
OnRemoveTable This method should be overriden by subclasses to restrict tables being removed.
RaisePropertyChanged Raises the property changed event. This creates the needed event data and then calls OnPropertyChanged.

Event Hookup:

Methods

AddOnMergeFailed Adds an event handler for the MergeFailed event.
AddOnPropertyChanged Adds an event handler for the OnPropertyChanged event.
RemoveOnMergeFailed Removes an event handler for the merge failed event. This event occurs when Merge failed for any reason.
RemoveOnPropertyChanged Removes an event handler for the property changed event. This event occurs when any property on the control has been changed for any reason.

See Also

DataSet Class | System.Data Namespace