Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês
Esta documentação foi arquivada e não está sendo atualizada.

Classe ListControl

Serve como a classe base abstrata que define as propriedades, métodos e eventos comuns a todos os controles do tipo de lista.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (em System.Web.dll)

[ControlValuePropertyAttribute("SelectedValue")]
public abstract class ListControl : DataBoundControl, 
	IEditableTextControl, ITextControl
<asp:ListControl />

O tipo ListControl expõe os membros a seguir.

  NomeDescrição
Método públicoListControlInitializes a new instance of the ListControl class.
Início

  NomeDescrição
Propriedade públicaAccessKey Obtém ou define uma tecla de acesso que permite que você navegue rapidamente para um controle. (Herdado de WebControl.)
Propriedade protegidaAdapter Obtém as especificações do navegador para o controle. (Herdado de Control.)
Propriedade públicaAppendDataBoundItemsObtém ou define um valor que indica se os itens de lista são limpas antes de ligação de dados.
Propriedade públicaAppRelativeTemplateSourceDirectoryObtém ou define o diretório virtual do aplicativo relativa da Page ou UserControl objeto que contém este controle. (Herdado de Control.)
Propriedade públicaAttributesObtém a coleção de atributos arbitrários (para processar apenas) que não correspondem às propriedades no controle. (Herdado de WebControl.)
Propriedade públicaAutoPostBackObtém ou define um valor indicando se um postback para o servidor ocorre automaticamente quando o usuário altera a seleção da lista.
Propriedade públicaBackColor Obtém ou define a cor do plano de fundo do controle. (Herdado de WebControl.)
Propriedade públicaBindingContainerInfraestrutura. Obtém o controle de vinculação de dados do controle. (Herdado de Control.)
Propriedade públicaBorderColor Obtém ou define a cor da borda do controle. (Herdado de WebControl.)
Propriedade públicaBorderStyle Obtém ou define o estilo de borda do controle. (Herdado de WebControl.)
Propriedade públicaBorderWidth Obtém ou define a largura da borda do controle. (Herdado de WebControl.)
Propriedade públicaCausesValidationObtém ou define um valor indicando se a validação é executada quando um controle que é derivado de ListControl classe for clicado.
Propriedade protegidaChildControlsCreatedObtém um valor que indica se os controles de filho do controle de servidor tem sido criados. (Herdado de Control.)
Propriedade públicaClientID Obtém o identificador do controle gerado pelo ASP.NET. (Herdado de Control.)
Propriedade públicaClientIDMode Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID. (Herdado de Control.)
Propriedade protegidaClientIDSeparatorObtém um valor de caracteres que representa o caractere separador usado na ClientID propriedade. (Herdado de Control.)
Propriedade protegidaContextObtém o HttpContext objeto associado com o controle de servidor para a solicitação da Web atual. (Herdado de Control.)
Propriedade públicaControlsObtém um ControlCollection objeto que representa os controles filho de um controle de servidor especificado na hierarquia de interface do usuário. (Herdado de Control.)
Propriedade públicaControlStyleObtém o estilo de controle de servidor Web. Esta propriedade é usada principalmente pelos desenvolvedores de controle. (Herdado de WebControl.)
Propriedade públicaControlStyleCreatedObtém um valor indicando se um Style objeto foi criado para o ControlStyle propriedade. Esta propriedade é usada principalmente pelos desenvolvedores de controle. (Herdado de WebControl.)
Propriedade públicaCssClassObtém ou define a classe de folha de estilos em cascata (CSS) processada pelo controle de servidor Web no cliente. (Herdado de WebControl.)
Propriedade públicaDataItemContainerObtém uma referência para o contêiner de nomeação, se o contêiner de nomeação implementa IDataItemContainer. (Herdado de Control.)
Propriedade públicaDataKeysContainerObtém uma referência para o contêiner de nomeação, se o contêiner de nomeação implementa IDataKeysControl. (Herdado de Control.)
Propriedade públicaDataMemberObtém ou define o nome da lista de dados que vincula o controle vinculado a dados, em casos onde a fonte de dados contém mais de uma lista distinta de itens de dados. (Herdado de DataBoundControl.)
Propriedade públicaDataSourceObtém ou define o objeto do qual o controle vinculado a dados recupera sua lista de itens de dados. (Herdado de BaseDataBoundControl.)
Propriedade públicaDataSourceIDObtém ou define a identificação do controle do qual o controle vinculado a dados recupera sua lista de itens de dados. (Herdado de DataBoundControl.)
Propriedade públicaDataSourceObjectObtém um objeto que implementa o IDataSource interface, que fornece acesso a conteúdo de dados. do objeto (Herdado de DataBoundControl.)
Propriedade públicaDataTextFieldObtém ou define o campo da fonte de dados que fornece o conteúdo de texto dos itens da lista.
Propriedade públicaDataTextFormatStringObtém ou define a seqüência de formatação usada para controlar como os dados ligados ao controle de lista são exibidos.
Propriedade públicaDataValueFieldObtém ou define o campo da fonte de dados que fornece o valor de cada item da lista.
Propriedade protegidaDesignModeObtém um valor indicando se um controle está sendo usado em uma superfície de design. (Herdado de Control.)
Propriedade públicaEnabledObtém ou define um valor indicando se o controle de servidor Web está ativado. (Herdado de WebControl.)
Propriedade públicaEnableThemingObtém ou define um valor indicando se os temas se aplicam a este controle. (Herdado de WebControl.)
Propriedade públicaEnableViewStateObtém ou define um valor indicando se o controle servidor persiste o estado de exibição e o estado de exibição de quaisquer controles filho que contém, para o cliente solicitante. (Herdado de Control.)
Propriedade protegidaEventsObtém uma lista de representantes de manipulador de eventos para o controle. Esta propriedade é somente leitura. (Herdado de Control.)
Propriedade públicaFontObtém as propriedades de fonte associadas com o controle de servidor Web. (Herdado de WebControl.)
Propriedade públicaForeColorObtém ou define a cor de primeiro plano (geralmente a cor do texto) de controle de servidor Web. (Herdado de WebControl.)
Propriedade públicaHasAttributesObtém um valor indicando se o controle tem atributos definidos. (Herdado de WebControl.)
Propriedade protegidaHasChildViewStateObtém um valor indicando se os atuais controles filhos do controle do servidor têm quaisquer configurações do estado de visualização salvas. (Herdado de Control.)
Propriedade públicaHeightObtém ou define a altura do controle de servidor Web. (Herdado de WebControl.)
Propriedade públicaIDObtém ou define o identificador programático atribuído ao controle de servidor. (Herdado de Control.)
Propriedade protegidaIdSeparatorInfraestrutura. Obtém o caractere usado para separar os identificadores de controle. (Herdado de Control.)
Propriedade protegidaInitializedObtém um valor indicando se o controle vinculado a dados foi inicializado. (Herdado de BaseDataBoundControl.)
Propriedade protegidaIsBoundUsingDataSourceIDObtém um valor indicando se o DataSourceID propriedade é definido. (Herdado de BaseDataBoundControl.)
Propriedade protegidaIsChildControlStateClearedObtém um valor que indica se os controles contidos dentro deste controle têm estado de controle. (Herdado de Control.)
Propriedade protegidaIsEnabledObtém um valor indicando se o controle está habilitado. (Herdado de WebControl.)
Propriedade protegidaIsTrackingViewStateObtém um valor que indica se o controle de servidor está salvando as alterações em seu estado de exibição. (Herdado de Control.)
Propriedade protegidaIsViewStateEnabledObtém um valor indicando se o estado de exibição está ativado para esse controle. (Herdado de Control.)
Propriedade públicaItemsObtém a coleção de itens no controle de lista.
Propriedade protegidaLoadViewStateByIDObtém um valor indicando se o controle participa carregar seu estado de exibição por ID em vez do índice. (Herdado de Control.)
Propriedade públicaNamingContainerObtém uma referência ao controle de servidor do contêiner de nomeação, que cria um namespace exclusivo para diferenciar entre controles de servidor com o mesmo Control.ID valor da propriedade. (Herdado de Control.)
Propriedade públicaPageObtém uma referência a Page instância que contém o controle de servidor. (Herdado de Control.)
Propriedade públicaParentObtém uma referência ao controle do pai do controle de servidor na hierarquia de controle da página. (Herdado de Control.)
Propriedade públicaRenderingCompatibilityObtém um valor que especifica o ASP.NET versão processado HTML será compatível com. (Herdado de Control.)
Propriedade protegidaRequiresDataBindingObtém ou define um valor indicando se a DataBind método deve ser chamado. (Herdado de BaseDataBoundControl.)
Propriedade protegidaSelectArgumentsObtém um DataSourceSelectArguments o objeto que o controle vinculado a dados usa ao recuperar dados de um controle de fonte de dados. (Herdado de DataBoundControl.)
Propriedade públicaSelectedIndexObtém ou define o índice ordinal menor dos itens selecionados na lista.
Propriedade públicaSelectedItemObtém o item selecionado com o índice mais baixo no controle de lista.
Propriedade públicaSelectedValueObtém o valor do item selecionado no controle de lista ou seleciona o item no controle de lista que contém o valor especificado.
Propriedade públicaSiteObtém informações sobre o recipiente que contém o controle atual quando processado em uma superfície de design. (Herdado de Control.)
Propriedade públicaSkinIDObtém ou define a capa para aplicar ao controle. (Herdado de WebControl.)
Propriedade públicaStyleObtém uma coleção de atributos de texto que será processado como um atributo de estilo na marca externa do controle de servidor Web. (Herdado de WebControl.)
Propriedade públicaSupportsDisabledAttributeObtém um valor que indica se o controle deve definir o disabled o atributo do elemento HTML renderizado para "desativado" Quando o controle IsEnabled é a propriedade false. (Herdado de BaseDataBoundControl.)
Propriedade públicaTabIndexObtém ou define o índice de tabulação do controle de servidor Web. (Herdado de WebControl.)
Propriedade protegidaTagKeyObtém o HtmlTextWriterTag valor para o ListControl de controle. (Substitui WebControl.TagKey.)
Propriedade protegidaTagNameObtém o nome da marca do controle. Esta propriedade é usada principalmente pelos desenvolvedores de controle. (Herdado de WebControl.)
Propriedade públicaTemplateControlObtém ou define uma referência ao modelo que contém este controle. (Herdado de Control.)
Propriedade públicaTemplateSourceDirectoryObtém o diretório virtual da Page ou UserControl que contém o controle de servidor atual. (Herdado de Control.)
Propriedade públicaTextObtém ou define o SelectedValue propriedade da ListControl de controle.
Propriedade públicaToolTipObtém ou define o texto exibido quando o ponteiro do mouse focaliza o controle de servidor Web. (Herdado de WebControl.)
Propriedade públicaUniqueIDObtém o identificador exclusivo, hierarquicamente qualificado para o controle de servidor. (Herdado de Control.)
Propriedade públicaValidationGroupObtém ou define o grupo de controles para o qual o controle que é derivado de ListControl classe faz com que a validação quando ele envia de volta para o servidor.
Propriedade protegidaViewState Obtém um dicionário de informações de estado que permite você salvar e restaurar o estado de exibição de um controle de servidor nas várias solicitações para a mesma página. (Herdado de Control.)
Propriedade protegidaViewStateIgnoresCase Obtém um valor que indica se o objeto StateBag distingue maiúsculas e minúsculas. (Herdado de Control.)
Propriedade públicaViewStateModeObtém ou define o modo de estado de exibição deste controle. (Herdado de Control.)
Propriedade públicaVisibleObtém ou define um valor que indica se um controle de servidor é processado como a interface do usuário na página. (Herdado de Control.)
Propriedade públicaWidthObtém ou define a largura do controle de servidor Web. (Herdado de WebControl.)
Início

  NomeDescrição
Método protegidoAddAttributesToRenderAplica os atributos HTML e estilos para processar a especificado HtmlTextWriter objeto. (Substitui WebControl.AddAttributesToRender(HtmlTextWriter).)
Método protegidoAddedControlChamado depois que um controle filho é adicionado à Controls coleção do objeto Control. (Herdado de Control.)
Método protegidoAddParsedSubObjectNotifica o controle do servidor que um elemento XML ou HTML, foi analisado e adiciona o elemento para a coleção de objetos  ControlCollection do servidor. (Herdado de Control.)
Método públicoApplyStyleCopia quaisquer elementos não vazios do estilo especificado para o controle da Web, substituindo quaisquer elementos de estilo existente do controle. Este método é usado principalmente pelos desenvolvedores de controle. (Herdado de WebControl.)
Método públicoApplyStyleSheetSkinAplica as propriedades de estilo definidas na folha de estilo da página para o controle. (Herdado de Control.)
Método protegidoBuildProfileTreeInfraestrutura. Reúne informações sobre o controle de servidor e o entrega para o Trace a propriedade a ser exibida quando o rastreamento está habilitado para a página. (Herdado de Control.)
Método protegidoClearCachedClientIDInfraestrutura. Define o cache ClientID o valor para null. (Herdado de Control.)
Método protegidoClearChildControlStateExclui as informações de estado do controle para controles de filho do controle de servidor. (Herdado de Control.)
Método protegidoClearChildStateExclui as informações de estado de exibição e estado do controle para controles filho de todo o controle do servidor. (Herdado de Control.)
Método protegidoClearChildViewStateExclui as informações de estado de exibição para controles filho de todo o controle do servidor. (Herdado de Control.)
Método protegidoClearEffectiveClientIDModeInfraestrutura. Conjuntos de ClientIDMode propriedade da instância atual do controle e de quaisquer controles filho a Inherit. (Herdado de Control.)
Método públicoClearSelectionRetira a seleção da lista e define o Selected a propriedade de todos os itens para false.
Método protegidoConfirmInitStateDefine o estado inicializado do controle ligado a dados. (Herdado de BaseDataBoundControl.)
Método públicoCopyBaseAttributesCopia as propriedades não são encapsuladas pela Style o objeto do controle do servidor Web especificado para o controle de servidor Web que este método é chamado de. Este método é usado principalmente pelos desenvolvedores de controle. (Herdado de WebControl.)
Método protegidoCreateChildControls Chamado pela estrutura da página ASP.NET para notificar os controles de servidor que usam implementação baseada em composição para criar os controles filho que eles contêm em preparação para postagem ou processamento. (Herdado de Control.)
Método protegidoCreateControlCollectionCria um novo objeto ControlCollection para armazenar os controles filhos (ambos literal e servidor) do controle do servidor. (Herdado de Control.)
Método protegidoCreateControlStyleCria o objeto de estilo é usado internamente pelo WebControl relacionados a classe para implementar o estilo de todas as propriedades. Este método é usado principalmente pelos desenvolvedores de controle. (Herdado de WebControl.)
Método protegidoCreateDataSourceSelectArgumentsCria um padrão de DataSourceSelectArguments objeto usado pelo controle ligado a dados se nenhum argumento for especificado. (Herdado de DataBoundControl.)
Método públicoDataBind()Vincula uma fonte de dados para o controle de chamada de servidor e todos os seus controles filho. (Herdado de BaseDataBoundControl.)
Método protegidoDataBind(Boolean)Vincula uma fonte de dados para o controle de chamada de servidor e todos os seus controles filho com uma opção para aumentar a DataBinding de evento. (Herdado de Control.)
Método protegidoDataBindChildrenVincula uma fonte de dados a controles de filho do controle de servidor. (Herdado de Control.)
Método públicoDisposePermite que um controle de servidor executar o final de limpeza antes que ele é liberado da memória. (Herdado de Control.)
Método protegidoEnsureChildControlsDetermina se o controle de servidor contém controles filho. Se não existir, ele criará filho controles. (Herdado de Control.)
Método protegidoEnsureDataBoundChamadas de DataBind método se o DataSourceID propriedade é definida e o controle vinculado a dados está marcado para requerem ligação. (Herdado de BaseDataBoundControl.)
Método protegidoEnsureIDCria um identificador para controles que não têm um identificador atribuído. (Herdado de Control.)
Método públicoEquals(Object) Determina se o Object especificado é igual ao Object atual. (Herdado de Object.)
Método protegidoFinalize Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)
Método públicoFindControl(String)Procura no controle atual por um controle filho com o id informado. (Herdado de Control.)
Método protegidoFindControl(String, Int32)Infraestrutura. Procura o contêiner de nomeação atual para um controle de servidor com o especificado id e um inteiro, especificado na pathOffset parâmetro, que auxilia na pesquisa. Não, você deve substituir esta versão do FindControl método. (Herdado de Control.)
Método públicoFocusDefine o foco para um controle de entrada. (Herdado de Control.)
Método protegidoGetDataRecupera um DataSourceView o objeto que o controle vinculado a dados usa para executar operações de dados. (Herdado de DataBoundControl.)
Método protegidoGetDataSourceRecupera o IDataSource interface que o controle vinculado a dados está associado, se houver. (Herdado de DataBoundControl.)
Método protegidoGetDesignModeStateInfraestrutura. Obtém os dados de tempo de design para um controle. (Herdado de Control.)
Método públicoGetHashCodeServe como uma função hash para um tipo específico. (Herdado de Object.)
Método públicoGetRouteUrl(Object)Obtém o URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control.)
Método públicoGetRouteUrl(RouteValueDictionary)Obtém o URL que corresponde a um conjunto de parâmetros de rota. (Herdado de Control.)
Método públicoGetRouteUrl(String, Object)Obtém o URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control.)
Método públicoGetRouteUrl(String, RouteValueDictionary)Obtém o URL que corresponde a um conjunto de parâmetros de rota e um nome de rota. (Herdado de Control.)
Método públicoGetType Obtém o Type da instância atual. (Herdado de Object.)
Método públicoGetUniqueIDRelativeToRetorna a parte prefixada a UniqueID a propriedade do controle especificado. (Herdado de Control.)
Método públicoHasControlsDetermina se o controle de servidor contém os controles filho. (Herdado de Control.)
Método protegidoHasEventsRetorna um valor que indica se os eventos são registrados para o controle ou os controles filho. (Herdado de Control.)
Método protegidoIsLiteralContentInfraestrutura. Determina se o controle de servidor contém apenas conteúdo literal. (Herdado de Control.)
Método protegidoLoadControlStateRestaura informações de estado do controle de uma solicitação de página anterior que foi salvo pelo SaveControlState método. (Herdado de Control.)
Método protegidoLoadViewStateCarrega o estado de exibição salvo anteriormente da DetailsView de controle. (Substitui WebControl.LoadViewState(Object).)
Método protegidoMapPathSecureRecupera o caminho físico que mapeia um caminho virtual absoluto ou relativo. (Herdado de Control.)
Método protegidoMarkAsDataBoundDefine o estado do controle no estado da exibição como com êxito é acoplado a dados. (Herdado de DataBoundControl.)
Método protegidoMemberwiseCloneCria uma cópia superficial do Object atual. (Herdado de Object.)
Método públicoMergeStyleCopia quaisquer elementos não vazios do estilo especificado na Web, controlam, mas não substituirá quaisquer elementos de estilo existente do controle. Este método é usado principalmente pelos desenvolvedores de controle. (Herdado de WebControl.)
Método protegidoOnBubbleEventDetermina se o evento para o controle de servidor é passado hierarquia de controle de servidor de interface do usuário da página. (Herdado de Control.)
Método protegidoOnDataBindingInfraestrutura. Gera o evento DataBinding. (Substitui Control.OnDataBinding(EventArgs).)
Método protegidoOnDataBoundRaises the DataBound event. (Herdado de BaseDataBoundControl.)
Método protegidoOnDataPropertyChangedReliga o controle ligado a dados para seus dados depois que um dos dados básicos alterações de propriedades de identificação de origem. (Herdado de DataBoundControl.)
Método protegidoOnDataSourceViewChangedRaises the DataSourceViewChanged event. (Herdado de DataBoundControl.)
Método protegidoOnInitManipula o Init de evento. (Herdado de BaseDataBoundControl.)
Método protegidoOnLoadManipula o Control.Load de evento. (Herdado de DataBoundControl.)
Método protegidoOnPagePreLoadDefine o estado inicializado do controle ligado a dados, antes do controle for carregado. (Herdado de DataBoundControl.)
Método protegidoOnPreRender Gera o evento PreRender. (Substitui BaseDataBoundControl.OnPreRender(EventArgs).)
Método protegidoOnSelectedIndexChangedRaises the SelectedIndexChanged event. Isso permite que você forneça um manipulador personalizado para o evento.
Método protegidoOnTextChangedRaises the TextChanged event.
Método protegidoOnUnload Gera o evento Unload. (Herdado de Control.)
Método protegidoOpenFileObtém um Stream usado para ler um arquivo. (Herdado de Control.)
Método protegidoPerformDataBindingInfraestrutura. Vincula a fonte de dados especificada para o controle que é derivado de ListControl classe. (Substitui DataBoundControl.PerformDataBinding(IEnumerable).)
Método protegidoPerformSelectRecupera dados da fonte de dados associado. (Substitui DataBoundControl.PerformSelect().)
Método protegidoRaiseBubbleEventAtribui quaisquer fontes de evento e suas informações para o pai do controle. (Herdado de Control.)
Método protegidoRemovedControlChamado depois que um controle filho é removido o Controls coleção da Control objeto. (Herdado de Control.)
Método protegidoRenderProcessa o controle para o gravador HTML especificado. (Herdado de WebControl.)
Método públicoRenderBeginTagProcessa o HTML abrindo a marca do controle para o gravador especificado. Este método é usado principalmente pelos desenvolvedores de controle. (Herdado de WebControl.)
Método protegidoRenderChildrenSaídas o conteúdo de filhos de um controle de servidor para um fornecido HtmlTextWriter o objeto, que grava o conteúdo a ser processado no cliente. (Herdado de Control.)
Método protegidoRenderContentsProcessa os itens do ListControl de controle. (Substitui WebControl.RenderContents(HtmlTextWriter).)
Método públicoRenderControl(HtmlTextWriter)Saídas conteúdo de controle do servidor para um fornecido HtmlTextWriter de objeto e armazena informações de rastreamento sobre o controle se rastreamento estiver ativado. (Herdado de Control.)
Método protegidoRenderControl(HtmlTextWriter, ControlAdapter)Saídas conteúdo de controle do servidor para um fornecido HtmlTextWriter um fornecido usando o objeto ControlAdapter objeto. (Herdado de Control.)
Método públicoRenderEndTagProcessa o HTML fechar marca do controle para o gravador especificado. Este método é usado principalmente pelos desenvolvedores de controle. (Herdado de WebControl.)
Método protegidoResolveAdapterObtém o adaptador de controle responsável por processar o controle especificado. (Herdado de Control.)
Método públicoResolveClientUrlObtém uma URL que pode ser usada pelo navegador. (Herdado de Control.)
Método públicoResolveUrlConverte uma URL que seja utilizável no cliente solicitante. (Herdado de Control.)
Método protegidoSaveControlStateSalva as alterações de estado que ocorreram desde o momento em que a página foi postada de volta para o servidor de qualquer controle de servidor. (Herdado de Control.)
Método protegidoSaveViewStateSalva o estado de exibição atual da ListControl -derivado de controle e os itens que ele contém. (Substitui WebControl.SaveViewState().)
Método protegidoSetDesignModeStateDefine os dados em tempo de design para um controle. (Herdado de Control.)
Método protegidoSetPostDataSelectionInfraestrutura. Conjuntos de Selected propriedade de um ListItem controlar depois que uma página é postada.
Método públicoSetRenderMethodDelegateInfraestrutura. Atribui um delegado manipulador de eventos para processar o controle de servidor e seu conteúdo em um controle pai. (Herdado de Control.)
Método públicoToStringRetorna uma string que representa o objeto atual. (Herdado de Object.)
Método protegidoTrackViewStateMarca o ponto de partida para iniciar o rastreamento e salvando as alterações de estado de exibição para um ListControl -derivado de controle. (Substitui WebControl.TrackViewState().)
Método protegidoValidateDataSourceVerifica se o objeto que vincula um controle vinculado a dados é um pode funcionar com. (Herdado de DataBoundControl.)
Método protegidoVerifyMultiSelectInfraestrutura. Determina se o controle de lista suporta o modo de seleção múltipla.
Início

  NomeDescrição
Evento públicoDataBindingOcorre quando o server control vincula a uma fonte de dados. (Herdado de Control.)
Evento públicoDataBoundOcorre após o controle de servidor vincula a uma fonte de dados. (Herdado de BaseDataBoundControl.)
Evento públicoDisposedOcorre quando um server control é liberado da memória, que é a última etapa do ciclo de vida do server contorl quando uma página ASP.NET é solicitada. (Herdado de Control.)
Evento públicoInitOcorre quando o server control é inicializado, que é o primeiro passo em seu ciclo de vida. (Herdado de Control.)
Evento públicoLoad

Ocorre quando o controle de servidor é carregado no objeto Page.

(Herdado de Control.)
Evento públicoPreRenderOcorre após o objeto Control ser carregado, mas antes da sua renderização. (Herdado de Control.)
Evento públicoSelectedIndexChangedOcorre quando a seleção do controle da lista é alterado entre postagens para o servidor.
Evento públicoTextChangedOcorre quando o Text e SelectedValue alteração de propriedades.
Evento públicoUnloadOcorre quando o server control é descarregado da memória. (Herdado de Control.)
Início

  NomeDescrição
Método de extensão públicoEnablePersistedSelectionPermite a seleção a ser mantido em controles de dados que oferecem suporte a seleção e paginação. (Definido por DynamicDataExtensions.)
Método de extensão públicoFindDataSourceControlRetorna a fonte de dados que está associada com o controle de dados para o controle especificado. (Definido por DynamicDataExtensions.)
Método de extensão públicoFindFieldTemplateRetorna que o modelo de campo da coluna especificada no controle especificado do contêiner de nomeação. (Definido por DynamicDataExtensions.)
Método de extensão públicoFindMetaTableRetorna o objeto metatable contendo o controle de dados. (Definido por DynamicDataExtensions.)
Início

  NomeDescrição
Implementação explícita da interfaceMétodo particularIAttributeAccessor.GetAttributeInfraestrutura. Obtém um atributo do controle da Web com o nome especificado. (Herdado de WebControl.)
Implementação explícita da interfaceMétodo particularIAttributeAccessor.SetAttributeDefine um atributo do controle da Web para o nome especificado e o valor. (Herdado de WebControl.)
Implementação explícita da interfacePropriedade particularIControlBuilderAccessor.ControlBuilderPara obter uma descrição desse membro, consulte IControlBuilderAccessor.ControlBuilder. (Herdado de Control.)
Implementação explícita da interfaceMétodo particularIControlDesignerAccessor.GetDesignModeStatePara obter uma descrição desse membro, consulte IControlDesignerAccessor.GetDesignModeState. (Herdado de Control.)
Implementação explícita da interfaceMétodo particularIControlDesignerAccessor.SetDesignModeStatePara obter uma descrição desse membro, consulte IControlDesignerAccessor.SetDesignModeState. (Herdado de Control.)
Implementação explícita da interfaceMétodo particularIControlDesignerAccessor.SetOwnerControlInfraestrutura. Para obter uma descrição desse membro, consulte IControlDesignerAccessor.SetOwnerControl. (Herdado de Control.)
Implementação explícita da interfacePropriedade particularIControlDesignerAccessor.UserDataPara obter uma descrição desse membro, consulte IControlDesignerAccessor.UserData. (Herdado de Control.)
Implementação explícita da interfacePropriedade particularIDataBindingsAccessor.DataBindingsPara obter uma descrição desse membro, consulte IDataBindingsAccessor.DataBindings. (Herdado de Control.)
Implementação explícita da interfacePropriedade particularIDataBindingsAccessor.HasDataBindingsPara obter uma descrição desse membro, consulte IDataBindingsAccessor.HasDataBindings. (Herdado de Control.)
Implementação explícita da interfacePropriedade particularIExpressionsAccessor.ExpressionsPara obter uma descrição desse membro, consulte IExpressionsAccessor.Expressions. (Herdado de Control.)
Implementação explícita da interfacePropriedade particularIExpressionsAccessor.HasExpressionsPara obter uma descrição desse membro, consulte IExpressionsAccessor.HasExpressions. (Herdado de Control.)
Implementação explícita da interfaceMétodo particularIParserAccessor.AddParsedSubObjectPara obter uma descrição desse membro, consulte IParserAccessor.AddParsedSubObject. (Herdado de Control.)
Início

Uma instância de ListControl classe abstrata não pode ser criado diretamente. Em vez disso, essa classe é herdada por outras classes, como o CheckBoxList, DropDownList, ListBox, e RadioButtonList classes, para fornecer funcionalidade básica comum.

As propriedades de ListControl classe permitem que você especifique a origem dos dados para preencher a lista de controle. Use o DataSource propriedade para especificar a fonte de dados para vincular a lista de controle. Se a fonte de dados contiver mais de uma tabela, use o DataMember propriedade para especificar a tabela a usar. Você pode vincular campos diferentes na fonte de dados para o ListItem.Text e ListItem.Value Propriedades dos itens no controle de lista, definindo a DataTextField e DataValueField Propriedades, respectivamente. O texto exibido para cada item no controle de lista pode por formatado, definindo a DataTextFormatString propriedade.

Todos os itens exibidos no controle de lista são armazenados na Items coleção. Programaticamente, você pode especificar ou determinar o índice de um item selecionado no controle de lista usando o SelectedIndex propriedade. As propriedades do item selecionado podem ser acessadas usando o SelectedItem propriedade.

O ListControl classe fornece o SelectedIndexChanged o evento, que é disparado quando a seleção de alterações de controle lista entre postagens para o servidor. Isso permite que você fornecer um manipulador personalizado para este evento. Para obter mais informações sobre tratamento de eventos, consulte Consumindo Eventos.

O ListControl classe implementa o IEditableTextControl interface para controles de lista tipo derivado pode ser usada no modo de modelo de outros controles.

O exemplo de código a seguir demonstra como selecionar itens em um ListBox de controle. Se o item for encontrado na caixa de texto, o item é selecionado e uma mensagem é exibida informando o nome do item selecionado. Se o item não for encontrado, nenhum item esteja selecionado e será exibida uma mensagem informando que o item não foi encontrado.

Observação de segurançaObservação sobre segurança

Este exemplo tem uma caixa de texto que aceita entrada do usuário, que é uma ameaça potencial de segurança. Por padrão, páginas Web ASP.NET validam se as entradas de usuário não incluem scripts ou elementos HTML. Para mais informações, consulte Visão Geral de Scripts Maliciosos.



<%@ Page Language="C#" AutoEventWireup="True" %>

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

<head runat="server">
    <title> ListControl SelectedValue Example </title>
<script runat="server">

      void Button_Click(Object sender, EventArgs e)
      {

         // Perform this operation in a try-catch block in case the item is not found.
         try
         {
            List.SelectedValue = ItemTextBox.Text;
            MessageLabel.Text = "You selected " + List.SelectedValue + ".";
         }
         catch (Exception ex)
         {
            List.SelectedValue = null;
            MessageLabel.Text = "Item not found in ListBox control.";
         }

      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3> ListControl SelectedValue Example </h3>

      <asp:ListBox ID="List"
           runat="server">

         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>

      </asp:ListBox>

      <hr />

      Enter the value of the item to select: <br />
      <asp:TextBox ID="ItemTextBox"
           MaxLength="6"
           Text="Item 1"
           runat="server"/>

      &nbsp;&nbsp;

      <asp:Button ID="SelectButton"
           Text="Select Item"
           OnClick="Button_Click"
           runat="server"/>

      <br /><br />

      <asp:Label ID="MessageLabel"
           runat="server"/>     

   </form>

</body>
</html>


.NET Framework

Com suporte em: 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 ou posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core não compatível), Windows Server 2008 R2 (Server Core não compatível com SP1 ou posterior), Windows Server 2003 SP2

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos de sistema do .NET Framework.

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.
Mostrar: