GetQueryableEventArgs.QueryableSource Property

Gets or sets the queryable data source.

Namespace: DevExpress.Data.Linq

Assembly: DevExpress.Data.v24.1.dll

NuGet Package: DevExpress.Data

Declaration

C#

public IQueryable QueryableSource { get; set; }

VB.NET

Public Property QueryableSource As IQueryable

Property Value

Type	Description
IQueryable	An object that implements the IQueryable interface.

Remarks

Use this property in a LinqInstantFeedbackSource.GetQueryable event handler to supply a queryable source that is connected to the required data store, to the LinqInstantFeedbackSource.

Example

This example demonstrates how to initialize a LinqInstantFeedbackSource, to retrieve data from a “Purchasing.PurchaseOrderHeader” data table (included in the AdventureWorks database shipped with MS SQL Server). The PurchaseOrderHeader persistent class is declared, and mapped to the “Purchasing.PurchaseOrderHeader” data table using the System.Data.Linq.Mapping.TableAttribute attribute. Then, a System.Data.Linq.Table<PurchaseOrderHeader> is passed to the LinqInstantFeedbackSource in the LinqInstantFeedbackSource.GetQueryable event handler.

C#

using System.ComponentModel;
using System.Data.Linq;
using System.Data.Linq.Mapping;
using DevExpress.Data.Linq;

// The class describing the "Purchasing.PurchaseOrderHeader" table 
// from the AdventureWorks SQL database
[Table(Name="Purchasing.PurchaseOrderHeader")]
public partial class PurchaseOrderHeader : INotifyPropertyChanging, INotifyPropertyChanged {
    //...
    [Column(Storage="_PurchaseOrderID", AutoSync=AutoSync.OnInsert, 
        DbType="Int NOT NULL IDENTITY", 
        IsPrimaryKey=true, IsDbGenerated=true)]
    // The property mapped to the primary key column
    public int PurchaseOrderID {
    //...
    }
    //...
}

// The class describing the AdventureWorks SQL database
[DatabaseAttribute(Name="AdventureWorks")]
public partial class AdvWorksDataContext : DataContext {
    //...
    public System.Data.Linq.Table<PurchaseOrderHeader> PurchaseOrderHeaders {
        get {
            return this.GetTable<PurchaseOrderHeader>();
        }
    }
    //...
}

public partial class Form1 : Form {
    //...
    private void Form1_Load(object sender, EventArgs e) {
        // Specify the key property of the PurchaseOrderHeader
        linqInstantFeedbackSource1.KeyExpression = "PurchaseOrderID";
        // Handle the GetQueryable event, to create a DataContext and assign a queryable source
        linqInstantFeedbackSource1.GetQueryable += linqInstantFeedbackSource1_GetQueryable;
        // Handle the DismissQueryable event, to dispose of the DataContext
        linqInstantFeedbackSource1.DismissQueryable += linqInstantFeedbackSource1_DismissQueryable;
        // Assign the created data source to an XtraGrid
        gridControl1.DataSource = linqInstantFeedbackSource1;
    }
    void linqInstantFeedbackSource1_GetQueryable(object sender, GetQueryableEventArgs e) {
        // Instantiate a new DataContext
        AdvWorksDataContext dataContext = new AdvWorksDataContext();
        // Assign a queryable source to the LinqInstantFeedbackSource
        e.QueryableSource = dataContext.PurchaseOrderHeaders;
        // Assign the DataContext to the Tag property, 
        // to dispose of it in the DismissQueryable event handler
        e.Tag = dataContext;            
    }
    void linqInstantFeedbackSource1_DismissQueryable(object sender, GetQueryableEventArgs e) {
        // Dispose of the DataContext
        ((AdvWorksDataContext)e.Tag).Dispose();         
    }
}

VB.NET

Imports System.ComponentModel
Imports System.Data.Linq
Imports System.Data.Linq.Mapping
Imports DevExpress.Data.Linq

' The class describing the "Purchasing.PurchaseOrderHeader" table 
' from the AdventureWorks SQL database
<Table(Name:="Purchasing.PurchaseOrderHeader")> _
Partial Public Class PurchaseOrderHeader
    Implements INotifyPropertyChanging, INotifyPropertyChanged
    '...
    ' The property mapped to the primary key column
    <Column(Storage:="_PurchaseOrderID", AutoSync:=AutoSync.OnInsert, _
    DbType:="Int NOT NULL IDENTITY", _
    IsPrimaryKey:=True, IsDbGenerated:=True)> _
    Public ReadOnly Property PurchaseOrderID() As Integer
    '...
    End Property
    '...
End Class

' The class describing the AdventureWorks SQL database
<DatabaseAttribute(Name:="AdventureWorks")> _
Partial Public Class AdvWorksDataContext
    Inherits DataContext
    '...
    Public ReadOnly Property PurchaseOrderHeaders() As Table(Of PurchaseOrderHeader)
        Get
            Return Me.GetTable(Of PurchaseOrderHeader)()
        End Get
    End Property
    '...
End Class

Partial Public Class Form1
    Inherits Form
    '...
    Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
        ' Specify the key property of the PurchaseOrderHeader
        linqInstantFeedbackSource1.KeyExpression = "PurchaseOrderID"
        ' Handle the GetQueryable event, to create a DataContext and assign a queryable source
        AddHandler linqInstantFeedbackSource1.GetQueryable, _
        AddressOf linqInstantFeedbackSource1_GetQueryable
        ' Handle the DismissQueryable event, to dispose of the DataContext
        AddHandler linqInstantFeedbackSource1.DismissQueryable, _
        AddressOf linqInstantFeedbackSource1_DismissQueryable
        ' Assign the created data source to an XtraGrid
        gridControl1.DataSource = linqInstantFeedbackSource1
    End Sub
    Private Sub linqInstantFeedbackSource1_GetQueryable(ByVal sender As Object, _
    ByVal e As GetQueryableEventArgs)
        ' Instantiate a new DataContext
        Dim dataContext As New AdvWorksDataContext()
        ' Assign a queryable source to the LinqInstantFeedbackSource
        e.QueryableSource = dataContext.PurchaseOrderHeaders
        ' Assign the DataContext to the Tag property, _
        ' to dispose of it in the DismissQueryable event handler
        e.Tag = dataContext
    End Sub
    Private Sub linqInstantFeedbackSource1_DismissQueryable(ByVal sender As Object, _
    ByVal e As GetQueryableEventArgs)
        ' Dispose of the DataContext
        CType(e.Tag, AdvWorksDataContext).Dispose()
    End Sub
End Class

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the QueryableSource property.

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#

how-to-bind-wpf-grid-to-data/CS/CodeBehind/EFCore/InstantFeedbackMode/MainWindow.xaml.cs#L17

    var context = new IssuesContext();
    e.QueryableSource = context.Issues.AsNoTracking();
};

wpf-data-grid-implement-crud-operations/CS/CodeBehind/EntityFramework/InstantFeedbackMode/MainWindow.xaml.cs#L20

    var context = new IssuesContext();
    e.QueryableSource = context.Issues.AsNoTracking();
};

winforms-grid-bind-to-linqinstantfeedbacksource/CS/LinqServerMode/Main.cs#L29

NorthwindClassesDataContext dt = new NorthwindClassesDataContext();
e.QueryableSource = dt.Suppliers;
e.Tag = dt;

winforms-mvvm-expenses-app/CS/MVVMExpenses/Common/DataModel/EntityFramework/DbUnitOfWorkFactory.cs#L35

}
var source = new EntityInstantFeedbackSource((GetQueryableEventArgs e) => e.QueryableSource = projection(getRepositoryFunc(createUnitOfWork()))) {
    KeyExpression = getRepositoryFunc(createUnitOfWork()).GetPrimaryKeyPropertyName(),

VB.NET

how-to-bind-wpf-grid-to-data/VB/CodeBehind/EFCore/InstantFeedbackMode/MainWindow.xaml.vb#L14

    Dim context = New IssuesContext()
    e.QueryableSource = context.Issues.AsNoTracking()
End Sub

winforms-grid-bind-to-linqinstantfeedbacksource/VB/LinqServerMode/Main.vb#L19

Dim dt As NorthwindClassesDataContext = New NorthwindClassesDataContext()
e.QueryableSource = dt.Suppliers
e.Tag = dt

winforms-mvvm-expenses-app/VB/MVVMExpenses/Common/DataModel/EntityFramework/DbUnitOfWorkFactory.vb#L30

End If
Dim source = New EntityInstantFeedbackSource(Sub(e As GetQueryableEventArgs) e.QueryableSource = projection(getRepositoryFunc(_createUnitOfWork()))) With {.KeyExpression = getRepositoryFunc(_createUnitOfWork()).GetPrimaryKeyPropertyName()}
Return New InstantFeedbackSource(Of TProjection)(source, threadSafeProperties)