MongoDBDataSourceBase.Fill(String[]) Method

Executes the specified queries and loads data from a MongoDB instance.

Namespace: DevExpress.DataAccess.MongoDB

Assembly: DevExpress.DataAccess.v24.2.dll

Declaration

C#

public void Fill(
    string[] queriesToFill
)

VB.NET

Public Sub Fill(
    queriesToFill As String()
)

Parameters

Name	Type	Description
queriesToFill	String[]	An array of query names. A Fill method call executes queries with these names.

Remarks

A MongoDB data source stores a collection of queries to database collections of a MongoDB instance. Call the Fill method to execute these queries and load data from the MongoDB instance to the data source. You can also call the FillAsync() method to load data asynchronously.

Example

The example below demonstrates how to use the MongoDBDataSource class to bind an application or component to a MongoDB instance. The example uses the MongoDBCustomConnectionParameters class to specify a connection string to the MongoDB instance and the MongoDBQuery class to specify data queries to the Categories and Products collections of the Northwind database. The example shows how to use the Fill(String[]) method to execute individual queries.

C#

using DevExpress.DataAccess.ConnectionParameters;
using DevExpress.DataAccess.MongoDB;
using DevExpress.DataAccess;
using DevExpress.DataAccess.ObjectBinding;
// ...
// Create an object to store a connection string to a MongoDB instance.
var connectionParameters = new MongoDBCustomConnectionParameters() {
    ConnectionString = "mongodb://localhost:27017"
};

// Specify queries to database collections.
var queryCategories = new MongoDBQuery() {
    DatabaseName = "Northwind",
    CollectionName = "Categories",
};

var queryProducts = new MongoDBQuery() {
    DatabaseName = "Northwind",
    CollectionName = "Products",
};

// Create a MongoDBDataSource object. Assign the created connection
// string and queries to the object's ConnectionParameters and
// Queries properties.
var mongoDBDataSource = new MongoDBDataSource() {
    ConnectionParameters = connectionParameters,
    Queries = { queryProducts, queryCategories },
};

// Specify an array of query names. The queries with these name are executed
// after the Fill method is called.
var queriesToFill = new[] { "Products" };

// Call the Fill method of the MongoDBDataSource object to execute queries
// and load data from the MongoDB instance. Pass the array of query names to
// this method.
mongoDBDataSource.Fill(queriesToFill);

// Use the created object as a data source in your application/component.
//...

VB.NET

Imports DevExpress.DataAccess.ConnectionParameters
Imports DevExpress.DataAccess.MongoDB
Imports DevExpress.DataAccess
Imports DevExpress.DataAccess.ObjectBinding
' ...
' Create an object to store a connection string to a MongoDB instance.
Dim connectionParameters = New MongoDBCustomConnectionParameters() With {
    .ConnectionString = "mongodb://localhost:27017"
}

' Specify queries to database collections.
Dim queryCategories = New MongoDBQuery() With {
    .DatabaseName = "Northwind",
    .CollectionName = "Categories"
}

Dim queryProducts = New MongoDBQuery() With {
    .DatabaseName = "Northwind",
    .CollectionName = "Products"
}

' Create a MongoDBDataSource object. Assign the created connection
' string and queries to the object's ConnectionParameters and
' Queries properties.
Dim mongoDBDataSource = New MongoDBDataSource() With {
    .ConnectionParameters = connectionParameters
}

mongoDBDataSource.Queries.Add(queryProducts)
mongoDBDataSource.Queries.Add(queryCategories)

' Specify an array of query names. The queries with these name are executed
' after the Fill method is called.
Dim queriesToFill = {"Products"}

' Call the Fill method of the MongoDBDataSource object to execute queries
' and load data from the MongoDB instance. Pass the array of query names to
' this method.
mongoDBDataSource.Fill(queriesToFill)

' Use the created object as a data source in your application/component.
'...