EditorZoneBase Clase

Definición

Actúa como la clase base para todos los controles de zona que actúan como contenedores para los controles EditorPart.

public ref class EditorZoneBase abstract : System::Web::UI::WebControls::WebParts::ToolZone
public abstract class EditorZoneBase : System.Web.UI.WebControls.WebParts.ToolZone
type EditorZoneBase = class
    inherit ToolZone
Public MustInherit Class EditorZoneBase
Inherits ToolZone
Herencia
Derivado

Ejemplos

En el ejemplo de código siguiente se muestran varios usos declarativos y mediante programación de la EditorZoneBase clase . Dado que la clase es abstracta, los ejemplos de código usan la clase derivada EditorZone que se incluye con el conjunto de controles de elementos web, mostrando las propiedades y los métodos que hereda de la EditorZoneBase clase .

El ejemplo de código tiene cuatro partes:

  • Control de usuario que le permite cambiar los modos de presentación en la página web.

  • Página web que contiene un EditorZone control .

  • Una clase personalizada EditorZone que muestra algunos de los miembros de la EditorZoneBase clase.

  • Descripción de cómo funciona el ejemplo en un explorador.

El código fuente del control de usuario procede de otro tema. Para que este ejemplo de código funcione, debe obtener el archivo .ascx para el control de usuario del tema Walkthrough: Changing Display Modes on a Web Parts Page y colocar el archivo en la misma carpeta que la página .aspx en este ejemplo de código.

La segunda parte del ejemplo de código es una página web que contiene una referencia declarativa a un EditorZone control . Cerca de la parte superior de la página hay una Register directiva para el control de usuario. La etiqueta de control de usuario se declara en la página con un <uc1:DisplayModeMenu> elemento . Observe que debajo del <asp:WebPartZone> elemento es un <asp:EditorZone> elemento que contiene EditorPart controles y tiene una variedad de etiquetas y propiedades establecidas para determinar su apariencia y comportamiento. La mayoría del código de la página muestra los distintos usos mediante programación de las EditorZoneBase propiedades y los métodos.

<%@ Page Language="C#" %>
<%@ register tagprefix="uc1" 
  tagname="DisplayModeMenuCS" 
  src="displaymodecs.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" %>
  
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
// <snippet3> 

  // <snippet4> 
  void Button1_Click(object sender, EventArgs e)
  {
    if (EditorZone1.ApplyVerb.Enabled)
      EditorZone1.ApplyVerb.Enabled = false;
    else
      EditorZone1.ApplyVerb.Enabled = true;
  }
  // </snippet4>
  // <snippet5> 
  void Button2_Click(object sender, EventArgs e)
  {
    if (EditorZone1.CancelVerb.Enabled)
      EditorZone1.CancelVerb.Enabled = false;
    else
      EditorZone1.CancelVerb.Enabled = true;
  }
  // </snippet5>
  // <snippet6>
  void Button3_Click(object sender, EventArgs e)
  {
    Label1.Text = "<br />";
    foreach (EditorPart part in EditorZone1.EditorParts)
    {
      Label1.Text += part.ID + "<br />";
    }
  }
  // </snippet6>
  // <snippet7>
  void Button4_Click(object sender, EventArgs e)
  {
    if (EditorZone1.OKVerb.Enabled)
      EditorZone1.OKVerb.Enabled = false;
    else
      EditorZone1.OKVerb.Enabled = true;
  }
  // </snippet7>
  
// </snippet3>    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
  <title>EditorZoneBase Examples</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuCS runat="server" id="displaymodemenu1" />
    <asp:WebPartZone ID="WebPartZone1" runat="server">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <asp:Calendar ID="Calendar1" Runat="server" 
          Title="My Calendar" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyEditorZone ID="EditorZone1" runat="server">
      <ApplyVerb Text="Apply Changes" />
      <CancelVerb Text="Cancel Changes" />
      <OKVerb Text="Finished" />
      <ZoneTemplate>
        <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
          runat="server" />
        <asp:LayoutEditorPart ID="LayoutEditorPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyEditorZone>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Toggle ApplyVerb Enabled" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Toggle CancelVerb Enabled" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorParts Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Toggle OKVerb Enabled" OnClick="Button4_Click" /> 
  </form>
</body>
</html>
<%@ Page Language="vb" %>
<%@ register tagprefix="uc1" 
  tagname="DisplayModeMenuVB" 
  src="displaymodevb.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
  ' <snippet3> 

  ' <snippet4> 
  Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
    If EditorZone1.ApplyVerb.Enabled Then
      EditorZone1.ApplyVerb.Enabled = False
    Else
      EditorZone1.ApplyVerb.Enabled = True
    End If
  End Sub
  ' </snippet4>
  ' <snippet5> 
  Sub Button2_Click(ByVal sender As Object, ByVal e As EventArgs)
    If EditorZone1.CancelVerb.Enabled Then
      EditorZone1.CancelVerb.Enabled = False
    Else
      EditorZone1.CancelVerb.Enabled = True
    End If
  End Sub
  ' </snippet5>
  ' <snippet6>
  Sub Button3_Click(ByVal sender As Object, ByVal e As EventArgs)
    Label1.Text = "<br />"
    Dim part As EditorPart
    For Each part In EditorZone1.EditorParts
      Label1.Text += part.ID + "<br />"
    Next part
  End Sub
  ' </snippet6>
  ' <snippet7>
  Sub Button4_Click(ByVal sender As Object, ByVal e As EventArgs)
    If EditorZone1.OKVerb.Enabled Then
      EditorZone1.OKVerb.Enabled = False
    Else
      EditorZone1.OKVerb.Enabled = True
    End If

  End Sub
  ' </snippet7>
  
  ' </snippet3>
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
  <title>EditorZoneBase Examples</title>
</head>
<body>
  <form id="form1" runat="server">
    <asp:WebPartManager ID="WebPartManager1" runat="server" />
    <uc1:DisplayModeMenuVB runat="server" id="displaymodemenu1" />
    <asp:WebPartZone ID="WebPartZone1" runat="server">
      <ZoneTemplate>
        <asp:BulletedList 
          ID="BulletedList1" 
          Runat="server"
          DisplayMode="HyperLink" 
          Title="Favorite Links" >
          <asp:ListItem Value="http://msdn.microsoft.com">
            MSDN
          </asp:ListItem>
          <asp:ListItem Value="http://www.asp.net">
            ASP.NET
          </asp:ListItem>
          <asp:ListItem Value="http://www.msn.com">
            MSN
          </asp:ListItem>
        </asp:BulletedList>
        <asp:Calendar ID="Calendar1" Runat="server" 
          Title="My Calendar" />
      </ZoneTemplate>
    </asp:WebPartZone>
    <aspSample:MyEditorZone ID="EditorZone1" runat="server">
      <ApplyVerb Text="Apply Changes" />
      <CancelVerb Text="Cancel Changes" />
      <OKVerb Text="Finished" />
      <ZoneTemplate>
        <asp:AppearanceEditorPart ID="AppearanceEditorPart1" 
          runat="server" />
        <asp:LayoutEditorPart ID="LayoutEditorPart1" 
          runat="server" />
      </ZoneTemplate>
    </aspSample:MyEditorZone>
    <hr />
    <asp:Button ID="Button1" runat="server" Width="200"
      Text="Toggle ApplyVerb Enabled" OnClick="Button1_Click" />
    <br />
    <asp:Button ID="Button2" runat="server" Width="200"
      Text="Toggle CancelVerb Enabled" OnClick="Button2_Click" />
    <br />
    <asp:Button ID="Button3" runat="server" Width="200"
      Text="Display EditorParts Collection" OnClick="Button3_Click" />
    <asp:Label ID="Label1" runat="server" />
    <br />
    <asp:Button ID="Button4" runat="server" Width="200"
      Text="Toggle OKVerb Enabled" OnClick="Button4_Click" /> 
  </form>
</body>
</html>

La tercera parte del ejemplo de código es una clase personalizada EditorZone que muestra cómo trabajar con varios miembros de clase EditorZoneBase . La clase personalizada se deriva de EditorZone para que se pueda usar con una plantilla de zona en el marcado declarativo de la página web. Para que se ejecute el ejemplo de código, debe compilar este código fuente. Puede compilarlo explícitamente y colocar el ensamblado resultante en la carpeta Bin del sitio web o en la caché global de ensamblados. Como alternativa, puede colocar el código fuente en la carpeta App_Code del sitio, donde se compilará dinámicamente en tiempo de ejecución. En este ejemplo de código se usa la compilación dinámica; por lo tanto, observará que la Register directiva cerca de la parte superior de la página web no hace referencia a un archivo de ensamblado. Para ver un tutorial que muestra ambos métodos de compilación, vea Walkthrough: Developing and Using a Custom Web Server Control.

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 MyEditorZone : EditorZone
  {
    public MyEditorZone()
    {
    }
    protected override void OnDisplayModeChanged(object sender, 
      WebPartDisplayModeEventArgs e)
    {
      this.BackColor = Color.LightGray;
      base.OnDisplayModeChanged(sender, e);
    }
    protected override void OnSelectedWebPartChanged(object sender, 
      WebPartEventArgs e)
    {
      if (e.WebPart != null)
        e.WebPart.Zone.SelectedPartChromeStyle.BackColor = 
          Color.LightGreen;
      base.OnSelectedWebPartChanged(sender, e);
    }
    protected override void RenderBody(HtmlTextWriter writer)
    {
      writer.WriteLine("<hr />");
      base.RenderBody(writer);
    }
    protected override void RenderVerbs(HtmlTextWriter writer)
    {
      WebPartVerb[] verbs = new WebPartVerb[] { OKVerb, 
        CancelVerb, ApplyVerb };
      foreach (WebPartVerb verb in verbs)
      {
        if (verb != null)
          verb.Text += " Verb";
      }
      base.RenderVerbs(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 MyEditorZone
    Inherits EditorZone

    Public Sub New()
    End Sub

    Protected Overrides Sub OnDisplayModeChanged(ByVal sender _
      As Object, ByVal e As WebPartDisplayModeEventArgs)
      Me.BackColor = Color.LightGray
      MyBase.OnDisplayModeChanged(sender, e)
    End Sub
    Protected Overrides Sub OnSelectedWebPartChanged(ByVal sender _
      As Object, ByVal e As WebPartEventArgs)
      If Not (e.WebPart Is Nothing) Then
        e.WebPart.Zone.SelectedPartChromeStyle.BackColor = _
          Color.LightGreen
      End If
      MyBase.OnSelectedWebPartChanged(sender, e)

    End Sub
    Protected Overrides Sub RenderBody(ByVal writer As _
      HtmlTextWriter)
      writer.WriteLine("<hr />")
      MyBase.RenderBody(writer)
    End Sub
    Protected Overrides Sub RenderVerbs(ByVal writer As _
      HtmlTextWriter)
      Dim verbs() As WebPartVerb = {OKVerb, CancelVerb, ApplyVerb}
      Dim verb As WebPartVerb
      For Each verb In verbs
        If Not (verb Is Nothing) Then
          verb.Text += " Verb"
        End If
      Next verb
      MyBase.RenderVerbs(writer)
    End Sub
  End Class

End Namespace

Al cargar la página en un explorador, puede seleccionar Modo de edición en la lista desplegable para cambiar al modo de edición. Puede hacer clic en el menú verbos (la flecha hacia abajo) en la barra de título de uno de los dos controles y hacer clic en Editar para editar el control. Cuando la interfaz de usuario de edición está visible, puede ver los efectos de los distintos usos declarativos y mediante programación de los miembros de clase EditorZoneBase .

Comentarios

La EditorZoneBase clase es una clase de zona especializada que hereda de la ToolZone clase y proporciona un conjunto base de comportamientos para zonas derivadas que contienen EditorPart controles. Hay otros tipos de ToolZone clases; para obtener más información, vea el tema de información general de la ToolZone clase . Al igual que otras zonas de herramientas, EditorZoneBase las zonas no son visibles cuando una página está en modo de exploración normal; solo son visibles cuando una página está en modo de presentación de edición. Al igual que las otras zonas de herramientas, EditorZoneBase las zonas solo pueden contener el tipo especial de controles que se diseñaron para contener (en este caso, EditorPart controles).

Las EditorZoneBase zonas proporcionan una interfaz de usuario especial para los controles de edición que contienen. Muchos de estos elementos de interfaz de usuario son comunes a todas las zonas del conjunto de controles de elementos web. Para obtener una explicación detallada de los elementos comunes de la interfaz de usuario en las zonas de elementos web, consulte el tema de información general de la clase para la WebZone clase .

Dado que la EditorZoneBase clase es abstracta, no se puede usar directamente en una página web. En su lugar, debe usar un control que herede de la EditorZoneBase clase e implemente su comportamiento. Puede usar la zona derivada que se proporciona en el conjunto de controles de elementos web, el EditorZone control o puede derivar su propio control personalizado EditorZoneBase .

La EditorZoneBase clase proporciona una interfaz de usuario común (UI) para contener controles especiales que permiten a los usuarios finales editar las propiedades, el diseño, la apariencia y otros atributos de WebPart los controles. Algunas propiedades que se aplican a la interfaz de usuario hacen referencia a verbos, como las ApplyVerbpropiedades , CancelVerby OKVerb . Los verbos son acciones comunes realizadas por los usuarios en una página y se representan en la interfaz de usuario mediante botones, vínculos, elementos de menú u otros elementos. Por ejemplo, cuando los usuarios editan propiedades en un control, pueden hacer clic en un verbo aplicar para guardar los cambios.

Otras propiedades afectan al texto que se muestra en varios puntos de la interfaz de usuario de edición. Entre ellas se incluyen las EmptyZoneTextpropiedades , ErrorText, HeaderTexty InstructionText .

Dos propiedades importantes proporcionan referencias a controles relacionados. La EditorParts propiedad es una colección de los EditorPart controles contenidos en la zona. La WebPartToEdit propiedad es una referencia de objeto a un control contenido en un WebPartZonecontrol , que puede ser un WebPart control o cualquier otro control de servidor ASP.NET, control de usuario o control personalizado que se está editando actualmente.

Por último, la EditorPartChrome propiedad hace referencia a una instancia de un EditorPartChrome objeto asociado a la zona y que contiene características de estilo de los elementos periféricos de la interfaz de usuario (conocidos como cromo), como estilos de título y borde para EditorPart los controles de la zona.

Varios de los métodos de la EditorZoneBase clase están especializados para controlar la edición de otros controles. El Close método cambia la página del modo de presentación de edición a una vista de exploración normal. El CreateEditorPartChrome método consiste en crear el cromo (elementos periféricos de la interfaz de usuario, como un borde, verbos, iconos y un título) que rodea cada EditorPart control de la zona. El CreateEditorParts método es un método abstracto; las clases derivadas la invalidan para crear instancias de todos los EditorPart controles contenidos en la zona. Una InvalidateEditorParts clase derivada puede llamar al método si la colección de controles de EditorPart la zona cambia por algún motivo mediante programación, que marca el control de elementos web establecido para volver a crear y actualizar la colección de EditorPart controles. El OnDisplayModeChanged método se usa para establecer la colección de controles en null cuando el modo de EditorPart presentación cambia del modo de edición al modo de exploración. Por último, el OnSelectedWebPartChanged método se usa para controlar el evento cuando un WebPart control entra o sale del modo de edición. Por ejemplo, este método es un lugar cómodo para sincronizar los valores de propiedad de un WebPart control con los valores editables de los controles asociados EditorPart .

Notas a los implementadores

Si desea desarrollar una zona personalizada para los controles de hospedaje EditorPart , debe determinar si desea proporcionar compatibilidad con plantillas de zona. Los tipos que implementan la ITemplate interfaz crean una plantilla de zona y es necesario si desea permitir que los desarrolladores de páginas usen la zona personalizada para hacer referencia EditorPart a controles dentro de la zona en el marcado declarativo de una página web. Si necesita compatibilidad con plantillas de zona, debe heredar de la EditorZone clase .

Por el contrario, si la zona personalizada y sus EditorPart controles serán independientes y se crearán mediante programación sin ninguna opción para que los desarrolladores de páginas especifiquen los controles mediante declaración en una plantilla de zona, puede heredar directamente de la EditorZoneBase clase . Si lo hace, es fundamental implementar el CreateEditorParts() método para que la zona personalizada funcione.

Constructores

EditorZoneBase()

Inicializa la clase para que la use una instancia de la clase heredada. A este constructor solo lo puede llamar una clase heredada.

Propiedades

AccessKey

Obtiene o establece la clave de acceso que 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)
ApplyVerb

Obtiene una referencia a un objeto WebPartVerb que permite a los usuarios finales aplicar los cambios de edición a un control en modo de edición.

AppRelativeTemplateSourceDirectory

Obtiene o establece el directorio virtual relativo a la aplicación del objeto Page o el objeto UserControl que contiene este control.

(Heredado de Control)
AssociatedDisplayModes

Obtiene la colección de objetos WebPartDisplayMode que están asociados a una zona ToolZone determinada.

(Heredado de ToolZone)
Attributes

Obtiene la colección de atributos arbitrarios (sólo para su representación) que no corresponden a 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 a una imagen de fondo para una zona.

(Heredado de WebZone)
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 del borde del control de servidor web.

(Heredado de WebControl)
BorderWidth

Obtiene o establece el ancho del borde del control de servidor web.

(Heredado de WebControl)
CancelVerb

Obtiene una referencia a un objeto WebPartVerb que permite a los usuarios finales cancelar los cambios de edición a un control en modo de edición.

ChildControlsCreated

Obtiene un valor que indica si se han creado controles secundarios del control de servidor.

(Heredado de Control)
ClientID

Obtiene el id. de control para marcado HTML que se genera por ASP.NET.

(Heredado de Control)
ClientIDMode

Obtiene o establece el algoritmo que se utiliza para generar el valor de la propiedad ClientID.

(Heredado de Control)
ClientIDSeparator

Obtiene un valor de carácter que representa el carácter separado utilizado en la propiedad ClientID.

(Heredado de Control)
Context

Obtiene el objeto HttpContext asociado al control de servidor para la solicitud Web actual.

(Heredado de Control)
Controls

Obtiene un objeto ControlCollection que representa los controles secundarios de CompositeControl.

(Heredado de CompositeControl)
ControlStyle

Obtiene el estilo del control de servidor web. Esta propiedad la usan principalmente los programadores de controles.

(Heredado de WebControl)
ControlStyleCreated

Obtiene un valor que indica si se ha creado un objeto Style para la propiedad ControlStyle. Esta propiedad la usan principalmente los programadores de controles.

(Heredado de WebControl)
CssClass

Obtiene o establece la clase hoja de estilos en cascada (CSS) presentada por el control de servidor web en el cliente.

(Heredado de WebControl)
DataItemContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataItemContainer.

(Heredado de Control)
DataKeysContainer

Obtiene una referencia al contenedor de nomenclatura si este implementa IDataKeysControl.

(Heredado de Control)
DesignMode

Obtiene un valor que indica si se está utilizando un control en una superficie de diseño.

(Heredado de Control)
Display

Obtiene un valor que indica si un control ToolZone se muestra actualmente.

EditorPartChrome

Obtiene una referencia a la instancia de la clase EditorPartChrome asociada a la zona EditorZoneBase.

EditorParts

Obtiene una colección de todos los controles EditorPart contenidos en una zona EditorZoneBase.

EditUIStyle

Obtiene los atributos de estilo para los controles modificables contenidos en un control ToolZone.

(Heredado de ToolZone)
EmptyZoneText

Obtiene o establece un mensaje que aparece cuando una zona no contiene controles.

EmptyZoneTextStyle

Obtiene los atributos de estilo para el texto del marcador de posición en una zona vacía.

(Heredado de WebZone)
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, así como el estado de vista de los controles secundarios que contiene, al cliente solicitante.

(Heredado de Control)
ErrorStyle

Obtiene los atributos de estilo para representar el mensaje de error que se muestra si no se puede cargar o crear un control WebPart.

(Heredado de WebZone)
ErrorText

Obtiene o establece el texto de un mensaje de error de nivel de zona para mostrarlo en la parte superior de la interfaz de usuario de edición.

Events

Obtiene una lista de delegados de controladores de eventos del control. Esta propiedad es de sólo lectura.

(Heredado de Control)
Font

Obtiene las propiedades de fuente asociadas al control de servidor web.

(Heredado de WebControl)
FooterStyle

Obtiene los atributos de estilo del contenido del área de pie de página de una zona.

(Heredado de WebZone)
ForeColor

Obtiene o establece el color de primer plano (normalmente el color del texto) del control de servidor web.

(Heredado de WebControl)
HasAttributes

Obtiene un valor que indica si el control tiene establecido algún atributo.

(Heredado de WebControl)
HasChildViewState

Obtiene un valor que indica si los controles secundarios del control de servidor actual tienen guardada alguna configuración del estado de vista.

(Heredado de Control)
HasFooter

Obtiene un valor que indica si una zona tiene un área de pie de página.

(Heredado de WebZone)
HasHeader

Obtiene un valor que indica si una zona tiene un área de encabezado.

(Heredado de WebZone)
HeaderCloseVerb

Obtiene una referencia al objeto WebPartVerb en el encabezado de un control ToolZone utilizado para cerrar el control.

(Heredado de ToolZone)
HeaderStyle

Obtiene los atributos de estilo del contenido del área de encabezado de una zona.

(Heredado de WebZone)
HeaderText

Obtiene o establece el texto del área de encabezado de una zona.

HeaderVerbStyle

Obtiene los atributos de estilo de todos los verbos del encabezado mostrados en un control ToolZone.

(Heredado de ToolZone)
Height

Obtiene o establece el alto del control de servidor Web.

(Heredado de WebControl)
ID

Obtiene o establece el identificador de programación asignado al control de servidor.

(Heredado de Control)
IdSeparator

Obtiene el carácter utilizado para separar los identificadores de control.

(Heredado de Control)
InstructionText

Obtiene o establece el texto de un control ToolZone que ofrece instrucciones para los usuarios finales.

InstructionTextStyle

Obtiene los atributos de estilo del texto de instrucciones que aparece en la parte superior de un control ToolZone.

(Heredado de ToolZone)
IsChildControlStateCleared

Obtiene un valor que indica si los controles que se encuentran en este control tienen estado de control.

(Heredado de Control)
IsEnabled

Obtiene un valor que indica si está habilitado el control.

(Heredado de WebControl)
IsTrackingViewState

Obtiene un valor que indica si el control de servidor está guardando los cambios realizados 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)
LabelStyle

Obtiene los atributos de estilo del contenido de las etiquetas que aparecen junto a los controles de edición dentro de un control ToolZone. Los controles ToolZone derivados, como CatalogZone y EditorZone, aplican los estilos a las etiquetas.

(Heredado de ToolZone)
LoadViewStateByID

Obtiene un valor que indica si el control participa en la carga de su estado de vista mediante ID en lugar de í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 los distintos controles de servidor que tienen el mismo valor para la propiedad ID.

(Heredado de Control)
OKVerb

Obtiene una referencia a un objeto WebPartVerb que aplica cambios de edición a un control en modo de edición y oculta la interfaz de usuario de edición.

Padding

Obtiene o establece los atributos de espacio del borde al texto para las celdas de la tabla que contiene los controles WebPart de una zona.

(Heredado de WebZone)
Page

Obtiene una referencia a la instancia Page que contiene el control de servidor.

(Heredado de Control)
Parent

Obtiene una referencia al control principal del control de servidor en la jerarquía de controles de página.

(Heredado de Control)
PartChromePadding

Obtiene o establece la distancia entre el contenido de un control WebPart y su borde.

(Heredado de WebZone)
PartChromeStyle

Obtiene las características de estilo que se aplican a los bordes de los controles de elementos Web que una zona contiene.

(Heredado de WebZone)
PartChromeType

Obtiene o establece el tipo de borde que rodea los controles de elementos Web incluidos en una zona.

(Heredado de WebZone)
PartStyle

Obtiene las características de estilo que se aplican al borde y al contenido de cada control de elementos Web que una zona contiene.

(Heredado de WebZone)
PartTitleStyle

Obtiene los atributos de estilo del contenido de la barra de título de cada control de elementos Web que una zona contiene.

(Heredado de WebZone)
RenderClientScript

Obtiene un valor que indica si se va a representar script de cliente en una página de elementos Web.

(Heredado de WebZone)
RenderingCompatibility

Obtiene o establece un valor que especifica la versión de ASP.NET compatible con los elementos HTML representados.

(Heredado de Control)
Site

Obtiene información sobre el contenedor en que se encuentra el control actual cuando se representa en una superficie de diseño.

(Heredado de Control)
SkinID

Obtiene o establece la máscara que se aplica al control.

(Heredado de WebControl)
Style

Obtiene una colección de atributos de texto que se representan como 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 en "disabled" el atributo disabled del elemento HTML representado cuando el valor de la propiedad IsEnabled del control es false.

(Heredado de CompositeControl)
TabIndex

Obtiene o establece el índice de tabulación del control de servidor web.

(Heredado de WebControl)
TagKey

Obtiene el valor HtmlTextWriterTag correspondiente al control de servidor web. Esta propiedad la usan principalmente los programadores de controles.

(Heredado de WebZone)
TagName

Obtiene el nombre de la etiqueta del control. Esta propiedad la usan principalmente los programadores de controles.

(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)
ToolTip

Obtiene o establece el texto que se muestra cuando el puntero del mouse se desplaza 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 valores potencialmente peligrosos.

(Heredado de Control)
VerbButtonType

Obtiene o establece el tipo de botón que se utiliza para representar los verbos de una zona.

(Heredado de WebZone)
VerbStyle

Obtiene los atributos de estilo para los verbos de la interfaz de usuario (UI) asociados a los controles de elementos Web de una zona.

(Heredado de WebZone)
ViewState

Obtiene un diccionario con información de estado que le permite guardar y restaurar el estado de vista de un control de servidor en las distintas solicitudes de la misma página.

(Heredado de Control)
ViewStateIgnoresCase

Obtiene un valor que indica si el objeto StateBag no distingue mayúsculas de minúsculas.

(Heredado de Control)
ViewStateMode

Obtiene o establece el modo del estado de vista de este control.

(Heredado de Control)
Visible

Obtiene o establece un valor que indica si un control de servidor se debe representar como elemento de interfaz de usuario (IU) en la página.

(Heredado de ToolZone)
WebPartManager

Obtiene una referencia al control WebPartManager asociado a una instancia del control WebZone en una página de elementos Web.

(Heredado de WebZone)
WebPartToEdit

Obtiene una referencia al control WebPart que se está editando.

Width

Obtiene o establece el ancho del control de servidor web.

(Heredado de WebControl)

Métodos

AddAttributesToRender(HtmlTextWriter)

Agrega atributos y estilos HTML que se deben representar en el HtmlTextWriterTag especificado. Este método lo usan principalmente los desarrolladores de controles.

(Heredado de WebControl)
AddedControl(Control, Int32)

Se llama después de agregar un control secundario a la colección Controls del objeto Control.

(Heredado de Control)
AddParsedSubObject(Object)

Notifica al control de servidor que se analizó un elemento, ya sea XML o HTML, y agrega el elemento al objeto ControlCollection del control del servidor.

(Heredado de Control)
ApplyStyle(Style)

Copia en el control Web todos los elementos no vacíos del estilo especificado, sobrescribiendo los elementos de estilo existentes del mismo. Este método lo usan principalmente los programadores de controles.

(Heredado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica al control las propiedades de estilo definidas en la hoja de estilos de la página.

(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 pasa a la propiedad Trace para que se muestre cuando está habilitada la traza de la página.

(Heredado de Control)
ClearCachedClientID()

Establece en null el valor de ClientID almacenado en caché.

(Heredado de Control)
ClearChildControlState()

Elimina la información sobre el estado de control de los controles secundarios del control de servidor.

(Heredado de Control)
ClearChildState()

Elimina la información sobre el estado de vista y el estado de control de los controles secundarios del control de servidor.

(Heredado de Control)
ClearChildViewState()

Elimina la información sobre el estado de vista de todos los controles secundarios del control de servidor.

(Heredado de Control)
ClearEffectiveClientIDMode()

Establece la propiedad ClientIDMode de la instancia del control actual y de cualquier control secundario en Inherit.

(Heredado de Control)
Close()

Se llama cuando un usuario hace clic en un verbo de cierre en el encabezado de una zona. Este método finaliza el proceso de edición de controles WebPart y devuelve el modo de presentación de una página de elementos Web al modo de exploración.

CopyBaseAttributes(WebControl)

Copia las propiedades no encapsuladas por el objeto Style del control de servidor web especificado al control de servidor web desde el que se efectúa la llamada al método. Este método lo usan principalmente los desarrolladores de controles.

(Heredado de WebControl)
CreateChildControls()

Crea el conjunto de controles secundarios asociado a una zona EditorZoneBase.

CreateControlCollection()

Crea un nuevo objeto ControlCollection que contendrá los controles secundarios (de literal y servidor) del control de servidor.

(Heredado de Control)
CreateControlStyle()

Crea el objeto de estilo que utiliza la clase WebControl de forma interna para implementar todas las propiedades relacionadas con el estilo. Este método lo usan principalmente los desarrolladores de controles.

(Heredado de WebControl)
CreateEditorPartChrome()

Obtiene una referencia a un nuevo objeto EditorPartChrome que se utiliza para representar los elementos periféricos de la interfaz de usuario de una zona EditorZoneBase circundante.

CreateEditorParts()

Proporciona una declaración de método base que las zonas derivadas puede reemplazar para controlar los detalles de creación de los controles EditorPart que contiene una zona.

DataBind()

Enlaza un origen de datos a CompositeControl y todos sus controles secundarios.

(Heredado de CompositeControl)
DataBind(Boolean)

Enlaza un origen de datos al control de servidor que se ha invocado y a todos sus controles secundarios con una opción para generar el evento DataBinding.

(Heredado de Control)
DataBindChildren()

Enlaza un origen de datos a los controles secundarios del control de servidor.

(Heredado de Control)
Dispose()

Habilita un control de servidor para que realice la limpieza final antes de que se libere 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 tiene controles secundarios, los crea.

(Heredado de Control)
EnsureID()

Crea un identificador para controles que no tiene un identificador asignado.

(Heredado de Control)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
FindControl(String)

Busca un control de servidor con el parámetro id especificado en el contenedor de nomenclatura actual.

(Heredado de Control)
FindControl(String, Int32)

Busca el contenedor de nomenclatura actual para un control de servidor con el id especificado y un entero, que se especifica en el parámetro pathOffset, que ayuda a realizar la búsqueda. Esta versión del método FindControl no se debe reemplazar.

(Heredado de Control)
Focus()

Establece el foco de entrada en un control.

(Heredado de Control)
GetDesignModeState()

Obtiene datos en tiempo de diseño para un control.

(Heredado de Control)
GetEffectiveChromeType(Part)

Devuelve el valor PartChromeType actual real o eficaz de un control WebPart, dada la propiedad PartChromeType de la zona y el modo de presentación actual de la página de elementos web.

(Heredado de WebZone)
GetHashCode()

Sirve 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 correspondiente al prefijo de la propiedad UniqueID 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 se registran eventos para el control o los controles secundarios.

(Heredado de Control)
InvalidateEditorParts()

Establece la colección de controles EditorPart asociada a una zona EditorZoneBase en null, lo que provoca que se llame al método CreateEditorParts() para volver a crear la colección.

IsLiteralContent()

Determina si el control de servidor alberga únicamente contenido literal.

(Heredado de Control)
LoadControlState(Object)

Restaura información de estado de control de una solicitud de página anterior guardada por el método SaveControlState().

(Heredado de Control)
LoadViewState(Object)

Carga la información de estado guardada previamente para una zona.

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 Object actual.

(Heredado de Object)
MergeStyle(Style)

Copia en el control Web todos los elementos no vacíos del estilo especificado, pero no sobrescribe los elementos de estilo existentes en el mismo. Este método lo usan principalmente 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 control de servidor de la interfaz de usuario (UI) de la página.

(Heredado de Control)
OnDataBinding(EventArgs)

Genera el evento DataBinding.

(Heredado de Control)
OnDisplayModeChanged(Object, WebPartDisplayModeEventArgs)

Provoca el evento DisplayModeChanged y destruye todos los objetos EditorPart y los controles secundarios de la zona como preparación para que una página Web entre o salga del modo de presentación de edición.

OnInit(EventArgs)

Crea controladores de eventos especializados utilizados por el control WebPartManager en una página Web.

(Heredado de ToolZone)
OnLoad(EventArgs)

Genera el evento Load.

(Heredado de Control)
OnPreRender(EventArgs)

Provoca el evento PreRender y llama al método PerformPreRender() para los elementos de cromo de los controles EditorPart.

OnSelectedWebPartChanged(Object, WebPartEventArgs)

Provoca el evento SelectedWebPartChanged y establece la colección EditorParts en null en la zona, como preparación para que un control WebPart entre o salga del modo de edición.

OnUnload(EventArgs)

Genera el evento Unload.

(Heredado de Control)
OpenFile(String)

Obtiene un objeto Stream utilizado para leer un archivo.

(Heredado de Control)
RaiseBubbleEvent(Object, EventArgs)

Asigna los orígenes del evento y su información al control principal del control.

(Heredado de Control)
RaisePostBackEvent(String)

Ejecuta las acciones asociadas a uno de los verbos de la zona o provoca un evento que devuelve datos al servidor.

RecreateChildControls()

Vuelve a crear los controles secundarios de un control derivado de CompositeControl.

(Heredado de CompositeControl)
RemovedControl(Control)

Se llama después de quitar un control secundario de la colección Controls del objeto Control.

(Heredado de Control)
Render(HtmlTextWriter)

Representa la zona del objeto HtmlTextWriter especificado.

RenderBeginTag(HtmlTextWriter)

Representa la etiqueta HTML de apertura del control de zona en el objeto HtmlTextWriter especificado.

(Heredado de WebZone)
RenderBody(HtmlTextWriter)

Reemplaza el método base para representar el cuerpo de una zona derivada de la clase EditorZoneBase.

RenderChildren(HtmlTextWriter)

Envía el contenido de los elementos secundarios de un control de servidor a un objeto HtmlTextWriter especificado, que escribe el contenido que se va a representar en el cliente.

(Heredado de Control)
RenderContents(HtmlTextWriter)

Representa todo el contenido de un control de zona que se encuentre entre las etiquetas inicial y final en el objeto HtmlTextWriter especificado.

(Heredado de WebZone)
RenderControl(HtmlTextWriter)

Envía el contenido de control del servidor a un objeto HtmlTextWriter proporcionado y almacena información de seguimiento sobre el control si está habilitado el seguimiento.

(Heredado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Coloca el contenido de un control de servidor en un objeto HtmlTextWriter proporcionado, utilizando un objeto ControlAdapter proporcionado.

(Heredado de Control)
RenderEndTag(HtmlTextWriter)

Presenta la etiqueta HTML de cierre del control en el escritor especificado. Este método lo usan principalmente los desarrolladores de controles.

(Heredado de WebControl)
RenderFooter(HtmlTextWriter)

Reemplaza el método base para representar los verbos del pie de página de un control ToolZone.

(Heredado de ToolZone)
RenderHeader(HtmlTextWriter)

Reemplaza el método base para proporcionar la representación especializada del área de encabezado que requieren los controles ToolZone.

(Heredado de ToolZone)
RenderVerb(HtmlTextWriter, WebPartVerb)

Representa un verbo individual con un control ToolZone.

(Heredado de ToolZone)
RenderVerbs(HtmlTextWriter)

Representa los verbos que se aplican en el nivel de zona.

ResolveAdapter()

Obtiene el adaptador de controles que se encarga de representar el control especificado.

(Heredado de Control)
ResolveClientUrl(String)

Obtiene una dirección URL que el explorador puede utilizar.

(Heredado de Control)
ResolveUrl(String)

Convierte una dirección URL en una que el cliente solicitante pueda utilizar.

(Heredado de Control)
SaveControlState()

Guarda los cambios de estado del control de servidor que se produjeron desde la hora en que la página volvió a publicarse en el servidor.

(Heredado de Control)
SaveViewState()

Guarda los cambios de estado de vista que se produjeron después de volver a publicar una página en el servidor.

SetDesignModeState(IDictionary)

Establece los datos en tiempo de diseño para un control.

(Heredado de Control)
SetRenderMethodDelegate(RenderMethod)

Asigna un delegado de controlador de eventos para representar el control de servidor y su contenido en el control principal.

(Heredado de Control)
SetTraceData(Object, Object)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa la clave y el valor de los datos de seguimiento.

(Heredado de Control)
SetTraceData(Object, Object, Object)

Establece datos de seguimiento para el seguimiento en tiempo de diseño de los datos de representación, para lo que usa el objeto del que se ha realizado seguimiento, así como la clave y el valor de los datos de seguimiento.

(Heredado de Control)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
TrackViewState()

Realiza un seguimiento de los cambios de estado de vista de un control de zona.

Eventos

DataBinding

Se produce cuando el control de servidor se enlaza a un origen de datos.

(Heredado de Control)
Disposed

Se produce cuando un control de servidor se libera de la memoria, lo que constituye la última fase del período de duración de un control de servidor cuando se solicita una página ASP.NET.

(Heredado de Control)
Init

Tiene lugar al inicializar el control de servidor, que es el primer paso en su ciclo de vida.

(Heredado de Control)
Load

Se produce cuando el control de servidor se carga en el objeto Page.

(Heredado de Control)
PreRender

Se produce una vez que se carga el objeto Control, pero antes de su 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

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 con el nombre y el valor especificados.

(Heredado de WebControl)
ICompositeControlDesignerAccessor.RecreateChildControls()

Permite que un diseñador vuelva a crear la colección de controles secundarios del control compuesto en el entorno en tiempo de diseño.

(Heredado de CompositeControl)
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)
IPostBackEventHandler.RaisePostBackEvent(String)

Implementa el método RaisePostBackEvent(String).

(Heredado de ToolZone)

Métodos de extensión

FindDataSourceControl(Control)

Devuelve el origen de datos que está asociado al control de datos del control especificado.

FindFieldTemplate(Control, String)

Devuelve la plantilla de campo para la columna especificada en el contenedor de nomenclatura del control especificado.

FindMetaTable(Control)

Devuelve el objeto de metatabla 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)

Establece los metadatos de la tabla para el control de datos especificado.

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

Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado.

SetMetaTable(INamingContainer, MetaTable, Object)

Establece los metadatos de tabla y la asignación de valores predeterminados para el control de datos especificado.

TryGetMetaTable(INamingContainer, MetaTable)

Determina si están disponibles los metadatos de la tabla.

EnableDynamicData(INamingContainer, Type)

Habilita el comportamiento de datos dinámicos para el control de datos especificado.

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.

Se aplica a

Consulte también