CatalogZoneBase Kelas

Definisi

Ruang nama:

System.Web.UI.WebControls.WebParts

Rakitan:

System.Web.dll

Berfungsi sebagai kelas dasar untuk semua kontrol zona yang bertindak sebagai katalog. Katalog berisi daftar WebPart kontrol yang bisa ditambahkan pengguna ke halaman Web.

public ref class CatalogZoneBase abstract : System::Web::UI::WebControls::WebParts::ToolZone, System::Web::UI::IPostBackDataHandler

public abstract class CatalogZoneBase : System.Web.UI.WebControls.WebParts.ToolZone, System.Web.UI.IPostBackDataHandler

type CatalogZoneBase = class
    inherit ToolZone
    interface IPostBackDataHandler

Public MustInherit Class CatalogZoneBase
Inherits ToolZone
Implements IPostBackDataHandler

Warisan

Object

Control

WebControl

CompositeControl

WebZone

ToolZone

CatalogZoneBase

Turunan

System.Web.UI.WebControls.WebParts.CatalogZone

Penerapan

IPostBackDataHandler

Contoh

Contoh kode berikut menunjukkan beberapa penggunaan CatalogZoneBase kelas deklaratif dan terprogram. Karena kelasnya abstrak, contoh kode menggunakan kelas turunan CatalogZone yang dikirim dengan set kontrol Bagian Web, menunjukkan properti dan metode yang diwarisinya dari CatalogZoneBase kelas.

Contoh kode memiliki empat bagian:

• Kontrol pengguna yang memungkinkan Anda mengubah mode tampilan pada halaman Web.

• Halaman Web yang berisi referensi ke CatalogZone kontrol, dan beberapa kode yang menunjukkan penggunaan beberapa anggota kelas kunci CatalogZoneBase .

• Kontrol kustom WebPart yang ditambahkan ke kontrol kustom CatalogZone .

• Deskripsi tentang cara kerja contoh di browser.

Bagian pertama dari contoh kode ini adalah kontrol pengguna yang memungkinkan Anda mengubah mode tampilan di halaman. Untuk detail tentang mode tampilan dan deskripsi kode sumber dalam kontrol ini, lihat Panduan: Mengubah Mode Tampilan pada Halaman Bagian Web.

<%@ 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="&nbsp;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="&nbsp;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>

Bagian kedua dari contoh kode adalah halaman Web yang berisi referensi deklaratif ke CatalogZone kontrol. Di dekat bagian atas halaman ada dua Register arahan--satu untuk kontrol pengguna, dan satu untuk kontrol kustom WebPart . Perhatikan bahwa di <asp:WebPartZone> bawah elemen adalah <asp: CatalogZone> elemen yang berisi referensi deklaratif ke kontrol kustom WebPart , dan ke kontrol ASP.NET Calendar . Zona ini juga memiliki berbagai tag dan properti yang diatur untuk menentukan tampilan dan perilakunya. <script> Di antara tag di halaman adalah berbagai kode penanganan peristiwa, yang sebagian besar menunjukkan berbagai penggunaan terprogram anggotaCatalogZoneBase.

<%@ page language="c#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenucs.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="TextDisplayWebPartCS" %>
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  WebPartManager manager;

  protected void WebPartManager1_DisplayModeChanged(object sender,
    WebPartDisplayModeEventArgs e)
  {
    if (e.OldDisplayMode.Name != "Catalog")
      Panel1.Visible = true;
    else
      Panel1.Visible = false;
  }
  
  // <snippet3>
  protected void Button1_Click(object sender, EventArgs e)
  {
    if (CatalogZone1.AddVerb.Enabled)
    {
      CatalogZone1.AddVerb.Enabled = false;
      CatalogZone1.CloseVerb.Enabled = false;
    }
    else
    {
      CatalogZone1.AddVerb.Enabled = true;
      CatalogZone1.CloseVerb.Enabled = true;
    }
  }
  // </snippet3>

  // <snippet4>
  protected void Button2_Click(object sender, EventArgs e)
  {
    Label1.Text = "<h3>CatalogPart List</h3>";
    foreach(CatalogPart part in CatalogZone1.CatalogParts)
    {
      Label1.Text += part.ID + "<br />";
    }
  }
  // </snippet4>

  // <snippet5>
  protected void Button3_Click(object sender, EventArgs e)
  {
    CatalogZone1.SelectTargetZoneText = "Add to zone";
    CatalogZone1.EmptyZoneText = "Zone is empty";
    CatalogZone1.HeaderText = "My Updated Header";
    CatalogZone1.InstructionText = "My Updated Instructions";
  }
  // </snippet5>

  // <snippet6>
  protected void Button4_Click(object sender, EventArgs e)
  {
    Label1.Text = CatalogZone1.SelectedCatalogPartID;
  }
  // </snippet6>

  // <snippet7>
  protected void Button5_Click(object sender, EventArgs e)
  {
    CatalogZone1.PartLinkStyle.ForeColor = System.Drawing.Color.Red;
    CatalogZone1.SelectedPartLinkStyle.ForeColor = 
      System.Drawing.Color.Blue;
  }
  // </snippet7>

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>
      CatalogZoneBase Example
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" 
        OnDisplayModeChanged="WebPartManager1_DisplayModeChanged" />
      <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" runat="server">
        <zonetemplate>
          <asp:BulletedList 
            ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink" 
            Title="Favorite Links" >
            <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"
        EmptyZoneText="No controls are in the zone."
        HeaderText="My Web Parts Catalog"
        InstructionText="Add Web Parts controls to the zone."
        PartLinkStyle-Font-Italic="true"
        SelectedPartLinkStyle-Font-Bold="true"
        SelectTargetZoneText="Select zone"
        AddVerb-Text="Add Control"
        CloseVerb-Description="Close and return to browse mode." 
        SelectedCatalogPartID="Currently Selected CatalogPart ID.">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
            runat="server">
            <WebPartsTemplate>
              <aspSample:TextDisplayWebPart 
                runat="server"   
                id="textwebpart" 
                title = "Text Content WebPart" 
                ExportMode="All"/>  
              <asp:Calendar id="calendar1" runat="server" 
                Title="My Calendar" />               
            </WebPartsTemplate>
          </asp:DeclarativeCatalogPart> 
          <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
          <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
        </ZoneTemplate>
      </asp:CatalogZone>
      <hr />
      <asp:CatalogZone ID="CatalogZone2" runat="server"
        BorderWidth="2"
        HeaderText="My Empty CatalogZone"
        EmptyZoneText="No controls are in the zone." />
      <hr />
      <asp:Panel ID="Panel1" runat="server" Visible="false">
        <asp:Button ID="Button1" runat="server" Width="200" 
          Text="Enable or Disable Verbs" 
          OnClick="Button1_Click" />
        <br />
        <asp:Button ID="Button2" runat="server" Width="200" 
          Text="List CatalogParts" OnClick="Button2_Click" />  
        <br />
        <asp:Button ID="Button3" runat="server" Width="200" 
          Text="Set Zone Text Properties" OnClick="Button3_Click" />  
        <br />   
        <asp:Button ID="Button4" runat="server" Width="200" 
          Text="Show Selected CatalogPart ID" OnClick="Button4_Click"  />  
        <br /> 
        <asp:Button ID="Button5" runat="server" Width="200" 
          Text="Change Part Link Styles" OnClick="Button5_Click"  />  
        <br />     
        <asp:Label ID="Label1" runat="server" Text="" /></asp:Panel>
    </form>
  </body>
</html>

<%@ page language="vb" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuvb.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="TextDisplayWebPartVB" %>
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">


  Dim manager As WebPartManager


  Protected Sub WebPartManager1_DisplayModeChanged(ByVal sender _
    As Object, ByVal e As WebPartDisplayModeEventArgs)
    If e.OldDisplayMode.Name <> "Catalog" Then
      Panel1.Visible = True
    Else
      Panel1.Visible = False
    End If

  End Sub
   
  ' <snippet3>
  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    If CatalogZone1.AddVerb.Enabled Then
      CatalogZone1.AddVerb.Enabled = False
      CatalogZone1.CloseVerb.Enabled = False
    Else
      CatalogZone1.AddVerb.Enabled = True
      CatalogZone1.CloseVerb.Enabled = True
    End If

  End Sub
  ' </snippet3>
  
  ' <snippet4>
  Protected Sub Button2_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    Label1.Text = "<h3>CatalogPart List</h3>"
    Dim part As CatalogPart
    For Each part In CatalogZone1.CatalogParts
      Label1.Text += part.ID + "<br />"
    Next part

  End Sub
  ' </snippet4>
  
  ' <snippet5>
  Protected Sub Button3_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    CatalogZone1.SelectTargetZoneText = "Add to zone"
    CatalogZone1.EmptyZoneText = "Zone is empty"
    CatalogZone1.HeaderText = "My Updated Header"
    CatalogZone1.InstructionText = "My Updated Instructions"
  End Sub
  ' </snippet5>
  
  ' <snippet6>
  Protected Sub Button4_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    Label1.Text = CatalogZone1.SelectedCatalogPartID
  End Sub
  ' </snippet6>
  
  ' <snippet7>
  Protected Sub Button5_Click(ByVal sender As Object, _
    ByVal e As EventArgs)
    CatalogZone1.PartLinkStyle.ForeColor = _
      System.Drawing.Color.Red
    CatalogZone1.SelectedPartLinkStyle.ForeColor = _
      System.Drawing.Color.Blue
  End Sub
  ' </snippet7>
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>
      CatalogZoneBase Example
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" 
        OnDisplayModeChanged="WebPartManager1_DisplayModeChanged" />
      <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" runat="server">
        <zonetemplate>
          <asp:BulletedList 
            ID="BulletedList1" 
            Runat="server"
            DisplayMode="HyperLink" 
            Title="Favorite Links" >
            <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"
        EmptyZoneText="No controls are in the zone."
        HeaderText="My Web Parts Catalog"
        InstructionText="Add Web Parts controls to the zone."
        PartLinkStyle-Font-Italic="true"
        SelectedPartLinkStyle-Font-Bold="true"
        SelectTargetZoneText="Select zone"
        AddVerb-Text="Add Control"
        CloseVerb-Description="Close and return to browse mode." 
        SelectedCatalogPartID="Currently Selected CatalogPart ID.">
        <ZoneTemplate>
          <asp:DeclarativeCatalogPart ID="DeclarativeCatalogPart1" 
            runat="server">
            <WebPartsTemplate>
              <aspSample:TextDisplayWebPart 
                runat="server"   
                id="textwebpart" 
                title = "Text Content WebPart" 
                ExportMode="All"/>  
              <asp:Calendar id="calendar1" runat="server" 
                Title="My Calendar" />               
            </WebPartsTemplate>
          </asp:DeclarativeCatalogPart> 
          <asp:PageCatalogPart ID="PageCatalogPart1" runat="server" />
          <asp:ImportCatalogPart ID="ImportCatalogPart1" runat="server" /> 
        </ZoneTemplate>
      </asp:CatalogZone>
      <hr />
      <asp:CatalogZone ID="CatalogZone2" runat="server"
        BorderWidth="2"
        HeaderText="My Empty CatalogZone"
        EmptyZoneText="No controls are in the zone." />
      <hr />
      <asp:Panel ID="Panel1" runat="server" Visible="false">
        <asp:Button ID="Button1" runat="server" Width="200" 
          Text="Enable or Disable Verbs" 
          OnClick="Button1_Click" />
        <br />
        <asp:Button ID="Button2" runat="server" Width="200" 
          Text="List CatalogParts" OnClick="Button2_Click" />  
        <br />
        <asp:Button ID="Button3" runat="server" Width="200" 
          Text="Set Zone Text Properties" OnClick="Button3_Click" />  
        <br />   
        <asp:Button ID="Button4" runat="server" Width="200" 
          Text="Show Selected CatalogPart ID" OnClick="Button4_Click"  />  
        <br /> 
        <asp:Button ID="Button5" runat="server" Width="200" 
          Text="Change Part Link Styles" OnClick="Button5_Click"  />  
        <br />     
        <asp:Label ID="Label1" runat="server" Text="" /></asp:Panel>
    </form>
  </body>
</html>

Bagian ketiga dari contoh kode adalah kontrol kustom WebPart bernama TextDisplayWebPart. Ini dideklarasikan dalam zona, dan pengguna akhir dapat menambahkannya dari katalog ke halaman. Agar contoh kode berjalan, Anda harus mengkompilasi kode sumber ini. Anda dapat mengkompilasinya secara eksplisit dan menempatkan rakitan yang dihasilkan di folder Bin situs Web Anda atau singgahan perakitan global. Atau, Anda dapat meletakkan kode sumber di folder App_Code situs Anda, tempat kode tersebut akan dikompilasi secara dinamis pada durasi. Untuk demonstrasi kedua metode kompilasi, lihat Panduan: Mengembangkan dan Menggunakan Kontrol Server Web Kustom.

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 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 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

Perhatikan bahwa agar contoh kode berfungsi, ada pengaturan yang harus Anda tambahkan dalam file Web.config untuk mengaktifkan ekspor file deskripsi Bagian Web. Pastikan Anda memiliki file Web.config di direktori yang sama dengan halaman Web untuk contoh kode ini. Di dalam bagian <system.web> , pastikan ada <webParts> elemen dengan atribut yang enableExport diatur ke true, seperti dalam markup berikut.

<webParts enableExport="true">

...

</webParts>

Saat memuat halaman di browser, Anda bisa memilih Katalog dari kotak daftar drop-down untuk beralih ke mode tampilan katalog. Ketika katalog terlihat, Anda dapat melihat dua kontrol server yang dapat ditambahkan dari katalog ke halaman, dan Anda juga dapat mencatat di antarmuka pengguna efek penggunaan deklaratif dan terprogram dari CatalogZoneBase anggota kelas.

Keterangan

Kelas CatalogZoneBase adalah kelas dasar yang mewarisi dari ToolZone kelas . Ini menyediakan serangkaian perilaku dasar untuk zona turunan.

Kelas ini CatalogZoneBase menyediakan antarmuka pengguna (UI) unik yang memungkinkan pengguna untuk menambahkan WebPart kontrol dan kontrol server lainnya ke halaman Web. Kontrol yang berasal dari CatalogZoneBase kelas, seperti CatalogZone, adalah kontrol yang benar-benar ditempatkan pada halaman Web. Mereka bertindak sebagai kontainer untuk kontrol lain, yang dikenal sebagai CatalogPart kontrol, yang membuat daftar kontrol server bagi pengguna untuk ditambahkan ke halaman. Zona yang berasal dari CatalogZoneBase kelas hanya dapat muncul saat halaman berada dalam mode tampilan katalog.

Catatan

Zona CatalogZoneBase hanya CatalogPart dapat berisi kontrol, dan sebaliknya, CatalogPart kontrol hanya dapat berada di CatalogZoneBase zona.

Mekanisme untuk menambahkan kontrol server ke katalog adalah serangkaian tiga kontrol berikut yang berasal dari kelas dasar CatalogPart .

Kontrol	Deskripsi
PageCatalogPart	Mempertahankan referensi ke kontrol yang telah ditutup pada halaman. Kontrol ini dapat dibuka kembali (ditambahkan kembali ke halaman) oleh pengguna.
DeclarativeCatalogPart	Berisi referensi ke kontrol yang dideklarasikan dalam katalog Bagian Web dalam markup halaman Web. Kontrol ini dapat ditambahkan ke halaman Web oleh pengguna.
ImportCatalogPart	Menyediakan UI bagi pengguna untuk mengunggah file definisi ke katalog sehingga kontrol dapat ditambahkan ke halaman Web. File definisi adalah file XML dengan . Ekstensi nama file WebPart yang mengimpor pengaturan untuk kontrol. Kontrol harus ada pada server sebelum file definisi dapat diimpor.

Kelas CatalogZoneBase ini memiliki sejumlah properti yang berguna untuk menampilkan katalog WebPart kontrol. Properti AddVerb mereferensikan kata kerja yang menambahkan kontrol yang dipilih dari katalog ke halaman, sementara CloseVerb properti mereferensikan kata kerja yang menutup katalog dan mengembalikan mode tampilan halaman untuk menelusuri mode. Properti CatalogParts mereferensikan kumpulan semua CatalogPart kontrol di zona tersebut. Beberapa properti berorientasi teks, seperti EmptyZoneText, , HeaderTextdan InstructionText, mengambil alih properti dasar untuk menyediakan teks default yang sesuai untuk katalog. Properti SelectTargetZoneText berisi teks bersama kontrol daftar drop-down yang memungkinkan pengguna untuk memilih zona mana kontrol akan ditambahkan.

Beberapa properti lain disertakan CatalogZoneBase dalam kelas . Properti SelectedCatalogPartID adalah pengidentifikasi string unik untuk kontrol yang saat ini dipilih CatalogPart . Properti ShowCatalogIcons menunjukkan apakah akan menampilkan ikon yang dapat dikaitkan dengan kontrol dengan mengatur CatalogIconImageUrl properti pada WebPart kontrol.

Properti PartLinkStyle berisi atribut gaya untuk tautan ke CatalogPart kontrol yang saat ini tidak dipilih di zona tersebut. Sebaliknya, SelectedPartLinkStyle properti berisi atribut gaya untuk tautan ke CatalogPart kontrol yang saat ini dipilih pengguna di zona tersebut.

Selain properti, ada juga beberapa metode di CatalogZoneBase kelas , selain metode penanganan peristiwa dan penyajian standar yang diwarisi dari kontrol dasar lainnya, yang dirancang secara unik untuk tujuan menangani katalog kontrol. Metode ini CreateCatalogPartChrome membuat chrome (elemen UI periferal seperti batas, kata kerja, ikon, dan judul) yang mengelilingi setiap CatalogPart kontrol di zona, dan juga menangani penyajian untuk kontrol. Metode CreateCatalogParts ini adalah metode abstrak; kelas turunan mengambil alihnya untuk membuat instans semua CatalogPart kontrol yang terkandung dalam zona. Metode InvalidateCatalogParts ini dapat dipanggil oleh kelas turunan jika pengumpulan CatalogPart kontrol di zona berubah karena beberapa alasan terprogram, dan kelas turunan perlu membuat ulang koleksi. Metode LoadPostData memuat status yang sudah ada sebelumnya untuk kotak centang di samping WebPart kontrol dalam katalog, setiap kali halaman diposting kembali ke server; sebaliknya, SaveControlState metode menyimpan status kotak centang. Terakhir, metode ini RenderCatalogPartLinks menyediakan semua penyajian untuk tautan ke setiap CatalogPart kontrol yang terkandung dalam zona.

Catatan Bagi Implementer

Jika Anda ingin mengembangkan zona kustom untuk kontrol hosting CatalogPart , Anda harus menentukan apakah Anda ingin memberikan dukungan templat zona. Templat zona dibuat oleh jenis yang mengimplementasikan ITemplate antarmuka, dan diperlukan jika Anda ingin mengaktifkan pengembang halaman menggunakan zona kustom Anda untuk mereferensikan CatalogPart kontrol dalam zona Anda di markup deklaratif halaman Web. Jika Anda memerlukan dukungan templat zona, Anda harus mewarisi dari CatalogZone kelas . Sebaliknya, jika zona kustom Anda dan kontrolnya CatalogPart akan mandiri, dan mereka akan dibuat secara terprogram tanpa opsi bagi pengembang halaman untuk menentukan kontrol secara deklaratif dalam templat zona, maka Anda dapat mewarisi langsung dari CatalogZoneBase kelas . Jika Anda mewarisi dari CatalogZoneBase kelas , Anda harus mengambil CreateCatalogParts() alih metode , dan menambahkan WebPart atau kontrol server lain yang Anda inginkan di katalog Anda ke CatalogPartCollection objek.

Konstruktor

CatalogZoneBase()

Menginisialisasi kelas untuk digunakan oleh instans kelas yang diwariskan. Konstruktor ini hanya dapat dipanggil oleh kelas yang diwariskan.

Properti

AccessKey	Mendapatkan atau mengatur kunci akses yang memungkinkan Anda menavigasi dengan cepat ke kontrol server Web. (Diperoleh dari WebControl)
Adapter	Mendapatkan adaptor khusus browser untuk kontrol. (Diperoleh dari Control)
AddVerb	Mendapatkan referensi ke WebPartVerb objek yang memungkinkan pengguna akhir menambahkan kontrol dari katalog ke halaman Bagian Web.
AppRelativeTemplateSourceDirectory	Mendapatkan atau mengatur direktori virtual relatif aplikasi dari Page objek atau UserControl yang berisi kontrol ini. (Diperoleh dari Control)
AssociatedDisplayModes	Mendapatkan kumpulan WebPartDisplayMode objek yang terkait dengan zona tertentu ToolZone . (Diperoleh dari ToolZone)
Attributes	Mendapatkan kumpulan atribut arbitrer (hanya untuk penyajian) yang tidak sesuai dengan properti pada kontrol. (Diperoleh dari WebControl)
BackColor	Mendapatkan atau mengatur warna latar belakang kontrol server Web. (Diperoleh dari WebControl)
BackImageUrl	Mendapatkan atau mengatur URL ke gambar latar belakang untuk zona. (Diperoleh dari WebZone)
BindingContainer	Mendapatkan kontrol yang berisi pengikatan data kontrol ini. (Diperoleh dari Control)
BorderColor	Mendapatkan atau menyetel warna batas kontrol Web. (Diperoleh dari WebControl)
BorderStyle	Mendapatkan atau mengatur gaya batas kontrol server Web. (Diperoleh dari WebControl)
BorderWidth	Mendapatkan atau mengatur lebar batas kontrol server Web. (Diperoleh dari WebControl)
CatalogPartChrome	Mendapatkan referensi ke instans kelas yang CatalogPartChrome terkait dengan CatalogZoneBase zona.
CatalogParts	Mendapatkan koleksi semua kontrol yang CatalogPart terkandung dalam CatalogZoneBase zona.
ChildControlsCreated	Mendapatkan nilai yang menunjukkan apakah kontrol anak kontrol server telah dibuat. (Diperoleh dari Control)
ClientID	Mendapatkan ID kontrol untuk markup HTML yang dihasilkan oleh ASP.NET. (Diperoleh dari Control)
ClientIDMode	Mendapatkan atau mengatur algoritma yang digunakan untuk menghasilkan nilai ClientID properti. (Diperoleh dari Control)
ClientIDSeparator	Mendapatkan nilai karakter yang mewakili karakter pemisah yang digunakan dalam ClientID properti . (Diperoleh dari Control)
CloseVerb	Mendapatkan referensi ke WebPartVerb objek yang memungkinkan pengguna akhir menutup antarmuka pengguna katalog (UI) dan mengembalikan halaman ke mode penelusuran normal.
Context	Mendapatkan objek yang HttpContext terkait dengan kontrol server untuk permintaan Web saat ini. (Diperoleh dari Control)
Controls	ControlCollection Mendapatkan objek yang mewakili kontrol anak dalam CompositeControl. (Diperoleh dari CompositeControl)
ControlStyle	Mendapatkan gaya kontrol server Web. Properti ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebControl)
ControlStyleCreated	Mendapatkan nilai yang menunjukkan apakah Style objek telah dibuat untuk ControlStyle properti . Properti ini terutama digunakan oleh pengembang kontrol. (Diperoleh dari WebControl)
CssClass	Mendapatkan atau mengatur kelas Lembar Gaya Bertingkat (CSS) yang dirender oleh kontrol server Web pada klien. (Diperoleh dari WebControl)
DataItemContainer	Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan IDataItemContainermengimplementasikan . (Diperoleh dari Control)
DataKeysContainer	Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan IDataKeysControlmengimplementasikan . (Diperoleh dari Control)
DesignMode	Mendapatkan nilai yang menunjukkan apakah kontrol sedang digunakan pada permukaan desain. (Diperoleh dari Control)
Display	Mendapatkan nilai yang menunjukkan apakah ToolZone kontrol saat ini ditampilkan. (Diperoleh dari ToolZone)
EditUIStyle	Mendapatkan atribut gaya untuk kontrol yang dapat diedit yang terkandung dalam ToolZone kontrol. (Diperoleh dari ToolZone)
EmptyZoneText	Mendapatkan atau mengatur pesan yang muncul saat zona tidak berisi kontrol.
EmptyZoneTextStyle	Mendapatkan atribut gaya untuk teks tempat penampung di zona kosong. (Diperoleh dari WebZone)
Enabled	Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server Web diaktifkan. (Diperoleh dari WebControl)
EnableTheming	Mendapatkan atau menetapkan nilai yang menunjukkan apakah tema berlaku untuk kontrol ini. (Diperoleh dari WebControl)
EnableViewState	Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server mempertahankan status tampilannya, dan status tampilan kontrol anak apa pun yang dikandungnya, ke klien yang meminta. (Diperoleh dari Control)
ErrorStyle	Mendapatkan atribut gaya untuk menyajikan pesan kesalahan yang ditampilkan jika WebPart kontrol tidak dapat dimuat atau dibuat. (Diperoleh dari WebZone)
Events	Mendapatkan daftar delegasi penanganan aktivitas untuk kontrol. Properti ini bersifat hanya baca. (Diperoleh dari Control)
Font	Mendapatkan properti font yang terkait dengan kontrol server Web. (Diperoleh dari WebControl)
FooterStyle	Mendapatkan atribut gaya untuk konten area footer zona. (Diperoleh dari WebZone)
ForeColor	Mendapatkan atau mengatur warna latar depan (biasanya warna teks) kontrol server Web. (Diperoleh dari WebControl)
HasAttributes	Mendapatkan nilai yang menunjukkan apakah kontrol memiliki atribut yang ditetapkan. (Diperoleh dari WebControl)
HasChildViewState	Mendapatkan nilai yang menunjukkan apakah kontrol turunan kontrol server saat ini memiliki pengaturan status tampilan yang disimpan. (Diperoleh dari Control)
HasFooter	Mendapatkan nilai yang menunjukkan apakah zona memiliki area footer. (Diperoleh dari WebZone)
HasHeader	Mendapatkan nilai yang menunjukkan apakah zona memiliki area header. (Diperoleh dari WebZone)
HeaderCloseVerb	Mendapatkan referensi ke WebPartVerb objek di header ToolZone kontrol yang digunakan untuk menutup kontrol. (Diperoleh dari ToolZone)
HeaderStyle	Mendapatkan atribut gaya untuk konten area header zona. (Diperoleh dari WebZone)
HeaderText	Mendapatkan atau mengatur teks untuk area header zona.
HeaderVerbStyle	Mendapatkan atribut gaya untuk semua kata kerja header yang ToolZone ditampilkan dalam kontrol. (Diperoleh dari ToolZone)
Height	Mendapatkan atau mengatur tinggi kontrol server Web. (Diperoleh dari WebControl)
ID	Mendapatkan atau mengatur pengidentifikasi terprogram yang ditetapkan ke kontrol server. (Diperoleh dari Control)
IdSeparator	Mendapatkan karakter yang digunakan untuk memisahkan pengidentifikasi kontrol. (Diperoleh dari Control)
InstructionText	Mendapatkan atau mengatur teks di zona yang menyediakan petunjuk arah untuk pengguna akhir.
InstructionTextStyle	Mendapatkan atribut gaya untuk teks instruksi yang muncul di bagian ToolZone atas kontrol. (Diperoleh dari ToolZone)
IsChildControlStateCleared	Mendapatkan nilai yang menunjukkan apakah kontrol yang terkandung dalam kontrol ini memiliki status kontrol. (Diperoleh dari Control)
IsEnabled	Mendapatkan nilai yang menunjukkan apakah kontrol diaktifkan. (Diperoleh dari WebControl)
IsTrackingViewState	Mendapatkan nilai yang menunjukkan apakah kontrol server menyimpan perubahan pada status tampilannya. (Diperoleh dari Control)
IsViewStateEnabled	Mendapatkan nilai yang menunjukkan apakah status tampilan diaktifkan untuk kontrol ini. (Diperoleh dari Control)
LabelStyle	Mendapatkan atribut gaya untuk konten label yang muncul bersama kontrol pengeditan dalam ToolZone kontrol. Kontrol turunan ToolZone , seperti CatalogZone dan EditorZone, menerapkan gaya ke label. (Diperoleh dari ToolZone)
LoadViewStateByID	Mendapatkan nilai yang menunjukkan apakah kontrol berpartisipasi dalam memuat status tampilannya dengan ID bukan indeks. (Diperoleh dari Control)
NamingContainer	Mendapatkan referensi ke kontainer penamaan kontrol server, yang membuat namespace unik untuk membedakan antara kontrol server dengan nilai properti yang sama ID . (Diperoleh dari Control)
Padding	Mendapatkan atau mengatur atribut padding sel pada tabel yang berisi WebPart kontrol di zona. (Diperoleh dari WebZone)
Page	Mendapatkan referensi ke Page instans yang berisi kontrol server. (Diperoleh dari Control)
Parent	Mendapatkan referensi ke kontrol induk kontrol server dalam hierarki kontrol halaman. (Diperoleh dari Control)
PartChromePadding	Mendapatkan atau mengatur jarak antara konten WebPart kontrol dan batas kontrol. (Diperoleh dari WebZone)
PartChromeStyle	Mendapatkan karakteristik gaya yang berlaku untuk batas kontrol Bagian Web yang dimuat oleh zona. (Diperoleh dari WebZone)
PartChromeType	Mendapatkan atau menyetel tipe batas yang membingkai kontrol Bagian Web yang dimuat oleh zona. (Diperoleh dari WebZone)
PartLinkStyle	Mendapatkan objek yang berisi atribut gaya untuk CatalogPart kontrol yang saat ini tidak dipilih di zona tersebut.
PartStyle	Mendapatkan karakteristik gaya yang berlaku untuk batas dan isi setiap kontrol Bagian Web yang dimuat oleh zona. (Diperoleh dari WebZone)
PartTitleStyle	Mendapatkan atribut gaya untuk isi bilah judul untuk setiap kontrol Bagian Web yang dimuat oleh zona. (Diperoleh dari WebZone)
RenderClientScript	Mendapatkan nilai yang menunjukkan apakah akan merender skrip klien pada halaman Bagian Web. (Diperoleh dari WebZone)
RenderingCompatibility	Mendapatkan nilai yang menentukan versi ASP.NET yang dirender HTML akan kompatibel. (Diperoleh dari Control)
SelectedCatalogPartID	Mendapatkan atau mengatur string sebagai pengidentifikasi untuk kontrol yang saat ini dipilih CatalogPart di zona.
SelectedPartLinkStyle	Mendapatkan objek yang berisi atribut gaya untuk CatalogPart kontrol yang saat ini dipilih di zona tersebut.
SelectTargetZoneText	Mendapatkan atau mengatur teks bersama kontrol di antarmuka pengguna katalog (UI) yang memungkinkan pengguna untuk memilih zona mana yang akan ditambahkan kontrol yang dipilih.
ShowCatalogIcons	Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server dalam katalog menampilkan ikon terkait dalam katalog.
Site	Mendapatkan informasi tentang kontainer yang menghosting kontrol saat ini saat dirender pada permukaan desain. (Diperoleh dari Control)
SkinID	Mendapatkan atau mengatur kulit untuk diterapkan ke kontrol. (Diperoleh dari WebControl)
Style	Mendapatkan kumpulan atribut teks yang akan dirender sebagai atribut gaya pada tag luar kontrol server Web. (Diperoleh dari WebControl)
SupportsDisabledAttribute	Mendapatkan nilai yang menunjukkan apakah kontrol harus mengatur disabled atribut elemen HTML yang dirender ke "dinonaktifkan" ketika properti kontrol IsEnabled adalah false. (Diperoleh dari CompositeControl)
TabIndex	Mendapatkan atau mengatur indeks tab kontrol server Web. (Diperoleh dari WebControl)
TagKey	HtmlTextWriterTag Mendapatkan nilai yang sesuai dengan kontrol server Web ini. Properti ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebZone)
TagName	Mendapatkan nama tag kontrol. Properti ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebControl)
TemplateControl	Mendapatkan atau mengatur referensi ke templat yang berisi kontrol ini. (Diperoleh dari Control)
TemplateSourceDirectory	Mendapatkan direktori Page virtual dari atau UserControl yang berisi kontrol server saat ini. (Diperoleh dari Control)
ToolTip	Mendapatkan atau mengatur teks yang ditampilkan saat penunjuk mouse mengarah ke kontrol server Web. (Diperoleh dari WebControl)
UniqueID	Mendapatkan pengidentifikasi unik yang memenuhi syarat secara hierarkis untuk kontrol server. (Diperoleh dari Control)
ValidateRequestMode	Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol memeriksa input klien dari browser untuk nilai yang berpotensi berbahaya. (Diperoleh dari Control)
VerbButtonType	Mendapatkan atau mengatur jenis tombol apa yang digunakan untuk mewakili kata kerja di zona. (Diperoleh dari WebZone)
VerbStyle	Mendapatkan atribut gaya untuk kata kerja antarmuka pengguna (UI) yang terkait dengan kontrol Bagian Web di zona. (Diperoleh dari WebZone)
ViewState	Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status tampilan kontrol server di beberapa permintaan untuk halaman yang sama. (Diperoleh dari Control)
ViewStateIgnoresCase	Mendapatkan nilai yang menunjukkan apakah StateBag objek tidak peka huruf besar/kecil. (Diperoleh dari Control)
ViewStateMode	Mendapatkan atau mengatur mode view-state kontrol ini. (Diperoleh dari Control)
Visible	Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server dirender sebagai elemen antarmuka pengguna (UI) di halaman. (Diperoleh dari ToolZone)
WebPartManager	Mendapatkan referensi ke kontrol yang WebPartManager terkait dengan WebZone instans kontrol pada halaman Bagian Web. (Diperoleh dari WebZone)
Width	Mendapatkan atau menyetel lebar kontrol server Web. (Diperoleh dari WebControl)

Metode

AddAttributesToRender(HtmlTextWriter)	Menambahkan atribut dan gaya HTML yang perlu dirender ke yang ditentukan HtmlTextWriterTag. Metode ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebControl)
AddedControl(Control, Int32)	Dipanggil setelah kontrol anak ditambahkan ke Controls koleksi Control objek. (Diperoleh dari Control)
AddParsedSubObject(Object)	Memberi tahu kontrol server bahwa elemen, BAIK XML atau HTML, diurai, dan menambahkan elemen ke objek kontrol ControlCollection server. (Diperoleh dari Control)
ApplyStyle(Style)	Menyalin elemen tidak kosong dari gaya yang ditentukan ke kontrol Web, menimpa elemen gaya kontrol yang ada. Metode ini terutama digunakan oleh pengembang kontrol. (Diperoleh dari WebControl)
ApplyStyleSheetSkin(Page)	Menerapkan properti gaya yang ditentukan dalam lembar gaya halaman ke kontrol. (Diperoleh dari Control)
BeginRenderTracing(TextWriter, Object)	Memulai pelacakan waktu desain dari data penyajian. (Diperoleh dari Control)
BuildProfileTree(String, Boolean)	Mengumpulkan informasi tentang kontrol server dan mengirimkannya ke properti yang Trace akan ditampilkan saat pelacakan diaktifkan untuk halaman. (Diperoleh dari Control)
ClearCachedClientID()	Mengatur nilai yang di-cache ClientID ke null. (Diperoleh dari Control)
ClearChildControlState()	Menghapus informasi status kontrol untuk kontrol turunan kontrol server. (Diperoleh dari Control)
ClearChildState()	Menghapus informasi status tampilan dan status kontrol untuk semua kontrol turunan kontrol server. (Diperoleh dari Control)
ClearChildViewState()	Menghapus informasi status tampilan untuk semua kontrol turunan kontrol server. (Diperoleh dari Control)
ClearEffectiveClientIDMode()	Mengatur properti instans ClientIDMode kontrol saat ini dan kontrol turunan apa pun ke Inherit. (Diperoleh dari Control)
Close()	Mengalihkan halaman Web dari mode tampilan katalog ke mode penjelajahan normal.
CopyBaseAttributes(WebControl)	Menyalin properti yang tidak dienkapsulasi oleh Style objek dari kontrol server Web yang ditentukan ke kontrol server Web tempat metode ini dipanggil. Metode ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebControl)
CreateCatalogPartChrome()	Membuat instans objek yang CatalogPartChrome digunakan untuk merender elemen antarmuka pengguna periferal (UI) untuk CatalogPart kontrol di zona.
CreateCatalogParts()	Menyediakan deklarasi metode dasar yang dapat diambil alih zona untuk menangani detail pembuatan CatalogPart kontrol yang terkandung dalam zona.
CreateChildControls()	Membuat kumpulan kontrol anak yang terkait dengan CatalogZoneBase zona.
CreateControlCollection()	Membuat objek baru ControlCollection untuk menahan kontrol anak (baik harfiah maupun server) kontrol server. (Diperoleh dari Control)
CreateControlStyle()	Membuat objek gaya yang digunakan secara internal oleh WebControl kelas untuk mengimplementasikan semua properti terkait gaya. Metode ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebControl)
DataBind()	Mengikat sumber data ke CompositeControl dan semua kontrol anaknya. (Diperoleh dari CompositeControl)
DataBind(Boolean)	Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya dengan opsi untuk menaikkan DataBinding peristiwa. (Diperoleh dari Control)
DataBindChildren()	Mengikat sumber data ke kontrol anak kontrol server. (Diperoleh dari Control)
Dispose()	Memungkinkan kontrol server untuk melakukan pembersihan akhir sebelum dirilis dari memori. (Diperoleh dari Control)
EndRenderTracing(TextWriter, Object)	Mengakhiri pelacakan waktu desain data penyajian. (Diperoleh dari Control)
EnsureChildControls()	Menentukan apakah kontrol server berisi kontrol anak. Jika tidak, itu membuat kontrol anak. (Diperoleh dari Control)
EnsureID()	Membuat pengidentifikasi untuk kontrol yang tidak memiliki pengidentifikasi yang ditetapkan. (Diperoleh dari Control)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FindControl(String)	Mencari kontainer penamaan saat ini untuk kontrol server dengan parameter yang ditentukan id . (Diperoleh dari Control)
FindControl(String, Int32)	Mencari kontainer penamaan saat ini untuk kontrol server dengan yang ditentukan id dan bilangan bulat, yang ditentukan dalam pathOffset parameter , yang membantu dalam pencarian. Anda tidak boleh mengambil alih versi FindControl metode ini. (Diperoleh dari Control)
Focus()	Mengatur fokus input ke kontrol. (Diperoleh dari Control)
GetDesignModeState()	Mendapatkan data waktu desain untuk kontrol. (Diperoleh dari Control)
GetEffectiveChromeType(Part)	Mengembalikan nilai WebPart kontrol aktual atau efektif saat iniPartChromeType, mengingat PartChromeType properti zona dan mode tampilan saat ini dari halaman Bagian Web. (Diperoleh dari WebZone)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetRouteUrl(Object)	Mendapatkan URL yang sesuai dengan sekumpulan parameter rute. (Diperoleh dari Control)
GetRouteUrl(RouteValueDictionary)	Mendapatkan URL yang sesuai dengan sekumpulan parameter rute. (Diperoleh dari Control)
GetRouteUrl(String, Object)	Mendapatkan URL yang sesuai dengan sekumpulan parameter rute dan nama rute. (Diperoleh dari Control)
GetRouteUrl(String, RouteValueDictionary)	Mendapatkan URL yang sesuai dengan sekumpulan parameter rute dan nama rute. (Diperoleh dari Control)
GetType()	Mendapatkan instans Type saat ini. (Diperoleh dari Object)
GetUniqueIDRelativeTo(Control)	Mengembalikan bagian awalan dari UniqueID properti kontrol yang ditentukan. (Diperoleh dari Control)
HasControls()	Menentukan apakah kontrol server berisi kontrol anak apa pun. (Diperoleh dari Control)
HasEvents()	Mengembalikan nilai yang menunjukkan apakah peristiwa terdaftar untuk kontrol atau kontrol turunan apa pun. (Diperoleh dari Control)
InvalidateCatalogParts()	Menghancurkan kumpulan CatalogPart kontrol yang terkait dengan CatalogZoneBase zona.
IsLiteralContent()	Menentukan apakah kontrol server hanya menyimpan konten harfiah. (Diperoleh dari Control)
LoadControlState(Object)	Memuat status dari permintaan halaman sebelumnya untuk properti kontrol yang harus bertahan di seluruh postback bahkan ketika status tampilan dinonaktifkan pada kontrol.
LoadPostData(String, NameValueCollection)	Memproses status kotak centang yang sesuai dengan WebPart kontrol dalam katalog, ketika halaman diposting kembali ke server.
LoadViewState(Object)	Memuat informasi status yang disimpan sebelumnya untuk zona.
MapPathSecure(String)	Mengambil jalur fisik tempat jalur virtual, baik absolut atau relatif, dipetakan. (Diperoleh dari Control)
MemberwiseClone()	Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object)
MergeStyle(Style)	Menyalin elemen tidak kosong dari gaya yang ditentukan ke kontrol Web, tetapi tidak akan menimpa elemen gaya kontrol yang ada. Metode ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebControl)
OnBubbleEvent(Object, EventArgs)	Menentukan apakah peristiwa untuk kontrol server diteruskan ke hierarki kontrol server UI halaman. (Diperoleh dari Control)
OnDataBinding(EventArgs)	Memunculkan kejadian DataBinding. (Diperoleh dari Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)	Menyediakan deklarasi metode dasar yang dapat diambil ToolZone alih kontrol untuk menangani detail perubahan mode tampilan halaman untuk zona khusus. (Diperoleh dari ToolZone)
OnInit(EventArgs)	Mendaftarkan objek halaman sehingga halaman memerlukan status kontrol.
OnLoad(EventArgs)	Memunculkan kejadian Load. (Diperoleh dari Control)
OnPreRender(EventArgs)	Menaikkan PreRender peristiwa dan mendaftarkan objek halaman sehingga memerlukan postback.
OnSelectedWebPartChanged(Object, WebPartEventArgs)	Menyediakan deklarasi metode dasar yang bisa diambil ToolZone alih kontrol untuk menangani kejadian perubahan kontrol Bagian Web mana yang dipilih dalam zona khusus. (Diperoleh dari ToolZone)
OnUnload(EventArgs)	Memunculkan kejadian Unload. (Diperoleh dari Control)
OpenFile(String)	Stream Menggunakan untuk membaca file. (Diperoleh dari Control)
RaiseBubbleEvent(Object, EventArgs)	Menetapkan sumber peristiwa apa pun dan informasinya ke induk kontrol. (Diperoleh dari Control)
RaisePostBackEvent(String)	Melakukan tindakan yang terkait dengan salah satu kata kerja zona, atau menaikkan peristiwa yang memposting kembali ke server.
RecreateChildControls()	Membuat ulang kontrol anak dalam kontrol yang berasal dari CompositeControl. (Diperoleh dari CompositeControl)
RemovedControl(Control)	Dipanggil setelah kontrol anak dihapus dari Controls koleksi Control objek. (Diperoleh dari Control)
Render(HtmlTextWriter)	Merender zona ke objek yang ditentukan HtmlTextWriter .
RenderBeginTag(HtmlTextWriter)	Merender tag HTML pembuka dari kontrol zona ke objek yang ditentukan HtmlTextWriter . (Diperoleh dari WebZone)
RenderBody(HtmlTextWriter)	Mengambil alih metode dasar untuk merender area isi zona yang berasal dari CatalogZoneBase kelas .
RenderCatalogPartLinks(HtmlTextWriter)	Merender tautan ke kontrol individual CatalogPart dalam zona CatalogZoneBase .
RenderChildren(HtmlTextWriter)	Mengeluarkan konten turunan kontrol server ke objek yang disediakan HtmlTextWriter , yang menulis konten yang akan dirender pada klien. (Diperoleh dari Control)
RenderContents(HtmlTextWriter)	Merender seluruh konten kontrol zona antara tag awal dan akhir ke objek yang ditentukan HtmlTextWriter . (Diperoleh dari WebZone)
RenderControl(HtmlTextWriter)	Output konten kontrol server ke objek yang disediakan HtmlTextWriter dan menyimpan informasi pelacakan tentang kontrol jika pelacakan diaktifkan. (Diperoleh dari Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Output konten kontrol server ke objek yang disediakan HtmlTextWriter menggunakan objek yang disediakan ControlAdapter . (Diperoleh dari Control)
RenderEndTag(HtmlTextWriter)	Merender tag penutup HTML kontrol ke penulis yang ditentukan. Metode ini digunakan terutama oleh pengembang kontrol. (Diperoleh dari WebControl)
RenderFooter(HtmlTextWriter)	Merender area footer untuk zona CatalogZoneBase .
RenderHeader(HtmlTextWriter)	Mengambil alih metode dasar untuk menyediakan penyajian khusus untuk area header yang diperlukan oleh ToolZone kontrol. (Diperoleh dari ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)	Merender kata kerja individu dengan ToolZone kontrol. (Diperoleh dari ToolZone)
RenderVerbs(HtmlTextWriter)	Merender kata kerja di area CatalogZoneBase footer zona.
ResolveAdapter()	Mendapatkan adaptor kontrol yang bertanggung jawab untuk merender kontrol yang ditentukan. (Diperoleh dari Control)
ResolveClientUrl(String)	Mendapatkan URL yang dapat digunakan oleh browser. (Diperoleh dari Control)
ResolveUrl(String)	Mengonversi URL menjadi URL yang dapat digunakan pada klien yang meminta. (Diperoleh dari Control)
SaveControlState()	Menyimpan perubahan apa pun dalam CatalogZoneBase status kontrol yang terjadi setelah halaman Web diposting kembali ke server.
SaveViewState()	Menyimpan perubahan status tampilan apa pun yang terjadi setelah halaman diposting kembali ke server.
SetDesignModeState(IDictionary)	Mengatur data waktu desain untuk kontrol. (Diperoleh dari Control)
SetRenderMethodDelegate(RenderMethod)	Menetapkan delegasi penanganan aktivitas untuk merender kontrol server dan kontennya ke dalam kontrol induknya. (Diperoleh dari Control)
SetTraceData(Object, Object)	Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan kunci data pelacakan dan nilai data pelacakan. (Diperoleh dari Control)
SetTraceData(Object, Object, Object)	Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan objek yang dilacak, kunci data pelacakan, dan nilai data pelacakan. (Diperoleh dari Control)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
TrackViewState()	Melacak perubahan pada status tampilan kontrol zona.

Acara

DataBinding	Terjadi ketika kontrol server mengikat ke sumber data. (Diperoleh dari Control)
Disposed	Terjadi ketika kontrol server dirilis dari memori, yang merupakan tahap terakhir dari siklus hidup kontrol server ketika halaman ASP.NET diminta. (Diperoleh dari Control)
Init	Terjadi ketika kontrol server diinisialisasi, yang merupakan langkah pertama dalam siklus hidupnya. (Diperoleh dari Control)
Load	Terjadi ketika kontrol server dimuat ke Page dalam objek. (Diperoleh dari Control)
PreRender	Terjadi setelah Control objek dimuat tetapi sebelum penyajian. (Diperoleh dari Control)
Unload	Terjadi ketika kontrol server dibongkar dari memori. (Diperoleh dari Control)

Implementasi Antarmuka Eksplisit

IAttributeAccessor.GetAttribute(String)	Mendapatkan atribut kontrol Web dengan nama yang ditentukan. (Diperoleh dari WebControl)
IAttributeAccessor.SetAttribute(String, String)	Menyetel atribut kontrol Web ke nama dan nilai yang ditentukan. (Diperoleh dari WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Memungkinkan perancang untuk membuat ulang kumpulan kontrol komposit kontrol anak di lingkungan waktu desain. (Diperoleh dari CompositeControl)
IControlBuilderAccessor.ControlBuilder	Untuk deskripsi anggota ini, lihat ControlBuilder. (Diperoleh dari Control)
IControlDesignerAccessor.GetDesignModeState()	Untuk deskripsi anggota ini, lihat GetDesignModeState(). (Diperoleh dari Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Untuk deskripsi anggota ini, lihat SetDesignModeState(IDictionary). (Diperoleh dari Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Untuk deskripsi anggota ini, lihat SetOwnerControl(Control). (Diperoleh dari Control)
IControlDesignerAccessor.UserData	Untuk deskripsi anggota ini, lihat UserData. (Diperoleh dari Control)
IDataBindingsAccessor.DataBindings	Untuk deskripsi anggota ini, lihat DataBindings. (Diperoleh dari Control)
IDataBindingsAccessor.HasDataBindings	Untuk deskripsi anggota ini, lihat HasDataBindings. (Diperoleh dari Control)
IExpressionsAccessor.Expressions	Untuk deskripsi anggota ini, lihat Expressions. (Diperoleh dari Control)
IExpressionsAccessor.HasExpressions	Untuk deskripsi anggota ini, lihat HasExpressions. (Diperoleh dari Control)
IParserAccessor.AddParsedSubObject(Object)	Untuk deskripsi anggota ini, lihat AddParsedSubObject(Object). (Diperoleh dari Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	LoadPostData(String, NameValueCollection) Menerapkan metode dengan memanggil LoadPostData(String, NameValueCollection) metode CatalogZoneBase kelas .
IPostBackDataHandler.RaisePostDataChangedEvent()	Untuk deskripsi anggota ini, lihat RaisePostDataChangedEvent().
IPostBackEventHandler.RaisePostBackEvent(String)	RaisePostBackEvent(String) Mengimplementasikan metode . (Diperoleh dari ToolZone)

Metode Ekstensi

FindDataSourceControl(Control)	Mengembalikan sumber data yang terkait dengan kontrol data untuk kontrol yang ditentukan.
FindFieldTemplate(Control, String)	Mengembalikan templat bidang untuk kolom yang ditentukan dalam kontainer penamaan kontrol yang ditentukan.
FindMetaTable(Control)	Mengembalikan objek metatable untuk kontrol data yang berisi.
GetDefaultValues(INamingContainer)	Mendapatkan kumpulan nilai default untuk kontrol data yang ditentukan.
GetMetaTable(INamingContainer)	Mendapatkan metadata tabel untuk kontrol data yang ditentukan.
SetMetaTable(INamingContainer, MetaTable)	Mengatur metadata tabel untuk kontrol data yang ditentukan.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Mengatur metadata tabel dan pemetaan nilai default untuk kontrol data yang ditentukan.
SetMetaTable(INamingContainer, MetaTable, Object)	Mengatur metadata tabel dan pemetaan nilai default untuk kontrol data yang ditentukan.
TryGetMetaTable(INamingContainer, MetaTable)	Menentukan apakah metadata tabel tersedia.
EnableDynamicData(INamingContainer, Type)	Mengaktifkan perilaku Data Dinamis untuk kontrol data yang ditentukan.
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Mengaktifkan perilaku Data Dinamis untuk kontrol data yang ditentukan.
EnableDynamicData(INamingContainer, Type, Object)	Mengaktifkan perilaku Data Dinamis untuk kontrol data yang ditentukan.

Lihat juga

• CatalogPart
• ASP.NET Kontrol Bagian Web