ControlParameter Класс

Ссылка

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Привязывает значение свойства Control к объекту параметра.

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

Наследование: Object

Parameter
ControlParameter

Примеры

В следующем примере кода показано, как использовать ControlParameter объект для привязки данных, отображаемых в элементе ListBox управления, к выбранному значению DropDownList элемента управления в декларативном сценарии. Объект ControlParameter добавляется в коллекцию SelectParameters SqlDataSource элемента управления формы и соответствует тексту заполнителя "@Title" в свойстве SelectCommand .

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

Класс можно использовать для ControlParameter привязки Control значения свойства, например SelectedValue или SelectedIndex, к параметру, который используется в параметризованном SQL-запросе, методе бизнес-объекта или фильтрующем выражении.

Класс ControlParameter предоставляет два свойства в дополнение к свойствам Parameter , унаследованным от класса: ControlID и PropertyName. Свойство ControlID определяет, к какому Control экземпляру следует выполнить привязку, а PropertyName свойство определяет открытое свойство Control объекта , из которого ControlParameter класс получает значение.

Конструкторы

ControlParameter()	Инициализирует новый безымянный экземпляр класса ControlParameter.
ControlParameter(ControlParameter)	Инициализирует новый экземпляр класса ControlParameter значениями из заданного экземпляра.
ControlParameter(String, DbType, String, String)	Инициализирует новый экземпляр класса ControlParameter заданным именем параметра, типом базы данных, идентификатором элемента управления и значением свойства.
ControlParameter(String, String)	Инициализирует новый именованный экземпляр класса ControlParameter, используя указанное имя для идентификации элемента управления, к которому выполняется привязка.
ControlParameter(String, String, String)	Инициализирует новый именованный экземпляр класса ControlParameter, используя указанные имя свойства и имя элемента управления для идентификации элемента управления, к которому выполняется привязка.
ControlParameter(String, TypeCode, String, String)	Инициализирует новый именованный и сильно типизированный экземпляр класса ControlParameter, используя указанные имя свойства и имя элемента управления для идентификации элемента управления, к которому выполняется привязка.

Свойства

ControlID	Задает имя элемента управления, к которому выполняется привязка объекта ControlParameter.
ConvertEmptyStringToNull	Возвращает или задает значение, указывающее на необходимость преобразования значения, к которому привязан объект Parameter в `null`, если его значение равно Empty. (Унаследовано от Parameter)
DbType	Возвращает или задает тип базы данных параметра. (Унаследовано от Parameter)
DefaultValue	Задает значение по умолчанию для параметра, если значение, к которому привязан параметр, должно быть инициализировано при вызове метода Evaluate(HttpContext, Control). (Унаследовано от Parameter)
Direction	Указывает, используется ли объект Parameter для привязки значения к элементу управления или же элемент управления можно использовать для изменения значения. (Унаследовано от Parameter)
IsTrackingViewState	Получает значение, указывающее сохраняет ли объект Parameter изменения в данных о состоянии представления. (Унаследовано от Parameter)
Name	Возвращает или задает имя параметра. (Унаследовано от Parameter)
PropertyName	Возвращает или задает имя свойства элемента управления, идентифицируемого свойством ControlID, к которому привязывается объект ControlParameter.
Size	Возвращает или задает размер параметра. (Унаследовано от Parameter)
Type	Возвращает или задает тип параметра. (Унаследовано от Parameter)
ViewState	Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления объекта Parameter при нескольких запросах одной и той же страницы. (Унаследовано от Parameter)

Методы

Clone()	Возвращает дубликат текущего экземпляра ControlParameter.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Evaluate(HttpContext, Control)	Обновляет и возвращает значение объекта ControlParameter.
GetDatabaseType()	Возвращает значение DbType, эквивалентное типу среды CLR текущего экземпляра Parameter. (Унаследовано от Parameter)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
LoadViewState(Object)	Восстанавливает сохраненное раннее состояние представления источника данных. (Унаследовано от Parameter)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnParameterChanged()	Вызывает метод OnParametersChanged(EventArgs) коллекции ParameterCollection, содержащей объект Parameter. (Унаследовано от Parameter)
SaveViewState()	Сохраняет изменения в данных о состоянии представления объекта Parameter после обратной передачи страницы на сервер. (Унаследовано от Parameter)
SetDirty()	Обозначает объект Parameter как подлежащий записи его состояния в данные о состоянии представления. (Унаследовано от Parameter)
ToString()	Преобразует значение этого экземпляра в эквивалентное ему строковое представление. (Унаследовано от Parameter)
TrackViewState()	Инициирует отслеживание объектом Parameter изменений в состоянии его представления, благодаря чему их можно сохранить для этого объекта ViewState элемента управления и хранить их для всех запросов одной и той же страницы. (Унаследовано от Parameter)

Явные реализации интерфейса

ICloneable.Clone()	Возвращает дубликат текущего экземпляра Parameter. (Унаследовано от Parameter)
IStateManager.IsTrackingViewState	Получает значение, указывающее сохраняет ли объект Parameter изменения в данных о состоянии представления. (Унаследовано от Parameter)
IStateManager.LoadViewState(Object)	Восстанавливает сохраненное раннее состояние представления источника данных. (Унаследовано от Parameter)
IStateManager.SaveViewState()	Сохраняет изменения в данных о состоянии представления объекта Parameter после обратной передачи страницы на сервер. (Унаследовано от Parameter)
IStateManager.TrackViewState()	Инициирует отслеживание объектом Parameter изменений в состоянии его представления, благодаря чему их можно сохранить для этого объекта ViewState элемента управления и хранить их для всех запросов одной и той же страницы. (Унаследовано от Parameter)

Применяется к

Бөлісу құралы: