DataSourceControl Clase

Referencia

Definición

Espacio de nombres:: System.Web.UI

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Actúa como clase base para los controles que representan orígenes de datos a controles enlazados a datos.

public ref class DataSourceControl abstract : System::Web::UI::Control, System::ComponentModel::IListSource, System::Web::UI::IDataSource

[System.ComponentModel.Bindable(false)]
public abstract class DataSourceControl : System.Web.UI.Control, System.ComponentModel.IListSource, System.Web.UI.IDataSource

[<System.ComponentModel.Bindable(false)>]
type DataSourceControl = class
    inherit Control
    interface IDataSource
    interface IListSource

Public MustInherit Class DataSourceControl
Inherits Control
Implements IDataSource, IListSource

Herencia: Object

Control
DataSourceControl

Derivado: System.Web.UI.WebControls.EntityDataSource

System.Web.UI.WebControls.LinqDataSource

System.Web.UI.WebControls.ObjectDataSource

System.Web.UI.WebControls.QueryableDataSource

System.Web.UI.WebControls.SqlDataSource

Atributos: BindableAttribute

Implementaciones: IListSource IDataSource

Ejemplos

En el ejemplo de código siguiente se muestra cómo una clase puede extender la clase DataSourceControl. El control CsvDataSource representa los datos de archivo separados por comas almacenados en un archivo .csv. La clase CsvDataSource proporciona sus propias implementaciones del GetView, GetViewNamesy otros métodos, ya que las implementaciones de clase base no son funcionales.

using System;
using System.Collections;
using System.Data;
using System.IO;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

// The CsvDataSource is a data source control that retrieves its
// data from a comma-separated value file.
[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
public class CsvDataSource : DataSourceControl
{
    public CsvDataSource() : base() {}

    // The comma-separated value file to retrieve data from.
    public string FileName {
        get {
            return ((CsvDataSourceView)this.GetView(String.Empty)).SourceFile;
        }
        set {
            // Only set if it is different.
            if ( ((CsvDataSourceView)this.GetView(String.Empty)).SourceFile != value) {
                ((CsvDataSourceView)this.GetView(String.Empty)).SourceFile = value;
                RaiseDataSourceChangedEvent(EventArgs.Empty);
            }
        }
    }

    // Do not add the column names as a data row. Infer columns if the CSV file does
    // not include column names.
    public bool IncludesColumnNames {
        get {
            return ((CsvDataSourceView)this.GetView(String.Empty)).IncludesColumnNames;
        }
        set {
            // Only set if it is different.
            if ( ((CsvDataSourceView)this.GetView(String.Empty)).IncludesColumnNames != value) {
                ((CsvDataSourceView)this.GetView(String.Empty)).IncludesColumnNames = value;
                RaiseDataSourceChangedEvent(EventArgs.Empty);
            }
        }
    }

    // Return a strongly typed view for the current data source control.
    private CsvDataSourceView view = null;
    protected override DataSourceView GetView(string viewName) {
        if (null == view) {
            view = new CsvDataSourceView(this, String.Empty);
        }
        return view;
    }
    // The ListSourceHelper class calls GetList, which
    // calls the DataSourceControl.GetViewNames method.
    // Override the original implementation to return
    // a collection of one element, the default view name.
    protected override ICollection GetViewNames() {
        ArrayList al = new ArrayList(1);
        al.Add(CsvDataSourceView.DefaultViewName);
        return al as ICollection;
    }
}

// The CsvDataSourceView class encapsulates the
// capabilities of the CsvDataSource data source control.
public class CsvDataSourceView : DataSourceView
{

    public CsvDataSourceView(IDataSource owner, string name) :base(owner, DefaultViewName) {
    }

    // The data source view is named. However, the CsvDataSource
    // only supports one view, so the name is ignored, and the
    // default name used instead.
    public static string DefaultViewName = "CommaSeparatedView";

    // The location of the .csv file.
    private string sourceFile = String.Empty;
    internal string SourceFile {
        get {
            return sourceFile;
        }
        set {
            // Use MapPath when the SourceFile is set, so that files local to the
            // current directory can be easily used.
            string mappedFileName = HttpContext.Current.Server.MapPath(value);
            sourceFile = mappedFileName;
        }
    }

    // Do not add the column names as a data row. Infer columns if the CSV file does
    // not include column names.
    private bool columns = false;
    internal bool IncludesColumnNames {
        get {
            return columns;
        }
        set {
            columns = value;
        }
    }

    // Get data from the underlying data source.
    // Build and return a DataView, regardless of mode.
    protected override IEnumerable ExecuteSelect(DataSourceSelectArguments selectArgs) {
        IEnumerable dataList = null;
        // Open the .csv file.
        if (File.Exists(this.SourceFile)) {
            DataTable data = new DataTable();

            // Open the file to read from.
            using (StreamReader sr = File.OpenText(this.SourceFile)) {
                // Parse the line
                string s = "";
                string[] dataValues;
                DataColumn col;

                // Do the following to add schema.
                dataValues = sr.ReadLine().Split(',');
                // For each token in the comma-delimited string, add a column
                // to the DataTable schema.
                foreach (string token in dataValues) {
                    col = new DataColumn(token,typeof(string));
                    data.Columns.Add(col);
                }

                // Do not add the first row as data if the CSV file includes column names.
                if (! IncludesColumnNames)
                    data.Rows.Add(CopyRowData(dataValues, data.NewRow()));

                // Do the following to add data.
                while ((s = sr.ReadLine()) != null) {
                    dataValues = s.Split(',');
                    data.Rows.Add(CopyRowData(dataValues, data.NewRow()));
                }
            }
            data.AcceptChanges();
            DataView dataView = new DataView(data);
            if (!string.IsNullOrEmpty(selectArgs.SortExpression)) {
                dataView.Sort = selectArgs.SortExpression;
            }
            dataList = dataView;
        }
        else {
            throw new System.Configuration.ConfigurationErrorsException("File not found, " + this.SourceFile);
        }

        if (null == dataList) {
            throw new InvalidOperationException("No data loaded from data source.");
        }

        return dataList;
    }

    private DataRow CopyRowData(string[] source, DataRow target) {
        try {
            for (int i = 0;i < source.Length;i++) {
                target[i] = source[i];
            }
        }
        catch (System.IndexOutOfRangeException) {
            // There are more columns in this row than
            // the original schema allows.  Stop copying
            // and return the DataRow.
            return target;
        }
        return target;
    }
    // The CsvDataSourceView does not currently
    // permit deletion. You can modify or extend
    // this sample to do so.
    public override bool CanDelete {
        get {
            return false;
        }
    }
    protected override int ExecuteDelete(IDictionary keys, IDictionary values)
    {
        throw new NotSupportedException();
    }
    // The CsvDataSourceView does not currently
    // permit insertion of a new record. You can
    // modify or extend this sample to do so.
    public override bool CanInsert {
        get {
            return false;
        }
    }
    protected override int ExecuteInsert(IDictionary values)
    {
        throw new NotSupportedException();
    }
    // The CsvDataSourceView does not currently
    // permit update operations. You can modify or
    // extend this sample to do so.
    public override bool CanUpdate {
        get {
            return false;
        }
    }
    protected override int ExecuteUpdate(IDictionary keys, IDictionary values, IDictionary oldValues)
    {
        throw new NotSupportedException();
    }
}

Imports System.Collections
Imports System.Data
Imports System.IO
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB.Controls

' The CsvDataSource is a data source control that retrieves its
' data from a comma-separated value file.
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class CsvDataSource
   Inherits DataSourceControl

   Public Sub New()
   End Sub

   ' The comma-separated value file to retrieve data from.
   Public Property FileName() As String
      Get
         Return CType(Me.GetView([String].Empty), CsvDataSourceView).SourceFile
      End Get
      Set
         ' Only set if it is different.
         If CType(Me.GetView([String].Empty), CsvDataSourceView).SourceFile <> value Then
            CType(Me.GetView([String].Empty), CsvDataSourceView).SourceFile = value
            RaiseDataSourceChangedEvent(EventArgs.Empty)
         End If
      End Set
   End Property

   ' Do not add the column names as a data row. Infer columns if the CSV file does
   ' not include column names.

   Public Property IncludesColumnNames() As Boolean
      Get
         Return CType(Me.GetView([String].Empty), CsvDataSourceView).IncludesColumnNames
      End Get
      Set
         ' Only set if it is different.
         If CType(Me.GetView([String].Empty), CsvDataSourceView).IncludesColumnNames <> value Then
            CType(Me.GetView([String].Empty), CsvDataSourceView).IncludesColumnNames = value
            RaiseDataSourceChangedEvent(EventArgs.Empty)
         End If
      End Set
   End Property


   ' Return a strongly typed view for the current data source control.
   Private view As CsvDataSourceView = Nothing

   Protected Overrides Function GetView(viewName As String) As DataSourceView
      If view Is Nothing Then
         view = New CsvDataSourceView(Me, String.Empty)
      End If
      Return view
   End Function 'GetView

   ' The ListSourceHelper class calls GetList, which
   ' calls the DataSourceControl.GetViewNames method.
   ' Override the original implementation to return
   ' a collection of one element, the default view name.
   Protected Overrides Function GetViewNames() As ICollection
      Dim al As New ArrayList(1)
      al.Add(CsvDataSourceView.DefaultViewName)
      Return CType(al, ICollection)
   End Function 'GetViewNames

End Class


' The CsvDataSourceView class encapsulates the
' capabilities of the CsvDataSource data source control.

Public Class CsvDataSourceView
   Inherits DataSourceView

   Public Sub New(owner As IDataSource, name As String)
       MyBase.New(owner, DefaultViewName)
   End Sub

   ' The data source view is named. However, the CsvDataSource
   ' only supports one view, so the name is ignored, and the
   ' default name used instead.
   Public Shared DefaultViewName As String = "CommaSeparatedView"

   ' The location of the .csv file.
   Private aSourceFile As String = [String].Empty

   Friend Property SourceFile() As String
      Get
         Return aSourceFile
      End Get
      Set
         ' Use MapPath when the SourceFile is set, so that files local to the
         ' current directory can be easily used.
         Dim mappedFileName As String
         mappedFileName = HttpContext.Current.Server.MapPath(value)
         aSourceFile = mappedFileName
      End Set
   End Property

   ' Do not add the column names as a data row. Infer columns if the CSV file does
   ' not include column names.
   Private columns As Boolean = False

   Friend Property IncludesColumnNames() As Boolean
      Get
         Return columns
      End Get
      Set
         columns = value
      End Set
   End Property

   ' Get data from the underlying data source.
   ' Build and return a DataView, regardless of mode.
   Protected Overrides Function ExecuteSelect(selectArgs As DataSourceSelectArguments) _
    As System.Collections.IEnumerable
      Dim dataList As IEnumerable = Nothing
      ' Open the .csv file.
      If File.Exists(Me.SourceFile) Then
         Dim data As New DataTable()

         ' Open the file to read from.
         Dim sr As StreamReader = File.OpenText(Me.SourceFile)

         Try
            ' Parse the line
            Dim dataValues() As String
            Dim col As DataColumn

            ' Do the following to add schema.
            dataValues = sr.ReadLine().Split(","c)
            ' For each token in the comma-delimited string, add a column
            ' to the DataTable schema.
            Dim token As String
            For Each token In dataValues
               col = New DataColumn(token, System.Type.GetType("System.String"))
               data.Columns.Add(col)
            Next token

            ' Do not add the first row as data if the CSV file includes column names.
            If Not IncludesColumnNames Then
               data.Rows.Add(CopyRowData(dataValues, data.NewRow()))
            End If

            ' Do the following to add data.
            Dim s As String
            Do
               s = sr.ReadLine()
               If Not s Is Nothing Then
                   dataValues = s.Split(","c)
                   data.Rows.Add(CopyRowData(dataValues, data.NewRow()))
               End If
            Loop Until s Is Nothing

         Finally
            sr.Close()
         End Try

         data.AcceptChanges()
         Dim dataView As New DataView(data)
         If Not selectArgs.SortExpression Is String.Empty Then
             dataView.Sort = selectArgs.SortExpression
         End If
         dataList = dataView
      Else
         Throw New System.Configuration.ConfigurationErrorsException("File not found, " + Me.SourceFile)
      End If

      If dataList is Nothing Then
         Throw New InvalidOperationException("No data loaded from data source.")
      End If

      Return dataList
   End Function 'ExecuteSelect


   Private Function CopyRowData([source]() As String, target As DataRow) As DataRow
      Try
         Dim i As Integer
         For i = 0 To [source].Length - 1
            target(i) = [source](i)
         Next i
      Catch iore As IndexOutOfRangeException
         ' There are more columns in this row than
         ' the original schema allows.  Stop copying
         ' and return the DataRow.
         Return target
      End Try
      Return target
   End Function 'CopyRowData

   ' The CsvDataSourceView does not currently
   ' permit deletion. You can modify or extend
   ' this sample to do so.
   Public Overrides ReadOnly Property CanDelete() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function ExecuteDelete(keys As IDictionary, values As IDictionary) As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteDelete

   ' The CsvDataSourceView does not currently
   ' permit insertion of a new record. You can
   ' modify or extend this sample to do so.
   Public Overrides ReadOnly Property CanInsert() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function ExecuteInsert(values As IDictionary) As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteInsert

   ' The CsvDataSourceView does not currently
   ' permit update operations. You can modify or
   ' extend this sample to do so.
   Public Overrides ReadOnly Property CanUpdate() As Boolean
      Get
         Return False
      End Get
   End Property

   Protected Overrides Function ExecuteUpdate(keys As IDictionary, _
                                              values As IDictionary, _
                                              oldValues As IDictionary) As Integer
      Throw New NotSupportedException()
   End Function 'ExecuteUpdate

End Class
End Namespace

En el ejemplo de código siguiente se muestra cómo usar el control CsvDataSource en un formulario web.

<%@ Page Language="C#" %>
<%@ Register Tagprefix="aspSample"
             Namespace="Samples.AspNet.CS.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="CsvDataSource1" />

      <aspSample:CsvDataSource
          id = "CsvDataSource1"
          runat = "server"
          filename = "sample.csv"
          includescolumnnames="True" />

    </form>
  </body>
</html>

<%@ Page Language="VB" %>
<%@ Register Tagprefix="aspSample"
             Namespace="Samples.AspNet.VB.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
    <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
        <form id="form1" runat="server">

            <asp:gridview
                id="GridView1"
                runat="server"
                allowsorting="True"
                datasourceid="CsvDataSource1" />

            <aspSample:CsvDataSource
                id = "CsvDataSource1"
                runat = "server"
                filename = "sample.csv"
                includescolumnnames="True" />

        </form>
    </body>
</html>

Comentarios

ASP.NET admite una arquitectura de enlace de datos de control que permite que los controles de servidor web se enlacen a datos de forma coherente. Los controles de servidor web que se enlazan a datos se conocen como controles enlazados a datos y las clases que facilitan ese enlace se denominan controles de origen de datos. Los controles de origen de datos pueden representar cualquier origen de datos: una base de datos relacional, un archivo, una secuencia, un objeto de negocio, etc. Los controles de origen de datos presentan datos de forma coherente con los controles enlazados a datos, independientemente del origen o formato de los datos subyacentes.

Use los controles de origen de datos que se proporcionan con ASP.NET, incluidos SqlDataSource, AccessDataSourcey XmlDataSource, para realizar la mayoría de las tareas de desarrollo web. Use la clase base DataSourceControl cuando desee implementar su propio control de origen de datos personalizado.

Aunque cualquier clase que implemente la interfaz IDataSource es un control de origen de datos, la mayoría de los controles de origen de datos ASP.NET amplían la clase de DataSourceControl abstracta, que proporciona una implementación base de la interfaz IDataSource. La clase DataSourceControl también proporciona una implementación de la interfaz IListSource, que permite asignar mediante programación el control de origen de datos a la propiedad DataSource de un control enlazado a datos y devolver datos al control como una lista básica.

Cualquier control ASP.NET que derive de la clase DataBoundControl puede enlazarse a un control de origen de datos. Cuando un DataBoundControl está enlazado a un control de origen de datos, el enlace de datos se realiza automáticamente en tiempo de ejecución. También puede usar controles de origen de datos con controles de ASP.NET que exponen una propiedad de DataSource o DataSourceID y admiten el enlace de datos básico, pero no se derivan de DataBoundControl. Al usar estos controles enlazados a datos, debe llamar explícitamente al método DataBind. Para obtener más información sobre el enlace de datos, vea ASP.NET mapa de contenido de acceso a datos.

Puede considerar un control de origen de datos como la combinación del objeto DataSourceControl y sus listas de datos asociadas, denominadas vistas del origen de datos. Cada lista de datos se representa mediante un objeto DataSourceView. Dado que el almacenamiento de datos subyacente contiene una o varias listas de datos, un DataSourceControl siempre está asociado a uno o varios objetos DataSourceView con nombre. La interfaz IDataSource define los métodos que usan todos los controles de origen de datos para interactuar con vistas del origen de datos: el método GetViewNames se usa para enumerar las vistas del origen de datos asociadas actualmente al control de origen de datos y el método GetView se usa para recuperar una instancia de vista del origen de datos específica por nombre.

También puede considerar el control de origen de datos como dos interfaces distintas que usan los autores de llamadas para acceder a los datos. La clase DataSourceControl es la interfaz con la que los desarrolladores de páginas interactúan directamente al desarrollar una página de Formularios Web Forms y la clase DataSourceView es la interfaz con la que interactúan los autores de controles enlazados a datos y controles enlazados a datos. Dado que el objeto DataSourceView solo está disponible en tiempo de ejecución, el control de origen de datos o la vista del origen de datos deben exponerse directamente mediante el control de origen de datos.

No hay representación visual de ASP.NET controles de origen de datos; se implementan como controles para poder crearlos de forma declarativa y, opcionalmente, permitirles participar en la administración de estados. Como resultado, los controles de origen de datos no admiten características visuales como EnableTheming o SkinID.

Constructores

DataSourceControl()

Inicializa una nueva instancia de la clase DataSourceControl.

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 UserControl que contiene este control. (Heredado de Control)
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 los controles secundarios del control de servidor. (Heredado de Control)
ClientID	Obtiene el identificador de control de servidor generado por ASP.NET.
ClientIDMode	Esta propiedad no se usa para los controles de origen de datos.
ClientIDMode	Obtiene o establece el algoritmo que se usa para generar el valor de la propiedad ClientID. (Heredado de Control)
ClientIDSeparator	Obtiene un valor de carácter que representa el carácter separador 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)
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.
DataItemContainer	Obtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataItemContainer. (Heredado de Control)
DataKeysContainer	Obtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataKeysControl. (Heredado de Control)
DesignMode	Obtiene un valor que indica si se usa un control en una superficie de diseño. (Heredado de Control)
EnableTheming	Obtiene un valor que indica si este control admite temas.
EnableViewState	Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista y el estado de vista de los controles secundarios que contiene, al cliente solicitante. (Heredado de Control)
Events	Obtiene una lista de delegados del controlador de eventos para el control . Esta propiedad es de solo lectura. (Heredado de Control)
HasChildViewState	Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen cualquier configuración de estado de vista guardada. (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 usado para separar los identificadores de control. (Heredado de Control)
IsChildControlStateCleared	Obtiene un valor que indica si los controles contenidos en este control tienen estado de control. (Heredado de Control)
IsTrackingViewState	Obtiene un valor que indica si el control de servidor guarda los cambios 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 ID en lugar del í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 entre los controles de servidor con el mismo valor de propiedad ID. (Heredado de Control)
Page	Obtiene una referencia a la instancia de Page que contiene el control de servidor. (Heredado de Control)
Parent	Obtiene una referencia al control primario del control de servidor en la jerarquía de controles de página. (Heredado de Control)
RenderingCompatibility	Obtiene un valor que especifica la versión de ASP.NET con la que se representará HTML. (Heredado de Control)
Site	Obtiene información sobre el contenedor que hospeda el control actual cuando se representa en una superficie de diseño. (Heredado de Control)
SkinID	Obtiene la piel que se va a aplicar al control DataSourceControl.
TemplateControl	Obtiene o establece una referencia a la plantilla que contiene este control. (Heredado de Control)
TemplateSourceDirectory	Obtiene el directorio virtual del 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)
ValidateRequestMode	Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para detectar valores potencialmente peligrosos. (Heredado de Control)
ViewState	Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un control de servidor en varias solicitudes para 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 de estado de vista de este control. (Heredado de Control)
Visible	Obtiene o establece un valor que indica si el control se muestra visualmente.

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 ha analizado un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control de servidor. (Heredado de Control)
ApplyStyleSheetSkin(Page)	Aplica las propiedades de estilo definidas en la hoja de estilos de página al control .
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 entrega a la propiedad Trace que se va a mostrar cuando el seguimiento está habilitado para la página. (Heredado de Control)
ClearCachedClientID()	Establece el valor de ClientID almacenado en caché en `null`. (Heredado de Control)
ClearChildControlState()	Elimina la información de estado de control de los controles secundarios del control de servidor. (Heredado de Control)
ClearChildState()	Elimina la información de estado de vista y estado de control de todos los controles secundarios del control de servidor. (Heredado de Control)
ClearChildViewState()	Elimina la información de estado de vista de todos los controles secundarios del control de servidor. (Heredado de Control)
ClearEffectiveClientIDMode()	Establece la propiedad ClientIDMode de la instancia de control actual y de cualquier control secundario en Inherit. (Heredado de Control)
CreateChildControls()	Llamado por el marco de ASP.NET página para notificar a los controles de servidor que usan la implementación basada en composición para crear los controles secundarios que contengan como preparación para la publicación o representación. (Heredado de Control)
CreateControlCollection()	Crea una colección para almacenar controles secundarios.
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 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)
Dispose()	Permite que un control de servidor realice la limpieza final antes de liberarse 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 es así, crea controles secundarios. (Heredado de Control)
EnsureID()	Crea un identificador para los controles que no tienen asignado un identificador. (Heredado de Control)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
FindControl(String, Int32)	Busca en el contenedor de nomenclatura actual un control de servidor con el `id` especificado y un entero, especificado en el parámetro `pathOffset`, que ayuda en la búsqueda. No debe invalidar esta versión del método FindControl. (Heredado de Control)
FindControl(String)	Busca en el contenedor de nomenclatura actual un control de servidor con el parámetro `id` especificado.
Focus()	Establece el foco de entrada en el control.
GetDesignModeState()	Obtiene los datos en tiempo de diseño de un control. (Heredado de Control)
GetHashCode()	Actúa como 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 prefijo de la propiedad UniqueID del control especificado. (Heredado de Control)
GetView(String)	Obtiene la vista del origen de datos con nombre asociada al control de origen de datos.
GetViewNames()	Obtiene una colección de nombres, que representa la lista de objetos DataSourceView asociados al control DataSourceControl.
HasControls()	Determina si el control de servidor contiene controles secundarios.
HasEvents()	Devuelve un valor que indica si los eventos están registrados para el control o para los controles secundarios. (Heredado de Control)
IsLiteralContent()	Determina si el control de servidor contiene solo contenido literal. (Heredado de Control)
LoadControlState(Object)	Restaura la información de estado de control de una solicitud de página anterior guardada por el método SaveControlState(). (Heredado de Control)
LoadViewState(Object)	Restaura la información de estado de vista de una solicitud de página anterior guardada por el método SaveViewState(). (Heredado de Control)
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 Objectactual. (Heredado de Object)
OnBubbleEvent(Object, EventArgs)	Determina si el evento del control de servidor se pasa a la jerarquía de controles de servidor de interfaz de usuario de la página. (Heredado de Control)
OnDataBinding(EventArgs)	Genera el evento DataBinding. (Heredado de Control)
OnInit(EventArgs)	Genera el evento Init. (Heredado de Control)
OnLoad(EventArgs)	Genera el evento Load. (Heredado de Control)
OnPreRender(EventArgs)	Genera el evento PreRender. (Heredado de Control)
OnUnload(EventArgs)	Genera el evento Unload. (Heredado de Control)
OpenFile(String)	Obtiene un Stream usado para leer un archivo. (Heredado de Control)
RaiseBubbleEvent(Object, EventArgs)	Asigna cualquier origen del evento y su información al elemento primario del control. (Heredado de Control)
RaiseDataSourceChangedEvent(EventArgs)	Genera el evento DataSourceChanged.
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 contenido de control de servidor a un objeto HtmlTextWriter proporcionado, que escribe el contenido que se va a representar en el cliente. (Heredado de Control)
RenderChildren(HtmlTextWriter)	Genera el contenido de los elementos secundarios de un control de servidor en un objeto HtmlTextWriter proporcionado, que escribe el contenido que se va a representar en el cliente. (Heredado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Genera contenido de control de servidor en un objeto de HtmlTextWriter proporcionado mediante un objeto ControlAdapter proporcionado. (Heredado de Control)
RenderControl(HtmlTextWriter)	Genera contenido de control de servidor en un objeto de HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si el seguimiento está habilitado.
ResolveAdapter()	Obtiene el adaptador de control responsable de representar el control especificado. (Heredado de Control)
ResolveClientUrl(String)	Obtiene una dirección URL que el explorador puede usar. (Heredado de Control)
ResolveUrl(String)	Convierte una dirección URL en una que se pueda usar en el cliente solicitante. (Heredado de Control)
SaveControlState()	Guarda los cambios de estado de control de servidor que se han producido desde el momento en que se devolvió la página al servidor. (Heredado de Control)
SaveViewState()	Guarda los cambios de estado de vista de control de servidor que se han producido desde el momento en que la página se devolvió al servidor. (Heredado de Control)
SetDesignModeState(IDictionary)	Establece los datos en tiempo de diseño de un control. (Heredado de Control)
SetRenderMethodDelegate(RenderMethod)	Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en su control primario. (Heredado de Control)
SetTraceData(Object, Object, Object)	Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante el objeto rastreado, la clave de datos de seguimiento y el valor de los datos de seguimiento. (Heredado de Control)
SetTraceData(Object, Object)	Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante la clave de datos de seguimiento y el valor de los datos de seguimiento. (Heredado de Control)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TrackViewState()	Provoca el seguimiento de los cambios de estado de vista en el control de servidor para que se puedan almacenar en el objeto de StateBag del control de servidor. Este objeto es accesible a través de la propiedad ViewState. (Heredado de Control)

Eventos

DataBinding	Se produce cuando el control de servidor se enlaza a un origen de datos. (Heredado de Control)
Disposed	Se produce cuando se libera un control de servidor de la memoria, que es la última fase del ciclo de vida del control de servidor cuando se solicita una página de ASP.NET. (Heredado de Control)
Init	Se produce cuando se inicializa el control de servidor, que es el primer paso de su ciclo de vida. (Heredado de Control)
Load	Se produce cuando el control de servidor se carga en el objeto Page. (Heredado de Control)
PreRender	Se produce después de cargar el objeto Control, pero antes de la representación. (Heredado de Control)
Unload	Se produce cuando el control de servidor se descarga de la memoria. (Heredado de Control)

Implementaciones de interfaz explícitas

IControlBuilderAccessor.ControlBuilder	Para obtener una descripción de este miembro, consulte ControlBuilder. (Heredado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obtener una descripción de este miembro, consulte GetDesignModeState(). (Heredado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obtener una descripción de este miembro, consulte SetDesignModeState(IDictionary). (Heredado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obtener una descripción de este miembro, consulte SetOwnerControl(Control). (Heredado de Control)
IControlDesignerAccessor.UserData	Para obtener una descripción de este miembro, consulte UserData. (Heredado de Control)
IDataBindingsAccessor.DataBindings	Para obtener una descripción de este miembro, consulte DataBindings. (Heredado de Control)
IDataBindingsAccessor.HasDataBindings	Para obtener una descripción de este miembro, consulte HasDataBindings. (Heredado de Control)
IDataSource.DataSourceChanged	Se produce cuando un control de origen de datos ha cambiado de una manera que afecta a los controles enlazados a datos.
IDataSource.GetView(String)	Obtiene el objeto DataSourceView con nombre asociado al control DataSourceControl. Algunos controles de origen de datos solo admiten una vista, mientras que otras admiten más de una.
IDataSource.GetViewNames()	Obtiene una colección de nombres, que representa la lista de objetos DataSourceView asociados al control DataSourceControl.
IExpressionsAccessor.Expressions	Para obtener una descripción de este miembro, consulte Expressions. (Heredado de Control)
IExpressionsAccessor.HasExpressions	Para obtener una descripción de este miembro, consulte HasExpressions. (Heredado de Control)
IListSource.ContainsListCollection	Indica si el control de origen de datos está asociado a una o varias listas de datos.
IListSource.GetList()	Obtiene una lista de controles de origen de datos que se pueden usar como orígenes de listas de datos.
IParserAccessor.AddParsedSubObject(Object)	Para obtener una descripción de este miembro, consulte AddParsedSubObject(Object). (Heredado de Control)

Métodos de extensión

FindDataSourceControl(Control)	Devuelve el origen de datos asociado al control de datos para el control especificado.
FindFieldTemplate(Control, String)	Devuelve la plantilla de campo de la columna especificada en el contenedor de nomenclatura del control especificado.
FindMetaTable(Control)	Devuelve el objeto de metatable 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 de una tabla del objeto de origen de datos especificado.
TryGetMetaTable(IDataSource, MetaTable)	Determina si los metadatos de la tabla están disponibles.

Se aplica a

Compartir vía