vs2010 slideshowextender_ajax中SlideShowExtender控件的使用方法讲解

微软Ajax.SlideShowExtender控件使用详解（转自：http://www.sychzs.cn/comm/dotnetbbs/Showtopic.aspx?Forum_ID=5&Id=283946） 2007-12-29 博客园 近期因为需要，用到了Ajax控件库的SlideShowExtender控件。一开始一点不懂，所以依照惯例从baidu 、google上查找，但网上的文章不是转抄微软演示网站的那几行说明文字，就是给个示例，然后说自己用 这个控件做出来了轮换的功能，炫耀一番，没有一个是教别人具体的使用方法的。自己费了一周的时间，终 于用SlideShowExtender实现了自己需要的功能，想到以后可能还有像我一样的朋友，把东西写出来，方便 大家。 多说一句，微软的Ajax控件库有源代码，大家可以参考。我将Ajax控件库的演示网站建在了本地服务器上 ，一开始只想到了研究网站的演示，竟忘了还有源代码可以看，浪费了好几天的时间。 一、实现图片的轮换 首先在网站根目录建立一个文件夹Images，存入10张jpg图片，命名为01.jpg-10.jpg。建立 DemoSlideShowExtender.aspx文件，拖拽一个SlideShowExtender控件到页面上。然后添加一个Image 控件，命名为imgPicture，用于显示轮换图片，添加三个Button控件，命名为btnPrevious、btnPlay、btnNext， 分别实现后退、播放/暂停、前进三个功能。 使用SlideShowExtender，官方说明上给出了控件的各个参数设置。但我想所有初学者最想知道的功能， 是如何设置轮换图片内容的方法，但却没有给出，而是语焉不详的写了如下说明： SlideShowServiceMethod?-?The?webservice?method?that?will?be?called?to?supply?images. The?signature?of?the?method?must?match?this:? [System.Web.Services.WebMethod] [System.Web.Script.Services.ScriptMethod] public?AjaxControlToolkit.Slide[]?GetSlides()?{?...?} 反正我是没看懂，还好有源代码可以参考，在DemoSlideShowExtender.aspx中，添加一个方法GetSlides， 内容如下： ＜script?runat="Server"?type="text/C#"＞ [System.Web.Services.WebMethod] [System.Web.Script.Services.ScriptMethod] public?static?AjaxControlToolkit.Slide[]?GetSlides() { return?new?AjaxControlToolkit.Slide[]?{? new?AjaxControlToolkit.Slide("Images/01.jpg",?"图片01的标题",?"图片01的说明"), new?AjaxControlToolkit.Slide("Images/02.jpg",?"图片02的标题",?"图片02的说明"), new?AjaxControlToolkit.Slide("Images/03.jpg",?"图片03的标题",?"图片03的说明"), new?AjaxControlToolkit.Slide("Images/04.jpg",?"图片04的标题",?"图片04的说明"), new?AjaxControlToolkit.Slide("Images/05.jpg",?"图片05的标题",?"图片05的说明")};? } ＜/script＞ 这个方法就指明了要轮换的图片的路径，“new?AjaxControlToolkit.Slide("Images/01.jpg",?"图片01的标题", "图片01的说明"),”这一条可以任意添加，需要几张图片就加几条语句。 然后还有几个控件参数： ＜cc1:SlideShowExtender?ID="SlideShowExtender1"?runat="server" TargetControlID="imgPicture"?//指明要对那个Image控件实现图片轮换效果 SlideShowServiceMethod="GetSlides"?//上面给出的指明了轮换图片路径的方法的名称，如果你的方法不是 GetSlides，而是其它名称（比如MySlidesDemo），这里也要改成对应的名称 AutoPlay="true"?//是否自动播放 NextButtonID="btnNext"?//点击后切换到下一张图片的按钮Id PlayButtonID="btnPlay"?//点击后切换播放/暂停状态的按钮Id PreviousButtonID="btnPrevious"?//点击后切换到前一张图片的按钮Id PlayButtonText="play"?//处于暂停状态时播放/暂停按钮文字 StopButtonText="stop"?//处于播放状态时播放/暂停按钮文字 Loop="true"?//是否循环显示图片 ＞ ＜/cc1:SlideShowExtender＞ 好了，运行一下，看是否能显示轮换图片了。 二、将代码改放到cs文件中 现在代码是在aspx文件中，与html掺杂在一起，感觉很不爽，把它改放到cs中吧。 在设计视图中，点击SlideShowExtender控件，出现SlideShowExtender?Task列表，选择唯一的一项“Add?SlideShow?page?method”。 SlideShowExtender控件属性中会多出一项“ContextKey”，不用管它。 ＜cc1:SlideShowExtender?ID="SlideShowExtender1"?runat="server"＞ ContextKey="" ＜/cc1:SlideShowExtender＞ cs中自动添加如下方法： [System.Web.Services.WebMethodAttribute(),?System.Web.Script.Services.ScriptMethodAttribute()] public?static?AjaxControlToolkit.Slide[]?GetSlides(string?contextKey) {? } 将前面GetSlides中的内容添加到新方法里面 [System.Web.Services.WebMethodAttribute(),?System.Web.Script.Services.ScriptMethodAttribute()] public?static?AjaxControlToolkit.Slide[]?GetSlides(string?contextKey) {? return?new?AjaxControlToolkit.Slide[]?{? new?AjaxControlToolkit.Slide("Images/01.jpg",?"图片01的标题",?"图片01的说明"), new?AjaxControlToolkit.Slide("Images/02.jpg",?"图片02的标题",?"图片02的说明"), new?AjaxControlToolkit.Slide("Images/03.jpg",?"图片03的标题",?"图片03的说明"), new?AjaxControlToolkit.Slide("Images/04.jpg",?"图片04的标题",?"图片04的说明"), new?AjaxControlToolkit.Slide("Images/05.jpg",?"图片05的标题",?"图片05的说明")};? } 然后删除aspx中实现GetSlides方法的＜script?runat="Server"?type="text/C#"＞＜/script＞代码段。 现在看一下，是否能正常运行。 三、实现动态设置轮换图片 图片轮换实现了，但我需要的是在页面加载时根据具体参数显示不同的一组图片，这个需要修改代码了。 首先假定有一个方法GetImages，这个方法会从Image中随即抽取5张图片，然后存入到List＜MyDemoImage＞对象中（我的代码涉及到很多内容，无法用于示例）。 将Slide中的内容改为 [System.Web.Services.WebMethodAttribute(),?System.Web.Script.Services.ScriptMethodAttribute()] public?static?AjaxControlToolkit.Slide[]?GetSlides(string?contextKey) {? List＜MyDemoImage＞?myDemoImages?=?GetImages(5);? AjaxControlToolkit.Slide[]?slides?=?new?AjaxControlToolkit.Slide[markePictures.Count];? for?(int?i?=?0;?i?＜?Images.Count;?i++) { AjaxControlToolkit.Slide?slide?=?new?AjaxControlToolkit.Slide("/Images/"?+?myDemoImages?[i].FileName,?myDemoImages?[i].Title,?myDemoImages?[i].Description);? slides[i]?=?slide;? } return?slides;? } 现在已经可以在运行时自动设置轮换图片的内容了。 有时我需要根据参数来设置轮换图片。比如上面的例子，如果需要根据传入参数来决定随即抽取图片的张数。再进行一些改进。 在cs文件中添加一个属性 protected?string?ContextKey { get { if?(Request.Params["Id"]?==?null) { return?"0";? } else { return?Request.Params["Id"].ToString();? } } } 然 后修改SlideShowExtender控件的ContextKey属性，改为使用页面的公共属性“ContextKey”（这两个 ContextKey不要弄混，一个是SlideShowExtender控件的属性，一个是DemoSlideShowExtender页面的属性）。 ＜cc1:SlideShowExtender?ID="SlideShowExtender1"?runat="server" ContextKey=＜%#?ContextKey?%＞ ＞ ＜/cc1:SlideShowExtender＞ 好了，这回带参数调用DemoSlideShowExtender.aspx，如DemoSlideShowExtender.aspx？Id=4，DemoSlideShowExtender.aspx？Id=8等，看是否能够根据不同的参数显示不同张数的图片了。

ajax中的SlideShowExtender控件可以实现幻灯片的图片效果,如果你使用C#编程,那么可以参考"微软Ajax.SlideShowExtender控件使用详解（转自：http://www.sychzs.cn/comm/dotnetbbs/Showtopic.aspx?Forum_ID=5&Id=283946）"这位大哥写的文章,如果你是用www.sychzs.cn的话,那么请好好看我写的这,或许对你有帮助.如果在百度上搜其用法的话,大多数网上的文章不是转抄微软演示网站的那几行说明文字，就是给个示例，然后说自己用这个控件做出来了轮换的功能，炫耀一番，没有一个是教别人具体的使用方法的。好了,下面是正经的.

?

1.先建一个ajax控件网站,在自己电脑上建最好,在网站根目录下建一个images文件夹,用于存放轮换的图片.我放了三张图片

2.新建一个default.aspx文件,其实你建网站时VS2005会自动建一个同名的文件,不用自己建..

3.在default.aspx页中需要添加一个image控件,一个SlideShowExtender控件,无需实现太多的功能,只要能自动播放就可,只要这个功能实现了,其它的一下就实现了,我的SlideShowExtender控件属性设置如下:

4.然后打开default.aspx的代码设计页面,增加下面的代码:

Partial Class _Default??? Inherits www.sychzs.cn

??? _??? _??? Public Shared Function GetSlides() As AjaxControlToolkit.Slide()??????? Return New AjaxControlToolkit.Slide() { _??????? New AjaxControlToolkit.Slide("Images/1.jpg", "图片01的标题", "图片01的说明"), _??????? New AjaxControlToolkit.Slide("Images/2.jpg", "图片02的标题", "图片02的说明"), _??????? New AjaxControlToolkit.Slide("Images/3.jpg", "图片03的标题", "图片03的说明")}??? End Function

红色字体部分是增加的代码,大家特别需要注意的是此代码如果不用续行符的话那么就必须得写在一行上,不然代码会出错.

好了,大家在浏览器中试一下是不是可以用了..

?

如果是C#的,default.aspx的界面代码同上,只是代码设计页面里的代码不同而已,具体代码如下:

using System;using www.sychzs.cn;using System.Configuration;using System.Collections;using System.Web;using System.Web.Security;using System.Web.UI;using System.Web.UI.WebControls;using System.Web.UI.WebControls.WebParts;using System.Web.UI.HtmlControls;

public partial class ce : www.sychzs.cn{??? protected void Page_Load(object sender, EventArgs e)??? {

??? }

??? [System.Web.Services.WebMethod]??? [System.Web.Script.Services.ScriptMethod]??? public static AjaxControlToolkit.Slide[] GetSlides()??? {??? return new AjaxControlToolkit.Slide[] {? ??? new AjaxControlToolkit.Slide("Images/1.jpg", "图片01的标题", "图片01的说明"),??? new AjaxControlToolkit.Slide("Images/2.jpg", "图片02的标题", "图片02的说明"),??? new AjaxControlToolkit.Slide("Images/3.jpg", "图片03的标题", "图片03的说明")};??? } } ? 这样实现的功能和www.sychzs.cn的一样 ? 最后说一下,如果你要听网上一些人的说法写个web服务引用的话,那么你的好好研究了,我是没有弄出来,虽然自测服务成功,出现下面的内容:

?

-

<

ArrayOfSlide

xmlns:xsi

="

http://www.sychzs.cn/2001/XMLSchema-instance

"

xmlns:xsd

="

http://www.sychzs.cn/2001/XMLSchema

"

xmlns

="

http://www.sychzs.cn/

">

-

<

Slide

>

?

<

ImagePath

>

Images/1.jpg

ImagePath

>

?

<

Name

>

图片01的标题

Name

>

?

<

Description

>

图片01的说明

Description

>

?

Slide

>

-

<

Slide

>

?

<

ImagePath

>

Images/2.jpg

ImagePath

>

?

<

Name

>

图片02的标题

Name

>

?

<

Description

>

图片02的说明

Description

>

?

Slide

>

-

<

Slide

>

?

<

ImagePath

>

Images/3.jpg

ImagePath

>

?

<

Name

>

图片03的标题

Name

>

?

<

Description

>

图片03的说明

Description

>

?

Slide

>

?

ArrayOfSlide

>

但是在default.aspx页面中不论怎么弄都不显示图片,如果哪位弄出来了,告一声!!

?

?

AjaxToollit3.5使用整理

?

?

1 AlwaysVisibleControl最前端显示滚动块... 1

2 AnimationExtender动画效果 无... 2

3 AutoCompleteExtender文本框自动填写... 2

4 CalendarExtender日历... 3

5 CascadingDropDown级联控件扩展，如下拉列表... 3

6 CollapsiblePanelExtender 面板控件扩展隐藏或显现面板... 6

7 ConfirmButtonExtender确认弹出窗口... 7

8 ModalPopupExtender模态面板，原页面灰显... 7

9 DragPanelExtender 生成一个可拖动的Panel 8

10 DropDownExtender 使一个Label扩展为DropDownList 8

11 DropShadowExtender 使控件下生成阴影形成立体效果... 8

12 DynamicPopulateExtender 生成Html替换掉控件... 9

13 FilteredTextBoxExtender 输入文本过滤... 9

14 HoverMenuExtender 扩展GridView鼠标放上显示编辑，删除等菜单 无... 9

15 ListSearchExtender? List类控件扩展 无... 9

16 MaskedEditExtender 输入控件格式设置扩展... 9

17 MaskedEditValidator输入控件验证扩展，配合MaskedEditExtender使用... 10

18 MutuallyExclusiveCheckBoxExtender 使用CheckBox实现RadioButtonList的功能... 11

19 NoBot 无... 11

20 NumericUpDownExtender 在文本框上添加向上向下小按钮来选择... 11

21 PagingBulletedListExtender 扩展BulletedList使其按指定条件筛选... 12

22 PasswordStrength 密码强度判断... 13

23 PopupControl 无... 13

24 Rating 五个代表等级的星星选择评分... 13

25 ReorderList 生成一个可以鼠标拖动排序的列表；无... 14

26 ResizableControl 生成一个可拖动改变大小的控件 无... 14

27 RoundedCornersExtender 设置控件的边角弧度 无... 14

28 SliderExtender 扩展TextBox形成一个滑块，可用鼠标拖动... 14

29 SlideShowExtender 扩展Image控件生成幻灯片效果... 15

30 TabPanel 形成Tab页效果，不多写了... 16

31 TextBoxWatermark 在填入前文本框内的提示，获得焦点后隐藏... 16

32 ToggleButtonExtender将CheckBox前的小圆点替换成其他图标 无... 17

33 UpdatePanelAnimation 更新数据时的动画效果... 17

34 ValidatorCalloutExtender 验证控件扩展弹出提示框动画... 17

?

?

?

?

?????? 未注明则下列控件皆略去runat,ID等服务器控件通用必填属性

1 AlwaysVisibleControl最前端显示滚动块

?????? 使一个面板总在屏幕上；一般用于广告；

?????? 控件必须包含如下属性：

????????????? TargetControlID：要控制的控件ID;

????????????? VerticalSide：垂直停靠位置，可选项Top,Bottom,Middle;

????????????? VerticalOffset：控件垂直偏移值，正数字，表示偏移像素；

????????????? HorizontalOffset： 控件水平停靠位置，可选项Left,Right,Center;

?????? HorizontalOffset: 控件水平偏移值，正数字，表示偏移像素；

????????????? ScrollEffectDuration：页面变动时移动到新位置所需时间，正数字，表示秒数；

?

2 AnimationExtender动画效果 无

3 AutoCompleteExtender文本框自动填写

?????? 根据用户输入字符串时自动提供备选项，项搜索引擎的查询条件输入框；

?????? 控件必须包含如下属性：

????????????? TargetControlID：要控制的控件ID;

????????????? ServicePath：指定自动完成功能Web Service的路径 如ServicePath="AutoCompleteService.asmx"?；

????????????? ServiceMethod：指定自动完成功能Web Method的名称 ServiceMethod="GetWordList"；

????????????? MinimumPrefixLength：开始提供自动完成列表的文本框内最少的输入字符数量；

????????????? CompletionSetCount：是指列表列出输入提示即可选项的数量；

?

需要如下格式的WebService支持：红色部分不可更改

?

using System;

using System.Collections.Generic;

using System.Web.Services;

?

[WebService(Namespace = "http://www.sychzs.cn/")]

[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]

[System.Web.Script.Services.ScriptService]

public class AutoComplete : WebService

{

??? public AutoComplete()

??? {

??? }

?

??? [WebMethod]

?? ?public string[] GetCompletionList(string prefixText, int count)

??? {

??????? if (count == 0)

??????? {

??????????? count = 10;

??????? }

?

??????? if (prefixText.Equals("xyz"))

??????? {

??????????? return new string[0];

??????? }

?

??????? Random random = new Random();

??????? List items = new List(count);

??????? for (int i = 0; i < count; i++)

??????? {

??????????? char c1 = (char) www.sychzs.cn(65, 90);

??????????? char c2 = (char) www.sychzs.cn(97, 122);

??????????? char c3 = (char) www.sychzs.cn(97, 122);

?

??????????? items.Add(prefixText + c1 + c2 + c3);

??????? }

?

??????? return items.ToArray();

}

?

4 CalendarExtender日历

?????? 在文本框上绑定一个日历控件，使文本框获得焦点时弹出日历框；

?????? 控件必须包含如下属性：

????????????? TargetControlID：要控制的控件ID;

?????? 可选属性：

????????????? PopupButtonID：控制弹出和收回的控件；一般为一个带有日历图标的按钮；

????????????? PopupPosition：日历弹出位置，相对目标控件偏移位置；

????????????? Format：选中的日期格式，字符串如"yyyy-mm-dd"；

5 CascadingDropDown级联控件扩展，如下拉列表

?????? 一般是在多个DropdownList控件绑定多个CascadingDropDown控件，按顺序必须选中第一个后第二个才可选并根据第一个控件的选中项加载可选项；

?????? 控件必须包含如下属性：

????????????? TargetControlID：要控制的控件ID;

????????????? Category：目标控件的数据项，会显示在目标控件前作为标题，例如：“供电公司：”

????????????? PromptText：控件默认显示项即第一项，一般为提示，例如：“选择一个供电公司”

????????????? LoadingText：加载下级控件项时显示的提示文本，例如：“[正在加载…]”;

????????????? ServicePath: 提供数据的WebService路径，例如：“CarsService.asmx”；

?????? ServiceMethod：提供数据的WebService方法，例如：“GetDropDownContents”；

????????????? ParentControlID：父控件ID，首级控件可以不写；

页面后台添加如下命名空间和方法：

?

?????? using System.Web.Services;

??? using AjaxControlToolkit;

?

?????? ? //此方法内容不能更改

??? [WebMethod]

??? [System.Web.Script.Services.ScriptMethod]

??? public static CascadingDropDownNameValue[] GetDropDownContentsPageMethod(string knownCategoryValues, string category)

??? {

??????? return new CarsService().GetDropDownContents(knownCategoryValues, category);

}

?

所需WebService如下：

?

using System;

using System.Collections.Specialized;

using System.Text.RegularExpressions;

using System.Web;

using System.Web.Services;

using System.Xml;

?

[WebService(Namespace = "http://www.sychzs.cn/")]

[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]

[System.Web.Script.Services.ScriptService]

public class CarsService : WebService

{

//为了简单描述功能，所以采用Xml数据源

private static XmlDocument _document;

??? private static Regex _inputValidationRegex;

??? private static object _lock = new object();

?

??? // 取得数据源；

??? public static XmlDocument Document

??? {

??????? get

??????? {

??????????? lock (_lock)

??????????? {

??????????????? if (_document == null)

??????????????? {

??????????????????? // 从文件加载数据

??????????????????? _document = new XmlDocument();

??????????????????? _document.Load(HttpContext.Current.Server.MapPath("~/App_Data/CarsService.xml"));

??????????????? }

??????????? }

??????????? return _document;

??????? }

??? }

?

??? //列出数据层级，本例共三级如下：

??? public static string[] Hierarchy

??? {

??????? get { return new string[] { "make", "model","color" }; }

??? }

???

??? ?//输入有效性验证，非必须；

??? public static Regex InputValidationRegex

??? {

??????? get

??????? {

??????????? lock (_lock)

??????????? {

??????????????? if (null == _inputValidationRegex)

??????????????? {

??????????????????? _inputValidationRegex = new Regex("^[0

-9a

-zA-Z \\(\\)]*$");

??????????????? }

??????????? }

??????????? return _inputValidationRegex;

??????? }

??? }

?

??? ///

??? /// 级联控件扩展方法，签名和内容不可更改

??? ///

??? [WebMethod]

??? public AjaxControlToolkit.CascadingDropDownNameValue[] GetDropDownContents(string knownCategoryValues, string category)

??? {

??????? StringDictionary knownCategoryValuesDictionary = AjaxControlToolkit.CascadingDropDown.ParseKnownCategoryValuesString(knownCategoryValues);

?

??????? return AjaxControlToolkit.CascadingDropDown.QuerySimpleCascadingDropDownDocument(Document, Hierarchy, knownCategoryValuesDictionary, category, InputValidationRegex);

??? }

}

?

本例加载的xml如下：

?

?

???

?????

?????

?????

???

???

?????

?????

???

???

?????

?????

???

?

?

6 CollapsiblePanelExtender 面板控件扩展隐藏或显现面板

?????? 点击某个区域浮动隐藏或显示一块面板

?????? 控件必须包含如下属性：

????????????? TargetControlID：要控制的控件ID；

????????????? ExpandControlID：控制浮动面板的控件ID，即在该控件上点击显示面板；

?????? CollapseControlID：控制浮动面板的控件ID，即在该控件上点击隐藏面板；

????????????? Collapsed：初始时是否显示面板，True为不显示；

?????? 可选属性：

????????????? ImageControlID：在展开和隐藏面板时变动的图标控件，一般为ImageControl，包含在TargetControl里或TargetControl本身就是TargetControl，在面板展开和隐藏时图案在ExpandedImage，CollapsedImage属性指定的图案变换；

????????????? ExpandedImage：在面板展开时ImageControlID指定的控件显示的图片；

?????? CollapsedImage：在面板隐藏时ImageControlID指定的控件显示的图片；

7 ConfirmButtonExtender确认弹出窗口

?????? 弹出模态面板，相当于JS的Confirm弹出对话框，原页面灰显；配合DisplayModalPopupID使用

?

?????? 控件必须包含如下属性：

?

????????????? TargetControlID：要控制的控件ID；

????????????? ConfirmText：弹出的对话框内容；

?????? 可选属性：

????????????? DisplayModalPopupID：控制弹出窗口的ModalPopupExtender的ID，联合使用可形成背景灰显效果；

?

8 ModalPopupExtender模态面板，原页面灰显

?????? 弹出模态面板，配合CSS可使原页面灰显，突出显示模态面板；模态面板以外的控件可点击但不触发事件，可配合使用BackgroundCssClass使背景灰显不可点击；

?

?????? 控件必须包含如下属性：

?

????????????? TargetControlID：要控制的控件ID；

????????????? PopupControlID：弹出的面板的ID，一般为Panel的ID;

????????????? OkControlID：返回OK的面板上的某个控件ID，点击该控件面板返回OK；

????????????? CancelControlID：返回Canel的面板上的某个控件ID，点击该控件面板返回OK；

?

?????? 可选属性：

????? DropShadow：弹出面板是否有阴影；

????????????? BackgroundCssClass：背景CssClass的类名，使原页面灰显的CssClass 定义如下：

?

?????? ? .background

??????? {

??????? ????? background-color:Gray;

??? ??? ?????? filter:alpha(opacity=70);

??? ??? ?????? opacity:0.7;

??????? }

?

?????? 9 DragPanelExtender 生成一个可拖动的Panel

?????? ?????? 控件使一个Panel可被拖到页面的任意位置；

?

????????????? 控件必须包含如下属性：

????????????? TargetControlID：要控制的可被拖动的控件的ID;

????????????? DragHandleID：被当作拖动把手的控件ID,鼠标点击上面然后可拖动Panel；最好放到被拖动到Panel里面；

????????????? 在页面任意位置加入如下JS代码，否则Panel拖动后会弹回原来位置：

?????????????

?

注：虽然在面板外套上一个div然后指定float,width,height可以时面板不弹回，但不可靠；

10 DropDownExtender 使一个Label扩展为DropDownList

????????????? 扩展Label使鼠标放上后形成下拉列表形式，选择一项后等于点击组成该列表项控件，激发该控件的注册事件；

?

????????????? 控件必须包含如下属性：

????????????? TargetControlID：要控制的控件的ID;

????????????? DropDownControlID：备选项的容器ID一般为一个Panel，里面包含多个控件，如LinkButton，Button

?

11 DropShadowExtender 使控件下生成阴影形成立体效果

?????? 扩展一个控件使控件下生成阴影形成立体效果；一般用于Panel；

?

?????? 控件必须包括如下属性：

????????????? TargetControlID：要控制的控件的ID;

?????? 可选属性：

????????????? Rounded：是否使控件角圆滑；True/False ；

????????????? Radius：控件角的圆滑程度，正整数，数字越大越接近圆形；该属性影响控件的大小；

????????????? Opacity：阴影透明度，0～1小数，数字越大越不透明；

12 DynamicPopulateExtender 生成Html替换掉控件

?

13 FilteredTextBoxExtender 输入文本过滤

?????? 过滤掉不符合格式的字符，输入不符合格式的字母时界面无显示；

??????

?????? 控件必须包括如下属性：

????????????? TargetControlID: 目标TextBox的ID；

????????????? FilterType： 过滤的类型，可选为：Custom，Numbers等；可多选中间用逗号隔开；

?????? 可选属性：

?

?????? ??? FilterMode：过滤模式，选InvalidChars时，配合属性InvalidChars表示禁止录入这些字符；选ValidChars时，配合属性ValidChars表示只允许这些字符录入；

????????????? ValidChars：当FilterType为Custom时并且FilterMode为ValidChars允许的字符，例如“×+-/”表示为允许录入上述字符；

????????????? InvalidChars：当FilterType为Custom时并且FilterMode为InvalidChars禁止录入的字符，例如“×+-/”表示为不允许录入上述字符；

14 HoverMenuExtender 扩展GridView鼠标放上显示编辑，删除等菜单 无

?????? 在GridView中，形成鼠标放上显示菜单项，例如显示编辑，删除选项；

15 ListSearchExtender? List类控件扩展 无

?????? 在List类无合适选项时可手动输入；

16 MaskedEditExtender 输入控件格式设置扩展

?????? 在用户输入时限制输入特定格式字符串，数字或日期；通常配合MaskedEditValidator控件使用；

?????? 控件必须包括如下属性：

????????????? TargetControlID: 目标TextBox的ID；

????????????? Mask：控件要验证的规则? 通常用 9为占为符，例如“999.999.

999.999”

；

????? MaskType：验证类型，可为时间，日期，数字等；

?????? 可选属性：

????????????? MessageValidatorTip：用户输入时是否提示消息；

????????????? OnFocusCssClass：控件获得焦点是的CssClass类名；

????????????? OnInvalidCssClass： 未通过验证时的CssClass类名；

????????????? InputDirection：输入的类型，如：RightToLeft 从右到左，未搞明白干什么的；

????????????? DisplayMoney：显示钱的符号位置，左或右；不写则为不显示该符号；

????????????? AcceptNegative：未搞明白干什么的；

????????????? ErrorTooltipEnabled：未搞明白干什么的；

17 MaskedEditValidator输入控件验证扩展，配合MaskedEditExtender使用

?????? 配合MaskedEditExtender使用，验证用户输入；

?????? 控件必须包括如下属性：

????????????? ControlExtender：要扩展的控件ID，一般为一个MaskedEditExtender控件；

????????????? ControlToValidate：要验证的控件ID;

?? 可选属性：

????????????? AcceptAMPM：未知；

????????????? IsValidEmpty：是否可为空，true为可为空；默认允许为空；

????????????? TooltipMessage：输入时鼠标放上时提示信息；

????????????? MessageValidatorTip: 是否在鼠标放上时显示提示信息；

????????????? ErrorTooltipEnabled：未通过验证时是否在鼠标放上是显现提示信息；

????????????? EmptyValueBlurredText：空值时错误信息；

????? EmptyValueMessage：空值鼠标放上提示错误信息；

????????????? InvalidValueBlurredMessage：验证错误提示信息；

????????????? InvalidValueMessage：验证失败时鼠标放上提示错误信息；

????????????? Number：

????? MaximumValue：允许的最大值；

????? MinimumValue：允许的最小值；

????? MaximumValueMessage：超出最大值时鼠标放上提示错误信息；

????? MinimumValueMessage：小于最小值时鼠标放上提示错误信息

????????????? MaximumValueBlurredMessage：超出最大值时错误信息；

????????????? MinimumValueBlurredText：小于最小值时错误信息

?????????????

18 MutuallyExclusiveCheckBoxExtender 使用CheckBox实现RadioButtonList的功能

?????? 使用该控件可以使设置在同一“Key“的多个CheckBox只有一个被选中；

?????? 控件必须包括如下属性：

????????????? ControlExtender：要扩展的控件ID；

????????????? Key：多个CheckBox只有设置为同一个Key值才能保证只有一个被选中；

19 NoBot 无

20 NumericUpDownExtender 在文本框上添加向上向下小按钮来选择

?????? 扩展文本框使其可以只能选择指定项或指定的项如图：

?????

?? 控件必须包括如下属性：

????????????? TargetControlID：要扩展的控件ID；

????????????? Width:文本框宽度；否则文本框宽度为零

?????? 可选属性：

????????????? 数字可手动输入：

????????????? Minimum：可选最大值；

????? Maximum：可选最小值；

????????????? 限定选项用户不可输入，如月份时：

????????????? ValuesRef="January;February;March;April;May;June;July"

?????? ?? 调用WebService取得项，选中项Value为WebService方法的返回值：

????????????? ServiceUpPath：点击向上按钮调用的WebService路径，例如：“NumericUpDown.asmx”；

????? ServiceDownPath：点击向下按钮调用的WebService路径，例如：“NumericUpDown.asmx”；

????????????? ServiceUpMethod：点击向上按钮调用的WebService方法，例如：“NextValue”；

????????????? ServiceDownMethod：点击向下按钮调用的WebService方法，例如：“PrevValue”；

????????????? 注：WebService方法签名必须有一个参数，调用时会将当前值传给该方法；

?

????????????? 可以在文本框添加两个按钮作为向上/向下按钮：

????????????? TargetButtonDownID：向下按钮的ID；

?? ?? TargetButtonUpID：向上按钮的ID;

21 PagingBulletedListExtender 扩展BulletedList使其按指定条件筛选

?????? 该控件可以从BulletedList项中筛选出符合项的首字母或多个字母的项，并按相似度排序；ClientSort为true,IndexSize为2，Separator为“-”时效果如图：

?

?? 控件必须包括如下属性：

????????????? TargetControlID：要扩展的控件ID；

????????????? ClientSort：是否在客户端对生成的筛选条件排序；

????????????? IndexSize：筛选条件显示几个字母；正整数；

????????????? Separator：筛选条件的分隔符，例如：“-”；

?????? 可选属性：

????????????? SelectIndexCssClass：选择的项CssClass类ID；

????? UnselectIndexCssClass：为选中项的CssClass类ID；

22 PasswordStrength 密码强度判断

?????? 控件必须包括如下属性：

????????????? TargetControlID：要扩展的控件ID；

????????????? DisplayPosition：强度提示显示位置，相当于被扩展的文本框；多选一；

????? StrengthIndicatorType：强度提示模式；Text为文本，BarIndicator为进度条；

????????????? PrefixText：强度提示前缀；例如：PrefixText= “密码强度：”;

????????????? TextStrengthDescriptions: 密码强度描述；例如：“很弱;弱;一般;强;很强“；

?????? 可选属性：

????????????? PreferredPasswordLength：推荐的密码长度；正整数；配合HelpStatusLabelID使用

????????????? HelpStatusLabelID：指定一个Lable随用户输入显示离推荐长度还差几个字符；

????????????? StrengthStyles：不同强度时强度提示按不同的样式显示；CssClass类名，中间以逗号隔开；样式和TextStrengthDescriptions一一对应；

????????????? RequiresUpperAndLowerCaseCharacters：是否验证大小写；

????? MinimumNumericCharacters： 至少要包含的数字个数；

????? MinimumSymbolCharacters：至少要包含的符号个数；

????????????? MinimumUpperCaseCharacters：至少要包含的大写字母个数；

????? HelpHandlePosition：在文本框某个地方出现一个问号标识，点击弹出提示；

23 PopupControl 无

24 Rating 五个代表等级的星星选择评分

?????? 生成一列或一排星星，可以点击选中，一般用来评级，或打分

?????? 控件必须包括如下属性：

????????????? MaxRating：总共多少个星星；

????????????? CurrentRating：当前选中多少个星星；

?????? 可选属性:

????????????? RatingAlign：星星排列方式，可选水平和垂直；

????? RatingDirection：设置星星从左往右还是从右到左；

????? StarCssClass:开始的样式；例如：

?? ?? .ratingStar

????? ?????? {

????????????? font-size:

0pt

; width: 13px; height: 12px;

??? ?????? margin: 0px; padding: 0px; cursor: pointer;

??? display: block; background-repeat: no-repeat;

??}

????? WaitingStarCssClass：等待完成时的样式；例如：

?? ?? .savedRatingStar { background-image: url(Images/SavedStar.png);}

?

????? FilledStarCssClass：填充时的样式；例如：

?? ?? .filledRatingStar{ background-image: url(Images/FilledStar.png);}

?

????? EmptyStarCssClass：为选中的星星样式；例如：

?? ?? .emptyRatingStar { background-image: url(Images/EmptyStar.png);}

?

?????? 包含事件：

????? OnChanged(): 选中时激发；

?? 注：通过在Onload()方法设置Orientation可以；

25 ReorderList 生成一个可以鼠标拖动排序的列表；无

26 ResizableControl 生成一个可拖动改变大小的控件 无

27 RoundedCornersExtender 设置控件的边角弧度 无

28 SliderExtender 扩展TextBox形成一个滑块，可用鼠标拖动

?? 效果如图：

?

?

?????? 控件必须包括如下属性：

????????????? TargetControlID：要扩展的控件ID；

????????????? Minimum：最小可选值；

????? Maximum：最大可选值；

????? Slider1_BoundControl：显现选择值的控件ID;

????? BehaviorID：和TargetControlID相同；

?? 可选属性：

????? Steps：分段的段数，分段后不能微调，只能选指定个特定值；

????????????? Orientation：排列方式，水平还是垂直；

????? TooltipText：鼠标放上提示；

????? Decimals：默认值；

29 SlideShowExtender 扩展Image控件生成幻灯片效果

?????? 可设置多少秒换图片，向前，向后，播放和停止；

?????? ?????? 控件必须包括如下属性：

????????????? TargetControlID：要扩展的控件ID；一般为一个Image控件；

????????????? SlideShowServiceMethod：取得图片的WebService方法；

????????????? AutoPlay：是否自动播放；

????? ImageTitleLabelID： 显示图片标题的控件，一般为一个Label;

????? ImageDescriptionLabelID：显示图片解释的控件，一般为一个Lable;

????? NextButtonID:翻下一页的按钮ID；

????? PreviousButtonID：翻前一页的按钮ID;

????? PlayButtonText： 播放键的文本；

????? StopButtonText：停止键的文本；

????? PlayButtonID：播放/停止键的控件ID；

????? Loop：是否循环播放；

????? PlayInterval：自动播放时间隔秒数；

?

?????? 服务器端必须包含如下方法：可以写入后台CS页，

?????? 如果该方法独立到WebService 时需添加属性SlideShowServicePath即WebService路径；

?

????????????? [System.Web.Services.WebMethod]

??????? [System.Web.Script.Services.ScriptMethod]

??????? public static AjaxControlToolkit.Slide[] GetSlides()

??????? {

??????????? return new AjaxControlToolkit.Slide[] {

??????????? new AjaxControlToolkit.Slide("images/Blue hills.jpg", "Blue Hills", "Go Blue"),

??????????? new AjaxControlToolkit.Slide("images/Sunset.jpg", "Sunset", "Setting sun"),

??????????? new AjaxControlToolkit.Slide("images/Winter.jpg", "Winter", "Wintery..."),

??????????? new AjaxControlToolkit.Slide("images/Water lilies.jpg", "Water lillies", "Lillies in the water"),

??????????? new AjaxControlToolkit.Slide("images/VerticalPicture.jpg", "Sedona", "Portrait style picture")};

??????? }

30 TabPanel 形成Tab页效果，不多写了

31 TextBoxWatermark 在填入前文本框内的提示，获得焦点后隐藏

?????? 控件必须包括如下属性：

????????????? TargetControlID：要扩展的控件ID；一般为一个TextBox控件；

????????????? WatermarkText：水印提示文本；

?????? 可选属性：

????????????? WatermarkCssClass：水印的样式；

32 ToggleButtonExtender将CheckBox前的小圆点替换成其他图标 无

33 UpdatePanelAnimation 更新数据时的动画效果

??????

34 ValidatorCalloutExtender 验证控件扩展弹出提示框动画

?????? 如图：

????????????????????

?? 控件必须包括如下属性：

????????????? TargetControlID：要扩展的控件ID；一般为一个验证控件；

?????? 可选属性：

????????????? HighlightCssClass：弹出框搜样式