ASP.NET - Panel Web 服務器控件概述

2019-11-17 04:01:16

字體：大中小

來源：轉載

供稿：網友

      Panel Web 服務器控件在 asp.net 網頁內提供了一種容器控件，您可以將它用作靜態文本和其他控件的父級。

一、背景

可以將 Panel 控件用作其他控件的容器。當以編程方創建內容并需要一種將內容插入到頁中的方法時，此方法尤為適用。以下部分描述了可以使用 Panel 控件的其他方法。

1、動態生成的控件的容器

Panel 控件為在運行時創建的控件提供了一個方便的容器。

2、對控件和標記進行分組

對于一組控件和相關的標記，可以通過把其放置在 Panel 控件中，然后操作此 Panel 控件的方式將它們作為一個單元進行管理。例如，可以通過設置面板的 Visible 屬性來隱藏或顯示該面板中的一組控件。

3、具有默認按鈕的窗體

可將 TextBox 控件和 Button 控件放置在 Panel 控件中，然后通過將 Panel 控件的 DefaultButton 屬性設置為面板中某個按鈕的 ID 來定義一個默認的按鈕。如果用戶在面板內的文本框中進行輸入時按 Enter，這與用戶單擊特定的默認按鈕具有相同的效果。這有助于用戶更有效地使用項目窗體。

4、向其他控件添加滾動條

有些控件（如 TreeView 控件）沒有內置的滾動條。通過在 Panel 控件中放置滾動條控件，可以添加滾動行為。若要向 Panel 控件添加滾動條，請設置 Height 和 Width 屬性，將 Panel 控件限制為特定的大小，然后再設置 ScrollBars 屬性。

      4、頁上的自定義區域

可使用 Panel 控件在頁上創建具有自定義外觀和行為的區域，如下所示：

·創建一個帶標題的分組框：可設置 GroupingText 屬性來顯示標題。呈現頁時，Panel 控件的周圍將顯示一個包含標題的框，其標題是您指定的文本。

說明：不能在 Panel 控件中同時指定滾動條和分組文本。如果設置了分組文本，其優先級高于滾動條。

·在頁上創建具有自定義顏色或其他外觀的區域： Panel 控件支持外觀屬性（例如 BackColor 和 BorderWidth），可以設置外觀屬性為頁上的某個區域創建獨特的外觀。

說明：設置 GroupingText 屬性將自動在 Panel 控件周圍呈現一個邊框。

二、如何：向 Web 窗體頁添加 Panel 控件

1、在“設計”視圖中，從工具箱的“標準”選項卡中，將 Panel 控件拖到頁面上。

2、若要創建靜態文本，請在控件中單擊，然后鍵入文本。若要添加控件，請將它們從“工具箱”拖到 Panel 控件中。

說明：若要在運行時向 Panel 控件添加靜態文本，則需要創建 Literal 控件并設置它的 Text 屬性。然后，可以通過編程方式將 Literal 對象添加到面板中，方法與添加任何控件相同。有關添加控件的詳細信息，請參見如何：以編程方式向 ASP.NET 網頁添加控件。

3、還可以選擇拖動面板的邊框以調整控件的大小。

說明：該控件會自動調整自身的大小以顯示其所有的子控件（即使它們超出了設置的高度）。

4、另外還可以選擇，設置 Panel 控件的屬性（如下表所述），以指定窗格與其子控件的交互方式。

屬性
說明

HorizontalAlign
指定子控件在面板內的對齊方式（左對齊、右對齊、居中或兩端對齊）。

Wrap
指定面板內過寬的內容是換到下一行，還是在面板邊緣處截斷。

Direction
指定控件的內容是從左至右呈現還是從右至左呈現。當在頁面上創建與整個頁面的方向不同的區域時，此屬性非常有用。

ScrollBars
如果已經設置了 Height 和 Width 屬性以將 Panel 控件限制為特定的大小，則可以通過設置 ScrollBars 屬性來添加滾動條。

GroupingText
在 Panel 控件周圍呈現邊框和標題。

說明：

設置 GroupingText 屬性會導致滾動條不顯示（如果您指定了滾動條）。

三、Panel 類

      Panel 控件是其他控件的容器。當要以編程方式生成控件、隱藏/顯示一組控件或本地化一組控件時，該控件尤其有用。

Direction 屬性對于本地化 Panel 控件的內容以顯示從右到左書寫的語言（如阿拉伯語或希伯來語）的文本非常有用。

Panel 控件提供了幾個屬性，使用這些屬性可以自定義該控件內容的行為和顯示。使用 BackImageUrl 屬性為 Panel 控件顯示一個自定義圖像。使用 ScrollBars 屬性為控件指定滾動條。

示例

1、下面的示例說明如何使用 Panel 控件以編程方式生成控件和隱藏/顯示一組控件。

說明：下面的代碼示例使用單文件代碼模型，當它直接復制到代碼隱藏文件時可能不能正常工作。此代碼示例必須被復制到具有 .aspx 擴展名的空文本文件中。

<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"

    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html  >

<head>

    <title>Panel Example</title>

<script runat="server">

       void Page_Load(Object sender, EventArgs e) {

          // Show or hide the Panel contents.

          if (Check1.Checked) {

             Panel1.Visible=false;

          }

          else {

             Panel1.Visible=true;

          }

          // Generate the Label controls.

          int numlabels = Int32.Parse(DropDown1.SelectedItem.Value);

          for (int i=1; i<=numlabels; i++) {

             Label l = new Label();

             l.Text = "Label" + (i).ToString();

             l.ID = "Label" + (i).ToString();

             Panel1.Controls.Add(l);

             Panel1.Controls.Add(new LiteralControl("<br />"));

          }

          // Generate the Textbox controls.

          int numtexts = Int32.Parse(DropDown2.SelectedItem.Value);

          for (int i=1; i<=numtexts; i++) {

             TextBox t = new TextBox();

             t.Text = "TextBox" + (i).ToString();

             t.ID = "TextBox" + (i).ToString();

             Panel1.Controls.Add(t);

             Panel1.Controls.Add(new LiteralControl("<br />"));

          }

       }

    </script>

</head>

<body>

    <h3>Panel Example</h3>

    <form id="form1" runat="server">

       <asp:Panel id="Panel1" runat="server"

            BackColor="gainsboro"

            Height="200px"

            Width="300px">

            Panel1: Here is some static content...

            <br />

       </asp:Panel>

       <br />

       Generate Labels:

       <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:ListItem Value="4">4</asp:ListItem>

       </asp:DropDownList>

       <br />

       Generate TextBoxes:

       <asp:DropDownList id="DropDown2" 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:ListItem Value="4">4</asp:ListItem>

       </asp:DropDownList>

       <br />

       <asp:CheckBox id="Check1" Text="Hide Panel" runat="server"/>

       <br />

       <asp:Button Text="Refresh Panel" runat="server"/>

    </form>

</body>

</html>

上一篇：深析Java中抽象類與接口的區別

下一篇：ASP.NET - Substitution Web 服務器控件概述