DeclarativeCatalogPart 類別

參考

定義

命名空間:: System.Web.UI.WebControls.WebParts

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

可讓開發人員將 WebPart 的目錄或其他伺服器控制項加入宣告式、頁面持續性格式的網頁中。此類別無法獲得繼承。

public ref class DeclarativeCatalogPart sealed : System::Web::UI::WebControls::WebParts::CatalogPart

public sealed class DeclarativeCatalogPart : System.Web.UI.WebControls.WebParts.CatalogPart

type DeclarativeCatalogPart = class
    inherit CatalogPart

Public NotInheritable Class DeclarativeCatalogPart
Inherits CatalogPart

繼承: Object

Control

WebControl

Panel

Part

CatalogPart
DeclarativeCatalogPart

範例

下列程式碼範例示範如何在網頁上以宣告方式使用 DeclarativeCatalogPart 控制項。此範例有四個部分：

使用者控制項，可讓您變更網頁元件頁面上的顯示模式。
包含 CatalogZone 控制項和控制項的 DeclarativeCatalogPart 網頁。
包含兩個自訂 WebPart 控制項的原始程式碼檔案。
說明當您在瀏覽器中載入頁面時，此範例的運作方式。

此程式碼範例的第一個部分是使用者控制項，可讓您變更頁面上的顯示模式。如需此控制項中顯示模式和原始程式碼描述的詳細資訊，請參閱逐步解說：變更網頁元件頁面上的顯示模式。

<%@ control language="C#" classname="DisplayModeMenuCS"%>
<script runat="server">
  
 // Use a field to reference the current WebPartManager.
  WebPartManager _manager;

  void Page_Init(object sender, EventArgs e)
  {
    Page.InitComplete += new EventHandler(InitComplete);
    
  }  

  void InitComplete(object sender, System.EventArgs e)
  {
    _manager = WebPartManager.GetCurrentWebPartManager(Page);

    String browseModeName = WebPartManager.BrowseDisplayMode.Name;

    // Fill the dropdown with the names of supported display modes.
    foreach (WebPartDisplayMode mode in _manager.SupportedDisplayModes)
    {
      String modeName = mode.Name;
      // Make sure a mode is enabled before adding it.
      if (mode.IsEnabled(_manager))
      {
        ListItem item = new ListItem(modeName, modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

    // If shared scope is allowed for this user, display the scope-switching
    // UI and select the appropriate radio button for the current user scope.
    if (_manager.Personalization.CanEnterSharedScope)
    {
      Panel2.Visible = true;
      if (_manager.Personalization.Scope == PersonalizationScope.User)
        RadioButton1.Checked = true;
      else
        RadioButton2.Checked = true;
    }
    
  }
 
  // Change the page to the selected display mode.
  void DisplayModeDropdown_SelectedIndexChanged(object sender, EventArgs e)
  {
    String selectedMode = DisplayModeDropdown.SelectedValue;

    WebPartDisplayMode mode = _manager.SupportedDisplayModes[selectedMode];
    if (mode != null)
      _manager.DisplayMode = mode;
  }

  // Set the selected item equal to the current display mode.
  void Page_PreRender(object sender, EventArgs e)
  {
    ListItemCollection items = DisplayModeDropdown.Items;
    int selectedIndex = 
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name));
    DisplayModeDropdown.SelectedIndex = selectedIndex;
  }

  // Reset all of a user's personalization data for the page.
  protected void LinkButton1_Click(object sender, EventArgs e)
  {
    _manager.Personalization.ResetPersonalizationState();
  }

  // If not in User personalization scope, toggle into it.
  protected void RadioButton1_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.Scope == PersonalizationScope.Shared)
      _manager.Personalization.ToggleScope();
  }

  // If not in Shared scope, and if user is allowed, toggle the scope.
  protected void RadioButton2_CheckedChanged(object sender, EventArgs e)
  {
    if (_manager.Personalization.CanEnterSharedScope && 
        _manager.Personalization.Scope == PersonalizationScope.User)
      _manager.Personalization.ToggleScope();
  }
</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

<%@ control language="vb" classname="DisplayModeMenuVB"%>
<script runat="server">
  ' Use a field to reference the current WebPartManager.
  Dim _manager As WebPartManager

  Sub Page_Init(ByVal sender As Object, ByVal e As EventArgs)
    AddHandler Page.InitComplete, AddressOf InitComplete
  End Sub

  Sub InitComplete(ByVal sender As Object, ByVal e As System.EventArgs)
    _manager = WebPartManager.GetCurrentWebPartManager(Page)
      
    Dim browseModeName As String = WebPartManager.BrowseDisplayMode.Name
      
    ' Fill the dropdown with the names of supported display modes.
    Dim mode As WebPartDisplayMode
    For Each mode In _manager.SupportedDisplayModes
      Dim modeName As String = mode.Name
      ' Make sure a mode is enabled before adding it.
      If mode.IsEnabled(_manager) Then
        Dim item As New ListItem(modeName, modeName)
        DisplayModeDropdown.Items.Add(item)
      End If
    Next mode
      
    ' If shared scope is allowed for this user, display the scope-switching
    ' UI and select the appropriate radio button for the current user scope.
    If _manager.Personalization.CanEnterSharedScope Then
      Panel2.Visible = True
      If _manager.Personalization.Scope = PersonalizationScope.User Then
        RadioButton1.Checked = True
      Else
        RadioButton2.Checked = True
      End If
    End If
   
  End Sub

  ' Change the page to the selected display mode.
  Sub DisplayModeDropdown_SelectedIndexChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    Dim selectedMode As String = DisplayModeDropdown.SelectedValue   
    Dim mode As WebPartDisplayMode = _
      _manager.SupportedDisplayModes(selectedMode)
    If Not (mode Is Nothing) Then
      _manager.DisplayMode = mode
    End If

  End Sub
   
  ' Set the selected item equal to the current display mode.
  Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs)
    Dim items As ListItemCollection = DisplayModeDropdown.Items
    Dim selectedIndex As Integer = _
      items.IndexOf(items.FindByText(_manager.DisplayMode.Name))
    DisplayModeDropdown.SelectedIndex = selectedIndex

  End Sub

  ' Reset all of a user's personalization data for the page.
  Protected Sub LinkButton1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    _manager.Personalization.ResetPersonalizationState()
    
  End Sub

  ' If not in User personalization scope, toggle into it.
  Protected Sub RadioButton1_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.Scope = PersonalizationScope.Shared Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub
   
  ' If not in Shared scope, and if user is allowed, toggle the scope.
  Protected Sub RadioButton2_CheckedChanged(ByVal sender As Object, _
    ByVal e As EventArgs)
    
    If _manager.Personalization.CanEnterSharedScope AndAlso _
      _manager.Personalization.Scope = PersonalizationScope.User Then
      _manager.Personalization.ToggleScope()
    End If

  End Sub

</script>
<div>
  <asp:Panel ID="Panel1" runat="server" 
    Borderwidth="1" 
    Width="230" 
    BackColor="lightgray"
    Font-Names="Verdana, Arial, Sans Serif" >
    <asp:Label ID="Label1" runat="server" 
      Text=" Display Mode" 
      Font-Bold="true"
      Font-Size="8"
      Width="120" 
      AssociatedControlID="DisplayModeDropdown"/>
    <asp:DropDownList ID="DisplayModeDropdown" runat="server"  
      AutoPostBack="true" 
      Width="120"
      OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
    <asp:LinkButton ID="LinkButton1" runat="server"
      Text="Reset User State" 
      ToolTip="Reset the current user's personalization data for the page."
      Font-Size="8" 
      OnClick="LinkButton1_Click" />
    <asp:Panel ID="Panel2" runat="server" 
      GroupingText="Personalization Scope"
      Font-Bold="true"
      Font-Size="8" 
      Visible="false" >
      <asp:RadioButton ID="RadioButton1" runat="server" 
        Text="User" 
        AutoPostBack="true"
        GroupName="Scope" OnCheckedChanged="RadioButton1_CheckedChanged" />
      <asp:RadioButton ID="RadioButton2" runat="server" 
        Text="Shared" 
        AutoPostBack="true"
        GroupName="Scope" 
        OnCheckedChanged="RadioButton2_CheckedChanged" />
    </asp:Panel>
  </asp:Panel>
</div>

程式碼範例的第二個部分是網頁。頁面頂端有兩 Register 個指示詞，一個用於使用者控制項，另一個用於包含兩個自訂 WebPart 控制項的已編譯元件。請注意，頁面具有控制項的 DeclarativeCatalogPart 宣告式參考，巢狀于宣告式元素的適當階層內，如本主題一節所述。元素 <asp:declarativecatalogpart> 包含 <webpartstemplate> 元素，接著包含標準 ASP.NET Calendar 控制項和兩個自訂 WebPart 控制項的參考;這些是使用者可以從目錄中選取的控制項。頁面也包含編輯功能，其中包含 PropertyGridEditorPart 在頁面上宣告的控制項。此控制項可讓使用者在自訂控制項新增至頁面之後，以及在使用者將頁面切換為編輯模式之後，編輯自訂 WebPart 控制項上的特定屬性。

<%@ page language="c#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="UserInfoWebPartCS" %>

<!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 id="Head1" runat="server">
    <title>
      DeclarativeCatalogPart Control
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server"  />
      <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" runat="server" >
        <PartTitleStyle BorderWidth="1" 
          Font-Names="Verdana, Arial"
          Font-Size="110%"
          BackColor="LightBlue" />
        <zonetemplate>
          <asp:BulletedList ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink"
            Title="Favorites">
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>
        </zonetemplate>
      </asp:webpartzone> 
      <asp:CatalogZone ID="CatalogZone1" runat="server">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1"  
            runat="server" 
            Title="Web Parts Catalog"
            ChromeType="TitleOnly" 
            Description="Contains a user control with Web Parts and 
              an ASP.NET Calendar control.">
            <WebPartsTemplate>
              <asp:Calendar ID="Calendar1" runat="server" 
                Title="My Calendar" 
                Description="ASP.NET Calendar control used as a personal calendar." />
              <aspSample:UserInfoWebPart 
                runat="server"   
                id="userinfo1" 
                title = "User Information WebPart"
                Description ="Contains custom, editable user information 
                  for display on a page." />
              <aspSample:TextDisplayWebPart 
                runat="server"   
                id="TextDisplayWebPart1" 
                title = "Text Display WebPart" 
                Description="Contains a label that users can dynamically update." />
            </WebPartsTemplate>              
          </asp:DeclarativeCatalogPart>
        </ZoneTemplate>
      </asp:CatalogZone>
      <asp:EditorZone ID="EditorZone1" runat="server">
      <ZoneTemplate>
        <asp:PropertyGridEditorPart ID="PropertyGridEditorPart1" runat="server" />
      </ZoneTemplate>
      </asp:EditorZone> 
    </form>
  </body>
</html>

<%@ page language="VB" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="UserInfoWebPartVB" %>

<!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>
      DeclarativeCatalogPart Control
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server"  />
      <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" runat="server" >
        <PartTitleStyle BorderWidth="1" 
          Font-Names="Verdana, Arial"
          Font-Size="110%"
          BackColor="LightBlue" />
        <zonetemplate>
          <asp:BulletedList ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink"
            Title="Favorites">
            <asp:ListItem Value="http://msdn.microsoft.com">
              MSDN
            </asp:ListItem>
            <asp:ListItem Value="http://www.asp.net">
              ASP.NET
            </asp:ListItem>
            <asp:ListItem Value="http://www.msn.com">
              MSN
            </asp:ListItem>
          </asp:BulletedList>
        </zonetemplate>
      </asp:webpartzone> 
      <asp:CatalogZone ID="CatalogZone1" runat="server">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1"  
            runat="server" 
            Title="Web Parts Catalog"
            ChromeType="TitleOnly" 
            Description="Contains a user control with Web Parts and 
              an ASP.NET Calendar control.">
            <WebPartsTemplate>
              <asp:Calendar ID="Calendar1" runat="server" 
                Title="My Calendar" 
                Description="ASP.NET Calendar control used as a personal calendar." />
              <aspSample:UserInfoWebPart 
                runat="server"   
                id="userinfo1" 
                title = "User Information WebPart"
                Description ="Contains custom, editable user information 
                  for display on a page." />
              <aspSample:TextDisplayWebPart 
                runat="server"   
                id="TextDisplayWebPart1" 
                title = "Text Display WebPart" 
                Description="Contains a label that users can dynamically update." />
            </WebPartsTemplate>              
          </asp:DeclarativeCatalogPart>
        </ZoneTemplate>
      </asp:CatalogZone>
      <asp:EditorZone ID="EditorZone1" runat="server">
      <ZoneTemplate>
        <asp:PropertyGridEditorPart ID="PropertyGridEditorPart1" runat="server" />
      </ZoneTemplate>
      </asp:EditorZone> 
    </form>
  </body>
</html>

程式碼範例的第三個部分是兩 WebPart 個控制項的原始程式碼。請注意，這些控制項上的某些屬性會以 WebBrowsable 屬性標示。這可讓 PropertyGridEditorPart 控制項動態產生使用者介面 (UI) ，讓使用者在控制項處於編輯模式時編輯這些屬性。屬性也會以 WebDisplayName 屬性標示，以指定顯示在編輯 UI 中每個控制項旁的標籤文字。

若要執行程式碼範例，您必須編譯此原始程式碼。您可以明確地編譯它，並將產生的元件放在網站的 Bin 資料夾或全域組件快取中。或者，您可以將原始程式碼放在月臺的 App_Code 資料夾中，其將在執行時間動態編譯。如需示範這兩種編譯方法的逐步解說，請參閱逐步解說：開發和使用自訂 Web 服務器控制項。

using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

namespace Samples.AspNet.CS.Controls
{
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class UserInfoWebPart : WebPart
  {
    HttpServerUtility server = HttpContext.Current.Server;
    private String _userNickName = "Add a nickname.";
    private String _userPetName = "Add a pet's name.";
    private DateTime _userSpecialDate = DateTime.Now;
    private Boolean _userIsCurrent = true;
    private JobTypeName _userJobType = JobTypeName.Unselected;
    public enum JobTypeName
    {
      Unselected = 0,
      Support = 1,
      Service = 2,
      Professional = 3, 
      Technical = 4,
      Manager = 5,
      Executive = 6
    }
    Label NickNameLabel;
    Label PetNameLabel;
    Label SpecialDateLabel;
    CheckBox IsCurrentCheckBox;
    Label JobTypeLabel;

    // Add the Personalizable and WebBrowsable attributes to the  
    // public properties, so that users can save property values  
    // and edit them with a PropertyGridEditorPart control.
    [Personalizable(), WebBrowsable, WebDisplayName("Nickname")]
    public String NickName
    {
      get 
      { 
        object o = ViewState["NickName"];
        if (o != null)
          return (string)o;
        else
          return _userNickName;        
      } 

      set { _userNickName = server.HtmlEncode(value); }
    }

    [Personalizable(), WebBrowsable, WebDisplayName("Pet Name")]
    public String PetName
    {
      get 
      { 
        object o = ViewState["PetName"];
        if (o != null)
          return (string)o;
        else
          return _userPetName;        
      }

      set { _userPetName = server.HtmlEncode(value); }
    }

    [Personalizable(), WebBrowsable(), WebDisplayName("Special Day")]
    public DateTime SpecialDay
    {
      get
      {
        object o = ViewState["SpecialDay"];
        if (o != null)
          return (DateTime)o;
        else
          return _userSpecialDate;
      }

      set { _userSpecialDate = value; }
    }

    [Personalizable(), WebBrowsable(), WebDisplayName("Job Type")]
    public JobTypeName UserJobType
    {
      get
      {
        object o = ViewState["UserJobType"];
        if (o != null)
          return (JobTypeName)o;
        else
          return _userJobType;
      }

      set { _userJobType = (JobTypeName)value; }
    }

    [Personalizable(), WebBrowsable(), WebDisplayName("Is Current")]
    public Boolean IsCurrent
    {
      get
      {
        object o = ViewState["IsCurrent"];
        if (o != null)
          return (Boolean)o;
        else
          return _userIsCurrent;
      }

      set { _userIsCurrent = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();

      NickNameLabel = new Label();
      NickNameLabel.Text = this.NickName;
      SetControlAttributes(NickNameLabel);

      PetNameLabel = new Label();
      PetNameLabel.Text = this.PetName;
      SetControlAttributes(PetNameLabel);

      SpecialDateLabel = new Label();
      SpecialDateLabel.Text = this.SpecialDay.ToShortDateString();
      SetControlAttributes(SpecialDateLabel);

      IsCurrentCheckBox = new CheckBox();
      IsCurrentCheckBox.Checked = this.IsCurrent;
      SetControlAttributes(IsCurrentCheckBox);

      JobTypeLabel = new Label();
      JobTypeLabel.Text = this.UserJobType.ToString();
      SetControlAttributes(JobTypeLabel);

      ChildControlsCreated = true;
    }

    private void SetControlAttributes(WebControl ctl)
    {
      ctl.BackColor = Color.White;
      ctl.BorderWidth = 1;
      ctl.Width = 200;
      this.Controls.Add(ctl);
    }

    protected override void RenderContents(HtmlTextWriter writer)
    {
      writer.Write("Nickname:");
      writer.WriteBreak();
      NickNameLabel.RenderControl(writer);
      writer.WriteBreak();
      writer.Write("Pet Name:");
      writer.WriteBreak();
      PetNameLabel.RenderControl(writer);
      writer.WriteBreak();
      writer.Write("Special Date:");
      writer.WriteBreak();
      SpecialDateLabel.RenderControl(writer);
      writer.WriteBreak();
      writer.Write("Job Type:");
      writer.WriteBreak();
      JobTypeLabel.RenderControl(writer);
      writer.WriteBreak();
      writer.Write("Current:");
      writer.WriteBreak();
      IsCurrentCheckBox.RenderControl(writer);
    }
  }

  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class TextDisplayWebPart : WebPart
  {
    private String _contentText = null;
    TextBox input;
    Label DisplayContent;
    Literal lineBreak;

    [Personalizable(), WebBrowsable]
    public String ContentText
    {
      get { return _contentText; }
      set { _contentText = value; }
    }

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      this.Controls.Add(DisplayContent);

      lineBreak = new Literal();
      lineBreak.Text = @"<br />";
      Controls.Add(lineBreak);

      input = new TextBox();
      this.Controls.Add(input);
      Button update = new Button();
      update.Text = "Set Label Content";
      update.Click += new EventHandler(this.submit_Click);
      this.Controls.Add(update);
    }

    private void submit_Click(object sender, EventArgs e)
    {
      // Update the label string.
      if (!string.IsNullOrEmpty(input.Text))
      {
        _contentText = input.Text + @"<br />";
        input.Text = String.Empty;
        DisplayContent.Text = this.ContentText;
      }
    }
  }
}

Imports System.Collections
Imports System.ComponentModel
Imports System.Drawing
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.WebControls.WebParts

Namespace Samples.AspNet.VB.Controls

  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class UserInfoWebPart
    Inherits WebPart
    Private server As HttpServerUtility = HttpContext.Current.Server
    Private _userNickName As String = "Add a nickname."
    Private _userPetName As String = "Add a pet's name."
    Private _userSpecialDate As DateTime = DateTime.Now
    Private _userIsCurrent As [Boolean] = True
    Private _userJobType As JobTypeName = JobTypeName.Unselected

    Public Enum JobTypeName
      Unselected = 0
      Support = 1
      Service = 2
      Professional = 3
      Technical = 4
      Manager = 5
      Executive = 6
    End Enum

    Private NickNameLabel As Label
    Private PetNameLabel As Label
    Private SpecialDateLabel As Label
    Private IsCurrentCheckBox As CheckBox
    Private JobTypeLabel As Label

    ' Add the Personalizable and WebBrowsable attributes to the  
    ' public properties, so that users can save property values  
    ' and edit them with a PropertyGridEditorPart control.

    <Personalizable(), WebBrowsable(), WebDisplayName("Nickname")> _
    Public Property NickName() As String
      Get
        Dim o As Object = ViewState("NickName")
        If Not (o Is Nothing) Then
          Return CStr(o)
        Else
          Return _userNickName
        End If
      End Get
      Set(ByVal value As String)
        _userNickName = server.HtmlEncode(value)
      End Set
    End Property

    <Personalizable(), WebBrowsable(), WebDisplayName("Pet Name")> _
    Public Property PetName() As String
      Get
        Dim o As Object = ViewState("PetName")
        If Not (o Is Nothing) Then
          Return CStr(o)
        Else
          Return _userPetName
        End If
      End Get
      Set(ByVal value As String)
        _userPetName = server.HtmlEncode(value)
      End Set
    End Property

    <Personalizable(), WebBrowsable(), WebDisplayName("Special Day")> _
    Public Property SpecialDay() As DateTime
      Get
        Dim o As Object = ViewState("SpecialDay")
        If Not (o Is Nothing) Then
          Return CType(o, DateTime)
        Else
          Return _userSpecialDate
        End If
      End Get

      Set(ByVal value As DateTime)
        _userSpecialDate = value
      End Set
    End Property

    <Personalizable(), WebBrowsable(), WebDisplayName("Job Type")> _
    Public Property UserJobType() As JobTypeName
      Get
        Dim o As Object = ViewState("UserJobType")
        If Not (o Is Nothing) Then
          Return CType(o, JobTypeName)
        Else
          Return _userJobType
        End If
      End Get
      Set(ByVal value As JobTypeName)
        _userJobType = CType(value, JobTypeName)
      End Set
    End Property

    <Personalizable(), WebBrowsable(), WebDisplayName("Is Current")> _
    Public Property IsCurrent() As [Boolean]
      Get
        Dim o As Object = ViewState("IsCurrent")
        If Not (o Is Nothing) Then
          Return CType(o, [Boolean])
        Else
          Return _userIsCurrent
        End If
      End Get
      Set(ByVal value As [Boolean])
        _userIsCurrent = value
      End Set
    End Property

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()

      NickNameLabel = New Label()
      NickNameLabel.Text = Me.NickName
      SetControlAttributes(NickNameLabel)

      PetNameLabel = New Label()
      PetNameLabel.Text = Me.PetName
      SetControlAttributes(PetNameLabel)

      SpecialDateLabel = New Label()
      SpecialDateLabel.Text = Me.SpecialDay.ToShortDateString()
      SetControlAttributes(SpecialDateLabel)

      IsCurrentCheckBox = New CheckBox()
      IsCurrentCheckBox.Checked = Me.IsCurrent
      SetControlAttributes(IsCurrentCheckBox)

      JobTypeLabel = New Label()
      JobTypeLabel.Text = Me.UserJobType.ToString()
      SetControlAttributes(JobTypeLabel)

      ChildControlsCreated = True

    End Sub

    Private Sub SetControlAttributes(ByVal ctl As WebControl)
      ctl.BackColor = Color.White
      ctl.BorderWidth = 1
      ctl.Width = 200
      Me.Controls.Add(ctl)
    End Sub

    Protected Overrides Sub RenderContents(ByVal writer As HtmlTextWriter)
      writer.Write("Nickname:")
      writer.WriteBreak()
      NickNameLabel.RenderControl(writer)
      writer.WriteBreak()
      writer.Write("Pet Name:")
      writer.WriteBreak()
      PetNameLabel.RenderControl(writer)
      writer.WriteBreak()
      writer.Write("Special Date:")
      writer.WriteBreak()
      SpecialDateLabel.RenderControl(writer)
      writer.WriteBreak()
      writer.Write("Job Type:")
      writer.WriteBreak()
      JobTypeLabel.RenderControl(writer)
      writer.WriteBreak()
      writer.Write("Current:")
      writer.WriteBreak()
      IsCurrentCheckBox.RenderControl(writer)

    End Sub

  End Class


  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class TextDisplayWebPart
    Inherits WebPart
    Private _contentText As String = Nothing
    Private _fontStyle As String = Nothing
    Private input As TextBox
    Private DisplayContent As Label
    Private lineBreak As Literal

    <Personalizable(), WebBrowsable()> _
    Public Property ContentText() As String
      Get
        Return _contentText
      End Get
      Set(ByVal value As String)
        _contentText = value
      End Set
    End Property

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      DisplayContent.BackColor = Color.LightBlue
      DisplayContent.Text = Me.ContentText
      Me.Controls.Add(DisplayContent)

      lineBreak = New Literal()
      lineBreak.Text = "<br />"
      Controls.Add(lineBreak)

      input = New TextBox()
      Me.Controls.Add(input)
      Dim update As New Button()
      update.Text = "Set Label Content"
      AddHandler update.Click, AddressOf Me.submit_Click
      Me.Controls.Add(update)

    End Sub

    Private Sub submit_Click(ByVal sender As Object, _
                             ByVal e As EventArgs)
      ' Update the label string.
      If input.Text <> String.Empty Then
        _contentText = input.Text + "<br />"
        input.Text = String.Empty
        DisplayContent.Text = Me.ContentText
      End If

    End Sub

  End Class

End Namespace

當您在瀏覽器中載入頁面時，請在 [顯示模式] 下拉式清單控制項中選取[目錄模式] 以切換至目錄模式。在目錄模式中，您可以看到可用來新增至頁面的控制項。新增這三個控制項，然後使用 [ 顯示模式 ] 下拉式清單，將頁面傳回瀏覽模式。這三個控制項會出現在頁面上。如果您使用 [顯示模式 ] 下拉式清單，並將頁面切換為編輯模式，您可以按一下動詞功能表， (使用者資訊 WebPart 控制項標題列中的向下箭號) ，然後按一下 [ 編輯 ] 來編輯控制項。當編輯 UI 可見時，您可以看到 PropertyGridEditorPart 控制項。請注意，控制項會針對標示屬性之類別 WebBrowsable 的每個屬性 UserInfoWebPart 轉譯。如果您在編輯 UI 中進行一些變更，然後按一下 [ 套用] 按鈕，您可以使用 [ 顯示模式 ] 下拉式清單傳回頁面以瀏覽模式，並查看編輯變更的完整效果。

備註

就像 Web 元件控制項集中有工具導向區域 (一樣，如需詳細資訊，請參閱 ToolZone 類別概觀) 、有工具導向 Part 控制項，而且每個控制項都必須位於特定類型的工具區域中。 Web 元件控制項集中的工具導向元件控制項有兩個區別特性：

它們是協助程式控制項，可讓使用者個人化網頁元件頁面上的控制項。
它們只會在特定顯示模式中顯示。

DeclarativeCatalogPart 是必須位於 CatalogZoneBase 某個區域的元件控制項，例如 CatalogZone Web 元件控制項集所提供的區域。 DeclarativeCatalogPart只有當網頁處於目錄顯示模式時，控制項才會變成可見。

控制項 DeclarativeCatalogPart 提供一種方式，讓開發人員以宣告方式將一組伺服器控制項新增至網頁上的目錄。網頁元件控制項集中的目錄只是頁面處於目錄顯示模式時可見的其他伺服器控制項清單 WebPart 。使用者可以從清單中選取控制項，並將其新增至網頁，這可有效地讓使用者變更一組控制項和頁面上的功能。

注意

使用者可以將目錄中相同控制項的多個實例新增至網頁。

使用 DeclarativeCatalogPart 控制項來建立伺服器控制項目錄的優點是它不需要任何程式碼。頁面開發人員可以完全使用宣告式 (或頁面持續性) 格式的控制項，因此控制項的名稱。

控制項 DeclarativeCatalogPart 具有實用的屬性，可讓開發人員設定整個網站中可使用的控制項目錄。開發人員可以在控制項內 DeclarativeCatalogPart 宣告個別伺服器控制項，而是可以將屬性值設定 WebPartsListUserControlPath 為使用者控制項的路徑，其中包含應該在目錄中的伺服器控制項清單。在執行時間，使用者控制項中所參考的伺服器控制項會載入目錄中。如此一來，多個頁面或網站就可以參考相同的使用者控制項來建立目錄。當使用者控制項的伺服器控制項清單更新時，它會根據使用者控制項更新所有目錄。

類別 DeclarativeCatalogPart 具有數個可覆寫繼承屬性的公用屬性。大部分的屬性實際上不會用於轉譯控制項;它們只會被覆寫，因此可以在它們上設定特殊程式碼屬性，以從 Microsoft Visual Studio 2005 等設計工具中隱藏它們。您不應該使用這些隱藏屬性，因為它們不會影響轉譯。他們從 IntelliSense 和 Visual Studio 的 [屬性] 窗格隱藏的事實，可協助開發人員避免誤用它們。所有這些隱藏屬性都會在其各自的說明主題中加以說明。

類別 DeclarativeCatalogPart 也有數種方法。方法 GetAvailableWebPartDescriptions 會 WebPartDescription 擷取目錄中每個 WebPart 控制項的物件，這可讓 DeclarativeCatalogPart 控制項顯示每個伺服器控制項的相關資訊，而不需要建立它的實例。另一個方法是方法 GetWebPart 。這個方法會根據傳遞給方法的描述，取得特定 WebPart 控制項的實例。

注意

為了改善協助工具， DeclarativeCatalogPart 控制項會在元素內 <fieldset> 呈現。元素會將 <fieldset> 用於在控制項中 DeclarativeCatalogPart 編輯的相關控制項集分組，並有助於在視覺使用者代理程式 ( (這些控制項之間進行索引標籤式流覽，例如一般網頁瀏覽器) 和語音導向使用者代理程式， (例如螢幕閱讀軟體) 。

建構函式

DeclarativeCatalogPart()

初始化類別的新執行個體。

屬性

AccessKey	呈現 DeclarativeCatalogPart 控制項時，設定的 Web 組件控制項不會使用這個繼承屬性。屬性只會為了防止它出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
Adapter	針對控制項取得瀏覽器的特定配置器。 (繼承來源 Control)
AppRelativeTemplateSourceDirectory	取得或設定包含了此控制項之 Page 或 UserControl 物件的相對應用程式虛擬目錄。 (繼承來源 Control)
Attributes	取得任意屬性 (Attribute) 的集合 (只供呈現)，不與控制項上的屬性 (Property) 對應。 (繼承來源 WebControl)
BackColor	DeclarativeCatalogPart 控制項不使用這個繼承屬性。屬性只會為了防止它出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
BackImageUrl	呈現 DeclarativeCatalogPart 控制項時，設定的 Web 組件控制項不會使用這個繼承屬性。屬性只會為了防止它出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
BindingContainer	取得包含了此控制項之資料繫結的控制項。 (繼承來源 Control)
BorderColor	DeclarativeCatalogPart 控制項不使用這個繼承屬性。屬性只會為了防止它出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
BorderStyle	DeclarativeCatalogPart 控制項不使用這個繼承屬性。屬性只會為了防止它出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
BorderWidth	DeclarativeCatalogPart 控制項不使用這個繼承屬性。屬性只會為了防止它出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
ChildControlsCreated	取得值，指出是否已經建立伺服器控制項的子控制項。 (繼承來源 Control)
ChromeState	取得或設定組件控制項是否為最小化或一般狀態。 (繼承來源 Part)
ChromeType	取得或設定圍繞著 Web 組件控制項的框線類型。 (繼承來源 Part)
ClientID	取得 ASP.NET 所產生之 HTML 標記的控制項識別碼。 (繼承來源 Control)
ClientIDMode	取得或設定用來產生 ClientID 屬性值的演算法。 (繼承來源 Control)
ClientIDSeparator	取得字元值，表示在 ClientID 屬性中所使用的分隔字元。 (繼承來源 Control)
Context	取得與目前 Web 要求的伺服器控制項關聯的 HttpContext 物件。 (繼承來源 Control)
Controls	取得 ControlCollection 物件，其包含使用者介面階層架構中所指定伺服器控制項的子控制項。 (繼承來源 Part)
ControlStyle	取得 Web 伺服器控制項的樣式。這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl)
ControlStyleCreated	取得值，指出 Style 物件是否已經為 ControlStyle 屬性建立。這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl)
CssClass	DeclarativeCatalogPart 控制項不使用這個繼承屬性。屬性只會為了防止它出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
DataItemContainer	如果命名容器實作 IDataItemContainer，則取得命名容器的參考。 (繼承來源 Control)
DataKeysContainer	如果命名容器實作 IDataKeysControl，則取得命名容器的參考。 (繼承來源 Control)
DefaultButton	DeclarativeCatalogPart 控制項不使用這個繼承屬性。屬性只會為了防止它出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
Description	取得或設定摘要說明組件控制項功能的簡短片語，用於組件控制項的工具提示和資料目錄。 (繼承來源 Part)
DesignMode	取得值，指出控制項是否正用於設計介面上。 (繼承來源 Control)
Direction	DeclarativeCatalogPart 控制項不使用這個繼承屬性。屬性只會為了防止它出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
DisplayTitle	取得字串，該字串包含 CatalogPart 控制項的實際目前標題。 (繼承來源 CatalogPart)
Enabled	DeclarativeCatalogPart 控制項不使用這個繼承屬性。屬性只會為了防止它出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
EnableTheming	DeclarativeCatalogPart 控制項不使用這個繼承屬性。屬性只會為了防止它出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
EnableViewState	取得或設定值，該值表示伺服器控制項是否對要求的用戶端而言保持其檢視狀態，以及它包含的任何子控制項狀態。 (繼承來源 Control)
Events	取得控制項事件處理常式委派 (Delegate) 的清單。這個屬性是唯讀的。 (繼承來源 Control)
Font	DeclarativeCatalogPart 控制項不使用這個繼承屬性。屬性只會為了防止它出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
ForeColor	DeclarativeCatalogPart 控制項不使用這個繼承屬性。屬性只會為了防止它出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
GroupingText	DeclarativeCatalogPart 控制項不使用這個繼承屬性。屬性只會為了防止它出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
HasAttributes	取得值，指出控制項是否已經設定屬性。 (繼承來源 WebControl)
HasChildViewState	取得值，指出目前伺服器控制項的子控制項是否有任何已儲存的檢視狀態設定。 (繼承來源 Control)
Height	DeclarativeCatalogPart 控制項不使用這個繼承屬性。屬性只會為了防止它出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
HorizontalAlign	DeclarativeCatalogPart 控制項不使用這個繼承屬性。僅為了防止屬性出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
ID	取得或設定指派給伺服器控制項的程式設計識別項。 (繼承來源 Control)
IdSeparator	取得用來分隔控制項識別項的字元。 (繼承來源 Control)
IsChildControlStateCleared	取得值，指出這個控制項中所包含的控制項是否有控制項狀態。 (繼承來源 Control)
IsEnabled	取得值，指出是否啟用控制項。 (繼承來源 WebControl)
IsTrackingViewState	取得值，指出伺服器控制項是否正在儲存檢視狀態的變更。 (繼承來源 Control)
IsViewStateEnabled	取得值，指出這個控制項是否已啟用檢視狀態。 (繼承來源 Control)
LoadViewStateByID	取得值，指出控制項是否依 ID (而不是索引) 參與載入其檢視狀態。 (繼承來源 Control)
NamingContainer	取得伺服器控制項命名容器的參考，其建立唯一命名空間，在具有相同 ID 屬性值的伺服器控制項之間作區別。 (繼承來源 Control)
Page	取得含有伺服器控制項的 Page 執行個體的參考。 (繼承來源 Control)
Parent	在網頁控制階層架構中取得伺服器控制項之父控制項的參考。 (繼承來源 Control)
RenderingCompatibility	取得值，這個值會指定將與呈現 HTML 相容的 ASP.NET 版本。 (繼承來源 Control)
ScrollBars	DeclarativeCatalogPart 控制項不使用這個繼承屬性。僅為了防止屬性出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
Site	當呈現在設計介面上時，取得裝載目前控制項之容器的資訊。 (繼承來源 Control)
SkinID	DeclarativeCatalogPart 控制項不使用這個繼承屬性。僅為了防止屬性出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
Style	取得文字屬性的集合，將呈現為 Web 伺服器控制項的外部標記上的樣式屬性。 (繼承來源 WebControl)
SupportsDisabledAttribute	取得值，這個值表示當控制項的 `disabled` 屬性為 IsEnabled 時，控制項是否應該將呈現之 HTML 項目的 `false` 屬性設為 "disabled"。 (繼承來源 Panel)
TabIndex	DeclarativeCatalogPart 控制項不使用這個繼承屬性。僅為了防止屬性出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
TagKey	取得對應至這個 Web 伺服器控制項的 HtmlTextWriterTag 值。這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl)
TagName	取得控制項標記的名稱。這個屬性主要由控制項開發人員使用。 (繼承來源 WebControl)
TemplateControl	取得或設定包含了此控制項之樣板的參考。 (繼承來源 Control)
TemplateSourceDirectory	取得包含目前伺服器控制項的 Page 或 UserControl 的虛擬目錄。 (繼承來源 Control)
Title	取得或設定顯示在控制項標題列中的標題。
ToolTip	DeclarativeCatalogPart 控制項不使用這個繼承屬性。僅為了防止屬性出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
UniqueID	取得伺服器控制項唯一的、符合階層架構的識別項。 (繼承來源 Control)
ValidateRequestMode	取得或設定值，指出控制項是否對來自瀏覽器的用戶端輸入檢查潛在的危險值。 (繼承來源 Control)
ViewState	取得狀態資訊的字典，允許您在相同網頁的多個要求之間，儲存和還原伺服器控制項的檢視狀態。 (繼承來源 Control)
ViewStateIgnoresCase	取得值，指出 StateBag 物件是否不區分大小寫。 (繼承來源 Control)
ViewStateMode	取得或設定這個控制項的檢視狀態模式。 (繼承來源 Control)
Visible	DeclarativeCatalogPart 控制項不使用這個繼承屬性。僅為了防止屬性出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
WebPartManager	取得 WebPartManager 類別目前執行個體的參考。 (繼承來源 CatalogPart)
WebPartsListUserControlPath	取得或設定使用者控制項的路徑，此控制項包含目錄之 WebPart 或其他伺服器控制項的清單。
WebPartsTemplate	取得或設定樣板的參考，該樣板包含在目錄中宣告的 WebPart 控制項。
Width	DeclarativeCatalogPart 控制項不使用這個繼承屬性。僅為了防止屬性出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
Wrap	DeclarativeCatalogPart 控制項不使用這個繼承屬性。僅為了防止屬性出現在 Microsoft Visual Studio 2005 設計工具中而遭到覆寫。
Zone	取得包含 CatalogZoneBase 控制項之 CatalogPart 區域的參考。 (繼承來源 CatalogPart)

方法

AddAttributesToRender(HtmlTextWriter)	將背景影像、對齊方式、換行和方向的相關資訊加入要呈現的屬性清單中。 (繼承來源 Panel)
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)
CopyBaseAttributes(WebControl)	將不被 Style 物件封裝的屬性從指定的 Web 伺服器控制項複製到呼叫這個方法的 Web 伺服器控制項上。這個方法主要由控制項開發人員使用。 (繼承來源 WebControl)
CreateChildControls()	由 ASP.NET 網頁架構呼叫，通知使用組合實作的伺服器控制項來建立所包含的任何子控制項，以準備回傳或呈現。 (繼承來源 Control)
CreateControlCollection()	建立新的 ControlCollection 物件來保存伺服器控制項的子控制項 (常值和伺服器)。 (繼承來源 Control)
CreateControlStyle()	建立樣式物件，這個物件是由 Panel 控制項在內部使用，以實作所有的樣式相關屬性。 (繼承來源 Panel)
DataBind()	將資料來源繫結至所叫用的伺服器控制項及其所有子控制項。 (繼承來源 Part)
DataBind(Boolean)	使用會引發 DataBinding 事件的選項，繫結資料來源至叫用的伺服器控制項及其所有子控制項。 (繼承來源 Control)
DataBindChildren()	繫結資料來源至伺服器控制項的子控制項。 (繼承來源 Control)
Dispose()	啟用伺服器控制項，在它從記憶體釋放之前執行最後清除。 (繼承來源 Control)
EndRenderTracing(TextWriter, Object)	結束轉譯資料的設計階段追蹤。 (繼承來源 Control)
EnsureChildControls()	判斷伺服器控制項是否包含子控制項。如果不包含，則建立子控制項。 (繼承來源 Control)
EnsureID()	為尚未指定識別項的控制項，建立識別項。 (繼承來源 Control)
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
FindControl(String)	在目前命名容器搜尋具有指定 `id` 參數的伺服器控制項。 (繼承來源 Control)
FindControl(String, Int32)	使用指定的 `id` 和有助於搜尋之 `pathOffset` 參數中所指定的整數，在目前的命名容器中搜尋伺服器控制項。您不應該覆寫這個版本的 FindControl 方法。 (繼承來源 Control)
Focus()	設定控制項的輸入焦點。 (繼承來源 Control)
GetAvailableWebPartDescriptions()	傳回目錄中可用 WebPart 控制項的描述集合。
GetDesignModeState()	擷取 CatalogPart 控制項之父區域的目前狀態。 (繼承來源 CatalogPart)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetRouteUrl(Object)	取得會對應於一組路由參數的 URL。 (繼承來源 Control)
GetRouteUrl(RouteValueDictionary)	取得會對應於一組路由參數的 URL。 (繼承來源 Control)
GetRouteUrl(String, Object)	取得 URL，此 URL 對應於一組路由參數及一個路由名稱。 (繼承來源 Control)
GetRouteUrl(String, RouteValueDictionary)	取得 URL，此 URL 對應於一組路由參數及一個路由名稱。 (繼承來源 Control)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
GetUniqueIDRelativeTo(Control)	傳回指定之控制項 UniqueID 屬性的前置部分。 (繼承來源 Control)
GetWebPart(WebPartDescription)	根據傳入方法中的描述值，傳回 WebPart 控制項的參考。
HasControls()	判斷伺服器控制項是否包含任何子控制項。 (繼承來源 Control)
HasEvents()	傳回值，指出控制項或任何子控制項的事件是否已註冊。 (繼承來源 Control)
IsLiteralContent()	判斷伺服器控制項是否只儲存常值內容。 (繼承來源 Control)
LoadControlState(Object)	從 SaveControlState() 方法所儲存的上一頁要求中，還原控制項狀態資訊。 (繼承來源 Control)
LoadViewState(Object)	從上一個使用 SaveViewState() 方法儲存的要求中，還原檢視狀態資訊。 (繼承來源 WebControl)
MapPathSecure(String)	擷取虛擬絕對路徑或相對路徑所對應至的實體路徑。 (繼承來源 Control)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
MergeStyle(Style)	將指定樣式的任何非空白項目複製到 Web 控制項，但不覆寫控制項的任何現有樣式項目。這個方法主要由控制項開發人員使用。 (繼承來源 WebControl)
OnBubbleEvent(Object, EventArgs)	決定伺服器控制項的事件是否要在頁面的 UI 伺服器控制項階層架構中向上傳遞。 (繼承來源 Control)
OnDataBinding(EventArgs)	引發 DataBinding 事件。 (繼承來源 Control)
OnInit(EventArgs)	引發 Init 事件。 (繼承來源 Control)
OnLoad(EventArgs)	引發 Load 事件。 (繼承來源 Control)
OnPreRender(EventArgs)	引發 PreRender 事件。 (繼承來源 CatalogPart)
OnUnload(EventArgs)	引發 Unload 事件。 (繼承來源 Control)
OpenFile(String)	取得用來讀取檔案的 Stream。 (繼承來源 Control)
RaiseBubbleEvent(Object, EventArgs)	指派事件的任何來源和它的資訊至控制項的父控制項。 (繼承來源 Control)
RemovedControl(Control)	從 Control 物件的 Controls 集合中移除子控制項之後呼叫。 (繼承來源 Control)
Render(HtmlTextWriter)	將控制項呈現在指定的 HTML 寫入器中。 (繼承來源 WebControl)
RenderBeginTag(HtmlTextWriter)	將 Panel 控制項的 HTML 開頭標記呈現在指定的寫入器中。 (繼承來源 Panel)
RenderChildren(HtmlTextWriter)	將伺服器控制項子系的內容輸出至提供的 HtmlTextWriter 物件，再由這個物件在用戶端上寫入要轉譯的內容。 (繼承來源 Control)
RenderContents(HtmlTextWriter)	將控制項的內容呈現在指定的寫入器。這個方法主要由控制項開發人員使用。 (繼承來源 WebControl)
RenderControl(HtmlTextWriter)	將伺服器控制項內容輸出至提供的 HtmlTextWriter 物件，並在啟用追蹤時儲存控制項的追蹤資訊。 (繼承來源 Control)
RenderControl(HtmlTextWriter, ControlAdapter)	使用提供的 HtmlTextWriter 物件，輸出伺服器控制項內容至提供的 ControlAdapter 物件。 (繼承來源 Control)
RenderEndTag(HtmlTextWriter)	將 Panel 控制項的 HTML 結尾標記呈現在指定的寫入器中。 (繼承來源 Panel)
ResolveAdapter()	取得負責呈現指定之控制項的控制項配置器。 (繼承來源 Control)
ResolveClientUrl(String)	取得瀏覽器可使用的 URL。 (繼承來源 Control)
ResolveUrl(String)	將 URL 轉換為要求用戶端可使用的 URL。 (繼承來源 Control)
SaveControlState()	儲存頁面回傳至伺服器以來，所發生的任何伺服器控制項狀態變更。 (繼承來源 Control)
SaveViewState()	儲存叫用 TrackViewState() 方法後已修改的任何狀態。 (繼承來源 WebControl)
SetDesignModeState(IDictionary)	設定控制項的設計階段資料。 (繼承來源 CatalogPart)
SetRenderMethodDelegate(RenderMethod)	指定事件處理常式委派，以呈現伺服器控制項及其內容至其父控制項。 (繼承來源 Control)
SetTraceData(Object, Object)	使用追蹤資料機碼和追蹤資料值，設定設計階段期間追蹤呈現資料的追蹤資料。 (繼承來源 Control)
SetTraceData(Object, Object, Object)	使用追蹤的物體、追蹤資料機碼和追蹤資料值，設定設計階段期間追蹤呈現資料的追蹤資料。 (繼承來源 Control)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
TrackViewState()	讓控制項追蹤其檢視狀態的變更，以便將這些變更儲存在物件的 ViewState 屬性中。 (繼承來源 WebControl)

事件

DataBinding	發生於伺服器控制項繫結至資料來源時。 (繼承來源 Control)
Disposed	發生於伺服器控制項從記憶體釋放時，這是在要求 ASP.NET 網頁時，伺服器控制項生命週期的最後階段。 (繼承來源 Control)
Init	發生於初始化伺服器控制項時，是其生命週期中的第一個步驟。 (繼承來源 Control)
Load	發生於載入伺服器控制項至 Page 物件時。 (繼承來源 Control)
PreRender	在 Control 物件載入之後但在呈現之前發生。 (繼承來源 Control)
Unload	發生於伺服器控制項從記憶體卸載時。 (繼承來源 Control)

明確介面實作

IAttributeAccessor.GetAttribute(String)	使用指定的名稱，取得 Web 控制項的屬性。 (繼承來源 WebControl)
IAttributeAccessor.SetAttribute(String, String)	將 Web 控制項的屬性設定為指定的名稱和值。 (繼承來源 WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	讓複合組件控制項設計工具的開發人員得以在設計介面上重新建立控制項的子控制項。 (繼承來源 Part)
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)

擴充方法

FindDataSourceControl(Control)	傳回與指定之控制項的資料控制項相關聯的資料來源。
FindFieldTemplate(Control, String)	傳回在指定之控制項的命名容器中所指定資料行的欄位樣板。
FindMetaTable(Control)	傳回包含資料控制項的中繼資料表物件。
GetDefaultValues(INamingContainer)	取得所指定資料控制項的預設值集合。
GetMetaTable(INamingContainer)	取得所指定資料控制項中的資料表中繼資料。
SetMetaTable(INamingContainer, MetaTable)	設定所指定資料控制項中的資料表中繼資料。
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	設定所指定資料控制項的資料表中繼資料及預設值對應。
SetMetaTable(INamingContainer, MetaTable, Object)	設定所指定資料控制項的資料表中繼資料及預設值對應。
TryGetMetaTable(INamingContainer, MetaTable)	判斷資料表中繼資料是否可供使用。
EnableDynamicData(INamingContainer, Type)	針對指定的資料控制項啟用動態資料行為。
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	針對指定的資料控制項啟用動態資料行為。
EnableDynamicData(INamingContainer, Type, Object)	針對指定的資料控制項啟用動態資料行為。

適用於

DeclarativeCatalogPart 類別

定義

範例

備註

建構函式

屬性

方法

事件

明確介面實作

擴充方法

適用於

另請參閱

意見反應

其他資源