ControlIDConverter Třída

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.dll

Poskytuje převaděč typů, který načte seznam ID ovládacích prvků v aktuálním kontejneru.

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

public class ControlIDConverter : System.ComponentModel.StringConverter

type ControlIDConverter = class
    inherit StringConverter

Public Class ControlIDConverter
Inherits StringConverter

Dědičnost

Object

TypeConverter

StringConverter

ControlIDConverter

Odvozené

System.Web.UI.WebControls.AssociatedControlConverter

System.Web.UI.WebControls.ValidatedControlConverter

Příklady

Následující příklad kódu ukazuje, jak použít ControlIDConverter ve třídě, která vyžaduje TypeConverter k vykreslení ID ovládacího prvku. Je DebugInfoControl jednoduchý ovládací prvek, který vypíše některé informace o ovládacím prvku obsaženém v aktuálním webovém formuláři. Jeho ControlID vlastnost je zdobena objektem , který označuje ControlIDConverter jako TypeConverter vlastnost, která se má použít pro danou TypeConverterAttribute vlastnost. Přepíše DebugInfoControl metodu Render pro tisk informací o cílovém ovládacím prvku v ovládacím Label prvku.

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

Následující příklad kódu ukazuje, jak DebugInfoControl lze použít ve webovém formuláři spolu s ovládacím prvku AccessDataSource k zobrazení informací o ovládacím AccessDataSource prvku.

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

Poznámky

Třída ControlIDConverter je odvozena z StringConverter třídy a poskytuje seznam ID ovládacích prvků pro zobrazení v ovládacím prvku mřížky vlastností v prostředích návrhu. Třída ControlIDConverter slouží také jako základní třída pro AssociatedControlConverter třídy a ValidatedControlConverter , což jsou převaděče typů pro webové ovládací prvky a ovládací prvky, které podporují atributy vlastností ověřování v uvedeném pořadí.

Další informace o převaděčích typů naleznete v tématu Postupy: Implementace převaděče typů nebo Zobecněný převod typů.

Konstruktory

ControlIDConverter()

Inicializuje novou instanci ControlIDConverter třídy .

Metody

CanConvertFrom(ITypeDescriptorContext, Type)	Získá hodnotu označující, zda tento převaděč lze převést objekt v daném typu zdroje na řetězec pomocí zadaného kontextu. (Zděděno od StringConverter)
CanConvertFrom(Type)	Vrátí, zda tento převaděč může převést objekt daného typu na typ tohoto převaděče. (Zděděno od TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Vrátí, zda tento převaděč lze převést objekt na zadaný typ pomocí zadaného kontextu. (Zděděno od TypeConverter)
CanConvertTo(Type)	Vrátí, zda tento převaděč lze převést objekt na zadaný typ. (Zděděno od TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Převede objekt zadané hodnoty na String objekt . (Zděděno od StringConverter)
ConvertFrom(Object)	Převede danou hodnotu na typ tohoto převaděče. (Zděděno od TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Převede zadaný řetězec na typ tohoto převaděče pomocí invariantní jazykové verze a zadaného kontextu. (Zděděno od TypeConverter)
ConvertFromInvariantString(String)	Převede daný řetězec na typ tohoto převaděče pomocí invariantní jazykové verze. (Zděděno od TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Převede daný text na objekt pomocí zadaného kontextu a informací o jazykové verzi. (Zděděno od TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Převede zadaný text na objekt pomocí zadaného kontextu. (Zděděno od TypeConverter)
ConvertFromString(String)	Převede zadaný text na objekt. (Zděděno od TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Převede daný objekt hodnoty na zadaný typ pomocí zadaného kontextu a jazykové verze informací. (Zděděno od TypeConverter)
ConvertTo(Object, Type)	Převede daný objekt hodnoty na zadaný typ pomocí argumentů. (Zděděno od TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Převede zadanou hodnotu na reprezentaci řetězce invariantní jazykové verze pomocí zadaného kontextu. (Zděděno od TypeConverter)
ConvertToInvariantString(Object)	Převede zadanou hodnotu na reprezentaci řetězce invariantní jazykové verze. (Zděděno od TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Převede danou hodnotu na řetězcovou reprezentaci pomocí zadaného kontextu a informací o jazykové verzi. (Zděděno od TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Převede danou hodnotu na řetězcovou reprezentaci pomocí daného kontextu. (Zděděno od TypeConverter)
ConvertToString(Object)	Převede zadanou hodnotu na řetězcovou reprezentaci. (Zděděno od TypeConverter)
CreateInstance(IDictionary)	Znovu vytvoří danou Object sadu hodnot vlastností pro objekt. (Zděděno od TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Vytvoří instanci typu, ke kterému TypeConverter je přidružena, pomocí zadaného kontextu, vzhledem k sadě hodnot vlastností pro objekt. (Zděděno od TypeConverter)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
FilterControl(Control)	Vrátí hodnotu, která určuje, zda je ID ovládacího prvku zadaného ovládacího prvku přidáno k TypeConverter.StandardValuesCollection ovládacího prvku, který je vrácen metodou GetStandardValues(ITypeDescriptorContext) .
GetConvertFromException(Object)	Vrátí výjimku, která se vyvolá, když nelze provést převod. (Zděděno od TypeConverter)
GetConvertToException(Object, Type)	Vrátí výjimku, která se vyvolá, když nelze provést převod. (Zděděno od TypeConverter)
GetCreateInstanceSupported()	Vrátí, zda změna hodnoty tohoto objektu vyžaduje volání CreateInstance(IDictionary) metody k vytvoření nové hodnoty. (Zděděno od TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Vrátí, zda změna hodnoty u tohoto objektu vyžaduje volání CreateInstance(IDictionary) k vytvoření nové hodnoty pomocí zadaného kontextu. (Zděděno od TypeConverter)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetProperties(ITypeDescriptorContext, Object)	Vrátí kolekci vlastností pro typ pole určený parametrem value pomocí zadaného kontextu. (Zděděno od TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Vrátí kolekci vlastností pro typ pole určený parametrem value pomocí zadaného kontextu a atributů. (Zděděno od TypeConverter)
GetProperties(Object)	Vrátí kolekci vlastností pro typ pole určený parametrem hodnoty. (Zděděno od TypeConverter)
GetPropertiesSupported()	Vrátí, zda tento objekt podporuje vlastnosti. (Zděděno od TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Vrátí, zda tento objekt podporuje vlastnosti pomocí zadaného kontextu. (Zděděno od TypeConverter)
GetStandardValues()	Vrátí kolekci standardních hodnot z výchozího kontextu pro datový typ, pro který je určen převaděč typů. (Zděděno od TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Vrátí kolekci ID ovládacích prvků z kontejneru v rámci IDesignerHost , pokud je k dispozici kontext formátu.
GetStandardValuesExclusive()	Vrátí, zda je kolekce standardních hodnot vrácená z GetStandardValues() výhradního seznamu. (Zděděno od TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Vrátí hodnotu označující, zda je kolekce standardních hodnot vrácených GetStandardValues(ITypeDescriptorContext) metodou výhradním seznamem možných hodnot pomocí zadaného kontextu.
GetStandardValuesSupported()	Vrátí, zda tento objekt podporuje standardní sadu hodnot, které lze vybrat ze seznamu. (Zděděno od TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Vrátí hodnotu určující, zda tento objekt podporuje standardní sadu hodnot ID ovládacího prvku, které lze vybrat ze seznamu pomocí zadaného kontextu.
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
IsValid(ITypeDescriptorContext, Object)	Vrátí, zda daný objekt hodnoty je platný pro tento typ a pro zadaný kontext. (Zděděno od TypeConverter)
IsValid(Object)	Vrátí, zda je daný objekt hodnoty platný pro tento typ. (Zděděno od TypeConverter)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
SortProperties(PropertyDescriptorCollection, String[])	Seřadí kolekci vlastností. (Zděděno od TypeConverter)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• TypeConverter
• AssociatedControlConverter
• ValidatedControlConverter
• Postupy: Implementace konvertoru typů
• Převod zobecněného typu