UnboundSource Class

A data source used to supply and obtain a typed list of objects to data-aware controls in unbound mode.

Namespace: DevExpress.Data

Assembly: DevExpress.Data.v18.1.dll

Declaration

C#

[ToolboxBitmap(typeof(ResFinder), "Bitmaps256.UnboundDataSource.bmp")]
[ToolboxTabName("DX.18.1: Data & Analytics")]
public class UnboundSource :
    Component,
    IListSource,
    ISupportInitialize

VB.NET

<ToolboxBitmap(GetType(ResFinder), "Bitmaps256.UnboundDataSource.bmp")>
<ToolboxTabName("DX.18.1: Data & Analytics")>
Public Class UnboundSource
    Inherits Component
    Implements IListSource,
               ISupportInitialize

Remarks

To use the UnboundSource component, drag it to the form from the DX.18.1: Data & Analytics tab of the Visual Studio Toolbox. You can also add and configure an UnboundSource with the Data Source Configuration Wizard.

To setup the UnboundSource‘s list and its columns, use the UnboundSource.Properties property.

Handle the UnboundSource.ValueNeeded and UnboundSource.ValuePushed events to obtain data from your data storage and save modified data back.

C#

unboundSource1.ValueNeeded+= unboundSource1_ValueNeeded;
unboundSource1.ValuePushed+= unboundSource1_ValuePushed;
//...
void unboundSource1_ValueNeeded(object sender, DevExpress.Data.UnboundSourceValueNeededEventArgs e) {
    e.Value = something; /* Assign the real data here.*/
}
void unboundSource1_ValuePushed(object sender, DevExpress.Data.UnboundSourceValuePushedEventArgs e) {
    something = e.Value; /* Propagate the value into the storage.*/
}

VB.NET

AddHandler unboundSource1.ValueNeeded, AddressOf unboundSource1_ValueNeeded
AddHandler unboundSource1.ValuePushed, AddressOf unboundSource1_ValuePushed
'...
Private Sub unboundSource1_ValueNeeded(ByVal sender As Object, ByVal e As DevExpress.Data.UnboundSourceValueNeededEventArgs)
    e.Value = something ' Assign the real data here.
End Sub
Private Sub unboundSource1_ValuePushed(ByVal sender As Object, ByVal e As DevExpress.Data.UnboundSourceValuePushedEventArgs)
    something = e.Value ' Propagate the value into the storage.
End Sub

Use the UnboundSource methods (UnboundSource.Add, UnboundSource.Move, UnboundSource.InsertAt, UnboundSource.RemoveAt, etc.) to notify the bound control that the data is changed.

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the UnboundSource class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

XDL_how-to-utilize-the-unboundsource-component-in-code-t474976/CS/UnboundDS-Code/Form1.cs#L19

public void CreateDS() {
    UnboundSource unboundDS = new UnboundSource();
    UnboundSourceProperty unboundSourceProperty1 = new UnboundSourceProperty() { DisplayName = "ID", Name = "Int", PropertyType = typeof(int) };

VB.NET

XDL_how-to-utilize-the-unboundsource-component-in-code-t474976/VB/UnboundDS-Code/Form1.vb#L21

Public Sub CreateDS()
    Dim unboundDS As New UnboundSource()
    Dim unboundSourceProperty1 As New UnboundSourceProperty() With {.DisplayName = "ID", .Name = "Int", .PropertyType = GetType(Integer)}

Inheritance

Object

MarshalByRefObject

Component

UnboundSource