ControlIDConverter Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt einen Typkonverter bereit, der eine Liste von Steuerelement-IDs im aktuellen Container abruft.

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

public class ControlIDConverter : System.ComponentModel.StringConverter

type ControlIDConverter = class
    inherit StringConverter

Public Class ControlIDConverter
Inherits StringConverter

Vererbung: Object

TypeConverter

StringConverter
ControlIDConverter

Abgeleitet: System.Web.UI.WebControls.AssociatedControlConverter

System.Web.UI.WebControls.ValidatedControlConverter

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie in ControlIDConverter einer Klasse verwendet wird, die eine TypeConverter zum Rendern der ID eines Steuerelements erfordert. Das DebugInfoControl ist ein einfaches Steuerelement, das einige Informationen zu einem Steuerelement ausgibt, das im aktuellen Webformular enthalten ist. Seine ControlID Eigenschaft ist mit einem TypeConverterAttribute dekoriert, das als ControlIDConverter die TypeConverter für diese Eigenschaft zu verwendende angibt. Die DebugInfoControl überschreibt die Render -Methode, um Informationen zum Zielsteuerelement in einem Label Steuerelement auszudrucken.

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

Im folgenden Codebeispiel wird veranschaulicht, wie in DebugInfoControl einem Webformular zusammen mit einem AccessDataSource Steuerelement Informationen zum AccessDataSource Steuerelement angezeigt werden können.

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

Hinweise

Die ControlIDConverter -Klasse leitet sich von der StringConverter -Klasse ab und stellt eine Liste von Steuerelement-IDs zur Anzeige in einem Eigenschaftenrastersteuerelement in Entwurfszeitumgebungen bereit. Die ControlIDConverter -Klasse dient auch als Basisklasse für die AssociatedControlConverter -Klasse und ValidatedControlConverter -Klasse. Dabei handelt es sich um Typkonverter für Websteuerelemente und Steuerelemente, die Validierungseigenschaftenattribute unterstützen.

Weitere Informationen zu Typkonvertern finden Sie unter Vorgehensweise: Implementieren eines Typkonverters oder generalisierte Typkonvertierung.

Konstruktoren

ControlIDConverter()

Initialisiert eine neue Instanz der ControlIDConverter-Klasse.

Methoden

CanConvertFrom(ITypeDescriptorContext, Type)	Ruft einen Wert ab, der angibt, ob dieser Konverter ein Objekt vom angegebenen Quelltyp unter Verwendung des angegebenen Kontexts in eine Zeichenfolge konvertieren kann. (Geerbt von StringConverter)
CanConvertFrom(Type)	Gibt zurück, ob dieser Konverter ein Objekt des angegebenen Typs in den Typ dieses Konverters konvertieren kann. (Geerbt von TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Gibt zurück, ob dieser Konverter das Objekt mithilfe des angegebenen Kontexts in den angegebenen Typ umwandeln kann. (Geerbt von TypeConverter)
CanConvertTo(Type)	Gibt zurück, ob dieser Konverter das Objekt in den angegebenen Typ konvertieren kann. (Geerbt von TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Konvertiert das angegebene Wertobjekt in ein String-Objekt. (Geerbt von StringConverter)
ConvertFrom(Object)	Konvertiert den angegebenen Wert in den Typ dieses Konverters. (Geerbt von TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Konvertiert die angegebene Zeichenfolge unter Verwendung der invarianten Kultur und des angegebenen Kontexts in den Typ dieses Konverters. (Geerbt von TypeConverter)
ConvertFromInvariantString(String)	Konvertiert die angegebene Zeichenfolge unter Verwendung der invarianten Kultur in einen Typ dieses Konverters. (Geerbt von TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Konvertiert den angegebenen Text unter Verwendung des angegebenen Kontexts und der angegebenen Kulturinformationen in ein Objekt. (Geerbt von TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Konvertiert den angegebenen Text unter Verwendung des angegebenen Kontexts in ein Objekt. (Geerbt von TypeConverter)
ConvertFromString(String)	Konvertiert den angegebenen Text in ein Objekt. (Geerbt von TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Konvertiert das angegebene Wertobjekt in den angegebenen Typ mit dem angegebenen Kontext und Kulturinformationen. (Geerbt von TypeConverter)
ConvertTo(Object, Type)	Konvertiert das angegebene Wertobjekt unter Verwendung der Argumente in den angegebenen Typ. (Geerbt von TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Konvertiert den angegebenen Wert unter Verwendung des angegebenen Kontexts in eine Zeichenfolgendarstellung mit invarianter Kultur. (Geerbt von TypeConverter)
ConvertToInvariantString(Object)	Konvertiert den angegebenen Wert in eine Zeichenfolgendarstellung mit invarianter Kultur. (Geerbt von TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Konvertiert den angegebenen Wert unter Verwendung des angegebenen Kontexts und der angegebenen Kulturinformationen in eine Zeichenfolgendarstellung. (Geerbt von TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Konvertiert den angegebenen Wert unter Verwendung des angegebenen Kontexts in eine Zeichenfolgendarstellung. (Geerbt von TypeConverter)
ConvertToString(Object)	Konvertiert den angegebenen Wert in eine Zeichenfolgendarstellung. (Geerbt von TypeConverter)
CreateInstance(IDictionary)	Erstellt eine Object-Klasse mit einer angegebenen Menge von Eigenschaftswerten für das Objekt neu. (Geerbt von TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Erstellt über den angegebenen Kontext, der aus einer angegebenen Menge von Eigenschaftswerten für das Objekt besteht, eine Instanz des Typs, der dieser TypeConverter-Klasse zugeordnet ist. (Geerbt von TypeConverter)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FilterControl(Control)	Gibt einen Wert zurück, der angibt, ob die Steuerelement-ID des angegebenen Steuerelements der TypeConverter.StandardValuesCollection hinzugefügt wird, die von der GetStandardValues(ITypeDescriptorContext)-Methode zurückgegeben wird.
GetConvertFromException(Object)	Gibt eine Ausnahme zurück, wenn eine Konvertierung nicht erfolgen kann. (Geerbt von TypeConverter)
GetConvertToException(Object, Type)	Gibt eine Ausnahme zurück, wenn eine Konvertierung nicht erfolgen kann. (Geerbt von TypeConverter)
GetCreateInstanceSupported()	Gibt zurück, ob zum Ändern eines Werts für dieses Objekt ein Aufruf der CreateInstance(IDictionary)-Methode erforderlich ist. (Geerbt von TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Gibt zurück, ob bei Ändern eines Werts für dieses Objekt ein Aufruf von CreateInstance(IDictionary) zum Erstellen eines neuen Werts mit dem angegebenen Kontext erforderlich ist. (Geerbt von TypeConverter)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetProperties(ITypeDescriptorContext, Object)	Gibt unter Verwendung des angegebenen Kontexts eine Auflistung der Eigenschaften für den Typ von Array zurück, der durch den Wertparameter angegeben ist. (Geerbt von TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Gibt unter Verwendung des angegebenen Kontexts und der angegebenen Attribute eine Auflistung der Eigenschaften für den Arraytyp zurück, der durch den Wertparameter angegeben ist. (Geerbt von TypeConverter)
GetProperties(Object)	Gibt eine Auflistung von Eigenschaften für den Typ Array zurück, der durch den Wertparameter angegeben ist. (Geerbt von TypeConverter)
GetPropertiesSupported()	Gibt zurück, ob dieses Objekt Eigenschaften unterstützt. (Geerbt von TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Gibt zurück, ob dieses Objekt Eigenschaften unter Verwendung des angegebenen Kontexts unterstützt. (Geerbt von TypeConverter)
GetStandardValues()	Gibt eine Auflistung von Standardwerten aus dem Standardkontext für den Datentyp zurück, für den dieser Typkonverter vorgesehen ist. (Geerbt von TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Gibt eine Auflistung von Steuerelement-IDs aus dem Container im IDesignerHost zurück, wenn ein Formatkontext bereitgestellt wird.
GetStandardValuesExclusive()	Gibt zurück, ob die von GetStandardValues() zurückgegebene Auflistung von Standardwerten eine exklusive Liste darstellt. (Geerbt von TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Gibt einen Wert zurück, der angibt, ob die Auflistung von Standardwerten, die von der GetStandardValues(ITypeDescriptorContext)-Methode unter Verwendung des angegebenen Kontexts zurückgegeben wird, eine exklusive Liste möglicher Werte darstellt.
GetStandardValuesSupported()	Gibt zurück, ob dieses Objekt einen Standardsatz von Werten unterstützt, die aus einer Liste ausgewählt werden können. (Geerbt von TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Gibt einen Wert zurück, der angibt, ob dieses Objekt eine Standardmenge von Steuerelement-ID-Werten unterstützt, die unter Verwendung des angegebenen Kontexts aus einer Liste ausgewählt werden können.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsValid(ITypeDescriptorContext, Object)	Gibt zurück, ob das angegebene Wertobjekt für diesen Typ und den angegebenen Kontext gültig ist. (Geerbt von TypeConverter)
IsValid(Object)	Ruft ab, ob das angegebene Werteobjekt für diesen Typ gültig ist. (Geerbt von TypeConverter)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
SortProperties(PropertyDescriptorCollection, String[])	Sortiert eine Auflistung von Eigenschaften. (Geerbt von TypeConverter)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Gilt für:

Teilen über