SelectQueryFluentBuilder.Build(String) Method

Ends the chain of methods specified for a SelectQueryFluentBuilder.

Namespace: DevExpress.DataAccess.Sql

Assembly: DevExpress.DataAccess.v20.2.dll

NuGet Packages: DevExpress.DataAccess, DevExpress.WindowsDesktop.DataAccess

Declaration

C#

public SelectQuery Build(
    string queryName
)

VB.NET

Public Function Build(
    queryName As String
) As SelectQuery

Parameters

Name	Type	Description
queryName	String	A String value, specifying the query name.

Returns

Type	Description
SelectQuery	A SelectQuery object.

Remarks

The chain of SelectQueryFluentBuilder methods must end with calling the Build method accepting the query name as a parameter.

In the following example, a query selects and orders records from a single data table.

C#

using DevExpress.DataAccess.ConnectionParameters;
using DevExpress.DataAccess.Sql;
// ... 

private SqlDataSource BindToData() {
    // Create a data source with the required connection parameters. 
    Access97ConnectionParameters connectionParameters =
    new Access97ConnectionParameters("../../Data/nwind.mdb", "", "");
    SqlDataSource ds = new SqlDataSource(connectionParameters);

    // Return a list of categories sorted by the number of products in each category. 
    // The chain ends with calling the Build method accepting the query name as a parameter.
    SelectQuery query = SelectQueryFluentBuilder
        .AddTable("Products")
        .SelectColumn("CategoryID")
        .GroupBy("CategoryID")
        .SortBy("ProductID", AggregationType.Count, System.ComponentModel.ListSortDirection.Descending)
        .Filter("[CategoryID] != 8")
        .Build("MyQuery");

    // Add the query to the collection and return the data source. 
    ds.Queries.Add(query);
    return ds;
}

VB.NET

Imports DevExpress.DataAccess.ConnectionParameters
Imports DevExpress.DataAccess.Sql
' ... 

Private Function BindToData() As SqlDataSource
    ' Create a data source with the required connection parameters.  
    Dim connectionParameters As New Access97ConnectionParameters("../../Data/nwind.mdb", "", "")
    Dim ds As New SqlDataSource(connectionParameters)

    ' Return a list of categories sorted by the number of products in each category.  
    ' The chain ends with calling the Build method accepting the query name as a parameter. 
    Dim query As SelectQuery = SelectQueryFluentBuilder.
        AddTable("Products").
        SelectColumn("CategoryID").
        GroupBy("CategoryID").
        SortBy("ProductID", AggregationType.Count, System.ComponentModel.ListSortDirection.Descending).
        Filter("[CategoryID] != 8").
        Build("MyQuery")

    ' Add the query to the collection and return the data source.  
    ds.Queries.Add(query)
    Return ds
End Function

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Build(String) method.

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-create-data-access-library-data-sources-at-runtime-t424210/CS/SqlDataSourceSnippets/Code.cs#L25

{
    SelectQuery query = SelectQueryFluentBuilder
                        .AddTable("Categories")

DashboardUserBasedMVC/CS/MVCDashboard/Code/CustomDataSourceStorage.cs#L20

DashboardSqlDataSource sqlDataSource1 = new DashboardSqlDataSource(sqlDataSourceId1, "NorthwindConnectionString");
SelectQuery query1 = SelectQueryFluentBuilder
    .AddTable("Categories")

how-to-bind-a-bound-image-dashboard-item-to-data-in-code-t382366/CS/Dashboard_BoundImage/Form1.cs#L17

DashboardSqlDataSource xmlDataSource = new DashboardSqlDataSource("Data Source 1", xmlParams);
SelectQuery selectQuery = SelectQueryFluentBuilder
    .AddTable("Products")

how-to-bind-a-dashboard-to-a-sql-database-using-dashboardsqldatasource-e5107/CS/Dashboard_DashboardDataProviders/Form1.cs#L48

case "fluent":
    return SelectQueryFluentBuilder
        .AddTable("SalesPersons")

how-to-combine-filter-elements-to-a-group-and-bind-them-to-data-t191632/CS/Dashboard_FilterElements_and_Groups/Form1.cs#L23

    new XmlFileConnectionParameters(@"..\..\Data\WebsiteStatisticsData.xml");
SelectQuery selectQuery = SelectQueryFluentBuilder
    .AddTable("Data")

VB.NET

how-to-create-data-access-library-data-sources-at-runtime-t424210/VB/SqlDataSourceSnippets/Code.vb#L21

Private Sub SelectQueryCreation()
    Dim query As SelectQuery = SelectQueryFluentBuilder.AddTable("Categories").SelectColumn("CategoryName").GroupBy("CategoryName").Join("Products", "CategoryID").SelectColumn("ProductName", AggregationType.Count, "ProductCount").SortBy("ProductName", AggregationType.Count, System.ComponentModel.ListSortDirection.Descending).GroupFilter("[ProductCount] > 7").Build("Categories")
    DataSource.Queries.Add(query)

how-to-bind-a-dashboard-to-a-sql-database-using-dashboardsqldatasource-e5107/VB/Dashboard_DashboardDataProviders/Form1.vb#L33

Case "fluent"
    Return SelectQueryFluentBuilder.AddTable("SalesPersons").SelectColumns("CategoryName", "SalesPerson", "OrderDate", "ExtendedPrice").Build("Query 1")
Case Else

how-to-combine-filter-elements-to-a-group-and-bind-them-to-data-t191632/VB/Dashboard_FilterElements_and_Groups/Form1.vb#L24

dataSource.ConnectionParameters = New XmlFileConnectionParameters("..\..\Data\WebsiteStatisticsData.xml")
Dim selectQuery As SelectQuery = SelectQueryFluentBuilder.AddTable("Data").SelectColumns("Browser", "BrowserDetails", "Date", "Count").Build("Statistics")
dataSource.Queries.Add(selectQuery)

Reporting_how-to-obtain-the-sql-string-that-has-been-automatically-constructed-for-a-table-t188966/VB/TableQueryGetSql/XtraReport1.vb#L23

' Create a query and assign it to the data source.
Dim query As SelectQuery = SelectQueryFluentBuilder.AddTable("Categories").SelectColumns("CategoryID", "CategoryName").Build("MyQuery")
sqlDataSource.Queries.Add(query)

asp-net-web-forms-dashboard-switch-between-designer-and-viewer-on-client/VB/Dashboard_WebDashboard_2010/WebForm1.aspx.vb#L20

Dim sqlDataSource As New DashboardSqlDataSource("SQL Data Source", "sqlConnection")
Dim countriesQuery As SelectQuery = SelectQueryFluentBuilder.AddTable("Countries").SelectColumns("Country", "Latitude", "Longitude", "Year", "EnergyType", "Production", "Import").Build("Countries")
sqlDataSource.Queries.Add(countriesQuery)