ControlParameter 建構函式

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 ControlParameter 類別的新執行個體。

多載

ControlParameter()	初始化 ControlParameter 類別未命名的新執行個體。
ControlParameter(ControlParameter)	使用來自指定之執行個體的值，初始化 ControlParameter 類別的新執行個體。
ControlParameter(String, String)	初始化 ControlParameter 類別的新命名執行個體，使用指定的控制項名稱識別要繫結至的控制項。
ControlParameter(String, String, String)	初始化 ControlParameter 類別的新命名執行個體，使用指定的屬性名稱和控制項名稱識別要繫結至的控制項。
ControlParameter(String, DbType, String, String)	使用指定的參數名稱、資料庫型別、控制項 ID 及屬性名稱，初始化 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 、 TypeCode.Object Type 屬性初始化為、 Direction 屬性 Input 初始化為，而 DefaultValue 屬性則會初始化為 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 屬性，全都會傳送至新的實例。

另請參閱

Clone()

適用於

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 。參數會系結至和 DropDownList 控制項的值 TextBox ，以從 Web Form 頁面輸入資料庫中的資料。

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)

使用指定的參數名稱、資料庫型別、控制項 ID 及屬性名稱，初始化 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 name 和 PropertyName 屬性初始化。 Direction只有和 ConvertEmptyStringToNull 屬性會以預設值初始化。

另請參閱

適用於

共用方式為

ControlParameter 建構函式

定義

多載

ControlParameter()

範例

備註

適用於

ControlParameter(ControlParameter)

參數

備註

另請參閱

適用於

ControlParameter(String, String)

參數

備註

另請參閱

適用於

ControlParameter(String, String, String)

參數

範例

備註

另請參閱

適用於

ControlParameter(String, DbType, String, String)

參數

適用於

ControlParameter(String, TypeCode, String, String)

參數

範例

備註

另請參閱

適用於

其他資源