Поделиться через


Заполнение списка с помощью CascadingDropDown (VB)

Кристиан Венц (Christian Wenz)

Загрузить PDF-файл

Элемент управления CascadingDropDown в наборе элементов управления AJAX расширяет элемент управления DropDownList, чтобы изменения в одном DropDownList загружали связанные значения в другой DropDownList. (Например, один список содержит список штатов США, а следующий список заполняется крупными городами в этом штате.) Первой задачей является заполнение раскрывающегося списка с помощью этого элемента управления.

Общие сведения

Элемент управления CascadingDropDown в наборе элементов управления AJAX расширяет элемент управления DropDownList, чтобы изменения в одном DropDownList загружали связанные значения в другой DropDownList. (Например, один список содержит список штатов США, а следующий список заполняется крупными городами в этом штате.) Первой задачей является заполнение раскрывающегося списка с помощью этого элемента управления.

Этапы

Чтобы активировать функциональные возможности ASP.NET AJAX и набора средств управления, ScriptManager элемент управления должен находиться в любом месте страницы (но в элементе <form> ).

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

Затем требуется элемент управления DropDownList:

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

Для этого списка добавляется расширитель CascadingDropDown. Он отправляет асинхронный запрос веб-службе, которая затем возвращает список записей, отображаемых в списке. Для этого необходимо задать следующие атрибуты CascadingDropDown:

  • ServicePath: URL-адрес веб-службы, доставляющего записи списка.
  • ServiceMethod: веб-метод доставки записей списка
  • TargetControlID: идентификатор раскрывающегося списка.
  • Category: сведения о категории, которые передаются в веб-метод при вызове.
  • PromptText: текст отображается при асинхронной загрузке данных списка с сервера.

Ниже приведена разметка CascadingDropDown для элемента . Единственное различие между C# и VB заключается в имени связанной веб-службы:

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

Код JavaScript, поступающий CascadingDropDown из расширителя, вызывает метод веб-службы со следующей сигнатурой:

Public Function MethodNameHere(ByVal knownCategoryValues As String, ByVal category As String) As CascadingDropDownNameValue()

Поэтому важным аспектом является то, что метод должен возвращать массив типа CascadingDropDownNameValue (определенный набором средств управления ASP.NET AJAX). В конструкторе CascadingDropDownNameValue необходимо сначала указать текст элемента списка, а затем его значение, как <option value="VALUE">NAME</option> это делается в HTML. Ниже приведены некоторые примеры данных:

<%@ WebService Language="VB" Class="CascadingDropDown0" %>
Imports System.Web.Script.Services
Imports AjaxControlToolkit
Imports System.Web
Imports System.Web.Services
Imports System.Web.Services.Protocols
Imports System.Collections.Generic
<ScriptService()> _
Public Class CascadingDropDown0
 Inherits System.Web.Services.WebService
 <WebMethod()> _
 Public Function GetVendors(ByVal knownCategoryValues As String, ByVal category As String) As CascadingDropDownNameValue()
 Dim l As New List(Of CascadingDropDownNameValue)
 l.Add(New CascadingDropDownNameValue("International", "1"))
 l.Add(New CascadingDropDownNameValue("Electronic Bike Repairs & Supplies","2"))
 l.Add(New CascadingDropDownNameValue("Premier Sport, Inc.", "3"))
 Return l.ToArray()
 End Function
End Class

Загрузка страницы в браузере приведет к заполнению списка тремя поставщиками.

Список заполняется автоматически

Список заполняется автоматически (щелкните для просмотра полноразмерного изображения)