Share via


CatalogZone Kelas

Definisi

Berfungsi sebagai kontrol utama di kumpulan kontrol Bagian Web untuk kontrol hosting CatalogPart pada halaman Web.

public ref class CatalogZone : System::Web::UI::WebControls::WebParts::CatalogZoneBase
public class CatalogZone : System.Web.UI.WebControls.WebParts.CatalogZoneBase
type CatalogZone = class
    inherit CatalogZoneBase
Public Class CatalogZone
Inherits CatalogZoneBase
Warisan

Contoh

Contoh kode berikut menunjukkan penggunaan CatalogZone kontrol yang deklaratif dan terprogram. Contoh kode memiliki empat bagian:

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

  • File dengan kode sumber untuk kontrol kustom CatalogZone , dan kontrol kustom WebPart yang diimpor oleh katalog dan ditambahkan ke halaman Web.

  • Halaman Web yang mendeklarasikan kontrol pengguna, dan kontrol kustom CatalogZone .

  • Penjelasan tentang cara menjalankan contoh.

Bagian pertama dari contoh kode ini adalah kontrol pengguna yang memungkinkan pengguna mengubah mode tampilan pada halaman Web. 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=" 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>

Bagian kedua dari contoh kode berisi kode untuk kustom CatalogZone dan WebPart kontrol. Kode untuk CatalogZone kontrol menunjukkan cara mewarisi dari CatalogZone kelas dan menyesuaikan propertinya dengan mengatur beberapa nilai properti default di konstruktor. Kode sumber juga menunjukkan cara membuat kelas kustom WebPart bernama TextDisplayWebPart. Ini adalah kontrol yang terkait dengan . File deskripsi WebPart yang akan Anda impor sebagai bagian dari contoh kode ini. Setelah Anda mengimpor file deskripsi dengan menggunakan ImportCatalogPart kontrol di halaman Web, Anda akan dapat menambahkan TextDisplayWebPart kontrol ke halaman, sepenuhnya telah dikonfigurasi seperti yang ditentukan dalam file deskripsi.

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. Contoh kode ini menggunakan kompilasi dinamis, jadi jika Anda ingin menjalankan contoh dengan cara ini, beri nama file kode sumber dan tambahkan ke subfolder App_Code direktori akar aplikasi Web Anda. Untuk panduan yang menunjukkan 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
{
  // Create a customized CatalogZone control by setting 
  // some properties in the constructor.
  [AspNetHostingPermission(SecurityAction.Demand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  [AspNetHostingPermission(SecurityAction.InheritanceDemand,
    Level = AspNetHostingPermissionLevel.Minimal)]
  public class MyCatalogZone : CatalogZone
  {
    public MyCatalogZone()
    {
      this.HeaderText = "My Company Catalog";
      this.HeaderCloseVerb.Text = "Close Catalog";
      this.CloseVerb.Text = "Close Catalog";
    }
  }

  // Create a custom WebPart control to add to a WebPartZone.
  [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

  ' Create a custom CatalogZone control by setting some 
  ' properties in the constructor.
  <AspNetHostingPermission(SecurityAction.Demand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  <AspNetHostingPermission(SecurityAction.InheritanceDemand, _
    Level:=AspNetHostingPermissionLevel.Minimal)> _
  Public Class MyCatalogZone
    Inherits CatalogZone

    Public Sub New()
      Me.HeaderText = "My Company Catalog"
      Me.HeaderCloseVerb.Text = "Close Catalog"
      Me.CloseVerb.Text = "Close Catalog"
    End Sub

  End Class


  ' Create a custom WebPart to add to a WebPartZone.
  <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

Bagian ketiga dari contoh kode adalah halaman Web yang berisi kontrol. Ini berisi Register direktif untuk kontrol pengguna, dan yang lain untuk file sumber dengan kontrol kustom. Perhatikan bahwa dalam direktif kedua, itu tidak memberi nama assembly, karena contoh tidak menggunakan assembly, ia menggunakan kompilasi dinamis dengan kode sumber yang ditempatkan di subfolder App_Code. Halaman Web mendeklarasikan WebPartZone kontrol, dan di dalam elemen turunannya <zonetemplate> , halaman ini mendeklarasikan BulletedList kontrol. Meskipun ini adalah kontrol ASP.NET standar, kontrol ini akan memiliki fungsionalitas Bagian Web penuh pada durasi, karena WebPartManager kontrol membungkus kontrol server apa pun yang ditempatkan dalam WebPartZone objek , GenericWebPart sehingga kontrol server lain dapat berpartisipasi dalam aplikasi Bagian Web. Juga dinyatakan dalam zona ini adalah kontrol kustom WebPart bernama TextDisplayWebPart. Perhatikan bahwa kontrol ini memiliki atribut yang ExportMode="All" dideklarasikan di atasnya. Ini memungkinkan Anda untuk mengekspor . File deskripsi WebPart yang berisi nilai properti kontrol, yang dapat diimpor oleh pengguna lain untuk menambahkan kontrol yang telah dikonfigurasi sebelumnya ke halaman Web lainnya.

Catatan

Untuk memungkinkan pengguna aplikasi Bagian Web mengekspor file deskripsi untuk WebPart kontrol, Anda juga harus mengaktifkan fitur ekspor di aplikasi Web dengan menambahkan enableExport="true" atribut ke <webParts> elemen (yang merupakan turunan dari <system.web> elemen) dalam file Web.config. Ekspor dinonaktifkan secara default, jadi jika Anda belum mengaktifkan ekspor untuk aplikasi Anda, edit file Web.config dan lakukan sekarang.

Halaman Web juga mendeklarasikan kontrol kustom CatalogZone dan, di dalamnya, <zonetemplate> elemen yang berisi ImportCatalogPart kontrol. Pengguna akan menggunakan kontrol ini pada durasi untuk mengimpor . File deskripsi WebPart untuk kontrol kustom WebPart .

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ Register TagPrefix="aspSample"
  Namespace="Samples.AspNet.CS.Controls" %> 
  
<!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>Untitled Page</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS ID="DisplayModeMenu1" runat="server" />
    <asp:WebPartZone ID="WebPartZone1" 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>
        <aspsample:textdisplaywebpart id="wp1" runat="server" 
           Title="My Text Display WebPart" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
      <ZoneTemplate>
        <asp:ImportCatalogPart id="ImportCatalogPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyCatalogZone>
  </form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ Register TagPrefix="aspSample"
  Namespace="Samples.AspNet.VB.Controls"  %> 

<!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>Untitled Page</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuVB ID="DisplayModeMenu1" runat="server" />
    <asp:WebPartZone ID="WebPartZone1" 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>
        <aspsample:textdisplaywebpart id="wp1" runat="server" 
           Title="My Text Display WebPart" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyCatalogZone ID="CatalogZone1" runat="server">
      <ZoneTemplate>
        <asp:ImportCatalogPart id="ImportCatalogPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyCatalogZone>
  </form>
</body>
</html>

Sekarang jalankan contoh kode. Muat halaman Web di browser. Langkah pertama adalah mengekspor . File deskripsi WebPart untuk TextDisplayWebPart kontrol. Klik menu kata kerja pada kontrol kustom (diwakili oleh panah ke bawah di bilah judul), dan klik Ekspor. Ikuti instruksi untuk menyimpan file deskripsi untuk kontrol. Buka . File deskripsi WebPart di editor, dan edit nilai teks properti judul. <property> Temukan elemen yang memiliki atribut name="Title", dan edit teks judul yang terkandung di antara tag pembuka dan penutup<property>. Sekarang tutup halaman Web, dan edit sumber halaman di editor. <aspSample:TextDisplayWebPart> Hapus elemen deklarasi kontrol, lalu simpan dan tutup file.

Muat halaman Web lagi di browser. TextDisplayWebPart Kontrol seharusnya tidak muncul, karena Anda menghapusnya. Gunakan kontrol daftar drop-down Mode Tampilan dan pilih Katalog untuk mengalihkan halaman ke mode katalog. Perhatikan bahwa kontrol kustom CatalogZone muncul, bersama dengan ImportCatalogPart kontrol. Klik tombol Telusuri untuk menemukan . File deskripsi WebPart yang Anda ekspor untuk TextDisplayWebPart kontrol. Anda bisa mengklik Unggah, pilih kotak centang di samping kontrol yang diimpor, dan klik Tambahkan untuk menambahkannya ke halaman. Klik Tutup Katalog untuk mengembalikan halaman ke mode penjelajahan normal. Kontrol yang diimpor sekarang akan muncul di halaman, dan judul yang muncul di bilah judul kontrol harus menjadi teks judul yang Anda tambahkan ke . File deskripsi WebPart.

Keterangan

Dalam kumpulan kontrol Bagian Web, zona adalah wilayah pada halaman Web yang berisi kontrol Bagian Web. Zona Bagian Web dibuat oleh kontrol zona, yang merupakan tipe yang CompositeControl dirancang untuk memuat kontrol lain. Fungsi utama zona adalah untuk menjabarkan kontrol yang dikandungnya, dan untuk menyediakan antarmuka pengguna (UI) umum untuk kontrol tersebut. Untuk informasi umum tentang zona dan bagaimana zona tersebut digunakan dalam aplikasi Bagian Web, lihat kelas dasar WebZone , dan Gambaran Umum Set Kontrol Bagian Web.

Fitur utama kontrol Bagian Web adalah mereka mengizinkan pengguna akhir untuk memodifikasi (atau mempersonalisasi) halaman Web sesuai dengan preferensi mereka, dan menyimpan pengaturan yang dipersonalisasi untuk sesi browser di masa mendatang. Salah satu aspek mengubah halaman Bagian Web mencakup kemampuan untuk menambahkan WebPart kontrol atau kontrol server lainnya ke halaman Bagian Web. Kontrol CatalogZone menyediakan daftar atau katalog kontrol yang dapat ditambahkan pengguna ke halaman.

Kontrol CatalogZone adalah salah satu kontrol dasar dalam kumpulan kontrol Bagian Web. Ini berasal dari CatalogZoneBase kelas , dan sebagian besar perilakunya diwariskan dari kelas itu. Kelas CatalogZone pada dasarnya menambahkan ke kelas dasar templat zona, yang merupakan implementasi antarmuka ITemplate . Templat zona memungkinkan pengembang untuk secara deklaratif menambahkan CatalogPart kontrol ke zona dalam format persistensi halaman.

Penting

Zona CatalogZone hanya CatalogPart dapat berisi kontrol, dan sebaliknya, CatalogPart kontrol hanya dapat berada di zona yang berasal dari CatalogZoneBase kelas , seperti CatalogZone.

CatalogZone Kontrol menjadi terlihat hanya ketika pengguna mengalihkan halaman Web ke mode tampilan katalog (CatalogDisplayMode). Katalog dapat berisi beberapa jenis CatalogPart kontrol. Setiap CatalogPart kontrol adalah jenis kontainer yang berisi kontrol server yang dapat ditambahkan pengguna ke halaman. Kontrol CatalogPart berbeda sesuai dengan dari mana kontrol server yang dikandungnya berasal. Tabel berikut ini meringkas CatalogPart kontrol yang disediakan dengan kumpulan kontrol Bagian Web dan, untuk setiap kontrol, jenis kontrol server apa yang dikandungnya.

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 (file XML dengan . Ekstensi WebPart dan format tertentu yang berisi informasi status) untuk kontrol ke katalog, sehingga kontrol dapat ditambahkan ke halaman Web.

CatalogZone Karena kelas hanya menambahkan templat zona ke perilaku kelas dasarnya, kelas tersebut memiliki beberapa anggota. Konstruktor CatalogZone adalah konstruktor tanpa parameter; dengan itu, Anda dapat menginisialisasi instans CatalogZone baru kelas. Properti ZoneTemplate mendapatkan atau mengatur referensi ke ITemplate objek yang berisi kontrol untuk zona tersebut. Metode CreateCatalogParts ini sangat penting. Ini mengambil alih metode dasar untuk membuat koleksi semua CatalogPart kontrol yang terkandung dalam templat zona.

Catatan

Tombol di CatalogZone UI memerlukan skrip sisi klien agar berfungsi dengan benar. Jika pembuatan skrip dinonaktifkan di browser, pengguna tidak akan dapat melakukan tindakan melalui CatalogZone UI.

Aksesibilitas

Markup yang dirender secara default untuk kontrol ini mungkin tidak sesuai dengan standar aksesibilitas seperti panduan 1 panduan prioritas Aksesibilitas Konten Web 1.0 (WCAG). Untuk detail tentang dukungan aksesibilitas untuk kontrol ini, lihat Kontrol dan Aksesibilitas ASP.NET.

Catatan Bagi Inheritor

Anda dapat membuat kelas kustom CatalogZone jika Anda menginginkan kontrol lebih atas penyajian dan perilaku UI katalog. Jika Anda tidak perlu memberi pengguna kontrol Anda kemampuan untuk menambahkan CatalogPart kontrol secara deklaratif, maka Anda dapat mewarisi langsung dari CatalogZoneBase kelas . Jika Anda ingin mengaktifkan kontrol untuk ditambahkan secara deklaratif, pendekatan sederhananya adalah mewarisi dari CatalogZone kelas , karena menyediakan templat zona penting.

Jika Anda mewarisi dari CatalogZone kelas , Anda dapat mengambil CreateCatalogParts() alih metode dan menggunakan metode untuk menambahkan kontrol kustom CatalogPart ke CatalogPartCollection, jika Anda ingin kontrol terprogram yang lebih besar atas penambahan kontrol kustom CatalogPart ke zona Anda.

Konstruktor

CatalogZone()

Menginisialisasi instans baru kelas CatalogZone.

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.

(Diperoleh dari CatalogZoneBase)
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.

(Diperoleh dari CatalogZoneBase)
CatalogParts

Mendapatkan koleksi semua kontrol yang CatalogPart terkandung dalam CatalogZoneBase zona.

(Diperoleh dari CatalogZoneBase)
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.

(Diperoleh dari CatalogZoneBase)
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 mengimplementasikan IDataItemContainer.

(Diperoleh dari Control)
DataKeysContainer

Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan mengimplementasikan IDataKeysControl.

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

(Diperoleh dari CatalogZoneBase)
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 setiap kontrol anak 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 anak 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.

(Diperoleh dari CatalogZoneBase)
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.

(Diperoleh dari CatalogZoneBase)
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.

(Diperoleh dari CatalogZoneBase)
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 akan kompatibel dengan HTML yang dirender.

(Diperoleh dari Control)
SelectedCatalogPartID

Mendapatkan atau mengatur string sebagai pengidentifikasi untuk kontrol yang saat ini dipilih CatalogPart di zona.

(Diperoleh dari CatalogZoneBase)
SelectedPartLinkStyle

Mendapatkan objek yang berisi atribut gaya untuk CatalogPart kontrol yang saat ini dipilih di zona tersebut.

(Diperoleh dari CatalogZoneBase)
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.

(Diperoleh dari CatalogZoneBase)
ShowCatalogIcons

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server dalam katalog menampilkan ikon terkait dalam katalog.

(Diperoleh dari CatalogZoneBase)
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)
ZoneTemplate

Mendapatkan atau mengatur templat untuk memuat kontrol anak dalam CatalogZone kontrol dalam format persistensi halaman.

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 untuk merender data.

(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 anak 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 anak 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.

(Diperoleh dari CatalogZoneBase)
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.

(Diperoleh dari CatalogZoneBase)
CreateCatalogParts()

Membuat instans dari setiap CatalogPart jenis yang dideklarasikan di zona tersebut.

CreateChildControls()

Membuat kumpulan kontrol anak yang terkait dengan CatalogZoneBase zona.

(Diperoleh dari CatalogZoneBase)
CreateControlCollection()

Membuat objek baru ControlCollection untuk menahan kontrol anak (baik literal maupun server) dari 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 dilepaskan dari memori.

(Diperoleh dari Control)
EndRenderTracing(TextWriter, Object)

Mengakhiri pelacakan waktu desain penyajian data.

(Diperoleh dari Control)
EnsureChildControls()

Menentukan apakah kontrol server memuat kontrol turunan. Jika tidak, ia 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 bilangan bulat dan yang ditentukan id , 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 dari 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.

(Diperoleh dari CatalogZoneBase)
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.

(Diperoleh dari CatalogZoneBase)
LoadPostData(String, NameValueCollection)

Memproses status kotak centang yang sesuai dengan WebPart kontrol dalam katalog, ketika halaman diposting kembali ke server.

(Diperoleh dari CatalogZoneBase)
LoadViewState(Object)

Memuat informasi status yang disimpan sebelumnya untuk zona.

(Diperoleh dari CatalogZoneBase)
MapPathSecure(String)

Mengambil jalur fisik tempat jalur virtual, baik absolut atau relatif, dipetakan.

(Diperoleh dari Control)
MemberwiseClone()

Membuat salinan dangkal dari 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.

(Diperoleh dari CatalogZoneBase)
OnLoad(EventArgs)

Memunculkan kejadian Load.

(Diperoleh dari Control)
OnPreRender(EventArgs)

Menaikkan PreRender peristiwa dan mendaftarkan objek halaman sehingga memerlukan postback.

(Diperoleh dari CatalogZoneBase)
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 Terbiasa 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.

(Diperoleh dari CatalogZoneBase)
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 .

(Diperoleh dari CatalogZoneBase)
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 .

(Diperoleh dari CatalogZoneBase)
RenderCatalogPartLinks(HtmlTextWriter)

Merender tautan ke kontrol individual CatalogPart dalam zona CatalogZoneBase .

(Diperoleh dari CatalogZoneBase)
RenderChildren(HtmlTextWriter)

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

(Diperoleh dari 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.

(Diperoleh dari CatalogZoneBase)
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.

(Diperoleh dari CatalogZoneBase)
SaveViewState()

Menyimpan perubahan status tampilan apa pun yang terjadi setelah halaman diposting kembali ke server.

(Diperoleh dari CatalogZoneBase)
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.

(Diperoleh dari CatalogZoneBase)

Acara

DataBinding

Terjadi ketika kontrol server mengikat ke sumber data.

(Diperoleh dari Control)
Disposed

Terjadi ketika kontrol server dilepaskan 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 .

(Diperoleh dari CatalogZoneBase)
IPostBackDataHandler.RaisePostDataChangedEvent()

Untuk deskripsi anggota ini, lihat RaisePostDataChangedEvent().

(Diperoleh dari CatalogZoneBase)
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.

Berlaku untuk

Lihat juga