Aracılığıyla paylaş

DeclarativeCatalogPart Sınıf

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls.WebParts
Bütünleştirilmiş Kod:
System.Web.dll

Geliştiricilerin WebPart web sayfasına bildirim temelli, sayfa kalıcılığı biçiminde bir veya başka sunucu denetimleri kataloğu eklemesini sağlar. Bu sınıf devralınamaz.

public ref class DeclarativeCatalogPart sealed : System::Web::UI::WebControls::WebParts::CatalogPart
public sealed class DeclarativeCatalogPart : System.Web.UI.WebControls.WebParts.CatalogPart
type DeclarativeCatalogPart = class
    inherit CatalogPart
Public NotInheritable Class DeclarativeCatalogPart
Inherits CatalogPart
Devralma
Object
Control
WebControl
Panel
Part
CatalogPart
DeclarativeCatalogPart

Örnekler

Aşağıdaki kod örneği, denetimin DeclarativeCatalogPart Web sayfasında bildirim temelli olarak nasıl kullanılacağını gösterir. Örnekte dört bölüm vardır:

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

  • Denetim ve denetim içeren bir CatalogZoneDeclarativeCatalogPart Web sayfası.

  • İki özel WebPart denetim içeren bir kaynak kod dosyası.

  • Sayfayı bir tarayıcıda yüklediğinizde örneğin nasıl çalıştığını gösteren bir 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=" 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ü Web sayfasıdır. Sayfanın üst kısmında biri kullanıcı denetimi, diğeri de iki özel WebPart denetimi içeren derlenmiş bileşen için iki yönerge bulunurRegister. Sayfanın, bu konunun Açıklamalar bölümünde açıklandığı gibi bildirim temelli öğelerin düzgün hiyerarşisinde iç içe yerleştirilmiş, denetime bildirim temelli bir başvurusu DeclarativeCatalogPart olduğuna dikkat edin. <asp:declarativecatalogpart> öğesi, standart bir ASP.NET Calendar denetimine ve iki özel WebPart denetime başvurular içeren bir <webpartstemplate> öğe içerir; bunlar kullanıcıların katalogdan seçebileceği denetimlerdir. Sayfada ayrıca, sayfada bildirilen bir PropertyGridEditorPart denetimle birlikte düzenleme özelliği de bulunur. Bu denetim, kullanıcıların sayfaya eklendikten sonra ve kullanıcı sayfayı düzenleme moduna geçtikten sonra özel WebPart denetimlerde belirli özellikleri düzenlemesine olanak tanır.

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

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

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

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

Kod örneğinin üçüncü bölümü, iki WebPart denetimin kaynak kodudur. Bu denetimlerde bazı özelliklerin WebBrowsable özniteliğiyle işaretlendiğini fark edin. Bu, denetimin PropertyGridEditorPart , denetimler düzenleme modundayken kullanıcının bu özellikleri düzenlemesi için kullanıcı arabirimini (UI) dinamik olarak oluşturmasını sağlar. Özellikler, düzenleme kullanıcı arabirimindeki her denetimin yanında görünen etiketin metnini belirtmek için bir WebDisplayName öznitelikle de işaretlenir.

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

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

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

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

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

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

      set { _userSpecialDate = value; }
    }

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

      set { _userJobType = (JobTypeName)value; }
    }

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

      set { _userIsCurrent = value; }
    }

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

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

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

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

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

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

      ChildControlsCreated = true;
    }

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

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

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

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

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

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

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

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

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

Namespace Samples.AspNet.VB.Controls

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

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

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

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

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

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

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

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

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

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

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()

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

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

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

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

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

      ChildControlsCreated = True

    End Sub

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

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

    End Sub

  End Class


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

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

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

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

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

    End Sub

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

    End Sub

  End Class

End Namespace

Sayfayı bir tarayıcıya yüklediğinizde, katalog moduna geçmek için Görüntü Modu açılan liste denetiminde Katalog Modu'nu seçin. Katalog modunda, sayfaya eklenebilen denetimleri görebilirsiniz. Üç denetimi de ekleyin ve ardından Görüntüleme Modu açılan listesini kullanarak sayfayı göz atma moduna döndürün. Sayfada üç denetim görünür. Görüntüleme Modu açılan listesini kullanır ve sayfayı düzenleme moduna geçirirseniz, Kullanıcı Bilgileri Web Bölümü denetiminin başlık çubuğunda fiiller menüsüne (aşağı ok) tıklayabilir ve denetimi düzenlemek için Düzenle'ye tıklayabilirsiniz. Düzenleme kullanıcı arabirimi görünür olduğunda denetimi görebilirsiniz PropertyGridEditorPart . özniteliğiyle işaretlenmiş sınıfın özelliklerinin her biri UserInfoWebPart için bir denetimin işlendiğine WebBrowsable dikkat edin. Düzenleme kullanıcı arabiriminde bazı değişiklikler yapar ve Uygula düğmesine tıklarsanız, sayfayı göz atma moduna döndürmek ve düzenleme değişikliklerinin tam etkisini görmek için Görüntüleme Modu açılan listesini kullanabilirsiniz.

Açıklamalar

Web Bölümleri denetim kümesinde araç odaklı bölgeler olduğu gibi (ayrıntılar için bkz ToolZone . sınıfa genel bakış), araç odaklı Part denetimler vardır ve bu denetimlerin her biri belirli bir araç bölgesinde bulunmalıdır. Web Bölümleri denetim kümesindeki araç odaklı parça denetimleri iki ayırt edici özelliğe sahiptir:

  • Bu denetimler, son kullanıcıların Web Bölümleri sayfasındaki denetimleri kişiselleştirmesine olanak tanıyan yardımcı denetimlerdir.

  • Bunlar yalnızca belirli görüntü modlarında görünür.

DeclarativeCatalogPart, Web Bölümleri denetim kümesiyle sağlanan bölge gibi CatalogZone bir bölge türünde bulunması gereken bir CatalogZoneBase parça denetimidir. Denetim DeclarativeCatalogPart yalnızca web sayfası katalog görüntüleme modunda olduğunda görünür hale gelir.

Denetim, geliştiricilerin DeclarativeCatalogPart Web sayfasındaki bir kataloğa bildirimli olarak bir sunucu denetimleri kümesi eklemesi için bir yol sağlar. Web Bölümleri denetim kümesindeki katalog, yalnızca bir sayfa katalog görüntüleme modundayken görünen veya diğer sunucu denetimlerinin listesidir WebPart . Bir kullanıcı, listeden denetimleri seçip Web sayfasına ekleyebilir ve bu sayede kullanıcılara bir sayfadaki denetim kümesini ve işlevselliğini etkili bir şekilde değiştirme olanağı tanır.

Not

Kullanıcılar bir katalogdaki aynı denetimin birden çok örneğini web sayfasına ekleyebilir.

Sunucu denetimleri kataloğu oluşturmak için denetim kullanmanın DeclarativeCatalogPart bir avantajı, herhangi bir kodlama gerektirmemesidir. Sayfa geliştiricileri denetimle tamamen bildirim temelli (veya sayfa kalıcılığı) biçiminde çalışabilir, bu nedenle denetimin adı.

Denetimin DeclarativeCatalogPart , geliştiricilerin sitenin tamamında kullanılabilecek bir denetim kataloğu ayarlamasına olanak tanıyan kullanışlı bir özelliği vardır. Bir geliştirici, bir DeclarativeCatalogPart denetim içindeki tek tek sunucu denetimlerini bildirmek yerine, özellik değerini katalogda olması gereken sunucu denetimlerinin listesini içeren bir kullanıcı denetiminin yoluna ayarlayabilir WebPartsListUserControlPath . Çalışma zamanında, kullanıcı denetiminde başvuruda bulunan sunucu denetimleri kataloğa yüklenir. Bu şekilde, birden çok sayfa veya site katalog oluşturmak için aynı kullanıcı denetimine başvurabilir. Kullanıcı denetiminin sunucu denetimleri listesi güncelleştirildiğinde, kullanıcı denetimine göre tüm katalogları güncelleştirir.

sınıfı, DeclarativeCatalogPart devralınan özellikleri geçersiz kılan bir dizi ortak özelliğe sahiptir. Bu özelliklerin çoğu aslında denetimi işlemek için kullanılmaz; bunlar yalnızca geçersiz kılınarak özel kod özniteliklerinin Microsoft Visual Studio 2005 gibi tasarım araçlarından gizlenmesi için bu öznitelikler üzerinde ayarlanabilir. İşleme üzerinde hiçbir etkisi olmadığından bu gizli özellikleri kullanmamalısınız. IntelliSense'ten ve Visual Studio'daki Özellikler bölmesinden gizlenmeleri, geliştiricilerin bunları yanlışlıkla kullanmaktan kaçınmalarına yardımcı olur. Tüm bu gizli özellikler, ilgili Yardım konularında bu şekilde not edilir.

Sınıfın DeclarativeCatalogPart çeşitli yöntemleri de vardır. GetAvailableWebPartDescriptions yöntemi, katalogdaki her WebPart denetim için bir WebPartDescription nesnesi alır ve bu nesne, bir DeclarativeCatalogPart denetimin bir örneğini oluşturmak zorunda kalmadan her sunucu denetimiyle ilgili bilgileri görüntülemesini sağlar. Başka bir yöntem yöntemidir GetWebPart . Bu yöntem, yöntemine geçirilen açıklamaya göre belirli WebPart bir denetimin örneğini alır.

Not

Erişilebilirliği geliştirmek için denetim DeclarativeCatalogPart bir <fieldset> öğe içinde işlenir. <fieldset> öğesi, denetimde DeclarativeCatalogPart düzenleme için kullanılan ilgili denetim kümesini gruplandırır ve hem görsel kullanıcı aracıları (normal Web tarayıcıları gibi) hem de konuşma odaklı kullanıcı aracıları (ekran okuma yazılımı gibi) için bu denetimler arasında sekmeli gezintiyi kolaylaştırır.

Oluşturucular

DeclarativeCatalogPart()

sınıfının yeni bir örneğini başlatır.

Özellikler

AccessKey

Bu devralınan özellik, denetim DeclarativeCatalogPart işlenirken Web Bölümleri denetim kümesi tarafından kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
Adapter

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

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

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

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

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

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

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
BackImageUrl

Bu devralınan özellik, denetim DeclarativeCatalogPart işlenirken Web Bölümleri denetim kümesi tarafından kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
BindingContainer

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

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

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
BorderStyle

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
BorderWidth

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
ChildControlsCreated

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

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

Parça denetiminin simge durumuna küçültülmüş veya normal durumda olup olmadığını alır veya ayarlar.

(Devralındığı yer: Part)
ChromeType

Web Bölümleri denetimini çerçeveleyen kenarlık türünü alır veya ayarlar.

(Devralındığı yer: Part)
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)
Context

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

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

ControlCollection Kullanıcı arabirimi hiyerarşisinde belirtilen sunucu denetimi için alt denetimleri içeren bir nesnesi alır.

(Devralındığı yer: Part)
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

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
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)
DefaultButton

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
Description

Araç İpuçlarında ve parça denetimlerinin kataloglarında kullanılmak üzere parça denetiminin ne yaptığını özetleyen kısa bir tümcecik alır veya ayarlar.

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

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

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

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
DisplayTitle

Denetimin gerçek geçerli başlığını içeren bir CatalogPart dize alır.

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

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
EnableTheming

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
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)
Events

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

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

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
ForeColor

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
GroupingText

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
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)
Height

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
HorizontalAlign

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
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)
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)
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)
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)
RenderingCompatibility

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

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

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
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

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
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: Panel)
TabIndex

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
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: WebControl)
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)
Title

Denetimin başlık çubuğunda görünen başlığı alır veya ayarlar.
ToolTip

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
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)
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

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
WebPartManager

Sınıfının geçerli örneğine başvuru alır WebPartManager .

(Devralındığı yer: CatalogPart)
WebPartsListUserControlPath

Katalog için veya diğer sunucu denetimlerinin listesini içeren bir kullanıcı denetiminin WebPart yolunu alır veya ayarlar.
WebPartsTemplate

Katalogda bildirilen denetimleri içeren WebPart bir şablona başvuru alır veya ayarlar.
Width

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
Wrap

Bu devralınan özellik denetim tarafından DeclarativeCatalogPart kullanılmaz. Özellik yalnızca Microsoft Visual Studio 2005 tasarımcı araçlarında görünmesini engellemek amacıyla geçersiz kılındı.
Zone

Denetim içeren bölgeye başvuru CatalogZoneBaseCatalogPart alır.

(Devralındığı yer: CatalogPart)

Yöntemler

AddAttributesToRender(HtmlTextWriter)

İşlenmek üzere öznitelik listesine arka plan görüntüsü, hizalama, kaydırma ve yön hakkında bilgi ekler.

(Devralındığı yer: Panel)
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)
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)
CreateChildControls()

ASP.NET sayfa çerçevesi tarafından, geri gönderme veya işleme hazırlığında içerdikleri alt denetimleri oluşturmak üzere birleşim tabanlı uygulama kullanan sunucu denetimlerini bilgilendirmek için çağrılır.

(Devralındığı yer: Control)
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()

Denetim tarafından Panel stille ilgili tüm özellikleri uygulamak için dahili olarak kullanılan bir stil nesnesi oluşturur.

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

Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine bağlar.

(Devralındığı yer: Part)
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)
GetAvailableWebPartDescriptions()

Katalogdaki kullanılabilir WebPart denetimlerin açıklamalarından oluşan bir koleksiyon döndürür.
GetDesignModeState()

Denetimin CatalogPart üst bölgesinin geçerli durumunu alır.

(Devralındığı yer: CatalogPart)
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)
GetWebPart(WebPartDescription)

yöntemine geçirilen açıklamanın değerini temel alan bir WebPart denetim başvurusu döndürür.
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)
IsLiteralContent()

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

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

yöntemi tarafından SaveControlState() kaydedilen önceki bir sayfa isteğinden denetim durumu bilgilerini geri yükler.

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

yöntemiyle SaveViewState() kaydedilmiş önceki bir istekten görünüm durumu bilgilerini geri yükler.

(Devralındığı yer: WebControl)
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)
OnInit(EventArgs)

Olayı tetikler Init .

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

Olayı tetikler Load .

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

Olayı tetikler PreRender .

(Devralındığı yer: CatalogPart)
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)
RemovedControl(Control)

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

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

Denetimi belirtilen HTML yazıcısına işler.

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

Denetimin HTML açma etiketini Panel belirtilen yazıcıya işler.

(Devralındığı yer: Panel)
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)

Denetimin içeriğini belirtilen yazıcıya işler. Bu yöntem öncelikle denetim geliştiricileri tarafından kullanılır.

(Devralındığı yer: WebControl)
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 Panel belirtilen yazıcıya işler.

(Devralındığı yer: Panel)
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()

Sayfanın sunucuya geri gönderildiği zamandan bu yana gerçekleşen tüm sunucu denetim durumu değişikliklerini kaydeder.

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

Yöntemi çağrıldıktan sonra TrackViewState() değiştirilen tüm durumları kaydeder.

(Devralındığı yer: WebControl)
SetDesignModeState(IDictionary)

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

(Devralındığı yer: CatalogPart)
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()

Denetimin, nesnenin ViewState özelliğinde depolanabilmeleri için görünüm durumundaki değişiklikleri izlemesine neden olur.

(Devralındığı yer: WebControl)

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 geliştiricisinin bileşik parça denetimi için denetimin alt denetimlerini tasarım yüzeyinde yeniden oluşturmasına olanak tanır.

(Devralındığı yer: Part)
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)

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.