PropertyGridEditorPart Класс

Определение

Предоставляет элемент управления редактора, позволяющий конечным пользователям изменять пользовательские свойства связанного элемента WebPart или серверного элемента управления.Provides an editor control that enables end users to edit custom properties on an associated WebPart or server control. Этот класс не наследуется.This class cannot be inherited.

public ref class PropertyGridEditorPart sealed : System::Web::UI::WebControls::WebParts::EditorPart
public sealed class PropertyGridEditorPart : System.Web.UI.WebControls.WebParts.EditorPart
type PropertyGridEditorPart = class
    inherit EditorPart
Public NotInheritable Class PropertyGridEditorPart
Inherits EditorPart
Наследование
PropertyGridEditorPart

Примеры

В следующем примере кода показано, как объявить PropertyGridEditorPart элемент управления на веб-странице и разрешить ему изменять несколько свойств WebPart пользовательского интерфейса элемента управления.The following code example demonstrates how to declare a PropertyGridEditorPart control on a Web page, and enable it to edit several UI properties of a WebPart control. Пример кода состоит из четырех частей:The code example has four parts:

  • Пользовательский элемент управления, позволяющий изменять режимы экрана на веб-части странице.A user control that enables you to change display modes on a Web Parts page.

  • Веб-страница, содержащая EditorZone элемент управления PropertyGridEditorPart и элемент управления, а также ссылка на пользовательский WebPart элемент управления.A Web page that contains an EditorZone control and a PropertyGridEditorPart control, along with a reference to a custom WebPart control.

  • Класс, содержащий пользовательский WebPart элемент управления.A class that contains the custom WebPart control.

  • Описание работы этого примера при загрузке страницы в браузере.An explanation of how the example works when you load the page in a browser.

Исходный код для пользовательского элемента управления поступает из другого раздела.The source code for the user control comes from another topic. Чтобы этот пример кода работал, необходимо получить ASCX файл для пользовательского элемента управления из пошагового руководства. Изменение режимов экрана веб-части разделе и размещение файла в той же папке, что и ASPX-страница в этом примере кода.For this code example to work, you need to obtain the .ascx file for the user control from the Walkthrough: Changing Display Modes on a Web Parts Page topic, and place the file in the same folder as the .aspx page in this code example.

Вторая часть примера кода — веб-страница.The second part of the code example is the Web page. Он содержит декларативную ссылку на EditorZone элемент управления с дочерним <zonetemplate> элементом, который содержит декларативную ссылку на PropertyGridEditorPart элемент управления.It contains a declarative reference to an EditorZone control, with a child <zonetemplate> element that contains a declarative reference to a PropertyGridEditorPart control. Страница ссылается на пользовательский WebPart элемент управления, Register используя директиву для сборки и <aspSample:UserInfoWebPart> элемент для элемента управления.The page references the custom WebPart control, using a Register directive for the assembly, and the <aspSample:UserInfoWebPart> element for the control.

<%@ 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">
<script runat="server">
  
  protected void Page_Load(object sender, EventArgs e)
  {
    Button1.Visible = false;
    TextBox1.Visible = false;
  }

  // <snippet3>
  private static String editControlTitle;
  
  protected void Button1_Click(object sender, EventArgs e)
  {
    editControlTitle = Server.HtmlEncode(TextBox1.Text);
    PropertyGridEditorPart1.Title = editControlTitle;
  }

  protected void PropertyGridEditorPart1_Init(object sender, EventArgs e)
  {
    if (editControlTitle != null)
      PropertyGridEditorPart1.Title = editControlTitle;
  }  
  // </snippet3>

  // <snippet4>
  protected void PropertyGridEditorPart1_PreRender(object sender,
    EventArgs e)
  {
    Button1.Visible = true;
    TextBox1.Visible = true;
  }
  // </snippet4> 

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      User Information WebPart with EditorPart
    </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>
          <aspSample:UserInfoWebPart 
            runat="server"   
            id="userinfo" 
            title = "User Information WebPart"
            BackColor="Beige" />          
        </zonetemplate>
      </asp:webpartzone> 
      <div>
      <hr />
      <asp:Button ID="Button1" runat="server" 
        Text="Update EditorPart Title" 
        OnClick="Button1_Click" />
      <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
      </div>
      <asp:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:PropertyGridEditorPart ID="PropertyGridEditorPart1" 
            runat="server" 
            Title="Edit Custom Properties"
            OnPreRender="PropertyGridEditorPart1_PreRender" 
            OnInit="PropertyGridEditorPart1_Init" />   
        </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">
<script runat="server">

  Protected Sub Page_Load(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    Button1.Visible = False
    TextBox1.Visible = False
  End Sub

  ' <snippet3>
  Shared editControlTitle As String
  
  Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs)
    editControlTitle = Server.HtmlEncode(TextBox1.Text)
    PropertyGridEditorPart1.Title = editControlTitle 
  End Sub
  
  Protected Sub PropertyGridEditorPart1_Init(ByVal _
    sender As Object, ByVal e As System.EventArgs)
    If Not editControlTitle Is Nothing Then
      PropertyGridEditorPart1.Title = editControlTitle
    End If
  End Sub
  ' </snippet3>

  ' <snippet4>
  Protected Sub PropertyGridEditorPart1_PreRender(ByVal _
    sender As Object, ByVal e As System.EventArgs)
    Button1.Visible = True
    TextBox1.Visible = True
  End Sub
  ' </snippet4>

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>
      User Information WebPart with EditorPart
    </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>
          <aspSample:UserInfoWebPart 
            runat="server"   
            id="userinfo" 
            title = "User Information WebPart"
            BackColor="Beige" />          
        </zonetemplate>
      </asp:webpartzone> 
      <div>
      <hr />
      <asp:Button ID="Button1" runat="server" 
        Text="Update EditorPart Title" 
        OnClick="Button1_Click" />
      <asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
      </div>
      <asp:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:PropertyGridEditorPart ID="PropertyGridEditorPart1" 
            runat="server" 
            Title="Edit Custom Properties"
            OnPreRender="PropertyGridEditorPart1_PreRender" 
            OnInit="PropertyGridEditorPart1_Init" />   
        </ZoneTemplate>
      </asp:EditorZone>
    </form>
  </body>
</html>

Третья часть примера кода — это пользовательский WebPart класс с именем UserInfoWebPart, на который ссылается веб-страница.The third part of the code example is a custom WebPart class named UserInfoWebPart, which is referenced in the Web page. Обратите внимание, что различные свойства, содержащие сведения о пользователе, помечены WebBrowsable атрибутом.Notice that the various properties that contain information about a user are all marked with the WebBrowsable attribute. Это позволяет PropertyGridEditorPart элементу управления предоставлять пользовательский интерфейс для редактирования этих свойств.This enables the PropertyGridEditorPart control to provide the UI for editing those properties. Свойства также помечаются WebDisplayName атрибутом, чтобы указать текст метки, которая отображается рядом с каждым элементом управления в пользовательском интерфейсе редактирования.The properties are also marked with a WebDisplayName attribute, to specify the text of the label that appears next to each control in the editing UI.

Для выполнения примера кода необходимо скомпилировать этот исходный код.For the code example to run, you must compile this source code. Его можно скомпилировать явным образом и разместить полученную сборку в папке Bin веб-сайта или в глобальном кэше сборок.You can compile it explicitly and put the resulting assembly in your Web site's Bin folder or the global assembly cache. Кроме того, можно разместить исходный код в папке App_Code сайта, где он будет динамически компилироваться во время выполнения.Alternatively, you can put the source code in your site's App_Code folder, where it will be dynamically compiled at run time. Пошаговое руководство, в котором демонстрируется компиляция , см. в разделе Пошаговое руководство. Разработка и использование пользовательского серверного веб-элемента управления.For a walkthrough that demonstrates how to compile, see Walkthrough: Developing and Using a Custom Web Server Control.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности.This example has a text box that accepts user input, which is a potential security threat. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.For more information, see Script Exploits Overview.

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 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 PetNickNameLabel;
    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"), 
      WebDescription("Select the category that corresponds to your job.")]
    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);

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

      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();
      PetNickNameLabel.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);
    }
  }
}
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 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 PetNickNameLabel 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"), _
      WebDescription("Select the category that corresponds to your job.")> _
    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)

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

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

End Namespace

При загрузке страницы в браузере выберите режим редактирования в раскрывающемся списке режим экрана , чтобы переключиться в режим редактирования.When you load the page in a browser, select Edit Mode in the Display Mode drop-down list control to switch to edit mode. Чтобы изменить элемент управления, щелкните меню глаголы (стрелку вниз) в заголовке окна элемента управления веб-части сведений о пользователях и нажмите кнопку изменить .You can click the verbs menu (the downward arrow) in the title bar of the User Information WebPart control, and click Edit to edit the control. Если пользовательский интерфейс редактирования отображается, PropertyGridEditorPart элемент управления отображается.When the editing UI is visible, you can see the PropertyGridEditorPart control. Обратите внимание, что элемент управления отображается для каждого свойства UserInfoWebPart класса в зависимости от типа свойства.Notice that a control is rendered for each of the properties of the UserInfoWebPart class, based on the type of the property. При внесении некоторых изменений в пользовательский интерфейс редактирования и нажатии кнопки Применить можно использовать раскрывающийся список режим отображения , чтобы вернуть страницу в режим просмотра и увидеть полный результат изменения.If you make some changes in the editing UI and click the Apply button, you can use the Display Mode drop-down list to return the page to browse mode and see the full effect of the editing changes.

Комментарии

Предоставляет универсальный пользовательский интерфейс, позволяющий пользователям изменять пользовательские свойства в WebPart и серверных элементах управления, размещенных в WebPartZoneBase зонах. PropertyGridEditorPartThe PropertyGridEditorPart provides a generic user interface (UI) that enables users to edit custom properties on WebPart and server controls placed in WebPartZoneBase zones. Напротив, другие EditorPart элементы управления, такие AppearanceEditorPart как элементы управления и BehaviorEditorPart , изменяют только WebPart существующие свойства, ориентированные на интерфейс пользователя, из класса.In contrast, the other EditorPart controls, such as the AppearanceEditorPart and BehaviorEditorPart controls, edit only existing, UI-oriented properties from the WebPart class.

Точно так же, как и в наборе элементов управления веб-части (Дополнительные сведения см. в ToolZone разделе Общие сведения о классе), существуют элементы управления, ориентированные на средства, и каждая из них должна находиться в соответствующей зоне.Just as there are tool-oriented zones in the Web Parts control set (for details, see the ToolZone class overview), there are tool-oriented part controls, and each of these must reside in a corresponding type of tool zone. Элементы управления этого типа в наборе элементов управления веб-части имеют две отличительные характеристики:These kind of controls in the Web Parts control set have two distinguishing characteristics:

  • Они являются вспомогательными элементами управления, которые позволяют конечным пользователям персонализировать элементы управления, которые формируют основной пользовательский интерфейс страницы в веб-части приложении.They are helper controls that enable end users to personalize the controls that form the primary UI of a page in a Web Parts application.

  • Они видимы только в определенных режимах отображения страницы.They are visible only in certain page display modes.

Элемент управления — это специальный элемент управления, который становится видимым только в том случае, если веб-страница находится в режиме редактирования WebPart , а определенный пользователь или серверный элемент управления выбран пользователем для редактирования. PropertyGridEditorPartThe PropertyGridEditorPart control is a special control, and it becomes visible only when a Web page is in edit mode, and when a specific WebPart or server control has been selected by a user for editing. Элемент управления, как и все EditorPart остальные элементы EditorZone , должен находиться в зоне на странице. PropertyGridEditorPartThe PropertyGridEditorPart control, like all other EditorPart controls, must reside in an EditorZone zone on the page.

Важно!

Зона может содержать только EditorPart элементы управления, а EditorPart элементы управления не могут размещаться в других типах зон. EditorZoneAn EditorZone zone can contain only EditorPart controls, and EditorPart controls cannot be placed in any other type of zone.

Элемент управления предоставляет пользовательский интерфейс редактирования для свойств, которые помечены в исходном коде WebBrowsable атрибутом (из WebBrowsableAttribute класса). PropertyGridEditorPartThe PropertyGridEditorPart control provides an editing UI for properties that are marked in the source code with the WebBrowsable attribute (from the WebBrowsableAttribute class). Если свойство помечено этим атрибутом, PropertyGridEditorPart элемент управления создает пользовательский интерфейс редактирования на основе типа свойства и при необходимости PropertyDescriptor использует объект, чтобы преобразовать значение в каждом элементе управления редактированием в тип свойства.When a property is marked with this attribute, a PropertyGridEditorPart control creates the editing UI based on the type of the property, and uses a PropertyDescriptor object if needed to convert the value in each editing control to the type of the property. Можно также добавить другие атрибуты, помогающие PropertyGridEditorPart элементу управления отображать пользовательский интерфейс редактирования.You can also add other attributes that help the PropertyGridEditorPart control to display the editing UI. WebDisplayName Атрибут (WebDisplayNameAttribute из класса) позволяет указать текст метки, которая отображается для каждого элемента управления в пользовательском интерфейсе редактирования.The WebDisplayName attribute (from the WebDisplayNameAttribute class) allows you to specify the text for the label that appears with each control in the editing UI. WebDescription Атрибут (WebDescriptionAttribute из класса) позволяет указать строку, которая отображается в качестве подсказки для каждого элемента управления в пользовательском интерфейсе редактирования.The WebDescription attribute (from the WebDescriptionAttribute class) allows you to specify a string that appears as a ToolTip for each control in the editing UI.

В следующей таблице перечислены элементы управления, созданные для изменения свойств различных типов.The controls created to edit properties of various types are listed in the following table.

Тип свойстваProperty type Элемент управления, созданный для изменения свойстваControl created to edit the property
StringString TextBox
Int, float, UnitInt, Float, Unit TextBox
BooleanBoolean CheckBox
Enum DropDownList(содержит список перечисляемых значений)DropDownList (contains the list of enumerated values)
DateTime TextBox

PropertyGridEditorPart КлассTitle имеет свойство, которое используется для получения или установки видимого текста заголовка для элемента управления.The PropertyGridEditorPart class has a Title property, which is used to get or set the visible title text for the control. Также имеется защищенное Display свойство, которое определяет, отображается ли элемент управления при переходе страницы в режим правки.There is also a protected Display property, which determines whether the control is displayed when the page enters edit mode.

Класс также имеет два важных метода, ApplyChanges и SyncChanges, которые он наследует от EditorPart класса и переопределяет. PropertyGridEditorPartThe PropertyGridEditorPart class also has two important methods, ApplyChanges and SyncChanges, which it inherits from the EditorPart class and overrides. Методы являются критически важными, так как они позволяют получать и устанавливать значения свойств между значениями полей элемента управления редактора и свойствами WebPart редактируемого элемента управления.The methods are critical because they enable getting and setting the property values between the field values of the editor control and the properties on the WebPart control being edited.

Поскольку элемент управления позволяет изменять только пользовательские свойства, для изменения внешнего вида, WebPart макета и EditorPart поведения элементов управления потребуются другие элементы управления в наборе элементов управления веб-части. PropertyGridEditorPartBecause the PropertyGridEditorPart control allows you to edit only custom properties, you will need the other EditorPart controls in the Web Parts control set to edit the appearance, layout, and behavior of WebPart controls. К другим элементам управления относятся BehaviorEditorPart AppearanceEditorPart элементы LayoutEditorPart, и.The other controls include the BehaviorEditorPart, the LayoutEditorPart, and the AppearanceEditorPart controls. Эти EditorPart элементы управления должны предоставлять большинство функций редактирования, необходимых WebPart для редактирования элементов управления, но при необходимости можно также создать пользовательский элемент управления редактора EditorPart , наследуемый от класса.These EditorPart controls should provide most editing features required to edit WebPart controls, but if necessary, you can also create a custom editor control by inheriting from the EditorPart class. Пример кода см. в EditorPart разделе Обзор класса.For a code example, see the EditorPart class overview topic.

Примечание

Для улучшения специальных возможностей PropertyGridEditorPart элемент управления подготавливается к просмотру <fieldset> в элементе.To improve accessibility, the PropertyGridEditorPart control is rendered within a <fieldset> element. Элемент группирует связанный набор элементов управления, используемых для редактирования PropertyGridEditorPart в элементе управления, и упрощает навигацию с вкладками для визуальных агентов пользователя (таких как обычные веб-браузеры) и агентов пользователя, ориентированного на речь ( <fieldset> Например, программное обеспечение для чтения с экрана).The <fieldset> element groups the related set of controls used for editing in the PropertyGridEditorPart control, and it facilitates tabbed navigation among those controls for both visual user agents (such as ordinary Web browsers) and speech-oriented user agents (such as screen-reading software).

Специальные возможностиAccessibility

Разметка, отображаемая по умолчанию для этого элемента управления, может не соответствовать стандартам специальных возможностей, таким как рекомендации по обеспечению доступности веб-содержимого 1,0 (WCAG) с приоритетом 1.The markup rendered by default for this control might not conform to accessibility standards such as the Web Content Accessibility Guidelines 1.0 (WCAG) priority 1 guidelines. Дополнительные сведения о поддержке специальных возможностей для этого элемента управления см. в разделе ASP.NET Controls and Accessibility.For details about accessibility support for this control, see ASP.NET Controls and Accessibility.

Конструкторы

PropertyGridEditorPart()

Создает новый экземпляр класса.Creates a new instance of the class.

Свойства

AccessKey

Возвращает или задает клавишу доступа, обеспечивающую быстрый переход к серверному веб-элементу управления.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Унаследовано от WebControl)
Adapter

Возвращает конкретный адаптер браузера для элемента управления.Gets the browser-specific adapter for the control.

(Унаследовано от Control)
AppRelativeTemplateSourceDirectory

Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Унаследовано от Control)
Attributes

Получает коллекцию произвольных атрибутов (только для отрисовки), которые не соответствуют свойствам элемента управления.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Унаследовано от WebControl)
BackColor

Получает или задает цвет фона серверного веб-элемента управления.Gets or sets the background color of the Web server control.

(Унаследовано от WebControl)
BackImageUrl

Получает или задает URL-адрес фонового изображения для элемента управления панели.Gets or sets the URL of the background image for the panel control.

(Унаследовано от Panel)
BindingContainer

Возвращает элемент управления, который содержит привязку данных элемента управления.Gets the control that contains this control's data binding.

(Унаследовано от Control)
BorderColor

Возвращает или задает цвет рамки элемента управления Веба.Gets or sets the border color of the Web control.

(Унаследовано от WebControl)
BorderStyle

Получает или задает стиль границы серверного веб-элемента управления.Gets or sets the border style of the Web server control.

(Унаследовано от WebControl)
BorderWidth

Возвращает или задает ширину границы серверного веб-элемента управления.Gets or sets the border width of the Web server control.

(Унаследовано от WebControl)
ChildControlsCreated

Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления.Gets a value that indicates whether the server control's child controls have been created.

(Унаследовано от Control)
ChromeState

Получает или задает значение, указывающее, находится ли элемент управления веб-частей в свернутом или обычном состоянии.Gets or sets whether a part control is in a minimized or normal state.

(Унаследовано от Part)
ChromeType

Получает или задает тип границы, которая обрамляет элемент управления веб-частей.Gets or sets the type of border that frames a Web Parts control.

(Унаследовано от Part)
ClientID

Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Унаследовано от Control)
ClientIDMode

Возвращает или задает алгоритм, используемый для создания значения свойства ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Унаследовано от Control)
ClientIDSeparator

Возвращает значение символа разделителя, используемого в свойстве ClientID.Gets a character value representing the separator character used in the ClientID property.

(Унаследовано от Control)
Context

Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса.Gets the HttpContext object associated with the server control for the current Web request.

(Унаследовано от Control)
Controls

Получает объект ControlCollection, который содержит дочерние элементы управления для заданного серверного элемента управления в иерархии пользовательского интерфейса.Gets a ControlCollection object that contains the child controls for a specified server control in the user interface hierarchy.

(Унаследовано от Part)
ControlStyle

Возвращает или задает стиль серверного веб-элемента управления.Gets the style of the Web server control. Это свойство используется преимущественно разработчиками элементов управления.This property is used primarily by control developers.

(Унаследовано от WebControl)
ControlStyleCreated

Возвращает значение, определяющее, был ли объект Style создан для свойства ControlStyle.Gets a value indicating whether a Style object has been created for the ControlStyle property. Этот свойство в основном используется разработчиками элементов управления.This property is primarily used by control developers.

(Унаследовано от WebControl)
CssClass

Возвращает или задает класс каскадных листов стилей (CSS), преобразовываемый для просмотра в серверном веб-элементе управления на клиентском компьютере.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Унаследовано от WebControl)
DataItemContainer

Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Унаследовано от Control)
DataKeysContainer

Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Унаследовано от Control)
DefaultButton

Переопределяет унаследованное из элемента управления Panel базовое свойство, чтобы скрыть свойство от разработчиков и защитить его от применения тем.Overrides the base property inherited from the Panel control to hide the property from designers and prevent it from being affected by themes.

Description

Получает или задает краткую фразу, в которой говорится, что делает этот элемент управления веб-частей. Эта фраза будет использоваться во всплывающих подсказках и каталогах элементов управления веб-частей.Gets or sets a brief phrase that summarizes what the part control does, for use in ToolTips and catalogs of part controls.

(Унаследовано от Part)
DesignMode

Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки.Gets a value indicating whether a control is being used on a design surface.

(Унаследовано от Control)
Direction

Получает или задает направление отображения элементов управления, которые включают текст в элементе управления Panel.Gets or sets the direction in which to display controls that include text in a Panel control.

(Унаследовано от Panel)
Display

Получает значение, указывающее, должен ли отображаться элемент управления, если связанный с ним элемент управления WebPart находится в режиме редактирования.Gets a value that indicates whether a control should be displayed when its associated WebPart control is in edit mode.

DisplayTitle

Получает строку, которая содержит текст, отображающийся в строке заголовка элемента управления EditorPart.Gets a string that contains the title text displayed in the title bar of an EditorPart control.

(Унаследовано от EditorPart)
Enabled

Возвращает или задает значение, определяющее, включен ли серверный веб-элемент управления.Gets or sets a value indicating whether the Web server control is enabled.

(Унаследовано от WebControl)
EnableTheming

Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления.Gets or sets a value indicating whether themes apply to this control.

(Унаследовано от WebControl)
EnableViewState

Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Унаследовано от Control)
Events

Возвращает список делегатов обработчиков событий элемента управления.Gets a list of event handler delegates for the control. Это свойство доступно только для чтения.This property is read-only.

(Унаследовано от Control)
Font

Возвращает свойства шрифта, связанные с серверным веб-элементом управления.Gets the font properties associated with the Web server control.

(Унаследовано от WebControl)
ForeColor

Возвращает или задает основной цвет (обычно это цвет текста) для серверного веб-элемента управления.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Унаследовано от WebControl)
GroupingText

Получает или задает заголовок для группы элементов управления, содержащихся в элементе управления панелью.Gets or sets the caption for the group of controls that is contained in the panel control.

(Унаследовано от Panel)
HasAttributes

Получает значение, определяющие наличие атрибутов у элемента управления.Gets a value indicating whether the control has attributes set.

(Унаследовано от WebControl)
HasChildViewState

Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Унаследовано от Control)
Height

Получает или задает высоту серверного веб-элемента управления.Gets or sets the height of the Web server control.

(Унаследовано от WebControl)
HorizontalAlign

Получает или задает выравнивание содержимого по горизонтали в пределах панели.Gets or sets the horizontal alignment of the contents within the panel.

(Унаследовано от Panel)
ID

Возвращает или задает программный идентификатор, назначенный серверному элементу управления.Gets or sets the programmatic identifier assigned to the server control.

(Унаследовано от Control)
IdSeparator

Возвращает символ, используемый для разделения идентификаторов элементов управления.Gets the character used to separate control identifiers.

(Унаследовано от Control)
IsChildControlStateCleared

Возвращает значение, указывающее, имеют ли элементы управления в этом элементе управления состояние элемента управления.Gets a value indicating whether controls contained within this control have control state.

(Унаследовано от Control)
IsEnabled

Возвращает значение, определяющее, включен ли элемент управления.Gets a value indicating whether the control is enabled.

(Унаследовано от WebControl)
IsTrackingViewState

Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления.Gets a value that indicates whether the server control is saving changes to its view state.

(Унаследовано от Control)
IsViewStateEnabled

Возвращает значение, указывающее, используется ли состояние представления для этого элемента управления.Gets a value indicating whether view state is enabled for this control.

(Унаследовано от Control)
LoadViewStateByID

Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Унаследовано от Control)
NamingContainer

Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства ID.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Унаследовано от Control)
Page

Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления.Gets a reference to the Page instance that contains the server control.

(Унаследовано от Control)
Parent

Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы.Gets a reference to the server control's parent control in the page control hierarchy.

(Унаследовано от Control)
RenderingCompatibility

Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Унаследовано от Control)
ScrollBars

Получает или задает видимость и положение полос прокрутки в элементе управления Panel.Gets or sets the visibility and position of scroll bars in a Panel control.

(Унаследовано от Panel)
Site

Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора.Gets information about the container that hosts the current control when rendered on a design surface.

(Унаследовано от Control)
SkinID

Возвращает или задает обложку, применяемую к элементу управления.Gets or sets the skin to apply to the control.

(Унаследовано от WebControl)
Style

Возвращает коллекцию атрибутов текста, которые будут отображены в виде атрибута стиля на внешнем теге серверного веб-элемента управления.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Унаследовано от WebControl)
SupportsDisabledAttribute

Получает значение, указывающее, должен ли элемент управления устанавливать для атрибута disabled отрисовываемого элемента HTML значение disabled, если для свойства элемента управления IsEnabled задано значение false.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Унаследовано от Panel)
TabIndex

Возвращает или задает индекс перехода по клавише Tab для серверного веб-элемента управления.Gets or sets the tab index of the Web server control.

(Унаследовано от WebControl)
TagKey

Возвращает значение HtmlTextWriterTag, которое соответствует этому элементу управления веб-сервера.Gets the HtmlTextWriterTag value that corresponds to this Web server control. Это свойство используется преимущественно разработчиками элементов управления.This property is used primarily by control developers.

(Унаследовано от WebControl)
TagName

Возвращает имя тега элемента управления.Gets the name of the control tag. Это свойство используется преимущественно разработчиками элементов управления.This property is used primarily by control developers.

(Унаследовано от WebControl)
TemplateControl

Возвращает или задает ссылку на шаблон, содержащий этот элемент управления.Gets or sets a reference to the template that contains this control.

(Унаследовано от Control)
TemplateSourceDirectory

Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Унаследовано от Control)
Title

Получает или задает заголовок редактирующего элемента управления.Gets or sets a title for the editor control.

ToolTip

Возвращает или задает текст, который отображается при наведении указателя мыши на серверный веб-элемент управления.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Унаследовано от WebControl)
UniqueID

Возвращает уникальный идентификатор серверного элемента управления в иерархии.Gets the unique, hierarchically qualified identifier for the server control.

(Унаследовано от Control)
ValidateRequestMode

Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Унаследовано от Control)
ViewState

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Унаследовано от Control)
ViewStateIgnoresCase

Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру.Gets a value that indicates whether the StateBag object is case-insensitive.

(Унаследовано от Control)
ViewStateMode

Возвращает или задает режим состояния представления данного элемента управления.Gets or sets the view-state mode of this control.

(Унаследовано от Control)
Visible

Получает или задает значение, указывающее, отрисовывается ли серверный элемент управления как пользовательский интерфейс на странице.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Унаследовано от Control)
WebPartManager

Получает ссылку на элемент управления WebPartManager, связанный с текущей веб-страницей.Gets a reference to the WebPartManager control associated with the current Web page.

(Унаследовано от EditorPart)
WebPartToEdit

Получает ссылку на элемент управления WebPart, редактируемый в настоящий момент.Gets a reference to the WebPart control that is currently being edited.

(Унаследовано от EditorPart)
Width

Получает или задает ширину серверного веб-элемента управления.Gets or sets the width of the Web server control.

(Унаследовано от WebControl)
Wrap

Получает или задает значение, показывающее, осуществляется ли перенос содержимого в пределах панели.Gets or sets a value indicating whether the content wraps within the panel.

(Унаследовано от Panel)
Zone

Получает ссылку на зону EditorZoneBase, в которой содержится элемент управления EditorPart.Gets a reference to the EditorZoneBase zone that contains an EditorPart control.

(Унаследовано от EditorPart)

Методы

AddAttributesToRender(HtmlTextWriter)

Добавляет сведения о фоновом изображении, выравнивании, переносе по словам и направление в список обрабатываемых атрибутов.Adds information about the background image, alignment, wrap, and direction to the list of attributes to render.

(Унаследовано от Panel)
AddedControl(Control, Int32)

Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control.Called after a child control is added to the Controls collection of the Control object.

(Унаследовано от Control)
AddParsedSubObject(Object)

Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Унаследовано от Control)
ApplyChanges()

Сохраняет значения из элемента управления PropertyGridEditorPart в соответствующие свойства связанного элемента управления WebPart.Saves the values from a PropertyGridEditorPart control to the corresponding properties in the associated WebPart control.

ApplyStyle(Style)

Копирует любой непустой элемент указанного стиля в элемент управления Веба, перезаписывая уже существующие элементы стиля.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Этот метод, в основном, используется разработчиками элементов управления.This method is primarily used by control developers.

(Унаследовано от WebControl)
ApplyStyleSheetSkin(Page)

Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления.Applies the style properties defined in the page style sheet to the control.

(Унаследовано от Control)
BeginRenderTracing(TextWriter, Object)

Запускает трассировку во время разработки данных отрисовки.Begins design-time tracing of rendering data.

(Унаследовано от Control)
BuildProfileTree(String, Boolean)

Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Унаследовано от Control)
ClearCachedClientID()

Задает для кэшированного свойства ClientID значение null.Sets the cached ClientID value to null.

(Унаследовано от Control)
ClearChildControlState()

Удаляет сведения о состоянии элемента управления для дочерних элементов управления серверного элемента управления.Deletes the control-state information for the server control's child controls.

(Унаследовано от Control)
ClearChildState()

Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления.Deletes the view-state and control-state information for all the server control's child controls.

(Унаследовано от Control)
ClearChildViewState()

Удаляет сведения о состоянии представления для всех дочерних элементов серверного элемента управления.Deletes the view-state information for all the server control's child controls.

(Унаследовано от Control)
ClearEffectiveClientIDMode()

Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Унаследовано от Control)
CopyBaseAttributes(WebControl)

Копирует не инкапсулированные объектом Style свойства из указанного серверного веб-элемента управления веб-сервера в элемент управления веб-сервера, откуда вызывается этот метод.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Унаследовано от WebControl)
CreateChildControls()

Вызывается платформой страницы ASP.NET для уведомления серверных элементов управления, использующих составную реализацию, о необходимости создания дочерних элементов управления, содержащихся в них для обратной передачи или отрисовки.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

(Унаследовано от Control)
CreateControlCollection()

Создает новый объект ControlCollection для хранения дочерних элементов управления (литеральных и серверных) серверного элемента управления.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Унаследовано от Control)
CreateControlStyle()

Создает объект стиля, который внутренне используется элементом управления Panel для реализации всех относящихся к стилю свойств.Creates a style object that is used internally by the Panel control to implement all style related properties.

(Унаследовано от Panel)
DataBind()

Связывает источник данных с вызывающим серверным элементом управления и всеми его дочерними элементами управления.Binds a data source to the invoked server control and all its child controls.

(Унаследовано от Part)
DataBind(Boolean)

Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Унаследовано от Control)
DataBindChildren()

Привязывает источник данных к дочерним элементам управления серверного элемента управления.Binds a data source to the server control's child controls.

(Унаследовано от Control)
Dispose()

Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти.Enables a server control to perform final clean up before it is released from memory.

(Унаследовано от Control)
EndRenderTracing(TextWriter, Object)

Завершает трассировку во время разработки данных отрисовки.Ends design-time tracing of rendering data.

(Унаследовано от Control)
EnsureChildControls()

Определяет наличие у серверного элемента управления дочерних элементов управления.Determines whether the server control contains child controls. Если дочерних элементов управления нет, они будут созданы.If it does not, it creates child controls.

(Унаследовано от Control)
EnsureID()

Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора.Creates an identifier for controls that do not have an identifier assigned.

(Унаследовано от Control)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
FindControl(String)

Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования.Searches the current naming container for a server control with the specified id parameter.

(Унаследовано от Control)
FindControl(String, Int32)

Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Эту версию метода FindControl не следует переопределять.You should not override this version of the FindControl method.

(Унаследовано от Control)
Focus()

Задает фокус ввода на элемент управления.Sets input focus to a control.

(Унаследовано от Control)
GetDesignModeState()

Извлекает текущее состояние родительской зоны элемента управления EditorPart.Retrieves the current state of an EditorPart control's parent zone.

(Унаследовано от EditorPart)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetRouteUrl(Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута.Gets the URL that corresponds to a set of route parameters.

(Унаследовано от Control)
GetRouteUrl(RouteValueDictionary)

Возвращает URL-адрес, соответствующий набору параметров маршрута.Gets the URL that corresponds to a set of route parameters.

(Унаследовано от Control)
GetRouteUrl(String, Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута.Gets the URL that corresponds to a set of route parameters and a route name.

(Унаследовано от Control)
GetRouteUrl(String, RouteValueDictionary)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута.Gets the URL that corresponds to a set of route parameters and a route name.

(Унаследовано от Control)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetUniqueIDRelativeTo(Control)

Возвращает часть с префиксом свойства UniqueID указанного элемента управления.Returns the prefixed portion of the UniqueID property of the specified control.

(Унаследовано от Control)
HasControls()

Определяет наличие у серверного элемента управления дочерних элементов управления.Determines if the server control contains any child controls.

(Унаследовано от Control)
HasEvents()

Возвращает значение, указывающее, регистрируются ли события для элемента управления или каких-либо дочерних элементов управления.Returns a value indicating whether events are registered for the control or any child controls.

(Унаследовано от Control)
IsLiteralContent()

Определяет наличие у серверного элемента управления только текстового содержимого.Determines if the server control holds only literal content.

(Унаследовано от Control)
LoadControlState(Object)

Восстанавливает сведения о состоянии элемента управления предыдущего запроса страницы, сохраненные методом SaveControlState().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

(Унаследовано от Control)
LoadViewState(Object)

Восстанавливает сведения о состоянии представления предыдущего запроса, сохраненные методом SaveViewState().Restores view-state information from a previous request that was saved with the SaveViewState() method.

(Унаследовано от WebControl)
MapPathSecure(String)

Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный).Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Унаследовано от Control)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
MergeStyle(Style)

Копирует любой непустой элемент указанного стиля в элемент управления Веба, но не перезаписывает уже существующие элементы стиля.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Унаследовано от WebControl)
OnBubbleEvent(Object, EventArgs)

Определяет, передается ли событие серверного элемента управления вверх по иерархии серверных элементов управления пользовательского интерфейса страницы.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

(Унаследовано от Control)
OnDataBinding(EventArgs)

Вызывает событие DataBinding.Raises the DataBinding event.

(Унаследовано от Control)
OnInit(EventArgs)

Создает событие Init.Raises the Init event.

(Унаследовано от Control)
OnLoad(EventArgs)

Создает событие Load.Raises the Load event.

(Унаследовано от Control)
OnPreRender(EventArgs)

Вызывает событие PreRender.Raises the PreRender event.

(Унаследовано от EditorPart)
OnUnload(EventArgs)

Создает событие Unload.Raises the Unload event.

(Унаследовано от Control)
OpenFile(String)

Возвращает Stream, используемое для чтения файла.Gets a Stream used to read a file.

(Унаследовано от Control)
RaiseBubbleEvent(Object, EventArgs)

Присваивает родительскому элементу управления все источники события и сведения о них.Assigns any sources of the event and its information to the control's parent.

(Унаследовано от Control)
RemovedControl(Control)

Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control.Called after a child control is removed from the Controls collection of the Control object.

(Унаследовано от Control)
Render(HtmlTextWriter)

Выполняет визуализацию элемента управления в указанный писатель HTML.Renders the control to the specified HTML writer.

(Унаследовано от WebControl)
RenderBeginTag(HtmlTextWriter)

Выполняет рендеринг открывающего HTML-тега элемента управления Panel для указанного объекта.Renders the HTML opening tag of the Panel control to the specified writer.

(Унаследовано от Panel)
RenderChildren(HtmlTextWriter)

Отправляет содержимое дочернего серверного элемента управления указанному объекту HtmlTextWriter, который записывает содержимое для преобразования на стороне клиента.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Унаследовано от Control)
RenderContents(HtmlTextWriter)

Выводит содержимое элемента управления в заданный модуль записи.Renders the contents of the control to the specified writer. Этот метод используется в основном разработчиками элементов управления.This method is used primarily by control developers.

(Унаследовано от WebControl)
RenderControl(HtmlTextWriter)

Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Унаследовано от Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Унаследовано от Control)
RenderEndTag(HtmlTextWriter)

Отображает закрывающий HTML-тег элемента управления Panel в указанное средство записи.Renders the HTML closing tag of the Panel control into the specified writer.

(Унаследовано от Panel)
ResolveAdapter()

Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления.Gets the control adapter responsible for rendering the specified control.

(Унаследовано от Control)
ResolveClientUrl(String)

Возвращает URL-адрес, который может использоваться браузером.Gets a URL that can be used by the browser.

(Унаследовано от Control)
ResolveUrl(String)

Преобразует URL-адрес в адрес, доступный для клиента.Converts a URL into one that is usable on the requesting client.

(Унаследовано от Control)
SaveControlState()

Сохраняет любые изменения состояния серверного элемента управления, произошедшие после отправки страницы обратно на сервер.Saves any server control state changes that have occurred since the time the page was posted back to the server.

(Унаследовано от Control)
SaveViewState()

Сохраняет любое состояние, которое было изменено после вызова метода TrackViewState().Saves any state that was modified after the TrackViewState() method was invoked.

(Унаследовано от WebControl)
SetDesignModeState(IDictionary)

Применяет характеристики состояния режима конструктора к текущей зоне EditorZoneBase, в которой содержится элемент управления EditorPart.Applies the characteristics of the design-mode state to the current EditorZoneBase zone that contains an EditorPart control.

(Унаследовано от EditorPart)
SetRenderMethodDelegate(RenderMethod)

Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления.Assigns an event handler delegate to render the server control and its content into its parent control.

(Унаследовано от Control)
SetTraceData(Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Унаследовано от Control)
SetTraceData(Object, Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Унаследовано от Control)
SyncChanges()

Извлекает значения из элемента управления WebPart и обновляет соответствующие элементы управления, которые использовавшиеся для редактирования, в элементе управления PropertyGridEditorPart.Retrieves the values from a WebPart control, and updates the corresponding controls used to edit those property values within a PropertyGridEditorPart control.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
TrackViewState()

Инициирует отслеживание элементом управления изменений в состоянии его представления для сохранения этих изменений в свойстве ViewState данного объекта.Causes the control to track changes to its view state so they can be stored in the object's ViewState property.

(Унаследовано от WebControl)

События

DataBinding

Происходит при привязке серверного элемента управления к источнику данных.Occurs when the server control binds to a data source.

(Унаследовано от Control)
Disposed

Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Унаследовано от Control)
Init

Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Унаследовано от Control)
Load

Происходит при загрузке серверного элемента управления в объект Page.Occurs when the server control is loaded into the Page object.

(Унаследовано от Control)
PreRender

Происходит после загрузки объекта Control, но перед отрисовкой.Occurs after the Control object is loaded but prior to rendering.

(Унаследовано от Control)
Unload

Происходит при выгрузке серверного элемента управления из памяти.Occurs when the server control is unloaded from memory.

(Унаследовано от Control)

Явные реализации интерфейса

IAttributeAccessor.GetAttribute(String)

Возвращает атрибуту веб-элемента управления указанное имя.Gets an attribute of the Web control with the specified name.

(Унаследовано от WebControl)
IAttributeAccessor.SetAttribute(String, String)

Задает атрибуту веб-элемента управления указанное имя и значение.Sets an attribute of the Web control to the specified name and value.

(Унаследовано от WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Позволяет разработчику конструктора для составного элемента управления "Веб-часть" воспроизвести дочерние элементы управления элемента управления в рабочей области конструирования.Allows the developer of a designer for a composite part control to recreate the control's child controls on the design surface.

(Унаследовано от Part)
IControlBuilderAccessor.ControlBuilder

Описание этого члена см. в разделе ControlBuilder.For a description of this member, see ControlBuilder.

(Унаследовано от Control)
IControlDesignerAccessor.GetDesignModeState()

Описание этого члена см. в разделе GetDesignModeState().For a description of this member, see GetDesignModeState().

(Унаследовано от Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Описание этого члена см. в разделе SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Унаследовано от Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Описание этого члена см. в разделе SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Унаследовано от Control)
IControlDesignerAccessor.UserData

Описание этого члена см. в разделе UserData.For a description of this member, see UserData.

(Унаследовано от Control)
IDataBindingsAccessor.DataBindings

Описание этого члена см. в разделе DataBindings.For a description of this member, see DataBindings.

(Унаследовано от Control)
IDataBindingsAccessor.HasDataBindings

Описание этого члена см. в разделе HasDataBindings.For a description of this member, see HasDataBindings.

(Унаследовано от Control)
IExpressionsAccessor.Expressions

Описание этого члена см. в разделе Expressions.For a description of this member, see Expressions.

(Унаследовано от Control)
IExpressionsAccessor.HasExpressions

Описание этого члена см. в разделе HasExpressions.For a description of this member, see HasExpressions.

(Унаследовано от Control)
IParserAccessor.AddParsedSubObject(Object)

Описание этого члена см. в разделе AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Унаследовано от Control)

Методы расширения

FindDataSourceControl(Control)

Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Возвращает объект метатаблицы для контейнерного элемента управления данными.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

Получает коллекцию значений по умолчанию для заданного элемента управления данными.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

Получает метаданные таблицы для заданного элемента управления данными.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

Задает метаданные таблицы для заданного элемента управления данными.Sets the table metadata for the specified data control.

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

Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

Задает метаданные таблицы и преобразование значений по умолчанию для заданного элемента управления данными.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

Определяет, доступны ли метаданные таблицы.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

Включает поведение платформы динамических данных для указанного элемента управления данными.Enables Dynamic Data behavior for the specified data control.

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

Включает поведение платформы динамических данных для указанного элемента управления данными.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

Включает поведение платформы динамических данных для указанного элемента управления данными.Enables Dynamic Data behavior for the specified data control.

Применяется к

Дополнительно