蜘蛛网博客

.net学习笔记

导航

Atlas 自动完成控件的Behavior

客户端AutoComplete Behavior继承于Sys.UI.Behavior(关于Sys.UI.Behavior,可以参考:在ASP.NET Atlas中创建自定义的Behavior)。AutoComplete Behavior有如下属性:

  1. serviceURL:提供自动完成功能的服务器端Web Service的路径。
  2. serviceMethod:提供自动完成功能的服务器端的Web Method名称,该Web Method应该有类似的签名:public String[] GetSuggestions(string prefixText, int count)。其中prefixText为客户端传入的当前输入的字符串,count为返回的提示列表中的最大条目数,同时它应该返回一个string数组,表示提示列表。
  3. minimumPrefixLength:开始提供自动完成列表的文本框内最少的输入字符数量。默认值为3。如果用户刚刚输入一两个字母,您就迫不及待的提供给他一长串的列表,这既没什么意义,也会极大浪费服务器与网络资源。只有用户输入了等于或超过某个数目(由本属性设定)时,给出的建议才是有价值的,Atlas也才会查询服务器端的相应方法并显示给用户提示列表。
  4. completionInterval:每次查询后台的间隔时间,默认值是1000(毫秒)。如果该值太大,则给用户带来程序反应迟钝的印象,如果太小,则加重服务器与网络负担。一般来讲,500-2000是一个比较合理的值。
  5. completionList:显示提示列表的DOM元素。如果不指定,Atlas会自动在相关的TextBox下面创建一个DIV来显示。一般情况下我们无须指定这个属性。
  6. completionSetCount:提示列表中的最大项目数,默认值为10

服务器端AutoComplete Extender继承于ExtenderControl,类似的,有如下属性:

  1. ServicePath:类似客户端AutoComplete BehaviorserviceURL属性。
  2. ServiceMethod:类似客户端AutoComplete BehaviorserviceMethod属性。
  3. DropDownPanelID:类似客户端AutoComplete BehaviorcompletionList属性,不过这里指定的是服务器端<asp:Panel />ID。一般情况下我们无须指定这个属性。
  4. MinimumPrefixLength:类似客户端AutoComplete BehaviorminimumPrefixLength属性。

在使用服务器端AutoComplete Extender时,您需要为其至少指定一个AutoCompleteProperties子控件。AutoCompleteProperties控件用来指定为某个特定的TextBox添加自动完成功能,它同样提供一些属性,其中包含了与上述AutoComplete Extender相同的ServicePathServiceMethodMinimumPrefixLength三个属性。如果您在AutoComplete ExtenderAutoCompleteProperties中都设定了上述某种属性,那么设定在AutoCompleteProperties中的会覆盖设定在AutoComplete Extender中的。除此之外,AutoCompleteProperties还提供如下属性:

  1. Enabled:是否启用自动完成功能,您应该将其置为true以启用自动完成。默认值为false
  2. TargetControlID:指定该自动完成功能将应用到哪个TextBox上,应设置为服务器端TextBoxID

文章来源http://www.cnblogs.com/dflying/archive/2006/05/11/397787.aspx

posted on 2006-08-15 15:10  spiderNet  阅读(204)  评论(0)    收藏  举报