AJAX控件Properties

 

Accordion 控件时的常用属性标签

属性标签名	描　　述
SelectedIndex	该控件初次加载时展开的 AccordionPane面板的索引值
HeaderCssClass	该 Accordion中包含的所有AccordionPane面板的标题区域所应用的CSS Class
ContentCssClass	该 Accordion中包含的所有AccordionPane面板的内容区域所应用的CSS Class
AutoSize	在展开具有不同高度的 AccordionPane面板时，该Accordion的总高度的变化方式。可选如下3个值： r None：该Accordion将随着当前展开的AccordionPane面板的高度自由伸长/缩短 r Limit：该Accordion将随着当前展开的AccordionPane面板的高度自由伸长/缩短，不过最高不会超过Accordion的Height属性设定值。若是其内容高度超过了Height属性设定值，则将自动显示滚动条 r Fill：该Accordion的高度将固定为Height属性的设定值，不随当前展开的不同高度的AccordionPane面板而变化。若是某个AccordionPane的内容高度超过了Height属性设定值，则将自动显示滚动条
FadeTransitions	若该属性值设置为true，则在切换当前展开的AccordionPane面板时，将带有淡入淡出效果
TransitionDuration	展开/折叠一个AccordionPane面板的过程所花费的时间，单位为毫秒
FramesPerSecond	播放展开/折叠AccordionPane面板动画的每秒钟帧数
DataSourceID	页面中某个 DataSource控件的ID，用于通过数据绑定自动生成AccordionPane面板
<Panes>	该标签内将包含一系列的 <ajaxToolkit:AccordionPane>标签，即Accordion- Pane的声明，用来表示Accordion中包含的面板
<HeaderTemplate>	在使用数据绑定功能自动生成AccordionPane面板时，该标签内将定义每个面板的标题区域中的内容模板
<ContentTemplate>	在使用数据绑定功能自动生成AccordionPane面板时，该标签内将定义每个面板的正文区域中的内容模板

AccordionPane 控件时的常用属性标签

属性标签名	描　　述
HeaderCssClass	该 AccordionPane面板的标题区域所应用的CSS Class，将覆盖声明在Accordion中的同名属性
ContentCssClass	该 AccordionPane面板的内容区域所应用的CSS Class，将覆盖声明在Accordion中的同名属性
<Header>	该标签内将定义此AccordionPane标题区域中的内容
<Content>	该标签内将定义此AccordionPane正文区域中的内容

AlwaysVisibleControl 控件时的常用属性标签( 控件适合做广告条^_^)

TargetControlID – 控件的 ID

HorizontalOffset – 控件距离浏览器的水平边距 . 默认是 0px 。

HorizontalSide - 水平停靠方向。可选择 (Left, Center, or Right) 。默认是 Left

VerticalOffset - 控件距离浏览器的垂直边距 . 默认是 0px 。

VerticalSide - 垂直停靠方向。可选择 (Top, Middle, or Bottom) 。默认是 Top 。

ScrollEffectDuration – 控件复位时间，默认时间是 0.1 ，单位是秒。

Animation 控件的常用属性标签(    用来美化、装饰网站 )

OnLoad ：表示要触发的事件是加载页面时。

OnClick ：表示要触发的事件是单击控件时。

OnMouseOver ：表示要触发的事件是鼠标滑过时。

OnMouseOut ：表示要触发的事件是鼠标移走时。

OnHoverOver ：与 OnMouseOver 类似，对特定控件而言。

OnHoverOut ：与 OnMouseOut 类似，对特定控件而言。

1 ．变色颜色的动画效果
         本例要实现的是当鼠标滑过 Panel 时， Panel 的颜色发生变化，当鼠标移走时， Panel 的颜色又发生了变化，这需要 “Color Animation” 。 Color Animation 动画的属性主要有 4 个：
     Duration ：动画显示效果的时间间隔。
     PropertyKey ：要设置的属性值。
     StartValue ：属性的开始值。
     EndValue ：属性的结束值。

2 ．淡入淡出合并的动画效果
     淡入淡出效果是网站中经常看到的效果，本例使用 “Fade Animation” 来实现这样的效果， “Fade Animation” 的属性主要有 4 个：
     duration ：动画效果的时间间隔。
     Fps ：帧 / 秒的显示速度。
     maximumOpacity ：最大透明度。
     minimumOpacity ：最小透明度。 

3 ．淡入和淡出分开的动画效果
     上一个实例中，当鼠标滑过时，其实是完成两步：淡入和淡出。通常在实际应用中，淡入和淡出是分开的。本例要演示的是当鼠标滑过时，实现淡入效果，当鼠标移出时，实现淡出效果。
     此功能需要使用 “FadeIn Animation” 和 “FadeOut Animation” ，其中两个动画控件有着相同的属性，属性内容如下：
     duration ：动画效果的时间间隔。
     Fps ：帧 / 秒的显示速度。
     maximumOpacity ：最大透明度。
    minimumOpacity ：最小透明度。 

4 ．可伸缩的动画效果
     本例要实现的效果是，当单击 Panel 时，变化 Panel 的高度和宽度。这需要使用 “Resize Animation” 动画控件。其属性主要有 5 个：
      duration ：动画效果的时间间隔。
     Fps ：帧 / 秒的显示速度。
    width ：变化后的宽度。
     height ：变化后的高度。
    unit ：高度和宽度的单位，通常为 “px” 。

AutoComplete控件的常用属性标签

1、 TargetControlID:指定要实现提示功能的控件。
2、 ServicePath:WebService的路径，提取数据的方法是写在一个WebService中的。
3、 ServeiceMethod:写在WebService中的用于提取数据的方法的名字。
4、 MinimumPrefixLength:用来设置用户输入多少字母才出现提示效果。
5、 CompletionSetCount:设置提示数据的行数。
6、 CompletionInterval:从服务器获取书的时间间隔，单位是毫秒。

Calendar 控件 常用属性标签

 TargetControlID ：用来显示选择日期的控件，改控件必需为 TextBox
    CssClass ：设置日历的样式
    Format ：显示日期的格式，如 yyMMdd, 会显示 071105
    PopupButtonID ：当日期是通过选定某个按钮弹出的时候，为改按钮的 ID ，一般为一个日历图片

CascadingDropDown 主要属性

属性	说明
TargetControlID	指定要扩展的DropDownList的ID
Category	DropDownList表示的类别名称，在WebMethod中会用到
PromptText	没有选择时显示的文字
LoadingText	加载数据时显示的文字
ServicePath	获取数据的Web Service，为每个DropDownList都要指定
ServiceMethod	获取数据的Web Method
ParentControlID	要扩展的DropDownList的父控件ID
SelectedValue	默认的选择项的值

CollapsiblePanel 控件 ------ （可收缩面版）
功能：      可以让页面中的某个区域变得可折叠，即用户可以根据喜好展开或折叠其中的内容。

  属性：

           TargetControlID ：该扩展器目标控件 ID ，即将要实现折叠、展开功能的控件的 ID

            ExpandControlID ：指定一个服务器控件的 ID ，当用户点击该控件时，该扩展器的目标 Panel 控件将展开

            CollapseControlID: 指定一个服务器控件的 ID ，当用户点击该控件时，该扩展器的目标 Panel 控件将折叠

            Collapsed ：目标 Panel 控件的初始化状态， true 代表折叠， false 代表展开

            TextLabelID ：指定一个服务器 Label 控件的 ID ，用来显示此时目标 Panel 控件的折叠 / 展开状态

            ImageControlID ：指定一个服务器端 Image 控件的 ID ，用来告知用户此时目标 Panel 控件的折叠、展开状态

            ExpandedText ：当目标 Panel 控件为展开状态时， TextLabelID 属性所指定的 Label 控件中的文字

            CollapsedText ：当目标 Panel 控件为折叠时， TextLabelID 属性所指定的 Label 控件中的文字

            ExpandedImage ：当目标 Panel 控件为展开状态时， ImageControlID 属性所指定的 Image 控件中图片的 URL

            CollapsedImage ：当目标 Panel 控件为折叠状态时， ImageControlID 属性所指定的 Image 控件中图片的 URL

ConfirmButton 控件 主要属性

TargetControlID - 该属性指定一个控件（ LinkButton 、 Button 等），点击是出现确认对话框

ConfirmText - 确认对话框显示的提示文字 ( 注 : 可以使用 html 代码 ( 如 : "
" 表示换行 ))

OnClientCancel – 取消时，执行的 js 函数。

ConfirmOnFormSubmit - 直到页面被提交之前才弹出 : 换句话说就是等页面上的验证全部通过的时候才弹出这个对话框

MaskedEditExtender 控件(用来设置文本框显示时的一些格式，主要是为了控制用户输入的内容格式。)

TargetControlID 拥有屏蔽编辑功能的文本控件ID
MaskType 屏蔽类型：None – 无屏蔽Number – 数字屏蔽Date – 日期屏蔽Time – 时间屏蔽DateTime – 日期+时间屏蔽
InputDirection:文本输入方向，从左到右或者从右到左
AcceptNegative:是否接受负数符号“-”  
DisplayMoney:显示金额符号的位置
MessageValidatorTip:是否提示验证消息  
PromptChararacter:没有输入完时的提示字符
OnInvalidCssClass:当被验证控件验证失败时应用的样式
OnFocusCssClass:当被验证控件获得焦点时应用的样式

MaskedEditValidator 控件用来难用户输入的内容，与普通控件相似。
属性列表：
ControlExtender:被控制的MaskedEditExtender的ID
ControlToValidate:被验证的控件ID
IsValidEmpty:是否能为空
EmptyValueMessage:空值时提示的信息
InvalidValueMessage:验证没有通过提示的信息
ValidationGroup:验证组
Display:验证控件的显示模式
TooltipMessage:当被验证控件获得焦点，并且内容为空时显示信息

MutuallyExclusiveCheckBox 常用属性标签

属性	描　　述
TargetControlID	目标控件
Key	同一个 key 为同一组关联复选框

Rating 控件时的常用属性标签

属性标签名	描　　述
CurrentRating	该Rating控件当前的评级，即当前选中了几颗星
MaxRating	该Rating控件支持的最高评级数，即最多有几颗星
RatingAlign	星形图标的排列方向，可选 Vertical（垂直）和Horizontal（水平）
RatingDirection	星形图标的起始方向，可选 LeftToRightTopToBottom（从左到右/从上到下）和RightToLeftBottomToTop（从右到左/从下到上）
ReadOnly	若该属性值设置为true，则该Rating控件为只读的，用户不能对评级进行修改
StarCssClass	星形图标所应用的 CSS Class
WaitingStarCssClass	在用户对评级有所改变，且这个改变尚处于异步提交回服务器保存的过程中时星形图标所应用的CSS Class
FilledStarCssClass	选中的星形图标所应用的 CSS Class
EmptyStarCssClass	未选中的星形图标所应用的 CSS Class
OnChanged	指定Changed事件的处理函数。Changed事件将在用户改变评级时触发，并通过异步而不是整页地回送发送回服务器。这样，在服务器端的事件处理函数中即可得到当前的所选值，并做后续操作
Tag	一个作为附加信息的上下文字符串，该附加信息将传递给Changed事件的服务器端处理程序，这样即可在其中根据需要使用这个值

ReorderList 控件时的常用属性标签

属性标签名	描　　述
DataSourceID	页面中某个DataSource控件的ID，用于通过数据绑定自动生成列表项目
DataKeyField	数据源中键字段的名称，该字段中的值应该在所在记录中是唯一且不变的，ReorderList将用条目中该字段的值作为记录的标志，将在更新/删除中使用
AllowReorder	是否允许用户对列表中的项目进行重新排序，若指定了 <ReorderTemplate>，则该属性将自动设置为true
SortOrderField	数据源中作为排序字段的名称。在用户进行重新排序之后，ReorderList将自动修改需要更新的条目的该字段
DragHandleAlignment	条目的可拖动区域与条目之间的相对位置关系，可选Top（上部）、Bottom（下部）、Left（左边）和Right（右边）
PostBackOnReorder	若该属性值设置为true，则当用户对列表中的项目进行重新排序之后，将自动引发一次整页的回送；否则将以异步回调的方式向服务器端发送请求
EditItemIndex	列表中当前处于编辑模式下的项目的索引值
ShowInsertItem	若该属性值为 true，则列表中将显示出一个用来添加新条目的特殊行，即<InsertItemTemplate>模板中定义的内容
ItemInsertLocation	插入的新行在整个列表中的位置，可选 Beginning（第一项）或End（最后一项）
<ItemTemplate>	该标签内将定义列表中普通条目的模板
<DragHandleTemplate>	该标签内将定义列表条目中可拖放区域的模板。用户只有在该区域中拖放才能够对该条目进行重排序
<ReorderTemplate>	该标签内将定义拖动列表条目时列表中可投放区域的模板
<InsertItemTemplate>	该标签内将定义用来添加新条目的特殊行的模板
<EditItemTemplate>	该标签内将定义处于编辑状态中的列表条目的模板
<EmptyListTemplate>	该标签内将定义空列表的模板。若列表中没有任何条目，则将显示该模板中定义的内容