ControlParameter Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

bir özelliğinin Control değerini parametre nesnesine bağlar.

public ref class ControlParameter : System::Web::UI::WebControls::Parameter

public class ControlParameter : System.Web.UI.WebControls.Parameter

type ControlParameter = class
    inherit Parameter

Public Class ControlParameter
Inherits Parameter

Devralma: Object

Parameter
ControlParameter

Örnekler

Aşağıdaki kod örneği, bir denetimde ListBox görüntülenen verileri bildirim temelli bir ControlParameter senaryoda denetimin seçili değerine bağlamak için nesnesinin DropDownList nasıl kullanılacağını gösterir. ControlParameter nesnesi, formdaki denetimin SqlDataSource koleksiyonuna SelectParameters eklenir ve özelliğindeki "@Title" yer tutucu metnine SelectCommand karşılık gelir.

<!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">

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">Sales Representative</asp:listitem>
          <asp:listitem>Sales Manager</asp:listitem>
          <asp:listitem>Vice President, Sales</asp:listitem>
      </asp:dropdownlist></p>

      <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

    </form>
  </body>
</html>

<!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">

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">Sales Representative</asp:listitem>
          <asp:listitem>Sales Manager</asp:listitem>
          <asp:listitem>Vice President, Sales</asp:listitem>
      </asp:dropdownlist></p>

      <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

    </form>
  </body>
</html>

Açıklamalar

veya gibi SelectedValue SelectedIndexbir özelliğin değerini parametreli SQL Control sorgusunda, iş nesnesi yönteminde veya filtreleme ifadesinde kullanılan bir parametreye bağlamak için sınıfını kullanabilirsinizControlParameter.

sınıfı, ControlParameter sınıfından Parameter devralınanlara ek olarak iki özellik sağlar: ControlID ve PropertyName. ControlID özelliği hangi Control örneğe bağlanacağını tanımlar ve PropertyName özelliği sınıfın Control ControlParameter bir değer aldığı ortak özelliğini tanımlar.

Oluşturucular

ControlParameter()	sınıfının yeni bir adsız örneğini ControlParameter başlatır.
ControlParameter(ControlParameter)	Belirtilen örnekteki ControlParameter değerlerle sınıfının yeni bir örneğini başlatır.
ControlParameter(String, DbType, String, String)	Belirtilen parametre adını, veritabanı türünü, denetim kimliğini ve özellik adını kullanarak sınıfın yeni bir örneğini ControlParameter başlatır.
ControlParameter(String, String)	Hangi denetimin ControlParameter bağlanacağını belirlemek için belirtilen denetim adını kullanarak sınıfının yeni bir adlandırılmış örneğini başlatır.
ControlParameter(String, String, String)	Hangi denetimin ControlParameter bağlanacağını belirlemek için belirtilen özellik adını ve denetim adını kullanarak sınıfının yeni bir adlandırılmış örneğini başlatır.
ControlParameter(String, TypeCode, String, String)	Hangi denetimin ControlParameter bağlanacağını belirlemek için belirtilen özellik adını ve denetim adını kullanarak sınıfın yeni adlandırılmış ve kesin olarak belirtilmiş bir örneğini başlatır.

Özellikler

ControlID	Nesnenin bağlandığını denetimin ControlParameter adını belirtir.
ConvertEmptyStringToNull	nesnenin bağlı olduğu değerin Parameter ise Emptydeğerine dönüştürülmesi `null` gerekip gerekmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: Parameter)
DbType	Parametresinin veritabanı türünü alır veya ayarlar. (Devralındığı yer: Parameter)
DefaultValue	Yöntemi çağrıldığında Evaluate(HttpContext, Control) parametrenin başlatılmamış olarak bağlı olduğu değerin parametresi için varsayılan bir değer belirtir. (Devralındığı yer: Parameter)
Direction	Nesnenin Parameter bir değeri bir denetime bağlamak için kullanılıp kullanılmadığını veya denetimin değeri değiştirmek için kullanılıp kullanılamayacağını gösterir. (Devralındığı yer: Parameter)
IsTrackingViewState	Nesnenin Parameter görünüm durumundaki değişiklikleri kaydedip kaydetmediğini belirten bir değer alır. (Devralındığı yer: Parameter)
Name	Parametresinin adını alır veya ayarlar. (Devralındığı yer: Parameter)
PropertyName	Nesnenin bağlandığı özellik tarafından tanımlanan denetimin ControlID özellik ControlParameter adını alır veya ayarlar.
Size	Parametresinin boyutunu alır veya ayarlar. (Devralındığı yer: Parameter)
Type	Parametresinin türünü alır veya ayarlar. (Devralındığı yer: Parameter)
ViewState	Aynı sayfa için birden çok istekte bir nesnenin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum Parameter bilgileri sözlüğü alır. (Devralındığı yer: Parameter)

Yöntemler

Clone()	Geçerli ControlParameter örneğin bir kopyasını döndürür.
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
Evaluate(HttpContext, Control)	Güncelleştirmeler ve nesnesinin ControlParameter değerini döndürür.
GetDatabaseType()	DbType Geçerli Parameter örneğin CLR türüne eşdeğer değeri alır. (Devralındığı yer: Parameter)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
LoadViewState(Object)	Veri kaynağı görünümünün daha önce kaydedilmiş görünüm durumunu geri yükler. (Devralındığı yer: Parameter)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnParameterChanged()	OnParametersChanged(EventArgs) nesnesini içeren Parameter koleksiyonun ParameterCollection yöntemini çağırır. (Devralındığı yer: Parameter)
SaveViewState()	Sayfa sunucuya geri gönderildiğinden Parameter beri nesnenin görünüm durumundaki değişiklikleri kaydeder. (Devralındığı yer: Parameter)
SetDirty()	Parameter Durumu görünüm durumunda kaydedilecek şekilde nesneyi işaretler. (Devralındığı yer: Parameter)
ToString()	Bu örneğinin değerini eşdeğer dize gösterimine dönüştürür. (Devralındığı yer: Parameter)
TrackViewState()	Nesnenin görünüm durumundaki Parameter değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState nesnesinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir. (Devralındığı yer: Parameter)

Belirtik Arabirim Kullanımları

ICloneable.Clone()	Geçerli Parameter örneğin bir kopyasını döndürür. (Devralındığı yer: Parameter)
IStateManager.IsTrackingViewState	Nesnenin Parameter görünüm durumundaki değişiklikleri kaydedip kaydetmediğini belirten bir değer alır. (Devralındığı yer: Parameter)
IStateManager.LoadViewState(Object)	Veri kaynağı görünümünün daha önce kaydedilmiş görünüm durumunu geri yükler. (Devralındığı yer: Parameter)
IStateManager.SaveViewState()	Sayfa sunucuya geri gönderildiğinden Parameter beri nesnenin görünüm durumundaki değişiklikleri kaydeder. (Devralındığı yer: Parameter)
IStateManager.TrackViewState()	Nesnenin görünüm durumundaki Parameter değişiklikleri izlemesine neden olur, böylece bunlar denetimin ViewState nesnesinde depolanabilir ve aynı sayfaya yönelik istekler arasında kalıcı hale gelebilir. (Devralındığı yer: Parameter)

Şunlara uygulanır