Compartir vía


LinqDataSource Clase

Definición

Habilita el uso de Language Integrated Query (LINQ) en una página web de ASP.NET a través de texto de marcado para recuperar y modificar datos de un objeto de datos.

public ref class LinqDataSource : System::Web::UI::DataSourceControl, System::Web::DynamicData::IDynamicDataSource
public ref class LinqDataSource : System::Web::UI::WebControls::ContextDataSource, System::Web::DynamicData::IDynamicDataSource
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.ico")]
public class LinqDataSource : System.Web.UI.DataSourceControl, System.Web.DynamicData.IDynamicDataSource
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.bmp")]
public class LinqDataSource : System.Web.UI.WebControls.ContextDataSource, System.Web.DynamicData.IDynamicDataSource
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.ico")>]
type LinqDataSource = class
    inherit DataSourceControl
    interface IDynamicDataSource
    interface IDataSource
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.LinqDataSource), "LinqDataSource.bmp")>]
type LinqDataSource = class
    inherit ContextDataSource
    interface IDynamicDataSource
    interface IDataSource
Public Class LinqDataSource
Inherits DataSourceControl
Implements IDynamicDataSource
Public Class LinqDataSource
Inherits ContextDataSource
Implements IDynamicDataSource
Herencia
Herencia
Atributos
Implementaciones

Ejemplos

En el ejemplo siguiente se muestra un LinqDataSource control que recupera datos de una clase de entidad denominada Products. La clase de entidad podría haberse generado mediante el Designer O/R o la utilidad SqlMetal.exe. La Where propiedad se establece para devolver solo los registros que tienen un valor en la Price propiedad mayor que 50. Un GridView control está enlazado al LinqDataSource control para mostrar los datos.

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > 50"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > 50"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

En el ejemplo siguiente se muestra un LinqDataSource control que permite a los usuarios actualizar, eliminar e insertar registros en el origen de datos. Un DetailsView control está enlazado al LinqDataSource control y permite a los usuarios ver y modificar los datos. Tenga en cuenta que no se requieren comandos SQL para seleccionar, actualizar, eliminar o insertar los registros.

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    EnableUpdate="true"
    EnableInsert="true"
    EnableDelete="true"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:DetailsView 
    DataKeyNames="ProductID"
    AutoGenerateEditButton="true"
    AutoGenerateDeleteButton="true"
    AutoGenerateInsertButton="true"
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:DetailsView>

En el ejemplo siguiente se muestra un controlador de eventos para el Selecting evento que establece el objeto de datos basado en un valor de la página web.

public partial class Default3 : System.Web.UI.Page
{
    string[] citiesArray = 
    { 
        "Atlanta", 
        "Charlotte", 
        "Denver", 
        "New York", 
        "San Francisco" 
    };

    protected void Page_Load(object sender, EventArgs e)
    {
    }

    protected void LinqDataSource_Selecting(object sender, LinqDataSourceSelectEventArgs e)
    {
        var cities = from city in citiesArray
                     where city.CompareTo("B") > 0
                     select city;
        e.Result = cities;
        // Or we could set e.Result = citiesArray to return all rows.
    }
}
Partial Class Default3
    Inherits System.Web.UI.Page

    Dim citiesArray() As String = _
    { _
        "Atlanta", _
        "Charlotte", _
        "Denver", _
        "New York", _
        "San Francisco" _
    }


    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load
       
    End Sub

    
    Protected Sub LinqDataSource_Selecting(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceSelectEventArgs) Handles LinqDataSource1.Selecting
        Dim cities = From city In citiesArray _
                     Where city > "B" _
                     Select city
        e.Result = cities
        ' Or we could set e.Result = citiesArray to return all rows.
    End Sub
    
End Class

En el ejemplo siguiente se muestra un LinqDataSource control configurado para agrupar por dos columnas. La Key propiedad hace referencia a un objeto que tiene dos propiedades y ProductCategoryColor. Se cambia el nombre del objeto representado por It (con alias) a Products. El objeto cuyo nombre ha cambiado Products contiene una colección de los registros individuales de una agrupación. Cada instancia contendrá todas las columnas de la Products tabla.

<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>
<asp:LinqDataSource 
  ContextTypeName="ExampleDataContext" 
  TableName="Products" 
  GroupBy="new(ProductCategory, Color)"
  Select="new(Key,
          It As Products,
          Max(ListPrice) As MaxListPrice, 
          Min(ListPrice) As MinListPrice)"
  ID="LinqDataSource1" 
  runat="server">
</asp:LinqDataSource>

En el ejemplo siguiente se muestran dos ListView controles que muestran los datos del LinqDataSource control en el ejemplo anterior. Un ListView control muestra los datos agrupados y el otro ListView control muestra los nombres individuales de los productos que pertenecen a ese grupo. La propiedad del DataSource control enlazado a datos anidada se establece Productsen , que es el alias del It objeto .

<asp:ListView 
    DataSourceID="LinqDataSource1" 
    ID="ListView1" runat="server">

    <LayoutTemplate>
      <table id="Table1" 
          style="background-color:Teal;color:White" 
          runat="server" 
          class="Layout">
          
        <thead>
          <tr>
            <th><b>Product Category</b></th>
            <th><b>Color</b></th>
            <th><b>Highest Price</b></th>
            <th><b>Lowest Price</b></th>
          </tr>
        </thead>
        <tr runat="server" id="itemPlaceholder">
        </tr>
        
      </table>
    </LayoutTemplate>

    <ItemTemplate>
      <tr>
        <td><%# Eval("key.ProductCategory") %></td>
        <td><%# Eval("key.Color") %></td>
        <td><%# Eval("MaxListPrice") %></td>
        <td><%# Eval("MinListPrice") %></td>
      </tr>
      <tr>
        
        <td colspan="4" style="width:100%;background-color:White;color:Black">
          <asp:ListView 
            DataSource='<%# Eval("Products") %>' 
            runat="server" 
            ID="ListView2">

            <LayoutTemplate>
              <div runat="server" id="itemPlaceholder" />
            </LayoutTemplate>

            <ItemTemplate>
              <%# Eval("ProductName") %><br />
            </ItemTemplate>

          </asp:ListView> 
        </td>
      </tr>
    </ItemTemplate>
  </asp:ListView>
<asp:ListView 
   DataSourceID="LinqDataSource1" 
   ID="ListView1" runat="server">

   <LayoutTemplate>
     <table id="Table1" 
         style="background-color:Teal;color:White" 
         runat="server" 
         class="Layout">
         
       <thead>
         <tr>
           <th><b>Product Category</b></th>
           <th><b>Color</b></th>
           <th><b>Highest Price</b></th>
           <th><b>Lowest Price</b></th>
         </tr>
       </thead>
       <tr runat="server" id="itemPlaceholder">
       </tr>
       
     </table>
   </LayoutTemplate>

   <ItemTemplate>
     <tr>
       <td><%# Eval("key.ProductCategory") %></td>
       <td><%# Eval("key.Color") %></td>
       <td><%# Eval("MaxListPrice") %></td>
       <td><%# Eval("MinListPrice") %></td>
     </tr>
     <tr>
       
       <td colspan="4" style="width:100%;background-color:White;color:Black">
         <asp:ListView 
           DataSource='<%# Eval("Products") %>' 
           runat="server" 
           ID="ListView2">

           <LayoutTemplate>
             <div runat="server" id="itemPlaceholder" />
           </LayoutTemplate>

           <ItemTemplate>
             <%# Eval("ProductName") %><br />
           </ItemTemplate>

         </asp:ListView> 
       </td>
     </tr>
   </ItemTemplate>
 </asp:ListView>

Comentarios

En este tema:

Introducción

Language-Integrated Query (LINQ) es una sintaxis de consulta que define un conjunto de operadores de consulta que permiten que las operaciones de recorrido, filtro y proyección se expresen de forma declarativa en cualquier . Lenguaje de programación basado en NET. El objeto de datos puede ser una colección de datos en memoria o un objeto que representa los datos de una base de datos. Puede recuperar o modificar los datos sin tener que escribir comandos SQL para cada operación.

El LinqDataSource control permite usar LINQ en una página web de ASP.NET estableciendo propiedades en texto de marcado. El LinqDataSource control usa LINQ to SQL para generar automáticamente los comandos de datos. Para obtener más información sobre LINQ to SQL, consulte LINQ to SQL.

Cuando se recuperan datos de una colección de datos en memoria, se establece la ContextTypeName propiedad en la clase que contiene la colección de datos. La propiedad se establece TableName en la propiedad o campo que devuelve la colección de datos. Por ejemplo, podría tener una clase denominada Person que contiene una propiedad denominada FavoriteCities que devuelve una matriz de valores de cadena. En ese caso, establezca la ContextTypeName propiedad Person en y establezca la TableName propiedad en FavoriteCities.

Al consultar una base de datos, primero debe crear clases de entidad que representen la base de datos y sus tablas. Puede usar el Object Relational Designer o la utilidad SqlMetal.exe para generar estas clases. A continuación, establezca la ContextTypeName propiedad en la clase que representa la base de datos y establezca la TableName propiedad en la propiedad que representa la tabla de base de datos.

Orden de las operaciones

El LinqDataSource control aplica las operaciones de datos en el orden siguiente:

  1. Dónde (especifique qué registros de datos se van a devolver).

  2. Ordenar por (ordenación).

  3. Agrupar por (agregar registros de datos que comparten valores).

  4. Ordenar grupos por (ordenar datos agrupados).

  5. Seleccione (especifique qué campos o propiedades se van a devolver).

  6. Ordenar automáticamente (ordenar los registros de datos por una propiedad que el usuario ha seleccionado).

  7. Página automática (recupere un subconjunto de registros de datos seleccionados por el usuario).

Puede agregar condiciones a la Where propiedad para filtrar los registros de datos que se devuelven desde una consulta. Si no se establece la Where propiedad , el LinqDataSource control recupera todos los registros del objeto de datos.

Ordenar datos

La propiedad se usa OrderBy para especificar los nombres de las propiedades de los datos devueltos por los que se va a ordenar.

Nota:

Al usar el LinqDataSource control con SQL Server 2000 o SQL Server Compact 3.5 y la AutoPage propiedad se establece trueen , debe proporcionar un valor en la OrderBy propiedad . De forma predeterminada, la AutoPage propiedad es true. Si asigna un valor a la Select propiedad , también debe incluir todas las columnas de identidad en la lista de propiedades que se devuelven en la consulta.

Agrupar datos

La propiedad se usa GroupBy para especificar qué propiedades se usan para consolidar los registros de datos que tienen los mismos valores. Al agrupar los datos, puede incluir Key y It, que se crean dinámicamente, en la Select propiedad . La Key propiedad hace referencia a los valores de la propiedad o propiedades que se usaron para agrupar los datos. Por ejemplo, si agrupa por una propiedad denominada Category, la Key propiedad contendrá todos los valores únicos de la Category propiedad . La It propiedad hace referencia a una colección de registros individuales en una agrupación de datos. Puede iterar por la It propiedad para recuperar los registros individuales que se han consolidado en la operación de agrupación. Por ejemplo, si agrupa por una propiedad denominada Category, la It propiedad contiene todos los registros individuales que comparten un valor común en la Category propiedad .

Utilice la OrderGroupsBy propiedad para especificar las propiedades que se van a usar para ordenar los datos agrupados. Cuando se agrupan los datos, la OrderBy propiedad especifica cómo se ordenan los registros individuales de los datos agrupados.

De forma predeterminada, el LinqDataSource control recupera los valores de todas las propiedades de un objeto de datos. Use la Select propiedad para especificar qué propiedades se van a devolver si desea trabajar con un subconjunto de propiedades disponibles. La operación Select se aplica después de las operaciones Where, Order By y Group By. Por lo tanto, si crea un nombre con alias en una cláusula Select, el alias no está disponible en las demás cláusulas.

Modificaciones de datos

Puede especificar si las modificaciones de datos están habilitadas mediante las EnableDeletepropiedades , EnableInserty EnableUpdate . Normalmente, la interfaz de usuario para modificar datos de un LinqDataSource control se proporciona a través de un control enlazado a datos, como un DetailsView control . Además de establecer EnableDelete, EnableInserto EnableUpdate en true, se requieren las siguientes condiciones para habilitar las modificaciones automáticas de datos:

Puede restringir las propiedades que se muestran en un control enlazado a datos de dos maneras. Puede establecer la Select propiedad en un subconjunto de propiedades, o bien puede definir los campos de un control enlazado a datos agregando DataControlField controles. Sin embargo, si establece la Select propiedad , significa que no se pueden habilitar las operaciones de actualización, inserción y eliminación automáticas. Si desea habilitar las modificaciones automáticas de datos mientras trabaja con un subconjunto de propiedades disponibles, no establezca la Select propiedad . En su lugar, recupere todas las propiedades del objeto de datos y administre las que se muestran mediante el control enlazado a datos. Al usar el DetailsView control o el GridView control , también debe establecer las AutoGenerateRows propiedades o AutoGenerateColumns en false. Esto impide que el control enlazado a datos incluya automáticamente botones para editar y eliminar los datos. Los valores que no se muestran en el control enlazado a datos se almacenan en estado de vista. Se pasan sin cambios al origen de datos cuando se realiza la actualización de datos.

Evaluación de valores en tiempo de ejecución

Si tiene que evaluar valores en tiempo de ejecución para ordenar, filtrar o agrupar valores, puede agregar parámetros a las WhereParameterscolecciones , GroupByParameters, OrderGroupsByParameterso OrderByParameters .

Si desea especificar valores predeterminados, puede agregar parámetros a la InsertParameters colección.

Si desea examinar o modificar valores antes de ejecutar la operación de datos, puede controlar los Deletingeventos , Inserting, Selectingo Updating . También puede controlar estos eventos para cancelar la operación de datos o examinar los errores de validación que se produjeron al establecer propiedades en la clase de datos en función de la entrada del usuario.

Para examinar los valores una vez finalizada la operación de datos, controle los Deletedeventos , InsertedSelected, o Updated .

Trabajar con procedimientos almacenados

Use el LinqDataSource control para recuperar datos de un procedimiento almacenado mediante la creación de un controlador de eventos para el Selecting evento. En el controlador de eventos, se llama al método en la clase de contexto de datos que representa el procedimiento almacenado y establece el resultado en la Result propiedad del LinqDataSourceSelectEventArgs objeto . Si desea habilitar las operaciones de actualización, inserción y eliminación automáticas para los datos, el tipo que se devuelve del método debe coincidir con el tipo especificado en la TableName propiedad . Para obtener más información sobre cómo crear métodos de contexto de datos, vea How to: Create DataContext methods mapped to stored procedures and functions (O/R Designer).

Sintaxis declarativa

<asp:LinqDataSource  
    AutoGenerateOrderByClause="True|False"  
    AutoGenerateWhereClause="True|False"  
    AutoPage="True|False"  
    AutoSort="True|False"  
    ContextTypeName="string"  
    EnableDelete="True|False"  
    EnableInsert="True|False"  
    EnableTheming="True|False"  
    EnableUpdate="True|False"  
    EnableViewState="True|False"  
    GroupBy="string"  
    ID="string"  
    OnContextCreated="ContextCreated event handler"  
    OnContextCreating="ContextCreating event handler"  
    OnContextDisposing="ContextDisposing event handler"  
    OnDataBinding="DataBinding event handler"  
    OnDeleted="Deleted event handler"  
    OnDeleting="Deleting event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler"  
    OnInserted="Inserted event handler"  
    OnInserting="Inserting event handler"  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnSelected="Selected event handler"  
    OnSelecting="Selecting event handler"  
    OnUnload="Unload event handler"  
    OnUpdated="Updated event handler"  
    OnUpdating="Updating event handler"  
    OrderBy="string"  
    runat="server"  
    Select="string"  
    SkinID="string"  
    StoreOriginalValuesInViewState="True|False"  
    TableName="string"  
    Visible="True|False"  
    Where="string"  
>  
        <GroupByParameters />  
        <InsertParameters />  
        <OrderByParameters />  
        <SelectParameters />  
        <WhereParameters />  
</asp:LinqDataSource>  

Constructores

LinqDataSource()

Inicializa una nueva instancia de la clase LinqDataSource.

Propiedades

Adapter

Obtiene el adaptador específico del explorador para el control.

(Heredado de Control)
AppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control.

(Heredado de Control)
AutoGenerateOrderByClause

Obtiene o establece un valor que indica si el control LinqDataSource crea de forma dinámica una cláusula Order By basándose en valores de la colección OrderByParameters.

AutoGenerateWhereClause

Obtiene o establece un valor que indica si el control LinqDataSource crea dinámicamente una cláusula Where según los valores definidos en la colección WhereParameters.

AutoPage

Obtiene o establece un valor que indica si el control LinqDataSource admite navegación por secciones de los datos en tiempo de ejecución.

AutoSort

Obtiene o establece un valor que indica si el control LinqDataSource admite la ordenación de los datos en tiempo de ejecución.

BindingContainer

Obtiene el control que contiene el enlace de datos de este control.

(Heredado de Control)
ChildControlsCreated

Obtiene un valor que indica si se han creado controles secundarios del control de servidor.

(Heredado de Control)
ClientID

Obtiene el identificador del control de servidor generado por ASP.NET.

(Heredado de DataSourceControl)
ClientIDMode

Esta propiedad no se utiliza para los controles de orígenes de datos.

(Heredado de DataSourceControl)
ClientIDSeparator

Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID.

(Heredado de Control)
Context

Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual.

(Heredado de Control)
ContextTypeName

Obtiene o establece el nombre del tipo que contiene la propiedad cuyo valor tiene los datos que desea recuperar.

Controls

Obtiene un objeto ControlCollection que representa los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario.

(Heredado de DataSourceControl)
DataItemContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer.

(Heredado de Control)
DataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl.

(Heredado de Control)
DeleteParameters

La clase LinqDataSource no emplea esta propiedad.

DesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.

(Heredado de Control)
EnableDelete

Obtiene o establece un valor que indica si los registros de datos se pueden eliminar a través del control LinqDataSource.

EnableInsert

Obtiene o establece un valor que indica si los registros de datos se pueden insertar a través del control LinqDataSource.

EnableObjectTracking

Obtiene o establece el valor que indica si se realiza un seguimiento de los cambios en el objeto de contexto de datos.

EnableTheming

Obtiene un valor que indica si el control admite temas.

(Heredado de DataSourceControl)
EnableUpdate

Obtiene o establece un valor que indica si los registros de datos se pueden actualizar a través del control LinqDataSource.

EnableViewState

Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante.

(Heredado de Control)
EntitySetName

Obtiene o establece el nombre de la propiedad o campo del objeto de origen de datos que representa una recolección de datos.

(Heredado de ContextDataSource)
EntityTypeName

Obtiene o establece el nombre del tipo que se crea para las operaciones de inserción, eliminación y actualización.

(Heredado de ContextDataSource)
Events

Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura.

(Heredado de Control)
GroupBy

Obtiene o establece un valor que especifica qué propiedades se utilizan para agrupar los datos recuperados.

GroupByParameters

Obtiene la colección de parámetros que se usan para crear la cláusula Group By.

HasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista.

(Heredado de Control)
ID

Obtiene o establece el identificador de programación asignado al control de servidor.

(Heredado de Control)
IdSeparator

Obtiene el carácter utilizado para separar los identificadores de control.

(Heredado de Control)
InsertParameters

Obtiene la colección de parámetros que se usan durante una operación de inserción.

IsChildControlStateCleared

Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control.

(Heredado de Control)
IsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista.

(Heredado de Control)
IsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.

(Heredado de Control)
LoadViewStateByID

Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice.

(Heredado de Control)
NamingContainer

Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar los distintos controles de servidor que tienen el mismo valor para la propiedad ID.

(Heredado de Control)
OrderBy

Obtiene o establece un valor que especifica qué campos se utilizan para ordenar los datos recuperados.

OrderByParameters

Obtiene la colección de parámetros que se usan para crear la cláusula Order By.

OrderGroupsBy

Obtiene o establece los campos que se utilizan para ordenar los datos agrupados.

OrderGroupsByParameters

Obtiene la colección de parámetros que se usan para crear la cláusula Order Groups By.

Page

Obtiene una referencia a la instancia Page que contiene el control de servidor.

(Heredado de Control)
Parent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.

(Heredado de Control)
RenderingCompatibility

Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados.

(Heredado de Control)
Select

Obtiene o establece las propiedades y los valores calculados que se incluyen en los datos recuperados.

SelectParameters

Obtiene la colección de parámetros que se usan durante una operación de recuperación de datos.

Site

Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño.

(Heredado de Control)
SkinID

Obtiene la máscara que se va a aplicar al control DataSourceControl.

(Heredado de DataSourceControl)
StoreOriginalValuesInViewState

Obtiene o establece un valor que indica si los datos del origen de datos deberían almacenarse en el estado de vista para asegurarse de que otro proceso no ha cambiado los datos antes de actualizarlos o eliminarlos.

TableName

Obtiene o establece el nombre de la propiedad o campo de la clase de contexto de datos que representa una recolección de datos.

TemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.

(Heredado de Control)
TemplateSourceDirectory

Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual.

(Heredado de Control)
UniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.

(Heredado de Control)
UpdateParameters

La clase LinqDataSource no emplea esta colección.

ValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos.

(Heredado de Control)
ViewState

Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página.

(Heredado de Control)
ViewStateIgnoresCase

Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas.

(Heredado de Control)
ViewStateMode

Obtiene o establece el modo del estado de vista de este control.

(Heredado de Control)
Visible

Obtiene o establece un valor que indica si el control se muestra gráficamente.

(Heredado de DataSourceControl)
Where

Obtiene o establece un valor que especifica qué condiciones deben cumplirse para que un registro se incluya en los datos recuperados.

WhereParameters

Obtiene la colección de parámetros que se utiliza para crear la cláusula Where.

Métodos

AddedControl(Control, Int32)

Se llama después de agregar un control secundario a la colección Controls del objeto Control.

(Heredado de Control)
AddParsedSubObject(Object)

Notifica al control de servidor que se analizó un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control del servidor.

(Heredado de Control)
ApplyStyleSheetSkin(Page)

Aplica al control las propiedades de estilo definidas en la hoja de estilos de página.

(Heredado de DataSourceControl)
BeginRenderTracing(TextWriter, Object)

Comienza el seguimiento en tiempo de diseño de los datos de representación.

(Heredado de Control)
BuildProfileTree(String, Boolean)

Recopila información sobre el control de servidor y la pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página.

(Heredado de Control)
ClearCachedClientID()

Establece en null el valor de ClientID almacenado en caché.

(Heredado de Control)
ClearChildControlState()

Elimina la información sobre el estado de control de los controles secundarios del control de servidor.

(Heredado de Control)
ClearChildState()

Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor.

(Heredado de Control)
ClearChildViewState()

Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor.

(Heredado de Control)
ClearEffectiveClientIDMode()

Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit.

(Heredado de Control)
CreateChildControls()

Lo llama el marco de páginas ASP.NET para indicar a los controles de servidor que usan la implementación basada en composición que creen los controles secundarios que contengan como forma de preparar la devolución o representación de los datos.

(Heredado de Control)
CreateControlCollection()

Crea una colección para almacenar controles secundarios.

(Heredado de DataSourceControl)
CreateQueryableView()

Devuelve una vista consultable.

CreateView()

Crea una nueva instancia de la clase LinqDataSourceView que está asociada a este control.

DataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.

(Heredado de Control)
DataBind(Boolean)

Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding.

(Heredado de Control)
DataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.

(Heredado de Control)
Delete(IDictionary, IDictionary)

Realiza una operación de eliminación.

Dispose()

Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria.

(Heredado de Control)
EndRenderTracing(TextWriter, Object)

Finaliza el seguimiento en tiempo de diseño de los datos de representación.

(Heredado de Control)
EnsureChildControls()

Determina si el control de servidor contiene controles secundarios. Si no tiene controles secundarios, los crea.

(Heredado de Control)
EnsureID()

Crea un identificador para controles que no tiene un identificador asignado.

(Heredado de Control)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
FindControl(String)

Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.

(Heredado de DataSourceControl)
FindControl(String, Int32)

Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda. Esta versión del método FindControl no se debe reemplazar.

(Heredado de Control)
Focus()

Establece el foco de entrada en el control.

(Heredado de DataSourceControl)
GetDesignModeState()

Obtiene datos en tiempo de diseño para un control.

(Heredado de Control)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.

(Heredado de Control)
GetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.

(Heredado de Control)
GetRouteUrl(String, Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.

(Heredado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.

(Heredado de Control)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
GetUniqueIDRelativeTo(Control)

Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado.

(Heredado de Control)
GetView(String)

Devuelve la vista de origen de datos que está asociada al objeto LinqDataSource.

GetView(String)

Obtiene la vista de origen de datos que está asociada al objeto QueryableDataSource.

(Heredado de QueryableDataSource)
GetViewNames()

Devuelve una colección de nombres que representa la lista de objetos de vista asociados al control LinqDataSource.

GetViewNames()

Obtiene una colección de los nombres que representan las vistas asociadas al control QueryableDataSource.

(Heredado de QueryableDataSource)
HasControls()

Determina si el control de servidor contiene controles secundarios.

(Heredado de DataSourceControl)
HasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.

(Heredado de Control)
Insert(IDictionary)

Realiza una operación de inserción.

IsLiteralContent()

Determina si el control de servidor alberga únicamente contenido literal.

(Heredado de Control)
LoadControlState(Object)

Restaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState().

(Heredado de Control)
LoadViewState(Object)

Carga el estado de los valores del control LinqDataSource que deben conservarse.

LoadViewState(Object)

Carga el estado de los valores del control QueryableDataSource que deben conservarse.

(Heredado de QueryableDataSource)
MapPathSecure(String)

Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa.

(Heredado de Control)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
OnBubbleEvent(Object, EventArgs)

Determina si el evento del control de servidor se pasa a la jerarquía de control de servidor de la interfaz de usuario (UI) de la página.

(Heredado de Control)
OnDataBinding(EventArgs)

Genera el evento DataBinding.

(Heredado de Control)
OnInit(EventArgs)

Inicializa el objeto LinqDataSource.

OnLoad(EventArgs)

Genera el evento Load.

(Heredado de Control)
OnPreRender(EventArgs)

Genera el evento PreRender.

(Heredado de Control)
OnUnload(EventArgs)

Genera el evento Unload.

OpenFile(String)

Obtiene un objeto Stream utilizado para leer un archivo.

(Heredado de Control)
RaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al control principal del control.

(Heredado de Control)
RaiseDataSourceChangedEvent(EventArgs)

Genera el evento DataSourceChanged.

(Heredado de DataSourceControl)
RaiseViewChanged()

Llama al método OnDataSourceViewChanged(EventArgs) de la clase DataSourceView.

(Heredado de QueryableDataSource)
RemovedControl(Control)

Se llama después de quitar un control secundario de la colección Controls del objeto Control.

(Heredado de Control)
Render(HtmlTextWriter)

Envía el contenido del control de servidor al objeto HtmlTextWriter proporcionado, que escribe el contenido que se representará en el cliente.

(Heredado de Control)
RenderChildren(HtmlTextWriter)

Envía el contenido de los elementos secundarios de un control de servidor a un objeto HtmlTextWriter especificado, que escribe el contenido que se va a representar en el cliente.

(Heredado de Control)
RenderControl(HtmlTextWriter)

Envía el contenido de control del servidor a un objeto HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si está habilitado el seguimiento.

(Heredado de DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)

Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.

(Heredado de Control)
ResolveAdapter()

Obtiene el adaptador de controles que se encarga de representar el control especificado.

(Heredado de Control)
ResolveClientUrl(String)

Obtiene una dirección URL que el explorador puede utilizar.

(Heredado de Control)
ResolveUrl(String)

Convierte una dirección URL en una que el cliente solicitante pueda utilizar.

(Heredado de Control)
SaveControlState()

Guarda los cambios de estado del control de servidor que se produjeron desde la hora en que la página volvió a publicarse en el servidor.

(Heredado de Control)
SaveViewState()

Guarda el estado de vista actual del control LinqDataSource.

SaveViewState()

Guarda el estado de vista actual del control QueryableDataSource.

(Heredado de QueryableDataSource)
SetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.

(Heredado de Control)
SetRenderMethodDelegate(RenderMethod)

Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.

(Heredado de Control)
SetTraceData(Object, Object)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa la clave y el valor de los datos de seguimiento.

(Heredado de Control)
SetTraceData(Object, Object, Object)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa el objeto del que se ha realizado seguimiento, así como la clave y el valor de los datos de seguimiento.

(Heredado de Control)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
TrackViewState()

Efectúa el seguimiento de los cambios en el estado de vista del control LinqDataSource para poder almacenarlos en el objeto StateBag del control.

TrackViewState()

Realiza un seguimiento de los cambios en el estado de vista del control QueryableDataSource para poder almacenarlos en el objeto StateBag del control.

(Heredado de QueryableDataSource)
Update(IDictionary, IDictionary, IDictionary)

Realiza una operación de actualización.

UpdateParameterVales()

Actualiza los valores de parámetro que han cambiado desde la solicitud anterior.

(Heredado de QueryableDataSource)

Eventos

ContextCreated

Se produce después de crearse una instancia del objeto de tipo de contexto.

ContextCreating

Se produce antes de crearse una instancia del objeto de tipo de contexto.

ContextDisposing

Se produce antes de desechar el objeto de tipo de contexto.

DataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.

(Heredado de Control)
Deleted

Tiene lugar cuando se ha completado una operación de eliminación.

Deleting

Tiene lugar antes de una operación de eliminación.

Disposed

Se produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET.

(Heredado de Control)
Init

Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida.

(Heredado de Control)
Inserted

Tiene lugar cuando se termina una operación de inserción.

Inserting

Tiene lugar antes de una operación de inserción.

Load

Se produce cuando el control de servidor se carga en el objeto Page.

(Heredado de Control)
PreRender

Se produce una vez que se carga el objeto Control, pero antes de su representación.

(Heredado de Control)
QueryCreated

Se produce cuando se agrega o se quita una consulta de un control de origen de datos.

(Heredado de QueryableDataSource)
Selected

Tiene lugar cuando se termina una operación de recuperación de datos.

Selecting

Tiene lugar antes de una operación de recuperación de datos.

Unload

Se produce cuando el control de servidor se descarga de la memoria.

(Heredado de Control)
Updated

Tiene lugar cuando se termina una operación de actualización.

Updating

Tiene lugar antes de una operación de actualización.

Implementaciones de interfaz explícitas

IControlBuilderAccessor.ControlBuilder

Para obtener una descripción de este miembro, vea ControlBuilder.

(Heredado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obtener una descripción de este miembro, vea GetDesignModeState().

(Heredado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary).

(Heredado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obtener una descripción de este miembro, vea SetOwnerControl(Control).

(Heredado de Control)
IControlDesignerAccessor.UserData

Para obtener una descripción de este miembro, vea UserData.

(Heredado de Control)
IDataBindingsAccessor.DataBindings

Para obtener una descripción de este miembro, vea DataBindings.

(Heredado de Control)
IDataBindingsAccessor.HasDataBindings

Para obtener una descripción de este miembro, vea HasDataBindings.

(Heredado de Control)
IDataSource.DataSourceChanged

Se produce cuando un control de origen de datos ha cambiado de modo que afecta a los controles enlazados a datos.

(Heredado de DataSourceControl)
IDataSource.GetView(String)

Obtiene el objeto DataSourceView con nombre asociado al control DataSourceControl. Ciertos controles de origen de datos sólo admiten una vista, mientras que otros admiten más de una.

(Heredado de DataSourceControl)
IDataSource.GetViewNames()

Obtiene una colección de nombres, que representa la lista de objetos DataSourceView asociados al control DataSourceControl.

(Heredado de DataSourceControl)
IDynamicDataSource.ContextType

Para obtener una descripción de este miembro, vea IDynamicDataSource.

IDynamicDataSource.EntitySetName

Para obtener una descripción de este miembro, vea IDynamicDataSource.

IDynamicDataSource.Exception

Para obtener una descripción de este miembro, vea IDynamicDataSource.

IExpressionsAccessor.Expressions

Para obtener una descripción de este miembro, vea Expressions.

(Heredado de Control)
IExpressionsAccessor.HasExpressions

Para obtener una descripción de este miembro, vea HasExpressions.

(Heredado de Control)
IListSource.ContainsListCollection

Indica si el control de origen de datos está asociado a una o varias listas de datos.

(Heredado de DataSourceControl)
IListSource.GetList()

Obtiene una lista de controles de origen de datos que pueden utilizarse como orígenes de listas de datos.

(Heredado de DataSourceControl)
IParserAccessor.AddParsedSubObject(Object)

Para obtener una descripción de este miembro, vea AddParsedSubObject(Object).

(Heredado de Control)

Métodos de extensión

ExpandDynamicWhereParameters(IDynamicDataSource)

Expande los filtros dinámicos en los parámetros Where que el origen de datos puede usar.

FindDataSourceControl(Control)

Devuelve el origen de datos que está asociado al control de datos del control especificado.

FindFieldTemplate(Control, String)

Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado.

FindMetaTable(Control)

Devuelve el objeto de metatabla para el control de datos contenedor.

GetDefaultValues(IDataSource)

Obtiene la colección de los valores predeterminados para el origen de datos especificado.

GetMetaTable(IDataSource)

Obtiene los metadatos para una tabla en el objeto de origen de datos especificado.

GetTable(IDynamicDataSource)

Devuelve el objeto MetaTable que está asociado al control de origen de datos especificado.

LoadWith<TEntity>(LinqDataSource)

Establece el valor DataLoadOptions de un origen de datos LINQ-to-SQL para forzar la carga de todas las entidades de clave externa.

LoadWithForeignKeys(LinqDataSource, Type)

Establece el valor DataLoadOptions de un origen de datos LINQ-to-SQL para forzar la carga de todas las entidades de clave externa.

TryGetMetaTable(IDataSource, MetaTable)

Determina si están disponibles los metadatos de la tabla.

Se aplica a

Consulte también