ControlIDConverter Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menyediakan konverter jenis yang mengambil daftar ID kontrol dalam kontainer saat ini.

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

public class ControlIDConverter : System.ComponentModel.StringConverter

type ControlIDConverter = class
    inherit StringConverter

Public Class ControlIDConverter
Inherits StringConverter

Warisan: Object

TypeConverter

StringConverter
ControlIDConverter

Turunan: System.Web.UI.WebControls.AssociatedControlConverter

System.Web.UI.WebControls.ValidatedControlConverter

Contoh

Contoh kode berikut menunjukkan cara menggunakan ControlIDConverter di kelas yang memerlukan TypeConverter untuk merender ID kontrol. DebugInfoControl adalah kontrol sederhana yang mencetak beberapa informasi pada kontrol yang terkandung oleh Formulir Web saat ini. Propertinya ControlID didekorasi dengan TypeConverterAttribute yang menunjuk ControlIDConverter sebagai untuk digunakan untuk properti tersebut TypeConverter . Mengambil DebugInfoControl alih Render metode untuk mencetak informasi tentang kontrol target dalam Label kontrol.

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

Contoh kode berikut menunjukkan bagaimana DebugInfoControl dapat digunakan dalam Formulir Web bersama dengan AccessDataSource kontrol untuk menampilkan informasi tentang AccessDataSource kontrol.

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

Keterangan

Kelas ControlIDConverter berasal dari StringConverter kelas dan menyediakan daftar ID kontrol untuk ditampilkan dalam kontrol kisi properti di lingkungan waktu desain. Kelas ini ControlIDConverter juga berfungsi sebagai kelas dasar untuk AssociatedControlConverter kelas dan ValidatedControlConverter , yang merupakan pengonversi jenis untuk kontrol dan kontrol Web yang masing-masing mendukung atribut properti validasi.

Untuk informasi selengkapnya tentang pengonversi jenis, lihat Cara: Menerapkan Pengonversi Tipe atau Konversi Tipe Umum.

Konstruktor

ControlIDConverter()

Menginisialisasi instans baru kelas ControlIDConverter.

Metode

CanConvertFrom(ITypeDescriptorContext, Type)	Mendapatkan nilai yang menunjukkan apakah pengonversi ini dapat mengonversi objek dalam jenis sumber tertentu menjadi string menggunakan konteks yang ditentukan. (Diperoleh dari StringConverter)
CanConvertFrom(Type)	Mengembalikan apakah pengonversi ini dapat mengonversi objek dari jenis yang diberikan ke tipe pengonversi ini. (Diperoleh dari TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Mengembalikan apakah pengonversi ini dapat mengonversi objek ke jenis yang ditentukan, menggunakan konteks yang ditentukan. (Diperoleh dari TypeConverter)
CanConvertTo(Type)	Mengembalikan apakah pengonversi ini dapat mengonversi objek ke tipe yang ditentukan. (Diperoleh dari TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Mengonversi objek nilai yang ditentukan menjadi String objek. (Diperoleh dari StringConverter)
ConvertFrom(Object)	Mengonversi nilai yang diberikan ke tipe pengonversi ini. (Diperoleh dari TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Mengonversi string yang diberikan ke jenis pengonversi ini, menggunakan budaya invarian dan konteks yang ditentukan. (Diperoleh dari TypeConverter)
ConvertFromInvariantString(String)	Mengonversi string yang diberikan ke jenis pengonversi ini, menggunakan budaya invariant. (Diperoleh dari TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Mengonversi teks yang diberikan menjadi objek, menggunakan informasi konteks dan budaya yang ditentukan. (Diperoleh dari TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Mengonversi teks yang diberikan menjadi objek, menggunakan konteks yang ditentukan. (Diperoleh dari TypeConverter)
ConvertFromString(String)	Mengonversi teks yang ditentukan menjadi objek. (Diperoleh dari TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Mengonversi objek nilai yang diberikan ke jenis yang ditentukan, menggunakan informasi konteks dan budaya yang ditentukan. (Diperoleh dari TypeConverter)
ConvertTo(Object, Type)	Mengonversi objek nilai yang diberikan ke jenis yang ditentukan, menggunakan argumen . (Diperoleh dari TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Mengonversi nilai yang ditentukan menjadi representasi string invarian budaya, menggunakan konteks yang ditentukan. (Diperoleh dari TypeConverter)
ConvertToInvariantString(Object)	Mengonversi nilai yang ditentukan menjadi representasi string invarian budaya. (Diperoleh dari TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Mengonversi nilai yang diberikan menjadi representasi string, menggunakan informasi konteks dan budaya yang ditentukan. (Diperoleh dari TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Mengonversi nilai yang diberikan menjadi representasi string, menggunakan konteks yang diberikan. (Diperoleh dari TypeConverter)
ConvertToString(Object)	Mengonversi nilai yang ditentukan menjadi representasi string. (Diperoleh dari TypeConverter)
CreateInstance(IDictionary)	Membuat ulang sekumpulan nilai properti yang Object diberikan untuk objek . (Diperoleh dari TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Membuat instans jenis yang terkait dengan ini TypeConverter , menggunakan konteks yang ditentukan, mengingat sekumpulan nilai properti untuk objek. (Diperoleh dari TypeConverter)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FilterControl(Control)	Mengembalikan nilai yang menunjukkan apakah ID kontrol kontrol yang ditentukan ditambahkan ke TypeConverter.StandardValuesCollection yang dikembalikan oleh GetStandardValues(ITypeDescriptorContext) metode .
GetConvertFromException(Object)	Mengembalikan pengecualian untuk dilemparkan saat konversi tidak dapat dilakukan. (Diperoleh dari TypeConverter)
GetConvertToException(Object, Type)	Mengembalikan pengecualian untuk dilemparkan saat konversi tidak dapat dilakukan. (Diperoleh dari TypeConverter)
GetCreateInstanceSupported()	Mengembalikan apakah mengubah nilai pada objek ini memerlukan panggilan ke CreateInstance(IDictionary) metode untuk membuat nilai baru. (Diperoleh dari TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Mengembalikan apakah mengubah nilai pada objek ini memerlukan panggilan ke CreateInstance(IDictionary) untuk membuat nilai baru, menggunakan konteks yang ditentukan. (Diperoleh dari TypeConverter)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetProperties(ITypeDescriptorContext, Object)	Mengembalikan kumpulan properti untuk jenis array yang ditentukan oleh parameter nilai, menggunakan konteks yang ditentukan. (Diperoleh dari TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Mengembalikan kumpulan properti untuk jenis array yang ditentukan oleh parameter nilai, menggunakan konteks dan atribut yang ditentukan. (Diperoleh dari TypeConverter)
GetProperties(Object)	Mengembalikan kumpulan properti untuk jenis array yang ditentukan oleh parameter nilai. (Diperoleh dari TypeConverter)
GetPropertiesSupported()	Mengembalikan apakah objek ini mendukung properti. (Diperoleh dari TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Mengembalikan apakah objek ini mendukung properti, menggunakan konteks yang ditentukan. (Diperoleh dari TypeConverter)
GetStandardValues()	Mengembalikan kumpulan nilai standar dari konteks default untuk jenis data yang dirancang untuk pengonversi jenis ini. (Diperoleh dari TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Mengembalikan kumpulan ID kontrol dari kontainer dalam IDesignerHost saat disediakan dengan konteks format.
GetStandardValuesExclusive()	Mengembalikan apakah kumpulan nilai standar yang dikembalikan adalah GetStandardValues() daftar eksklusif. (Diperoleh dari TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Mengembalikan nilai yang menunjukkan apakah kumpulan nilai standar yang dikembalikan oleh GetStandardValues(ITypeDescriptorContext) metode adalah daftar eksklusif dari kemungkinan nilai, menggunakan konteks yang ditentukan.
GetStandardValuesSupported()	Mengembalikan apakah objek ini mendukung sekumpulan nilai standar yang dapat dipilih dari daftar. (Diperoleh dari TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Mengembalikan nilai yang menunjukkan apakah objek ini mendukung sekumpulan nilai ID kontrol standar yang dapat dipilih dari daftar, menggunakan konteks yang ditentukan.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
IsValid(ITypeDescriptorContext, Object)	Mengembalikan apakah objek nilai yang diberikan valid untuk jenis ini dan untuk konteks yang ditentukan. (Diperoleh dari TypeConverter)
IsValid(Object)	Mengembalikan apakah objek nilai yang diberikan valid untuk tipe ini. (Diperoleh dari TypeConverter)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
SortProperties(PropertyDescriptorCollection, String[])	Mengurutkan kumpulan properti. (Diperoleh dari TypeConverter)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk

Bagikan melalui