Udostępnij za pośrednictwem


ControlParameter Klasa

Definicja

Wiąże wartość właściwości obiektu Control z obiektem parametru.

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
Dziedziczenie
ControlParameter

Przykłady

Poniższy przykład kodu pokazuje, jak używać ControlParameter obiektu do powiązania danych wyświetlanych w kontrolce ListBox z wybraną wartością DropDownList kontrolki w scenariuszu deklaratywnym. ControlParameter Obiekt jest dodawany do SelectParameters kolekcji kontrolki SqlDataSource w formularzu i odpowiada tekstowi zastępczemu "@Title" we SelectCommand właściwości.

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

Uwagi

Klasy można użyć ControlParameter do powiązania wartości Control właściwości, takiej jak SelectedValue lub SelectedIndex, z parametrem używanym w sparametryzowanym zapytaniu SQL, metodzie obiektu biznesowego lub wyrażeniu filtrowania.

Klasa ControlParameter udostępnia dwie właściwości oprócz tych dziedziczone z Parameter klasy: ControlID i PropertyName. Właściwość ControlID identyfikuje wystąpienie, z którym Control ma być powiązane, a PropertyName właściwość identyfikuje właściwość Control publiczną klasy, z której ControlParameter klasa pobiera wartość.

Konstruktory

ControlParameter()

Inicjuje nowe nienazwane wystąpienie ControlParameter klasy.

ControlParameter(ControlParameter)

Inicjuje ControlParameter nowe wystąpienie klasy z wartościami z określonego wystąpienia.

ControlParameter(String, DbType, String, String)

Inicjuje nowe wystąpienie klasy przy użyciu określonej nazwy parametru ControlParameter , typu bazy danych, identyfikatora kontrolki i nazwy właściwości.

ControlParameter(String, String)

Inicjuje ControlParameter nowe nazwane wystąpienie klasy przy użyciu określonej nazwy kontrolki w celu zidentyfikowania, z którą kontrolką ma być powiązana.

ControlParameter(String, String, String)

Inicjuje ControlParameter nowe nazwane wystąpienie klasy przy użyciu określonej nazwy właściwości i nazwy kontrolki w celu zidentyfikowania, z którą kontrolką ma być powiązana.

ControlParameter(String, TypeCode, String, String)

Inicjuje nowe nazwane i silnie typizowane wystąpienie ControlParameter klasy przy użyciu określonej nazwy właściwości i nazwy kontrolki w celu zidentyfikowania, z którą kontrolką ma być powiązana.

Właściwości

ControlID

Określa nazwę kontrolki, z którą ControlParameter obiekt jest powiązany.

ConvertEmptyStringToNull

Pobiera lub ustawia wartość wskazującą, Parameter czy wartość, którą obiekt jest powiązany, powinna zostać przekonwertowana na null wartość , jeśli jest Emptyto .

(Odziedziczone po Parameter)
DbType

Pobiera lub ustawia typ bazy danych parametru.

(Odziedziczone po Parameter)
DefaultValue

Określa wartość domyślną parametru, jeśli wartość parametru jest powiązana z niezainicjowaną, gdy Evaluate(HttpContext, Control) metoda jest wywoływana.

(Odziedziczone po Parameter)
Direction

Wskazuje, czy Parameter obiekt jest używany do powiązania wartości z kontrolką, czy kontrolki można użyć do zmiany wartości.

(Odziedziczone po Parameter)
IsTrackingViewState

Pobiera wartość wskazującą, czy Parameter obiekt zapisuje zmiany w stanie widoku.

(Odziedziczone po Parameter)
Name

Pobiera lub ustawia nazwę parametru.

(Odziedziczone po Parameter)
PropertyName

Pobiera lub ustawia nazwę właściwości kontrolki zidentyfikowanej przez ControlID właściwość, z którą ControlParameter obiekt jest powiązany.

Size

Pobiera lub ustawia rozmiar parametru.

(Odziedziczone po Parameter)
Type

Pobiera lub ustawia typ parametru.

(Odziedziczone po Parameter)
ViewState

Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu Parameter widoku obiektu na wielu żądaniach dla tej samej strony.

(Odziedziczone po Parameter)

Metody

Clone()

Zwraca duplikat bieżącego ControlParameter wystąpienia.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
Evaluate(HttpContext, Control)

Aktualizacje i zwraca wartość ControlParameter obiektu.

GetDatabaseType()

DbType Pobiera wartość równoważną typowi CLR bieżącego Parameter wystąpienia.

(Odziedziczone po Parameter)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
LoadViewState(Object)

Przywraca wcześniej zapisany stan widoku źródła danych.

(Odziedziczone po Parameter)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
OnParameterChanged()

Wywołuje metodę OnParametersChanged(EventArgs) kolekcji ParameterCollection zawierającej Parameter obiekt.

(Odziedziczone po Parameter)
SaveViewState()

Zapisuje zmiany w Parameter stanie widoku obiektu od czasu opublikowania strony z powrotem na serwerze.

(Odziedziczone po Parameter)
SetDirty()

Oznacza obiekt tak Parameter , aby jego stan był rejestrowany w stanie widoku.

(Odziedziczone po Parameter)
ToString()

Konwertuje wartość tego wystąpienia na jego równoważną reprezentację w postaci ciągu.

(Odziedziczone po Parameter)
TrackViewState()

Parameter Powoduje, że obiekt śledzi zmiany w stanie widoku, dzięki czemu można je przechowywać w obiekcie kontrolki ViewState i utrwalać w żądaniach dla tej samej strony.

(Odziedziczone po Parameter)

Jawne implementacje interfejsu

ICloneable.Clone()

Zwraca duplikat bieżącego Parameter wystąpienia.

(Odziedziczone po Parameter)
IStateManager.IsTrackingViewState

Pobiera wartość wskazującą, czy Parameter obiekt zapisuje zmiany w stanie widoku.

(Odziedziczone po Parameter)
IStateManager.LoadViewState(Object)

Przywraca wcześniej zapisany stan widoku źródła danych.

(Odziedziczone po Parameter)
IStateManager.SaveViewState()

Zapisuje zmiany w Parameter stanie widoku obiektu od czasu opublikowania strony z powrotem na serwerze.

(Odziedziczone po Parameter)
IStateManager.TrackViewState()

Parameter Powoduje, że obiekt śledzi zmiany w stanie widoku, dzięki czemu można je przechowywać w obiekcie kontrolki ViewState i utrwalać w żądaniach dla tej samej strony.

(Odziedziczone po Parameter)

Dotyczy

Zobacz też