QueryExtender QueryExtender QueryExtender QueryExtender Class

Definición

Habilita el filtrado de los datos de un origen de datos sin una cláusula Where explícita en el origen de datos.Enables data from a data source to be filtered without an explicit Where clause in the data source.

public ref class QueryExtender : System::Web::UI::Control
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.QueryExtender), "QueryExtender.bmp")]
public class QueryExtender : System.Web.UI.Control
type QueryExtender = class
    inherit Control
Public Class QueryExtender
Inherits Control
Herencia
QueryExtenderQueryExtenderQueryExtenderQueryExtender
Atributos

Ejemplos

El ejemplo siguiente muestra cómo usar el QueryExtender control para proporcionar una función de búsqueda en una página Web.The following example shows how to use the QueryExtender control to provide a search function in a Web page. El QueryExtender control utiliza el texto especificado en el TextBoxSearch control para buscar contenido en las columnas ProductName y Supplier.CompanyName de una tabla de productos en los datos que se devuelven desde el LinqDataSource control.The QueryExtender control uses the text that is entered in the TextBoxSearch control to search for contents in the ProductName and Supplier.CompanyName columns of a Products table in the data that is returned from the LinqDataSource control. La SearchExpression objeto se usa para realizar la búsqueda.The SearchExpression object is used to perform the search. El DataFields propiedad especifica los campos de datos para buscar.The DataFields property specifies the data fields to search. El SearchType propiedad especifica el tipo de búsqueda que desee realizar.The SearchType property specifies the type of search to perform. El ControlParameter elemento especifica el control que contiene el texto que se usará para la búsqueda.The ControlParameter element specifies the control that contains the text to use for the search. Este ejemplo de código forma parte de un ejemplo más extenso que se proporciona en Tutorial: Filtrar datos en una página Web mediante la sintaxis declarativa.This code example is part of a larger example that is provided in Walkthrough: Filtering Data in a Web Page Using Declarative Syntax.

<asp:LinqDataSource ID="dataSource" runat="server"   
    TableName="Products">  
</asp:LinqDataSource>  
<asp:QueryExtender TargetControlID="dataSource" runat="server">  
  <asp:SearchExpression DataFields="ProductName, Supplier.CompanyName"   
        SearchType="StartsWith">  
    <asp:ControlParameter ControlID="TextBoxSearch" />  
  </asp:SearchExpression>  
</asp:QueryExtender>  

El ejemplo siguiente muestra cómo usar el QueryExtender control para buscar una página Web para los valores de un intervalo especificado.The following example shows how to use the QueryExtender control to search a Web page for values in a specified range. El QueryExtender control utiliza los valores que se escriben en el TextBoxFrom y TextBoxTo controles para buscar valores en las columnas ProductName y Supplier.CompanyName de una tabla de productos en los datos que se devuelven desde el LinqDataSource control .The QueryExtender control uses the values that are entered in the TextBoxFrom and TextBoxTo controls to search for values in the ProductName and Supplier.CompanyName columns of a Products table in the data that is returned from the LinqDataSource control. El ControlParameter elemento especifica los controles de cuadro de texto que contienen los valores mínimos y máximo que se utilizará para buscar el intervalo.The ControlParameter element specifies the text box controls that contain the minimum and maximum values to use for searching the range. El MinType y MaxType propiedades especifican que los valores mínimo y máximos deben incluirse en los datos que se devuelven.The MinType and MaxType properties specify that the minimum and maximum values must be included in the data that is returned. Este ejemplo de código forma parte de un ejemplo más extenso incluido en Tutorial: Filtrar datos en una página Web mediante la sintaxis declarativa.This code example is part of a larger example provided in Walkthrough: Filtering Data in a Web Page Using Declarative Syntax.

<asp:LinqDataSource ID="dataSource" runat="server"   
    TableName="Products">  
</asp:LinqDataSource>  
<asp:QueryExtender TargetControlID="dataSource" runat="server">  
  <asp:RangeExpression DataField="UnitPrice" MinType="Inclusive"   
        MaxType="Inclusive">  
    <asp:ControlParameter ControlID="TextBoxFrom" />  
    <asp:ControlParameter ControlID="TexBoxTo" />  
  </asp:RangeExpression>  
</asp:QueryExtender>  

Comentarios

En este tema:In this topic:

IntroducciónIntroduction

El QueryExtender control se usa para crear filtros para los datos que se recuperan de un origen de datos sin usar explícita Where cláusula del origen de datos.The QueryExtender control is used to create filters for data that is retrieved from a data source, without using an explicit Where clause in the data source. El QueryExtender control puede utilizarse para especificar el filtrado mediante la sintaxis declarativa.The QueryExtender control can be used to specify filtering by using declarative syntax.

FondoBackground

Filtrado excluye los datos desde un origen de datos al mostrar únicamente los registros que cumplen los criterios especificados.Filtering excludes data from a data source by displaying only the records that meet specified criteria. El filtrado permite presentar diferentes vistas de los datos que se encuentra en un conjunto de datos sin afectar a los datos del conjunto de datos.Filtering enables you to present different views of the data that is in a data set without affecting the data in the data set.

Filtrado normalmente requiere la creación de un Where cláusula para aplicar el comando que consulta el origen de datos.Filtering typically requires that you create a Where clause to apply to the command that queries the data source. Sin embargo, el Where propiedad del control de origen de datos no podría exponer la funcionalidad completa que está disponible.However, the Where property of the data source control might not expose the full functionality that is available. Por ejemplo, el control QueryExtender le permite consultar una tabla mediante la búsqueda de cadenas al principio, terminar o en cualquier parte en el campo. Data.For example, the QueryExtender control enables you to query a table by searching for strings at the beginning, end or anywhere in .data field.

Para exponer la funcionalidad completa que está disponible en LINQ y para facilitar el filtrado de datos, ASP.NETASP.NET proporciona el QueryExtender control.To expose the full functionality that is available in LINQ and to make filtering data easier, ASP.NETASP.NET provides the QueryExtender control. El QueryExtender control tiene las siguientes ventajas:The QueryExtender control has the following benefits:

  • Proporciona una experiencia más enriquecida de filtrado que escribir un Where cláusula.It provides a richer filtering experience than writing a Where clause. Por ejemplo, puede buscar una tabla de productos para los valores booleanos mediante el PropertyExpression filtro sin tener que escribir una consulta.For example, you can search a Products table for Boolean values by using the PropertyExpression filter without writing a query.

  • Permite especificar filtros mediante la misma sintaxis para el LinqDataSource y EntityDataSource controles y cualquier otro origen de datos los controles que se puede usar.It lets you specify filters by using the same syntax for the LinqDataSource and EntityDataSource controls and for any other data source controls that you might use.

  • Se puede usar con LinqDataSource control, con un EntityDataSource control, o con orígenes de datos de terceros.It can be used with LinqDataSource control, with a EntityDataSource control, or with third-party data sources.

Opciones de filtro:Filter Options

El QueryExtender control admite una variedad de opciones que puede usar para filtrar los datos.The QueryExtender control supports a variety of options that you can use to filter data. El control permite buscar cadenas, buscar valores numéricos en un intervalo especificado y comparar un valor de propiedad en una tabla con un valor especificado.The control lets you search strings, search numeric values in a specified range, and compare a property value in a table to a specified value. El control también permite ordenar los datos y proporcionar consultas personalizadas.The control also lets you sort the data and provide custom queries.

Estas opciones se proporcionan como expresiones de LINQ en el QueryExtender control.These options are provided as LINQ expressions in the QueryExtender control. El QueryExtender control también admite expresiones que son específicas de ASP.NETASP.NET aplicaciones de datos dinámicos.The QueryExtender control also supports expressions that are specific to ASP.NETASP.NET Dynamic Data applications.

En la tabla siguiente se enumera las opciones que puede usar para filtrar los datos en el QueryExtender control.The following table lists the options that you can use to filter data in the QueryExtender control.

ExpresiónExpression DescripciónDescription
ControlFilterExpression (Solo datos dinámicos) Crea una consulta de base de datos mediante el uso de la clave de datos que está seleccionada en un control enlazado a datos de origen.(Dynamic Data only) Builds a database query by using the data key that is selected in a source data-bound control.

Para obtener información sobre cómo usar esta opción de filtro, vea Cómo: Filtrar filas de tabla con valores de una tabla primaria en los datos dinámicos.For information about how to use this filter option, see How to: Filter Table Rows Using Values from a Parent Table in Dynamic Data.
CustomExpression Especifica una expresión definida por el usuario para un origen de datos.Specifies a user-defined expression for a data source. La expresión LINQ personalizada se puede invocar en un controlador de eventos.The custom LINQ expression can be invoked in an event handler.
DynamicFilterExpression (Solo datos dinámicos) Crea una consulta de base de datos mediante la interfaz DynamicFilter control.(Dynamic Data only) Builds a database query by using the specified DynamicFilter control.

Para obtener información sobre cómo usar esta opción de filtro, vea Cómo: Filtrar filas de tabla mediante la clave externa en los datos dinámicos.For information about how to use this filter option, see How to: Filter Table Rows Using Foreign Key in Dynamic Data.
MethodExpression Especifica una expresión de LINQ definida por el usuario para un origen de datos.Specifies a user-defined LINQ expression for a data source. La expresión se invoca en un método.The expression is invoked in a method.
OrderByExpression Se aplica una expresión de ordenación para un IQueryable objeto origen de datos.Applies a sort expression to an IQueryable data source object. Después de aplicar el OrderByExpression valor, puede aplicar las operaciones de ordenación adicionales mediante la especificación de un ThenByExpressions valor.After you apply the OrderByExpression value, you can apply additional sort operations by specifying a ThenByExpressions value.
PropertyExpression Compara las propiedades de los valores de propiedad y campo de datos que se especifican en el WhereParameters colección.Compares the properties the data field and property values that are specified in the WhereParameters collection.
RangeExpression Determina si un valor es mayor o menor que un valor especificado, o si es un valor entre dos valores.Determines whether a value is greater than or less than a specified value, or whether a value is between two values.
SearchExpression Compara los valores de uno o varios campos en un valor de cadena especificada.Compares values in a field or fields to a specified string value.

Puede usar estos QueryExtender opciones individualmente o combinarlos para proporcionar un filtrado complejo en una página Web.You can use these QueryExtender options individually or you can combine them to provide complex filtering in a Web page. Para obtener más información, consulte información general sobre el Control de servidor Web QueryExtender.For more information, see QueryExtender Web Server Control Overview. Tutorial: Filtrar datos en una página Web mediante la sintaxis declarativaWalkthrough: Filtering Data in a Web Page Using Declarative Syntax

TareasTasks

En la tabla siguiente se enumera las tareas que se muestran cómo usar el QueryExtender control para filtrar los datos.The following table lists tasks that show how to use the QueryExtender control to filter data.

DocumentoDocument TareaTask
Tutorial: Filtrar datos en una página Web mediante la sintaxis declarativaWalkthrough: Filtering Data in a Web Page Using Declarative Syntax Muestra cómo utilizar el filtro de opciones que el QueryExtender proporciona el control.Shows how to use the filter options that the QueryExtender control provides.

Sintaxis declarativaDeclarative Syntax

<asp:QueryExtender   
    EnableViewState="True|False"  
    ID="string"  
    OnDataBinding="DataBiding event handler"  
    OnDisposed="Disposed event handler"  
    OnInit="Init event handler  
    OnLoad="Load event handler"  
    OnPreRender="PreRender event handler"  
    OnUnload="UnLoad event handler"  
    Runat="server"  
    TargetControlID="string"  
    Visible="True|False"  
>  
        <asp:ControlFilterExpression   
            ControlD="string"  
            Column="string">   
        </asp:ControlFilterExpression>  
        <asp:DynamicFilterExpression  
            ControlD="string"  
        </asp:DynamicFilterExpression>  
        <asp:CustomExpression="string"  
            OnQuerying="OnQuerying event handler">  
        </asp:CustomExpression>  
        <asp:OrderByExpression="string"  
            DataField="string"  
            Direction="string">  
            <asp:ThenByExpression  
                 DataField="string"  
                 Direction="string"  
            </asp:ThenBy>  
        </asp:OrderByExpression>  
        <asp:PropertyExpression="string">  
                <!-- child controls -->  
        </asp:PropertyExpression  
        >  
        <asp:RangeExpression="integer"  
            Datafield="string"  
            MaxType="Exclusive|Inclusive|None"  
            MinType="Exclusive|Inclusive|None">  
                <!--child controls-->  
        </asp:RangeExpression>  
        <asp:SearchExpression="string"  
            ComparisonType="CurrentCulture|CurrentCultureIgnoreCase|  
                InvariantCulture|InvariantCultureIgnoreCase|  
                Ordinal|OrdinalIgnoreCase"  
            DataField="string"  
            SearchType="Contains|EndsWith|StartsWith">  
                <!--child controls-->  
        </asp:SearchExpression>  
</asp:QueryExtender>  

Constructores

QueryExtender() QueryExtender() QueryExtender() QueryExtender()

Inicializa una nueva instancia de la clase QueryExtender.Initializes a new instance of the QueryExtender Class.

Propiedades

Adapter Adapter Adapter Adapter

Obtiene el adaptador específico del explorador para el control.Gets the browser-specific adapter for the control.

(Inherited from Control)
AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Inherited from Control)
BindingContainer BindingContainer BindingContainer BindingContainer

Obtiene el control que contiene el enlace de datos de este control.Gets the control that contains this control's data binding.

(Inherited from Control)
ChildControlsCreated ChildControlsCreated ChildControlsCreated ChildControlsCreated

Obtiene un valor que indica si se han creado controles secundarios del control de servidor.Gets a value that indicates whether the server control's child controls have been created.

(Inherited from Control)
ClientID ClientID ClientID ClientID

Obtiene el id. de control para marcado HTML que se genera por ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Inherited from Control)
ClientIDMode ClientIDMode ClientIDMode ClientIDMode

Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Inherited from Control)
ClientIDSeparator ClientIDSeparator ClientIDSeparator ClientIDSeparator

Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID.Gets a character value representing the separator character used in the ClientID property.

(Inherited from Control)
Context Context Context Context

Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual.Gets the HttpContext object associated with the server control for the current Web request.

(Inherited from Control)
Controls Controls Controls 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.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Inherited from Control)
DataItemContainer DataItemContainer DataItemContainer DataItemContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Inherited from Control)
DataKeysContainer DataKeysContainer DataKeysContainer DataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Inherited from Control)
DataSource DataSource DataSource DataSource

Obtiene el control de origen de datos (IDataSource) que se va a usar para la consulta.Gets the data source control (IDataSource object) to use for the query.

DesignMode DesignMode DesignMode DesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.Gets a value indicating whether a control is being used on a design surface.

(Inherited from Control)
EnableTheming EnableTheming EnableTheming EnableTheming

Obtiene o establece un valor que indica si los temas se aplican a este control.Gets or sets a value indicating whether themes apply to this control.

(Inherited from Control)
EnableViewState EnableViewState EnableViewState 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.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Inherited from Control)
Events Events Events Events

Obtiene una lista de delegados de controladores de eventos del control.Gets a list of event handler delegates for the control. Esta propiedad es de sólo lectura.This property is read-only.

(Inherited from Control)
Expressions Expressions Expressions Expressions

Obtiene la colección de las expresiones que se aplican al control IDataSource.Gets the collection of expressions that are applied to the IDataSource control.

HasChildViewState HasChildViewState HasChildViewState HasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Inherited from Control)
IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder IControlBuilderAccessor.ControlBuilder

Para obtener una descripción de este miembro, vea ControlBuilder.For a description of this member, see ControlBuilder.

(Inherited from Control)
IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData IControlDesignerAccessor.UserData

Para una descripción de este miembro, vea UserData.For a description of this member, see UserData.

(Inherited from Control)
ID ID ID ID

Obtiene o establece el identificador de programación asignado al control de servidor.Gets or sets the programmatic identifier assigned to the server control.

(Inherited from Control)
IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings IDataBindingsAccessor.DataBindings

Para obtener una descripción de este miembro, vea DataBindings.For a description of this member, see DataBindings.

(Inherited from Control)
IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings IDataBindingsAccessor.HasDataBindings

Para una descripción de este miembro, vea HasDataBindings.For a description of this member, see HasDataBindings.

(Inherited from Control)
IdSeparator IdSeparator IdSeparator IdSeparator

Obtiene el carácter utilizado para separar los identificadores de control.Gets the character used to separate control identifiers.

(Inherited from Control)
IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions IExpressionsAccessor.Expressions

Para una descripción de este miembro, vea Expressions.For a description of this member, see Expressions.

(Inherited from Control)
IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions IExpressionsAccessor.HasExpressions

Para obtener una descripción de este miembro, vea HasExpressions.For a description of this member, see HasExpressions.

(Inherited from Control)
IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared

Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control.Gets a value indicating whether controls contained within this control have control state.

(Inherited from Control)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios realizados en su estado de vista.Gets a value that indicates whether the server control is saving changes to its view state.

(Inherited from Control)
IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled

Obtiene un valor que indica si el estado de vista está habilitado para este control.Gets a value indicating whether view state is enabled for this control.

(Inherited from Control)
LoadViewStateByID LoadViewStateByID LoadViewStateByID LoadViewStateByID

Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de índice.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Inherited from Control)
NamingContainer NamingContainer NamingContainer 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.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Inherited from Control)
Page Page Page Page

Obtiene una referencia a la instancia Page que contiene el control de servidor.Gets a reference to the Page instance that contains the server control.

(Inherited from Control)
Parent Parent Parent Parent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.Gets a reference to the server control's parent control in the page control hierarchy.

(Inherited from Control)
RenderingCompatibility RenderingCompatibility RenderingCompatibility RenderingCompatibility

Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Inherited from Control)
Site Site Site Site

Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño.Gets information about the container that hosts the current control when rendered on a design surface.

(Inherited from Control)
SkinID SkinID SkinID SkinID

Obtiene o establece la máscara que se aplica al control.Gets or sets the skin to apply to the control.

(Inherited from Control)
TargetControlID TargetControlID TargetControlID TargetControlID

Obtiene o establece el identificador del control IDataSource que se va a usar para la consulta.Gets or sets the ID of the IDataSource control to use for the query.

TemplateControl TemplateControl TemplateControl TemplateControl

Obtiene o establece una referencia a la plantilla que contiene este control.Gets or sets a reference to the template that contains this control.

(Inherited from Control)
TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory

Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Inherited from Control)
UniqueID UniqueID UniqueID UniqueID

Obtiene el identificador único calificado jerárquicamente para el control de servidor.Gets the unique, hierarchically qualified identifier for the server control.

(Inherited from Control)
ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para valores potencialmente peligrosos.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Inherited from Control)
ViewState ViewState ViewState 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.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Inherited from Control)
ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase ViewStateIgnoresCase

Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas.Gets a value that indicates whether the StateBag object is case-insensitive.

(Inherited from Control)
ViewStateMode ViewStateMode ViewStateMode ViewStateMode

Obtiene o establece el modo del estado de vista de este control.Gets or sets the view-state mode of this control.

(Inherited from Control)
Visible Visible Visible Visible

Obtiene o establece un valor que indica si un control de servidor se representa como interfaz de usuario en la página.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Inherited from Control)

Métodos

AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32) AddedControl(Control, Int32)

Se llama después de agregar un control secundario a la colección Controls del objeto Control.Called after a child control is added to the Controls collection of the Control object.

(Inherited from Control)
AddParsedSubObject(Object) AddParsedSubObject(Object) AddParsedSubObject(Object) 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.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Inherited from Control)
ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page) ApplyStyleSheetSkin(Page)

Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página.Applies the style properties defined in the page style sheet to the control.

(Inherited from Control)
BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object) BeginRenderTracing(TextWriter, Object)

Comienza el seguimiento en tiempo de diseño de los datos de representación.Begins design-time tracing of rendering data.

(Inherited from Control)
BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) 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.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Inherited from Control)
ClearCachedClientID() ClearCachedClientID() ClearCachedClientID() ClearCachedClientID()

Establece en null el valor de ClientID almacenado en caché.Sets the cached ClientID value to null.

(Inherited from Control)
ClearChildControlState() ClearChildControlState() ClearChildControlState() ClearChildControlState()

Elimina la información sobre el estado de control de los controles secundarios del control de servidor.Deletes the control-state information for the server control's child controls.

(Inherited from Control)
ClearChildState() ClearChildState() ClearChildState() ClearChildState()

Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor.Deletes the view-state and control-state information for all the server control's child controls.

(Inherited from Control)
ClearChildViewState() ClearChildViewState() ClearChildViewState() ClearChildViewState()

Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor.Deletes the view-state information for all the server control's child controls.

(Inherited from Control)
ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode() ClearEffectiveClientIDMode()

Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Inherited from Control)
CreateChildControls() CreateChildControls() CreateChildControls() 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.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Inherited from Control)
CreateControlCollection() CreateControlCollection() CreateControlCollection() CreateControlCollection()

Crea un nuevo objeto ControlCollection que contendrá los controles secundarios (de literal y servidor) del control de servidor.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Inherited from Control)
DataBind() DataBind() DataBind() DataBind()

Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios.Binds a data source to the invoked server control and all its child controls.

(Inherited from Control)
DataBind(Boolean) DataBind(Boolean) DataBind(Boolean) 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.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Inherited from Control)
DataBindChildren() DataBindChildren() DataBindChildren() DataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.Binds a data source to the server control's child controls.

(Inherited from Control)
Dispose() Dispose() Dispose() Dispose()

Habilita un control de servidor para que realice la limpieza final antes de que se libere de la memoria.Enables a server control to perform final clean up before it is released from memory.

(Inherited from Control)
EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object) EndRenderTracing(TextWriter, Object)

Finaliza el seguimiento en tiempo de diseño de los datos de representación.Ends design-time tracing of rendering data.

(Inherited from Control)
EnsureChildControls() EnsureChildControls() EnsureChildControls() EnsureChildControls()

Determina si el control de servidor contiene controles secundarios.Determines whether the server control contains child controls. Si no tiene controles secundarios, los crea.If it does not, it creates child controls.

(Inherited from Control)
EnsureID() EnsureID() EnsureID() EnsureID()

Crea un identificador para controles que no tiene un identificador asignado.Creates an identifier for controls that do not have an identifier assigned.

(Inherited from Control)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindControl(String) FindControl(String) FindControl(String) FindControl(String)

Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.Searches the current naming container for a server control with the specified id parameter.

(Inherited from Control)
FindControl(String, Int32) FindControl(String, Int32) FindControl(String, Int32) 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.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Esta versión del método FindControl no se debe reemplazar.You should not override this version of the FindControl method.

(Inherited from Control)
Focus() Focus() Focus() Focus()

Establece el foco de entrada en un control.Sets input focus to a control.

(Inherited from Control)
GetDesignModeState() GetDesignModeState() GetDesignModeState() GetDesignModeState()

Obtiene datos en tiempo de diseño para un control.Gets design-time data for a control.

(Inherited from Control)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object) GetRouteUrl(Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary) GetRouteUrl(RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta.Gets the URL that corresponds to a set of route parameters.

(Inherited from Control)
GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object) GetRouteUrl(String, Object)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary) GetRouteUrl(String, RouteValueDictionary)

Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta.Gets the URL that corresponds to a set of route parameters and a route name.

(Inherited from Control)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control) GetUniqueIDRelativeTo(Control)

Devuelve la parte correspondiente al prefijo de la propiedad UniqueID del control especificado.Returns the prefixed portion of the UniqueID property of the specified control.

(Inherited from Control)
HasControls() HasControls() HasControls() HasControls()

Determina si el control de servidor contiene controles secundarios.Determines if the server control contains any child controls.

(Inherited from Control)
HasEvents() HasEvents() HasEvents() HasEvents()

Devuelve un valor que indica si se registran eventos para el control o los controles secundarios.Returns a value indicating whether events are registered for the control or any child controls.

(Inherited from Control)
IsLiteralContent() IsLiteralContent() IsLiteralContent() IsLiteralContent()

Determina si el control de servidor alberga únicamente contenido literal.Determines if the server control holds only literal content.

(Inherited from Control)
LoadControlState(Object) LoadControlState(Object) LoadControlState(Object) LoadControlState(Object)

Restaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Inherited from Control)
LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Carga el estado de los valores del control QueryExtender que deben conservarse.Loads the state of the values in the QueryExtender control that must be persisted.

MapPathSecure(String) MapPathSecure(String) MapPathSecure(String) MapPathSecure(String)

Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Inherited from Control)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) 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.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Inherited from Control)
OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs) OnDataBinding(EventArgs)

Genera el evento DataBinding.Raises the DataBinding event.

(Inherited from Control)
OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs) OnInit(EventArgs)

Se produce cuando se inicializa una nueva instancia de la clase QueryExtender.Occurs when a new instance of the QueryExtender class is initialized.

OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs) OnLoad(EventArgs)

Genera el evento Load.Raises the Load event.

(Inherited from Control)
OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs) OnPreRender(EventArgs)

Genera el evento PreRender.Raises the PreRender event.

(Inherited from Control)
OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs) OnUnload(EventArgs)

Genera el evento Unload.Raises the Unload event.

(Inherited from Control)
OpenFile(String) OpenFile(String) OpenFile(String) OpenFile(String)

Obtiene un objeto Stream utilizado para leer un archivo.Gets a Stream used to read a file.

(Inherited from Control)
RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs) RaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al control principal del control.Assigns any sources of the event and its information to the control's parent.

(Inherited from Control)
RemovedControl(Control) RemovedControl(Control) RemovedControl(Control) RemovedControl(Control)

Se llama después de quitar un control secundario de la colección Controls del objeto Control.Called after a child control is removed from the Controls collection of the Control object.

(Inherited from Control)
Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter) Render(HtmlTextWriter)

Envía el contenido del control de servidor al objeto HtmlTextWriter proporcionado, que escribe el contenido que se representará en el cliente.Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Inherited from Control)
RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter) RenderChildren(HtmlTextWriter)

Envía el contenido del control secundario del control de servidor a un objeto HtmlTextWriter suministrado, que escribe el contenido que se va a representar en el cliente.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Inherited from Control)
RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) RenderControl(HtmlTextWriter) 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.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Inherited from Control)
RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter) RenderControl(HtmlTextWriter, ControlAdapter)

Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Inherited from Control)
ResolveAdapter() ResolveAdapter() ResolveAdapter() ResolveAdapter()

Obtiene el adaptador de controles que se encarga de representar el control especificado.Gets the control adapter responsible for rendering the specified control.

(Inherited from Control)
ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String) ResolveClientUrl(String)

Obtiene una dirección URL que el explorador puede utilizar.Gets a URL that can be used by the browser.

(Inherited from Control)
ResolveUrl(String) ResolveUrl(String) ResolveUrl(String) ResolveUrl(String)

Convierte una dirección URL en una que el cliente solicitante pueda utilizar.Converts a URL into one that is usable on the requesting client.

(Inherited from Control)
SaveControlState() SaveControlState() SaveControlState() 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.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Inherited from Control)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Guarda el estado de vista actual del control QueryExtender.Saves the current view state of the QueryExtender control.

SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary) SetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.Sets design-time data for a control.

(Inherited from Control)
SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod) SetRenderMethodDelegate(RenderMethod)

Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.Assigns an event handler delegate to render the server control and its content into its parent control.

(Inherited from Control)
SetTraceData(Object, Object) SetTraceData(Object, Object) SetTraceData(Object, Object) 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.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Inherited from Control)
SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) SetTraceData(Object, Object, Object) 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.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Inherited from Control)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Realiza un seguimiento de los cambios en el estado de vista del control QueryExtender para poder almacenarlos en el objeto StateBag del control.Tracks view-state changes of the QueryExtender control so that the changes can be stored in the StateBag object for the control.

Eventos

DataBinding DataBinding DataBinding DataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.Occurs when the server control binds to a data source.

(Inherited from Control)
Disposed Disposed Disposed 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.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Inherited from Control)
Init Init Init Init

Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Inherited from Control)
Load Load Load Load

Se produce cuando el control de servidor se carga en el objeto Page.Occurs when the server control is loaded into the Page object.

(Inherited from Control)
PreRender PreRender PreRender PreRender

Se produce una vez que se carga el objeto Control, pero antes de su representación.Occurs after the Control object is loaded but prior to rendering.

(Inherited from Control)
Unload Unload Unload Unload

Se produce cuando el control de servidor se descarga de la memoria.Occurs when the server control is unloaded from memory.

(Inherited from Control)

Implementaciones de interfaz explícitas

IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState() IControlDesignerAccessor.GetDesignModeState()

Para una descripción de este miembro, vea GetDesignModeState().For a description of this member, see GetDesignModeState().

(Inherited from Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary) IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para una descripción de este miembro, vea SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Inherited from Control)
IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control) IControlDesignerAccessor.SetOwnerControl(Control)

Para obtener una descripción de este miembro, vea SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Inherited from Control)
IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object) IParserAccessor.AddParsedSubObject(Object)

Para obtener una descripción de este miembro, vea AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Inherited from Control)

Extension Methods

FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control) FindDataSourceControl(Control)

Devuelve el origen de datos que está asociado al control de datos del control especificado.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String) FindFieldTemplate(Control, String)

Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control) FindMetaTable(Control)

Devuelve el objeto de metatabla para el control de datos contenedor.Returns the metatable object for the containing data control.

Se aplica a

Consulte también: