Aracılığıyla paylaş


CatalogZoneBase Sınıf

Tanım

Katalog görevi görecek tüm bölge denetimleri için temel sınıf görevi görür. Kataloglar, kullanıcıların Web sayfasına ekleyebilecekleri denetimlerin WebPart listesini içerir.

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
Devralma
Türetilmiş
Uygulamalar

Örnekler

Aşağıdaki kod örneği, sınıfının çeşitli bildirim temelli ve programlı kullanımlarını CatalogZoneBase gösterir. sınıf soyut olduğundan, kod örnekleri Web Bölümleri denetim kümesiyle birlikte gelen türetilmiş CatalogZone sınıfı kullanır ve sınıftan CatalogZoneBase devraldığı özellikleri ve yöntemleri 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.

  • Bir denetime başvuru içeren bir CatalogZone Web sayfası ve bazı anahtar CatalogZoneBase sınıf üyelerinin kullanımını gösteren bir kod.

  • Özel WebPart denetime eklenen özel CatalogZone denetim.

  • Örneğin tarayıcıda nasıl çalıştığını gösteren açıklama.

Bu kod örneğinin ilk bölümü, sayfadaki görüntüleme modlarını değiştirmenize 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="&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>

Kod örneğinin ikinci bölümü, denetime bildirim temelli başvuru içeren bir CatalogZone Web sayfasıdır. Sayfanın üst kısmına yakın iki yönerge vardır Register : biri kullanıcı denetimi için, diğeri de özel WebPart denetim için. öğesinin <asp:WebPartZone> altında özel WebPart denetime ve ASP.NET <asp: CatalogZone>Calendar denetimine bildirim temelli başvurular içeren bir öğe olduğuna dikkat edin. Ayrıca bölge, görünümünü ve davranışını belirlemek için ayarlanmış çeşitli etiketlere ve özelliklere sahiptir. <script> Sayfadaki etiketler arasında, çoğu üyelerin çeşitli programlı kullanımlarını CatalogZoneBase gösteren çeşitli olay işleme kodu bulunur.

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

Kod örneğinin üçüncü bölümü adlı TextDisplayWebPartözel WebPart denetimdir. Bölge içinde bildirilir ve bir son kullanıcı bunu katalogdan sayfaya ekleyebilir. 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. Her iki derleme yönteminin de gösterimi 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
{
  [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

Kod örneğinin çalışması için, Web Bölümleri açıklama dosyalarını dışarı aktarmayı etkinleştirmek için Web.config dosyasına eklemeniz gereken bir ayar olduğunu unutmayın. Bu kod örneğinin Web sayfasıyla aynı dizinde bir Web.config dosyanız olduğundan emin olun. <system.web> bölümünde, aşağıdaki işaretlemede olduğu gibi özniteliği olarak ayarlanmış truebir enableExport öğe olduğundan emin olun<webParts>.

<webParts enableExport="true">

...

</webParts>

Sayfayı bir tarayıcıya yüklediğinizde, katalog görüntüleme moduna geçmek için açılan liste kutusundan Katalog'a tıklayabilirsiniz. Katalog görünür olduğunda, katalogdan sayfaya eklenebilen iki sunucu denetimini görebilir ve kullanıcı arabiriminde sınıf üyelerinin bildirim temelli ve programlı kullanımlarının CatalogZoneBase etkilerini de not edebilirsiniz.

Açıklamalar

CatalogZoneBase sınıfı, sınıfından ToolZone devralan bir temel sınıftır. Türetilmiş bölgeler için temel bir davranış kümesi sağlar.

sınıfı, CatalogZoneBase kullanıcıların Web sayfalarına denetimler ve diğer sunucu denetimleri eklemesine WebPart olanak tanıyan benzersiz bir kullanıcı arabirimi (UI) sağlar. gibi CatalogZonesınıfından CatalogZoneBase türetilen denetimler, aslında Web sayfalarına yerleştirilen denetimlerdir. Kullanıcıların sayfaya eklemesi için sunucu denetimleri listeleri oluşturan ve denetim olarak CatalogPart bilinen diğer denetimler için kapsayıcı görevi görürler. Sınıfından CatalogZoneBase türetilen bölgeler yalnızca sayfa katalog görüntüleme modunda olduğunda görüntülenebilir.

Not

Bir CatalogZoneBase bölge yalnızca CatalogPart denetimler içerebilir ve bunun tersine denetimler CatalogPart yalnızca CatalogZoneBase bölgelerde bulunabilir.

Bir kataloğa sunucu denetimleri ekleme mekanizması, temel CatalogPart sınıftan türetilen üç denetimden oluşan aşağıdaki kümedir.

Denetim Description
PageCatalogPart Sayfada kapatılmış denetimlere yönelik başvuruları korur. Bu denetimler kullanıcılar tarafından yeniden açılabilir (sayfaya geri eklenebilir).
DeclarativeCatalogPart Web sayfasının işaretlemesinde Web Bölümleri kataloğunda bildirilen denetimlere başvurular içerir. Bu denetimler, kullanıcılar tarafından bir Web sayfasına eklenebilir.
ImportCatalogPart Denetimin bir Web sayfasına eklenebilmesi için bir kullanıcının bir tanım dosyasını kataloğa yüklemesi için kullanıcı arabirimini sağlar. Tanım dosyaları, ile xml dosyasıdır. Denetimin ayarlarını içeri aktaran Web Bölümü dosya adı uzantısı. Tanım dosyasının içeri aktarılabilmesi için önce denetimin sunucuda mevcut olması gerekir.

sınıfı, CatalogZoneBase denetim kataloglarını WebPart görüntülemek için yararlı olan bir dizi özelliğe sahiptir. AddVerb özelliği katalogdan seçilen bir denetimi sayfaya ekleyen fiillere başvururkenCloseVerb, özellik kataloğu kapatan ve sayfanın görüntüleme modunu göz atma moduna döndüren bir fiile başvurur. özelliği, CatalogParts bölgedeki tüm CatalogPart denetimlerin koleksiyonuna başvurur. , HeaderText, ve InstructionTextgibi EmptyZoneTextçeşitli metin odaklı özellikler, kataloglar için uygun varsayılan metin sağlamak için temel özellikleri geçersiz kılar. özelliği, SelectTargetZoneText kullanıcıların denetimin hangi bölgeye ekleneceğini seçmesine olanak tanıyan açılan liste denetiminin yanı sıra metni içerir.

Sınıfına CatalogZoneBase birkaç başka özellik daha eklenir. SelectedCatalogPartID özelliği, seçili CatalogPart durumdaki denetim için benzersiz bir dize tanımlayıcısıdır. özelliği, ShowCatalogIcons özelliği bir WebPart denetimde ayarlayarak denetimlerle ilişkilendirilebilen simgelerin CatalogIconImageUrl gösterilip gösterilmeyeceğini gösterir.

özelliği, PartLinkStyle bölgede şu anda seçili olmayan denetimlerin CatalogPart bağlantılarının stil özniteliklerini içerir. Buna karşılık özelliği, SelectedPartLinkStyle kullanıcının o anda bölgede seçtiği denetime CatalogPart yönelik bir bağlantı için stil öznitelikleri içerir.

Özelliklere ek olarak, sınıfında, diğer temel denetimlerden devralınan standart olay işleme ve işleme yöntemlerine ek olarak, denetim kataloglarını işlemek için benzersiz olarak tasarlanmış bazı yöntemler CatalogZoneBase de vardır. yöntemi, CreateCatalogPartChrome bölgedeki her CatalogPart denetimi çevreleyen ve ayrıca denetimler için işlemeyi işleyen kromu (kenarlık, fiil, simge ve başlık gibi çevre birimi kullanıcı arabirimi öğeleri) oluşturur. CreateCatalogParts yöntemi soyut bir yöntemdir; türetilmiş sınıflar, bölgede bulunan tüm denetimlerin CatalogPart örneklerini oluşturmak için bunu geçersiz kılar. Bölgedeki InvalidateCatalogParts denetim koleksiyonu programlı bir nedenle değişirse ve türetilen sınıfın CatalogPart koleksiyonu yeniden oluşturması gerekiyorsa yöntemi türetilmiş bir sınıf tarafından çağrılabilir. yöntemi LoadPostData , sayfa sunucuya geri gönderildiğinde katalogdaki denetimlerin WebPart yanındaki onay kutuları için önceden var olan durumu yükler; bunun tersine, SaveControlState yöntem onay kutularının durumunu kaydeder. Son olarak yöntemi, RenderCatalogPartLinks bölgede yer alan her CatalogPart denetime bağlantılar için tüm işlemeyi sağlar.

Uygulayanlara Notlar

Barındırma CatalogPart denetimleri için özel bir bölge geliştirmek istiyorsanız, bölge şablonu desteği sağlamak isteyip istemediğinizi belirlemeniz gerekir. Bölge şablonu arabirimini uygulayan ITemplate türler tarafından oluşturulur ve web sayfasının bildirim temelli işaretlemesinde bölgenizdeki denetimlere başvurmak CatalogPart için özel bölgenizi kullanan sayfa geliştiricileri etkinleştirmek istiyorsanız gereklidir. Bölge şablonu desteğine ihtiyacınız varsa sınıfından CatalogZone devralınmalıdır. Buna karşılık, özel bölgeniz ve CatalogPart denetimleri kendi içinde olacaksa ve sayfa geliştiricilerinin denetimleri bir bölge şablonunda bildirimli olarak belirtmesi için herhangi bir seçenek olmadan program aracılığıyla oluşturulacaksa, doğrudan sınıfından CatalogZoneBase devralabilirsiniz. sınıfından CatalogZoneBase devralırsanız, yöntemini geçersiz kılmanız CreateCatalogParts() ve kataloğunuzda olmasını istediğiniz veya diğer sunucu denetimlerini bir CatalogPartCollection nesneye eklemeniz WebPart gerekir.

Oluşturucular

CatalogZoneBase()

Sınıfı devralınan bir sınıf örneği tarafından kullanılmak üzere başlatır. Bu oluşturucu yalnızca devralınan bir sınıf tarafından çağrılabilir.

Özellikler

AccessKey

Web sunucusu denetimine hızla gitmenize olanak tanıyan erişim anahtarını alır veya ayarlar.

(Devralındığı yer: WebControl)
Adapter

Denetim için tarayıcıya özgü bağdaştırıcıyı alır.

(Devralındığı yer: Control)
AddVerb

Son kullanıcıların katalogdan WebPartVerb Web Bölümleri sayfasına denetim eklemesine olanak tanıyan bir nesneye başvuru alır.

AppRelativeTemplateSourceDirectory

Bu denetimi içeren veya nesnesinin Page uygulama göreli sanal dizinini alır veya UserControl ayarlar.

(Devralındığı yer: Control)
AssociatedDisplayModes

Belirli ToolZone bir bölgeyle ilişkili nesne koleksiyonunu WebPartDisplayMode alır.

(Devralındığı yer: ToolZone)
Attributes

Denetimdeki özelliklere karşılık gelen rastgele özniteliklerin (yalnızca işleme için) koleksiyonunu alır.

(Devralındığı yer: WebControl)
BackColor

Web sunucusu denetiminin arka plan rengini alır veya ayarlar.

(Devralındığı yer: WebControl)
BackImageUrl

Bölge için arka plan görüntüsü URL'sini alır veya ayarlar.

(Devralındığı yer: WebZone)
BindingContainer

Bu denetimin veri bağlamasını içeren denetimi alır.

(Devralındığı yer: Control)
BorderColor

Web denetiminin kenarlık rengini alır veya ayarlar.

(Devralındığı yer: WebControl)
BorderStyle

Web sunucusu denetiminin kenarlık stilini alır veya ayarlar.

(Devralındığı yer: WebControl)
BorderWidth

Web sunucusu denetiminin kenarlık genişliğini alır veya ayarlar.

(Devralındığı yer: WebControl)
CatalogPartChrome

Bölgeyle CatalogZoneBase ilişkili sınıfın örneğine CatalogPartChrome başvuru alır.

CatalogParts

Bir bölgede bulunan tüm denetimlerin CatalogPartCatalogZoneBase koleksiyonunu alır.

ChildControlsCreated

Sunucu denetiminin alt denetimlerinin oluşturulup oluşturulmadığını gösteren bir değer alır.

(Devralındığı yer: Control)
ClientID

ASP.NET tarafından oluşturulan HTML işaretlemesinin denetim kimliğini alır.

(Devralındığı yer: Control)
ClientIDMode

özelliğinin değerini oluşturmak için kullanılan algoritmayı ClientID alır veya ayarlar.

(Devralındığı yer: Control)
ClientIDSeparator

özelliğinde ClientID kullanılan ayırıcı karakteri temsil eden bir karakter değeri alır.

(Devralındığı yer: Control)
CloseVerb

Son kullanıcıların katalog kullanıcı arabirimini (UI) kapatmasını ve sayfayı normal göz atma moduna döndürmesini sağlayan bir WebPartVerb nesneye başvuru alır.

Context

HttpContext Geçerli Web isteği için sunucu denetimiyle ilişkili nesneyi alır.

(Devralındığı yer: Control)
Controls

içindeki alt denetimleri temsil eden bir ControlCollectionCompositeControlnesnesi alır.

(Devralındığı yer: CompositeControl)
ControlStyle

Web sunucusu denetiminin stilini alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
ControlStyleCreated

Özelliği için ControlStyle bir nesne oluşturulup oluşturulmadığını belirten bir Style değer alır. Bu özellik öncelikli olarak denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
CssClass

İstemcideki Web sunucusu denetimi tarafından işlenen Basamaklı Stil Sayfası (CSS) sınıfını alır veya ayarlar.

(Devralındığı yer: WebControl)
DataItemContainer

Adlandırma kapsayıcısı uygularsa IDataItemContaineradlandırma kapsayıcısına bir başvuru alır.

(Devralındığı yer: Control)
DataKeysContainer

Adlandırma kapsayıcısı uygularsa IDataKeysControladlandırma kapsayıcısına bir başvuru alır.

(Devralındığı yer: Control)
DesignMode

Bir denetimin tasarım yüzeyinde kullanılıp kullanılmadığını belirten bir değer alır.

(Devralındığı yer: Control)
Display

Denetimin şu anda görüntülenip görüntülenmediğini gösteren bir ToolZone değer alır.

(Devralındığı yer: ToolZone)
EditUIStyle

Bir ToolZone denetimde yer alan düzenlenebilir denetimlerin stil özniteliklerini alır.

(Devralındığı yer: ToolZone)
EmptyZoneText

Bir bölge denetim içermediğinde görüntülenen bir iletiyi alır veya ayarlar.

EmptyZoneTextStyle

Boş bir bölgedeki yer tutucu metnin stil özniteliklerini alır.

(Devralındığı yer: WebZone)
Enabled

Web sunucusu denetiminin etkinleştirilip etkinleştirilmediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: WebControl)
EnableTheming

Temaların bu denetime uygulanıp uygulanmadığını belirten bir değer alır veya ayarlar.

(Devralındığı yer: WebControl)
EnableViewState

Sunucu denetiminin görünüm durumunu ve içerdiği alt denetimlerin görünüm durumunu istekte bulunan istemciye kalıcı hale getirip getirmek olmadığını belirten bir değer alır veya ayarlar.

(Devralındığı yer: Control)
ErrorStyle

Bir denetim yüklenemediğinde veya oluşturulamadığında WebPart görüntülenen hata iletisini işlemek için stil özniteliklerini alır.

(Devralındığı yer: WebZone)
Events

Denetim için olay işleyicisi temsilcilerinin listesini alır. Bu özellik salt okunur durumdadır.

(Devralındığı yer: Control)
Font

Web sunucusu denetimiyle ilişkili yazı tipi özelliklerini alır.

(Devralındığı yer: WebControl)
FooterStyle

Bölgenin alt bilgi alanının içeriğinin stil özniteliklerini alır.

(Devralındığı yer: WebZone)
ForeColor

Web sunucusu denetiminin ön plan rengini (genellikle metnin rengi) alır veya ayarlar.

(Devralındığı yer: WebControl)
HasAttributes

Denetimin öznitelikleri ayarlanıp ayarlanmadığını belirten bir değer alır.

(Devralındığı yer: WebControl)
HasChildViewState

Geçerli sunucu denetiminin alt denetimlerinin kaydedilmiş görünüm durumu ayarlarına sahip olup olmadığını gösteren bir değer alır.

(Devralındığı yer: Control)
HasFooter

Bir bölgenin alt bilgi alanına sahip olup olmadığını belirten bir değer alır.

(Devralındığı yer: WebZone)
HasHeader

Bir bölgenin üst bilgi alanına sahip olup olmadığını belirten bir değer alır.

(Devralındığı yer: WebZone)
HeaderCloseVerb

Denetimi kapatmak için WebPartVerb kullanılan bir ToolZone denetimin üst bilgisindeki nesneye başvuru alır.

(Devralındığı yer: ToolZone)
HeaderStyle

Bir bölgenin üst bilgi alanının içeriği için stil özniteliklerini alır.

(Devralındığı yer: WebZone)
HeaderText

Bir bölgenin üst bilgi alanının metnini alır veya ayarlar.

HeaderVerbStyle

Denetimde görüntülenen ToolZone tüm üst bilgi fiillerinin stil özniteliklerini alır.

(Devralındığı yer: ToolZone)
Height

Web sunucusu denetiminin yüksekliğini alır veya ayarlar.

(Devralındığı yer: WebControl)
ID

Sunucu denetimine atanan program tanımlayıcısını alır veya ayarlar.

(Devralındığı yer: Control)
IdSeparator

Denetim tanımlayıcılarını ayırmak için kullanılan karakteri alır.

(Devralındığı yer: Control)
InstructionText

Son kullanıcılar için yol tarifleri sağlayan bir bölgedeki metni alır veya ayarlar.

InstructionTextStyle

Denetimin en üstünde ToolZone görünen yönerge metninin stil özniteliklerini alır.

(Devralındığı yer: ToolZone)
IsChildControlStateCleared

Bu denetim içindeki denetimlerin denetim durumuna sahip olup olmadığını belirten bir değer alır.

(Devralındığı yer: Control)
IsEnabled

Denetimin etkinleştirilip etkinleştirilmediğini belirten bir değer alır.

(Devralındığı yer: WebControl)
IsTrackingViewState

Sunucu denetiminin değişiklikleri görünüm durumuna kaydedip kaydetmediğini gösteren bir değer alır.

(Devralındığı yer: Control)
IsViewStateEnabled

Bu denetim için görünüm durumunun etkinleştirilip etkinleştirilmediğini belirten bir değer alır.

(Devralındığı yer: Control)
LabelStyle

Bir denetim içindeki düzenleme denetimleriyle ToolZone birlikte görüntülenen etiketlerin içeriği için stil özniteliklerini alır. ve EditorZonegibi CatalogZone türetilmiş ToolZone denetimler, stilleri etiketlere uygular.

(Devralındığı yer: ToolZone)
LoadViewStateByID

Denetimin dizin yerine görünüm durumunu ID yüklemeye katılıp katılmadığını belirten bir değer alır.

(Devralındığı yer: Control)
NamingContainer

Aynı özellik değerine sahip sunucu denetimleri arasında ayrım yapmak için benzersiz bir ad alanı oluşturan sunucu denetiminin adlandırma kapsayıcısına ID başvuru alır.

(Devralındığı yer: Control)
Padding

Bir bölgedeki denetimleri içeren WebPart tablodaki hücre doldurma özniteliklerini alır veya ayarlar.

(Devralındığı yer: WebZone)
Page

Sunucu denetimini içeren örneğe başvuru Page alır.

(Devralındığı yer: Control)
Parent

Sayfa denetimi hiyerarşisindeki sunucu denetiminin üst denetimine başvuru alır.

(Devralındığı yer: Control)
PartChromePadding

Denetimin içeriğiyle denetimin kenarlığı WebPart arasındaki uzaklığı alır veya ayarlar.

(Devralındığı yer: WebZone)
PartChromeStyle

Bir bölgenin içerdiği Web Bölümleri denetimlerinin kenarlıklarına uygulanan stil özelliklerini alır.

(Devralındığı yer: WebZone)
PartChromeType

Bir bölgenin içerdiği Web Bölümleri denetimlerini çerçeveleyen kenarlık türünü alır veya ayarlar.

(Devralındığı yer: WebZone)
PartLinkStyle

Bölgede şu anda seçili olmayan denetimler için CatalogPart stil öznitelikleri içeren bir nesne alır.

PartStyle

Bir bölgenin içerdiği her Web Bölümü denetiminin kenarlık ve içeriğine uygulanan stil özelliklerini alır.

(Devralındığı yer: WebZone)
PartTitleStyle

Bir bölgenin içerdiği her Web Bölümü denetimi için başlık çubuğu içeriğinin stil özniteliklerini alır.

(Devralındığı yer: WebZone)
RenderClientScript

Web Bölümleri sayfasında istemci betiğinin işlenip işlenmeyeceğini belirten bir değer alır.

(Devralındığı yer: WebZone)
RenderingCompatibility

HTML'nin uyumlu olacağı ASP.NET sürümünü belirten bir değer alır.

(Devralındığı yer: Control)
SelectedCatalogPartID

Bir dizeyi bir bölgede seçili CatalogPart durumdaki denetim için tanımlayıcı olarak alır veya ayarlar.

SelectedPartLinkStyle

Bölgede seçili durumdaki denetimin CatalogPart stil özniteliklerini içeren bir nesneyi alır.

SelectTargetZoneText

Kullanıcıların seçili denetimlerini ekleyecekleri bölgeyi seçmesine olanak tanıyan katalog kullanıcı arabirimindeki (UI) denetimiyle birlikte metni alır veya ayarlar.

ShowCatalogIcons

Katalogdaki sunucu denetimlerinin katalogda ilişkili simgelerini görüntüleyip görüntülemediğini belirten bir değer alır veya ayarlar.

Site

Tasarım yüzeyinde işlendiğinde geçerli denetimi barındıran kapsayıcı hakkında bilgi alır.

(Devralındığı yer: Control)
SkinID

Denetime uygulanacak kaplamayı alır veya ayarlar.

(Devralındığı yer: WebControl)
Style

Web sunucusu denetiminin dış etiketinde stil özniteliği olarak işlenecek metin öznitelikleri koleksiyonunu alır.

(Devralındığı yer: WebControl)
SupportsDisabledAttribute

Denetimin özelliği falseolduğundaIsEnabled, denetimin işlenen HTML öğesinin özniteliğini "devre dışı" olarak ayarlayıp ayarlamayacağını disabled belirten bir değer alır.

(Devralındığı yer: CompositeControl)
TabIndex

Web sunucusu denetiminin sekme dizinini alır veya ayarlar.

(Devralındığı yer: WebControl)
TagKey

HtmlTextWriterTag Bu Web sunucusu denetimine karşılık gelen değeri alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebZone)
TagName

Denetim etiketinin adını alır. Bu özellik öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
TemplateControl

Bu denetimi içeren şablona başvuru alır veya ayarlar.

(Devralındığı yer: Control)
TemplateSourceDirectory

Geçerli sunucu denetimini içeren veya UserControl sanal dizinini Page alır.

(Devralındığı yer: Control)
ToolTip

Fare işaretçisi Web sunucusu denetiminin üzerine geldiğinde görüntülenen metni alır veya ayarlar.

(Devralındığı yer: WebControl)
UniqueID

Sunucu denetimi için benzersiz, hiyerarşik olarak nitelenmiş tanımlayıcıyı alır.

(Devralındığı yer: Control)
ValidateRequestMode

Denetimin tarayıcıdan istemci girişini tehlikeli olabilecek değerler için denetlediğini belirten bir değer alır veya ayarlar.

(Devralındığı yer: Control)
VerbButtonType

Bir bölgedeki fiilleri temsil etmek için ne tür bir düğme kullanıldığını alır veya ayarlar.

(Devralındığı yer: WebZone)
VerbStyle

Bir bölgedeki Web Bölümleri denetimleriyle ilişkili kullanıcı arabirimi (UI) fiillerinin stil özniteliklerini alır.

(Devralındığı yer: WebZone)
ViewState

Aynı sayfa için birden çok istekte bir sunucu denetiminin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum bilgileri sözlüğü alır.

(Devralındığı yer: Control)
ViewStateIgnoresCase

Nesnenin StateBag büyük/küçük harfe duyarlı olup olmadığını gösteren bir değer alır.

(Devralındığı yer: Control)
ViewStateMode

Bu denetimin görünüm durumu modunu alır veya ayarlar.

(Devralındığı yer: Control)
Visible

Sunucu denetiminin sayfada kullanıcı arabirimi (UI) öğesi olarak işlenip işlenmediğini gösteren bir değeri alır veya ayarlar.

(Devralındığı yer: ToolZone)
WebPartManager

Web Bölümleri sayfasındaki bir WebZone denetim örneğiyle ilişkili denetime başvuru WebPartManager alır.

(Devralındığı yer: WebZone)
Width

Web sunucusu denetiminin genişliğini alır veya ayarlar.

(Devralındığı yer: WebControl)

Yöntemler

AddAttributesToRender(HtmlTextWriter)

Belirtilen HtmlTextWriterTagöğesine işlenmesi gereken HTML öznitelikleri ve stilleri ekler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
AddedControl(Control, Int32)

Nesne koleksiyonuna Controls bir alt denetim eklendikten sonra çağrılır Control .

(Devralındığı yer: Control)
AddParsedSubObject(Object)

Xml veya HTML gibi bir öğenin ayrıştırıldığını sunucu denetimine bildirir ve öğeyi sunucu denetiminin ControlCollection nesnesine ekler.

(Devralındığı yer: Control)
ApplyStyle(Style)

Belirtilen stilin boş olmayan öğelerini Web denetimine kopyalar ve denetimin varolan stil öğelerinin üzerine yazar. Bu yöntem öncelikli olarak denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
ApplyStyleSheetSkin(Page)

Sayfa stili sayfasında tanımlanan stil özelliklerini denetime uygular.

(Devralındığı yer: Control)
BeginRenderTracing(TextWriter, Object)

İşleme verilerinin tasarım zamanı izlemeye başlar.

(Devralındığı yer: Control)
BuildProfileTree(String, Boolean)

Sunucu denetimi hakkında bilgi toplar ve sayfa için izleme etkinleştirildiğinde görüntülenecek özelliğe teslim eder Trace .

(Devralındığı yer: Control)
ClearCachedClientID()

Önbelleğe alınan ClientID değeri olarak nullayarlar.

(Devralındığı yer: Control)
ClearChildControlState()

Sunucu denetiminin alt denetimleri için denetim durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearChildState()

Tüm sunucu denetiminin alt denetimleri için görünüm durumu ve denetim durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearChildViewState()

Tüm sunucu denetiminin alt denetimleri için görünüm durumu bilgilerini siler.

(Devralındığı yer: Control)
ClearEffectiveClientIDMode()

ClientIDMode Geçerli denetim örneğinin ve alt denetimlerin özelliğini olarak Inheritayarlar.

(Devralındığı yer: Control)
Close()

Web sayfasını katalog görüntüleme modundan normal göz atma moduna geçirir.

CopyBaseAttributes(WebControl)

Nesne tarafından Style kapsüllenmeyen özellikleri belirtilen Web sunucusu denetiminden bu yöntemin çağrıldığı Web sunucusu denetimine kopyalar. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
CreateCatalogPartChrome()

Bir CatalogPartChrome bölgedeki denetimler için çevre birimi kullanıcı arabirimi (UI) öğelerini işlemek için CatalogPart kullanılan bir nesnenin örneğini oluşturur.

CreateCatalogParts()

Türetilmiş bölgelerin, bir bölgede bulunan denetimleri oluşturmanın CatalogPart ayrıntılarını işlemek için geçersiz kılabileceği bir temel yöntem bildirimi sağlar.

CreateChildControls()

Bir CatalogZoneBase bölgeyle ilişkili alt denetim kümesini oluşturur.

CreateControlCollection()

Sunucu denetiminin alt denetimlerini (hem değişmez değer hem de sunucu) tutmak için yeni ControlCollection bir nesne oluşturur.

(Devralındığı yer: Control)
CreateControlStyle()

Sınıf tarafından WebControl stille ilgili tüm özellikleri uygulamak için dahili olarak kullanılan stil nesnesini oluşturur. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
DataBind()

Bir veri kaynağını CompositeControl ve tüm alt denetimlerine bağlar.

(Devralındığı yer: CompositeControl)
DataBind(Boolean)

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine olayı tetikle DataBinding seçeneğiyle bağlar.

(Devralındığı yer: Control)
DataBindChildren()

Bir veri kaynağını sunucu denetiminin alt denetimlerine bağlar.

(Devralındığı yer: Control)
Dispose()

Sunucu denetiminin bellekten serbest bırakılmadan önce son temizleme işlemini gerçekleştirmesini sağlar.

(Devralındığı yer: Control)
EndRenderTracing(TextWriter, Object)

İşleme verilerinin tasarım zamanı izlemesini sonlandırır.

(Devralındığı yer: Control)
EnsureChildControls()

Sunucu denetiminin alt denetimler içerip içermediğini belirler. Aksi takdirde alt denetimler oluşturur.

(Devralındığı yer: Control)
EnsureID()

Atanmış tanımlayıcısı olmayan denetimler için bir tanımlayıcı oluşturur.

(Devralındığı yer: Control)
Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
FindControl(String)

Belirtilen id parametreyle geçerli adlandırma kapsayıcısında bir sunucu denetimi arar.

(Devralındığı yer: Control)
FindControl(String, Int32)

Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde belirtilen id bir tamsayı ile bir sunucu denetimi arar ve bu da pathOffset aramaya yardımcı olur. Yöntemin bu sürümünü FindControl geçersiz kılmamalısınız.

(Devralındığı yer: Control)
Focus()

Giriş odağını bir denetime ayarlar.

(Devralındığı yer: Control)
GetDesignModeState()

Denetim için tasarım zamanı verilerini alır.

(Devralındığı yer: Control)
GetEffectiveChromeType(Part)

Bölgenin özelliği ve Web Bölümleri sayfasının geçerli görüntüleme modu göz önünde bulundurularak PartChromeType denetimin WebPart gerçek veya geçerli geçerli PartChromeType değerini döndürür.

(Devralındığı yer: WebZone)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetRouteUrl(Object)

Bir yol parametreleri kümesine karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(RouteValueDictionary)

Bir yol parametreleri kümesine karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(String, Object)

Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetRouteUrl(String, RouteValueDictionary)

Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır.

(Devralındığı yer: Control)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
GetUniqueIDRelativeTo(Control)

Belirtilen denetimin özelliğinin UniqueID ön ekli bölümünü döndürür.

(Devralındığı yer: Control)
HasControls()

Sunucu denetiminin alt denetimler içerip içermediğini belirler.

(Devralındığı yer: Control)
HasEvents()

Olayların denetim için mi yoksa alt denetimler için mi kaydedildiğini gösteren bir değer döndürür.

(Devralındığı yer: Control)
InvalidateCatalogParts()

Bir CatalogZoneBase bölgeyle ilişkili denetim koleksiyonunu CatalogPart yok eder.

IsLiteralContent()

Sunucu denetiminin yalnızca değişmez değer içeriğini barındırdığını belirler.

(Devralındığı yer: Control)
LoadControlState(Object)

Görünüm durumu denetimde devre dışı bırakıldığında bile geri göndermelerde kalıcı olması gereken denetim özellikleri için önceki sayfa isteğinden gelen durumu yükler.

LoadPostData(String, NameValueCollection)

Sayfa sunucuya geri gönderildiğinde, katalogdaki denetimlere WebPart karşılık gelen onay kutularının durumunu işler.

LoadViewState(Object)

Bir bölge için daha önce kaydedilmiş durum bilgilerini yükler.

MapPathSecure(String)

Bir sanal yolun mutlak veya göreli olarak eşlene olduğu fiziksel yolu alır.

(Devralındığı yer: Control)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
MergeStyle(Style)

Belirtilen stilin boş olmayan öğelerini Web denetimine kopyalar, ancak denetimin varolan stil öğelerinin üzerine yazılmaz. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
OnBubbleEvent(Object, EventArgs)

Sunucu denetimi olayının sayfanın UI sunucu denetim hiyerarşisine geçirilip geçirilmeyeceğini belirler.

(Devralındığı yer: Control)
OnDataBinding(EventArgs)

Olayı tetikler DataBinding .

(Devralındığı yer: Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)

Türetilmiş ToolZone denetimlerin özelleştirilmiş bir bölge için sayfa görüntüleme modlarını değiştirme ayrıntılarını işlemek için geçersiz kılabileceği bir temel yöntem bildirimi sağlar.

(Devralındığı yer: ToolZone)
OnInit(EventArgs)

Sayfanın denetim durumu gerektirmesi için sayfa nesnesini kaydeder.

OnLoad(EventArgs)

Olayı tetikler Load .

(Devralındığı yer: Control)
OnPreRender(EventArgs)

PreRender Olayı oluşturur ve sayfa nesnesini geri gönderme gerektirecek şekilde kaydeder.

OnSelectedWebPartChanged(Object, WebPartEventArgs)

Türetilmiş ToolZone denetimlerin, özelleştirilmiş bir bölge içinde hangi Web Bölümleri denetiminin seçildiğini değiştirme olayını işlemek için geçersiz kılabileceği bir temel yöntem bildirimi sağlar.

(Devralındığı yer: ToolZone)
OnUnload(EventArgs)

Olayı tetikler Unload .

(Devralındığı yer: Control)
OpenFile(String)

Stream Bir dosyayı okumak için kullanılan alır.

(Devralındığı yer: Control)
RaiseBubbleEvent(Object, EventArgs)

Olayın tüm kaynaklarını ve bilgilerini denetimin üst öğesine atar.

(Devralındığı yer: Control)
RaisePostBackEvent(String)

Bölge fiillerinden biriyle ilişkili eylemleri yürütür veya sunucuya geri postalayan bir olay oluşturur.

RecreateChildControls()

alt denetimleri öğesinden CompositeControltüretilmiş bir denetimde yeniden oluşturur.

(Devralındığı yer: CompositeControl)
RemovedControl(Control)

Alt denetim nesne koleksiyonundan Controls kaldırıldıktan sonra çağrılır Control .

(Devralındığı yer: Control)
Render(HtmlTextWriter)

Bölgeyi belirtilen HtmlTextWriter nesneye işler.

RenderBeginTag(HtmlTextWriter)

Bölge denetiminin açılış HTML etiketini belirtilen HtmlTextWriter nesneye işler.

(Devralındığı yer: WebZone)
RenderBody(HtmlTextWriter)

sınıfından türetilen CatalogZoneBase bir bölgenin gövde alanını işlemek için temel yöntemi geçersiz kılar.

RenderCatalogPartLinks(HtmlTextWriter)

Bir bölgedeki tek tek CatalogPart denetimlere CatalogZoneBase bağlantıları işler.

RenderChildren(HtmlTextWriter)

Sunucu denetiminin alt öğelerinin içeriğini sağlanan bir HtmlTextWriter nesneye aktarır ve istemcide işlenecek içeriği yazar.

(Devralındığı yer: Control)
RenderContents(HtmlTextWriter)

Bir bölge denetiminin tüm içeriğini, belirtilen HtmlTextWriter nesneye başlangıç ve bitiş etiketleri arasında işler.

(Devralındığı yer: WebZone)
RenderControl(HtmlTextWriter)

Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve izleme etkinse denetimle ilgili izleme bilgilerini depolar.

(Devralındığı yer: Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Sağlanan bir nesneyi kullanarak sağlanan HtmlTextWriter bir nesneye sunucu denetimi içeriği çıkışı sağlar ControlAdapter .

(Devralındığı yer: Control)
RenderEndTag(HtmlTextWriter)

Denetimin HTML kapanış etiketini belirtilen yazıcıya işler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
RenderFooter(HtmlTextWriter)

Bir CatalogZoneBase bölge için alt bilgi alanını işler.

RenderHeader(HtmlTextWriter)

Denetimler için ToolZone gereken üst bilgi alanı için özelleştirilmiş işleme sağlamak üzere temel yöntemi geçersiz kılar.

(Devralındığı yer: ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)

Tek bir fiili bir ToolZone denetimle işler.

(Devralındığı yer: ToolZone)
RenderVerbs(HtmlTextWriter)

Bir bölgenin alt bilgi alanındaki fiilleri CatalogZoneBase işler.

ResolveAdapter()

Belirtilen denetimin işlenmesinden sorumlu denetim bağdaştırıcısını alır.

(Devralındığı yer: Control)
ResolveClientUrl(String)

Tarayıcı tarafından kullanılabilecek bir URL alır.

(Devralındığı yer: Control)
ResolveUrl(String)

URL'yi istekte bulunan istemcide kullanılabilen bir URL'ye dönüştürür.

(Devralındığı yer: Control)
SaveControlState()

Web sayfası sunucuya geri gönderildikten sonra bir denetimin durumundaki değişiklikleri CatalogZoneBase kaydeder.

SaveViewState()

Bir sayfa sunucuya geri gönderildikten sonra gerçekleşen görünüm durumu değişikliklerini kaydeder.

SetDesignModeState(IDictionary)

Denetim için tasarım zamanı verilerini ayarlar.

(Devralındığı yer: Control)
SetRenderMethodDelegate(RenderMethod)

Sunucu denetimini ve içeriğini üst denetimine işlemek için bir olay işleyicisi temsilcisi atar.

(Devralındığı yer: Control)
SetTraceData(Object, Object)

İzleme veri anahtarını ve izleme verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar.

(Devralındığı yer: Control)
SetTraceData(Object, Object, Object)

İzlenen nesneyi, izleme veri anahtarını ve izleme verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar.

(Devralındığı yer: Control)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
TrackViewState()

Bölge denetiminin görünüm durumundaki değişiklikleri izler.

Ekinlikler

DataBinding

Sunucu denetimi bir veri kaynağına bağlandığında gerçekleşir.

(Devralındığı yer: Control)
Disposed

ASP.NET sayfası istendiğinde sunucu denetimi yaşam döngüsünün son aşaması olan bellekten bir sunucu denetimi serbest bırakıldığında gerçekleşir.

(Devralındığı yer: Control)
Init

Sunucu denetimi başlatıldığında gerçekleşir ve bu, yaşam döngüsünün ilk adımıdır.

(Devralındığı yer: Control)
Load

Sunucu denetimi nesneye Page yüklendiğinde gerçekleşir.

(Devralındığı yer: Control)
PreRender

Nesne yüklendikten sonra Control ancak işlemeden önce gerçekleşir.

(Devralındığı yer: Control)
Unload

Sunucu denetimi bellekten kaldırıldığında gerçekleşir.

(Devralındığı yer: Control)

Belirtik Arabirim Kullanımları

IAttributeAccessor.GetAttribute(String)

Belirtilen ada sahip Web denetiminin özniteliğini alır.

(Devralındığı yer: WebControl)
IAttributeAccessor.SetAttribute(String, String)

Web denetiminin özniteliğini belirtilen ada ve değere ayarlar.

(Devralındığı yer: WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Tasarımcının tasarım zamanı ortamında bileşik denetimin alt denetim koleksiyonunu yeniden oluşturmasını sağlar.

(Devralındığı yer: CompositeControl)
IControlBuilderAccessor.ControlBuilder

Bu üyenin açıklaması için bkz ControlBuilder. .

(Devralındığı yer: Control)
IControlDesignerAccessor.GetDesignModeState()

Bu üyenin açıklaması için bkz GetDesignModeState(). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Bu üyenin açıklaması için bkz SetDesignModeState(IDictionary). .

(Devralındığı yer: Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Bu üyenin açıklaması için bkz SetOwnerControl(Control). .

(Devralındığı yer: Control)
IControlDesignerAccessor.UserData

Bu üyenin açıklaması için bkz UserData. .

(Devralındığı yer: Control)
IDataBindingsAccessor.DataBindings

Bu üyenin açıklaması için bkz DataBindings. .

(Devralındığı yer: Control)
IDataBindingsAccessor.HasDataBindings

Bu üyenin açıklaması için bkz HasDataBindings. .

(Devralındığı yer: Control)
IExpressionsAccessor.Expressions

Bu üyenin açıklaması için bkz Expressions. .

(Devralındığı yer: Control)
IExpressionsAccessor.HasExpressions

Bu üyenin açıklaması için bkz HasExpressions. .

(Devralındığı yer: Control)
IParserAccessor.AddParsedSubObject(Object)

Bu üyenin açıklaması için bkz AddParsedSubObject(Object). .

(Devralındığı yer: Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

LoadPostData(String, NameValueCollection) sınıfının yöntemini çağırarak LoadPostData(String, NameValueCollection) yöntemini CatalogZoneBase uygular.

IPostBackDataHandler.RaisePostDataChangedEvent()

Bu üyenin açıklaması için bkz RaisePostDataChangedEvent(). .

IPostBackEventHandler.RaisePostBackEvent(String)

RaisePostBackEvent(String) yöntemini uygular.

(Devralındığı yer: ToolZone)

Uzantı Metotları

FindDataSourceControl(Control)

Belirtilen denetim için veri denetimiyle ilişkili veri kaynağını döndürür.

FindFieldTemplate(Control, String)

Belirtilen denetimin adlandırma kapsayıcısında belirtilen sütun için alan şablonunu döndürür.

FindMetaTable(Control)

İçeren veri denetimi için metatablo nesnesini döndürür.

GetDefaultValues(INamingContainer)

Belirtilen veri denetimi için varsayılan değerlerin koleksiyonunu alır.

GetMetaTable(INamingContainer)

Belirtilen veri denetimi için tablo meta verilerini alır.

SetMetaTable(INamingContainer, MetaTable)

Belirtilen veri denetimi için tablo meta verilerini ayarlar.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Belirtilen veri denetimi için tablo meta verilerini ve varsayılan değer eşlemesini ayarlar.

SetMetaTable(INamingContainer, MetaTable, Object)

Belirtilen veri denetimi için tablo meta verilerini ve varsayılan değer eşlemesini ayarlar.

TryGetMetaTable(INamingContainer, MetaTable)

Tablo meta verilerinin kullanılabilir olup olmadığını belirler.

EnableDynamicData(INamingContainer, Type)

Belirtilen veri denetimi için Dinamik Veri davranışını etkinleştirir.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Belirtilen veri denetimi için Dinamik Veri davranışını etkinleştirir.

EnableDynamicData(INamingContainer, Type, Object)

Belirtilen veri denetimi için Dinamik Veri davranışını etkinleştirir.

Şunlara uygulanır

Ayrıca bkz.