Использование DynamicPopulate с пользовательским элементом управления и кодом JavaScript (C#)

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

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

Элемент управления DynamicPopulate в ASP.NET AJAX Control Toolkit вызывает веб-службу (или метод страницы) и заполняет полученное значение в целевой элемент управления на странице без обновления страницы. Можно также активировать заполнение с помощью пользовательского кода JavaScript на стороне клиента. Однако необходимо соблюдать особую осторожность, когда расширитель находится в пользовательском элементе управления.

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

Элемент DynamicPopulate управления в ASP.NET AJAX Control Toolkit вызывает веб-службу (или метод страницы) и заполняет полученное значение в целевой элемент управления на странице без обновления страницы. Можно также активировать заполнение с помощью пользовательского кода JavaScript на стороне клиента. Однако необходимо соблюдать особую осторожность, когда расширитель находится в пользовательском элементе управления.

Этапы

Прежде всего, требуется веб-служба ASP.NET, которая реализует метод, вызываемый элементом DynamicPopulateExtender управления . Веб-служба реализует метод getDate() , который ожидает один аргумент типа string, называемый contextKey, так как DynamicPopulate элемент управления отправляет один фрагмент контекстной информации при каждом вызове веб-службы. Ниже приведен код (файл DynamicPopulate.cs.asmx), который извлекает текущую дату в одном из трех форматов:

<%@ WebService Language="C#" Class="DynamicPopulate" %>
using System;
using System.Web;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Web.Script.Services;
[ScriptService]
public class DynamicPopulate : System.Web.Services.WebService
{
 [WebMethod]
 public string getDate(string contextKey)
 {
 string myDate = "";
 switch (contextKey)
 {
 case "format1":
 myDate = String.Format("{0:MM}-{0:dd}-{0:yyyy}", DateTime.Now);
 break;
 case "format2":
 myDate = String.Format("{0:dd}.{0:MM}.{0:yyyy}", DateTime.Now);
 break;
 case "format3":
 myDate = String.Format("{0:yyyy}/{0:MM}/{0:dd}", DateTime.Now);
 break;
 }
 return myDate;
 }
}

На следующем шаге создайте пользовательский элемент управления (.ascx file), обозначенный следующим объявлением в первой строке:

<%@ Control Language="C#" ClassName="DynamicPopulate2" %>

Элемент <label> будет использоваться для отображения данных, поступающих с сервера.

<label id="myDate" runat="server" />

Кроме того, в файле пользовательского элемента управления мы будем использовать три переключателя, каждый из которых представляет один из трех возможных форматов дат, поддерживаемых веб-службой. Когда пользователь щелкает один из переключателей, браузер выполнит код JavaScript, который выглядит следующим образом:

$find("mcd1_dpe1").populate(this.value)

Этот код обращается DynamicPopulateExtender к (пока не беспокойтесь о странном идентификаторе, он будет рассматриваться позже) и активирует динамическое заполнение данными. В контексте текущего переключателя ссылается на его значение, this.value которое равно format1, format2 или format3 именно то, что ожидает веб-метод.

В пользовательском элементе управления отсутствует DynamicPopulateExtender только элемент управления, который связывает переключатели с веб-службой.

<ajaxToolkit:DynamicPopulateExtender ID="dpe1" runat="server"
 ClearContentsDuringUpdate="true"
 TargetControlID="mcd1$myDate"
 ServicePath="DynamicPopulate.cs.asmx" ServiceMethod="getDate"/>

Опять же можно отметить странный идентификатор, используемый в элементе управления : mcd1$myDate вместо myDate. Ранее код JavaScript использовался для mcd1_dpe1 доступа DynamicPopulateExtender к вместо dpe1. Эта стратегия именования является особым требованием при использовании DynamicPopulateExtender в пользовательском элементе управления. Кроме того, необходимо внедрить пользовательский элемент управления определенным способом, чтобы все это работало. Создайте страницу ASP.NET и зарегистрируйте префикс тега для только что реализованного пользовательского элемента управления:

<%@ Register TagPrefix="uc1" TagName="myCustomDate" Src="~/DynamicPopulate2.cs.ascx"%>

Затем добавьте элемент управления ASP.NET AJAX ScriptManager на новую страницу:

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

Наконец, добавьте пользовательский элемент управления на страницу. Необходимо задать только его ID атрибут (и runat="server", конечно), но также задать для него определенное имя: mcd1 так как это префикс, используемый в пользовательском элементе управления для доступа к нему с помощью JavaScript.

<div>
 <uc1:myCustomDate ID="mcd1" runat="server" />
</div>

Вот и все! Страница работает должным образом: пользователь щелкает один из переключателей, элемент управления в наборе средств вызывает веб-службу и отображает текущую дату в нужном формате.

Переключатели находятся в пользовательском элементе управления (щелкните для просмотра полноразмерного изображения)

НазадВперед