ControlIDConverter Clase

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.dll

Proporciona un convertidor de tipos que recupera una lista de los id. de control almacenados en el contenedor actual.

public ref class ControlIDConverter : System::ComponentModel::StringConverter

public class ControlIDConverter : System.ComponentModel.StringConverter

type ControlIDConverter = class
    inherit StringConverter

Public Class ControlIDConverter
Inherits StringConverter

Herencia

Object

TypeConverter

StringConverter

ControlIDConverter

Derivado

System.Web.UI.WebControls.AssociatedControlConverter

System.Web.UI.WebControls.ValidatedControlConverter

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar en ControlIDConverter una clase que requiere que TypeConverter represente el identificador de un control. DebugInfoControl es un control simple que imprime información sobre un control contenido en el formulario web actual. Su ControlID propiedad está decorada con un TypeConverterAttribute objeto que designa como ControlIDConverter el TypeConverter que se va a usar para esa propiedad. DebugInfoControl Invalida el Render método para imprimir información sobre el control de destino en un Label control .

namespace Samples.AspNet.CS {

  using System;
  using System.ComponentModel;
  using System.Web.UI;
  using System.Web.UI.WebControls;

  [DefaultProperty("ControlID")]
  public class DebugInfoControl : Control {

    public DebugInfoControl() {
    }

    public DebugInfoControl(string controlID) {
      ControlID = controlID;
    }

    [DefaultValue(""),
    TypeConverter(typeof(ControlIDConverter))]
    public string ControlID {
      get {
        object o = ViewState["ControlID"];
        if (o == null)
          return String.Empty;
        return (string)o;
      }
      set {
        if (ControlID != value) {
          ViewState["ControlID"] = value;
        }
      }
    }

    protected override void Render(HtmlTextWriter writer) {

      Label info = new Label();

      if (this.ControlID.Length == 0) {
        writer.Write("<Font Color='Red'>No ControlID set.</Font>");
      }

      Control ctrl = this.FindControl(ControlID);

      if (ctrl == null) {
        writer.Write("<Font Color='Red'>Could not find control " +  ControlID + " in Naming Container.</Font>");
      }
      else {
        writer.Write("<Font Color='Green'>Control " + ControlID + " found.<BR>");
        writer.Write("Its Naming Container is: " + ctrl.NamingContainer.ID + "<BR>");
        if (ctrl.EnableViewState)
          writer.Write("It uses view state to persist its state.<BR>");

        if (ctrl.EnableTheming)
          writer.Write("It can be assigned a Theme ID.<BR>");

        if (ctrl.Visible)
          writer.Write("It is visible on the page.<BR>");
        else
          writer.Write("It is not visible on the page.<BR>");

        writer.Write("</Font>");
      }
    }
  }
}

Imports System.ComponentModel
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB

  <DefaultProperty("ControlID")>  _
  Public Class DebugInfoControl
     Inherits Control


     Public Sub New()
     End Sub


     Public Sub New(controlID As String)
        ControlID = controlID
     End Sub


     <DefaultValue(""), TypeConverter(GetType(ControlIDConverter))>  _
     Public Property ControlID() As String
        Get
           Dim o As Object = ViewState("ControlID")
           If o Is Nothing Then
              Return String.Empty
           End If
           Return CStr(o)
        End Get
        Set
           If ControlID <> value Then
              ViewState("ControlID") = value
           End If
        End Set
     End Property


     Protected Overrides Sub Render(writer As HtmlTextWriter)

        Dim info As New Label()

        If Me.ControlID.Length = 0 Then
           writer.Write("<Font Color='Red'>No ControlID set.</Font>")
        End If

        Dim ctrl As Control = Me.FindControl(ControlID)


        If ctrl Is Nothing Then
           writer.Write(("<Font Color='Red'>Could not find control " + ControlID + " in Naming Container.</Font>"))
        Else
           writer.Write(("<Font Color='Green'>Control " + ControlID + " found.<BR>"))
           writer.Write(("Its Naming Container is: " + ctrl.NamingContainer.ID + "<BR>"))
           If ctrl.EnableViewState Then
              writer.Write("It uses view state to persist its state.<BR>")
           End If
           If ctrl.EnableTheming Then
              writer.Write("It can be assigned a Theme ID.<BR>")
           End If
           If ctrl.Visible Then
              writer.Write("It is visible on the page.<BR>")
           Else
              writer.Write("It is not visible on the page.<BR>")
           End If
           writer.Write("</Font>")
        End If
     End Sub
  End Class
End Namespace

En el ejemplo de código siguiente se muestra cómo DebugInfoControl se puede usar en un formulario web junto con un AccessDataSource control para mostrar información sobre el AccessDataSource control.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" assembly="Samples.AspNet.CS" %>
<%@Page  Language="C#" %>
<!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>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataReader"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID FROM Orders WHERE EmployeeID=2">
      </asp:accessdatasource>

      <br />
      <aspSample:debuginfocontrol
          id="DebugInfoControl1"
          runat="server"
          controlid="AccessDataSource1" />

    </form>
  </body>
</html>

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" assembly="Samples.AspNet.VB" %>
<%@ Page  Language="VB" %>
<!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>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataReader"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID FROM Orders WHERE EmployeeID=2">
      </asp:accessdatasource>

      <br />
      <aspSample:debuginfocontrol
          id="DebugInfoControl1"
          runat="server"
          controlid="AccessDataSource1" />

    </form>
  </body>
</html>

Comentarios

La ControlIDConverter clase deriva de la StringConverter clase y proporciona una lista de identificadores de control para su visualización en un control de cuadrícula de propiedades en entornos en tiempo de diseño. La ControlIDConverter clase también actúa como clase base para las AssociatedControlConverter clases y ValidatedControlConverter , que son convertidores de tipos para controles web y controles que admiten atributos de propiedad de validación, respectivamente.

Para obtener más información sobre los convertidores de tipos, vea How to: Implement a Type Converter o Generalized Type Conversion.

Constructores

ControlIDConverter()

Inicializa una nueva instancia de la clase ControlIDConverter.

Métodos

CanConvertFrom(ITypeDescriptorContext, Type)	Obtiene un valor que indica si este convertidor puede convertir un objeto del tipo de origen especificado en una estructura mediante el contexto especificado. (Heredado de StringConverter)
CanConvertFrom(Type)	Devuelve si este convertidor puede convertir un objeto del tipo dado al tipo de este convertidor. (Heredado de TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Devuelve si este convertidor puede convertir el objeto al tipo especificado, con el contexto especificado. (Heredado de TypeConverter)
CanConvertTo(Type)	Devuelve si este convertidor puede convertir el objeto al tipo especificado. (Heredado de TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Convierte el objeto de valor especificado en un objeto String. (Heredado de StringConverter)
ConvertFrom(Object)	Convierte el valor especificado en el tipo de este convertidor. (Heredado de TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Convierte la cadena dada en el tipo de este convertidor, utilizando el contexto especificado y la referencia cultural invariable. (Heredado de TypeConverter)
ConvertFromInvariantString(String)	Convierte la cadena dada al tipo de este convertidor, utilizando la referencia cultural invariable. (Heredado de TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Convierte el texto dado a un objeto, utilizando el contexto especificado y la información de referencia cultural. (Heredado de TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Convierte el texto dado a un objeto, utilizando el contexto especificado. (Heredado de TypeConverter)
ConvertFromString(String)	Convierte el texto especificado a un objeto. (Heredado de TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Convierte el objeto de valor dado al tipo especificado, utilizando el contexto y la información de referencia cultural especificados. (Heredado de TypeConverter)
ConvertTo(Object, Type)	Convierte el objeto de valor dado al tipo especificado, utilizando los argumentos. (Heredado de TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Convierte el valor especificado a una representación de cadena invariable de la referencia cultural, utilizando el contexto especificado. (Heredado de TypeConverter)
ConvertToInvariantString(Object)	Convierte el valor especificado a una representación de cadena invariable de la referencia cultural. (Heredado de TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Convierte el valor dado a una representación de cadena, utilizando el contexto especificado y la información de referencia cultural. (Heredado de TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Convierte el valor dado a una representación de cadena, utilizando el contexto especificado. (Heredado de TypeConverter)
ConvertToString(Object)	Convierte el valor especificado a una representación de cadena. (Heredado de TypeConverter)
CreateInstance(IDictionary)	Vuelve a crear un Object dado un conjunto de valores de propiedad del objeto. (Heredado de TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Crea una instancia del tipo al que está asociado este TypeConverter, mediante el contexto especificado, según un conjunto de valores de propiedad para el objeto. (Heredado de TypeConverter)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
FilterControl(Control)	Devuelve un valor que indica si el id. de control especificado se agrega a la colección TypeConverter.StandardValuesCollection devuelta por el método GetStandardValues(ITypeDescriptorContext).
GetConvertFromException(Object)	Devuelve una excepción que se debe iniciar cuando no se puede realizar una conversión. (Heredado de TypeConverter)
GetConvertToException(Object, Type)	Devuelve una excepción que se debe iniciar cuando no se puede realizar una conversión. (Heredado de TypeConverter)
GetCreateInstanceSupported()	Devuelve un valor que indica si, al cambiar un valor en este objeto, es necesario llamar al método CreateInstance(IDictionary) para crear un nuevo valor. (Heredado de TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Devuelve si el cambio de un valor en este objeto requiere una llamada a CreateInstance(IDictionary) para crear un nuevo valor, mediante el contexto especificado. (Heredado de TypeConverter)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetProperties(ITypeDescriptorContext, Object)	Devuelve una colección de propiedades para el tipo de matriz especificado por valor del parámetro, utilizando el contexto especificado. (Heredado de TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Devuelve una colección de propiedades para el tipo de matriz especificado por el parámetro de valor, usando el contexto y los atributos especificados. (Heredado de TypeConverter)
GetProperties(Object)	Devuelve una colección de propiedades para el tipo de matriz especificado por el valor del parámetro. (Heredado de TypeConverter)
GetPropertiesSupported()	Devuelve si este objeto admite propiedades. (Heredado de TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Devuelve si este objeto admite propiedades, mediante el contexto especificado. (Heredado de TypeConverter)
GetStandardValues()	Devuelve una colección de valores estándar del contexto predeterminado para el tipo de datos para el que está diseñado este convertidor de tipos. (Heredado de TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Devuelve una colección de id. de control del contenedor de IDesignerHost cuando se suministra un contexto de formato.
GetStandardValuesExclusive()	Devuelve si la colección de valores estándar devueltos por GetStandardValues() es una lista exclusiva. (Heredado de TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Devuelve un valor que indica si la colección de valores estándar devueltos por el método GetStandardValues(ITypeDescriptorContext) es una lista exclusiva de posibles valores, utilizando el contexto especificado.
GetStandardValuesSupported()	Devuelve si este objeto admite un conjunto estándar de valores que se pueden seleccionar de una lista. (Heredado de TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Devuelve un valor que indica si el objeto admite un conjunto estándar de valores de id. de control que se pueden seleccionar de una lista, utilizando el contexto especificado.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsValid(ITypeDescriptorContext, Object)	Indica si el objeto de valor especificado es válido para este tipo y para el contexto especificado. (Heredado de TypeConverter)
IsValid(Object)	Devuelve si el valor de objeto dado es válido para este tipo. (Heredado de TypeConverter)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
SortProperties(PropertyDescriptorCollection, String[])	Ordena una colección de propiedades. (Heredado de TypeConverter)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• TypeConverter
• AssociatedControlConverter
• ValidatedControlConverter
• Cómo: Implementar un convertidor de tipos
• Conversión de tipos generalizada