Поделиться через


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

Определение

Инициализирует новый экземпляр класса ControlParameter.

Перегрузки

Имя Описание
ControlParameter()

Инициализирует новый неименованный экземпляр ControlParameter класса.

ControlParameter(ControlParameter)

Инициализирует новый экземпляр ControlParameter класса со значениями из указанного экземпляра.

ControlParameter(String, String)

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

ControlParameter(String, String, String)

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

ControlParameter(String, DbType, String, String)

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

ControlParameter(String, TypeCode, String, String)

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

ControlParameter()

Инициализирует новый неименованный экземпляр ControlParameter класса.

public:
 ControlParameter();
public ControlParameter();
Public Sub New ()

Примеры

В следующем коде показано, как создать ControlParameter объект с помощью конструктора ControlParameter . Объект ControlParameter привязывает SelectedValue свойство DropDownList элемента управления к параметризованному SQL-запросу, который извлекает данные, отображаемые в элементе DataGrid управления.

<%@ Page Language="C#" CodeFile="param1acs.aspx.cs" Inherits="param1acs_aspx" %>
<!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">
    <div>
        <asp:DropDownList
          runat="server"
          AutoPostBack="True"
          id="DropDownList1">
            <asp:ListItem Value="USA">USA</asp:ListItem>
            <asp:ListItem Value="UK">UK</asp:ListItem>
         </asp:DropDownList>

        <asp:DataGrid
          runat="server"
          id="DataGrid1" />    
    </div>
    </form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="false" CodeFile="param1avb.aspx.vb" Inherits="param1avb_aspx" %>
<!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">
    <div>
        <asp:DropDownList
          runat="server"
          AutoPostBack="True"
          id="DropDownList1">
            <asp:ListItem Value="USA">USA</asp:ListItem>
            <asp:ListItem Value="UK">UK</asp:ListItem>
         </asp:DropDownList>

        <asp:DataGrid
          runat="server"
          id="DataGrid1" />    
    </div>
    </form>
</body>
</html>

Комментарии

Объект ControlParameter , созданный с помощью конструктора ControlParameter , инициализирован со значениями по умолчанию для всех его свойств. PropertyName Инициализированы ControlIDString.Emptyсвойства. Кроме того, Name свойство инициализируется в , Type свойство инициализируется TypeCode.ObjectString.Emptyв , Direction свойство инициализировано в , и DefaultValue свойство инициализировано Inputв null.

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

ControlParameter(ControlParameter)

Инициализирует новый экземпляр ControlParameter класса со значениями из указанного экземпляра.

protected:
 ControlParameter(System::Web::UI::WebControls::ControlParameter ^ original);
protected ControlParameter(System.Web.UI.WebControls.ControlParameter original);
new System.Web.UI.WebControls.ControlParameter : System.Web.UI.WebControls.ControlParameter -> System.Web.UI.WebControls.ControlParameter
Protected Sub New (original As ControlParameter)

Параметры

original
ControlParameter

Экземпляр ControlParameter , из которого инициализирован текущий экземпляр.

Комментарии

Конструктор ControlParameter — это защищенный конструктор копирования, который используется для клонирования экземпляра ControlParameter . Значения ControlParameter объекта, включая NameControlIDPropertyNameсвойства и Type свойства, передаются в новый экземпляр.

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

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

ControlParameter(String, String)

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

public:
 ControlParameter(System::String ^ name, System::String ^ controlID);
public ControlParameter(string name, string controlID);
new System.Web.UI.WebControls.ControlParameter : string * string -> System.Web.UI.WebControls.ControlParameter
Public Sub New (name As String, controlID As String)

Параметры

name
String

Имя параметра.

controlID
String

Имя элемента управления, к которому привязан параметр. Значение по умолчанию — Empty.

Комментарии

Объект ControlParameter , созданный с помощью конструктора ControlParameter , инициализируется указанным именем и Control именем параметра, который определяет Control привязку параметра. Другие свойства, включая PropertyNameинициализированы TypeDirectionсо значениями по умолчанию.

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

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

ControlParameter(String, String, String)

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

public:
 ControlParameter(System::String ^ name, System::String ^ controlID, System::String ^ propertyName);
public ControlParameter(string name, string controlID, string propertyName);
new System.Web.UI.WebControls.ControlParameter : string * string * string -> System.Web.UI.WebControls.ControlParameter
Public Sub New (name As String, controlID As String, propertyName As String)

Параметры

name
String

Имя параметра.

controlID
String

Имя элемента управления, к которому привязан параметр. Значение по умолчанию — Empty.

propertyName
String

Имя свойства элемента управления, к которому привязан параметр. Значение по умолчанию — Empty.

Примеры

В следующем коде показано, как создавать ControlParameter объекты с помощью конструктора ControlParameter . Параметры привязываются к значениям TextBox и DropDownList элементам управления для ввода данных в базу данных на странице веб-форм.

private void Button1_Click(object sender, EventArgs e) {

    // The user has pressed the Submit button, prepare a parameterized
    // SQL query to insert the values from the controls.
    AccessDataSource1.InsertCommand =
    "INSERT INTO Employees (FirstName,LastName,Address,City,PostalCode,Country,ReportsTo) " +
    "  VALUES (?,?,?,?,?,?,? ); ";

    AccessDataSource1.InsertParameters.Add(
      new ControlParameter("FirstName", "TextBox1", "Text"));

    AccessDataSource1.InsertParameters.Add(
      new ControlParameter("LastName", "TextBox2", "Text"));

    AccessDataSource1.InsertParameters.Add(
      new ControlParameter("Address", "TextBox3", "Text"));

    AccessDataSource1.InsertParameters.Add(
      new ControlParameter("City", "TextBox4", "Text"));

    AccessDataSource1.InsertParameters.Add(
      new ControlParameter("PostalCode", "TextBox5", "Text"));

    AccessDataSource1.InsertParameters.Add(
      new ControlParameter("Country", "TextBox6", "Text"));

    AccessDataSource1.InsertParameters.Add(
      new ControlParameter("ReportsTo", "DropDownList1", "SelectedValue"));

    try {
        AccessDataSource1.Insert();
    }
    finally {
        Button1.Visible = false;
        Label9.Visible = true;
    }
}
Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)

    ' The user has pressed the Submit button, prepare a parameterized
    ' SQL query to insert the values from the controls.
    AccessDataSource1.InsertCommand = _
    "INSERT INTO Employees (FirstName,LastName,Address,City,PostalCode,Country,ReportsTo) " & _
    "  VALUES (?,?,?,?,?,?,? ); "

    Dim firstName As New ControlParameter("FirstName", "TextBox1", "Text")
    AccessDataSource1.InsertParameters.Add(firstName)

    Dim lastName As New ControlParameter("LastName", "TextBox2", "Text")
    AccessDataSource1.InsertParameters.Add(lastName)

    Dim address As New ControlParameter("Address", "TextBox3", "Text")
    AccessDataSource1.InsertParameters.Add(address)

    Dim city As New ControlParameter("City", "TextBox4", "Text")
    AccessDataSource1.InsertParameters.Add(city)

    Dim postalCode As New ControlParameter("PostalCode", "TextBox5", "Text")
    AccessDataSource1.InsertParameters.Add(postalCode)

    Dim country As New ControlParameter("Country", "TextBox6", "Text")
    AccessDataSource1.InsertParameters.Add(country)

    Dim supervisor As New ControlParameter("ReportsTo", "DropDownList1", "SelectedValue")
    AccessDataSource1.InsertParameters.Add(supervisor)

    Try
        AccessDataSource1.Insert()
    Finally
        Button1.Visible = False
        Label9.Visible = True
    End Try

End Sub

Комментарии

Объект ControlParameter , созданный с ControlParameter помощью конструктора, инициализируется указанным именем параметра, Control именем и PropertyName свойством, который определяет Control привязку параметра. Другие свойства, включая Typeинициализированы DirectionConvertEmptyStringToNullсо значениями по умолчанию.

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

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

ControlParameter(String, DbType, String, String)

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

public:
 ControlParameter(System::String ^ name, System::Data::DbType dbType, System::String ^ controlID, System::String ^ propertyName);
public ControlParameter(string name, System.Data.DbType dbType, string controlID, string propertyName);
new System.Web.UI.WebControls.ControlParameter : string * System.Data.DbType * string * string -> System.Web.UI.WebControls.ControlParameter
Public Sub New (name As String, dbType As DbType, controlID As String, propertyName As String)

Параметры

name
String

Имя параметра.

dbType
DbType

Тип данных параметра.

controlID
String

Имя элемента управления, к которому привязан параметр. Значение по умолчанию — Empty.

propertyName
String

Имя свойства элемента управления, к которому привязан параметр. Значение по умолчанию — Empty.

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

ControlParameter(String, TypeCode, String, String)

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

public:
 ControlParameter(System::String ^ name, TypeCode type, System::String ^ controlID, System::String ^ propertyName);
public ControlParameter(string name, TypeCode type, string controlID, string propertyName);
new System.Web.UI.WebControls.ControlParameter : string * TypeCode * string * string -> System.Web.UI.WebControls.ControlParameter
Public Sub New (name As String, type As TypeCode, controlID As String, propertyName As String)

Параметры

name
String

Имя параметра.

type
TypeCode

Тип, который представляет параметр. Значение по умолчанию — Object.

controlID
String

Имя элемента управления, к которому привязан параметр. Значение по умолчанию — Empty.

propertyName
String

Имя свойства элемента управления, к которому привязан параметр. Значение по умолчанию — Empty.

Примеры

В следующем коде показано, как использовать ControlParameter конструктор для создания двух ControlParameter объектов и связывания их с элементом SqlDataSource управления.


ControlParameter country =
  new ControlParameter("country",TypeCode.String,"ListBox1","SelectedValue");
sqlSource.SelectParameters.Add(country);

ControlParameter report  =
  new ControlParameter("report",TypeCode.Int16,"ListBox2","SelectedValue");
sqlSource.SelectParameters.Add(report);


Dim country As ControlParameter
country = New ControlParameter("country", TypeCode.String, "ListBox1", "SelectedValue")

Dim report As ControlParameter
report = New ControlParameter("report", TypeCode.Int16, "ListBox2", "SelectedValue")

Комментарии

ОбъектControlParameter, созданный с помощью конструктораControlParameter, инициализируется указанным именем параметра, TypeControl именем и PropertyName свойством. Direction Только свойства инициализированы ConvertEmptyStringToNull со значениями по умолчанию.

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

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