二、ASP.NET 服务器控件(草本)

二、ASP.NET 服务器控件



可以添加到 ASP.NET 页面上的控件有三种类型：
    ● HTML 服务器控件：也就是 HTML 标签，位于 System.Web.UI.HtmlControls 命名空间。
    ● Web 服务器控件：提供统一的编程模型、包含方法以及现关的时间处理程序，并且代码都在服务器端执行。位于 System.Web.UI.WebControls 命名空间中。
    ● 定制控件和用户控件：由开发人员定制的控件。

    我们添加的所有服务器控件都会自动成为对象模型的一部分，该对象模型是在这段后置代码中为窗体构建的。基本上，Web 窗体上控件的状态信息（包括文本框中的输入数据、下拉列表中的选项等）存储在隐藏的 viewstate 字段中，这个字段是服务器生成页面的一部分，并传送给用户。在复杂的窗体上，会产生很多的 viewstate 值，可以禁用不需保留状态信息的控件 Viewstate，也可以禁用整个页面的 Viewstate，有助于提高性能。

    修改过的 .aspx.cs 文件可以不用再次手工编译，就可以显示其改变的信息(?)。



一、Crystal Reports（Crystal 报表服务器控件）
    可以在 Web 页面上显示 Crystal 报表信息。



二、Standard（标准 Web 服务器控件）
Label：显示简单文本，使用 Text 属性设置和编程修改显示的文本。

TextBox：提供一个用户可以编辑的文本框，支持 AutoPostBack 属性在修改文本内容后自动回送；支持 TextChanged 事件。

Button：用户单击的标准按钮。支持 Click 事件；支持 Command 事件访问接收的附加属性 CommandName 和 CommandArgument。
   
LinkButton：与 Button 相同，但把按钮显示为超链接。

ImageButton：显示一个图像，其属性和事件继承了 Button 和 Image。

HyperLink：添加一个 HTML 超链接，NavigateUrl 属性设置超链接；ImageUrl 属性指定替换文本的图片；Target 属性指定打开窗口方式。

DropDownList：允许用户选择一个列表项，使用属性 Items 设置列表项目（一个 ListItem 集合）；SelectedItem 和 SelectedIndex 属性确定选择的内容；支持 SelectedIndexChanged 事件可以用于确定选项是否改变；支持 AutoPostBack 属性。

ListBox：允许用户选择一个或多个列表。把 SelectionMode 设置为 Muliple 或 Single 可以确定一次选择多少选项；Rows 确定要显示选项个数；其他选项与 DropDownList 控件相同。

CheckBox：显示一个复选框，选择的状态在 Checkted 属性中；文本在 Text 属性；支持 AutoPostBack 属性；支持 CheckedChanged 事件。

CheckBoxList：创建一组复选框，属性和事件可参照 DropDownList。

RadioButton：显示一个单选按钮，使用 GroupName 属性可以把 RadioButton 控件链接到一个组中，其他属性与事件与 CheckBox 相同。

RadioButtonList：创建一组单选按钮，其属性与事件类同于其他列表控件。

Image：显示一个图像。使用 ImageUrl 进行图像索引，如果图像加载失败则显示 AlternateText 对应的文本。

ImageMap：类似于 Image，但支持 HotSpot 控件提供的热区功能重定向到不同的页面。

Table：指定一个表，可设定 TableRow 和 TableCell，或者 TableRow 的集合类属性指定数据行。

BulletedList：把一个选项列表格式化为一个项目符号列表，可以有不同的显示格式，支持 Click 事件确定用户回送的选项；<ol>...</ul>，<ul>...</ul>。

HiddenField：用于提供隐藏的字段，以存储不同的值。这个控件可存储需要另一种存储机制才能发挥作用的设置。使用 Value 属性访问存储的值。

Literal：执行与 Label 相同的功能，但没有样式属性，只有一个 Text 属性。

Calendar：允许用户从图像日历中选择一个日期。基本功能是 SelectedDate 和 VisibleDate 属性。

AdRotator：广告流转板，顺序显示几个图像，使用 AdvertisementFile 属性指定描述图像的 XML 文件；支持 AdCreated 事件。

FileUpload：提供用户选择并上传文件，支持 HasFile 属性，支持后台代码的 SaveAs() 方法执行文件上传。

Wizard：用户简化用户在几个页面中输入数据的常见任务，可以给向导添加多个步骤，按顺序或不按顺序显示，并依赖此控件来维护状态。

Xml：复杂的文本显示控件，用于显示用 XSLT 样式传输的 XML 内容。

MultiView：包含一个或多个 View 控件，每次只显示一个 View 控件。可用 ActiveViewIndex 属性指定当前；如果视图改变会触发 ActiveViewChanged 事件。
Panel：添加其他控件的容器。可以使用 HorizontalAlign 和 Wiap 指定内容如何安排。

View：控件的容器，类似于 PlaceHolder，但主要作用于 MulitView 的子控件，支持 Activate 和 Deactivate 事件检测激活状态的变化。



Substitution：指定一组不与其他输出一起高速缓存的 Web 页面。

Location：与 Literal 相同，但允许使用项目资源指定要在不同区域显示的文本，使文本本地化。



三、Data（数据 Web 服务器控件）
  数据 Web 服务器控件分为两类：
    ● 数据源控件：实现从不同数据源获取数据的功能，最好通过图形化的向导来配置属性。分为两类：
System.Web.UI.DataSource（普通数据源控件）

ObjectDataSource：可以处理存储在自己创建的对象中的数据，能在 ASP.NET 中快捷显示定制的对象模型。

SqlDataSource：使用和操作 SQL Server 数据库中存储的数据管道，返回的对象是 DataSet。

AccessDataSource：使用和操作 Access 数据库中存储的数据管道。


System.Web.UI.HierarchicalDataSource（层次化数据源控件）
XmlDataSource：处理层次结构化的数据，可以绑定导航控件，还可以使用 XSL 样式表传输 XML 数据。

SiteMapDataSource：可以绑定到层次站点地图数据上。


   
    ● 数据显示控件

GridView：以数据行的格式显示多个数据项（例如数据库中的行），利用这个控件的属性，可以选择、排序和编辑数据项。

DataList：显示多个数据项，可以为每一项提供模板，以任意指定的方式显示数据字段，可以选择、排序和编辑数据项。

DetailsView：显示单条数据项的详细字段，可以添加、编辑和删除数据项。

FormView：使用模板显示一个数据项，可以添加、编辑和删除数据项。

Repeater：类似于 DataList，但是不能选择和编辑数据。

RepeaterViewer：显示报表服务数据的高级控件。



四、Validation（验证 Web 服务器控件）
    验证控件可以在不编写代码的前提下验证用户输入，还可以自动给用户输出有帮助的提示，甚至还可以生成客户端的 JavaScript 函数来简化验证任务的执行。

    验证控件只要有回送，每个验证控件就会检查控件是否有效，并相应地改变 IsValid 属性的值。如果页面中任何一个有效性验证控件不通过验证，那整个页面的 IsValid 属性为 false。另外，存储在 ErrorMessage 中的文本可以在验证控件所在位置输出（Display 属性），也可以和其他页面上的验证控件一起输出在一个独立的位置（使用 ValidationSummary 控件）。ControlToValidate 属性用于指定要验证的控件的编程ID。

RequiredFieldValidator：对输入控件的非空验证。

CompareValidator：检查输入的数据是否满足简单的要求。利用一个运算集合，通过 Operator 和 ValueToCompare 属性进行验证。Operator 设置比较运算符 >、<、= ； ValueToCompare 用于比较的值；还有 Type 用于设置比较的类型；最后还是对另一控件进行比较 ControlToCompare 属性。

RangeValidator：验证输入数据 MaximumValue 和 MinimumValue 间的范围，Type 指定其验证的数据类型。

RegularExpressionValidator：根据存储在 ValidationExpression 中的正则表达式验证字段的内容。

CustomValidator：使用定制函数验证控件的数据，自定义验证。ClientValidationFunction 用户设置客户端验证的脚本函数；ServerValidate 事件指定服务器验证数据的方法。

ValidationSummary：为所有设置了 ErrorMessage 的验证控件显示验证错误。通过 DisplayMode 和 HeaderText 属性使其显示的内容可以格式化；ShowSummary 属性设置是否显示；ShowMessageBox 属性设置是否弹出对话框显示信息。


五、Navigation （导航 Web 服务器控件）

SiteMapPath：显示路径样式的信息，允许用户产看他们在站点结构中的位置，并导航到父区域中。

Menu：支持静态或动态样式的菜单导航站点。

TreeView：可以在树形结构中显示层次化数据。树中的节点存储在 Nodes 属性中，选中的节点存储在 SelectedNode 中，支持 SelectedNodeChanged 和 TreeNodeCollapsed 事件。

    根目录下的站点地图 Web.sitemap XML 文件包含一个<siteMap>元素，这个跟元素包含一个<siteMapNode>元素，<siteMapNode>元素可以包含多个嵌套的<siteMapNode>元素。每个跟元素都包含下列属性 title、url、roles、description 属性。

    添加控件时将使用默认的提供程序和当前的 URL 位置，格式化父页面的链接列表。如果使用定制的提供程序，可以通过 SiteMapProvider 属性指定提供程序ID，还可以使用 StartingNodeOffset 删除菜单数据的上一层（例如根级的 Home 项）；“数据源控件”的 ShowStartingNode 属性选定是否删除顶级链接；使用 StartFromCurrentNode 属性指定是否从当前位置开始；使用 StringNodeUrl 会重写根节点。
地图

    默认提供程序会忽略 roles 属性，这种定制将在 Web.config 文件的 securityTrimmingEnable 属性设置为当前用户允许查看的节点提供数据，这种可见性是由用户的角色成员决定的。