ControlIDConverter Classe

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit un convertisseur de type qui récupère une liste d'ID de contrôle dans le conteneur actuel.

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

public class ControlIDConverter : System.ComponentModel.StringConverter

type ControlIDConverter = class
    inherit StringConverter

Public Class ControlIDConverter
Inherits StringConverter

Héritage: Object

TypeConverter

StringConverter
ControlIDConverter

Dérivé: System.Web.UI.WebControls.AssociatedControlConverter

System.Web.UI.WebControls.ValidatedControlConverter

Exemples

L’exemple de code suivant montre comment utiliser dans ControlIDConverter une classe qui nécessite un TypeConverter pour restituer l’ID d’un contrôle. Il s’agit DebugInfoControl d’un contrôle simple qui imprime certaines informations sur un contrôle contenu dans le formulaire web actuel. Sa ControlID propriété est décorée avec un TypeConverterAttribute qui désigne le ControlIDConverter comme à TypeConverter utiliser pour cette propriété. remplace DebugInfoControl la Render méthode pour imprimer des informations sur le contrôle cible dans un Label contrôle.

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

L’exemple de code suivant montre comment le DebugInfoControl peut être utilisé dans un formulaire web avec un AccessDataSource contrôle pour afficher des informations sur le AccessDataSource contrôle.

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

Remarques

La ControlIDConverter classe dérive de la StringConverter classe et fournit une liste d’ID de contrôle à afficher dans un contrôle de grille de propriétés dans les environnements au moment du design. La ControlIDConverter classe sert également de classe de base pour les AssociatedControlConverter classes et ValidatedControlConverter , qui sont des convertisseurs de type pour les contrôles Web et les contrôles qui prennent en charge les attributs de propriété de validation, respectivement.

Pour plus d’informations sur les convertisseurs de types, consultez Guide pratique pour implémenter un convertisseur de type ou une conversion de type généralisée.

Constructeurs

ControlIDConverter()

Initialise une nouvelle instance de la classe ControlIDConverter.

Méthodes

CanConvertFrom(ITypeDescriptorContext, Type)	Obtient une valeur indiquant si ce convertisseur peut convertir un objet du type source donné en chaîne utilisant le contexte spécifié. (Hérité de StringConverter)
CanConvertFrom(Type)	Retourne une valeur indiquant si ce convertisseur peut convertir un objet du type donné en objet du type de ce convertisseur. (Hérité de TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Retourne une valeur indiquant si ce convertisseur peut convertir l’objet en objet du type spécifié, à l’aide du contexte spécifié. (Hérité de TypeConverter)
CanConvertTo(Type)	Retourne une valeur indiquant si ce convertisseur peut convertir l'objet en objet du type spécifié. (Hérité de TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Convertit l'objet de valeur spécifiée en objet String. (Hérité de StringConverter)
ConvertFrom(Object)	Convertit la valeur donnée en valeur du type de ce convertisseur. (Hérité de TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Convertit la chaîne donnée au type de ce convertisseur, à l'aide des informations de culture indifférente et du contexte spécifiés. (Hérité de TypeConverter)
ConvertFromInvariantString(String)	Convertit la chaîne donnée en représentation sous forme de chaîne du type de ce convertisseur, à l'aide de la culture dite indifférente. (Hérité de TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Convertit le texte donné en objet, à l'aide du contexte et des informations de culture spécifiés. (Hérité de TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Convertit le texte donné en objet, à l'aide du contexte spécifié. (Hérité de TypeConverter)
ConvertFromString(String)	Convertit le texte spécifié en objet. (Hérité de TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Convertit l'objet valeur donné au type spécifié, en utilisant le contexte et les informations de culture spécifiés. (Hérité de TypeConverter)
ConvertTo(Object, Type)	Convertit l'objet de valeur donné en objet du type spécifié, à l'aide des arguments. (Hérité de TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Convertit la valeur spécifiée en représentation sous forme de chaîne de culture dite indifférente, à l'aide du contexte déterminé. (Hérité de TypeConverter)
ConvertToInvariantString(Object)	Convertit la valeur spécifiée en représentation sous forme de chaîne de culture dite indifférente. (Hérité de TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Convertit la valeur donnée en représentation sous forme de chaîne, à l'aide du contexte et des informations de culture spécifiés. (Hérité de TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Convertit la valeur donnée en représentation sous forme de chaîne, à l'aide du contexte déterminé. (Hérité de TypeConverter)
ConvertToString(Object)	Convertit la valeur spécifiée en représentation sous forme de chaîne. (Hérité de TypeConverter)
CreateInstance(IDictionary)	Recrée un Object en fonction d'un jeu de valeurs de propriétés de l'objet. (Hérité de TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Crée une instance du type auquel ce TypeConverter est associé, en utilisant le contexte spécifié, en fonction d’un ensemble de valeurs de propriétés de l’objet. (Hérité de TypeConverter)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
FilterControl(Control)	Retourne une valeur indiquant si l'ID de contrôle du contrôle spécifié est ajouté au TypeConverter.StandardValuesCollection qui est retourné par la méthode GetStandardValues(ITypeDescriptorContext).
GetConvertFromException(Object)	Retourne une exception à lever quand une conversion ne peut pas être effectuée. (Hérité de TypeConverter)
GetConvertToException(Object, Type)	Retourne une exception à lever quand une conversion ne peut pas être effectuée. (Hérité de TypeConverter)
GetCreateInstanceSupported()	Retourne une valeur indiquant si la modification d'une valeur de cet objet nécessite un appel à la méthode CreateInstance(IDictionary) pour créer une nouvelle valeur. (Hérité de TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Retourne une valeur indiquant si la modification d’une valeur de cet objet nécessite un appel à CreateInstance(IDictionary) pour créer une valeur, en utilisant le contexte spécifié. (Hérité de TypeConverter)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetProperties(ITypeDescriptorContext, Object)	Retourne une collection de propriétés pour le type de tableau spécifié par le paramètre de valeur, à l'aide du contexte déterminé. (Hérité de TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Retourne une collection de propriétés pour le type de tableau spécifié par le paramètre de valeur, à l’aide du contexte et des attributs spécifiés. (Hérité de TypeConverter)
GetProperties(Object)	Retourne une collection de propriétés pour le type de tableau spécifié par le paramètre de valeur. (Hérité de TypeConverter)
GetPropertiesSupported()	Retourne une valeur indiquant si l'objet prend en charge les propriétés. (Hérité de TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Retourne une valeur qui indique si cet objet prend en charge les propriétés en utilisant le contexte spécifié. (Hérité de TypeConverter)
GetStandardValues()	Retourne une collection de valeurs standard à partir du contexte par défaut du type de données pour lequel ce convertisseur de type est conçu. (Hérité de TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Retourne une collection d'ID de contrôle du conteneur dans IDesignerHost lorsqu'elle est fournie avec un contexte de format.
GetStandardValuesExclusive()	Retourne une valeur indiquant si la collection de valeurs standard retournée par GetStandardValues() est une liste exclusive. (Hérité de TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Retourne une valeur indiquant si la collection de valeurs standard retournée par la méthode GetStandardValues(ITypeDescriptorContext) est une liste exclusive des valeurs possibles, en utilisant le contexte spécifié.
GetStandardValuesSupported()	Retourne une valeur indiquant si cet objet prend en charge un jeu standard de valeurs qui peuvent être sélectionnées dans une liste. (Hérité de TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Retourne une valeur indiquant si cet objet prend en charge une série de valeurs d'ID de contrôles standard qui peuvent être sélectionnées dans une liste, à l'aide du contexte spécifié.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
IsValid(ITypeDescriptorContext, Object)	Indique par retour si l’objet de valeur donné est valide pour ce type et pour le contexte spécifié. (Hérité de TypeConverter)
IsValid(Object)	Retourne une valeur indiquant si l'objet de valeur donné est valide pour ce type. (Hérité de TypeConverter)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
SortProperties(PropertyDescriptorCollection, String[])	Trie une collection de propriétés. (Hérité de TypeConverter)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

S’applique à

Partager via