FilterRepeater Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa um controlo que enumera as colunas da tabela que podem ser filtradas.
public ref class FilterRepeater : System::Web::UI::WebControls::Repeater, System::Web::DynamicData::IWhereParametersProvider
public class FilterRepeater : System.Web.UI.WebControls.Repeater, System.Web.DynamicData.IWhereParametersProvider
type FilterRepeater = class
inherit Repeater
interface IWhereParametersProvider
Public Class FilterRepeater
Inherits Repeater
Implements IWhereParametersProvider
- Herança
- Implementações
Observações
Este tipo é obsoleto. Use QueryableFilterRepeater, em vez disso.
Neste tópico:
Introduction
O controlo FilterRepeater é um controlo no framework ASP.NET Dynamic Data. Renderiza automaticamente controlos que podem ser usados para filtrar linhas de dados que são exibidas para uma tabela. Os filtros funcionam fornecendo uma lista de Where parâmetros à fonte de dados para cada tipo de coluna suportado. Por defeito, os Dados Dinâmicos filtram colunas de chave estrangeira e Booleanas e renderizam-nas usando um DropDownList controlo de lista.
O FilterRepeater controlo é um controlo especializado Repeater que se liga automaticamente a uma coleção de colunas filtráveis para a tabela que é apresentada na página atual. Por exemplo, se for feito um pedido para /Products/List.aspx, o FilterRepeater controlo atribui-se às colunas da tabela Products. A tabela é escolhida com base na rota que corresponde ao pedido. Também pode ser anulado definindo as TableName propriedades e ContextTypeName do FilterRepeater controlo.
Para mostrar a interface do filtro, o ItemTemplate modelo do FilterRepeater controlo deve conter um controlo com um ID conhecido. Por defeito, o ID conhecido é "DynamicFilter". O controlo no template de item deve derivar de FilterUserControlBase. Quando ocorre a ligação de dados, o FilterRepeater controlo inicializa uma instância do controlo do filtro com informação sobre a coluna a filtrar.
Sintaxe declarativa
<asp:FilterRepeater
ContextTypeName="string"
DataMember="string"
DataSource="string"
DataSourceID="string"
DynamicFilterContainerId="string"
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnItemCommand="ItemCommand event handler"
OnItemCreated="ItemCreated event handler"
OnItemDataBound="ItemDataBound event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
TableName="string"
Visible="True|False"
>
<AlternatingItemTemplate>
<!-- child controls -->
</AlternatingItemTemplate>
<FooterTemplate>
<!-- child controls -->
</FooterTemplate>
<HeaderTemplate>
<!-- child controls -->
</HeaderTemplate>
<ItemTemplate>
<!-- child controls -->
</ItemTemplate>
<SeparatorTemplate>
<!-- child controls -->
</SeparatorTemplate>
</asp:FilterRepeater>
Construtores
| Name | Description |
|---|---|
| FilterRepeater() |
Inicializa uma nova instância da FilterRepeater classe. |
Propriedades
| Name | Description |
|---|---|
| Adapter |
Recebe o adaptador específico do navegador para o controlo. (Herdado de Control) |
| AlternatingItemTemplate |
Obtém ou define o objeto que define ITemplate como os itens alternados no controlo são exibidos. (Herdado de Repeater) |
| AppRelativeTemplateSourceDirectory |
Obtém ou define o diretório virtual relativo à aplicação do Page objeto ou UserControl que contém este controlo. (Herdado de Control) |
| BindingContainer |
Obtém o controlo que contém a ligação de dados desse controlo. (Herdado de Control) |
| ChildControlsCreated |
Recebe um valor que indica se os controlos filhos do controlo do servidor foram criados. (Herdado de Control) |
| ClientID |
Obtém o ID de controlo para a marcação HTML gerada pelo ASP.NET. (Herdado de Control) |
| ClientIDMode |
Obtém ou define o algoritmo que é usado para gerar o valor da ClientID propriedade. (Herdado de Control) |
| ClientIDSeparator |
Obtém um valor de carácter que representa o carácter separador usado na ClientID propriedade. (Herdado de Control) |
| Context |
Obtém o controlo do HttpContext objeto associado ao servidor para o pedido Web atual. (Herdado de Control) |
| ContextTypeName |
Obtém ou define o nome do objeto fonte de dados a usar para recuperar os dados. |
| Controls |
Obtém um ControlCollection que contém os controlos filhos do Repeater controlo. (Herdado de Repeater) |
| DataItemContainer |
Obtém uma referência ao contentor de nomes se o contentor implementar IDataItemContainer. (Herdado de Control) |
| DataKeysContainer |
Obtém uma referência ao contentor de nomes se o contentor implementar IDataKeysControl. (Herdado de Control) |
| DataMember |
Obtém ou define a tabela DataSource específica no para ligar ao controlo. (Herdado de Repeater) |
| DataSource |
Obtém ou define a fonte de dados que fornece dados para preencher a lista. (Herdado de Repeater) |
| DataSourceID |
Obtém ou define a ID propriedade do controlo de fonte de dados que o Repeater controlo deve usar para recuperar a sua fonte de dados. (Herdado de Repeater) |
| DesignMode |
Obtém um valor que indica se um controlo está a ser usado numa superfície de projeto. (Herdado de Control) |
| DynamicFilterContainerId |
Obtém ou define o ID do FilterRepeater controlo numa ItemTemplate instância. |
| EnableTheming |
Recebe ou define um valor que indica se os temas são aplicados a este controlo. (Herdado de Repeater) |
| EnableViewState |
Recebe ou define um valor que indica se o controlo do servidor mantém o seu estado de visualização, e o estado de vista de quaisquer controlos filhos que contém, para o cliente solicitante. (Herdado de Control) |
| Events |
Obtém uma lista de delegados handler de eventos para o controlo. Esta propriedade é somente leitura. (Herdado de Control) |
| FooterTemplate |
Obtém ou define o ITemplate que define como a secção Repeater do rodapé do controlo é apresentada. (Herdado de Repeater) |
| HasChildViewState |
Recebe um valor que indica se os controlos filhos do controlo atual do servidor têm alguma configuração de estado de visualização guardada. (Herdado de Control) |
| HeaderTemplate |
Obtém ou define o ITemplate que define como a secção do cabeçalho do Repeater controlo é exibida. (Herdado de Repeater) |
| ID |
Obtém ou define o identificador programático atribuído ao controlo do servidor. (Herdado de Control) |
| IdSeparator |
Faz com que o carácter seja usado para separar identificadores de controlo. (Herdado de Control) |
| Initialized |
Devolve um valor que indica se o controlo foi inicializado. (Herdado de Repeater) |
| IsBoundUsingDataSourceID |
Recebe um valor que indica se a DataSourceID propriedade está definida. (Herdado de Repeater) |
| IsChildControlStateCleared |
Obtém um valor que indica se os controlos contidos neste controlo têm estado de controlo. (Herdado de Control) |
| IsDataBindingAutomatic |
Obtém um valor que indica se a ligação de dados é automática. (Herdado de Repeater) |
| IsTrackingViewState |
Recebe um valor que indica se o controlo do servidor está a guardar alterações ao estado de visualização. (Herdado de Control) |
| IsViewStateEnabled |
Recebe um valor que indica se o estado de visualização está ativado para este controlo. (Herdado de Control) |
| Items |
Obtém uma coleção de RepeaterItem objetos no Repeater controlo. (Herdado de Repeater) |
| ItemTemplate |
Obtém ou define o ITemplate que define como os itens no Repeater controlo são exibidos. (Herdado de Repeater) |
| ItemType |
O nome do tipo de modelo para ligação de dados fortemente tipada. (Herdado de Repeater) |
| LoadViewStateByID |
Recebe um valor que indica se o controlo participa no carregamento do seu estado de visualização em ID vez de index. (Herdado de Control) |
| NamingContainer |
Obtém uma referência ao contentor de nomes do controlo do servidor, que cria um namespace único para diferenciar controlos de servidor com o mesmo ID valor de propriedade. (Herdado de Control) |
| Page |
Obtém uma referência à Page instância que contém o controlo do servidor. (Herdado de Control) |
| Parent |
Obtém uma referência ao controlo pai do controlo do servidor na hierarquia de controlo de página. (Herdado de Control) |
| RenderingCompatibility |
Recebe um valor que especifica a versão ASP.NET com a qual o HTML renderizado será compatível. (Herdado de Control) |
| RequiresDataBinding |
Recebe ou define um valor que indica se o controlo Repeater precisa de se ligar à sua fonte de dados especificada. (Herdado de Repeater) |
| SelectArguments |
Obtém um DataSourceSelectArguments objeto que o Repeater controlo usa ao recuperar dados de um controlo fonte de dados. (Herdado de Repeater) |
| SelectMethod |
O nome do método a chamar para ler dados. (Herdado de Repeater) |
| SeparatorTemplate |
Obtém ou define a ITemplate interface que define como o separador entre os itens é exibido. (Herdado de Repeater) |
| Site |
Obtém informação sobre o contentor que aloja o controlo atual quando renderizado numa superfície de design. (Herdado de Control) |
| SkinID |
Obtém ou fixa a pele para aplicar no controlo. (Herdado de Control) |
| Table |
Obtém a tabela associada ao FilterRepeater controlo. |
| TableName |
Obtém o nome da tabela para filtrar. |
| TemplateControl |
Recebe ou define uma referência ao template que contém esse controlo. (Herdado de Control) |
| TemplateSourceDirectory |
Obtém o diretório virtual do Page ou UserControl que contém o controlo atual do servidor. (Herdado de Control) |
| UniqueID |
Obtém o identificador único e hierarquicamente qualificado para o controlo do servidor. (Herdado de Control) |
| ValidateRequestMode |
Recebe ou define um valor que indica se o controlo verifica a entrada do cliente do navegador para valores potencialmente perigosos. (Herdado de Control) |
| ViewState |
Obtém um dicionário de informação de estado que permite guardar e restaurar o estado de visualização de um controlo de servidor através de múltiplos pedidos para a mesma página. (Herdado de Control) |
| ViewStateIgnoresCase |
Obtém um valor que indica se o StateBag objeto é indistinto a maiúsculas e maiúsculas. (Herdado de Control) |
| ViewStateMode |
Obtém ou define o modo view-state deste controlo. (Herdado de Control) |
| Visible |
Recebe ou define um valor que especifica se o controlo é exibido. |
Métodos
| Name | Description |
|---|---|
| AddedControl(Control, Int32) |
Chamado após um controlo filho ser adicionado à Controls coleção do Control objeto. (Herdado de Control) |
| AddParsedSubObject(Object) |
Notifica o controlo do servidor que um elemento, seja XML ou HTML, foi analisado, e adiciona o elemento ao objeto do ControlCollection controlo do servidor. (Herdado de Control) |
| ApplyStyleSheetSkin(Page) |
Aplica as propriedades de estilo definidas na folha de estilo da página ao controlo. (Herdado de Control) |
| BeginRenderTracing(TextWriter, Object) |
Inicia o rastreio em tempo de design dos dados de renderização. (Herdado de Control) |
| BuildProfileTree(String, Boolean) |
Recolhe informações sobre o controlo do servidor e entrega-as à Trace propriedade para serem exibidas quando o rastreamento for ativado para a página. (Herdado de Control) |
| ClearCachedClientID() |
Define o valor em ClientID cache para |
| ClearChildControlState() |
Apaga a informação de estado de controlo dos controlos filhos do controlo do servidor. (Herdado de Control) |
| ClearChildState() |
Apaga a informação de view-state e control-state de todos os controlos filhos do servidor. (Herdado de Control) |
| ClearChildViewState() |
Elimina a informação de estado de visualização de todos os controlos filhos do controlo do servidor. (Herdado de Control) |
| ClearEffectiveClientIDMode() |
Define a ClientIDMode propriedade da instância de controlo atual e de qualquer controlo filho para Inherit. (Herdado de Control) |
| CreateChildControls() |
Chamada pelo framework de páginas ASP.NET para notificar os controlos de servidor que utilizam implementação baseada em composição para criar quaisquer controlos filhos que contenham em preparação para publicação ou renderização. (Herdado de Repeater) |
| CreateControlCollection() |
Cria um novo ControlCollection objeto para armazenar os controlos filhos (tanto literais como de servidor) do controlo do servidor. (Herdado de Control) |
| CreateControlHierarchy(Boolean) |
Cria uma hierarquia de controlo, com ou sem a fonte de dados especificada. (Herdado de Repeater) |
| CreateDataSourceSelectArguments() |
Devolve o Empty valor. (Herdado de Repeater) |
| CreateItem(Int32, ListItemType) |
Cria um RepeaterItem objeto com o tipo de item especificado e a localização dentro do Repeater controlo. (Herdado de Repeater) |
| DataBind() |
Vincula o FilterRepeater controlo aos dados que são recuperados de uma fonte de dados. |
| DataBind(Boolean) |
Vincula uma fonte de dados ao controlo do servidor invocado e a todos os seus controlos filhos com uma opção para elevar o DataBinding evento. (Herdado de Control) |
| DataBindChildren() |
Vincula uma fonte de dados aos controlos filhos do controlo do servidor. (Herdado de Control) |
| Dispose() |
Permite que o controlo do servidor realize a limpeza final antes de ser libertado da memória. (Herdado de Control) |
| EndRenderTracing(TextWriter, Object) |
Termina o rastreio de tempo de design dos dados de renderização. (Herdado de Control) |
| EnsureChildControls() |
Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos. (Herdado de Control) |
| EnsureDataBound() |
Verifica que o controlo Repeater requer ligação de dados e que um controlo de fonte de dados válido está especificado antes de chamar o DataBind() método. (Herdado de Repeater) |
| EnsureID() |
Cria um identificador para controlos que não têm um identificador atribuído. (Herdado de Control) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FindControl(String, Int32) |
Pesquisa no contentor de nomenclatura atual um controlo de servidor com o especificado |
| FindControl(String) |
Procura no contentor de nomenclatura atual um controlo de servidor com o parâmetro especificado |
| Focus() |
Define o foco de entrada num controlo. (Herdado de Control) |
| GetData() |
Devolve uma IEnumerable interface da fonte de dados. (Herdado de Repeater) |
| GetDesignModeState() |
Obtém dados de tempo de projeto para um controlo. (Herdado de Control) |
| GetFilteredColumns() |
Devolve uma enumeração das colunas ordenáveis que pertencem à tabela associada ao controlo atual FilterRepeater . |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetRouteUrl(Object) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(RouteValueDictionary) |
Obtém a URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control) |
| GetRouteUrl(String, Object) |
Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Obtém o URL que corresponde a um conjunto de parâmetros de rota e a um nome de rota. (Herdado de Control) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| GetUniqueIDRelativeTo(Control) |
Devolve a parte prefixada da UniqueID propriedade do controlo especificado. (Herdado de Control) |
| GetWhereParameters(IDynamicDataSource) |
Obtém a lista de |
| HasControls() |
Determina se o controlo do servidor contém algum controlo filho. (Herdado de Control) |
| HasEvents() |
Devolve um valor que indica se os eventos estão registados para o controlo ou para quaisquer controlos filhos. (Herdado de Control) |
| InitializeItem(RepeaterItem) |
Preenche iterativamente o especificado RepeaterItem com uma sub-hierarquia de controlos filhos. (Herdado de Repeater) |
| IsLiteralContent() |
Determina se o controlo do servidor contém apenas conteúdo literal. (Herdado de Control) |
| LoadControlState(Object) |
Restaura a informação do estado de controlo a partir de um pedido de página anterior que foi guardado pelo SaveControlState() método. (Herdado de Control) |
| LoadViewState(Object) |
Restaura a informação de estado de visualização de um pedido de página anterior que foi guardado usando o SaveViewState() método. (Herdado de Repeater) |
| MapPathSecure(String) |
Recupera o caminho físico para o qual um caminho virtual, seja absoluto ou relativo, mapeia. (Herdado de Control) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| OnBubbleEvent(Object, EventArgs) |
Aumenta o ItemCommand evento se o |
| OnCreatingModelDataSource(CreatingModelDataSourceEventArgs) |
Eleva o CreatingModelDataSource evento. (Herdado de Repeater) |
| OnDataBinding(EventArgs) |
Eleva o |
| OnDataPropertyChanged() |
Determina se a ligação de dados é necessária. (Herdado de Repeater) |
| OnDataSourceViewChanged(Object, EventArgs) |
Define a propriedade RequiresDataBinding como |
| OnFilterItemCreated(RepeaterItem) |
Chamado para cada item e modelo alternado que está a ser instanciado por este FilterRepeater controlo durante a ligação de dados. |
| OnInit(EventArgs) |
Levanta o Init evento para inicializar o FilterRepeater controlo. |
| OnItemCommand(RepeaterCommandEventArgs) |
Eleva o ItemCommand evento. (Herdado de Repeater) |
| OnItemCreated(RepeaterItemEventArgs) |
Eleva o ItemCreated evento. |
| OnItemDataBound(RepeaterItemEventArgs) |
Eleva o ItemDataBound evento. (Herdado de Repeater) |
| OnLoad(EventArgs) |
Aumenta o Load evento e realiza outras inicializações. (Herdado de Repeater) |
| OnPreRender(EventArgs) |
Eleva o PreRender evento. (Herdado de Repeater) |
| OnUnload(EventArgs) |
Eleva o Unload evento. (Herdado de Control) |
| OpenFile(String) |
Recebe um Stream usado para ler um ficheiro. (Herdado de Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Atribui quaisquer fontes do evento e da sua informação ao pai do controlo. (Herdado de Control) |
| RemovedControl(Control) |
Chamado após um controlo filho ser removido da Controls coleção do Control objeto. (Herdado de Control) |
| Render(HtmlTextWriter) |
Envia conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderChildren(HtmlTextWriter) |
Exporta o conteúdo dos filhos de um controlo de servidor para um objeto fornecido HtmlTextWriter , que escreve o conteúdo a ser renderizado no cliente. (Herdado de Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter usando um objeto fornecido ControlAdapter . (Herdado de Control) |
| RenderControl(HtmlTextWriter) |
Fornece conteúdo de controlo do servidor para um objeto fornecido HtmlTextWriter e armazena informação de rastreamento sobre o controlo se o rastreio estiver ativado. (Herdado de Control) |
| ResolveAdapter() |
Faz com que o adaptador de controlo seja responsável por renderizar o controlo especificado. (Herdado de Control) |
| ResolveClientUrl(String) |
Recebe um URL que pode ser usado pelo navegador. (Herdado de Control) |
| ResolveUrl(String) |
Converte uma URL numa que seja utilizável no cliente solicitante. (Herdado de Control) |
| SaveControlState() |
Guarda quaisquer alterações no estado de controlo do servidor que tenham ocorrido desde que a página foi publicada de volta no servidor. (Herdado de Control) |
| SaveViewState() |
Guarda quaisquer alterações no estado de visualização que tenham ocorrido desde que a página foi publicada de volta no servidor. (Herdado de Repeater) |
| SetDesignModeState(IDictionary) |
Define dados em tempo de projeto para um controlo. (Herdado de Control) |
| SetRenderMethodDelegate(RenderMethod) |
Atribui um delegado handler de eventos para renderizar o controlo do servidor e o seu conteúdo no controlo pai. (Herdado de Control) |
| SetTraceData(Object, Object, Object) |
Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando o objeto rastreado, a chave de dados de traço e o valor dos dados de traço. (Herdado de Control) |
| SetTraceData(Object, Object) |
Define os dados de rastreio para o rastreio em tempo de design dos dados de renderização, usando a chave de dados de traço e o valor dos dados de traço. (Herdado de Control) |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
| TrackViewState() |
Provoca o rastreio das alterações de estado de visualização do controlo para que possam ser armazenadas no objeto do StateBag controlo. (Herdado de Repeater) |
evento
| Name | Description |
|---|---|
| CallingDataMethods |
Ocorre quando métodos de dados estão a ser chamados. (Herdado de Repeater) |
| CreatingModelDataSource |
Ocorre quando o ModelDataSource objeto está a ser criado. (Herdado de Repeater) |
| DataBinding |
Ocorre quando o controlo do servidor se liga a uma fonte de dados. (Herdado de Control) |
| Disposed |
Ocorre quando um controlo de servidor é libertado da memória, que é a última etapa do ciclo de vida do controlo do servidor quando uma página ASP.NET é solicitada. (Herdado de Control) |
| Init |
Ocorre quando o controlo do servidor é inicializado, que é o primeiro passo no seu ciclo de vida. (Herdado de Control) |
| ItemCommand |
Ocorre quando um botão é clicado no Repeater controlo. (Herdado de Repeater) |
| ItemCreated |
Ocorre quando um item é criado no Repeater controlo. (Herdado de Repeater) |
| ItemDataBound |
Ocorre depois de um item no Repeater controlo estar vinculado aos dados, mas antes de ser renderizado na página. (Herdado de Repeater) |
| Load |
Ocorre quando o controlo do servidor é carregado no Page objeto. (Herdado de Control) |
| PreRender |
Ocorre depois do carregamento do Control objeto, mas antes da renderização. (Herdado de Control) |
| Unload |
Ocorre quando o controlo do servidor é descarregado da memória. (Herdado de Control) |
Implementações de Interface Explícita
Métodos da Extensão
| Name | Description |
|---|---|
| EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado. |
| EnableDynamicData(INamingContainer, Type, Object) |
Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado. |
| EnableDynamicData(INamingContainer, Type) |
Ativa o comportamento de Dados Dinâmicos para o controlo de dados especificado. |
| FindDataSourceControl(Control) |
Devolve a fonte de dados associada ao controlo de dados para o controlo especificado. |
| FindFieldTemplate(Control, String) |
Devolve o modelo de campo para a coluna especificada no contentor de nomenclatura do controlo especificado. |
| FindMetaTable(Control) |
Devolve o objeto metatable para o controlo de dados que contém. |
| GetDefaultValues(INamingContainer) |
Obtém a recolha dos valores padrão para o controlo de dados especificado. |
| GetMetaTable(INamingContainer) |
Obtém os metadados da tabela para o controlo de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable, Object) |
Define os metadados da tabela e o mapeamento de valores padrão para o controlo de dados especificado. |
| SetMetaTable(INamingContainer, MetaTable) |
Define os metadados da tabela para o controlo de dados especificado. |
| TryGetMetaTable(INamingContainer, MetaTable) |
Determina se os metadados da tabela estão disponíveis. |