ControlParameter Konstruktoren

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert eine neue Instanz der ControlParameter-Klasse.

Überlädt

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 anhand des angegebenen Steuerelementnamens das Steuerelement identifiziert wird, an das die Bindung erfolgen soll.
ControlParameter(String, String, String)	Initialisiert eine neue benannte Instanz der ControlParameter-Klasse, wobei mithilfe des angegebenen Eigenschaftennamens und des Steuerelementnamens das Steuerelement identifiziert wird, an das die Bindung erfolgen soll.
ControlParameter(String, DbType, String, String)	Initialisiert eine neue Instanz der ControlParameter-Klasse unter Verwendung des angegebenen Parameternamens, des angegebenen Datenbanktyps, der angegebenen Steuerelement-ID sowie des angegebenen Eigenschaftennamens.
ControlParameter(String, TypeCode, String, String)	Initialisiert eine neu benannte und stark typisierte Instanz der ControlParameter-Klasse, wobei mithilfe des angegebenen Eigenschaftennamens und des Steuerelementnamens das Steuerelement angegeben wird, an das die 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 Sie ein ControlParameter Objekt mit dem ControlParameter Konstruktor erstellen. 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 und PropertyName werden mit String.Emptyinitialisiert. Darüber hinaus wird die Name -Eigenschaft mit String.Emptyinitialisiert, die Type -Eigenschaft wird mit initialisiert TypeCode.Object, die Direction -Eigenschaft wird mit Inputinitialisiert, und die DefaultValue -Eigenschaft wird mit nullinitialisiert.

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, von der die aktuelle Instanz initialisiert wird.

Hinweise

Der ControlParameter Konstruktor ist ein geschützter Kopierkonstruktor, der zum Klonen eines ControlParameter instance verwendet wird. Die Werte des ControlParameter -Objekts, einschließlich der ControlIDEigenschaften , PropertyName, NameundType, werden alle an die neue instance übertragen.

Weitere Informationen

Clone()

Gilt für:

ControlParameter(String, String)

Initialisiert eine neue benannte Instanz der ControlParameter-Klasse, wobei anhand des angegebenen Steuerelementnamens das Steuerelement identifiziert wird, an das die 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 wird. Der Standardwert ist Empty.

Hinweise

Ein ControlParameter Objekt, das mit dem ControlParameter Konstruktor erstellt wird, wird mit dem angegebenen Parameternamen und Control -namen initialisiert, der den Control identifiziert, an den der Parameter gebunden ist. 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 mithilfe des angegebenen Eigenschaftennamens und des Steuerelementnamens das Steuerelement identifiziert wird, an das die 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 wird. Der Standardwert ist Empty.

propertyName: String

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

Beispiele

Der folgende Code zeigt, wie Objekte mithilfe des ControlParameter Konstruktors erstellt ControlParameter werden. Die Parameter binden an die Werte und TextBox DropDownList Steuerelemente, um Daten von 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 namen und PropertyName der angegebenen Eigenschaft initialisiert, die den Control identifiziert, an den der Parameter gebunden ist. 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 unter Verwendung des angegebenen Parameternamens, des angegebenen Datenbanktyps, der angegebenen Steuerelement-ID sowie des angegebenen 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 wird. Der Standardwert ist Empty.

propertyName: String

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

Gilt für:

ControlParameter(String, TypeCode, String, String)

Initialisiert eine neu benannte und stark typisierte Instanz der ControlParameter-Klasse, wobei mithilfe des angegebenen Eigenschaftennamens und des Steuerelementnamens das Steuerelement angegeben wird, an das die 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 ist Object.

controlID: String

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

propertyName: String

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

Beispiele

Der folgende Code zeigt, wie Sie den ControlParameter Konstruktor verwenden, um zwei ControlParameter Objekte zu erstellen und sie einem SqlDataSource Steuerelement zuzuordnen.


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, Typenamen Control und PropertyName der angegebenen Eigenschaft initialisiert. Nur die Direction Eigenschaften und ConvertEmptyStringToNull werden mit Standardwerten initialisiert.

Weitere Informationen

Gilt für:

Freigeben über

ControlParameter Konstruktoren

Definition

Überlädt

ControlParameter()

Beispiele

Hinweise

Gilt für:

ControlParameter(ControlParameter)

Parameter

Hinweise

Weitere Informationen

Gilt für:

ControlParameter(String, String)

Parameter

Hinweise

Weitere Informationen

Gilt für:

ControlParameter(String, String, String)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

ControlParameter(String, DbType, String, String)

Parameter

Gilt für:

ControlParameter(String, TypeCode, String, String)

Parameter

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen