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 vykreslení ID ovládacího prvku. Jedná se DebugInfoControl o 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 TypeConverterAttribute , která označuje ControlIDConverter jako TypeConverter použití pro tuto vlastnost. Přepíše DebugInfoControl metodu Render k vytištění 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 AccessDataSource prvku 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 také slouží jako základní třída pro AssociatedControlConverter třídy a ValidatedControlConverter třídy, které jsou převaděče typů pro webové ovládací prvky a ovládací prvky, které podporují atributy ověřovací vlastnosti 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ý typ převodu.

Konstruktory

Name	Description
ControlIDConverter()	Inicializuje novou instanci ControlIDConverter třídy.

Metody

Name	Description
CanConvertFrom(ITypeDescriptorContext, Type)	Získá hodnotu určující, zda tento převaděč může 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ěč může převést objekt na zadaný typ pomocí zadaného kontextu. (Zděděno od TypeConverter)
CanConvertTo(Type)	Vrátí, zda tento převaděč může převést objekt na zadaný typ. (Zděděno od TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Převede zadaný objekt hodnoty na objekt String. (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 daný ř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 daný 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 informací o jazykové verzi. (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í objektu. (Zděděno od TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Vytvoří instanci typu, ke kterému je přidružena TypeConverter , pomocí zadaného kontextu vzhledem k sadě hodnot vlastností objektu. (Zděděno od TypeConverter)
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
FilterControl(Control)	Vrátí hodnotu určující, zda je ID ovládacího prvku zadaného ovládacího prvku přidáno do TypeConverter.StandardValuesCollection vrácené metodou GetStandardValues(ITypeDescriptorContext) .
GetConvertFromException(Object)	Vrátí výjimku, která se vyvolá, když převod nelze provést. (Zděděno od TypeConverter)
GetConvertToException(Object, Type)	Vrátí výjimku, která se vyvolá, když převod nelze provést. (Zděděno od TypeConverter)
GetCreateInstanceSupported()	Vrátí, zda změna hodnoty pro tento objekt 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 v tomto objektu vyžaduje volání k CreateInstance(IDictionary) vytvoření nové hodnoty pomocí zadaného kontextu. (Zděděno od TypeConverter)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Vrátí kolekci vlastností pro typ pole určeného parametrem hodnoty pomocí zadaného kontextu a atributů. (Zděděno od TypeConverter)
GetProperties(ITypeDescriptorContext, Object)	Vrátí kolekci vlastností pro typ pole určeného parametrem hodnoty pomocí zadaného kontextu. (Zděděno od TypeConverter)
GetProperties(Object)	Vrátí kolekci vlastností pro typ pole určeného 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 tento převaděč typů určen. (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 kolekce standardních hodnot vrácených z GetStandardValues() je exkluzivní seznam. (Zděděno od TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Vrátí hodnotu určující, zda kolekce standardních hodnot vrácených metodou GetStandardValues(ITypeDescriptorContext) je 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()	Získá Type 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 daný objekt hodnoty je platný pro tento typ. (Zděděno od TypeConverter)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (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 převaděče typů
• Zobecněný převod typu