Gets or sets value of a data object, held by Row.

Namespace: Dapfor.Net.Ui
Assembly: Dapfor.Net (in Dapfor.Net.dll) Version: 2.10.3.24917 (2.10.3.24917)

Syntax

C#
public Object Value { get; set; }
Visual Basic
Public Property Value As Object
	Get
	Set
Visual C++
public:
property Object^ Value {
	Object^ get ();
	void set (Object^ value);
}
F#
member Value : Object with get, set

Property Value

Type: Object
The value.

Remarks

When data is changed in business logic layer, the rows where this data is displayed should be sorted, filtrated, and grouped, and cells with this are repainted and highlighted as well

Data updates in non-event model
These processes are automatically launched when Update()()()() / Update()()()() methods are invoked. Moreover, .Net Grid constantly monitors row state including their visibility, sorting position, grouping position and matching filtering conditions. Invocation of Row.Update() method initiates verification of all the above conditions for a single row among ordered rows in a grid. This process is much more efficient than working with unsorted data, especially during sorting. Invocation of Row.Update() in the event-driven model occurs regularly upon notification from the INotifyPropertyChanged interface. The Row.Update() method call is thread-safe, and therefore you don't have to write your own thread synchronization logic. It is extremely convenient when you develop multi-threaded applications.

Therefore, when data is changed in the non-event model, you just have to invoke Update()()()() / Update()()()() methods or Value setter, and .Net Grid will automatically perform all necessary operations with the row or with the cell

 Copy imageCopy
public void DataUpdating(Grid grid)
{
    object[] data = new object[] { "value 1", 125, true, DockStyle.Fill };
    Row row = grid.Rows.Add(data);

    //The next calls will invalidate and highlight cells, and sort, filter and regroup the row
    row[2].Value = false;
    row[3].Value = DockStyle.Top;

    //The last value in the data should equal to 'DockStyle.Top'.
    Assert.AreEqual(data[3], DockStyle.Top);

    //This call will also invalidate and highlight the cell, and sort, filter and regroup the row
    data[1] = 125;
    row[1].Update();

    //The next call will just sort, filter and regroup the row
    data[0] = "value 2";
    row.Update();
}

Event-driven model

In the event-driven model it is sufficient to implement INotifyPropertyChanged interface to notify grid about data changes. This approach has very important advantages. The aforementioned interface is located in System.ComponentModel namespace and has only one public event - PropertyChanged. Because of that business logic can notify subscribers (GUI controls) through this interface and the .Net Grid itself performs data sorting, filtration and other operations. Moreover, a subscriber makes necessary actions for thread synchronization with the GUI thread. In other words, with good application architecture your assemblies with application logic will have no dependencies from System.Windows.Forms and Dapfor assemblies.

This is an implementation of the popular OOP design pattern that is known as Observer or Publisher / Subscriber. This approach provides a considerable advantage over conventional programming models. Your applications may have multiple Graphic User Interfaces (multiple grids) that are subscribed to PropertyChanged event as event-listeners to the business object. A business object is an event generator or event publisher. When an object field changes in the setter of any property, the PropertyChanged event is fired and all subscribers get guaranteed notification about it:

 Copy imageCopy
//Some data object
public class Product : INotifyPropertyChanged
{
    //Some fields
    private double price;
    private DateTime maturity;

    [DoubleFormat(Precision = 3, ShortForm = true, ShowZero = false)]
    public double Price
    {
        get { return price; }
        set
        {
            price = value;
            if(PropertyChanged != null)
            {
                PropertyChanged(this, new PropertyChangedEventArgs("Price"));
            }
        }
    }
    public DateTime Maturity
    {
        get { return maturity; }
    }
    public event PropertyChangedEventHandler PropertyChanged;
}

//Add a data object to the grid. 
Product product = new Product();
Row row = grid.Rows.Add(product);

//The grid will automatically sort, filter, group and highlight corresponding row!
//The product is your business logic and may be placed in any assembly that doesn't need to have references to Dapfor assemblies!
product.Price = 123;

//The value in the "Price" cell should equal to '123'.
Assert.AreEqual(row["Price"].Value, 123);

Performance
We would also like to emphasize performance advantages of the .Net Grid. In an unsorted grid all rows are systematically indexed, and when sorting is enabled, the search occurs at most ln(N) iterations due to efficient algorithms used in .Net Grid. It's obvious that storing row state data consumes memory. Average memory consumption per row equals to 160 bytes, and that results in 16 MB per 100,000 data objects inserted into the grid, while the performance advantage is tremendous! The grid with 2,000 rows enables updating of more than 50,000 cells and sorting of more than 3,000 rows per second in realtime!

See Also