QueryExtender Klasa

Definicja

Umożliwia filtrowanie danych ze źródła danych bez jawnej Where klauzuli w źródle danych.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
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.QueryExtender), "QueryExtender.bmp")>]
type QueryExtender = class
    inherit Control
Public Class QueryExtender
Inherits Control
Dziedziczenie
QueryExtender
Atrybuty

Przykłady

Poniższy przykład pokazuje, jak używać QueryExtender kontrolki do udostępniania funkcji wyszukiwania na stronie sieci Web.The following example shows how to use the QueryExtender control to provide a search function in a Web page. QueryExtenderKontrolka używa tekstu wprowadzonego w TextBoxSearch kontrolce, aby wyszukać zawartość w kolumnach ProductName i dostawca. NazwaFirmy tabeli Products w danych, które są zwracane z LinqDataSource formantu.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. SearchExpressionObiekt jest używany do przeprowadzenia wyszukiwania.The SearchExpression object is used to perform the search. DataFieldsWłaściwość określa pola danych do wyszukania.The DataFields property specifies the data fields to search. SearchTypeWłaściwość określa typ wyszukiwania do wykonania.The SearchType property specifies the type of search to perform. ControlParameterElement Określa formant, który zawiera tekst, który ma być używany do wyszukiwania.The ControlParameter element specifies the control that contains the text to use for the search. Ten przykład kodu jest częścią większego przykładu, który jest dostępny w przewodniku: filtrowanie danych na stronie sieci Web przy użyciu składni deklaratywnej.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>  

Poniższy przykład pokazuje, jak za pomocą QueryExtender kontrolki przeszukać stronę sieci Web pod kątem wartości w określonym zakresie.The following example shows how to use the QueryExtender control to search a Web page for values in a specified range. QueryExtenderKontrolka używa wartości wprowadzonych w TextBoxFrom formantach i, TextBoxTo Aby wyszukać wartości w kolumnach ProductName i dostawca. NazwaFirmy tabeli Products w danych, które są zwracane z LinqDataSource formantu.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. ControlParameterElement określa kontrolki pola tekstowego, które zawierają wartości minimalne i maksymalne do użycia podczas wyszukiwania zakresu.The ControlParameter element specifies the text box controls that contain the minimum and maximum values to use for searching the range. MinTypeWłaściwości i MaxType określają, że wartości minimalne i maksymalne muszą być uwzględnione w zwracanych danych.The MinType and MaxType properties specify that the minimum and maximum values must be included in the data that is returned. Ten przykład kodu jest częścią większego przykładu podanego w przewodniku: filtrowanie danych na stronie sieci Web przy użyciu składni deklaratywnej.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>  

Uwagi

W tym temacie:In this topic:

WprowadzenieIntroduction

QueryExtenderKontrolka służy do tworzenia filtrów dla danych pobieranych ze źródła danych bez używania Where klauzuli Explicit w źródle danych.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. QueryExtenderKontrolka może służyć do określania filtrowania przy użyciu składni deklaratywnej.The QueryExtender control can be used to specify filtering by using declarative syntax.

TłoBackground

Filtrowanie wyklucza dane ze źródła danych, wyświetlając tylko te rekordy, które spełniają określone kryteria.Filtering excludes data from a data source by displaying only the records that meet specified criteria. Filtrowanie pozwala przedstawić różne widoki danych znajdujących się w zestawie danych bez wpływu na dane w zestawie danych.Filtering enables you to present different views of the data that is in a data set without affecting the data in the data set.

Filtrowanie zwykle wymaga utworzenia Where klauzuli, która ma zostać zastosowana do polecenia, które wysyła zapytanie do źródła danych.Filtering typically requires that you create a Where clause to apply to the command that queries the data source. Jednak Where Właściwość kontroli źródła danych może nie uwidaczniać pełnej dostępnej funkcjonalności.However, the Where property of the data source control might not expose the full functionality that is available. Na przykład kontrolka QueryExtender umożliwia wykonywanie zapytań względem tabeli przez wyszukiwanie ciągów na początku, na końcu lub w dowolnym miejscu w polu 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.

Aby udostępnić pełną funkcjonalność, która jest dostępna w LINQ i aby ułatwić filtrowanie danych, ASP.NETASP.NET zapewnia QueryExtender kontrolę.To expose the full functionality that is available in LINQ and to make filtering data easier, ASP.NETASP.NET provides the QueryExtender control. QueryExtenderKontrolka ma następujące zalety:The QueryExtender control has the following benefits:

  • Zapewnia bogatsze środowisko filtrowania niż pisanie Where klauzuli.It provides a richer filtering experience than writing a Where clause. Na przykład można wyszukiwać w tabeli Products wartości logiczne przy użyciu PropertyExpression filtra bez pisania zapytania.For example, you can search a Products table for Boolean values by using the PropertyExpression filter without writing a query.

  • Umożliwia określenie filtrów za pomocą tej samej składni dla LinqDataSource EntityDataSource formantów i i dla innych kontrolek źródła danych, które mogą być używane.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.

  • Może być używany z LinqDataSource formantem, z EntityDataSource kontrolką lub źródłami danych innych firm.It can be used with LinqDataSource control, with a EntityDataSource control, or with third-party data sources.

Opcje filtruFilter Options

QueryExtenderKontrolka obsługuje różne opcje, których można użyć do filtrowania danych.The QueryExtender control supports a variety of options that you can use to filter data. Kontrolka umożliwia wyszukiwanie ciągów, wyszukiwanie wartości liczbowych w określonym zakresie i porównywanie wartości właściwości w tabeli z określoną wartością.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. Kontrolka umożliwia również sortowanie danych i dostarczanie niestandardowych zapytań.The control also lets you sort the data and provide custom queries.

Te opcje są dostępne jako wyrażenia LINQ w QueryExtender kontrolce.These options are provided as LINQ expressions in the QueryExtender control. QueryExtenderFormant obsługuje również wyrażenia, które są specyficzne dla ASP.NETASP.NET dynamicznych aplikacji danych.The QueryExtender control also supports expressions that are specific to ASP.NETASP.NET Dynamic Data applications.

W poniższej tabeli wymieniono opcje, których można użyć do filtrowania danych w QueryExtender formancie.The following table lists the options that you can use to filter data in the QueryExtender control.

WyrażenieExpression OpisDescription
ControlFilterExpression (Tylko dane dynamiczne) Kompiluje zapytanie bazy danych przy użyciu klucza danych wybranego w kontrolce powiązanej z danymi źródłowymi.(Dynamic Data only) Builds a database query by using the data key that is selected in a source data-bound control.

Aby uzyskać informacje o sposobach korzystania z tej opcji filtru, zobacz How to: Filter wierszy tabeli przy użyciu wartości z tabeli nadrzędnej w danych dynamicznych.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 Określa zdefiniowane przez użytkownika wyrażenie dla źródła danych.Specifies a user-defined expression for a data source. Niestandardowe wyrażenie LINQ może być wywoływane w programie obsługi zdarzeń.The custom LINQ expression can be invoked in an event handler.
DynamicFilterExpression (Tylko dane dynamiczne) Kompiluje zapytanie bazy danych przy użyciu określonej DynamicFilter kontrolki.(Dynamic Data only) Builds a database query by using the specified DynamicFilter control.

Aby uzyskać informacje o sposobach korzystania z tej opcji filtru, zobacz How to: Filter Rows Table wierszs using Foreign Key in dane dynamiczne.For information about how to use this filter option, see How to: Filter Table Rows Using Foreign Key in Dynamic Data.
MethodExpression Określa zdefiniowane przez użytkownika wyrażenie LINQ dla źródła danych.Specifies a user-defined LINQ expression for a data source. Wyrażenie jest wywoływane w metodzie.The expression is invoked in a method.
OrderByExpression Stosuje wyrażenie sortowania do IQueryable obiektu źródła danych.Applies a sort expression to an IQueryable data source object. Po zastosowaniu OrderByExpression wartości można zastosować dodatkowe operacje sortowania, określając ThenByExpressions wartość.After you apply the OrderByExpression value, you can apply additional sort operations by specifying a ThenByExpressions value.
PropertyExpression Porównuje właściwości pola danych i wartości właściwości, które są określone w WhereParameters kolekcji.Compares the properties the data field and property values that are specified in the WhereParameters collection.
RangeExpression Określa, czy wartość jest większa niż określona wartość lub czy wartość należy do przedziału od dwóch wartości.Determines whether a value is greater than or less than a specified value, or whether a value is between two values.
SearchExpression Porównuje wartości w polu lub polach z określoną wartością ciągu.Compares values in a field or fields to a specified string value.

Możesz użyć tych QueryExtender opcji pojedynczo lub połączyć je, aby zapewnić złożone filtrowanie na stronie sieci Web.You can use these QueryExtender options individually or you can combine them to provide complex filtering in a Web page. Aby uzyskać więcej informacji, zobacz QueryExtender Web Server Control — Omówienie.For more information, see QueryExtender Web Server Control Overview. Przewodnik: filtrowanie danych na stronie sieci Web przy użyciu składni deklaracyjnejWalkthrough: Filtering Data in a Web Page Using Declarative Syntax

ZadaniaTasks

Poniższa tabela zawiera listę zadań, które pokazują, jak używać QueryExtender kontrolki do filtrowania danych.The following table lists tasks that show how to use the QueryExtender control to filter data.

DokumentDocument ZadanieTask
Przewodnik: filtrowanie danych na stronie sieci Web przy użyciu składni deklaracyjnejWalkthrough: Filtering Data in a Web Page Using Declarative Syntax Pokazuje, w jaki sposób używać opcji filtru QueryExtender udostępnianych przez formant.Shows how to use the filter options that the QueryExtender control provides.

Składnia deklaracyjnaDeclarative 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>  

Konstruktory

QueryExtender()

Inicjuje nowe wystąpienie QueryExtender klasy.Initializes a new instance of the QueryExtender Class.

Właściwości

Adapter

Pobiera kartę specyficzną dla przeglądarki dla kontrolki.Gets the browser-specific adapter for the control.

(Odziedziczone po Control)
AppRelativeTemplateSourceDirectory

Pobiera lub ustawia katalog wirtualny względem aplikacji Page lub UserControl obiekt, który zawiera tę kontrolkę.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Odziedziczone po Control)
BindingContainer

Pobiera formant, który zawiera powiązanie danych tego formantu.Gets the control that contains this control's data binding.

(Odziedziczone po Control)
ChildControlsCreated

Pobiera wartość wskazującą, czy zostały utworzone formanty podrzędne kontrolki serwera.Gets a value that indicates whether the server control's child controls have been created.

(Odziedziczone po Control)
ClientID

Pobiera identyfikator formantu dla znacznika HTML, który jest generowany przez ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Odziedziczone po Control)
ClientIDMode

Pobiera lub ustawia algorytm używany do generowania wartości ClientID właściwości.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Odziedziczone po Control)
ClientIDSeparator

Pobiera wartość znaku reprezentującą znak separatora używany we ClientID właściwości.Gets a character value representing the separator character used in the ClientID property.

(Odziedziczone po Control)
Context

Pobiera HttpContext obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web.Gets the HttpContext object associated with the server control for the current Web request.

(Odziedziczone po Control)
Controls

Pobiera ControlCollection obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

(Odziedziczone po Control)
DataItemContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa jest zaimplementowany IDataItemContainer .Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Odziedziczone po Control)
DataKeysContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa jest zaimplementowany IDataKeysControl .Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Odziedziczone po Control)
DataSource

Pobiera formant źródła danych ( IDataSource Object) do użycia w zapytaniu.Gets the data source control (IDataSource object) to use for the query.

DesignMode

Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej.Gets a value indicating whether a control is being used on a design surface.

(Odziedziczone po Control)
EnableTheming

Pobiera lub ustawia wartość wskazującą, czy motywy stosują się do tej kontrolki.Gets or sets a value indicating whether themes apply to this control.

(Odziedziczone po Control)
EnableViewState

Pobiera lub ustawia wartość wskazującą, czy formant serwera utrzymuje stan widoku, oraz stan widoku wszystkich formantów podrzędnych, które zawiera, do żądającego klienta.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.

(Odziedziczone po Control)
Events

Pobiera listę delegatów obsługi zdarzeń dla formantu.Gets a list of event handler delegates for the control. Ta właściwość jest tylko do odczytu.This property is read-only.

(Odziedziczone po Control)
Expressions

Pobiera kolekcję wyrażeń, które są stosowane do IDataSource kontrolki.Gets the collection of expressions that are applied to the IDataSource control.

HasChildViewState

Pobiera wartość wskazującą, czy bieżące kontrolki formantu serwera mają jakiekolwiek zapisane ustawienia stanu widoku.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Odziedziczone po Control)
ID

Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwerowej.Gets or sets the programmatic identifier assigned to the server control.

(Odziedziczone po Control)
IdSeparator

Pobiera znak używany do oddzielania identyfikatorów kontroli.Gets the character used to separate control identifiers.

(Odziedziczone po Control)
IsChildControlStateCleared

Pobiera wartość wskazującą, czy kontrolki zawarte w tym formancie mają stan kontroli.Gets a value indicating whether controls contained within this control have control state.

(Odziedziczone po Control)
IsTrackingViewState

Pobiera wartość wskazującą, czy formant serwera zapisuje zmiany w stanie widoku.Gets a value that indicates whether the server control is saving changes to its view state.

(Odziedziczone po Control)
IsViewStateEnabled

Pobiera wartość wskazującą, czy stan widoku jest włączony dla tego formantu.Gets a value indicating whether view state is enabled for this control.

(Odziedziczone po Control)
LoadViewStateByID

Pobiera wartość wskazującą, czy formant uczestniczy w ładowaniu stanu widoku przez ID zamianę na indeks.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Odziedziczone po Control)
NamingContainer

Pobiera odwołanie do kontenera nazw kontrolki serwera, który tworzy unikatową przestrzeń nazw do rozróżniania między kontrolkami serwera z tą samą ID wartością właściwości.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.

(Odziedziczone po Control)
Page

Pobiera odwołanie do Page wystąpienia, które zawiera formant serwera.Gets a reference to the Page instance that contains the server control.

(Odziedziczone po Control)
Parent

Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii formantów strony.Gets a reference to the server control's parent control in the page control hierarchy.

(Odziedziczone po Control)
RenderingCompatibility

Pobiera wartość określającą ASP.NET wersję, która będzie zgodna z językiem HTML.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Odziedziczone po Control)
Site

Pobiera informacje o kontenerze, który hostuje bieżącą kontrolkę, gdy jest renderowany na powierzchni projektowej.Gets information about the container that hosts the current control when rendered on a design surface.

(Odziedziczone po Control)
SkinID

Pobiera lub ustawia skórkę, która ma zostać zastosowana do kontrolki.Gets or sets the skin to apply to the control.

(Odziedziczone po Control)
TargetControlID

Pobiera lub ustawia identyfikator IDataSource formantu, który ma być używany w zapytaniu.Gets or sets the ID of the IDataSource control to use for the query.

TemplateControl

Pobiera lub ustawia odwołanie do szablonu, który zawiera tę kontrolkę.Gets or sets a reference to the template that contains this control.

(Odziedziczone po Control)
TemplateSourceDirectory

Pobiera katalog wirtualny Page lub zawierający UserControl bieżącą kontrolkę serwerową.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Odziedziczone po Control)
UniqueID

Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator dla kontrolki serwerowej.Gets the unique, hierarchically qualified identifier for the server control.

(Odziedziczone po Control)
ValidateRequestMode

Pobiera lub ustawia wartość wskazującą, czy formant sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Odziedziczone po Control)
ViewState

Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach na tej samej stronie.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.

(Odziedziczone po Control)
ViewStateIgnoresCase

Pobiera wartość wskazującą, czy w StateBag obiekcie nie jest rozróżniana wielkość liter.Gets a value that indicates whether the StateBag object is case-insensitive.

(Odziedziczone po Control)
ViewStateMode

Pobiera lub ustawia tryb widoku stanu tego formantu.Gets or sets the view-state mode of this control.

(Odziedziczone po Control)
Visible

Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera jest renderowana jako interfejs użytkownika na stronie.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Odziedziczone po Control)

Metody

AddedControl(Control, Int32)

Wywołuje się po dodaniu formantu podrzędnego do Controls kolekcji Control obiektu.Called after a child control is added to the Controls collection of the Control object.

(Odziedziczone po Control)
AddParsedSubObject(Object)

Powiadamia formant serwera o przeanalizowaniu elementu, XML lub HTML, a następnie dodaje element do obiektu formantu serwera ControlCollection .Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Odziedziczone po Control)
ApplyStyleSheetSkin(Page)

Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki.Applies the style properties defined in the page style sheet to the control.

(Odziedziczone po Control)
BeginRenderTracing(TextWriter, Object)

Rozpoczyna śledzenie danych renderowania w czasie projektowania.Begins design-time tracing of rendering data.

(Odziedziczone po Control)
BuildProfileTree(String, Boolean)

Zbiera informacje o formancie serwera i dostarcza go do Trace właściwości, która będzie wyświetlana po włączeniu śledzenia dla strony.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Odziedziczone po Control)
ClearCachedClientID()

Ustawia wartość w pamięci podręcznej ClientID na null .Sets the cached ClientID value to null.

(Odziedziczone po Control)
ClearChildControlState()

Usuwa informacje o stanie formantu dla kontrolek podrzędnych kontrolki serwerowej.Deletes the control-state information for the server control's child controls.

(Odziedziczone po Control)
ClearChildState()

Usuwa informacje o stanie widoku i kontroli dla wszystkich formantów podrzędnych formantu serwera.Deletes the view-state and control-state information for all the server control's child controls.

(Odziedziczone po Control)
ClearChildViewState()

Usuwa informacje o stanie widoku dla wszystkich formantów podrzędnych formantu serwera.Deletes the view-state information for all the server control's child controls.

(Odziedziczone po Control)
ClearEffectiveClientIDMode()

Ustawia ClientIDMode Właściwość bieżącego wystąpienia kontrolki i wszystkich formantów podrzędnych na Inherit .Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Odziedziczone po Control)
CreateChildControls()

Wywoływane przez platformę strony ASP.NET w celu powiadomienia formantów serwera, które używają implementacji opartej na kompozycjach, do tworzenia wszelkich formantów podrzędnych, które zawierają w przygotowaniu do ponownego ogłaszania lub renderowania.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.

(Odziedziczone po Control)
CreateControlCollection()

Tworzy nowy ControlCollection obiekt do przechowywania formantów podrzędnych (zarówno literału, jak i serwera) formantu serwera.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Odziedziczone po Control)
DataBind()

Tworzy powiązanie źródła danych z wywołaną kontrolką serwera i wszystkimi jego kontrolkami podrzędnymi.Binds a data source to the invoked server control and all its child controls.

(Odziedziczone po Control)
DataBind(Boolean)

Tworzy powiązanie źródła danych z wywoływanym formantem serwera i wszystkimi jego kontrolkami podrzędnymi z opcją podniesienia poziomu DataBinding zdarzenia.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Odziedziczone po Control)
DataBindChildren()

Tworzy powiązanie źródła danych z kontrolkami podrzędnymi formantu serwera.Binds a data source to the server control's child controls.

(Odziedziczone po Control)
Dispose()

Umożliwia formantowi serwera przeprowadzenie końcowego oczyszczania przed jego zwolnieniem z pamięci.Enables a server control to perform final clean up before it is released from memory.

(Odziedziczone po Control)
EndRenderTracing(TextWriter, Object)

Przerywa śledzenie danych renderowania w czasie projektowania.Ends design-time tracing of rendering data.

(Odziedziczone po Control)
EnsureChildControls()

Określa, czy formant serwera zawiera kontrolki podrzędne.Determines whether the server control contains child controls. Jeśli tak nie jest, tworzy kontrolki podrzędne.If it does not, it creates child controls.

(Odziedziczone po Control)
EnsureID()

Tworzy identyfikator dla kontrolek, które nie mają przypisanego identyfikatora.Creates an identifier for controls that do not have an identifier assigned.

(Odziedziczone po Control)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
FindControl(String)

Wyszukuje w bieżącym kontenerze nazewnictwa dla kontrolki serwera z określonym id parametrem.Searches the current naming container for a server control with the specified id parameter.

(Odziedziczone po Control)
FindControl(String, Int32)

Wyszukuje w bieżącym kontenerze nazewnictwa dla kontrolki serwera z określoną id i liczbą całkowitą, która jest określona w pathOffset parametrze, który ułatwia wyszukiwanie.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. Nie należy przesłaniać tej wersji FindControl metody.You should not override this version of the FindControl method.

(Odziedziczone po Control)
Focus()

Ustawia fokus wprowadzania dla kontrolki.Sets input focus to a control.

(Odziedziczone po Control)
GetDesignModeState()

Pobiera dane czasu projektowania dla kontrolki.Gets design-time data for a control.

(Odziedziczone po Control)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetRouteUrl(Object)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.Gets the URL that corresponds to a set of route parameters.

(Odziedziczone po Control)
GetRouteUrl(RouteValueDictionary)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.Gets the URL that corresponds to a set of route parameters.

(Odziedziczone po Control)
GetRouteUrl(String, Object)

Pobiera adres URL, który odnosi się do zestawu parametrów trasy i nazwy trasy.Gets the URL that corresponds to a set of route parameters and a route name.

(Odziedziczone po Control)
GetRouteUrl(String, RouteValueDictionary)

Pobiera adres URL, który odnosi się do zestawu parametrów trasy i nazwy trasy.Gets the URL that corresponds to a set of route parameters and a route name.

(Odziedziczone po Control)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)

Zwraca przedznaczoną część UniqueID właściwości określonej kontrolki.Returns the prefixed portion of the UniqueID property of the specified control.

(Odziedziczone po Control)
HasControls()

Określa, czy formant serwera zawiera wszystkie kontrolki podrzędne.Determines if the server control contains any child controls.

(Odziedziczone po Control)
HasEvents()

Zwraca wartość wskazującą czy zdarzenia są rejestrowane dla kontrolki lub wszelkich formantów podrzędnych.Returns a value indicating whether events are registered for the control or any child controls.

(Odziedziczone po Control)
IsLiteralContent()

Określa, czy formant serwera przechowuje tylko zawartość literału.Determines if the server control holds only literal content.

(Odziedziczone po Control)
LoadControlState(Object)

Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez SaveControlState() metodę.Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Odziedziczone po Control)
LoadViewState(Object)

Ładuje stan wartości w QueryExtender kontrolce, która musi być utrwalona.Loads the state of the values in the QueryExtender control that must be persisted.

MapPathSecure(String)

Pobiera ścieżkę fizyczną, do której jest mapowana ścieżka wirtualna (absolutna lub względna).Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Odziedziczone po Control)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnBubbleEvent(Object, EventArgs)

Określa, czy zdarzenie dla formantu serwera jest przenoszone do hierarchii kontroli serwera interfejsu użytkownika strony.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Odziedziczone po Control)
OnDataBinding(EventArgs)

Podnosi DataBinding zdarzenie.Raises the DataBinding event.

(Odziedziczone po Control)
OnInit(EventArgs)

Występuje, gdy zostanie zainicjowane nowe wystąpienie QueryExtender klasy.Occurs when a new instance of the QueryExtender class is initialized.

OnLoad(EventArgs)

Podnosi Load zdarzenie.Raises the Load event.

(Odziedziczone po Control)
OnPreRender(EventArgs)

Podnosi PreRender zdarzenie.Raises the PreRender event.

(Odziedziczone po Control)
OnUnload(EventArgs)

Podnosi Unload zdarzenie.Raises the Unload event.

(Odziedziczone po Control)
OpenFile(String)

Pobiera informacje Stream używane do odczytu pliku.Gets a Stream used to read a file.

(Odziedziczone po Control)
RaiseBubbleEvent(Object, EventArgs)

Przypisuje wszystkie źródła zdarzenia i informacje do elementu nadrzędnego formantu.Assigns any sources of the event and its information to the control's parent.

(Odziedziczone po Control)
RemovedControl(Control)

Wywoływana po usunięciu formantu podrzędnego z Controls kolekcji Control obiektu.Called after a child control is removed from the Controls collection of the Control object.

(Odziedziczone po Control)
Render(HtmlTextWriter)

Wysyła zawartość kontrolki serwera do podanego HtmlTextWriter obiektu, który zapisuje zawartość, która ma być renderowana na kliencie.Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Odziedziczone po Control)
RenderChildren(HtmlTextWriter)

Wyprowadza zawartość elementu podrzędnego kontrolki serwera do podanego HtmlTextWriter obiektu, który zapisuje zawartość, która ma być renderowana na kliencie.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Odziedziczone po Control)
RenderControl(HtmlTextWriter)

Wyprowadza zawartość kontrolki serwera do podanego HtmlTextWriter obiektu i przechowuje informacje o śledzeniu dla kontrolki, jeśli śledzenie jest włączone.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Odziedziczone po Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Wyprowadza zawartość kontrolki serwera do podanego HtmlTextWriter obiektu za pomocą podanego ControlAdapter obiektu.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Odziedziczone po Control)
ResolveAdapter()

Pobiera adapter sterowania odpowiedzialny za renderowanie określonego formantu.Gets the control adapter responsible for rendering the specified control.

(Odziedziczone po Control)
ResolveClientUrl(String)

Pobiera adres URL, który może być używany przez przeglądarkę.Gets a URL that can be used by the browser.

(Odziedziczone po Control)
ResolveUrl(String)

Konwertuje adres URL na taki, który jest używany na żądającym klienta.Converts a URL into one that is usable on the requesting client.

(Odziedziczone po Control)
SaveControlState()

Zapisuje wszelkie zmiany stanu formantu serwera, które wystąpiły od momentu, gdy strona została opublikowana na serwerze.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Odziedziczone po Control)
SaveViewState()

Zapisuje bieżący stan widoku QueryExtender formantu.Saves the current view state of the QueryExtender control.

SetDesignModeState(IDictionary)

Ustawia dane czasu projektowania dla kontrolki.Sets design-time data for a control.

(Odziedziczone po Control)
SetRenderMethodDelegate(RenderMethod)

Przypisuje delegata programu obsługi zdarzeń, aby renderować formant serwera i jego zawartość w jego formancie nadrzędnym.Assigns an event handler delegate to render the server control and its content into its parent control.

(Odziedziczone po Control)
SetTraceData(Object, Object)

Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Odziedziczone po Control)
SetTraceData(Object, Object, Object)

Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu obiektu śledzenia, klucza danych śledzenia i wartości danych śledzenia.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Odziedziczone po Control)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
TrackViewState()

Śledzi zmiany stanu widoku QueryExtender kontrolki, tak aby zmiany mogły być przechowywane w StateBag obiekcie dla kontrolki.Tracks view-state changes of the QueryExtender control so that the changes can be stored in the StateBag object for the control.

Zdarzenia

DataBinding

Występuje, gdy formant serwera wiąże się ze źródłem danych.Occurs when the server control binds to a data source.

(Odziedziczone po Control)
Disposed

Występuje, gdy formant serwera zostanie wystawiony z pamięci, który jest ostatnim etapem cyklu życia formantu serwera, gdy zażądano strony 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.

(Odziedziczone po Control)
Init

Występuje po zainicjowaniu formantu serwera, który jest pierwszym krokiem w jego cyklu życia.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Odziedziczone po Control)
Load

Występuje, gdy kontrolka serwera jest załadowana do Page obiektu.Occurs when the server control is loaded into the Page object.

(Odziedziczone po Control)
PreRender

Występuje po Control załadowaniu obiektu, ale przed renderowaniem.Occurs after the Control object is loaded but prior to rendering.

(Odziedziczone po Control)
Unload

Występuje, gdy formant serwera zostanie zwolniony z pamięci.Occurs when the server control is unloaded from memory.

(Odziedziczone po Control)

Jawne implementacje interfejsu

IControlBuilderAccessor.ControlBuilder

Aby uzyskać opis tego elementu członkowskiego, zobacz ControlBuilder .For a description of this member, see ControlBuilder.

(Odziedziczone po Control)
IControlDesignerAccessor.GetDesignModeState()

Aby uzyskać opis tego elementu członkowskiego, zobacz GetDesignModeState() .For a description of this member, see GetDesignModeState().

(Odziedziczone po Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetDesignModeState(IDictionary) .For a description of this member, see SetDesignModeState(IDictionary).

(Odziedziczone po Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control) .For a description of this member, see SetOwnerControl(Control).

(Odziedziczone po Control)
IControlDesignerAccessor.UserData

Aby uzyskać opis tego elementu członkowskiego, zobacz UserData .For a description of this member, see UserData.

(Odziedziczone po Control)
IDataBindingsAccessor.DataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings .For a description of this member, see DataBindings.

(Odziedziczone po Control)
IDataBindingsAccessor.HasDataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings .For a description of this member, see HasDataBindings.

(Odziedziczone po Control)
IExpressionsAccessor.Expressions

Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions .For a description of this member, see Expressions.

(Odziedziczone po Control)
IExpressionsAccessor.HasExpressions

Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions .For a description of this member, see HasExpressions.

(Odziedziczone po Control)
IParserAccessor.AddParsedSubObject(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object) .For a description of this member, see AddParsedSubObject(Object).

(Odziedziczone po Control)

Metody rozszerzania

FindDataSourceControl(Control)

Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonego formantu.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Zwraca obiekt obiektu z tabeli dla kontrolki zawierającej dane.Returns the metatable object for the containing data control.

Dotyczy

Zobacz też