Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Propiedad EntityDataSource.CommandText

 

Publicado: octubre de 2016

Obtiene o establece un comando de Entity SQL que define la consulta.

Espacio de nombres:   System.Web.UI.WebControls
Ensamblado:  System.Web.Entity (en System.Web.Entity.dll)

public string CommandText { get; set; }

Valor de propiedad

Type: System.String

Un string valor que es la consulta de Entity SQL.

El CommandText propiedad de la EntityDataSource control le permite especificar una consulta que utiliza una expresión de Entity SQL personalizada. Al igual que la instrucción SELECT, CommandText crea una proyección de los datos originales que no es actualizables.

Cuando el CommandText se asigna la propiedad, update, insert y delete funcionalidades están deshabilitadas. En este caso, los métodos CanDelete, CanInsert, y CanUpdate los EntityDataSourceView control devuelto todos los false.

Cuando el CommandText se establece la propiedad, se produce una excepción cuando el ExecuteSelect método llama a un control que está enlazado a datos un EntityDataSource el control si el valor de EnableInsert, EnableUpdate, o EnableDelete se establece en true.

Si el CommandText se establece en una consulta que devuelve una proyección de propiedades (por ejemplo, "SELECT p.ProductID, p. Name FROM AdventureWorksEntities.Products AS p"), un DbDataRecord se devolverá.

El ejemplo siguiente se utiliza el comando de Entity SQL suministrado para devuelve una colección de objetos Product.

<asp:EntityDataSource ID="ProductDataSource" runat="server" 
    CommandText="SELECT value p FROM Products AS p
        WHERE p.ProductID
        BETWEEN @OrderIdMin AND @OrderIdMax"
    ConnectionString="name=AdventureWorksEntities" 
    DefaultContainerName="AdventureWorksEntities" >
    <CommandParameters>
        <asp:ControlParameter Name="OrderIdMin" 
            ControlID="ProductIdMin" Type="Int32"/>
        <asp:ControlParameter Name="OrderIdMax" 
            ControlID="ProductIdMax" Type="Int32" />
    </CommandParameters>
</asp:EntityDataSource>

En el ejemplo siguiente se devuelve una serie proyectada de columnas:

<asp:EntityDataSource ID="ProductDataSource" runat="server" 
    CommandText="SELECT p.ProductID, p.ProductName, p.UnitsOnOrder
          FROM Products AS p 
          WHERE p.ProductID BETWEEN @OrderIDMin AND @OrderIDMax" 
          ContextTypeName="AdventureWorksModel. AdventureWorksEntities">
    <CommandParameters>
        <asp:ControlParameter Name="OrderIDMin" 
                ControlID="ProductIDMinTextBox" Type="Int32"/>
        <asp:ControlParameter Name="OrderIDMax" 
                ControlID="ProductIDMaxTextBox" Type="Int32" />
    </CommandParameters>
</asp:EntityDataSource>

.NET Framework
Disponible desde 3.5
Volver al principio
Mostrar: