ControlIDConverter Classe

Definizione

Fornisce un convertitore di tipi che recupera un elenco di ID dei controlli nel contenitore corrente.Provides a type converter that retrieves a list of control IDs in the current container.

public ref class ControlIDConverter : System::ComponentModel::StringConverter
public class ControlIDConverter : System.ComponentModel.StringConverter
type ControlIDConverter = class
    inherit StringConverter
Public Class ControlIDConverter
Inherits StringConverter
Ereditarietà
ControlIDConverter
Derivato

Esempi

Nell'esempio di codice riportato di seguito viene illustrato ControlIDConverter come utilizzare in una classe che TypeConverter richiede un oggetto per eseguire il rendering dell'ID di un controllo.The following code example demonstrates how to use the ControlIDConverter in a class that requires a TypeConverter to render the ID of a control. DebugInfoControl È un controllo semplice che stampa alcune informazioni su un controllo contenuto nel Web Form corrente.The DebugInfoControl is a simple control that prints out some information on a control contained by the current Web Form. La ControlID proprietà è decorata con TypeConverterAttribute un oggetto che TypeConverter designa ControlIDConverter come da usare per la proprietà.Its ControlID property is decorated with a TypeConverterAttribute that designates the ControlIDConverter as the TypeConverter to use for that property. Esegue l'override Render del metodo per stampare le informazioni sul controllo di destinazione in Label un controllo. DebugInfoControlThe DebugInfoControl overrides the Render method to print out information about the target control in a 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

Nell'esempio di codice riportato di seguito DebugInfoControl viene illustrato come è possibile utilizzare in un Web Form AccessDataSource insieme a un controllo AccessDataSource per visualizzare informazioni sul controllo.The following code example demonstrates how the DebugInfoControl can be used in a Web Form along with an AccessDataSource control to display information about the 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>

Commenti

La ControlIDConverter classe deriva StringConverter dalla classe e fornisce un elenco di ID di controllo da visualizzare in un controllo griglia delle proprietà negli ambienti della fase di progettazione.The ControlIDConverter class derives from the StringConverter class and provides a list of control IDs for display in a property grid control in design-time environments. La ControlIDConverter classe funge anche da classe base per le AssociatedControlConverter classi e ValidatedControlConverter , che sono convertitori di tipi per controlli Web e controlli che supportano rispettivamente gli attributi delle proprietà di convalida.The ControlIDConverter class also serves as the base class for the AssociatedControlConverter and ValidatedControlConverter classes, which are type converters for Web controls and controls that support validation property attributes, respectively.

Per ulteriori informazioni sui convertitori di tipi, vedere Procedura: Implementare un convertitore di tipi o una conversione di tipi generalizzata.For more information about type converters, see How to: Implement a Type Converter or Generalized Type Conversion.

Costruttori

ControlIDConverter()

Inizializza una nuova istanza della classe ControlIDConverter.Initializes a new instance of the ControlIDConverter class.

Metodi

CanConvertFrom(ITypeDescriptorContext, Type)

Ottiene un valore che indica se il convertitore è in grado di convertire un oggetto dal tipo di origine specificato in una stringa tramite il contesto specificato.Gets a value indicating whether this converter can convert an object in the given source type to a string using the specified context.

(Ereditato da StringConverter)
CanConvertFrom(Type)

Indica se questo convertitore può convertire un oggetto del tipo specificato nel tipo di questo convertitore.Returns whether this converter can convert an object of the given type to the type of this converter.

(Ereditato da TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)

Restituisce un valore che indica se il convertitore può convertire l'oggetto nel tipo specificato usando il contesto specificato.Returns whether this converter can convert the object to the specified type, using the specified context.

(Ereditato da TypeConverter)
CanConvertTo(Type)

Indica se questo convertitore può convertire l'oggetto nel tipo specificato.Returns whether this converter can convert the object to the specified type.

(Ereditato da TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)

Converte l'oggetto valore specificato in un oggetto String.Converts the specified value object to a String object.

(Ereditato da StringConverter)
ConvertFrom(Object)

Converte il valore specificato nel tipo di questo convertitore.Converts the given value to the type of this converter.

(Ereditato da TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)

Converte la stringa specificata nel tipo di questo convertitore, utilizzando le impostazioni cultura inglesi e il contesto specificato.Converts the given string to the type of this converter, using the invariant culture and the specified context.

(Ereditato da TypeConverter)
ConvertFromInvariantString(String)

Converte la stringa specificata nel tipo di questo convertitore, utilizzando le impostazioni cultura invarianti.Converts the given string to the type of this converter, using the invariant culture.

(Ereditato da TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)

Converte il testo specificato in un oggetto, utilizzando il contesto specificato e le informazioni sulle impostazioni cultura.Converts the given text to an object, using the specified context and culture information.

(Ereditato da TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)

Converte il testo specificato in un oggetto, utilizzando il contesto specificato.Converts the given text to an object, using the specified context.

(Ereditato da TypeConverter)
ConvertFromString(String)

Converte il testo specificato in un oggetto.Converts the specified text to an object.

(Ereditato da TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Converte l'oggetto valore indicato nel tipo specificato, usando il contesto e le informazioni sulle impostazioni cultura specificati.Converts the given value object to the specified type, using the specified context and culture information.

(Ereditato da TypeConverter)
ConvertTo(Object, Type)

Converte l'oggetto valore specificato nel tipo specificato, utilizzando gli argomenti.Converts the given value object to the specified type, using the arguments.

(Ereditato da TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)

Converte il valore specificato in una rappresentazione in formato stringa indipendente dalle impostazioni cultura, utilizzando il contesto specificato.Converts the specified value to a culture-invariant string representation, using the specified context.

(Ereditato da TypeConverter)
ConvertToInvariantString(Object)

Converte il valore specificato in una rappresentazione in formato stringa indipendente dalle impostazioni cultura.Converts the specified value to a culture-invariant string representation.

(Ereditato da TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)

Converte il valore specificato in una rappresentazione in formato stringa, utilizzando il contesto specificato e le informazioni sulle impostazioni cultura.Converts the given value to a string representation, using the specified context and culture information.

(Ereditato da TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)

Converte il valore specificato in una rappresentazione in formato stringa, utilizzando il contesto specificato.Converts the given value to a string representation, using the given context.

(Ereditato da TypeConverter)
ConvertToString(Object)

Converte il valore specificato in una rappresentazione in formato stringa.Converts the specified value to a string representation.

(Ereditato da TypeConverter)
CreateInstance(IDictionary)

Ricrea un oggetto Object in base a un set di valori di proprietà dell'oggetto.Re-creates an Object given a set of property values for the object.

(Ereditato da TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)

Crea un'istanza del tipo a cui questo oggetto TypeConverter è associato, usando il contesto specificato, dato un set di valori di proprietà per l'oggetto.Creates an instance of the type that this TypeConverter is associated with, using the specified context, given a set of property values for the object.

(Ereditato da TypeConverter)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
FilterControl(Control)

Restituisce un valore che indica se l'ID del controllo specificato viene aggiunto nell'insieme TypeConverter.StandardValuesCollection restituito dal metodo GetStandardValues(ITypeDescriptorContext).Returns a value indicating whether the control ID of the specified control is added to the TypeConverter.StandardValuesCollection that is returned by the GetStandardValues(ITypeDescriptorContext) method.

GetConvertFromException(Object)

Restituisce un'eccezione da generare quando non è possibile eseguire una conversione.Returns an exception to throw when a conversion cannot be performed.

(Ereditato da TypeConverter)
GetConvertToException(Object, Type)

Restituisce un'eccezione da generare quando non è possibile eseguire una conversione.Returns an exception to throw when a conversion cannot be performed.

(Ereditato da TypeConverter)
GetCreateInstanceSupported()

Restituisce se la modifica di un valore su questo oggetto richiede una chiamata al metodo CreateInstance(IDictionary) per creare un nuovo valore.Returns whether changing a value on this object requires a call to the CreateInstance(IDictionary) method to create a new value.

(Ereditato da TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)

Indica se la modifica di un valore di questo oggetto richiede la chiamata del metodo CreateInstance(IDictionary) per creare un nuovo valore utilizzando il contesto specificato.Returns whether changing a value on this object requires a call to CreateInstance(IDictionary) to create a new value, using the specified context.

(Ereditato da TypeConverter)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetProperties(ITypeDescriptorContext, Object)

Restituisce un insieme di proprietà per il tipo di matrice specificato dal parametro del valore utilizzando il contesto specificato.Returns a collection of properties for the type of array specified by the value parameter, using the specified context.

(Ereditato da TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])

Restituisce un insieme di proprietà per il tipo di matrice specificato dal parametro del valore utilizzando il contesto e gli attributi specificati.Returns a collection of properties for the type of array specified by the value parameter, using the specified context and attributes.

(Ereditato da TypeConverter)
GetProperties(Object)

Restituisce un insieme di proprietà per il tipo di matrice specificato dal parametro del valore.Returns a collection of properties for the type of array specified by the value parameter.

(Ereditato da TypeConverter)
GetPropertiesSupported()

Indica se questo oggetto supporta le proprietà.Returns whether this object supports properties.

(Ereditato da TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)

Indica se questo oggetto supporta le proprietà, utilizzando il contesto specificato.Returns whether this object supports properties, using the specified context.

(Ereditato da TypeConverter)
GetStandardValues()

Restituisce un insieme di valori standard dal contesto predefinito del tipo di dati per il quale è stato progettato questo convertitore di tipi.Returns a collection of standard values from the default context for the data type this type converter is designed for.

(Ereditato da TypeConverter)
GetStandardValues(ITypeDescriptorContext)

Restituisce un insieme di ID dei controlli dal contenitore all'interno dell'oggetto IDesignerHost quando viene fornito con un contesto di formato.Returns a collection of control IDs from the container within the IDesignerHost when provided with a format context.

GetStandardValuesExclusive()

Indica se l'insieme di valori standard restituiti dal metodo GetStandardValues() rappresenta un elenco esclusivo.Returns whether the collection of standard values returned from GetStandardValues() is an exclusive list.

(Ereditato da TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)

Restituisce un valore che indica se l'insieme di valori standard restituito dal metodo GetStandardValues(ITypeDescriptorContext) è un elenco esclusivo di valori possibili, utilizzando il contesto specificato.Returns a value indicating whether the collection of standard values returned by the GetStandardValues(ITypeDescriptorContext) method is an exclusive list of possible values, using the specified context.

GetStandardValuesSupported()

Indica se questo oggetto supporta un gruppo standard di valori selezionabili da un elenco.Returns whether this object supports a standard set of values that can be picked from a list.

(Ereditato da TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)

Restituisce un valore che indica se l'oggetto supporta un insieme standard di valori degli ID dei controlli che possono essere selezionati da un elenco, utilizzando il contesto specificato.Returns a value indicating whether this object supports a standard set of control ID values that can be picked from a list, using the specified context.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
IsValid(ITypeDescriptorContext, Object)

Indica se l'oggetto valore specificato è valido per questo tipo e per il contesto specificato.Returns whether the given value object is valid for this type and for the specified context.

(Ereditato da TypeConverter)
IsValid(Object)

Indica se l'oggetto valore specificato è valido per questo tipo.Returns whether the given value object is valid for this type.

(Ereditato da TypeConverter)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
SortProperties(PropertyDescriptorCollection, String[])

Ordina un insieme di proprietà.Sorts a collection of properties.

(Ereditato da TypeConverter)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche