共用方式為


BulletedList 類別

定義

建立控制項,以點符格式產生項目清單。

public ref class BulletedList : System::Web::UI::WebControls::ListControl, System::Web::UI::IPostBackEventHandler
public class BulletedList : System.Web.UI.WebControls.ListControl, System.Web.UI.IPostBackEventHandler
type BulletedList = class
    inherit ListControl
    interface IPostBackEventHandler
Public Class BulletedList
Inherits ListControl
Implements IPostBackEventHandler
繼承
實作

範例

本節包含兩個程式代碼範例。 第一個程式代碼範例示範如何使用格式化為連結按鈕的清單專案來建立 BulletedList 控件。 第二個程式代碼範例示範如何使用數據系結來指定清單專案來建立 BulletedList 控件。

下列程式代碼範例示範如何使用格式化為連結按鈕的清單專案建立 BulletedList 控件。 按兩下清單專案時,文字會顯示在 Label 控件中。

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>BulletedList Click Example</title>
  <script runat="server">


    void ItemsBulletedList_Click(object sender, System.Web.UI.WebControls.BulletedListEventArgs e)
    {

        // Change the message displayed in the label based on the index
        // of the list item that was clicked.
        switch (e.Index) 
      {
            case 0:
                Message.Text = "You clicked list item 1.";
                break;
            case 1:
                Message.Text = "You clicked list item 2.";
                break;
            case 2:
                Message.Text = "You clicked list item 3.";
                break;
            default:
                throw new Exception("You did not click a valid list item.");
                break;
        }

    }

  </script>

</head>
<body>

  <h3>BulletedList Click Example</h3>

  <form id="form1" runat="server">
            
    <p>Click on an item in the list to raise the Click event.</p> 
        
    <asp:BulletedList id="ItemsBulletedList" 
      BulletStyle="Disc"
      DisplayMode="LinkButton"
      OnClick="ItemsBulletedList_Click"
      runat="server">
        <asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
        <asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
        <asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
    </asp:BulletedList>
            
    <asp:Label id="Message" 
      Font-Size="12"
      Width="168px" 
      Font-Bold="True" 
      runat="server"
      AssociatedControlID="ItemsBulletedList"/>

   </form>

</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>BulletedList Click Example</title>
  <script runat="server">

    Sub ItemsBulletedList_Click(ByVal sender As Object, _
                                ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)
      
      ' Change the message displayed in the label based on the index
      ' of the list item that was clicked.
      Select Case (e.Index)
        Case 0
          Message.Text = "You clicked list item 1."
        Case 1
          Message.Text = "You clicked list item 2."
        Case 2
          Message.Text = "You clicked list item 3."
        Case Else
          Throw New Exception("You did not click a valid list item.")
      End Select

    End Sub

  </script>

</head>
<body>

  <h3>BulletedList Click Example</h3>

  <form id="form1" runat="server">
            
    <p>Click on an item in the list to raise the Click event.</p> 
        
    <asp:BulletedList id="ItemsBulletedList" 
      BulletStyle="Disc"
      DisplayMode="LinkButton" 
      OnClick="ItemsBulletedList_Click"
      runat="server">
        <asp:ListItem Value="http://www.cohowinery.com">Coho Winery</asp:ListItem>
        <asp:ListItem Value="http://www.contoso.com">Contoso, Ltd.</asp:ListItem>
        <asp:ListItem Value="http://www.tailspintoys.com">Tailspin Toys</asp:ListItem>
    </asp:BulletedList>
            
    <asp:Label id="Message"
      Font-Size="12"
      Width="168px"
      Font-Bold="True"
      runat="server"
      AssociatedControlID="ItemsBulletedList"/>

   </form>

</body>
</html>

下列程式代碼範例示範如何使用數據系結來指定清單專案來建立 BulletedList 控件。 清單專案會格式化為連結按鈕。 按兩下清單專案時,文字會顯示在 Label 控件中。

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>BulletedList Class Data Binding Example</title>
  <script runat="server">

    void ProductsBulletedList_Click(object sender, 
      System.Web.UI.WebControls.BulletedListEventArgs e)
    {

        // Change the message displayed in the label based on the index
        // of the list item that was clicked.
        switch (e.Index) 
      {
            case 0:
                Message.Text = "Product 1 was clicked";
                break;
            case 1:
                Message.Text = "Product 2 was clicked";
                break;
            case 2:
                Message.Text = "Product 3 was clicked";
                break;
            case 3:
                Message.Text = "Product 4 was clicked";
                break;
            default:
                throw new Exception("You must click a valid list item.");
                break;
        }

  }

  </script>
    
</head>
<body>

  <h3>BulletedList Class Data Binding Example</h3>

  <form id="form1" runat="server">
            
    <p>Click on an item in the list.</p>

    <asp:BulletedList id="ProductsBulletedList" 
      BulletStyle="Disc"
      DisplayMode="LinkButton"
      DataTextField="ProductName"
      DataSourceID="SqlDataSource1"
      OnClick="ProductsBulletedList_Click"
      runat="server">                    
    </asp:BulletedList>
        
    <asp:SqlDataSource id="SqlDataSource1"          
      ConnectionString="<%$ ConnectionStrings:NorthWindConnection%>"
      runat="server"
      SelectCommand="SELECT * FROM [Products] Where ProductID < 5">
    </asp:SqlDataSource>

    <asp:Label id="Message" 
      Font-Size="12"
      Width="168px" 
      Font-Bold="True" 
      runat="server"/>

   </form>

</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>BulletedList Class Data Binding Example</title>
  <script runat="server">

    Sub ProductsBulletedList_Click(ByVal sender As Object, _
                                   ByVal e As System.Web.UI.WebControls.BulletedListEventArgs)
      
      ' Change the message displayed in the label based on the index
      ' of the list item that was clicked.
      Select Case (e.Index)
        Case 0
          Message.Text = "Product 1 was clicked"
        Case 1
          Message.Text = "Product 2 was clicked"
        Case 2
          Message.Text = "Product 3 was clicked"
        Case 3
          Message.Text = "Product 4 was clicked"
        Case Else
          Throw New Exception("You must click a valid list item.")
      End Select

    End Sub

  </script>
    
</head>
<body>

  <h3>BulletedList Class Data Binding Example</h3>

  <form id="form1" runat="server">
            
    <p>Click on an item in the list.</p>

    <asp:BulletedList id="ProductsBulletedList" 
      BulletStyle="Disc"
      DisplayMode="LinkButton"
      DataTextField="ProductName"
      DataSourceID="SqlDataSource1"
      OnClick="ProductsBulletedList_Click"
      runat="server">                    
    </asp:BulletedList>
        
    <asp:SqlDataSource id="SqlDataSource1"          
      ConnectionString="<%$ ConnectionStrings:NorthWindConnection%>"
      runat="server"
      SelectCommand="SELECT * FROM [Products] Where ProductID < 5">
    </asp:SqlDataSource>

    <asp:Label id="Message" 
      Font-Size="12"
      Width="168px" 
      Font-Bold="True" 
      runat="server"/>

   </form>

</body>
</html>

備註

在本主題中:

介紹

使用 BulletedList 控件來建立以項目符號格式化的項目清單。 若要指定您想要出現在 BulletedList 控件中的個別清單專案,請在 BulletedList 控件的開頭和結尾標記之間放置每個專案的 ListItem 物件。

若要指定要用來在 BulletedList 控件中顯示清單專案的項目符號類型,請將 BulletStyle 屬性設定為 BulletStyle 列舉所定義的其中一個專案符號類型。 下表列出可用的項目符號樣式。

項目符號樣式 描述
NotSet 未設定。
Numbered 數位。
LowerAlpha 小寫字母。
UpperAlpha 大寫字母。
LowerRoman 小寫羅馬數位。
UpperRoman 大寫羅馬數位。
Disc 填滿的圓形。
Circle 空的圓形。
Square 填滿的正方形。
CustomImage 自定義映像。

使用 FirstBulletNumber 屬性來指定值,這個值會啟動排序 BulletedList 控件中的清單項目編號。 如果 BulletStyle 屬性設定為 DiscSquareCircleCustomImage 欄位,則會忽略指派給 FirstBulletNumber 屬性的值。 如果您將 BulletStyle 屬性設定為 CustomImage 的值來指定項目符號的自定義影像,則必須同時設定 BulletImageUrl 屬性,以指定圖像檔的位置。

若要指定 BulletedList中列表項目的顯示行為,請將 DisplayMode 屬性設定為 BulletedListDisplayMode 列舉所定義的其中一個值。 定義的顯示行為會 TextHyperLinkLinkButton

按兩下超連結時,它會巡覽至URL。 使用 Value 屬性來指定超連結巡覽至的URL。 使用 Target 屬性來指定框架或視窗,以顯示單擊超連結時巡覽至的網頁。

DisplayMode 屬性設定為 LinkButton時,BulletedList 控件會將清單項目顯示為按兩下時回傳至伺服器的連結。 若要以程式設計方式控制按下連結按鈕時所執行的動作,請提供 Click 事件的事件處理程式。 請注意,SelectedIndexSelectedItem 屬性繼承自 ListControl 類別,不適用於 BulletedList 控件。 使用 BulletedListEventArgs 類別的事件數據來判斷已按下 BulletedList 中鏈接按鈕的索引。

BulletedList 控件也支持數據系結。 若要將 BulletedList 系結至數據源,您可以使用任何提供的數據系結機制。 如需詳細資訊,請參閱 系結至資料庫

可及性

根據預設,此控件所轉譯的標記可能不符合輔助功能標準,例如 Web 內容輔助功能指導方針 1.0 (WCAG) 優先順序 1 指導方針。 如需此控制項輔助功能支援的詳細資訊,請參閱 ASP.NET 控制件和輔助功能

宣告式語法

<asp:BulletedList
    AccessKey="string"
    AppendDataBoundItems="True|False"
    AutoPostBack="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    BulletImageUrl="uri"
    BulletStyle="NotSet|Numbered|LowerAlpha|UpperAlpha|LowerRoman|
        UpperRoman|Disc|Circle|Square|CustomImage"
    CausesValidation="True|False"
    CssClass="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    DataTextField="string"
    DataTextFormatString="string"
    DataValueField="string"
    DisplayMode="Text|HyperLink|LinkButton"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FirstBulletNumber="integer"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|
        Medium|Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnClick="Click event handler"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnTextChanged="TextChanged event handler"
    OnUnload="Unload event handler"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    Target="string|_blank|_parent|_search|_self|_top"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
>
            <asp:ListItem
                Enabled="True|False"
                Selected="True|False"
                Text="string"
                Value="string"
            />
</asp:BulletedList>

建構函式

BulletedList()

初始化 BulletedList 類別的新實例。

屬性

AccessKey

取得或設定存取金鑰,可讓您快速流覽至 Web 伺服器控制項。

(繼承來源 WebControl)
Adapter

取得控制器特定配接器。

(繼承來源 Control)
AppendDataBoundItems

取得或設定值,這個值表示是否在數據系結之前清除清單專案。

(繼承來源 ListControl)
AppRelativeTemplateSourceDirectory

取得或設定包含這個控制項之 PageUserControl 物件的應用程式相對虛擬目錄。

(繼承來源 Control)
Attributes

取得任意屬性的集合(僅適用於轉譯),這些屬性不會對應至 控件上的屬性。

(繼承來源 WebControl)
AutoPostBack

取得或設定基類 AutoPostBack 屬性值。

BackColor

取得或設定 Web 伺服器控制件的背景色彩。

(繼承來源 WebControl)
BindingContainer

取得包含此控件數據系結的 控件。

(繼承來源 Control)
BorderColor

取得或設定 Web 控制件的框線色彩。

(繼承來源 WebControl)
BorderStyle

取得或設定 Web 伺服器控制件的框線樣式。

(繼承來源 WebControl)
BorderWidth

取得或設定 Web 伺服器控制件的框線寬度。

(繼承來源 WebControl)
BulletImageUrl

取得或設定要針對 BulletedList 控件中每個專案符號顯示之影像的路徑。

BulletStyle

取得或設定 BulletedList 控件的專案符號樣式。

CausesValidation

取得或設定值,指出按一下衍生自 ListControl 類別的控制件時,是否執行驗證。

(繼承來源 ListControl)
ChildControlsCreated

取得值,這個值表示是否已建立伺服器控制件的子控件。

(繼承來源 Control)
ClientID

取得由 ASP.NET 產生的 HTML 標記控件識別碼。

(繼承來源 Control)
ClientIDMode

取得或設定用來產生 ClientID 屬性值的演算法。

(繼承來源 Control)
ClientIDSeparator

取得字元值,表示 ClientID 屬性中使用的分隔符。

(繼承來源 Control)
Context

取得與目前 Web 要求之伺服器控制項相關聯的 HttpContext 物件。

(繼承來源 Control)
Controls

取得控件的 ControlCollection 集合。

ControlStyle

取得 Web 伺服器控制件的樣式。 此屬性主要是由控件開發人員使用。

(繼承來源 WebControl)
ControlStyleCreated

取得值,指出是否已為 ControlStyle 屬性建立 Style 物件。 此屬性主要供控件開發人員使用。

(繼承來源 WebControl)
CssClass

取得或設定用戶端上 Web 伺服器控制項所轉譯的級聯樣式表單 (CSS) 類別。

(繼承來源 WebControl)
DataItemContainer

如果命名容器實作 IDataItemContainer,則取得命名容器的參考。

(繼承來源 Control)
DataKeysContainer

如果命名容器實作 IDataKeysControl,則取得命名容器的參考。

(繼承來源 Control)
DataMember

取得或設定要系結至控件之 DataSource 中的特定數據表。

(繼承來源 ListControl)
DataSource

取得或設定填入清單控制件項目的數據源。

(繼承來源 ListControl)
DataSourceID

取得或設定控件的標識符,數據綁定控件會從中擷取其數據項清單。

(繼承來源 DataBoundControl)
DataSourceObject

取得實作 IDataSource 介面的對象,這個介面提供對象數據內容的存取權。

(繼承來源 DataBoundControl)
DataTextField

取得或設定數據源的欄位,提供清單專案的文字內容。

(繼承來源 ListControl)
DataTextFormatString

取得或設定格式化字串,用來控制系結至清單控件的數據顯示方式。

(繼承來源 ListControl)
DataValueField

取得或設定數據來源的欄位,提供每個清單專案的值。

(繼承來源 ListControl)
DesignMode

取得值,指出控件是否在設計介面上使用。

(繼承來源 Control)
DisplayMode

取得或設定 BulletedList 控件中清單內容的顯示模式。

Enabled

取得或設定值,指出是否啟用 Web 伺服器控制件。

(繼承來源 WebControl)
EnableTheming

取得或設定值,指出主題是否套用至這個控件。

(繼承來源 WebControl)
EnableViewState

取得或設定值,指出伺服器控制項是否將檢視狀態及其包含之任何子控件的檢視狀態保存至要求用戶端。

(繼承來源 Control)
Events

取得控制項的事件處理程式委派清單。 這個屬性是唯讀的。

(繼承來源 Control)
FirstBulletNumber

取得或設定值,這個值會啟動排序 BulletedList 控件中的清單專案編號。

Font

取得與網頁伺服器控件相關聯的字型屬性。

(繼承來源 WebControl)
ForeColor

取得或設定網頁伺服器控制件的前景色彩(通常是文字的色彩)。

(繼承來源 WebControl)
HasAttributes

取得值,指出控件是否設定屬性。

(繼承來源 WebControl)
HasChildViewState

取得值,指出目前伺服器控件的子控件是否有任何儲存的檢視狀態設定。

(繼承來源 Control)
Height

取得或設定 Web 伺服器控制件的高度。

(繼承來源 WebControl)
ID

取得或設定指派給伺服器控制件的程式設計標識碼。

(繼承來源 Control)
IdSeparator

取得用來分隔控件識別碼的字元。

(繼承來源 Control)
Initialized

取得值,指出數據綁定控件是否已初始化。

(繼承來源 BaseDataBoundControl)
IsBoundUsingDataSourceID

取得值,指出是否已設定 DataSourceID 屬性。

(繼承來源 BaseDataBoundControl)
IsChildControlStateCleared

取得值,指出這個控件中包含的控件是否具有控件狀態。

(繼承來源 Control)
IsDataBindingAutomatic

取得值,這個值表示數據系結是否為自動系結。

(繼承來源 BaseDataBoundControl)
IsEnabled

取得值,指出控制件是否已啟用。

(繼承來源 WebControl)
IsTrackingViewState

取得值,這個值表示伺服器控件是否將變更儲存至其檢視狀態。

(繼承來源 Control)
IsUsingModelBinders

取得值,這個值表示模型系結是否正在使用中。

(繼承來源 DataBoundControl)
IsViewStateEnabled

取得值,指出這個控件是否啟用檢視狀態。

(繼承來源 Control)
Items

取得清單控制件中的專案集合。

(繼承來源 ListControl)
ItemType

取得或設定強型別數據系結之數據項類型的名稱。

(繼承來源 DataBoundControl)
LoadViewStateByID

取得值,指出控件是否參與藉由 ID 而不是索引載入其檢視狀態。

(繼承來源 Control)
NamingContainer

取得伺服器控制項命名容器的參考,這個容器會建立唯一的命名空間,以區分具有相同 ID 屬性值的伺服器控制件。

(繼承來源 Control)
Page

取得包含伺服器控制件之 Page 實例的參考。

(繼承來源 Control)
Parent

取得頁面控件階層中伺服器控制件之父控件的參考。

(繼承來源 Control)
RenderingCompatibility

取得值,指定轉譯 HTML 與 的 ASP.NET 版本相容。

(繼承來源 Control)
RenderWhenDataEmpty

取得或設定值,這個值表示如果數據源沒有數據,還是控件未系結數據,則表示控件是否呈現。

RequiresDataBinding

取得或設定值,指出是否應該呼叫 DataBind() 方法。

(繼承來源 BaseDataBoundControl)
SelectArguments

取得數據綁定控件從數據源控件擷取數據時所使用的 DataSourceSelectArguments 物件。

(繼承來源 DataBoundControl)
SelectedIndex

取得或設定 BulletedList 控件中目前選取專案的以零起始的索引。

SelectedItem

取得 BulletedList 控件中目前選取的專案。

SelectedValue

取得或設定 BulletedList 控件中選取之 ListItem 物件的 Value 屬性。

SelectMethod

要呼叫的方法名稱,以便讀取數據。

(繼承來源 DataBoundControl)
Site

取得在設計介面上呈現時裝載目前控制件之容器的相關信息。

(繼承來源 Control)
SkinID

取得或設定要套用至控件的面板。

(繼承來源 WebControl)
Style

取得文字屬性的集合,這些屬性將會轉譯為 Web 伺服器控件外部標記上的樣式屬性。

(繼承來源 WebControl)
SupportsDisabledAttribute

取得值,這個值表示當控件的 IsEnabled 屬性 false時,控件是否應該將轉譯 HTML 專案的 disabled 屬性設定為 「停用」。

(繼承來源 BaseDataBoundControl)
TabIndex

取得或設定 Web 伺服器控制件的索引標籤索引。

(繼承來源 WebControl)
TagKey

取得指定之 BulletedList 控件的 HtmlTextWriterTag 值。

TagName

取得控件標記的名稱。 此屬性主要是由控件開發人員使用。

(繼承來源 WebControl)
Target

取得或設定目標視窗或框架,以在單擊 BulletedList 控件中的超連結時顯示所連結的網頁內容。

TemplateControl

取得或設定包含這個控件之範本的參考。

(繼承來源 Control)
TemplateSourceDirectory

取得包含目前伺服器控制件之 PageUserControl 的虛擬目錄。

(繼承來源 Control)
Text

取得或設定 BulletedList 控件的文字。

ToolTip

取得或設定滑鼠指標停留在 Web 伺服器控制件上時所顯示的文字。

(繼承來源 WebControl)
UniqueID

取得伺服器控制件的唯一階層式限定標識碼。

(繼承來源 Control)
ValidateRequestMode

取得或設定值,這個值表示控件是否會檢查瀏覽器的用戶端輸入是否有潛在的危險值。

(繼承來源 Control)
ValidationGroup

取得或設定從 ListControl 類別衍生之控件的控件群組,會在它回傳至伺服器時造成驗證。

(繼承來源 ListControl)
ViewState

取得狀態資訊的字典,可讓您跨相同頁面的多個要求儲存和還原伺服器控件的檢視狀態。

(繼承來源 Control)
ViewStateIgnoresCase

取得值,這個值表示 StateBag 物件是否不區分大小寫。

(繼承來源 Control)
ViewStateMode

取得或設定這個控件的檢視狀態模式。

(繼承來源 Control)
Visible

取得或設定值,這個值表示伺服器控制項是否呈現為頁面上的UI。

(繼承來源 Control)
Width

取得或設定 Web 伺服器控制件的寬度。

(繼承來源 WebControl)

方法

AddAttributesToRender(HtmlTextWriter)

BulletedList 控件的 HTML 屬性和樣式加入至指定的 HtmlTextWriter 物件。

AddedControl(Control, Int32)

在子控件新增至 Control 物件的 Controls 集合之後呼叫。

(繼承來源 Control)
AddParsedSubObject(Object)

通知伺服器控制項已剖析 XML 或 HTML 元素,並將專案加入至伺服器控制件的 ControlCollection 物件。

(繼承來源 Control)
ApplyStyle(Style)

將指定樣式的任何非空白項目複製到 Web 控制項,並覆寫控件的任何現有樣式專案。 此方法主要供控件開發人員使用。

(繼承來源 WebControl)
ApplyStyleSheetSkin(Page)

將頁面樣式表單中定義的樣式屬性套用至 控件。

(繼承來源 Control)
BeginRenderTracing(TextWriter, Object)

開始對轉譯數據進行設計時間追蹤。

(繼承來源 Control)
BuildProfileTree(String, Boolean)

收集伺服器控制件的相關信息,並將它傳遞給在啟用頁面追蹤時要顯示的 Trace 屬性。

(繼承來源 Control)
ClearCachedClientID()

將快取 ClientID 值設定為 null

(繼承來源 Control)
ClearChildControlState()

刪除伺服器控制項子控制件的控制項狀態資訊。

(繼承來源 Control)
ClearChildState()

刪除所有伺服器控制項子控件的檢視狀態和控件狀態資訊。

(繼承來源 Control)
ClearChildViewState()

刪除所有伺服器控制件子控件的檢視狀態資訊。

(繼承來源 Control)
ClearEffectiveClientIDMode()

將目前控制項實體和任何子控制件的 ClientIDMode 屬性設定為 Inherit

(繼承來源 Control)
ClearSelection()

清除清單選取範圍,並將所有專案的 Selected 屬性設定為 false。

(繼承來源 ListControl)
ConfirmInitState()

設定數據綁定控件的初始化狀態。

(繼承來源 BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Style 物件未封裝的屬性,從指定的 Web 伺服器控制項複製到呼叫此方法的 Web 伺服器控制件。 此方法主要是由控制開發人員使用。

(繼承來源 WebControl)
CreateChildControls()

由 ASP.NET 頁面架構呼叫,以通知伺服器控件使用組合式實作來建立它們所包含的任何子控件,以準備回傳或轉譯。

(繼承來源 Control)
CreateControlCollection()

建立新的 ControlCollection 物件,以保存伺服器控制元件的子控件(常值和伺服器)。

(繼承來源 Control)
CreateControlStyle()

建立 WebControl 類別內部用來實作所有樣式相關屬性的樣式物件。 此方法主要是由控制開發人員使用。

(繼承來源 WebControl)
CreateDataSourceSelectArguments()

如果未指定自變數,則建立數據綁定控件所使用的預設 DataSourceSelectArguments 物件。

(繼承來源 DataBoundControl)
DataBind()

將數據源系結至叫用的伺服器控制項及其所有子控件。

(繼承來源 BaseDataBoundControl)
DataBind(Boolean)

將數據源系結至叫用的伺服器控制項及其所有子控件,以及具有引發 DataBinding 事件的選項。

(繼承來源 Control)
DataBindChildren()

將數據源系結至伺服器控制件的子控制件。

(繼承來源 Control)
Dispose()

可讓伺服器控制件在從記憶體釋放之前執行最終清除。

(繼承來源 Control)
EndRenderTracing(TextWriter, Object)

結束轉譯數據的設計時間追蹤。

(繼承來源 Control)
EnsureChildControls()

判斷伺服器控制項是否包含子控制件。 如果沒有,它會建立子控件。

(繼承來源 Control)
EnsureDataBound()

如果已設定 DataSourceID 屬性,且數據綁定控件標示為需要系結,則呼叫 DataBind() 方法。

(繼承來源 BaseDataBoundControl)
EnsureID()

為未指派標識碼的控件建立標識符。

(繼承來源 Control)
Equals(Object)

判斷指定的物件是否等於目前的物件。

(繼承來源 Object)
FindControl(String, Int32)

使用指定的 idpathOffset 參數中指定的整數,搜尋目前命名容器中的伺服器控制件,以協助搜尋。 您不應該覆寫這個版本的 FindControl 方法。

(繼承來源 Control)
FindControl(String)

使用指定的 id 參數搜尋伺服器控制元件的目前命名容器。

(繼承來源 Control)
Focus()

將輸入焦點設定為控件。

(繼承來源 Control)
GetData()

擷取數據綁定控件用來執行數據作業的 DataSourceView 物件。

(繼承來源 DataBoundControl)
GetDataSource()

擷取與數據綁定控件相關聯的 IDataSource 介面,如果有的話。

(繼承來源 DataBoundControl)
GetDesignModeState()

取得控制件的設計時間數據。

(繼承來源 Control)
GetHashCode()

做為預設哈希函式。

(繼承來源 Object)
GetRouteUrl(Object)

取得對應至一組路由參數的URL。

(繼承來源 Control)
GetRouteUrl(RouteValueDictionary)

取得對應至一組路由參數的URL。

(繼承來源 Control)
GetRouteUrl(String, Object)

取得對應至一組路由參數和路由名稱的URL。

(繼承來源 Control)
GetRouteUrl(String, RouteValueDictionary)

取得對應至一組路由參數和路由名稱的URL。

(繼承來源 Control)
GetType()

取得目前實例的 Type

(繼承來源 Object)
GetUniqueIDRelativeTo(Control)

傳回指定控件之 UniqueID 屬性的前置部分。

(繼承來源 Control)
HasControls()

判斷伺服器控制項是否包含任何子控制件。

(繼承來源 Control)
HasEvents()

傳回值,指出事件是註冊控件或任何子控件。

(繼承來源 Control)
IsLiteralContent()

判斷伺服器控制項是否只保留常值內容。

(繼承來源 Control)
LoadControlState(Object)

從上一頁要求還原 SaveControlState() 方法所儲存的控制狀態資訊。

(繼承來源 Control)
LoadViewState(Object)

載入先前儲存的 DetailsView 控件檢視狀態。

(繼承來源 ListControl)
MapPathSecure(String)

擷取虛擬路徑對應至的實體路徑,無論是絕對路徑還是相對路徑。

(繼承來源 Control)
MarkAsDataBound()

將檢視狀態中的控件狀態設定為已成功系結至數據。

(繼承來源 DataBoundControl)
MemberwiseClone()

建立目前 Object的淺層複本。

(繼承來源 Object)
MergeStyle(Style)

將指定樣式的任何非空白項目複製到 Web 控制項,但不會覆寫控件的任何現有樣式專案。 此方法主要是由控制開發人員使用。

(繼承來源 WebControl)
OnBubbleEvent(Object, EventArgs)

判斷伺服器控制件的事件是否已傳遞頁面的 UI 伺服器控制件階層。

(繼承來源 Control)
OnClick(BulletedListEventArgs)

引發 BulletedList 控件的 Click 事件。

OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

引發 CreatingModelDataSource 事件。

(繼承來源 DataBoundControl)
OnDataBinding(EventArgs)

引發 DataBinding 事件。

(繼承來源 ListControl)
OnDataBound(EventArgs)

引發 DataBound 事件。

(繼承來源 BaseDataBoundControl)
OnDataPropertyChanged()

在其中一個基底數據源識別屬性變更之後,將數據綁定控件重新系結至其數據。

(繼承來源 DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

引發 DataSourceViewChanged 事件。

(繼承來源 DataBoundControl)
OnInit(EventArgs)

處理 Init 事件。

(繼承來源 BaseDataBoundControl)
OnLoad(EventArgs)

處理 Load 事件。

(繼承來源 DataBoundControl)
OnPagePreLoad(Object, EventArgs)

在載入控制項之前,設定數據綁定控件的初始化狀態。

(繼承來源 DataBoundControl)
OnPreRender(EventArgs)

引發 PreRender 事件。

(繼承來源 ListControl)
OnSelectedIndexChanged(EventArgs)

引發 SelectedIndexChanged 事件。 這可讓您提供事件的自定義處理程式。

(繼承來源 ListControl)
OnTextChanged(EventArgs)

引發 TextChanged 事件。

(繼承來源 ListControl)
OnUnload(EventArgs)

引發 Unload 事件。

(繼承來源 Control)
OpenFile(String)

取得用來讀取檔案的 Stream

(繼承來源 Control)
PerformDataBinding(IEnumerable)

將指定的數據源系結至衍生自 ListControl 類別的控件。

(繼承來源 ListControl)
PerformSelect()

從相關聯的數據源擷取數據。

(繼承來源 ListControl)
RaiseBubbleEvent(Object, EventArgs)

將事件的任何來源及其資訊指派給控件的父系。

(繼承來源 Control)
RaisePostBackEvent(String)

當表單回傳回伺服器時,引發 BulletedList 控件的事件。

RemovedControl(Control)

Control 物件的 Controls 集合中移除子控件之後呼叫。

(繼承來源 Control)
Render(HtmlTextWriter)

BulletedList 控件內容寫入指定的 HtmlTextWriter 物件,以在用戶端上顯示。

RenderBeginTag(HtmlTextWriter)

將控件的 HTML 開頭標記轉譯為指定的寫入器。 此方法主要是由控制開發人員使用。

(繼承來源 WebControl)
RenderBulletText(ListItem, Int32, HtmlTextWriter)

轉譯 BulletedList 控件中每個清單項目的點符文字。

RenderChildren(HtmlTextWriter)

將伺服器控制件的子系內容輸出至提供的 HtmlTextWriter 物件,以寫入要呈現在用戶端上的內容。

(繼承來源 Control)
RenderContents(HtmlTextWriter)

BulletedList 控件的清單專案,轉譯為指定 HtmlTextWriter的項目符號。

RenderControl(HtmlTextWriter, ControlAdapter)

使用提供的 ControlAdapter 物件,將伺服器控制項內容輸出至提供的 HtmlTextWriter 物件。

(繼承來源 Control)
RenderControl(HtmlTextWriter)

將伺服器控制項內容輸出至提供的 HtmlTextWriter 物件,並在啟用追蹤時儲存控件的追蹤資訊。

(繼承來源 Control)
RenderEndTag(HtmlTextWriter)

將控件的 HTML 結尾標記轉譯成指定的寫入器。 此方法主要是由控制開發人員使用。

(繼承來源 WebControl)
ResolveAdapter()

取得負責轉譯指定控件的控件配接器。

(繼承來源 Control)
ResolveClientUrl(String)

取得瀏覽器可以使用的URL。

(繼承來源 Control)
ResolveUrl(String)

將 URL 轉換成可在要求用戶端上使用的 URL。

(繼承來源 Control)
SaveControlState()

儲存自頁面回傳至伺服器之後發生的任何伺服器控制項狀態變更。

(繼承來源 Control)
SaveViewState()

儲存 ListControl -derived 控件的目前檢視狀態及其包含的專案。

(繼承來源 ListControl)
SetDesignModeState(IDictionary)

設定控制件的設計時間數據。

(繼承來源 Control)
SetPostDataSelection(Int32)

設定張貼頁面之後 ListItem 控件的 Selected 屬性。

(繼承來源 ListControl)
SetRenderMethodDelegate(RenderMethod)

指派事件處理程式委派,將伺服器控件及其內容轉譯成其父控件。

(繼承來源 Control)
SetTraceData(Object, Object, Object)

使用追蹤物件、追蹤數據索引鍵和追蹤數據值,設定轉譯數據的設計時間追蹤數據。

(繼承來源 Control)
SetTraceData(Object, Object)

使用追蹤數據索引鍵和追蹤數據值,設定轉譯數據的設計時間追蹤數據。

(繼承來源 Control)
ToString()

傳回表示目前 物件的字串。

(繼承來源 Object)
TrackViewState()

標記開始追蹤的起點,並將檢視狀態變更儲存至 ListControl -derived 控件。

(繼承來源 ListControl)
ValidateDataSource(Object)

確認數據綁定控件所系結的物件是否為它可以使用的物件。

(繼承來源 DataBoundControl)
VerifyMultiSelect()

判斷清單控制項是否支援多重選取模式。

(繼承來源 ListControl)

事件

CallingDataMethods

發生於呼叫數據方法時。

(繼承來源 DataBoundControl)
Click

發生於單擊 BulletedList 控件中的連結按鈕時。

CreatingModelDataSource

發生於正在建立 ModelDataSource 物件時。

(繼承來源 DataBoundControl)
DataBinding

當伺服器控制項系結至數據源時發生。

(繼承來源 Control)
DataBound

發生在伺服器控制項系結至數據源之後。

(繼承來源 BaseDataBoundControl)
Disposed

發生於從記憶體釋放伺服器控制項時,這是要求 ASP.NET 頁面時伺服器控件生命週期的最後階段。

(繼承來源 Control)
Init

當伺服器控件初始化時發生,這是其生命週期中的第一個步驟。

(繼承來源 Control)
Load

當伺服器控制項載入至 Page 物件時發生。

(繼承來源 Control)
PreRender

發生在載入 Control 物件之後,但在轉譯之前發生。

(繼承來源 Control)
SelectedIndexChanged

當清單控制件的選取範圍在貼文至伺服器之間變更時發生。

(繼承來源 ListControl)
TextChanged

發生於 TextSelectedValue 屬性變更時。

(繼承來源 ListControl)
Unload

發生於伺服器控制件從記憶體卸除時。

(繼承來源 Control)

明確介面實作

IAttributeAccessor.GetAttribute(String)

取得具有指定名稱之 Web 控制件的屬性。

(繼承來源 WebControl)
IAttributeAccessor.SetAttribute(String, String)

將 Web 控制件的屬性設定為指定的名稱和值。

(繼承來源 WebControl)
IControlBuilderAccessor.ControlBuilder

如需此成員的描述,請參閱 ControlBuilder

(繼承來源 Control)
IControlDesignerAccessor.GetDesignModeState()

如需此成員的描述,請參閱 GetDesignModeState()

(繼承來源 Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

如需此成員的描述,請參閱 SetDesignModeState(IDictionary)

(繼承來源 Control)
IControlDesignerAccessor.SetOwnerControl(Control)

如需此成員的描述,請參閱 SetOwnerControl(Control)

(繼承來源 Control)
IControlDesignerAccessor.UserData

如需此成員的描述,請參閱 UserData

(繼承來源 Control)
IDataBindingsAccessor.DataBindings

如需此成員的描述,請參閱 DataBindings

(繼承來源 Control)
IDataBindingsAccessor.HasDataBindings

如需此成員的描述,請參閱 HasDataBindings

(繼承來源 Control)
IExpressionsAccessor.Expressions

如需此成員的描述,請參閱 Expressions

(繼承來源 Control)
IExpressionsAccessor.HasExpressions

如需此成員的描述,請參閱 HasExpressions

(繼承來源 Control)
IParserAccessor.AddParsedSubObject(Object)

如需此成員的描述,請參閱 AddParsedSubObject(Object)

(繼承來源 Control)
IPostBackEventHandler.RaisePostBackEvent(String)

如需此方法的描述,請參閱 RaisePostBackEvent(String)

擴充方法

EnablePersistedSelection(BaseDataBoundControl)
已淘汰.

可讓選取專案保存在支持選取和分頁的數據控件中。

FindDataSourceControl(Control)

傳回與指定控件之數據控件相關聯的數據源。

FindFieldTemplate(Control, String)

傳回指定控件命名容器中指定數據行的欄位範本。

FindMetaTable(Control)

傳回包含數據控制件的中繼資料表物件。

適用於

另請參閱