Freigeben über


ControlParameter Konstruktoren

Definition

Initialisiert eine neue Instanz der ControlParameter-Klasse.

Überlädt

Name Beschreibung
ControlParameter()

Initialisiert eine neue unbenannte Instanz der ControlParameter Klasse.

ControlParameter(ControlParameter)

Initialisiert eine neue Instanz der ControlParameter Klasse mit Werten aus der angegebenen Instanz.

ControlParameter(String, String)

Initialisiert eine neue benannte Instanz der ControlParameter Klasse, wobei der angegebene Steuerelementname verwendet wird, um zu identifizieren, an welches Steuerelement eine Bindung erfolgen soll.

ControlParameter(String, String, String)

Initialisiert eine neue benannte Instanz der ControlParameter Klasse, wobei der angegebene Eigenschaftenname und der Steuerelementname verwendet werden, um zu identifizieren, an welches Steuerelement eine Bindung erfolgen soll.

ControlParameter(String, DbType, String, String)

Initialisiert eine neue Instanz der ControlParameter Klasse mithilfe des angegebenen Parameternamens, des Datenbanktyps, der Steuerelement-ID und des Eigenschaftennamens.

ControlParameter(String, TypeCode, String, String)

Initialisiert eine neue benannte und stark typierte Instanz der ControlParameter Klasse, wobei der angegebene Eigenschaftenname und der Steuerelementname verwendet werden, um zu identifizieren, an welches Steuerelement eine Bindung erfolgen soll.

ControlParameter()

Initialisiert eine neue unbenannte Instanz der ControlParameter Klasse.

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

Beispiele

Der folgende Code zeigt, wie Ein ControlParameter Objekt mit dem ControlParameter Konstruktor erstellt wird. Das ControlParameter Objekt bindet die SelectedValue Eigenschaft eines DropDownList Steuerelements an eine parametrisierte SQL-Abfrage, die Daten abruft, die in einem DataGrid Steuerelement angezeigt werden.

<%@ 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>

Hinweise

Ein ControlParameter Objekt, das mit dem ControlParameter Konstruktor erstellt wird, wird mit Standardwerten für alle zugehörigen Eigenschaften initialisiert. Die ControlID Eigenschaften PropertyName und Eigenschaften werden initialisiert in String.Empty. Darüber hinaus wird die Name Eigenschaft initialisiert in String.Empty, die Type Eigenschaft wird initialisiert TypeCode.Objectin , die Direction Eigenschaft wird initialisiert für Input, und die DefaultValue Eigenschaft wird initialisiert in null.

Gilt für:

ControlParameter(ControlParameter)

Initialisiert eine neue Instanz der ControlParameter Klasse mit Werten aus der angegebenen Instanz.

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)

Parameter

original
ControlParameter

Eine ControlParameter Instanz, aus der die aktuelle Instanz initialisiert wird.

Hinweise

Der ControlParameter Konstruktor ist ein geschützter Kopierkonstruktor, der zum Klonen einer ControlParameter Instanz verwendet wird. Die Werte des ControlParameter Objekts, einschließlich der ControlID, PropertyName, Nameund Type Eigenschaften, werden alle an die neue Instanz übertragen.

Weitere Informationen

Gilt für:

ControlParameter(String, String)

Initialisiert eine neue benannte Instanz der ControlParameter Klasse, wobei der angegebene Steuerelementname verwendet wird, um zu identifizieren, an welches Steuerelement eine Bindung erfolgen soll.

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)

Parameter

name
String

Der Name des Parameters.

controlID
String

Der Name des Steuerelements, an das der Parameter gebunden ist. Der Standardwert lautet Empty.

Hinweise

Ein ControlParameter Objekt, das mit dem ControlParameter Konstruktor erstellt wird, wird mit dem angegebenen Parameternamen und Control -namen initialisiert, der die Control Bindung des Parameters angibt. Andere Eigenschaften, einschließlich PropertyName, Typeund Direction, werden mit Standardwerten initialisiert.

Weitere Informationen

Gilt für:

ControlParameter(String, String, String)

Initialisiert eine neue benannte Instanz der ControlParameter Klasse, wobei der angegebene Eigenschaftenname und der Steuerelementname verwendet werden, um zu identifizieren, an welches Steuerelement eine Bindung erfolgen soll.

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)

Parameter

name
String

Der Name des Parameters.

controlID
String

Der Name des Steuerelements, an das der Parameter gebunden ist. Der Standardwert lautet Empty.

propertyName
String

Der Name der Eigenschaft für das Steuerelement, an das der Parameter gebunden ist. Der Standardwert lautet Empty.

Beispiele

Der folgende Code zeigt, wie Objekte mithilfe des ControlParameter Konstruktors erstellt ControlParameter werden. Die Parameter binden an die Werte und TextBoxDropDownList Steuerelemente, um Daten aus einer Web Forms-Seite in eine Datenbank einzugeben.

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

Hinweise

Ein ControlParameter Objekt, das mit dem ControlParameter Konstruktor erstellt wird, wird mit dem angegebenen Parameternamen, Control Dem Namen und PropertyName der Eigenschaft initialisiert, das die Control Bindung des Parameters angibt. Andere Eigenschaften, einschließlich Type, Directionund ConvertEmptyStringToNull, werden mit Standardwerten initialisiert.

Weitere Informationen

Gilt für:

ControlParameter(String, DbType, String, String)

Initialisiert eine neue Instanz der ControlParameter Klasse mithilfe des angegebenen Parameternamens, des Datenbanktyps, der Steuerelement-ID und des Eigenschaftennamens.

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)

Parameter

name
String

Der Name des Parameters.

dbType
DbType

Der Datentyp des Parameters.

controlID
String

Der Name des Steuerelements, an das der Parameter gebunden ist. Der Standardwert lautet Empty.

propertyName
String

Der Name der Eigenschaft des Steuerelements, an das der Parameter gebunden ist. Der Standardwert lautet Empty.

Gilt für:

ControlParameter(String, TypeCode, String, String)

Initialisiert eine neue benannte und stark typierte Instanz der ControlParameter Klasse, wobei der angegebene Eigenschaftenname und der Steuerelementname verwendet werden, um zu identifizieren, an welches Steuerelement eine Bindung erfolgen soll.

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)

Parameter

name
String

Der Name des Parameters.

type
TypeCode

Der Typ, den der Parameter darstellt. Der Standardwert lautet Object.

controlID
String

Der Name des Steuerelements, an das der Parameter gebunden ist. Der Standardwert lautet Empty.

propertyName
String

Der Name der Eigenschaft des Steuerelements, an das der Parameter gebunden ist. Der Standardwert lautet Empty.

Beispiele

Der folgende Code zeigt, wie sie mit dem ControlParameter Konstruktor zwei ControlParameter Objekte erstellen und einem SqlDataSource Steuerelement zuordnen.


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")

Hinweise

Ein ControlParameter Objekt, das mit dem ControlParameter Konstruktor erstellt wird, wird mit dem angegebenen Parameternamen, ControlTypedem Namen und PropertyName der Eigenschaft initialisiert. Nur die Eigenschaften und ConvertEmptyStringToNull Eigenschaften Direction werden mit Standardwerten initialisiert.

Weitere Informationen

Gilt für: