QueryExtender QueryExtender QueryExtender QueryExtender Class

Definizione

Consente di filtrare i dati di un'origine dati senza una clausola Where esplicita nell'origine dati.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
Ereditarietà
QueryExtenderQueryExtenderQueryExtenderQueryExtender
Attributi

Esempi

Nell'esempio seguente viene illustrato come utilizzare il QueryExtender controllo per fornire una funzione di ricerca in una pagina Web.The following example shows how to use the QueryExtender control to provide a search function in a Web page. Il QueryExtender controllo Usa il testo immesso TextBoxSearch nel controllo per cercare il contenuto nelle colonne ProductName e Supplier. CompanyName di una tabella Products nei dati restituiti dal LinqDataSource controllo.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. L' SearchExpression oggetto viene utilizzato per eseguire la ricerca.The SearchExpression object is used to perform the search. La DataFields proprietà specifica i campi dati in cui eseguire la ricerca.The DataFields property specifies the data fields to search. La SearchType proprietà specifica il tipo di ricerca da eseguire.The SearchType property specifies the type of search to perform. L' ControlParameter elemento specifica il controllo che contiene il testo da utilizzare per la ricerca.The ControlParameter element specifies the control that contains the text to use for the search. Questo esempio di codice fa parte di un esempio più ampio fornito in procedura dettagliata: Filtraggio dei dati in una pagina Web consintassi dichiarativa.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>  

Nell'esempio seguente viene illustrato come utilizzare il QueryExtender controllo per eseguire la ricerca di valori in una pagina Web in un intervallo specificato.The following example shows how to use the QueryExtender control to search a Web page for values in a specified range. Il QueryExtender controllo utilizza i valori immessi TextBoxFrom nei controlli e TextBoxTo per cercare i valori nelle colonne ProductName e Supplier. CompanyName di una tabella Products LinqDataSource nei dati restituiti dal controllo. .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. L' ControlParameter elemento specifica i controlli casella di testo che contengono i valori minimo e massimo da usare per la ricerca nell'intervallo.The ControlParameter element specifies the text box controls that contain the minimum and maximum values to use for searching the range. Le MinType proprietà MaxType e specificano che i valori minimo e massimo devono essere inclusi nei dati restituiti.The MinType and MaxType properties specify that the minimum and maximum values must be included in the data that is returned. Questo esempio di codice fa parte di un esempio più ampio disponibile in procedura dettagliata: Filtraggio dei dati in una pagina Web consintassi dichiarativa.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>  

Commenti

In questo argomentoIn this topic:

IntroduzioneIntroduction

Il QueryExtender controllo viene utilizzato per creare filtri per i dati recuperati da un'origine dati, senza utilizzare una clausola Where esplicita nell'origine dati.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. Il QueryExtender controllo può essere utilizzato per specificare il filtro utilizzando la sintassi dichiarativa.The QueryExtender control can be used to specify filtering by using declarative syntax.

SfondoBackground

Il filtro esclude i dati da un'origine dati visualizzando solo i record che soddisfano i criteri specificati.Filtering excludes data from a data source by displaying only the records that meet specified criteria. Il filtro consente di presentare visualizzazioni diverse dei dati presenti in un set di dati senza influire sui dati nel set di dati.Filtering enables you to present different views of the data that is in a data set without affecting the data in the data set.

Il filtro richiede in genere la creazione Where di una clausola da applicare al comando che esegue query sull'origine dati.Filtering typically requires that you create a Where clause to apply to the command that queries the data source. Tuttavia, la Where proprietà del controllo origine dati potrebbe non esporre le funzionalità complete disponibili.However, the Where property of the data source control might not expose the full functionality that is available. Il controllo QueryExtender, ad esempio, consente di eseguire una query su una tabella cercando stringhe all'inizio, alla fine o in qualsiasi punto del 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.

Per esporre la funzionalità completa disponibile in LINQ e per semplificare il filtraggio dei dati, ASP.NETASP.NET fornisce il QueryExtender controllo.To expose the full functionality that is available in LINQ and to make filtering data easier, ASP.NETASP.NET provides the QueryExtender control. Il QueryExtender controllo presenta i vantaggi seguenti:The QueryExtender control has the following benefits:

  • Offre un'esperienza di filtraggio più avanzata rispetto alla Where scrittura di una clausola.It provides a richer filtering experience than writing a Where clause. Ad esempio, è possibile cercare i valori booleani in una tabella Products usando PropertyExpression il filtro senza scrivere una query.For example, you can search a Products table for Boolean values by using the PropertyExpression filter without writing a query.

  • Consente di specificare i filtri utilizzando la stessa sintassi per i LinqDataSource controlli e EntityDataSource e per qualsiasi altro controllo origine dati che è possibile utilizzare.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.

  • Può essere usato con LinqDataSource il controllo, con un EntityDataSource controllo o con origini dati di terze parti.It can be used with LinqDataSource control, with a EntityDataSource control, or with third-party data sources.

Opzioni di filtroFilter Options

Il QueryExtender controllo supporta un'ampia gamma di opzioni che è possibile usare per filtrare i dati.The QueryExtender control supports a variety of options that you can use to filter data. Il controllo consente di cercare stringhe, cercare valori numerici in un intervallo specificato e confrontare un valore della proprietà in una tabella con un valore specificato.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. Il controllo consente anche di ordinare i dati e fornire query personalizzate.The control also lets you sort the data and provide custom queries.

Queste opzioni vengono fornite come espressioni LINQ nel QueryExtender controllo.These options are provided as LINQ expressions in the QueryExtender control. Il QueryExtender controllo supporta inoltre espressioni specifiche per ASP.NETASP.NET Dynamic Data applicazioni.The QueryExtender control also supports expressions that are specific to ASP.NETASP.NET Dynamic Data applications.

Nella tabella seguente sono elencate le opzioni che è possibile usare per filtrare i dati QueryExtender nel controllo.The following table lists the options that you can use to filter data in the QueryExtender control.

EspressioneExpression DescriptionDescription
ControlFilterExpression (Solo Dynamic Data) Compila una query di database usando la chiave dati selezionata in un controllo con associazione a dati di origine.(Dynamic Data only) Builds a database query by using the data key that is selected in a source data-bound control.

Per informazioni sull'uso di questa opzione di filtro, vedere procedura: Filtrare le righe della tabella utilizzando i valori di una tabellapadre in Dynamic Data.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 Specifica un'espressione definita dall'utente per un'origine dati.Specifies a user-defined expression for a data source. L'espressione LINQ personalizzata può essere richiamata in un gestore eventi.The custom LINQ expression can be invoked in an event handler.
DynamicFilterExpression (Solo Dynamic Data) Compila una query di database utilizzando il controllo DynamicFilter specificato.(Dynamic Data only) Builds a database query by using the specified DynamicFilter control.

Per informazioni sull'uso di questa opzione di filtro, vedere procedura: Filtrare le righe della tabella utilizzando la chiaveesterna in Dynamic Data.For information about how to use this filter option, see How to: Filter Table Rows Using Foreign Key in Dynamic Data.
MethodExpression Specifica un'espressione LINQ definita dall'utente per un'origine dati.Specifies a user-defined LINQ expression for a data source. L'espressione viene richiamata in un metodo.The expression is invoked in a method.
OrderByExpression Applica un'espressione di ordinamento a IQueryable un oggetto origine dati.Applies a sort expression to an IQueryable data source object. Dopo aver applicato il OrderByExpression valore, è possibile applicare ulteriori operazioni di ordinamento specificando ThenByExpressions un valore.After you apply the OrderByExpression value, you can apply additional sort operations by specifying a ThenByExpressions value.
PropertyExpression Confronta le proprietà con i valori dei campi dati e delle proprietà specificati nella WhereParameters raccolta.Compares the properties the data field and property values that are specified in the WhereParameters collection.
RangeExpression Determina se un valore è maggiore o minore di un valore specificato o se un valore è compreso tra due valori.Determines whether a value is greater than or less than a specified value, or whether a value is between two values.
SearchExpression Confronta i valori di un campo o di campi con un valore stringa specificato.Compares values in a field or fields to a specified string value.

È possibile utilizzare queste QueryExtender opzioni singolarmente oppure è possibile combinarle per fornire filtri complessi in una pagina Web.You can use these QueryExtender options individually or you can combine them to provide complex filtering in a Web page. Per ulteriori informazioni, vedere Cenni preliminari sul controllo server Web QueryExtender.For more information, see QueryExtender Web Server Control Overview. Procedura dettagliata: Filtraggio dei dati in una pagina Web con sintassi dichiarativaWalkthrough: Filtering Data in a Web Page Using Declarative Syntax

AttivitàTasks

Nella tabella seguente sono elencate le attività in cui viene illustrato QueryExtender come utilizzare il controllo per filtrare i dati.The following table lists tasks that show how to use the QueryExtender control to filter data.

DocumentDocument AttivitàTask
Procedura dettagliata: Filtraggio dei dati in una pagina Web con sintassi dichiarativaWalkthrough: Filtering Data in a Web Page Using Declarative Syntax Viene illustrato come utilizzare le opzioni di filtro fornite QueryExtender dal controllo.Shows how to use the filter options that the QueryExtender control provides.

Sintassi dichiarativaDeclarative 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>  

Costruttori

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

Inizializza una nuova istanza della classe QueryExtender.Initializes a new instance of the QueryExtender Class.

Proprietà

Adapter Adapter Adapter Adapter

Ottiene l'adattatore specifico del browser per il controllo.Gets the browser-specific adapter for the control.

(Inherited from Control)
AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory AppRelativeTemplateSourceDirectory

Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo.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

Ottiene il controllo contenente l'associazione dati del controllo corrente.Gets the control that contains this control's data binding.

(Inherited from Control)
ChildControlsCreated ChildControlsCreated ChildControlsCreated ChildControlsCreated

Ottiene un valore che indica se i controlli figli del controllo server sono stati creati.Gets a value that indicates whether the server control's child controls have been created.

(Inherited from Control)
ClientID ClientID ClientID ClientID

Ottiene l'ID di controllo per il markup HTML generato da ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Inherited from Control)
ClientIDMode ClientIDMode ClientIDMode ClientIDMode

Ottiene o imposta l'algoritmo utilizzato per generare il valore della proprietà ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Inherited from Control)
ClientIDSeparator ClientIDSeparator ClientIDSeparator ClientIDSeparator

Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID.Gets a character value representing the separator character used in the ClientID property.

(Inherited from Control)
Context Context Context Context

Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente.Gets the HttpContext object associated with the server control for the current Web request.

(Inherited from Control)
Controls Controls Controls Controls

Ottiene un oggetto ControlCollection che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente.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

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Inherited from Control)
DataKeysContainer DataKeysContainer DataKeysContainer DataKeysContainer

Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Inherited from Control)
DataSource DataSource DataSource DataSource

Ottiene il controllo origine dati (oggetto IDataSource) da utilizzare per la query.Gets the data source control (IDataSource object) to use for the query.

DesignMode DesignMode DesignMode DesignMode

Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione.Gets a value indicating whether a control is being used on a design surface.

(Inherited from Control)
EnableTheming EnableTheming EnableTheming EnableTheming

Ottiene o imposta un valore che indica se al controllo vengono applicati i temi.Gets or sets a value indicating whether themes apply to this control.

(Inherited from Control)
EnableViewState EnableViewState EnableViewState EnableViewState

Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente.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

Ottiene un elenco dei delegati del gestore eventi per il controllo.Gets a list of event handler delegates for the control. Questa proprietà è di sola lettura.This property is read-only.

(Inherited from Control)
Expressions Expressions Expressions Expressions

Ottiene l'insieme di espressioni applicate al controllo IDataSource.Gets the collection of expressions that are applied to the IDataSource control.

HasChildViewState HasChildViewState HasChildViewState HasChildViewState

Ottiene un valore che indica se per i controlli figlio del controllo server corrente esistono impostazioni dello stato di visualizzazione salvate.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

Per una descrizione di questo membro, vedere ControlBuilder.For a description of this member, see ControlBuilder.

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

Per una descrizione di questo membro, vedere UserData.For a description of this member, see UserData.

(Inherited from Control)
ID ID ID ID

Ottiene o imposta l'identificatore a livello di codice assegnato al controllo server.Gets or sets the programmatic identifier assigned to the server control.

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

Per una descrizione di questo membro, vedere DataBindings.For a description of this member, see DataBindings.

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

Per una descrizione di questo membro, vedere HasDataBindings.For a description of this member, see HasDataBindings.

(Inherited from Control)
IdSeparator IdSeparator IdSeparator IdSeparator

Ottiene il carattere utilizzato per separare gli identificatori di controllo.Gets the character used to separate control identifiers.

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

Per una descrizione di questo membro, vedere Expressions.For a description of this member, see Expressions.

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

Per una descrizione di questo membro, vedere HasExpressions.For a description of this member, see HasExpressions.

(Inherited from Control)
IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared IsChildControlStateCleared

Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo.Gets a value indicating whether controls contained within this control have control state.

(Inherited from Control)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ottiene un valore che indica se il controllo server salva le modifiche allo stato di visualizzazione.Gets a value that indicates whether the server control is saving changes to its view state.

(Inherited from Control)
IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled IsViewStateEnabled

Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente.Gets a value indicating whether view state is enabled for this control.

(Inherited from Control)
LoadViewStateByID LoadViewStateByID LoadViewStateByID LoadViewStateByID

Ottiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'indice.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

Ottiene un riferimento al contenitore dei nomi del controllo server, che crea uno spazio dei nomi univoco per distinguere i controlli server che hanno lo stesso valore della proprietà 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

Ottiene un riferimento all'istanza Page che contiene il controllo server.Gets a reference to the Page instance that contains the server control.

(Inherited from Control)
Parent Parent Parent Parent

Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli della pagina.Gets a reference to the server control's parent control in the page control hierarchy.

(Inherited from Control)
RenderingCompatibility RenderingCompatibility RenderingCompatibility RenderingCompatibility

Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Inherited from Control)
Site Site Site Site

Ottiene informazioni sul contenitore del controllo corrente quando viene eseguito il rendering in un'area di progettazione.Gets information about the container that hosts the current control when rendered on a design surface.

(Inherited from Control)
SkinID SkinID SkinID SkinID

Ottiene o imposta l'interfaccia personalizzata da applicare al controllo.Gets or sets the skin to apply to the control.

(Inherited from Control)
TargetControlID TargetControlID TargetControlID TargetControlID

Ottiene o imposta l'ID del controllo IDataSource da utilizzare per la query.Gets or sets the ID of the IDataSource control to use for the query.

TemplateControl TemplateControl TemplateControl TemplateControl

Ottiene o imposta un riferimento al modello che contiene il controllo.Gets or sets a reference to the template that contains this control.

(Inherited from Control)
TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory TemplateSourceDirectory

Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Inherited from Control)
UniqueID UniqueID UniqueID UniqueID

Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server.Gets the unique, hierarchically qualified identifier for the server control.

(Inherited from Control)
ValidateRequestMode ValidateRequestMode ValidateRequestMode ValidateRequestMode

Ottiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser.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

Ottiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina.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

Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole.Gets a value that indicates whether the StateBag object is case-insensitive.

(Inherited from Control)
ViewStateMode ViewStateMode ViewStateMode ViewStateMode

Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo.Gets or sets the view-state mode of this control.

(Inherited from Control)
Visible Visible Visible Visible

Ottiene o imposta un valore che indica se viene eseguito il rendering di un controllo server come interfaccia utente nella pagina.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Inherited from Control)

Metodi

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

Chiamato dopo che un controllo figlio viene aggiunto alla raccolta Controls dell'oggetto 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 controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto ControlCollection del controllo server.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)

Applica al controllo le proprietà di stile definite nel foglio di stile della pagina.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)

Inizia la traccia in fase di progettazione dei dati di rendering.Begins design-time tracing of rendering data.

(Inherited from Control)
BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean) BuildProfileTree(String, Boolean)

Raccoglie informazioni sul controllo server e le recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina.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()

Imposta il valore memorizzato nella cache ClientID su null.Sets the cached ClientID value to null.

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

Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server.Deletes the control-state information for the server control's child controls.

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

Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server.Deletes the view-state and control-state information for all the server control's child controls.

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

Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server.Deletes the view-state information for all the server control's child controls.

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

Imposta la proprietà ClientIDMode dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Inherited from Control)
CreateChildControls() CreateChildControls() CreateChildControls() CreateChildControls()

Viene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che usano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti in preparazione per il postback o il rendering.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 nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server.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()

Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio.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)

Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'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()

Associa un'origine dati al controllo server e ai relativi controlli figlio.Binds a data source to the server control's child controls.

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

Abilita un controllo server alla pulizia finale prima che venga rilasciato dalla 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)

Termina la traccia in fase di progettazione dei dati di rendering.Ends design-time tracing of rendering data.

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

Determina se il controllo server contiene controlli figlio.Determines whether the server control contains child controls. In caso contrario, li crea.If it does not, it creates child controls.

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

Crea un identificatore per i controlli a cui non è assegnato alcun identificatore.Creates an identifier for controls that do not have an identifier assigned.

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

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

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

Cerca un controllo server nel contenitore dei nomi corrente con il parametro id specificato.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)

Cerca nel contenitore di denominazione corrente un controllo server con il parametro id indicato e un intero, specificato nel parametro pathOffset, che agevola la ricerca.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. Non eseguire l'override di questa versione del metodo FindControl.You should not override this version of the FindControl method.

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

Imposta lo stato attivo per l'input su un controllo.Sets input focus to a control.

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

Ottiene i dati della fase di progettazione per un controllo.Gets design-time data for a control.

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

Funge da funzione hash predefinita.Serves as the default hash function.

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

Ottiene l'URL corrispondente a un set di parametri di route.Gets the URL that corresponds to a set of route parameters.

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

Ottiene l'URL corrispondente a un set di parametri di route.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)

Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route.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)

Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route.Gets the URL that corresponds to a set of route parameters and a route name.

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

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

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

Restituisce la parte con prefisso della proprietà UniqueID del controllo specificato.Returns the prefixed portion of the UniqueID property of the specified control.

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

Determina se il controllo server contiene controlli figlio.Determines if the server control contains any child controls.

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

Restituisce un valore che indica se gli eventi vengono registrati per il controllo o eventuali controlli figlio.Returns a value indicating whether events are registered for the control or any child controls.

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

Determina se il controllo server conserva solo il contenuto literal.Determines if the server control holds only literal content.

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

Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo 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)

Carica nel controllo QueryExtender lo stato dei valori che devono essere mantenuti.Loads the state of the values in the QueryExtender control that must be persisted.

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

Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

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

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs) OnBubbleEvent(Object, EventArgs)

Determina se l'evento per il controllo server viene passato a un livello superiore nella gerarchia dei controlli server dell'interfaccia utente per la pagina.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 l'evento DataBinding.Raises the DataBinding event.

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

Si verifica quando viene inizializzata una nuova istanza della classe QueryExtender.Occurs when a new instance of the QueryExtender class is initialized.

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

Genera l'evento Load.Raises the Load event.

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

Genera l'evento PreRender.Raises the PreRender event.

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

Genera l'evento Unload.Raises the Unload event.

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

Ottiene un oggetto Stream utilizzato per leggere un file.Gets a Stream used to read a file.

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

Assegna eventuali origini dell'evento e relative informazioni al controllo padre.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)

Chiamato dopo che un controllo figlio viene rimosso dalla raccolta Controls dell'oggetto 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)

Invia il contenuto del controllo server a un oggetto HtmlTextWriter specificato che scrive il contenuto di cui eseguire il rendering nel client.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)

Invia il contenuto di un controllo figlio del controllo server a un oggetto HtmlTextWriter fornito, che scrive il contenuto di cui verrà effettuato il rendering sul client.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)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata.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)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

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

Ottiene l'adattatore del controllo responsabile del rendering del controllo specificato.Gets the control adapter responsible for rendering the specified control.

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

Ottiene un URL che può essere utilizzato dal browser.Gets a URL that can be used by the browser.

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

Converte un URL in un formato utilizzabile dal client richiedente.Converts a URL into one that is usable on the requesting client.

(Inherited from Control)
SaveControlState() SaveControlState() SaveControlState() SaveControlState()

Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server.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()

Salva lo stato di visualizzazione corrente del controllo QueryExtender.Saves the current view state of the QueryExtender control.

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

Imposta i dati della fase di progettazione per un controllo.Sets design-time data for a control.

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

Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre.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)

Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando la chiave dei dati di traccia e il valore dei dati di traccia.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)

Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia.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()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

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

Tiene traccia delle modifiche dello stato di visualizzazione del controllo QueryExtender in modo che possano essere archiviate nell'oggetto StateBag per il controllo.Tracks view-state changes of the QueryExtender control so that the changes can be stored in the StateBag object for the control.

Eventi

DataBinding DataBinding DataBinding DataBinding

Viene generato quando il controllo server viene associato a un'origine dati.Occurs when the server control binds to a data source.

(Inherited from Control)
Disposed Disposed Disposed Disposed

Si verifica quando un controllo server viene rilasciato dalla memoria, ossia nell'ultima fase della durata di un controllo server quando viene richiesta una pagina 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

Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Inherited from Control)
Load Load Load Load

Viene generato quando il controllo server è caricato nell'oggetto Page.Occurs when the server control is loaded into the Page object.

(Inherited from Control)
PreRender PreRender PreRender PreRender

Si verifica dopo il caricamento dell'oggetto Control ma prima del rendering.Occurs after the Control object is loaded but prior to rendering.

(Inherited from Control)
Unload Unload Unload Unload

Viene generato quando il controllo server viene scaricato dalla memoria.Occurs when the server control is unloaded from memory.

(Inherited from Control)

Implementazioni dell'interfaccia esplicita

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

Per una descrizione di questo membro, vedere GetDesignModeState().For a description of this member, see GetDesignModeState().

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

Per una descrizione di questo membro, vedere 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)

Per una descrizione di questo membro, vedere 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)

Per una descrizione di questo membro, vedere AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Inherited from Control)

Metodi di estensione

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

Restituisce l'origine dati associata al controllo dati per il controllo specificato.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)

Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.Returns the field template for the specified column in the specified control's naming container.

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

Restituisce l'oggetto metatabella per il controllo contenitore dei dati.Returns the metatable object for the containing data control.

Si applica a

Vedi anche