ControlIDConverter Třída

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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ý vytiskne 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á urč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 prvek 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 od StringConverter třídy a poskytuje seznam ID ovládacích prvků pro zobrazení v ovládacím prvku mřížky vlastností v návrhových prostředích. Třída ControlIDConverter slouží také jako základní třída pro AssociatedControlConverter třídy a ValidatedControlConverter třídy, které jsou převaděči 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ého převodu typů.

Konstruktory

ControlIDConverter()

Inicializuje novou instanci ControlIDConverter třídy.

Metody

CanConvertFrom(ITypeDescriptorContext, Type)	Získá hodnotu označující, zda tento převaděč může převést objekt v daném zdrojovém typu 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 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 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 TypeConverter je přidružena, pomocí zadaného kontextu, vzhledem k sadě hodnot vlastností objektu. (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 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 v tomto objektu CreateInstance(IDictionary) vyžaduje volání 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)	Vrátí kolekci vlastností pro typ pole určeného parametrem hodnoty pomocí zadaného kontextu. (Zděděno od TypeConverter)
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(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 datového typu, pro který je tento převaděč typů navržen. (Zděděno od TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Vrátí kolekci ID ovládacího prvku z kontejneru v IDesignerHost případě, že je k dispozici kontext formátu.
GetStandardValuesExclusive()	Vrátí, zda kolekce standardních hodnot vrácených z GetStandardValues() je výhradní seznam. (Zděděno od TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Vrátí hodnotu určující, zda kolekce standardních hodnot vrácených GetStandardValues(ITypeDescriptorContext) metodou je výhradní seznam 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á aktuální instanci. (Zděděno od Object)
IsValid(ITypeDescriptorContext, Object)	Vrátí, zda je daný objekt hodnoty 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ří použádnou kopii aktuálního souboru 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)

Platí pro