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
Имя параметра.
- 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 со значениями по умолчанию.