EntityDataSource.CommandText Propiedad

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.Entity.dll

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

public:
 property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };

public string CommandText { get; set; }

member this.CommandText : string with get, set

Public Property CommandText As String

Valor de propiedad

String

Valor string que es la consulta de Entity SQL.

Ejemplos

En el ejemplo siguiente se usa el comando Entity SQL proporcionado para devolver 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>

Comentarios

La CommandText propiedad del EntityDataSource control permite especificar una consulta que usa 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 son actualizables.

Cuando se asigna la propiedad, se deshabilitan las CommandText funcionalidades de actualización, inserción y eliminación. En este caso, los métodos CanDelete, CanInserty CanUpdate del control relacionado EntityDataSourceView devuelven falsetodos .

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

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