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 объект для привязки данных, отображаемых в элементе управления, к выбранному значению DropDownList элемента управления в ListBox декларативном сценарии. Объект 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 для привязки значения свойства, например SelectedValue или SelectedIndexпараметра, используемого Control в параметризованном SQL-запросе, методе бизнес-объекта или выражении фильтрации.

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

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

Имя	Описание
ControlParameter()	Инициализирует новый неименованный экземпляр ControlParameter класса.
ControlParameter(ControlParameter)	Инициализирует новый экземпляр ControlParameter класса со значениями из указанного экземпляра.
ControlParameter(String, DbType, String, String)	Инициализирует новый экземпляр класса с помощью указанного имени параметра, типа базы данных, идентификатора ControlParameter элемента управления и имени свойства.
ControlParameter(String, String, String)	Инициализирует новый именованный экземпляр ControlParameter класса, используя указанное имя свойства и имя элемента управления, чтобы определить, к какому элементу управления необходимо привязаться.
ControlParameter(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)

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

См. также раздел

Кері байланыс

Бет пайдалы болды ма?

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