ObjectQuery<T>.SelectValue<TResultType>(String, ObjectParameter[]) Método

Definição

Limita os resultados da consulta à propriedade especificada na projeção.Limits the query results to only the property specified in the projection.

public:
generic <typename TResultType>
 System::Data::Objects::ObjectQuery<TResultType> ^ SelectValue(System::String ^ projection, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);
public System.Data.Objects.ObjectQuery<TResultType> SelectValue<TResultType> (string projection, params System.Data.Objects.ObjectParameter[] parameters);
member this.SelectValue : string * System.Data.Objects.ObjectParameter[] -> System.Data.Objects.ObjectQuery<'ResultType>
Public Function SelectValue(Of TResultType) (projection As String, ParamArray parameters As ObjectParameter()) As ObjectQuery(Of TResultType)

Parâmetros de tipo

TResultType

O tipo de ObjectQuery<T> retornado pelo método SelectValue<TResultType>(String, ObjectParameter[]).The type of the ObjectQuery<T> returned by the SelectValue<TResultType>(String, ObjectParameter[]) method.

Parâmetros

projection
String

A lista de projeção.The projection list.

parameters
ObjectParameter[]

Um conjunto opcional de parâmetros de consulta que devem estar no escopo durante a análise.An optional set of query parameters that should be in scope when parsing.

Retornos

ObjectQuery<TResultType>

Uma nova instância de ObjectQuery<T> de um tipo compatível com a projeção específica.A new ObjectQuery<T> instance of a type compatible with the specific projection. O ObjectQuery<T> retornado é equivalente à instância original com SELECT VALUE aplicado.The returned ObjectQuery<T> is equivalent to the original instance with SELECT VALUE applied.

Exceções

projection é null.projection is null.

- ou --or-

parameters é null.parameters is null.

O projection é uma cadeia de caracteres vazia.The projection is an empty string.

Exemplos

Este exemplo é baseado no Microsoft SQL Server exemplos de produto: banco de dados.This example is based on the Microsoft SQL Server Product Samples: Database. O exemplo cria um novo ObjectQuery<T> que contém resultados que são uma sequência de valores de ProductID projetadas a partir dos resultados da consulta existente.The example creates a new ObjectQuery<T> that contains results that are a sequence of ProductID values projected from the results of the existing query.

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    string queryString =
        @"SELECT VALUE product FROM 
            AdventureWorksEntities.Products AS product";

    ObjectQuery<Product> productQuery1 =
        new ObjectQuery<Product>(queryString,
            context, MergeOption.NoTracking);

    ObjectQuery<Int32> productQuery2 =
        productQuery1.SelectValue<Int32>("it.ProductID");

    foreach (Int32 result in productQuery2)
    {
        Console.WriteLine("{0}", result);
    }
}
Using context As New AdventureWorksEntities()
    Dim queryString As String = "SELECT VALUE product FROM AdventureWorksEntities.Products AS product"

    Dim productQuery1 As New ObjectQuery(Of Product)(queryString, context, MergeOption.NoTracking)

    Dim productQuery2 As ObjectQuery(Of Int32) = productQuery1.SelectValue(Of Int32)("it.ProductID")

    For Each result As Int32 In productQuery2
        Console.WriteLine("{0}", result)
    Next
End Using

Comentários

SelectValue é usado para retornar valores que são tipos simples, tipos de entidade ou tipos complexos.SelectValue is used to return values that are simple types, entity types, or complex types. Use o método Select para projeções que exigem um tipo de linha em vez de um tipo de valor.Use the Select method for projections that require a row type instead of a value type. Para obter mais informações, consulte consultas de objeto.For more information, see Object Queries.

O método SelectValue aplica a projeção especificada pelo parâmetro projection.The SelectValue method applies the projection specified by the projection parameter. O ObjectQuery<T> retornado pelo método SelectValue deve ser de um tipo de valor compatível com a projeção e deve ser do mesmo tipo que o tipo de SelectValue.The ObjectQuery<T> returned by the SelectValue method must be of a value type that is compatible with the projection and must be the same type as the type of SelectValue.

Aplica-se a

Veja também