ControlIDConverter Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Udostępnia konwerter typów, który pobiera listę identyfikatorów kontrolek w bieżącym kontenerze.

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

public class ControlIDConverter : System.ComponentModel.StringConverter

type ControlIDConverter = class
    inherit StringConverter

Public Class ControlIDConverter
Inherits StringConverter

Dziedziczenie: Object

TypeConverter

StringConverter
ControlIDConverter

Pochodne: System.Web.UI.WebControls.AssociatedControlConverter

System.Web.UI.WebControls.ValidatedControlConverter

Przykłady

W poniższym przykładzie kodu pokazano, jak używać klasy ControlIDConverter w klasie, która wymaga TypeConverter renderowania identyfikatora kontrolki. Jest DebugInfoControl to prosta kontrolka, która wyświetla niektóre informacje o kontrolce zawartej w bieżącym formularzu sieci Web. Jego ControlID właściwość jest ozdobiona elementem TypeConverterAttribute , który wyznacza ControlIDConverter jako TypeConverter wartość do użycia dla tej właściwości. Zastępuje DebugInfoControl metodę Render , aby wyświetlić informacje o kontrolce docelowej w kontrolce Label .

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

Poniższy przykład kodu pokazuje, jak DebugInfoControl można użyć w formularzu sieci Web wraz z kontrolką AccessDataSource do wyświetlania informacji o kontrolce AccessDataSource .

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

Uwagi

Klasa ControlIDConverter pochodzi z StringConverter klasy i udostępnia listę identyfikatorów kontrolek do wyświetlania w kontrolce siatki właściwości w środowiskach czasu projektowania. Klasa ControlIDConverter służy również jako klasa bazowa dla klas iValidatedControlConverter, które są konwerterami typów dla AssociatedControlConverter kontrolek sieci Web i kontrolek, które obsługują atrybuty właściwości weryfikacji, odpowiednio.

Aby uzyskać więcej informacji na temat konwerterów typów, zobacz How to: Implement a Type Converter or Generalized Type Conversion (Instrukcje: implementowanie konwertera typów lub konwersji uogólnionego typu).

Konstruktory

ControlIDConverter()

Inicjuje nowe wystąpienie klasy ControlIDConverter.

Metody

CanConvertFrom(ITypeDescriptorContext, Type)	Pobiera wartość wskazującą, czy ten konwerter może przekonwertować obiekt w danym typie źródłowym na ciąg przy użyciu określonego kontekstu. (Odziedziczone po StringConverter)
CanConvertFrom(Type)	Zwraca, czy ten konwerter może przekonwertować obiekt danego typu na typ tego konwertera. (Odziedziczone po TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Zwraca, czy ten konwerter może przekonwertować obiekt na określony typ przy użyciu określonego kontekstu. (Odziedziczone po TypeConverter)
CanConvertTo(Type)	Zwraca, czy ten konwerter może przekonwertować obiekt na określony typ. (Odziedziczone po TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Konwertuje określony obiekt wartości na String obiekt. (Odziedziczone po StringConverter)
ConvertFrom(Object)	Konwertuje daną wartość na typ tego konwertera. (Odziedziczone po TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Konwertuje dany ciąg na typ tego konwertera przy użyciu niezmiennej kultury i określonego kontekstu. (Odziedziczone po TypeConverter)
ConvertFromInvariantString(String)	Konwertuje dany ciąg na typ tego konwertera przy użyciu niezmiennej kultury. (Odziedziczone po TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Konwertuje dany tekst na obiekt przy użyciu określonego kontekstu i informacji o kulturze. (Odziedziczone po TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Konwertuje dany tekst na obiekt przy użyciu określonego kontekstu. (Odziedziczone po TypeConverter)
ConvertFromString(String)	Konwertuje określony tekst na obiekt. (Odziedziczone po TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Konwertuje podany obiekt wartości na określony typ przy użyciu określonych kontekstów i informacji o kulturze. (Odziedziczone po TypeConverter)
ConvertTo(Object, Type)	Konwertuje podany obiekt wartości na określony typ przy użyciu argumentów. (Odziedziczone po TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Konwertuje określoną wartość na reprezentację ciągu niezmiennego kultury przy użyciu określonego kontekstu. (Odziedziczone po TypeConverter)
ConvertToInvariantString(Object)	Konwertuje określoną wartość na niezmienną reprezentację ciągu kultury. (Odziedziczone po TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Konwertuje daną wartość na reprezentację ciągu przy użyciu określonego kontekstu i informacji o kulturze. (Odziedziczone po TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Konwertuje daną wartość na reprezentację ciągu przy użyciu danego kontekstu. (Odziedziczone po TypeConverter)
ConvertToString(Object)	Konwertuje określoną wartość na reprezentację ciągu. (Odziedziczone po TypeConverter)
CreateInstance(IDictionary)	Ponownie tworzy Object dany zestaw wartości właściwości dla obiektu. (Odziedziczone po TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Tworzy wystąpienie typu skojarzonego TypeConverter z określonym kontekstem przy użyciu określonego kontekstu, biorąc pod uwagę zestaw wartości właściwości dla obiektu. (Odziedziczone po TypeConverter)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FilterControl(Control)	Zwraca wartość wskazującą, czy identyfikator kontrolki określonej kontrolki jest dodawany do TypeConverter.StandardValuesCollection elementu zwracanego przez metodę GetStandardValues(ITypeDescriptorContext) .
GetConvertFromException(Object)	Zwraca wyjątek zgłaszany, gdy nie można wykonać konwersji. (Odziedziczone po TypeConverter)
GetConvertToException(Object, Type)	Zwraca wyjątek zgłaszany, gdy nie można wykonać konwersji. (Odziedziczone po TypeConverter)
GetCreateInstanceSupported()	Zwraca, czy zmiana wartości w tym obiekcie wymaga wywołania metody w CreateInstance(IDictionary) celu utworzenia nowej wartości. (Odziedziczone po TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Zwraca, czy zmiana wartości na tym obiekcie wymaga wywołania w celu CreateInstance(IDictionary) utworzenia nowej wartości przy użyciu określonego kontekstu. (Odziedziczone po TypeConverter)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetProperties(ITypeDescriptorContext, Object)	Zwraca kolekcję właściwości dla typu tablicy określonej przez parametr value przy użyciu określonego kontekstu. (Odziedziczone po TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Zwraca kolekcję właściwości dla typu tablicy określonej przez parametr value przy użyciu określonego kontekstu i atrybutów. (Odziedziczone po TypeConverter)
GetProperties(Object)	Zwraca kolekcję właściwości dla typu tablicy określonej przez parametr value. (Odziedziczone po TypeConverter)
GetPropertiesSupported()	Zwraca, czy ten obiekt obsługuje właściwości. (Odziedziczone po TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Zwraca, czy ten obiekt obsługuje właściwości przy użyciu określonego kontekstu. (Odziedziczone po TypeConverter)
GetStandardValues()	Zwraca kolekcję wartości standardowych z domyślnego kontekstu dla typu danych, dla których jest przeznaczony ten konwerter typów. (Odziedziczone po TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Zwraca kolekcję identyfikatorów kontrolek z kontenera w ramach IDesignerHost elementu dostarczanego z kontekstem formatu.
GetStandardValuesExclusive()	Zwraca, czy kolekcja wartości standardowych zwracanych z GetStandardValues() listy jest wyłączną listą. (Odziedziczone po TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Zwraca wartość wskazującą, czy kolekcja wartości standardowych zwracanych przez GetStandardValues(ITypeDescriptorContext) metodę jest wyłączną listą możliwych wartości przy użyciu określonego kontekstu.
GetStandardValuesSupported()	Zwraca, czy ten obiekt obsługuje standardowy zestaw wartości, które można wybrać z listy. (Odziedziczone po TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Zwraca wartość wskazującą, czy ten obiekt obsługuje standardowy zestaw wartości identyfikatora kontrolki, które można wybrać z listy przy użyciu określonego kontekstu.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsValid(ITypeDescriptorContext, Object)	Zwraca, czy dany obiekt wartości jest prawidłowy dla tego typu i dla określonego kontekstu. (Odziedziczone po TypeConverter)
IsValid(Object)	Zwraca, czy dany obiekt wartości jest prawidłowy dla tego typu. (Odziedziczone po TypeConverter)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
SortProperties(PropertyDescriptorCollection, String[])	Sortuje kolekcję właściwości. (Odziedziczone po TypeConverter)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Dotyczy