Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
ControlIDConverter, classe
.NET Framework 4
Fournit un convertisseur de type qui récupère une liste d'ID de contrôle dans le conteneur actuel.
System.Object
System.ComponentModel.TypeConverter
System.ComponentModel.StringConverter
System.Web.UI.WebControls.ControlIDConverter
System.Web.UI.WebControls.AssociatedControlConverter
System.Web.UI.WebControls.ValidatedControlConverter
System.ComponentModel.TypeConverter
System.ComponentModel.StringConverter
System.Web.UI.WebControls.ControlIDConverter
System.Web.UI.WebControls.AssociatedControlConverter
System.Web.UI.WebControls.ValidatedControlConverter
Assembly : System.Web (dans System.Web.dll)
Le type ControlIDConverter expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
ControlIDConverter | Initialise une nouvelle instance de la classe ControlIDConverter. |
| Nom | Description | |
|---|---|---|
|
|
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.) |
|
|
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.) |
|
|
CanConvertTo(Type) | Retourne une valeur indiquant si ce convertisseur peut convertir l'objet en objet du type spécifié. (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 déterminé. (Hérité de TypeConverter.) |
|
|
ConvertFrom(Object) | Convertit la valeur donnée en valeur du type de ce convertisseur. (Hérité de TypeConverter.) |
|
|
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object) | Convertit l'objet de valeur spécifiée en objet String. (Hérité de StringConverter.) |
|
|
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.) |
|
|
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.) |
|
|
ConvertFromString(String) | Convertit le texte spécifié en objet. (Hérité de TypeConverter.) |
|
|
ConvertFromString(ITypeDescriptorContext, String) | Convertit le texte donné en objet, à l'aide du contexte spécifié. (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.) |
|
|
ConvertTo(Object, Type) | Convertit l'objet de valeur donné en objet du type spécifié, à l'aide des arguments. (Hérité de TypeConverter.) |
|
|
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) | Convertit l'objet de valeur donné en objet du type spécifié, à l'aide du contexte et des informations de culture spécifiés. (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.) |
|
|
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.) |
|
|
ConvertToString(Object) | Convertit la valeur spécifiée en représentation sous forme de chaîne. (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(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.) |
|
|
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é de l'objet. (Hérité de TypeConverter.) |
|
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
FilterControl | 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. |
|
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
|
GetConvertFromException | Retourne une exception à lever lorsqu'une conversion ne peut pas être effectuée. (Hérité de TypeConverter.) |
|
|
GetConvertToException | Retourne une exception à lever lorsqu'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 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 l'appel à CreateInstance pour la création d'une nouvelle valeur, à l'aide du contexte spécifié. (Hérité de TypeConverter.) |
|
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
|
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.) |
|
|
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 déterminés. (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 indiquant 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. (Substitue TypeConverter.GetStandardValues(ITypeDescriptorContext).) |
|
|
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 est une liste exclusive des valeurs possibles, en utilisant le contexte spécifié. (Substitue TypeConverter.GetStandardValuesExclusive(ITypeDescriptorContext).) |
|
|
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é. (Substitue TypeConverter.GetStandardValuesSupported(ITypeDescriptorContext).) |
|
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
|
IsValid(Object) | Retourne une valeur indiquant si l'objet de valeur donné est valide pour ce type. (Hérité de TypeConverter.) |
|
|
IsValid(ITypeDescriptorContext, Object) | Retourne une valeur indiquant si l'objet de valeur donné est valide pour ce type et pour le contexte spécifié. (Hérité de TypeConverter.) |
|
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
|
SortProperties | 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.) |
La classe ControlIDConverter dérive de la classe StringConverter et fournit une liste d'ID de contrôle pour l'affichage dans un contrôle de grille de propriétés dans les environnements au moment du design. La classe ControlIDConverter sert également de classe de base pour les classes AssociatedControlConverter 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 d'assistance, respectivement.
Pour plus d'informations sur les convertisseurs de type, consultez Comment : implémenter un convertisseur de type ou Conversion de type généralisée.
L'exemple de code suivant montre comment utiliser le ControlIDConverter dans une classe qui requiert qu'un TypeConverter rende l'ID d'un contrôle. Le DebugInfoControl est un contrôle simple qui imprime certaines informations d'un contrôle que contiennent les Web Forms actuels. Sa propriété ControlID est décorée avec un TypeConverterAttribute qui désigne le ControlIDConverter en tant que TypeConverter à utiliser pour cette propriété. Le DebugInfoControlsubstitue la méthode Render pour imprimer des informations relatives au contrôle cible d'un contrôle Label.
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>"); } } } }
L'exemple de code suivant montre comment le DebugInfoControl peut être utilisé dans un Web Form avec un contrôle AccessDataSource pour afficher les informations relatives au contrôle AccessDataSource.
<%@ 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>
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
