ObjectContext.CreateQuery<T>(String, ObjectParameter[]) Method

Reference

Definition

Namespace:: System.Data.Objects

Assembly:: System.Data.Entity.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

public:
generic <typename T>
 System::Data::Objects::ObjectQuery<T> ^ CreateQuery(System::String ^ queryString, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);

public System.Data.Objects.ObjectQuery<T> CreateQuery<T> (string queryString, params System.Data.Objects.ObjectParameter[] parameters);

member this.CreateQuery : string * System.Data.Objects.ObjectParameter[] -> System.Data.Objects.ObjectQuery<'T>

Public Function CreateQuery(Of T) (queryString As String, ParamArray parameters As ObjectParameter()) As ObjectQuery(Of T)

Type Parameters

T

The entity type of the returned ObjectQuery<T>.

Parameters

queryString: String

The query string to be executed.

parameters: ObjectParameter[]

Parameters to pass to the query.

Returns

ObjectQuery<T>

An ObjectQuery<T> of the specified type.

Exceptions

ArgumentNullException

The queryString or parameters parameter is null.

Examples

This 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);
}

Remarks

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

Applies to

Del via