Predefinição de entradas de lista com CascadingDropDown (C#)

por Christian Wenz

Baixar PDF

O controle CascadingDropDown no Kit de Ferramentas de Controle AJAX estende um controle DropDownList para que as alterações em um DropDownList carreguem valores associados em outro DropDownList. Com um pouco de código, é possível que um elemento de lista seja pré-selecionado depois que os dados forem carregados dinamicamente.

Visão geral

O controle CascadingDropDown no Kit de Ferramentas de Controle AJAX estende um controle DropDownList para que as alterações em um DropDownList carreguem valores associados em outro DropDownList. (Por exemplo, uma lista fornece uma lista de estados dos EUA e a próxima lista é preenchida com as principais cidades desse estado.) Com um pouco de código, é possível que um elemento de lista seja pré-selecionado depois que os dados forem carregados dinamicamente.

Etapas

Para ativar a funcionalidade de ASP.NET AJAX e o Kit de Ferramentas de Controle, o ScriptManager controle deve ser colocado em qualquer lugar na página (mas dentro do <form> elemento):

<asp:ScriptManager ID="asm" runat="server" />

Em seguida, um controle DropDownList é necessário:

<div>
 Vendor: <asp:DropDownList ID="VendorsList" runat="server"/>
</div>

Para esta lista, um extensor CascadingDropDown é adicionado, fornecendo a URL do serviço Web e informações de método:

<ajaxToolkit:CascadingDropDown ID="ccd1" runat="server"
 ServicePath="CascadingDropdown2.cs.asmx" ServiceMethod="GetVendors"
 TargetControlID="VendorsList" Category="Vendor" />

O extensor CascadingDropDown chama de forma assíncrona um serviço Web com a seguinte assinatura de método:

public CascadingDropDownNameValue[] MethodNameHere(string knownCategoryValues, string category)

O método retorna uma matriz do tipo Valor CascadingDropDown. O construtor do tipo espera primeiro o legenda da entrada de lista e, em seguida, o valor (atributo HTMLvalue). Se o terceiro argumento for definido como true, o elemento list será selecionado automaticamente no navegador.

<%@ WebService Language="C#" Class="CascadingDropdown2" %>
using System.Web.Script.Services;
using AjaxControlToolkit;
using System;
using System.Web;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Collections.Generic;
[ScriptService]
public class CascadingDropdown2 : System.Web.Services.WebService
{
 [WebMethod]
 public CascadingDropDownNameValue[] GetVendors(string knownCategoryValues, string
 category)
 {
 List<CascadingDropDownNameValue> l = new List<CascadingDropDownNameValue>();
 l.Add(new CascadingDropDownNameValue(
 "International", "1"));
 l.Add(new CascadingDropDownNameValue(
 "Electronic Bike Repairs & Supplies", "2", true));
 l.Add(new CascadingDropDownNameValue(
 "Premier Sport, Inc.", "3"));
 return l.ToArray();
 }
}

Carregar a página no navegador preencherá a lista suspensa com três fornecedores, sendo o segundo pré-selecionado.

A lista é preenchida e pré-selecionada automaticamente

A lista é preenchida e pré-selecionada automaticamente (Clique para exibir a imagem em tamanho real)