ControlParameter Sınıf

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 bir nesnenin DropDownList nasıl kullanılacağını gösterir. ControlParameter nesnesi, formdaki denetimin SqlDataSource koleksiyonuna eklenir SelectParameters 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

Name	Description
ControlParameter()	sınıfının yeni bir adlandırılmamış ö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, String)	Hangi denetimin ControlParameter bağlanacağını belirlemek için belirtilen özellik adını ve denetim adını kullanarak sınıfın yeni bir adlandırılmış örneğini başlatır.
ControlParameter(String, String)	Hangi denetimin ControlParameter bağlanacağını belirlemek için belirtilen denetim adını kullanarak sınıfı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 adlandırılmış ve kesin olarak belirlenmiş yeni bir örneğini başlatır.

Özellikler

Name	Description
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) parametresinin 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 değişiklikleri görünüm durumuna 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

Name	Description
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)	Nesnesinin değerini ControlParameter güncelleştirir ve 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()	Geçerli örneğin Type 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 Objectbasit 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()	Sayfanın sunucuya Parameter geri gönderildiği zamandan bu yana nesnenin görünüm durumundaki değişiklikleri kaydeder. (Devralındığı yer: Parameter)
SetDirty()	Nesnenin durumunun Parameter görünüm durumunda kaydedilmesini sağlayacak şekilde işaretler. (Devralındığı yer: Parameter)
ToString()	Bu örneğin 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ı

Name	Description
ICloneable.Clone()	Geçerli Parameter örneğin bir kopyasını döndürür. (Devralındığı yer: Parameter)
IStateManager.IsTrackingViewState	Nesnenin Parameter değişiklikleri görünüm durumuna 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()	Sayfanın sunucuya Parameter geri gönderildiği zamandan bu yana 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

Ayrıca bkz.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?