ControlIDConverter Sınıf

Tanım

Ad Alanı:

System.Web.UI.WebControls

Bütünleştirilmiş Kod:

System.Web.dll

Geçerli kapsayıcıdaki denetim kimliklerinin listesini alan bir tür dönüştürücü sağlar.

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

public class ControlIDConverter : System.ComponentModel.StringConverter

type ControlIDConverter = class
    inherit StringConverter

Public Class ControlIDConverter
Inherits StringConverter

Devralma

Object

TypeConverter

StringConverter

ControlIDConverter

Türetilmiş

System.Web.UI.WebControls.AssociatedControlConverter

System.Web.UI.WebControls.ValidatedControlConverter

Örnekler

Aşağıdaki kod örneği, bir denetimin ControlIDConverter kimliğini işlemek için bir TypeConverter gerektiren bir sınıfta öğesinin nasıl kullanılacağını gösterir. DebugInfoControl, geçerli Web Formunun içerdiği denetimle ilgili bazı bilgileri yazdıran basit bir denetimdir. ÖzelliğiControlID, öğesini bu özellik için kullanılacak olarak TypeConverter belirten ControlIDConverter bir TypeConverterAttribute ile dekore edilmiştir. , DebugInfoControl bir Label denetimdeki Render hedef denetim hakkındaki bilgileri yazdırmak için yöntemini geçersiz kılar.

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

Aşağıdaki kod örneği, denetim hakkındaki bilgileri görüntülemek için bir denetimle birlikte bir AccessDataSource Web Formu'nda öğesinin AccessDataSource nasıl DebugInfoControl kullanılabileceğini gösterir.

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

Açıklamalar

ControlIDConverter sınıfı sınıfından StringConverter türetilir ve tasarım zamanı ortamlarındaki bir özellik kılavuzu denetiminde görüntülenmek üzere denetim kimliklerinin listesini sağlar. ControlIDConverter sınıfı ayrıca, sırasıyla doğrulama özelliği özniteliklerini destekleyen Web denetimleri ve denetimleri için tür dönüştürücüleri olan ve ValidatedControlConverter sınıfları için AssociatedControlConverter temel sınıf görevi görür.

Tür dönüştürücüleri hakkında daha fazla bilgi için bkz . Nasıl yapılır: Tür Dönüştürücüsü Uygulama veya Genelleştirilmiş Tür Dönüştürme.

Oluşturucular

ControlIDConverter()

ControlIDConverter sınıfının yeni bir örneğini başlatır.

Yöntemler

CanConvertFrom(ITypeDescriptorContext, Type)	Bu dönüştürücüün belirtilen bağlamı kullanarak verilen kaynak türdeki bir nesneyi dizeye dönüştürebileceğini belirten bir değer alır. (Devralındığı yer: StringConverter)
CanConvertFrom(Type)	Bu dönüştürücüün verilen türdeki bir nesneyi bu dönüştürücü türüne dönüştürip dönüştüremeyeceğini döndürür. (Devralındığı yer: TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Bu dönüştürücü, belirtilen bağlamı kullanarak nesneyi belirtilen türe dönüştürebilir mi döndürür. (Devralındığı yer: TypeConverter)
CanConvertTo(Type)	Bu dönüştürücüün nesneyi belirtilen türe dönüştürip dönüştüremeyeceğini döndürür. (Devralındığı yer: TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Belirtilen değer nesnesini bir String nesneye dönüştürür. (Devralındığı yer: StringConverter)
ConvertFrom(Object)	Verilen değeri bu dönüştürücü türüne dönüştürür. (Devralındığı yer: TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Sabit kültürü ve belirtilen bağlamı kullanarak verilen dizeyi bu dönüştürücü türüne dönüştürür. (Devralındığı yer: TypeConverter)
ConvertFromInvariantString(String)	Sabit kültürü kullanarak verilen dizeyi bu dönüştürücü türüne dönüştürür. (Devralındığı yer: TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Belirtilen bağlam ve kültür bilgilerini kullanarak verilen metni bir nesneye dönüştürür. (Devralındığı yer: TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Belirtilen bağlamı kullanarak verilen metni bir nesneye dönüştürür. (Devralındığı yer: TypeConverter)
ConvertFromString(String)	Belirtilen metni bir nesneye dönüştürür. (Devralındığı yer: TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Belirtilen bağlam ve kültür bilgilerini kullanarak verilen değer nesnesini belirtilen türe dönüştürür. (Devralındığı yer: TypeConverter)
ConvertTo(Object, Type)	Bağımsız değişkenleri kullanarak verilen değer nesnesini belirtilen türe dönüştürür. (Devralındığı yer: TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Belirtilen bağlamı kullanarak belirtilen değeri kültür sabiti dize gösterimine dönüştürür. (Devralındığı yer: TypeConverter)
ConvertToInvariantString(Object)	Belirtilen değeri kültür sabiti dize gösterimine dönüştürür. (Devralındığı yer: TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Belirtilen bağlam ve kültür bilgilerini kullanarak verilen değeri dize gösterimine dönüştürür. (Devralındığı yer: TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Verilen bağlamı kullanarak verilen değeri bir dize gösterimine dönüştürür. (Devralındığı yer: TypeConverter)
ConvertToString(Object)	Belirtilen değeri dize gösterimine dönüştürür. (Devralındığı yer: TypeConverter)
CreateInstance(IDictionary)	Nesne için belirli bir Object özellik değerleri kümesini yeniden oluşturur. (Devralındığı yer: TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Nesne için bir özellik değerleri kümesi verildiğinde, belirtilen bağlamı kullanarak bunun TypeConverter ilişkili olduğu türün bir örneğini oluşturur. (Devralındığı yer: TypeConverter)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
FilterControl(Control)	Belirtilen denetimin denetim kimliğinin yöntemi tarafından GetStandardValues(ITypeDescriptorContext) döndürülen öğesine TypeConverter.StandardValuesCollection eklenip eklenmediğini belirten bir değer döndürür.
GetConvertFromException(Object)	Dönüştürme gerçekleştirilemediğinde oluşturulacak bir özel durum döndürür. (Devralındığı yer: TypeConverter)
GetConvertToException(Object, Type)	Dönüştürme gerçekleştirilemediğinde oluşturulacak bir özel durum döndürür. (Devralındığı yer: TypeConverter)
GetCreateInstanceSupported()	Bu nesnedeki bir değeri değiştirmenin yeni bir değer oluşturmak için yöntemine CreateInstance(IDictionary) bir çağrı gerekip gerekmediğini döndürür. (Devralındığı yer: TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Bu nesnedeki bir değeri değiştirmenin, belirtilen bağlamı kullanarak yeni bir değer oluşturmak için CreateInstance(IDictionary) çağrısı gerekip gerekmediğini döndürür. (Devralındığı yer: TypeConverter)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetProperties(ITypeDescriptorContext, Object)	Belirtilen bağlamı kullanarak değer parametresi tarafından belirtilen dizi türü için bir özellik koleksiyonu döndürür. (Devralındığı yer: TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Belirtilen bağlamı ve öznitelikleri kullanarak değer parametresi tarafından belirtilen dizi türü için bir özellik koleksiyonu döndürür. (Devralındığı yer: TypeConverter)
GetProperties(Object)	değer parametresi tarafından belirtilen dizi türü için bir özellik koleksiyonu döndürür. (Devralındığı yer: TypeConverter)
GetPropertiesSupported()	Bu nesnenin özellikleri destekleyip desteklemediğini döndürür. (Devralındığı yer: TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Belirtilen bağlamı kullanarak bu nesnenin özellikleri destekleyip desteklemediğini döndürür. (Devralındığı yer: TypeConverter)
GetStandardValues()	Bu tür dönüştürücüsünün tasarlandığı veri türü için varsayılan bağlamdan bir standart değerler koleksiyonu döndürür. (Devralındığı yer: TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Bir biçim bağlamı sağlandığında içindeki IDesignerHost kapsayıcıdan denetim kimlikleri koleksiyonunu döndürür.
GetStandardValuesExclusive()	'den GetStandardValues() döndürülen standart değerler koleksiyonunun özel kullanım listesi olup olmadığını döndürür. (Devralındığı yer: TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	yöntemi tarafından GetStandardValues(ITypeDescriptorContext) döndürülen standart değerler koleksiyonunun, belirtilen bağlamı kullanarak olası değerlerin özel bir listesi olup olmadığını belirten bir değer döndürür.
GetStandardValuesSupported()	Bu nesnenin bir listeden seçilebilen standart bir değer kümesini destekleyip desteklemediğini döndürür. (Devralındığı yer: TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Bu nesnenin, belirtilen bağlam kullanılarak bir listeden seçilebilen standart bir denetim kimliği değerlerini destekleyip desteklemediğini belirten bir değer döndürür.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
IsValid(ITypeDescriptorContext, Object)	Verilen değer nesnesinin bu tür ve belirtilen bağlam için geçerli olup olmadığını döndürür. (Devralındığı yer: TypeConverter)
IsValid(Object)	Verilen değer nesnesinin bu tür için geçerli olup olmadığını döndürür. (Devralındığı yer: TypeConverter)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
SortProperties(PropertyDescriptorCollection, String[])	Bir özellik koleksiyonunu sıralar. (Devralındığı yer: TypeConverter)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• TypeConverter
• AssociatedControlConverter
• ValidatedControlConverter
• Nasıl yapılır: Tür Dönüştürücü Uygulama
• Genelleşmiş Tür Dönüştürme