Aracılığıyla paylaş


ControlParameter Sınıf

Tanım

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
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 SelectedValueSelectedIndexbir ö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 ControlControlParameter 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

Ayrıca bkz.