ControlIDConverter Třída
Definice
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
- Odvozené
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) |