CatalogZone Sınıf

Tanım

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

Devralma

Object

Control

WebControl

CompositeControl

WebZone

ToolZone

CatalogZoneBase

CatalogZone

Örnekler

Aşağıdaki kod örneği, denetimin bildirim temelli ve programlı kullanımını CatalogZone gösterir. Kod örneğinin dört bölümü vardır:

• Web sayfasındaki görüntüleme modlarını değiştirmenize olanak tanıyan bir kullanıcı denetimi.

• Özel CatalogZone denetim için kaynak kodu içeren bir dosya ve katalog tarafından içeri aktarılan ve Web sayfasına eklenen özel WebPart bir denetim.

• Kullanıcı denetimini ve özel CatalogZone denetimi bildiren bir Web sayfası.

• Örneğin nasıl çalıştırıldığından bir açıklama.

Bu kod örneğinin ilk bölümü, kullanıcıların Web sayfasındaki görüntü modlarını değiştirmesine olanak tanıyan kullanıcı denetimidir. Bu denetimdeki görüntü modları ve kaynak kodun açıklaması hakkında ayrıntılı bilgi için bkz . İzlenecek Yol: Web Bölümleri Sayfasında Görüntüleme Modlarını Değiştirme.

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

Kod örneğinin ikinci bölümü, özel CatalogZone ve WebPart denetimler için kodu içerir. Denetimin CatalogZone kodu, oluşturucuda bazı varsayılan özellik değerlerini ayarlayarak sınıfından CatalogZone devralmayı ve özelliklerini özelleştirmeyi gösterir. Kaynak kodu, adlı TextDisplayWebPartözel WebPart bir sınıfın nasıl oluşturulacağını da gösterir. Bu, ile ilişkili denetimdir. Bu kod örneğinin bir parçası olarak içeri aktaracağınız Web Bölümü açıklama dosyası. Web sayfasındaki denetimi kullanarak ImportCatalogPart açıklama dosyasını içeri aktardıktan sonra, denetimi açıklama dosyasında belirtildiği gibi önceden yapılandırılmış şekilde sayfaya ekleyebilirsiniz TextDisplayWebPart .

Kod örneğinin çalışması için bu kaynak kodu derlemeniz gerekir. Bunu açıkça derleyebilir ve sonuçta elde edilen derlemeyi Web sitenizin Bin klasörüne veya genel derleme önbelleğine yerleştirebilirsiniz. Alternatif olarak, kaynak kodu sitenizin çalışma zamanında dinamik olarak derlenecek App_Code klasörüne yerleştirebilirsiniz. Bu kod örneği dinamik derleme kullanır, bu nedenle örneği bu şekilde çalıştırmak istiyorsanız kaynak kod dosyasını adlandırın ve Web uygulamanızın kök dizininin App_Code bir alt klasörüne ekleyin. Her iki derleme yöntemini de gösteren bir kılavuz için bkz. İzlenecek yol: Özel Web Sunucusu Denetimi Geliştirme ve Kullanma.

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

Kod örneğinin üçüncü bölümü, denetimleri içeren Web sayfasıdır. Kullanıcı denetimi için bir yönerge ve özel denetimlere sahip kaynak dosya için başka bir Register yönerge içerir. İkinci yönergede derlemeyi adlandırmaz, çünkü örnek bir derleme kullanmaz, App_Code alt klasörüne yerleştirilen kaynak koduyla dinamik derleme kullanır. Web sayfası bir WebPartZone denetim bildirir ve alt <zonetemplate> öğesi içinde bir BulletedList denetim bildirir. Bu standart bir ASP.NET denetimi olsa da, denetim bir nesneye yerleştirilen WebPartZone tüm sunucu denetimlerini bir nesneyle GenericWebPart sarmalayıp diğer sunucu denetimlerinin Web Bölümleri uygulamalarına katılabilmesi için çalışma zamanında WebPartManager tam Web Bölümleri işlevselliğine sahip olur. Bu bölgede de adlı TextDisplayWebPartözel WebPart denetim bildirilir. Bu denetimin üzerinde bildirilen bir özniteliği ExportMode="All" olduğuna dikkat edin. Bu, bir dışarı aktarmanızı sağlar. Denetimin özellik değerlerini içeren Web Bölümü açıklama dosyası; önceden yapılandırılmış denetimi diğer Web sayfalarına eklemek için diğer kullanıcılar tarafından içeri aktarılabilir.

Web sayfası ayrıca özel CatalogZone denetimi ve içinde denetim içeren bir <zonetemplate>ImportCatalogPart öğeyi bildirir. Kullanıcı bu denetimi çalışma zamanında kullanarak öğesini içeri aktarır. Özel WebPart denetim için Web Bölümü açıklama dosyası.

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

Şimdi kod örneğini çalıştırın. Web sayfasını bir tarayıcıda yükleyin. İlk adım bir dışarı aktarmaktır. Denetim için TextDisplayWebPart Web Bölümü açıklama dosyası. Özel denetimdeki fiiller menüsüne tıklayın (başlık çubuğundaki aşağı okla gösterilir) ve Dışarı Aktar'a tıklayın. Denetimin açıklama dosyasını kaydetmek için yönergeleri izleyin. öğesini açın. Düzenleyicide Web Bölümü açıklama dosyası ve başlık özelliği metninin değerini düzenleyin. özniteliğine name="Title"sahip öğeyi <property> bulun ve açılış ve kapanış <property> etiketleri arasında yer alan başlık metnini düzenleyin. Şimdi Web sayfasını kapatın ve bir düzenleyicide sayfa kaynağını düzenleyin. <aspSample:TextDisplayWebPart> Denetim bildirimi öğesini silin, ardından dosyayı kaydedin ve kapatın.

Web sayfasını bir tarayıcıda yeniden yükleyin. Denetimi TextDisplayWebPart kaldırdığınızdan, denetim görüntülenmemelidir. Görüntüleme Modu açılan liste denetimini kullanın ve Katalog'a tıklayarak sayfayı katalog moduna geçirin. Denetimle birlikte özel CatalogZone denetimin göründüğüne ImportCatalogPart dikkat edin. Gözat düğmesine tıklayarak öğesini bulun. Denetim için TextDisplayWebPart dışarı aktardığınız Web Bölümü açıklama dosyası. Karşıya Yükle'ye tıklayabilir, içeri aktarılan denetimin yanındaki onay kutusunu seçebilir ve Ekle'ye tıklayarak sayfaya ekleyebilirsiniz. Sayfayı normal gözatma moduna döndürmek için Kataloğu Kapat'a tıklayın. İçeri aktarılan denetim artık sayfada görünmelidir ve denetimin başlık çubuğunda görünen başlık, öğesine eklediğiniz başlık metni olmalıdır. Web Bölümü açıklama dosyası.

Açıklamalar

Web Bölümleri denetim kümesinde bölge, Web sayfasındaki Web Bölümleri denetimlerini içeren bir bölgedir. Web Bölümleri bölgesi, diğer denetimleri içerecek şekilde tasarlanmış bir tür CompositeControl olan bölge denetimi tarafından oluşturulur. Bir bölgenin birincil işlevleri, içerdiği denetimleri ayarlamak ve bu denetimler için ortak bir kullanıcı arabirimi (UI) sağlamaktır. Bölgeler ve Web Bölümleri uygulamalarında nasıl kullanıldıkları hakkında genel bilgi için temel WebZone sınıfa ve Web Bölümleri Denetim Kümesine Genel Bakış'a bakın.

Web Bölümleri denetimlerinin önemli özelliklerinden biri, son kullanıcıların Web sayfalarını tercihlerine göre değiştirmesine (veya kişiselleştirmesine) ve gelecekteki tarayıcı oturumları için kişiselleştirilmiş ayarlarını kaydetmesine izin vermeleridir. Web Bölümleri sayfalarını değiştirmenin bir yönü, Web Bölümleri sayfasına denetimler veya diğer sunucu denetimleri ekleme WebPart özelliğini içerir. Denetim, CatalogZone kullanıcıların sayfaya ekleyebilecekleri denetimlerin listesini veya kataloğunu sağlar.

Denetim CatalogZone , Web Bölümleri denetim kümesindeki temel denetimlerden biridir. Sınıfından CatalogZoneBase türetilir ve davranışının çoğu bu sınıftan devralınır. CatalogZone sınıfı temelde temel sınıfa arabiriminin bir uygulaması ITemplate olan bir bölge şablonu ekler. Bölge şablonu, geliştiricilerin sayfa kalıcılığı biçimindeki bir bölgeye bildirimli olarak denetim eklemesine CatalogPart olanak tanır.

Denetim CatalogZone , yalnızca bir kullanıcı Web sayfasını katalog görüntüleme moduna (CatalogDisplayMode ) geçtiğinde görünür hale gelir. Katalog çeşitli denetim türleri CatalogPart içerebilir. Her CatalogPart denetim, kullanıcıların sayfaya ekleyebilecekleri sunucu denetimlerini içeren bir kapsayıcı türüdür. Denetimler, CatalogPart içerdikleri sunucu denetimlerinin nereden geldiğine göre farklılık gösterir. Aşağıdaki tabloda, Web Bölümleri denetim kümesiyle sağlanan denetimler CatalogPart ve her denetim için ne tür sunucu denetimleri içerdiği özetlenmiştir.

CatalogZone sınıfı, temel sınıfının davranışına yalnızca bir bölge şablonu eklediğinden, birkaç üyesi vardır. CatalogZone Oluşturucu parametresiz bir oluşturucudur; bununla birlikte sınıfının yeni bir örneğini CatalogZone başlatabilirsiniz. özelliği, ZoneTemplate bölge denetimlerini içeren nesneye ITemplate başvuru alır veya ayarlar. CreateCatalogParts yöntemi kritiktir. Bölge şablonunda yer alan tüm CatalogPart denetimlerin koleksiyonunu oluşturmak için temel yöntemi geçersiz kılar.

Erişilebilirlik

Bu denetim için varsayılan olarak işlenen işaretleme, Web İçeriği Erişilebilirlik Yönergeleri 1.0 (WCAG) öncelik 1 yönergeleri gibi erişilebilirlik standartlarına uygun olmayabilir. Bu denetim için erişilebilirlik desteği hakkında ayrıntılı bilgi için bkz. denetimler ve erişilebilirlik ASP.NET.

Devralanlara Notlar

Katalog kullanıcı arabiriminin işlenmesi ve davranışı üzerinde daha fazla denetime ihtiyacınız varsa özel CatalogZone sınıflar oluşturabilirsiniz. Denetiminizin kullanıcılarına bildirimli olarak denetim ekleme CatalogPart olanağı sağlamanız gerekmiyorsa doğrudan sınıfından CatalogZoneBase devralabilirsiniz. Denetimlerin bildirim temelli olarak eklenmesini etkinleştirmek istiyorsanız, temel bölge şablonunu sağladığından basit yaklaşım sınıftan CatalogZone devralmaktır.

sınıfından CatalogZone devralırsanız, özel denetimleri bölgenize ekleme üzerinde daha fazla programlı denetim istiyorsanız yöntemini geçersiz kılabilir CreateCatalogParts() ve yöntemini kullanarak öğesine CatalogPartCollectionözel CatalogPart denetimler ekleyebilirsinizCatalogPart.

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Belirtik Arabirim Kullanımları

Uzantı Metotları

Şunlara uygulanır

Ayrıca bkz.

• CatalogPart
• Web Bölümleri Denetim Kümesine Genel Bakış
• Web Bölümleri Kişiselleştirmeye Genel Bakış
• Web Bölümleri Denetimlerini ASP.NET