Infragistics2.Win.UltraWinDataSource.v9.2 Returns the localized category name Name of the category to retreive The localized string value Return the list of products that this control can be licensed with Controls class loading and mandates what class to load. Controls the binding of a serialized object to a type Specifies the Assembly name of the serialized object Specifies the Type name of the serialized object. The type of the object the formatter creates a new instance of. Uniquely identifies each UltraDataSource event. Event id that identifies event. Event id that identifies event. Event id that identifies event. Event id that identifies event. Event id that identifies event. Event id that identifies event. Event id that identifies event. Event id that identifies event. Event id that identifies event. Event id that identifies event. Event id that identifies event. Event id that identifies event. Keep the last event id used. Identifies groups of UltraDataSource specific events. All events Before events After events Uniquely identify each property. property property property Item was added to the collection Item was removed to the collection Collection was cleared property property property property property property property Class for managing an UltraDataSource' events. It maintains an enabled flag for each event as well as a nested 'in progress' count and it exposes methods for firing each event. Contructor. UltraDataSource that this event manager will be asociated with. Returns true if the event is in progress (in progress count > 0) The id of the event true if the event is in progress; otherwise, false. Returns true if the event is enabled The id of the event. true if the event is enabled; otherwise, false. Sets a specific event to enabled or disabled. Returns true if all events in the group are enabled The id of the events. true if the event group is enabled; otherwise, false. Sets a specific event to enabled or disabled The id of the event. True to enable the firing of the events, false to disable. Delegate for event. Delegate for event. Delegate for event. Delegate for event. Delegate for event. Delegate for event. Delegate for event. Delegate for event. Delegate for event. Delegate for event. Delegate for event. Delegate for event. Base class for event args that have an associated row. Constructor. Gets the row. Event args for event. Constructor. The row The column Gets the row. Gets the column. Specifies whether to cache the data. Default value is true. Set this to false if you want to prevent the UltraDataSource from keeping the data. As a result event will be fired again the next time the data for the cell is needed. Gets or sets the cell data. Set this property to the cell's value. Event args for event. Constructor. The row The column New value of the cell. Gets the row. Gets the column. New value of the cell. You can set this to a different value. Specifies whether to cache the data. Default value is true. Set this to false if you want to prevent the UltraDataSource from keeping the data. If there is some existing data that's cached for the column, it will be cleared. event will be fired the next time the data for the cell is needed. Event args for event. Constructor. The row The column The new value of the cell. Gets the row. Gets the column. New value of the cell. Event args for event. Constructor. Event args for event. Constructor. The rows collection that is being initialized. Gets the row scollection that is being initialized. Event args for event. Constructor. The rows collection to which the row is being added. the location in the collection at which to add the new row. Gets the rows collection to which the row is being added. Specifies the location in the collection at which to add the new row. You can set this property to a new value to change the location where the new row will get added. Event args for event. Constructor. Event args for event. Constructor. The row being deleted. Gets the row being deleted. Event args for event. Constructor. Event args for event. Constructor. Event args for event. Constructor. Event args for event. Constructor. Interface implemented by UltraDataSource. For internal use only. When designing the UltraDataSource in the designer, we want to allow the binding manager to be able to add rows so that the data structure for child bands can be extracted properly. For internal use only. A flag that's used by the UltraDataSource to suspend binding related notification while deserializing. Exposes a instance for this assembly. Returns the resource string using the specified name and default culture. Name of the string resource to return. Arguments supplied to the string.Format method when formatting the string. The resource string using the specified resource name and default culture. Returns the resource string using the specified resource name and default culture. The string is then formatted using the arguments specified. Name of the string resource to return. The resource string using the specified resource name and default culture. Returns the resource object using the specified name. Name of the resource item An object containing the specified resource Returns the for this assembly. UltraDataBand class. Represents a band (analogous to a table) in the data structure of the UltraDataSource.

An UltraDataBand defines columns and child bands. Use the property to get the top-most band. You can add columns to a band using its collection. You can also define one or more child bands using its collection. This effectively lets you create a hierarchical data structure.

Constructor used for serialization/deserialization. Returns true if the object has some non-default settings. true if the object has some non-default settings. Returns true if the is set to its non-default value of false. Returns true if this property is not set to its default value Returns true if the is set to its non-default value of false. Returns true if this property is not set to its default value Returns true if the is set to its non-default value of true. Returns true if this property is not set to its default value Returns true if this property is not set to its default value. ShouldSerializeKey always returns False for the UltraDataBand object since the band keys are serialized via the key parameter to the constructor. Returns true if this property is not set to its default value Returns true if this property is not set to its default value Returns true if this property is not set to its default value Returns true if this property is not set to its default value Clears cell values of rows associated with this band. This will cause the UltraDataSource component to fire event for cells next time the values for those cells are needed.

You can also use the UltraDataRowsCollection's method to clear the cached cell values of a particular row collection. UltraDataRow also exposes method.

Resets the property to its default value of true. Resets the property to its default value of true. Resets the property to its default value of true. Clears the columns collection. Clears the child bands collection. Resets the object to its default state.

Note that this method clears the columns and the child bands collections.

Moves this band after or before the specified band depending upon the value of relative position parameter. The band object relative to which this band will be moved. The relative position.

You can use the Move method to change the order of bands in a bands collection. Note that this method is not supported on the root band since the root band doesn't belong to any bands collection as it never has any siblings.

The UltraDataColumn object also exposes method that lets you change the order of columns in a columns collection.

Invoked during the serialization of the object. The used to obtain the serialized properties of the object An that provides a format context. Constructor used to deserialization to initialize a new instance of the class with the serialized property values The used to obtain the serialized properties of the object An that provides a format context. Fires when a property of this object or any of it's sub-objects changes. The Property change info which describes the chain of property changes. Returns an empty string. An empty string. Overridden. The Key of the item in its collection. This proeprty specifies the name of the band.

The Key of a band is also used as the the list name of the row collection associated with the band. ITypedList's GetListName implementation returns this value. The keys have to be unique across all the bands.

Bands collection that contains this band object. If this band is the root band then this property will return null (Nothing in VB). Returns the parent band. If this band is the top most band, then ParentBand will return null. Returns the associated UltraDataSource component. Indicates whether controls bound to this data source are allowed to add rows to row collections associated with this band.

Note that this property only controls whether the controls bound to this data source are allowed to add new rows. It does not control whether you can add rows to the data source directly to the .

Indicates whether controls bound to this data source are allowed to delete rows from row collections associated with this band.

Note that this property only controls whether the controls bound to this data source are allowed to add new rows. It does not control whether you can add rows to the data source directly to the .

Indicates whether any modifications to data, including adding and deleting of rows, are allowed in row collections associated with this band.

Setting ReadOnly to true will prevent the user from modifying cell values as well as from adding and removing of rows regardless of and property settings. This property caues the IBindingList.ReadOnly implementation in UltraDataSource to return true.

 Columns associated with this band.

You can use the returned columns collection to add one or more columns.

Note: To add a field that represents a child band (child rows) add a an UltraDataChildBand to the collection.

Returns a collection of bands that are child bands of this band.

You can use the ChildBands collection to add one or more child bands to a band. The root band can be accessed using the property of the UltraDataSource.

Retruns the index of the band in the parent collection. If this is the root band, returns -1 since the root band doesn't have a parent collection. UltraDataBand type converter. Returns whether this converter can convert the object to the specified type, using the specified context. An that provides a format context. A System.Type that represents the type you want to convert to. true if this converter can perform the conversion; otherwise, false. Converts the given value object to the specified type, using the specified context and culture information. An that provides a format context. A System.Globalization.CultureInfo. If null is passed, the current culture is assumed. The System.Object to convert. The System.Type to convert the value parameter to. An System.Object that represents the converted value. Constructor used to deserialization to initialize a new instance of the class with the serialized property values The used to obtain the serialized properties of the object An that provides a format context. Returns true if this property is not set to its default value. UltraDataBandsCollection class. Represents a collection of bands.

UltraDataBandsCollection class represents a collection of bands.

 Constructor. The parent band. Adds a new band with the specified key to the collection. Key of the new band. Returns the new band. Adds a new band with the specified key to the collection at the specified location. Location in the collection at which to insert the band. Key of the new band. Returns the new band. Removes the band with the specified key from the collection. The key of the band to remove. Removes the specified band from the collection. The band to remove. Removes band at the specified location from the collection. The index of the band to remove. Removes all the bands from the collection. AddRange method for serialization and deserialization. Constructor used to deserialization to initialize a new instance of the class with the serialized property values The used to obtain the serialized properties of the object An that provides a format context. Invoked when the deserialization of the component is completed. Reserved Fires when a property of this object or any of it's sub-objects changes. The Property change info which describes the chain of property changes. Returns an empty string. An empty string. Validates that the key doesn't already exist. The key to check Don't throw an exception if the key matches this item. Key already exists. Specifies the initial capacity of the collection. Returns false Overridden. Always returns false since columns collection does not allow having two columns with the same key. Returns true if the collection allows items to be added that do not have key values. Band this bands collection is a child of. Band returned by this property is the parent band of all the bands contained in this collection. Indexer. Gets the band with the specified key. Indexer. Gets the band with the specified key. BandsCollectionUITypeEditor prevents the default collection type editor from displaying an ellipsis button. Used to determine the type of UIEditor that will be displayed. ITypeDescriptorContext UITypeEditorEditStyle specifying the type of UIEditor. Summary description for UltraDataBandsCollectionConverter. constructor Returns whether this object supports properties, using the specified context. An that provides a format context. true if should be called to find the properties of this object; otherwise, false. Returns a collection of properties for the type of array specified by the value parameter, using the specified context and attributes. An that provides a format context. An that specifies the type of array for which to get properties. An array of type that is used as a filter. A with the properties that are exposed for this data type, or null if there are no properties. constructor Returns true The component to test for reset capability. Returns true Returns band object The component to test for reset capability. The band object. Does nothing The component to test for reset capability. Does nothing The component with the property value that is to be set. The new value. Returns false The component with the property to be examined for persistence. false Gets category Gets/SEts resource name Gets resource value Gets the type of the component this propertyvis bound to. A that represents the type of component this property is bound to. When the or methods are invoked, the object specified might be an instance of this type. Return false Gets the type of the property. A that represents the type of the property. UltraDataColumn class. Represents a column in the data structure of the UltraDataSource.

You can define one or more columns using the method of the .

Constructor used for serialization/deserialization. Clears the cell values of rows associated with this column. This will cause the UltraDataSource componenet to fire event for cells next time the data for those cells is needed. Resets the property to its default value of true. Resets the property to its default value of null. Resets the data type to its default value of type of string. Resets the AllowDBNull property its default value. Resets the object to its default state. Moves this column after or before the specified column depending upon the value of relative position parameter. The column object relative to which this column will be moved. The relative position.

You can use the Move method to change the order of columns in a columns collection.

The UltraDataBand object also exposes method that lets you change the order of bands in a bands collection.

Returns true if the object has some non-default settings. true if the object has some non-default settings. Returns true if the is set to its non-default value of true. Returns true if this property is not set to its default value Returns true if this property is not set to its default value. ShouldSerializeKey always returns False for the Band object since the band key can never be changed. Returns true if DefaultValue is set to a non-null value. Returns true if this property is not set to its default value Returns true if the DataType property needs to be serialized. Returns true if this property is not set to its default value Returns true if the AllowDBNull property needs to be serialized. Returns true if this property is not set to its default value Invoked during the serialization of the object. The used to obtain the serialized properties of the object An that provides a format context. Constructor used to deserialization to initialize a new instance of the class with the serialized property values The used to obtain the serialized properties of the object An that provides a format context. Fires when a property of this object or any of it's sub-objects changes. The Property change info which describes the chain of property changes. Returns an empty string. An empty string. The Key of the item in its collection. This property specifies the name of the column.

The propertyDescriptor associated with this column will use the value of this property as its name. In other words the bound controls will use this value as the name of the column.

Returns the band columns in this collection are associated with. Column's data type. Default value that's used when no value is specified for a cell of this column. Returns the columns collection this column is associated with. Typically the returned columns collection would contain this column. Indicates whether modifying of cell contents is allowed in this column.

Setting ReadOnly to true on an UltraDataColumn object will cause the associated PropertyDescriptor's IsReadOnly implementation to return true.

 Retruns the index of the column in the parent collection.

The Index property returns the location of this column in the that this column belongs to. This property returns the same value as the UltraDataColumnsCollection.IndexOf method of the UltraDataColumnsCollection.

Specifies whether the user is allowed to enter null values in the cells of this column.

Specifies whether the user is allowed to enter null values in the cells of this column. More precisely, setting this property to False will cause the associated property descriptor to not accept null and DBNull values. You can still set null values through code regardless of this property setting.

 UltraDataBand type converter. Returns whether this converter can convert the object to the specified type, using the specified context. An that provides a format context. A System.Type that represents the type you want to convert to. true if this converter can perform the conversion; otherwise, false. Converts the given value object to the specified type, using the specified context and culture information. An that provides a format context. A System.Globalization.CultureInfo. If null is passed, the current culture is assumed. The System.Object to convert. The System.Type to convert the value parameter to. An System.Object that represents the converted value. UltraDataColumnsCollection class. Represents a collection of columns.

UltraDataColumnsCollection class represents a collection of columns.

 Adds a new column with the specified key and specified data type. Key of the new column. Column's data type. Returns the new column. Adds a new column with the specified key and string data type. Key of the new column. Returns the new column. Adds a new column with the specified key and specified data type to the collection at the spcified location. Location in the collection at which to insert the band. Key of the new column. Column's data type. Returns the new column. Removes the column with the specified key from the collection. A value that uniquely identifies an object in a collection. Removes the specified column from the collection. The column to remove from the collection. Removes column at the specified location from the collection. The index of hte column to remove. Removes all the columns from the collection. AddRange method for serialization and deserialization. Constructor used to deserialization to initialize a new instance of the class with the serialized property values The used to obtain the serialized properties of the object An that provides a format context. Invoked after the entire object graph has been deserialized. The object that initiated the callback. The functionality for the this parameter is not currently implemented. Fires when a property of this object or any of it's sub-objects changes. The Property change info which describes the chain of property changes. Returns an empty string. An empty string. Validates that the key doesn't already exist. The key to check Don't throw an exception if the key matches this item. Key already exists. Specifies the initial capacity of the collection. Returns false Overridden. Always returns false since columns collection does not allow having two columns with the same key. Returns true if the collection allows items to be added that do not have key values. Band object this columns collection is associated with. Returned band's Columns would point to this columns collection. Gets the column with the specified key. Gets the column at the specified location in the collection. Determines whether to use a hash table to store the keys and objects. By use a hash table, performance of methods like ValidateKeyDoesNotExist and GetItem can be significantly improvied. ColumnsCollectionUITypeEditor prevents the default collection type editor from displaying an ellipsis button. Used to determine the type of UIEditor that will be displayed. ITypeDescriptorContext UITypeEditorEditStyle specifying the type of UIEditor. Summary description for ColumnsCollectionConverter. constructor Returns whether this object supports properties, using the specified context. An that provides a format context. true if should be called to find the properties of this object; otherwise, false. Returns a collection of properties for the type of array specified by the value parameter, using the specified context and attributes. An that provides a format context. An that specifies the type of array for which to get properties. An array of type that is used as a filter. A with the properties that are exposed for this data type, or null if there are no properties. constructor Returns true The component to test for reset capability. Returns true Returns column object The component to test for reset capability. The column object. Does nothing The component to test for reset capability. Does nothing The component with the property value that is to be set. The new value. Returns false The component with the property to be examined for persistence. false Gets category Gets/SEts resource name Gets resource value Gets the type of the component this propertyvis bound to. A that represents the type of component this property is bound to. When the or methods are invoked, the object specified might be an instance of this type. Return false Gets the type of the property. A that represents the type of the property. Property descriptor associated with an instance. Returns true The component to test for reset capability. Returns true Returns the passed in object. The component to test for reset capability. the passed in object. Does nothing The component to test for reset capability. Component is an instance of UltraGridRow for which to set the value to the bound list. The component with the property value that is to be set. The new value. Returns true The component with the property to be examined for persistence. true Returns the associated column. Returns the key of the column. Gets the name that can be displayed in a window, such as a Properties window. The name to display for the member. Return true if the column is read-only Gets the type of the property. A that represents the type of the property. Gets the type of the component this propertyvis bound to. A that represents the type of component this property is bound to. When the or methods are invoked, the object specified might be an instance of this type. Property descriptor associated with an instance. Returns true The component to test for reset capability. Returns true Returns the passed in object. The component to test for reset capability. the passed in object. Does nothing The component to test for reset capability. Component is an instance of UltraGridRow for which to set the value to the bound list. The component with the property value that is to be set. The new value. Returns true The component with the property to be examined for persistence. true Retruns the associated band. Returns the name of the band. Return true if the band is read-only Gets the type of the property. A that represents the type of the property. Gets the type of the component this propertyvis bound to. A that represents the type of component this property is bound to. When the or methods are invoked, the object specified might be an instance of this type. Represents a row in the UltraDataSource.

You can add one or more rows to a row collection using the method of the .

Constructor. The parent colletion to which this row belongs. Constructor for Deserialization This constructor is for internal infrastructure purposes and should not be used. The row data. The child islands The Tag of the row Constructor for Deserialization This constructor is for internal infrastructure purposes and should not be used. The row data. The child islands Constructor for Deserialization This constructor is for internal infrastructure purposes and should not be used. The row data. Constructor for Deserialization This constructor is for internal infrastructure purposes and should not be used. The row data. The Tag of the row Returns true if the tag value is a string or a primitive type. Gets the cell value associated with the specified column. The index of the column whose value to get.

Sets the cell value associated with the specified column. This overload does not raise the event if the cell value has not been set.

The value of the cell. Gets the cell value associated with the specified column. The key of the column whose value to get.

Sets the cell value associated with the specified column. This overload does not raise the event if the cell value has not been set.

The value of the cell. Gets the cell value associated with the specified column. The column whose value to get.

Sets the cell value associated with the specified column. This overload does not raise the event if the cell value has not been set.

The value of the cell. Gets the cell value associated with the specified column. The index of the column whose value to get. Specifies whether to raise the event if the cell's value has not been set. The value of the cell. Gets the cell value associated with the specified column. The key of the column whose value to get. Specifies whether to raise the event if the cell's value has not been set. The value of the cell. Gets the cell value associated with the specified column. The column whose value to get. Specifies whether to raise the event if the cell's value has not been set. The value of the cell. Sets the cell value associated with the specified column. The index of the column whose value to set. The new cell value.

Sets the cell value associated with the specified column. This overload does not raise the and events.

Sets the cell value associated with the specified column. The key of the column whose value to set. The new cell value.

Sets the cell value associated with the specified column. This overload does not raise the and events.

Sets the cell value associated with the specified column. The column whose value to set. The new cell value.

Sets the cell value associated with the specified column. This overload does not raise the and events.

Sets the cell value associated with the specified column. The index of the column whose value to set. The new cell value. Specifies whether to raise the and events. Sets the cell value associated with the specified column. The key of the column whose value to set. The new cell value. Specifies whether to raise the and events. Sets the cell value associated with the specified column. The column whose value to set. The new cell value. Specifies whether to raise the and events. Gets the child rows associated with the child band with the specified key in the child bands collection of the row's band. Child band key. Child bands collection returned by property of this row's band must contain an entry with this key. Returns the child rows.

The row's band must have a child band defined with the specified key. The property of the is used to define the child bands.

Gets the child rows associated with the child band at the childBandIndex location in the child bands collection of the row's band. Index in the child bands collection returned by property of this row's band. Returns the child rows.

The row's band must have child bands defined. The property of the is used to define the child bands.

Gets the child rows for the specified child band. Child rows associated with this child band will be returned. The child rows of the specified child band.

The specified band must be a child band of the band associated with this row. The property of the is used to define the child bands.

Clears the cached cell value associated with the column with the specified index. This will result in the component raising event for the cell the next time the cell value is needed Specifies the index of the column whose cell value is to be cleared.

You can use the UltraDataRow's method to clear values of all cells. The UltraDataRowsCollection also exposes method that lets you clear cell values of all rows in a row collection.

Clears the cached cell value associated with the column with the specified key. This will result in the component raising event for the cell the next time the cell value is needed Specifies the index of the column whose cell value is to be cleared.

You can use the UltraDataRow's method to clear values of all cells. The UltraDataRowsCollection also exposes method that lets you clear cell values of all rows in a row collection.

Clears the cached cell value associated with the specified column. This will result in the component raising event for the cell the next time the cell value is needed. Specifies the column whose cell value is to be cleared.

You can use the UltraDataRow's method to clear values of all cells. The UltraDataRowsCollection also exposes method that lets you clear cell values of all rows in a row collection.

Clears all the cached cell values. This will result in the component raising event for the cells of this row the next time the cell values are needed.

You can use the UltraDataRow's method to clear the cell value of a specific column.

Gets serialization information with all of the non-default information required to reinstantiate the object. The used to obtain the serialized properties of the object An that provides a format context. Constructor used to deserialization to initialize a new instance of the class with the serialized property values The used to obtain the serialized properties of the object An that provides a format context. Gets the band associated with this row. Returns the parent collection. Gets the parent row. Gets the associated UltraDataSource component. Gets or sets the tag. The tag property can be used to logically attach another object or value to this object. Index of this row in the parent collection. Gets or sets the cell value associated with the column with the specified index. Gets or sets the cell value associated with the column with the specified key. Gets or sets the cell value associated with the specified column. UltraDataRow type converter. Returns whether this converter can convert the object to the specified type, using the specified context. An that provides a format context. A System.Type that represents the type you want to convert to. true if this converter can perform the conversion; otherwise, false. Converts the given value object to the specified type, using the specified context and culture information. An that provides a format context. A System.Globalization.CultureInfo. If null is passed, the current culture is assumed. The System.Object to convert. The System.Type to convert the value parameter to. An System.Object that represents the converted value. UltraDataRowsCollection class. Contains one or more rows.

An UltraDataRowsCollection collection contains one or more instances. It also implements IBindingList and ITypedList .NET data binding interfaces.

You can add one or more rows using the or methods. You can also use the method to specify that the collection contain a specified number of rows. With SetCount you don't have to call Add or Insert methods multiple times. Also SetCount will lazily create rows when they are accessed thus making it more efficient.

Constructor. Constructor. An arrow of rows. The Tag of the collection. Returns true if the tag value is a string or a primitive type. Gets the index of the specified row in the collection. Object whose index should be returned The index of value if found in the list; otherwise, -1. Indicates whether the specified row is contained in the collection. Object to evaluate true if the item is found in the list; otherwise, false. Adds a new row to the collection. Returns the new row that was added to the collection. Adds a new row to the collection. Specifies whether to raise and events. Returns the new row that was added to the collection.

Add method creates a new row and adds it to the collection. If raiseAddEvents argument is true, and are raised. If RowAdding event is canceled, no new row is added to the collection and this method returns null.

 Adds a new row to the collection. Specifies whether to raise and events. If this parameter is specified as True then the added row will be put in Edit and AddNew states. When a row is in Edit state it can be cancelled by calling ((IEditableObject)row).CancelEdit. The end user can cancel such a row by hitting Escape key twice on the row (if the row were being displayed in an UltraGrid or DataGrid). Cancelling a row in edit state reverts the cell values to their original values (as they were when the BeginEdit was called). When a row in AddNew state is canceled, it's removed from the collection. Overloads of this method that do not take this parameter default it to True. Returns the new row that was added to the collection.

Add method creates a new row and adds it to the collection. If raiseAddEvents argument is true, and are raised. If RowAdding event is canceled, no new row is added to the collection and this method returns null.

 Adds a new row to the collection. Specifies the cell values with which to initialize the new row. An exception is thrown if the array is null or has more elements thant the number of columns or if a value cannot be converted to the data type of the corresponding column. Returns the new row that was added to the collection. Adds a new row to the collection. Specifies whether to raise and events. Specifies the cell values with which to initialize the new row. An exception is thrown if the array is null or has more elements thant the number of columns or if a value cannot be converted to the data type of the corresponding column. Returns the new row that was added to the collection.

Add method creates a new row and adds it to the collection. If raiseAddEvents argument is true, and are raised. If RowAdding event is canceled, no new row is added to the collection and this method returns null.

 Adds a new row to the collection. Specifies whether to raise and events. Overloads of this method that do not take this parameter default it to False. Specifies the cell values with which to initialize the new row. An exception is thrown if the array is null or has more elements thant the number of columns or if a value cannot be converted to the data type of the corresponding column. If this parameter is specified as True then the added row will be put in Edit and AddNew states. When a row is in Edit state it can be cancelled by calling ((IEditableObject)row).CancelEdit. The end user can cancel such a row by hitting Escape key twice on the row (if the row were being displayed in an UltraGrid or DataGrid). Cancelling a row in edit state reverts the cell values to their original values (as they were when the BeginEdit was called). When a row in AddNew state is canceled, it's removed from the collection. Overloads of this method that do not take this parameter default it to True. Returns the new row that was added to the collection.

Add method creates a new row and adds it to the collection. If raiseAddEvents argument is true, and are raised. If RowAdding event is canceled, no new row is added to the collection and this method returns null.

 Adds a new row to the collection at the specified location. Location in the collection at which to add the new row to. Returns the new row that was added to the collection. Adds a new row to the collection at the spcified location. Location in the collection at which to add the new row to. Specifies whether to raise and events. Returns the new row that was added to the collection.

Insert method creates a new row and adds it to the collection at the specified location. If raiseAddEvents argument is true, and are raised. If RowAdding event is canceled, no new row is added to the collection and this method returns null.

 Adds a new row to the collection at the spcified location. Location in the collection at which to add the new row to. Specifies whether to raise and events. If this parameter is specified as True then the added row will be put in Edit and AddNew states. When a row is in Edit state it can be cancelled by calling ((IEditableObject)row).CancelEdit. The end user can cancel such a row by hitting Escape key twice on the row (if the row were being displayed in an UltraGrid or DataGrid). Cancelling a row in edit state reverts the cell values to their original values (as they were when the BeginEdit was called). When a row in AddNew state is canceled, it's removed from the collection. Overloads of this method that do not take this parameter default it to True. Returns the new row that was added to the collection.

Insert method creates a new row and adds it to the collection at the specified location. If raiseAddEvents argument is true, and are raised. If RowAdding event is canceled, no new row is added to the collection and this method returns null.

 Adds a new row to the collection at the specified location. Location in the collection at which to add the new row to. Optional parameter. Specifies the cell values with which to initialize the new row. An exception is thrown if the array has more elements thant the number of columns or if a value cannot be converted to the data type of the corresponding column. Returns the new row that was added to the collection. Adds a new row to the collection at the spcified location. Location in the collection at which to add the new row to. Specifies whether to raise and events. Optional parameter. Specifies the cell values with which to initialize the new row. An exception is thrown if the array has more elements thant the number of columns or if a value cannot be converted to the data type of the corresponding column. Returns the new row that was added to the collection.

Insert method creates a new row and adds it to the collection at the specified location. If raiseAddEvents argument is true, and are raised. If RowAdding event is canceled, no new row is added to the collection and this method returns null.

 Adds a new row to the collection at the spcified location. Location in the collection at which to add the new row to. Specifies whether to raise and events. Optional parameter. Specifies the cell values with which to initialize the new row. An exception is thrown if the array has more elements thant the number of columns or if a value cannot be converted to the data type of the corresponding column. If this parameter is specified as True then the added row will be put in Edit and AddNew states. When a row is in Edit state it can be cancelled by calling ((IEditableObject)row).CancelEdit. The end user can cancel such a row by hitting Escape key twice on the row (if the row were being displayed in an UltraGrid or DataGrid). Cancelling a row in edit state reverts the cell values to their original values (as they were when the BeginEdit was called). When a row in AddNew state is canceled, it's removed from the collection. Overloads of this method that do not take this parameter default it to True. Returns the new row that was added to the collection.

Insert method creates a new row and adds it to the collection at the specified location. If raiseAddEvents argument is true, and are raised. If RowAdding event is canceled, no new row is added to the collection and this method returns null.

 Removes the specified row from the collection. If the row doesn't exist in the collection, this method does nothing. Row to remove from the collection. Removes the specified row from the collection. If the row doesn't exist in the collection, this method does nothing. Row to remove from the collection. Specifies whether to raise and events.

Remove method removes the specified row from the collection. If raiseDeleteEvents argument is true, and events are raised. If RowDeleting event is canceled, the row is not removed.

 Removes the row at the specified location. The index of the row to remove. Removes the row at the specified location. The index of the row to remove. Specifies whether to raise and events.

RemoveAt method removes the row at the specified location from the collection. If raiseDeleteEvents argument is true, and events are raised. If RowDeleting event is canceled, row is not removed.

 Clears the rows collection.

Clear method removes all the rows from the collection. This has the same effect as setting the count to 0 by calling . Note: Calling this method does not raise RowDeleting and RowDeleted events.

 Fires ListChanged notification with the ListChanged type of Reset on the IBindingList implementation causing bound controls to refresh themselves by reloading the data. Sets the row count to the specified count. If the new count is greater than the current count, new rows are added at the end of the collection. If the new count is less than the current count, rows are removed from the end of the collection. The new count of the collection.

Note: SetCount method does not raise add (RowAdding, RowAdded) or delete (RowDeleting, RowDeleted) events when it does add or remove items.

 Sets the row count to the specified count. If the new count is greater than the current count, new rows are added at the end of the collection. If the new count is less than the current count, rows are removed from the end of the collection. The new count of the collection. If the count is different, SetCount always fires ListChanged notification with Reset as the ListChanged type on the IBindingList implementaion so the controls bound to this data source reload the data and refresh themselves. However if the count is the same, this method by default doesn't fire the ListChanged notification. Specify true for the forceNotifyListReset parameter to force this method to fire ListChanged even when the new count is the same as the old count.

Note: SetCount method does not raise add (RowAdding, RowAdded) or delete (RowDeleting, RowDeleted) events when it does add or remove items.

 Clears all cached cell values. This will result in the component raising event for cells the next time the cell values are needed.

You can use the UltraDataRowsCollection's method to clear the cached cell values of a particular row collection. UltraDataRow also exposes method.

Indicates if any of the property values differ from the default value. True if the object needs to be serialized. AddRange method for serialization and deserialization. An arrow of rows to add. Constructor used to deserialization to initialize a new instance of the class with the serialized property values The used to obtain the serialized properties of the object An that provides a format context. Gets the band associated with the row collection. Gets the parent row. Associated UltraDataSource component. Gets or sets the tag. The tag property can be used to logically attach another object or value to this object. Returns the number of items in this collection.

The Count property returns the number of rows contained in this row collection. You can add one or more rows using the or methods. You can also use the method to specify that the collection contain a specified number of rows. With SetCount you don't have to call Add or Insert methods multiple times. Also SetCount will lazily create rows when they are accessed thus making it more efficient.

Indexer. IBindingList.ListChanged event implementation. UltraDataRowsCollection type converter. Returns whether this converter can convert the object to the specified type, using the specified context. An that provides a format context. A System.Type that represents the type you want to convert to. true if this converter can perform the conversion; otherwise, false. Converts the given value object to the specified type, using the specified context and culture information. An that provides a format context. A System.Globalization.CultureInfo. If null is passed, the current culture is assumed. The System.Object to convert. The System.Type to convert the value parameter to. An System.Object that represents the converted value. Constructor used to deserialization to initialize a new instance of the class with the serialized property values The used to obtain the serialized properties of the object An that provides a format context. UltraDataSource component. UltraDataSource is a bindable data source that provides the ability to define hierarchical data structure and provides capability to serialize out the data. Constructor. Initializes a new instance of . Constructor. Initializes a new instance of . An that represents the container of the Fires the event. An that contains the event data. Fires the event. An that contains the event data. Fires the event. An that contains the event data. Fires the event. An that contains the event data. Fires the event. An that contains the event data. Fires the event. An that contains the event data. Fires the event. An that contains the event data. Fires the event. An that contains the event data. Fires the event. An that contains the event data. Fires the event. An that contains the event data. Fires the event. An that contains the event data. Fires the event. An that contains the event data. Returns true if the object has some non-default settings. true if the object has some non-default settings. Returns true if the is set to its non-default value of false. Returns true if this property is not set to its default value Returns true if the is set to its non-default value of false. Returns true if this property is not set to its default value Returns true if the is set to its non-default value of true. Returns true if this property is not set to its default value Returns true if the property needs to be serialized. Returns true if this property is not set to its default value Returns true if the property needs to be serialized. Returns true if this property is not set to its default value Returns true if the is set to its non-default value of true. Returns true if this property is not set to its default value Clears all cached cell values. This will cause the UltraDataSource component to fire event for cells next time the values for those cells are needed.

Note that calling ResetCachedValues clears the internal cache of data from the DataSource, but it does not notify bound controls. This means that if there is a control bound to the UltraDataSource (an UltraWinGrid, for example) that is currently displaying data, the control will not update it's display to reflect the new data unless something occurs to make it re-request the data. To force this to occur immediately, call the method of the .

 Suspends firing of IBindingList related notifications. This is useful if you want to make lot of modifications and temporarily prevent the controls bound to this data source from handling events associated with the data source modification.

This method along with the can be used to temporarily prevent UltraDataSource from firing ListChanged ItemChanged notifications. This can be useful in a situation where a lot of cells need to be modified however for efficiency reasons you do not want to fire ListChanged ItemChanged notification for every cell that's modified. In such a situation you would call SuspendBindingNotifications and modify cells and then call ResumeBindingNotifications. When ResumeBindingNotifications is called the UltraDataSource fires a single ListChanged Reset notification for every row collection that was affected to cause the bound controls to reload the data. To prevent the ResumeBindingNotifications from firing any notifications on resumption, use the overload of ResumeBindingNotifications that takes in fireNotifications parameter. However note that if you specify false for fireNotifications parameter then the bound controls may not reflect the changed cell values. You will have to invalidate those controls manually yourself.

Note: If the data source is bound to an UltraGrid, as expected, the UltraGrid will not fire InitializeRow event for the rows you modify since it will not receive any ItemChanged notifications.

, Resumes firing of IBindingList related notifications.

This method along with the can be used to temporarily prevent UltraDataSource from firing ListChanged ItemChanged notifications. This can be useful in a situation where a lot of cells need to be modified however for efficiency reasons you do not want to fire ListChanged ItemChanged notification for every cell that's modified. In such a situation you would call SuspendBindingNotifications and modify cells and then call ResumeBindingNotifications. When ResumeBindingNotifications is called the UltraDataSource fires a single ListChanged Reset notification for every row collection that was affected to cause the bound controls to reload the data. To prevent the ResumeBindingNotifications from firing any notifications on resumption, use the overload of ResumeBindingNotifications that takes in fireNotifications parameter. However note that if you specify false for fireNotifications parameter then the bound controls may not reflect the changed cell values. You will have to invalidate those controls manually yourself.

Note: If the data source is bound to an UltraGrid, as expected, the UltraGrid will not fire InitializeRow event for the rows you modify since it will not receive any ItemChanged notifications.

, Resumes firing of IBindingList related notifications.

This method along with the can be used to temporarily prevent UltraDataSource from firing ListChanged ItemChanged notifications. This can be useful in a situation where a lot of cells need to be modified however for efficiency reasons you do not want to fire ListChanged ItemChanged notification for every cell that's modified. In such a situation you would call SuspendBindingNotifications and modify cells and then call ResumeBindingNotifications. When ResumeBindingNotifications is called the UltraDataSource fires a single ListChanged Reset notification for every row collection that was affected to cause the bound controls to reload the data. To prevent the ResumeBindingNotifications from firing any notifications on resumption, use the overload of ResumeBindingNotifications that takes in fireNotifications parameter. However note that if you specify false for fireNotifications parameter then the bound controls may not reflect the changed cell values. You will have to invalidate those controls manually yourself.

, Resets the property to its default value of true. Resets the property to its default value of true. Resets the property to its default value of true. Resets the band. This will also clear the data strcture. Resets the property to its default value of true. Resets the object to its default state. Returns a Band if the key exists anywhere in the band hierarchy or null if it does not. The key to search for. Returns a Band if the key exists anywhere in the band hierarchy or null if it does not. Loads saved information from a stream containing the binary data.

The LoadFromBinary method is used in conjunction with the method to persist the structure and data of the ultraDataSource.

 Stream containing the serialized information Determines whether that data is saved along with the data structure. Loads saved information from a stream containing the binary data.

The LoadFromBinary method is used in conjunction with the method to persist the structure and data of the ultraDataSource.

 Stream containing the serialized information Loads saved information from a file containing the binary data.

The LoadFromBinary method is used in conjunction with the method to persist the structure and data of the ultraDataSource.

 The name of the file containing the serialized information. Determines whether that data is saved along with the data structure. Loads saved information from a file containing the binary data.

The LoadFromBinary method is used in conjunction with the method to persist the structure and data of the ultraDataSource.

 The name of the file containing the serialized information. Loads saved information from a stream containing the Xml data.

The LoadFromXml method is used in conjunction with the method to persist the structure and data of the ultraDataSource.

 Stream containing the serialized information Determines whether that data is saved along with the data structure. Loads saved information from a stream containing the Xml data.

The LoadFromXml method is used in conjunction with the method to persist the structure and data of the ultraDataSource.

 Stream containing the serialized information Loads saved information from a file containing the Xml data.

The LoadFromXml method is used in conjunction with the method to persist the structure and data of the ultraDataSource.

 The name of the file containing the serialized information Determines whether that data is saved along with the data structure. Loads saved information from a file containing the Xml data.

The LoadFromXml method is used in conjunction with the method to persist the structure and data of the ultraDataSource.

 The name of the file containing the serialized information Saves properties, structure, and data information to a binary stream.

The SaveAsBinary method is used in conjunction with the method to persist the property settings and layout of the ultraDataSource.

 Stream containing the serialized information Determines whether that data is saved along with the data structure. Saves properties, structure, and data information to a binary stream.

The SaveAsBinary method is used in conjunction with the method to persist the property settings and layout of the ultraDataSource.

 Stream containing the serialized information Saves properties, structure, and data information to a file in binary format.

The SaveAsBinary method is used in conjunction with the method to persist the property settings and layout of the ultraDataSource.

 The name of the file containing the serialized information Determines whether that data is saved along with the data structure. Saves properties, structure, and data information to a file in binary format.

The SaveAsBinary method is used in conjunction with the method to persist the property settings and layout of the ultraDataSource.

 The name of the file containing the serialized information Saves properties, structure, and data information to an Xml/soap stream.

The SaveAsBinary method is used in conjunction with the method to persist the property settings and layout of the ultraDataSource.

 Stream containing the serialized information Determines whether that data is saved along with the data structure. Saves properties, structure, and data information to an Xml/soap stream.

The SaveAsBinary method is used in conjunction with the method to persist the property settings and layout of the ultraDataSource.

 Stream containing the serialized information Saves properties, structure, and data information to a file in xml/soap format.

The SaveAsBinary method is used in conjunction with the method to persist the property settings and layout of the ultraDataSource.

 The name of the file containing the serialized information Determines whether that data is saved along with the data structure. Saves properties, structure, and data information to a file in xml/soap format.

The SaveAsBinary method is used in conjunction with the method to persist the property settings and layout of the ultraDataSource.

 The name of the file containing the serialized information Called when a property on a sub object has changed. A structure containing the property change information. Fired when data is requested by a control bound to this UltraDataSource for a particular cell and the UltraDataSource doesn't have the cell value.

CellDataRequested event is fired when a control bound to the UltraDataSource requests value for a cell and UltraDataSource doesn't have the cell value. Once the value is provided, UltraDataSource will cache it and this event will not be fired for the cell next time. You can prevent the value from being cached by setting the to false in the event handler.

You can also provide cell values without having to hook into this event by using method. Also you can clear the cached value for a cell using method to cause this event to be fired next time for the cell.

 Fired before a control bound to this UltraDataSource attempts to update a cell's value.

CellDataUpdating is fired before a control bound to this UltraDataSource attempts to update a cell's value. You can cancel the update by setting Cancel to true off the in which case the original value will be retained. You can also alter the update value by setting to a different value.

By default the UltraDataSource will cache the new value of the cell. If you are managing the data then you may want to prevent the UltraDataSource from caching the value by setting to false.

Note that this event is not be fired when you set the value in code.

 Fired after a cell's data has been updated. This event occurs after event.

See for information on when this event is raised.

 Fired for every UltraDataRow when it's created.

InitializeDataRow event is fired for every row when it's created.

 Fired for every UltraDataRowsCollection when it's created.

The InitializeRowsCollection event is fired for every when it's created.

Fired when a control bound to this UltraDataSource attempts to add a new row to the UltraDataSource. Fired after a control bound to this UltraDataSource adds a new row to the data source. Fired when a control bound to this UltraDataSource attempts to delete a row. Fired after a control bound to this UltraDataSource to deletes a row. RowBeginEdit event is fired when BeginEdit on the implementation of the UltraDataRow is called.

RowBeginEdit event is fired when BeginEdit on the implementation of the UltraDataRow is called. This typically happens when a bound control starts editing cells of a row. When one or more of the row cells are modified, is called on the row object to commit those modifications. Optionally can be called to discard the modifications and restore the original values. , and events correspond to UltraDataRow implementation of , and .

NOTE: multiple rows can be in edit mode at the same time. As a result RowBeginEdit and or can fire asynchronously for different rows.

 RowEndEdit event is fired when EndEdit on the implementation of the UltraDataRow is called.

RowEndEdit event is fired when EndEdit on the implementation of the UltraDataRow is called. Typically bound controls call EndEdit on a row to commit series of modifications that might have been made to a row. When one or more of the row cells are modified, is called on the row object to commit those modifications. , and events correspond to UltraDataRow implementation of , and .

NOTE: multiple rows can be in edit mode at the same time. As a result and or RowEndEdit can fire asynchronously for different rows.

 RowCancelEdit event is fired when CancelEdit on the implementation of the UltraDataRow is called.

RowCancelEdit event is fired when CancelEdit on the implementation of the UltraDataRow is called. Typically bound controls call CancelEdit on a row to discard series of modifications that might have been made to a row and restore the original values. , and events correspond to UltraDataRow implementation of , and .

NOTE: multiple rows can be in edit mode at the same time. As a result and RowCancelEdit or can fire asynchronously for different rows.

 Gets the rows collection associated with the top most band. Gets the top most band object.

The Band property returns the root band. To access the child bands use the property of the band.

Indicates whether row adding is allowed. Default is true.

Setting AllowAdd to true will prevent the controls bound to this data source from adding rows to it.

 Indicates whether row deleting is allowed. Default is true.

Setting AllowDelete to true will prevent the controls bound to this data source from deleting rows from it.

 Indicates whether any modifications to data, including adding and deleting of rows, are allowed in row collections associated with this band.

Setting ReadOnly to true makes the data source read-only so that the controls bound to this data source can not make any modifications. Setting it to true will prevent cell content modifications as well as adding and deleting of rows regardless of the and settings. This property caues the IBindingList.ReadOnly implementation in UltraDataSource to return true.

 Indicates whether IBindingList related notifications are suspended. The object that enables, disables and controls firing of specific control events.

The DataSourceEventManager gives you a high degree of control over how the component invokes event procedures. You can use it to selectively enable and disable event procedures depending on the context of your application. You can also use the event manager to return information about the state of the component's events.

The event manager's methods are used to determine the enabled state of an event (), to selectively enable or disable events (), and to tell whether an event procedure is currently being processed (). There is also an property that you can check to quickly determine whether any events have been disabled by the event manager.

 Returns the event handler that for the method that is used to receive notifications when a property on a sub-object has changed. Display the about dialog Returns the cached license for the control Indicates whether to use BindingSource to manage currency managers via ICurrencyManagerProvider implementation. Default value is true. In CLR2.0 framework, a new BindingSource data source wrapper object was introduced that solved some performance issues with binding hierarchical data sources with high number of bands. However BindingSource introduced some incompatibilities with older behavior. You can use this property to fallback to not using BindingSource.