AJAX Toolkit(1) --AutoComplete

ASP.NET 2.0的AJAX Toolkit已经推出有些日子了，不过我是最近开始用上的
可以到AJAX的官方网站下载http://www.asp.net
先安装AJAX Extension For 2005，然后，把下载下来的Toolkit里面有一个.vsi文件，双击就可以完成安装，这样就有AJAX Toolkit Website的模板了。
Toolkit的教程网址是http://asp.net/ajax/control%2Dtoolkit/live/
上面包含了所有的工具的说明，不过都是英文的，这次我只做了一个autocomplete的例子，很简单

xml 代码

<ajaxToolkit:AutoCompleteExtender
 runat="server"
 ID="autoComplete1"
 TargetControlID="myTextBox"
 ServiceMethod="GetCompletionList"
 ServicePath="AutoComplete.asmx"
 MinimumPrefixLength="2"
 CompletionInterval="1000"
 EnableCaching="true"
 CompletionSetCount="20"
 CompletionListCssClass="autocomplete_completionListElement"
 CompletionListItemCssClass="autocomplete_listItem"
 CompletionListHighlightedItemCssClass="autocomplete_highlightedListItem"
 DelimiterCharacters=";, :">
 <Animations>
 <OnShow> ... <!---->OnShow>
 <OnHide> ... <!---->OnHide>
 <!---->Animations>
<!---->ajaxToolkit:AutoCompleteExtender>

主要是有一个ServicePath用来提供自动完成的Web服务，调用的是ServiceMethod中的方法，TargetID指定的是哪个文本框需要进行自动完成。MinimumPrefixLength指定最少需要多少个才开始自动完成，runat必须是Server，ID指定的是本身的标识符
还有一些动画效果用Anmations指定。CssClass指定的是各种样式了。
这里的AutoComplete.asmx中的GetCompeteList方法有一定的限制，必须是：

c# 代码

[System.Web.Services.WebMethod]
[System.Web.Script.Services.ScriptMethod]
public string[] GetCompletionList(string prefixText, int count) {
 //......
}

方法的名称可以不一样，但是参数和返回值，一定要一致，否则不会调用的。
其实还有一个签名是多一个参数：

c# 代码

[System.Web.Services.WebMethod]
[System.Web.Script.Services.ScriptMethod]
public string[] GetCompletionList(
 string prefixText, int count, string contextKey) { ... }

不过我没有用过，看了半天的说明还是没有怎么看明白。下次再说

过了一阵子了，今天再回去做这个例子还是有问题，还有遗漏的，就是在webservice的类上也要加上描述

c# 代码

[WebService(Namespace = "http://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
[System.Web.Script.Services.ScriptService]
public class mycomplete : System.Web.Services.WebService {

}