Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

ObjectContext.CreateQuery<T> Method

Creates an ObjectQuery<T> in the current object context by using the specified query string.

Namespace:  System.Data.Objects
Assembly:  System.Data.Entity (in System.Data.Entity.dll)

public ObjectQuery<T> CreateQuery<T>(
	string queryString,
	params ObjectParameter[] parameters
)

Type Parameters

T

The entity type of the returned ObjectQuery<T>.

Parameters

queryString
Type: System.String

The query string to be executed.

parameters
Type: System.Data.Objects.ObjectParameter[]

Parameters to pass to the query.

Return Value

Type: System.Data.Objects.ObjectQuery<T>
An ObjectQuery<T> of the specified type.

ExceptionCondition
ArgumentNullException

The queryString or parameters parameter is null.

Use CreateQuery<T> to create an ObjectQuery<T> of the specified type that belongs to the current object context.

This example is based on the Adventure Works Sales Model.

The example creates a simple query and iterates through the collection of results.

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    string queryString =
        @"SELECT VALUE contact FROM AdventureWorksEntities.Contacts 
            AS contact WHERE contact.FirstName = @fn";

    ObjectQuery<Contact> contactQuery =
        context.CreateQuery<Contact>(queryString,
            new ObjectParameter("fn", "Frances"));

    // Iterate through the collection of Contact items. 
    foreach (Contact result in contactQuery)
        Console.WriteLine("First Name: {0}, Last Name: {1}",
        result.FirstName, result.LastName);
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5 SP1

.NET Framework Client Profile

Supported in: 4
Show:
© 2015 Microsoft