EditorPart Clase

Definición

Espacio de nombres:: System.Web.UI.WebControls.WebParts

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Actúa como clase base para los controles que residen en EditorZoneBase zonas y se usan para editar WebPart controles.

public ref class EditorPart abstract : System::Web::UI::WebControls::WebParts::Part

[System.ComponentModel.Bindable(false)]
public abstract class EditorPart : System.Web.UI.WebControls.WebParts.Part

[<System.ComponentModel.Bindable(false)>]
type EditorPart = class
    inherit Part

Public MustInherit Class EditorPart
Inherits Part

Herencia: Object

Control

WebControl

Panel

Part
EditorPart

Derivado: System.Web.UI.WebControls.WebParts.AppearanceEditorPart

System.Web.UI.WebControls.WebParts.BehaviorEditorPart

System.Web.UI.WebControls.WebParts.LayoutEditorPart

System.Web.UI.WebControls.WebParts.PropertyGridEditorPart

Atributos: BindableAttribute

Ejemplos

En el ejemplo de código siguiente se muestra el uso declarativo y mediante programación de EditorPart controles. Este ejemplo de código tiene cuatro partes:

Control de usuario que permite cambiar los modos de visualización en una página de elementos web.
Página web que contiene un EditorZone control, con varios de los EditorPart controles del conjunto de controles de elementos web declarados en la zona y una referencia a un control personalizado WebPart .
Clase que contiene el control personalizado WebPart y un control personalizado EditorPart para editar una propiedad en el WebPart control.
Explicación de cómo funciona el ejemplo al cargar la página en un explorador.

La primera parte de este ejemplo de código es el control de usuario que permite a los usuarios cambiar los modos de visualización en una página web. Para obtener más información sobre los modos de visualización y una descripción del código fuente de este control, vea Walkthrough: Changing Display Modes on a Web Parts Page.

<%@ 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 + " Mode", modeName);
        DisplayModeDropdown.Items.Add(item);
      }
    }

  }
 
  // 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;

  }

  void Page_PreRender(object sender, EventArgs e)
  {
    DisplayModeDropdown.SelectedValue = _manager.DisplayMode.Name;
  }
  
</script>
<div>
  <asp:DropDownList ID="DisplayModeDropdown" 
    runat="server"  
    AutoPostBack="true" 
    OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
</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 + " Mode", modeName)
            DisplayModeDropdown.Items.Add(item)
        End If
    Next mode

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 


Sub Page_PreRender(ByVal sender As Object, ByVal e As EventArgs) 
    DisplayModeDropdown.SelectedValue = _manager.DisplayMode.Name

End Sub 

</script>
<div>
  <asp:DropDownList ID="DisplayModeDropdown" 
    runat="server"  
    AutoPostBack="true" 
    OnSelectedIndexChanged="DisplayModeDropdown_SelectedIndexChanged" />
</div>

La segunda parte del ejemplo de código es la página web. Contiene una referencia declarativa a un EditorZone control, con un elemento secundario <zonetemplate> que contiene referencias declarativas a dos de los controles del conjunto EditorPart de controles de elementos web. La página también hace referencia a un control personalizado WebPart , mediante una Register directiva para el ensamblado y el <aspSample:TextDisplayWebPart> elemento del control .

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>
      Text Display WebPart with EditorPart
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" />
      <uc1:DisplayModeMenu ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" runat="server" 
        CloseVerb-Enabled="false">
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" />          
        </zonetemplate>
      </asp:webpartzone> 
      <asp:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
            runat="server" />
          <asp:LayoutEditorPart ID="LayoutEditorPart1" 
            runat="server" />
        </ZoneTemplate>      
      </asp:EditorZone>
    </form>
  </body>
</html>

<%@ page language="vb" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenu" 
  Src="DisplayModevb.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="TextDisplayWebPartVB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head id="Head1" runat="server">
    <title>
      Text Display WebPart with EditorPart
    </title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:webpartmanager id="WebPartManager1" runat="server" />
      <uc1:DisplayModeMenu ID="DisplayModeMenu1" runat="server" />
      <asp:webpartzone id="zone1" runat="server" 
        CloseVerb-Enabled="false">
        <zonetemplate>
          <aspSample:TextDisplayWebPart 
            runat="server"   
            id="textwebpart" 
            title = "Text Content WebPart" />          
        </zonetemplate>
      </asp:webpartzone> 
      <asp:EditorZone ID="EditorZone1" runat="server">
        <ZoneTemplate>
          <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
            runat="server" />
          <asp:LayoutEditorPart ID="LayoutEditorPart1" 
            runat="server" />
        </ZoneTemplate>      
      </asp:EditorZone>
    </form>
  </body>
</html>

La tercera parte del ejemplo de código es una clase personalizada WebPart denominada TextDisplayWebPart. La clase implementa la IWebEditable interfaz . Dentro de esta clase es una clase privada anidada que contiene el código de una clase privada EditorPart asociada a la TextDisplayWebPart clase y denominada TextDisplayEditorPart. En tiempo de ejecución, a medida que el TextDisplayWebPart control entra en modo de edición, en su TextDisplayWebPart.CreateEditorParts método, crea una instancia de la TextDisplayEditorPart clase y la muestra en el EditorZone control, junto con los demás EditorPart controles.

using System;
using System.Collections;
using System.ComponentModel;
using System.Drawing;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;

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

    public override EditorPartCollection CreateEditorParts()
    {
      ArrayList editorArray = new ArrayList();
      TextDisplayEditorPart edPart = new TextDisplayEditorPart();
      edPart.ID = this.ID + "_editorPart1";
      editorArray.Add(edPart);
      EditorPartCollection editorParts = 
        new EditorPartCollection(editorArray);
      return editorParts;
    }

    public override object WebBrowsableObject
    {
      get { return this; }
    }

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

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

    protected override void CreateChildControls()
    {
      Controls.Clear();
      DisplayContent = new Label();
      DisplayContent.BackColor = Color.LightBlue;
      DisplayContent.Text = this.ContentText;
      if (FontStyle == null)
        FontStyle = "None";
      SetFontStyle(DisplayContent, FontStyle);
      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;
      }
    }

    private void SetFontStyle(Label label, String selectedStyle)
    {
      if (selectedStyle == "Bold")
      {
        label.Font.Bold = true;
        label.Font.Italic = false;
        label.Font.Underline = false;
      }
      else if (selectedStyle == "Italic")
      {
        label.Font.Italic = true;
        label.Font.Bold = false;
        label.Font.Underline = false;
      }
      else if (selectedStyle == "Underline")
      {
        label.Font.Underline = true;
        label.Font.Bold = false;
        label.Font.Italic = false;
      }
      else
      {
        label.Font.Bold = false;
        label.Font.Italic = false;
        label.Font.Underline = false;
      }
    }

    // Create a custom EditorPart to edit the WebPart control.
    [AspNetHostingPermission(SecurityAction.Demand,
      Level = AspNetHostingPermissionLevel.Minimal)]
    private class TextDisplayEditorPart : EditorPart
    {
      DropDownList _partContentFontStyle;

      public TextDisplayEditorPart()
      {
        Title = "Font Face";
      }

      public override bool ApplyChanges()
      {
        TextDisplayWebPart part = 
          (TextDisplayWebPart)WebPartToEdit;
        // Update the custom WebPart control with the font style.
        part.FontStyle = PartContentFontStyle.SelectedValue;

        return true;
      }

      public override void SyncChanges()
      {
        TextDisplayWebPart part = 
          (TextDisplayWebPart)WebPartToEdit;
        String currentStyle = part.FontStyle;

        // Select the current font style in the drop-down control.
        foreach (ListItem item in PartContentFontStyle.Items)
        {
          if (item.Value == currentStyle)
          {
            item.Selected = true;
            break;
          }
        }
      }

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

        // Add a set of font styles to the dropdown list.
        _partContentFontStyle = new DropDownList();
        _partContentFontStyle.Items.Add("Bold");
        _partContentFontStyle.Items.Add("Italic");
        _partContentFontStyle.Items.Add("Underline");
        _partContentFontStyle.Items.Add("None");

        Controls.Add(_partContentFontStyle);
      }

      protected override void RenderContents(HtmlTextWriter writer)
      {
        writer.Write("<b>Text Content Font Style</b>");
        writer.WriteBreak();
        writer.Write("Select a font style.");
        writer.WriteBreak();
        _partContentFontStyle.RenderControl(writer);
        writer.WriteBreak();
      }

      // Access the drop-down control through a property.
      private DropDownList PartContentFontStyle
      {
        get 
        {
          EnsureChildControls();
          return _partContentFontStyle;
        }
      }
    }
  }
}

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

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

    Public Overrides Function CreateEditorParts() _
                                As EditorPartCollection
      Dim editorArray As New ArrayList()
      Dim edPart as New TextDisplayEditorPart()
      edPart.ID = Me.ID & "_editorPart1"
      editorArray.Add(edPart)
      Dim editorParts As New EditorPartCollection(editorArray)
      Return editorParts

    End Function

    Public Overrides ReadOnly Property WebBrowsableObject() _
                                        As Object
      Get
        Return Me
      End Get
    End Property

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

    <Personalizable(), WebBrowsable()> _
    Public Property FontStyle() As String
      Get
        Return _fontStyle
      End Get
      Set(ByVal value As String)
        _fontStyle = Value
      End Set
    End Property

    Protected Overrides Sub CreateChildControls()
      Controls.Clear()
      DisplayContent = New Label()
      DisplayContent.BackColor = Color.LightBlue
      DisplayContent.Text = Me.ContentText
      If FontStyle Is Nothing Then
        FontStyle = "None"
      End If
      SetFontStyle(DisplayContent, FontStyle)
      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

    Private Sub SetFontStyle(ByVal label As Label, _
                             ByVal selectedStyle As String)
      If selectedStyle = "Bold" Then
        label.Font.Bold = True
        label.Font.Italic = False
        label.Font.Underline = False
      ElseIf selectedStyle = "Italic" Then
        label.Font.Italic = True
        label.Font.Bold = False
        label.Font.Underline = False
      ElseIf selectedStyle = "Underline" Then
        label.Font.Underline = True
        label.Font.Bold = False
        label.Font.Italic = False
      Else
        label.Font.Bold = False
        label.Font.Italic = False
        label.Font.Underline = False
      End If

    End Sub

    ' Create a custom EditorPart to edit the WebPart control.
    <AspNetHostingPermission(SecurityAction.Demand, _
      Level:=AspNetHostingPermissionLevel.Minimal)> _
    Private Class TextDisplayEditorPart
      Inherits EditorPart
      Private _partContentFontStyle As DropDownList

      Public Sub New()
        Title = "Font Face"
      End Sub

      Public Overrides Function ApplyChanges() As Boolean
        Dim part As TextDisplayWebPart = CType(WebPartToEdit, _
                                               TextDisplayWebPart)
        ' Update the custom WebPart control with the font style.
        part.FontStyle = PartContentFontStyle.SelectedValue

        Return True

      End Function

      Public Overrides Sub SyncChanges()
        Dim part As TextDisplayWebPart = CType(WebPartToEdit, _
                                               TextDisplayWebPart)
        Dim currentStyle As String = part.FontStyle

        ' Select the current font style in the drop-down control.
        Dim item As ListItem
        For Each item In PartContentFontStyle.Items
          If item.Value = currentStyle Then
            item.Selected = True
            Exit For
          End If
        Next item

      End Sub

      Protected Overrides Sub CreateChildControls()
        Controls.Clear()

        ' Add a set of font styles to the dropdown list.
        _partContentFontStyle = New DropDownList()
        _partContentFontStyle.Items.Add("Bold")
        _partContentFontStyle.Items.Add("Italic")
        _partContentFontStyle.Items.Add("Underline")
        _partContentFontStyle.Items.Add("None")

        Controls.Add(_partContentFontStyle)

      End Sub

      Protected Overrides Sub RenderContents(ByVal writer _
                                             As HtmlTextWriter)
        writer.Write("<b>Text Content Font Style</b>")
        writer.WriteBreak()
        writer.Write("Select a font style.")
        writer.WriteBreak()
        _partContentFontStyle.RenderControl(writer)
        writer.WriteBreak()

      End Sub

      ' Access the drop-down control through a property.
      Private ReadOnly Property PartContentFontStyle() As DropDownList
        Get
          EnsureChildControls()
          Return _partContentFontStyle
        End Get
      End Property

    End Class

  End Class

End Namespace

Cargue la página en un explorador y, en el control Modo de presentación , seleccione Modo de edición para cambiar al modo de edición. Haga clic en el menú verbos (la flecha hacia abajo) en la barra de título del TextDisplayWebPart control y haga clic en Editar para editar el control. Cuando la interfaz de usuario de edición está visible, puede ver tres EditorPart controles, incluido el personalizado que le permite editar la TextDisplayWebPart.FontStyle propiedad. Si realiza algunos cambios en la interfaz de usuario de edición y hace clic en el botón Aplicar , puede usar el control de lista desplegable para devolver la página para examinar el modo y ver el efecto completo de los cambios de edición.

Comentarios

La EditorPart clase proporciona un conjunto base de propiedades y métodos que usan los controles derivados EditorPart proporcionados con el conjunto de controles de elementos web y por controles personalizados EditorPart . Un EditorPart control permite a un usuario editar un control asociado WebPart modificando su diseño, apariencia, propiedades, comportamiento u otras características.

La interfaz de usuario de edición (UI), que consta de zonas que contienen EditorPart controles, se muestra después de EditorZoneBase que una página web entre en el modo de edición.

Note

Un EditorPart control solo se puede usar dentro de una zona que deriva de la EditorZoneBase clase , como el EditorZone control .

Después de que una página haya entrado en modo de edición, un usuario puede seleccionar un WebPart control para editar haciendo clic en un verbo de edición en el menú verbos del control seleccionado. Solo se puede editar un WebPart control a la vez.

Se proporcionan varios controles derivados EditorPart con el conjunto de controles de elementos web, como se muestra en la tabla siguiente. Estos controles proporcionan todas las funcionalidades de edición necesarias para la mayoría de las aplicaciones. El enfoque típico para usar estos controles en una página de elementos web es declararlos en formato de persistencia de página dentro de un <zonetemplate> elemento, donde <zonetemplate> es el elemento secundario de un <asp:editorzone> elemento. Para obtener un ejemplo de código, vea la sección Ejemplo de este tema.

Tipo de control	Description
AppearanceEditorPart	Edita la apariencia del control asociado, incluidas las propiedades como su texto de título, el alto, el ancho y los atributos de borde.
BehaviorEditorPart	Edita ciertos comportamientos del control asociado, como si se puede editar, si se puede cerrar o si se puede mover a otra zona. Este control solo es visible en una página cuando se está editando un control en el ámbito de personalización compartida.
LayoutEditorPart	Edita los atributos de diseño para el control asociado, como si se encuentra en un estado normal o minimizado (contraído) y en qué zona se coloca.
PropertyGridEditorPart	Edita las propiedades del control asociado, si esas propiedades se declararon en el código fuente con un `WebBrowsable` atributo .

Note

Para mejorar la accesibilidad, todos los EditorPart controles proporcionados en el conjunto de controles de elementos web se representan dentro de un <fieldset> elemento. El <fieldset> elemento agrupa el conjunto relacionado de controles que se usan para editar en un control determinado EditorPart y facilita la navegación por pestañas entre esos controles para los agentes de usuario visual (como exploradores web normales) y agentes de usuario orientados a voz (como software de lectura de pantalla).

Notas a los implementadores

Para crear un control personalizado EditorPart , debe invalidar dos métodos importantes. El ApplyChanges() método aplica los cambios realizados en el control del editor al WebPart control que se está editando. El SyncChanges() método obtiene los valores actuales del WebPart control que se está editando, de modo que el control del editor pueda editarlos. Con estos dos métodos críticos, obtendrá y establecerá valores entre el control personalizado EditorPart y el WebPart control que está editando.

Si deriva de la EditorPart clase para crear controles de editor personalizados, puede agregar los controles personalizados a una EditorZoneBase zona mediante la implementación de la IWebEditable interfaz en un WebPart control, un control de usuario o un control de servidor. Para obtener más detalles y un ejemplo de código, consulte la información general de la IWebEditable clase. Además, en el ejemplo de código de la sección Ejemplo se muestra cómo implementar IWebEditable en un control personalizado WebPart .

Constructores

Nombre	Description
EditorPart()	Inicializa la clase para que la use una instancia de clase heredada. Solo una clase heredada puede llamar a este constructor.

Propiedades

Nombre	Description
AccessKey	Obtiene o establece la clave de acceso que le permite navegar rápidamente al control de servidor web. (Heredado de WebControl)
Adapter	Obtiene el adaptador específico del explorador para el control . (Heredado de Control)
AppRelativeTemplateSourceDirectory	Obtiene o establece el directorio virtual relativo a la Page aplicación del objeto o UserControl que contiene este control. (Heredado de Control)
Attributes	Obtiene la colección de atributos arbitrarios (solo para la representación) que no corresponden a las propiedades del control. (Heredado de WebControl)
BackColor	Obtiene o establece el color de fondo del control de servidor web. (Heredado de WebControl)
BackImageUrl	Obtiene o establece la dirección URL de la imagen de fondo para el control del panel. (Heredado de Panel)
BindingContainer	Obtiene el control que contiene el enlace de datos de este control. (Heredado de Control)
BorderColor	Obtiene o establece el color de borde del control Web. (Heredado de WebControl)
BorderStyle	Obtiene o establece el estilo de borde del control de servidor web. (Heredado de WebControl)
BorderWidth	Obtiene o establece el ancho de borde del control de servidor web. (Heredado de WebControl)
ChildControlsCreated	Obtiene un valor que indica si se han creado los controles secundarios del control de servidor. (Heredado de Control)
ChromeState	Obtiene o establece si un control de pieza está en un estado minimizado o normal. (Heredado de Part)
ChromeType	Obtiene o establece el tipo de borde que enmarca un control de elementos web. (Heredado de Part)
ClientID	Obtiene el identificador de control para el marcado HTML generado por ASP.NET. (Heredado de Control)
ClientIDMode	Obtiene o establece el algoritmo que se usa para generar el valor de la ClientID propiedad . (Heredado de Control)
ClientIDSeparator	Obtiene un valor de carácter que representa el carácter separador utilizado en la ClientID propiedad . (Heredado de Control)
Context	Obtiene el HttpContext objeto asociado al control de servidor para la solicitud web actual. (Heredado de Control)
Controls	Obtiene un objeto ControlCollection que contiene los controles secundarios de un control de servidor especificado en la jerarquía de la interfaz de usuario. (Heredado de Part)
ControlStyle	Obtiene el estilo del control de servidor web. Esta propiedad se usa principalmente por los desarrolladores de control. (Heredado de WebControl)
ControlStyleCreated	Obtiene un valor que indica si se ha creado un Style objeto para la ControlStyle propiedad . Esta propiedad la usan principalmente los desarrolladores de controles. (Heredado de WebControl)
CssClass	Obtiene o establece la clase Hoja de estilos en cascada (CSS) representada por el control de servidor web en el cliente. (Heredado de WebControl)
DataItemContainer	Obtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataItemContainer. (Heredado de Control)
DataKeysContainer	Obtiene una referencia al contenedor de nomenclatura si el contenedor de nomenclatura implementa IDataKeysControl. (Heredado de Control)
DefaultButton	Obtiene o establece el identificador del botón predeterminado contenido en el Panel control . (Heredado de Panel)
Description	Obtiene o establece una frase breve que resume lo que hace el control de pieza, para su uso en información sobre herramientas y catálogos de controles de elementos. (Heredado de Part)
DesignMode	Obtiene un valor que indica si se usa un control en una superficie de diseño. (Heredado de Control)
Direction	Obtiene o establece la dirección en la que se muestran los controles que incluyen texto en un Panel control. (Heredado de Panel)
Display	Obtiene un valor que indica si se debe mostrar un control cuando su control asociado WebPart está en modo de edición.
DisplayTitle	Obtiene una cadena que contiene el texto del título mostrado en la barra de título de un EditorPart control.
Enabled	Obtiene o establece un valor que indica si el control de servidor web está habilitado. (Heredado de WebControl)
EnableTheming	Obtiene o establece un valor que indica si los temas se aplican a este control. (Heredado de WebControl)
EnableViewState	Obtiene o establece un valor que indica si el control de servidor conserva su estado de vista y el estado de vista de los controles secundarios que contiene, al cliente solicitante. (Heredado de Control)
Events	Obtiene una lista de delegados del controlador de eventos para el control . Esta propiedad es de solo lectura. (Heredado de Control)
Font	Obtiene las propiedades de fuente asociadas al control de servidor web. (Heredado de WebControl)
ForeColor	Obtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web. (Heredado de WebControl)
GroupingText	Obtiene o establece el título del grupo de controles que se encuentra en el control del panel. (Heredado de Panel)
HasAttributes	Obtiene un valor que indica si el control tiene los atributos establecidos. (Heredado de WebControl)
HasChildViewState	Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen cualquier configuración de estado de vista guardada. (Heredado de Control)
Height	Obtiene o establece el alto del control de servidor web. (Heredado de WebControl)
HorizontalAlign	Obtiene o establece la alineación horizontal del contenido dentro del panel. (Heredado de Panel)
ID	Obtiene o establece el identificador de programación asignado al control de servidor. (Heredado de Control)
IdSeparator	Obtiene el carácter usado para separar los identificadores de control. (Heredado de Control)
IsChildControlStateCleared	Obtiene un valor que indica si los controles contenidos en este control tienen estado de control. (Heredado de Control)
IsEnabled	Obtiene un valor que indica si el control está habilitado. (Heredado de WebControl)
IsTrackingViewState	Obtiene un valor que indica si el control de servidor guarda los cambios en su estado de vista. (Heredado de Control)
IsViewStateEnabled	Obtiene un valor que indica si el estado de vista está habilitado para este control. (Heredado de Control)
LoadViewStateByID	Obtiene un valor que indica si el control participa en la carga de su estado de vista en ID lugar del índice. (Heredado de Control)
NamingContainer	Obtiene una referencia al contenedor de nomenclatura del control de servidor, que crea un espacio de nombres único para diferenciar entre los controles de servidor con el mismo ID valor de propiedad. (Heredado de Control)
Page	Obtiene una referencia a la Page instancia que contiene el control de servidor. (Heredado de Control)
Parent	Obtiene una referencia al control primario del control de servidor en la jerarquía de controles de página. (Heredado de Control)
RenderingCompatibility	Obtiene un valor que especifica la versión de ASP.NET con la que se representará HTML. (Heredado de Control)
ScrollBars	Obtiene o establece la visibilidad y la posición de las barras de desplazamiento en un Panel control . (Heredado de Panel)
Site	Obtiene información sobre el contenedor que hospeda el control actual cuando se representa en una superficie de diseño. (Heredado de Control)
SkinID	Obtiene o establece la máscara que se va a aplicar al control. (Heredado de WebControl)
Style	Obtiene una colección de atributos de texto que se representarán como un atributo de estilo en la etiqueta externa del control de servidor web. (Heredado de WebControl)
SupportsDisabledAttribute	Obtiene un valor que indica si el control debe establecer el `disabled` atributo del elemento HTML representado en "disabled" cuando la propiedad del IsEnabled control es `false`. (Heredado de Panel)
TabIndex	Obtiene o establece el índice de tabulación del control de servidor web. (Heredado de WebControl)
TagKey	Obtiene el HtmlTextWriterTag valor que corresponde a este control de servidor web. Esta propiedad se usa principalmente por los desarrolladores de control. (Heredado de WebControl)
TagName	Obtiene el nombre de la etiqueta de control. Esta propiedad se usa principalmente por los desarrolladores de control. (Heredado de WebControl)
TemplateControl	Obtiene o establece una referencia a la plantilla que contiene este control. (Heredado de Control)
TemplateSourceDirectory	Obtiene el directorio virtual de Page o UserControl que contiene el control de servidor actual. (Heredado de Control)
Title	Obtiene o establece el título de un control de pieza. (Heredado de Part)
ToolTip	Obtiene o establece el texto que se muestra cuando el puntero del mouse mantiene el puntero sobre el control de servidor web. (Heredado de WebControl)
UniqueID	Obtiene el identificador único calificado jerárquicamente para el control de servidor. (Heredado de Control)
ValidateRequestMode	Obtiene o establece un valor que indica si el control comprueba la entrada del cliente desde el explorador para detectar valores potencialmente peligrosos. (Heredado de Control)
ViewState	Obtiene un diccionario de información de estado que permite guardar y restaurar el estado de vista de un control de servidor en varias solicitudes para la misma página. (Heredado de Control)
ViewStateIgnoresCase	Obtiene un valor que indica si el StateBag objeto no distingue mayúsculas de minúsculas. (Heredado de Control)
ViewStateMode	Obtiene o establece el modo de estado de vista de este control. (Heredado de Control)
Visible	Obtiene o establece un valor que indica si un control de servidor se representa como interfaz de usuario en la página. (Heredado de Control)
WebPartManager	Obtiene una referencia al WebPartManager control asociado a la página web actual.
WebPartToEdit	Obtiene una referencia al WebPart control que se está editando actualmente.
Width	Obtiene o establece el ancho del control de servidor web. (Heredado de WebControl)
Wrap	Obtiene o establece un valor que indica si el contenido se ajusta dentro del panel. (Heredado de Panel)
Zone	Obtiene una referencia a la EditorZoneBase zona que contiene un EditorPart control .

Métodos

Nombre	Description
AddAttributesToRender(HtmlTextWriter)	Agrega información sobre la imagen de fondo, la alineación, el ajuste y la dirección a la lista de atributos que se van a representar. (Heredado de Panel)
AddedControl(Control, Int32)	Se llama después de agregar un control secundario a la Controls colección del Control objeto . (Heredado de Control)
AddParsedSubObject(Object)	Notifica al control de servidor que se ha analizado un elemento, ya sea XML o HTML, y agrega el elemento al objeto del control de ControlCollection servidor. (Heredado de Control)
ApplyChanges()	Guarda los valores de un EditorPart control en las propiedades correspondientes del control asociado WebPart .
ApplyStyle(Style)	Copia todos los elementos que no sean de marca del estilo especificado en el control Web, sobrescribir los elementos de estilo existentes del control. Este método lo usan principalmente los desarrolladores de controles. (Heredado de WebControl)
ApplyStyleSheetSkin(Page)	Aplica las propiedades de estilo definidas en la hoja de estilos de página al control . (Heredado de Control)
BeginRenderTracing(TextWriter, Object)	Comienza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control)
BuildProfileTree(String, Boolean)	Recopila información sobre el control de servidor y la entrega a la Trace propiedad que se va a mostrar cuando el seguimiento está habilitado para la página. (Heredado de Control)
ClearCachedClientID()	Establece el valor ClientIDalmacenado en caché en `null` . (Heredado de Control)
ClearChildControlState()	Elimina la información de estado de control de los controles secundarios del control de servidor. (Heredado de Control)
ClearChildState()	Elimina la información de estado de vista y estado de control de todos los controles secundarios del control de servidor. (Heredado de Control)
ClearChildViewState()	Elimina la información de estado de vista de todos los controles secundarios del control de servidor. (Heredado de Control)
ClearEffectiveClientIDMode()	Establece la ClientIDMode propiedad de la instancia de control actual y de cualquier control secundario en Inherit. (Heredado de Control)
CopyBaseAttributes(WebControl)	Copia las propiedades no encapsuladas por el Style objeto desde el control de servidor web especificado al control de servidor web desde el que se llama a este método. Este método se usa principalmente por los desarrolladores de controles. (Heredado de WebControl)
CreateChildControls()	Llamado por el marco de ASP.NET página para notificar a los controles de servidor que usan la implementación basada en composición para crear los controles secundarios que contengan como preparación para la publicación o representación. (Heredado de Control)
CreateControlCollection()	Crea un nuevo ControlCollection objeto para contener los controles secundarios (literal y servidor) del control de servidor. (Heredado de Control)
CreateControlStyle()	Crea un objeto de estilo que el control usa internamente Panel para implementar todas las propiedades relacionadas con el estilo. (Heredado de Panel)
DataBind()	Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios. (Heredado de Part)
DataBind(Boolean)	Enlaza un origen de datos al control de servidor invocado y a todos sus controles secundarios con una opción para generar el DataBinding evento. (Heredado de Control)
DataBindChildren()	Enlaza un origen de datos a los controles secundarios del control de servidor. (Heredado de Control)
Dispose()	Permite que un control de servidor realice la limpieza final antes de liberarse de la memoria. (Heredado de Control)
EndRenderTracing(TextWriter, Object)	Finaliza el seguimiento en tiempo de diseño de los datos de representación. (Heredado de Control)
EnsureChildControls()	Determina si el control de servidor contiene controles secundarios. Si no es así, crea controles secundarios. (Heredado de Control)
EnsureID()	Crea un identificador para los controles que no tienen asignado un identificador. (Heredado de Control)
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
FindControl(String, Int32)	Busca en el contenedor de nomenclatura actual un control de servidor con el especificado `id` y un entero, especificado en el `pathOffset` parámetro , que ayuda en la búsqueda. No debe invalidar esta versión del FindControl método. (Heredado de Control)
FindControl(String)	Busca en el contenedor de nomenclatura actual un control de servidor con el parámetro especificado `id` . (Heredado de Control)
Focus()	Establece el foco de entrada en un control. (Heredado de Control)
GetDesignModeState()	Recupera el estado actual de la zona primaria de un EditorPart control.
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetRouteUrl(Object)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Heredado de Control)
GetRouteUrl(RouteValueDictionary)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta. (Heredado de Control)
GetRouteUrl(String, Object)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Heredado de Control)
GetRouteUrl(String, RouteValueDictionary)	Obtiene la dirección URL que corresponde a un conjunto de parámetros de ruta y un nombre de ruta. (Heredado de Control)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetUniqueIDRelativeTo(Control)	Devuelve la parte prefijo de la UniqueID propiedad del control especificado. (Heredado de Control)
HasControls()	Determina si el control de servidor contiene controles secundarios. (Heredado de Control)
HasEvents()	Devuelve un valor que indica si los eventos están registrados para el control o para los controles secundarios. (Heredado de Control)
IsLiteralContent()	Determina si el control de servidor contiene solo contenido literal. (Heredado de Control)
LoadControlState(Object)	Restaura la información de estado de control de una solicitud de página anterior guardada por el SaveControlState() método . (Heredado de Control)
LoadViewState(Object)	Restaura la información de estado de vista de una solicitud anterior que se guardó con el SaveViewState() método . (Heredado de WebControl)
MapPathSecure(String)	Recupera la ruta de acceso física a la que se asigna una ruta de acceso virtual, absoluta o relativa. (Heredado de Control)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
MergeStyle(Style)	Copia todos los elementos que no sean de marca del estilo especificado en el control Web, pero no sobrescribirán ningún elemento de estilo existente del control. Este método se usa principalmente por los desarrolladores de controles. (Heredado de WebControl)
OnBubbleEvent(Object, EventArgs)	Determina si el evento del control de servidor se pasa a la jerarquía de controles de servidor de interfaz de usuario de la página. (Heredado de Control)
OnDataBinding(EventArgs)	Genera el evento DataBinding. (Heredado de Control)
OnInit(EventArgs)	Genera el evento Init. (Heredado de Control)
OnLoad(EventArgs)	Genera el evento Load. (Heredado de Control)
OnPreRender(EventArgs)	Genera el evento PreRender.
OnUnload(EventArgs)	Genera el evento Unload. (Heredado de Control)
OpenFile(String)	Obtiene un objeto Stream que se usa para leer un archivo. (Heredado de Control)
RaiseBubbleEvent(Object, EventArgs)	Asigna cualquier origen del evento y su información al elemento primario del control. (Heredado de Control)
RemovedControl(Control)	Se llama después de quitar un control secundario de la Controls colección del Control objeto . (Heredado de Control)
Render(HtmlTextWriter)	Representa el control en el escritor HTML especificado. (Heredado de WebControl)
RenderBeginTag(HtmlTextWriter)	Representa la etiqueta de apertura HTML del Panel control en el escritor especificado. (Heredado de Panel)
RenderChildren(HtmlTextWriter)	Genera el contenido de los elementos secundarios de un control de servidor en un objeto proporcionado HtmlTextWriter , que escribe el contenido que se va a representar en el cliente. (Heredado de Control)
RenderContents(HtmlTextWriter)	Representa el contenido del control en el escritor especificado. Este método se usa principalmente por los desarrolladores de controles. (Heredado de WebControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Genera contenido de control de servidor en un objeto proporcionado HtmlTextWriter mediante un objeto proporcionado ControlAdapter . (Heredado de Control)
RenderControl(HtmlTextWriter)	Genera contenido de control de servidor en un objeto proporcionado HtmlTextWriter y almacena información de seguimiento sobre el control si el seguimiento está habilitado. (Heredado de Control)
RenderEndTag(HtmlTextWriter)	Representa la etiqueta de cierre HTML del Panel control en el escritor especificado. (Heredado de Panel)
ResolveAdapter()	Obtiene el adaptador de control responsable de representar el control especificado. (Heredado de Control)
ResolveClientUrl(String)	Obtiene una dirección URL que el explorador puede usar. (Heredado de Control)
ResolveUrl(String)	Convierte una dirección URL en una que se pueda usar en el cliente solicitante. (Heredado de Control)
SaveControlState()	Guarda los cambios de estado de control de servidor que se han producido desde el momento en que se devolvió la página al servidor. (Heredado de Control)
SaveViewState()	Guarda cualquier estado que se modificó después de invocar el TrackViewState() método . (Heredado de WebControl)
SetDesignModeState(IDictionary)	Aplica las características del estado del modo de diseño a la zona actual EditorZoneBase que contiene un EditorPart control .
SetRenderMethodDelegate(RenderMethod)	Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en su control primario. (Heredado de Control)
SetTraceData(Object, Object, Object)	Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante el objeto rastreado, la clave de datos de seguimiento y el valor de los datos de seguimiento. (Heredado de Control)
SetTraceData(Object, Object)	Establece los datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, mediante la clave de datos de seguimiento y el valor de los datos de seguimiento. (Heredado de Control)
SyncChanges()	Recupera los valores de propiedad de un WebPart control para su control asociado EditorPart .
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TrackViewState()	Hace que el control realice un seguimiento de los cambios en su estado de vista para que se puedan almacenar en la propiedad del ViewState objeto. (Heredado de WebControl)

Eventos

Nombre	Description
DataBinding	Se produce cuando el control de servidor se enlaza a un origen de datos. (Heredado de Control)
Disposed	Se produce cuando se libera un control de servidor de la memoria, que es la última fase del ciclo de vida del control de servidor cuando se solicita una página de ASP.NET. (Heredado de Control)
Init	Se produce cuando se inicializa el control de servidor, que es el primer paso de su ciclo de vida. (Heredado de Control)
Load	Se produce cuando el control de servidor se carga en el Page objeto . (Heredado de Control)
PreRender	Se produce después de cargar el Control objeto, pero antes de la representación. (Heredado de Control)
Unload	Se produce cuando el control de servidor se descarga de la memoria. (Heredado de Control)

Implementaciones de interfaz explícitas

Nombre	Description
IAttributeAccessor.GetAttribute(String)	Obtiene un atributo del control Web con el nombre especificado. (Heredado de WebControl)
IAttributeAccessor.SetAttribute(String, String)	Establece un atributo del control Web en el nombre y el valor especificados. (Heredado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()	Permite al desarrollador de un diseñador de un control de pieza compuesta volver a crear los controles secundarios del control en la superficie de diseño. (Heredado de Part)
IControlBuilderAccessor.ControlBuilder	Para obtener una descripción de este miembro, vea ControlBuilder. (Heredado de Control)
IControlDesignerAccessor.GetDesignModeState()	Para obtener una descripción de este miembro, vea GetDesignModeState(). (Heredado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Para obtener una descripción de este miembro, vea SetDesignModeState(IDictionary). (Heredado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Para obtener una descripción de este miembro, vea SetOwnerControl(Control). (Heredado de Control)
IControlDesignerAccessor.UserData	Para obtener una descripción de este miembro, vea UserData. (Heredado de Control)
IDataBindingsAccessor.DataBindings	Para obtener una descripción de este miembro, vea DataBindings. (Heredado de Control)
IDataBindingsAccessor.HasDataBindings	Para obtener una descripción de este miembro, vea HasDataBindings. (Heredado de Control)
IExpressionsAccessor.Expressions	Para obtener una descripción de este miembro, vea Expressions. (Heredado de Control)
IExpressionsAccessor.HasExpressions	Para obtener una descripción de este miembro, vea HasExpressions. (Heredado de Control)
IParserAccessor.AddParsedSubObject(Object)	Para obtener una descripción de este miembro, vea AddParsedSubObject(Object). (Heredado de Control)

Métodos de extensión

Nombre	Description
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Habilita el comportamiento de datos dinámicos para el control de datos especificado.
EnableDynamicData(INamingContainer, Type, Object)	Habilita el comportamiento de datos dinámicos para el control de datos especificado.
EnableDynamicData(INamingContainer, Type)	Habilita el comportamiento de datos dinámicos para el control de datos especificado.
FindDataSourceControl(Control)	Devuelve el origen de datos asociado al control de datos para el control especificado.
FindFieldTemplate(Control, String)	Devuelve la plantilla de campo de la columna especificada en el contenedor de nomenclatura del control especificado.
FindMetaTable(Control)	Devuelve el objeto de metatable para el control de datos contenedor.
GetDefaultValues(INamingContainer)	Obtiene la colección de los valores predeterminados para el control de datos especificado.
GetMetaTable(INamingContainer)	Obtiene los metadatos de la tabla para el control de datos especificado.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Establece los metadatos de la tabla y la asignación de valores predeterminados para el control de datos especificado.
SetMetaTable(INamingContainer, MetaTable, Object)	Establece los metadatos de la tabla y la asignación de valores predeterminados para el control de datos especificado.
SetMetaTable(INamingContainer, MetaTable)	Establece los metadatos de la tabla para el control de datos especificado.
TryGetMetaTable(INamingContainer, MetaTable)	Determina si los metadatos de la tabla están disponibles.

Se aplica a

Consulte también

Comentarios

¿Le ha resultado útil esta página?