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


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

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

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 с указанным именем параметра, Type, Control именем и PropertyName свойством. Только свойства и инициализируются DirectionConvertEmptyStringToNull значениями по умолчанию.

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

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