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 со значениями по умолчанию для всех его свойств. Свойства ControlID и инициализируются PropertyName в String.Empty. Кроме того, Name свойство инициализируется значением String.Empty, Type свойство инициализируется параметром TypeCode.Object, 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 объекта, включая ControlIDсвойства , PropertyName, Nameи 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, Typeи Direction, инициализируются значениями по умолчанию.
См. также раздел
Применяется к
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, Directionи ConvertEmptyStringToNull, инициализируются значениями по умолчанию.
См. также раздел
Применяется к
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 с указанным именем параметра, Type, Control именем и PropertyName свойством. Только свойства и инициализируются DirectionConvertEmptyStringToNull значениями по умолчанию.