ASP.NET - 使用 ASP.NET Web 服务器控件（一）

 

一、如何：使用 ASP.NET 语法将服务器控件添加到 ASP.NET 网页

      可以通过在 .aspx 文件中直接声明 Web 服务器控件将它添加到页中。

以声明方式添加控件

A、如果您位于可视化设计器中，请切换到源编辑视图。

B、将表示该控件的元素键入 .aspx 文件。您使用的具体语法取决于要添加的控件，但通常适用下面的情况：

·控件必须包含 runat="server" 属性。

·设置了控件的 ID 属性，除非该控件是某个复杂控件的一部分且重复出现（如在 GridView、FormView、DetailsView、Repeater 或 DataList 控件中一样）。

·Web 服务器控件是使用引用 asp 命名空间的 XML 标记声明的。

·控件声明必须正确结束。您可以指定显式结束标记，或者如果控件不具有子元素，也可以指定一个自结束标记。唯一的例外是不可以包含子元素的 HTML 输入控件，如输入控件（例如，HtmlInputText 服务器控件声明语法、HtmlImage 服务器控件声明性语法和 HtmlButton 服务器控件声明性语法）。

·控件属性声明为属性。

 

下面的示例显示 Web 服务器控件的典型声明：

<!-- Textbox Web server control -->

<asp:textbox id="TextBox1" runat="Server" Text=""></asp:textbox>

 

<!-- Same, but with self-closing element -->

<asp:textbox id="Textbox2" runat="Server" Text="" />

 

<!-- Web DropDownList control, which contains subelements -->

<asp:DropDownList id="DropDown1" runat="server">

   <asp:ListItem Value="0">0</asp:ListItem>

   <asp:ListItem Value="1">1</asp:ListItem>

   <asp:ListItem Value="2">2</asp:ListItem>

   <asp:ListItem Value="3">3</asp:ListItem>

</asp:DropDownList>

 

<asp:Repeater id="Repeater2" runat="server">

   <HeaderTemplate>

       Company data:

   </HeaderTemplate>

   <ItemTemplate>

       <asp:Label ID="Label1" runat="server"

             Font-Names="verdana" Font-Size="10pt"

             Text='<%# Eval("Name") %>' />

       ( <asp:Label ID="Label2" runat="server"

             Font-Names="verdana" Font-Size="10pt"

             Text='<%# Eval("Ticker") %>'/>

        )

   </ItemTemplate>

   <SeparatorTemplate>

       ,

   </SeparatorTemplate>

</asp:Repeater>

 

说明： 如果页设计器不能正确地呈现 Web 服务器控件，它将显示一个含有文字“创建控件时出错”的灰色框。这通常意味着该控件的 ASP.NET 语法不正确，例如，如果某 Web 服务器控件元素中缺少了 runat="server" 属性，则显示此错误。

 

1、如何：以编程方式设置 ASP.NET 服务器控件样式属性

      可以通过编程方式设置 ASP.NET 服务器控件的样式属性，这允许您按条件更改控件的外观。

      A、通过编程设置样式属性外观

使用以下分层约定指定要设置的样式对象和属性：

Control.StyleObject.Property = value;

下面的代码示例演示如何为 Calendar 控件的 DayStyle 对象设置 BackColor 属性：

Calendar1.DayStyle.BackColor = System.Drawing.Color.Green;

      您还可以创建单独的 Style 对象并将其属性值复制或合并为控件上的样式之一。这是将相同样式应用于项目中若干不同列表对象的有效方法。实际上，您可以创建一个虚拟样式表作为 Style 对象，随后将它应用到一系列控件。

 

      B、创建样式对象并将它应用于控件

      创建 Style 对象的实例并设置它的属性，如下面的示例所示：

Style s = new Style();

s.BackColor = System.Drawing.Color.Red;

 

      使用以下方法之一将 Style 对象分配给控件：

·CopyFrom 方法应用来自 Style 对象的所有设置，其中包括空设置。

·MergeWith 方法只复制已在 Style 对象上设置的属性，而略过没有设置的 Style 属性。此外，MergeWith 方法将不会改写任何现有的样式元素。

下面的代码示例演示如何使用描述的每一种方法，创建 Style 对象，然后设置它的一个属性，最后将它应用于两个不同的控件样式对象：

// Apply all values in s, including nulls.

Calendar1.SelectedDayStyle.CopyFrom(s);

// Apply only values in s that are null in HeaderStyle.

DataGrid1.HeaderStyle.MergeWith(s);

 

2、如何：使用 ASP.NET 语法设置 ASP.NET 服务器控件样式属性

      可以通过两种方式直接在 .aspx 文件中设置样式属性。

      A、直接在 .aspx 文件中设置样式属性

使用样式对象名与属性之间的连字符约定来声明样式属性，如下面的示例所示：

<asp:Calendar Id="MyCalendar"

  SelectionMode="DayWeek" runat="server"

  TitleStyle-Backcolor="#3366ff"

  TitleStyle-ForeColor="White" />

声明显式元素，并在这些元素中声明相应数据类型的属性元素，如下面的示例所示：

<asp:Calendar id="Calendar1"

  SelectionMode="DayWeek" runat="server">

  <TitleStyle BackColor="#3366ff" ForeColor="white" />

</asp:Calendar>

 

3、如何：通过编程方式设置 HTML 服务器控件的属性

      HTML 服务器控件有两个略有差异的类型。窗体中最常用的 HTML 元素可用作单独的 HTML 服务器控件，例如 HtmlInputText、HtmlInputButton、HtmlTable 等等。这些 HTML 服务器控件公开其自身和控件有关的属性，这些属性直接映射为属性。但是，任何 HTML 元素都可以转换为控件。在这种情况下，元素变为 HtmlGenericControl，且具有 TagName、Visible 和 InnerHTML 等基类属性。

      A、设置 HTML 服务器控件的属性

向对任何对象一样获取或设置属性名。所有属性或者是字符串或者是整数。

下面的示例阐释如何设置属性名称：

myAnchor.HRef = "http://www.microsoft.com";

Text1.MaxLength = 20;

Text1.Text = string.Format("{0:$####}", TotalCost);

Span1.InnerHtml = "You must enter a value for Email Address.";

 

      B、设置属性

所有 HTML 服务器控件还支持 Attributes 集合，该集合为您提供对所有控件属性的直接访问。对于使用没有公开为单独属性的特性而言尤为有用。

直接使用控件属性

使用控件的 Attributes 集合的属性和方法，如 Add、Remove、Clear 和 Count。Keys 属性返回包含控件中所有属性的名称的集合。下面的示例演示使用 Attributes 集合的各种方法：

// Adds a new attribute.

Text1.Attributes.Add("bgcolor", "red");

// Removes one attribute.

Text1.Attributes.Remove("maxlength");

// Removes all attributes, clearing all properties.

Text1.Attributes.Clear();

// Creates comma-delimited list of defined attributes

string strTemp = "";

foreach (string key in Text1.Attributes.Keys)

{

    strTemp += Text1.Attributes[key] + ", ";

}