ControlIDConverter Classe

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.dll

Fornece um conversor de tipo que recupera uma lista de IDs de controle no contêiner atual.

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

public class ControlIDConverter : System.ComponentModel.StringConverter

type ControlIDConverter = class
    inherit StringConverter

Public Class ControlIDConverter
Inherits StringConverter

Herança

Object

TypeConverter

StringConverter

ControlIDConverter

Derivado

System.Web.UI.WebControls.AssociatedControlConverter

System.Web.UI.WebControls.ValidatedControlConverter

Exemplos

O exemplo de código a seguir demonstra como usar o ControlIDConverter em uma classe que requer um TypeConverter para renderizar a ID de um controle. O DebugInfoControl é um controle simples que imprime algumas informações sobre um controle contido no Web Form atual. Sua ControlID propriedade é decorada com um TypeConverterAttribute que designa o ControlIDConverter como o TypeConverter a ser usado para essa propriedade. O DebugInfoControl substitui o Render método para imprimir informações sobre o controle de destino em um Label controle .

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

O exemplo de código a seguir demonstra como o DebugInfoControl pode ser usado em um Web Form juntamente com um AccessDataSource controle para exibir informações sobre o AccessDataSource controle.

<%@ 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>

Comentários

A ControlIDConverter classe deriva da StringConverter classe e fornece uma lista de IDs de controle para exibição em um controle de grade de propriedades em ambientes de tempo de design. A ControlIDConverter classe também serve como a classe base para as AssociatedControlConverter classes e ValidatedControlConverter , que são conversores de tipo para controles Da Web e controles que dão suporte a atributos de propriedade de validação, respectivamente.

Para obter mais informações sobre conversores de tipo, consulte Como implementar um conversor de tipo ou conversão de tipo generalizado.

Construtores

ControlIDConverter()

Inicializa uma nova instância da classe ControlIDConverter.

Métodos

CanConvertFrom(ITypeDescriptorContext, Type)	Obtém um valor que indica se esse conversor pode converter um objeto do tipo de origem especificado em uma cadeia de caracteres usando o contexto especificado. (Herdado de StringConverter)
CanConvertFrom(Type)	Retorna se este conversor pode converter um objeto do tipo indicado para o tipo deste conversor. (Herdado de TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Retorna se esse conversor pode converter o objeto para o tipo especificado, usando o contexto especificado. (Herdado de TypeConverter)
CanConvertTo(Type)	Retorna se esse conversor pode converter o objeto para o tipo especificado. (Herdado de TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Converte o objeto de valor especificado em um objeto String. (Herdado de StringConverter)
ConvertFrom(Object)	Converte o valor fornecido noo tipo deste conversor. (Herdado de TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Converte a cadeia de caracteres fornecida para o tipo deste conversor usando a cultura invariável e o contexto especificado. (Herdado de TypeConverter)
ConvertFromInvariantString(String)	Converte a cadeia de caracteres fornecida para o tipo deste conversor usando a cultura invariável. (Herdado de TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Converte o texto fornecido em um objeto, usando o contexto e a informação de cultura especificados. (Herdado de TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Converte o texto fornecido em um objeto, usando o contexto especificado. (Herdado de TypeConverter)
ConvertFromString(String)	Converte o texto especificado em um objeto. (Herdado de TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Converte o objeto de valor determinado para o tipo especificado, usando o contexto especificado e as informações da cultura. (Herdado de TypeConverter)
ConvertTo(Object, Type)	Converte o objeto de valor especificado para o tipo especificado, usando os argumentos. (Herdado de TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Converte o valor especificado em uma representação de cadeia de caracteres que não varia de acordo com a cultura, usando o contexto especificado. (Herdado de TypeConverter)
ConvertToInvariantString(Object)	Converte o valor especificado em uma representação de cadeia de caracteres invariável da cultura. (Herdado de TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Converte o valor especificado em uma representação de cadeia de caracteres, usando as informações de contexto e cultura especificadas. (Herdado de TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Converte o valor especificado em uma representação de cadeia de caracteres, usando o contexto fornecido. (Herdado de TypeConverter)
ConvertToString(Object)	Converte o valor especificado em uma representação de cadeia de caracteres. (Herdado de TypeConverter)
CreateInstance(IDictionary)	Recria um Object dado um conjunto de valores de propriedade do objeto. (Herdado de TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Cria uma instância do tipo ao qual esse TypeConverter está associado, usando o contexto especificado, dado um conjunto de valores de propriedade para o objeto. (Herdado de TypeConverter)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FilterControl(Control)	Retorna um valor que indica se a ID de controle do controle especificado é adicionada à TypeConverter.StandardValuesCollection retornada pelo método GetStandardValues(ITypeDescriptorContext).
GetConvertFromException(Object)	Retorna uma exceção a ser gerada quando uma conversão não puder ser executada. (Herdado de TypeConverter)
GetConvertToException(Object, Type)	Retorna uma exceção a ser gerada quando uma conversão não puder ser executada. (Herdado de TypeConverter)
GetCreateInstanceSupported()	Retorna se a alteração de um valor neste objeto requer uma chamada ao método CreateInstance(IDictionary) para criar um novo valor. (Herdado de TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Retorna se a alteração de um valor neste objeto requer uma chamada para CreateInstance(IDictionary) para criar um novo valor, usando o contexto especificado. (Herdado de TypeConverter)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetProperties(ITypeDescriptorContext, Object)	Retorna uma coleção de propriedades para o tipo de matriz especificado pelo parâmetro de valor, usando o contexto especificado. (Herdado de TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Retorna uma coleção de propriedades para o tipo de matriz especificado pelo parâmetro de valor, usando o contexto e os atributos especificados. (Herdado de TypeConverter)
GetProperties(Object)	Retorna uma coleção de propriedades para o tipo de matriz especificado pelo parâmetro de valor. (Herdado de TypeConverter)
GetPropertiesSupported()	Retorna se este objeto dá suporte a propriedades. (Herdado de TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Retorna se este objeto é compatível com as propriedades, usando o contexto especificado. (Herdado de TypeConverter)
GetStandardValues()	Retorna uma coleção de valores padrão do contexto padrão para o tipo de dados para o qual esse conversor de tipo foi criado. (Herdado de TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Retorna uma coleção de IDs de controle do contêiner no IDesignerHost quando fornecido com um contexto de formato.
GetStandardValuesExclusive()	Retorna se a coleção de valores padrão retornada de GetStandardValues() é uma lista exclusiva. (Herdado de TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Retorna um valor que indica se a coleção de valores padrão retornada pelo método GetStandardValues(ITypeDescriptorContext) é uma lista exclusiva de valores possíveis, usando o contexto especificado.
GetStandardValuesSupported()	Retorna se este objeto dá suporte a um conjunto padrão de valores que podem ser escolhidos em uma lista. (Herdado de TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Retorna um valor que indica se esse objeto dá suporte a um conjunto padrão de valores de ID de controle que podem ser escolhidos em uma lista, usando o contexto especificado.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsValid(ITypeDescriptorContext, Object)	Retorna se o objeto de valor fornecido é válido para esse tipo e para o contexto especificado. (Herdado de TypeConverter)
IsValid(Object)	Retorna se o objeto de valor especificado é válido para esse tipo. (Herdado de TypeConverter)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
SortProperties(PropertyDescriptorCollection, String[])	Classifica uma coleção de propriedades. (Herdado de TypeConverter)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• TypeConverter
• AssociatedControlConverter
• ValidatedControlConverter
• Como implementar um conversor de tipos
• Conversão de tipos generalizada