Partager via


ControlParameter Constructeurs

Définition

Initialise une nouvelle instance de la classe ControlParameter.

Surcharges

ControlParameter()

Initialise une nouvelle instance sans nom de la classe ControlParameter.

ControlParameter(ControlParameter)

Initialise une nouvelle instance de la classe ControlParameter avec des valeurs de l'instance spécifiée.

ControlParameter(String, String)

Initialise une nouvelle instance nommée de la classe ControlParameter à l'aide du nom de contrôle spécifié pour identifier le contrôle à lier.

ControlParameter(String, String, String)

Initialise une nouvelle instance nommée de la classe ControlParameter à l'aide du nom de la propriété spécifié et du nom du contrôle pour identifier le contrôle à lier.

ControlParameter(String, DbType, String, String)

Initialise une nouvelle instance de la classe ControlParameter en utilisant le nom de paramètre, le type de base de données, l'ID du contrôle et le nom de propriété spécifiés.

ControlParameter(String, TypeCode, String, String)

Initialise une nouvelle instance nommée et fortement typée de la classe ControlParameter à l'aide du nom de la propriété spécifié et du nom du contrôle pour identifier le contrôle à lier.

ControlParameter()

Initialise une nouvelle instance sans nom de la classe ControlParameter.

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

Exemples

Le code suivant montre comment créer un ControlParameter objet avec le ControlParameter constructeur. L’objet ControlParameter lie la SelectedValue propriété d’un DropDownList contrôle à une requête SQL paramétrée qui récupère les données affichées dans un DataGrid contrôle.

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

Remarques

Un ControlParameter objet créé avec le ControlParameter constructeur est initialisé avec des valeurs par défaut pour toutes ses propriétés. Les ControlID propriétés et PropertyName sont initialisées en String.Empty. En outre, la Name propriété est initialisée en String.Empty, la Type propriété est initialisée en TypeCode.Object, la Direction propriété est initialisée sur Inputet la DefaultValue propriété est initialisée sur null.

S’applique à

ControlParameter(ControlParameter)

Initialise une nouvelle instance de la classe ControlParameter avec des valeurs de l'instance spécifiée.

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)

Paramètres

original
ControlParameter

Instance de ControlParameter à partir de laquelle l'instance actuelle est initialisée.

Remarques

Le ControlParameter constructeur est un constructeur de copie protégée utilisé pour cloner un ControlParameter instance. Les valeurs de l’objetControlParameter, y compris les ControlIDpropriétés , PropertyName, Nameet Type , sont toutes transférées vers la nouvelle instance.

Voir aussi

S’applique à

ControlParameter(String, String)

Initialise une nouvelle instance nommée de la classe ControlParameter à l'aide du nom de contrôle spécifié pour identifier le contrôle à lier.

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)

Paramètres

name
String

Le nom du paramètre.

controlID
String

Nom du contrôle auquel est lié le paramètre. La valeur par défaut est Empty.

Remarques

Un ControlParameter objet créé avec le ControlParameter constructeur est initialisé avec le nom et Control le nom du paramètre spécifiés, ce qui identifie le Control auquel le paramètre se lie. D’autres propriétés, notamment PropertyName, Typeet Direction, sont initialisées avec des valeurs par défaut.

Voir aussi

S’applique à

ControlParameter(String, String, String)

Initialise une nouvelle instance nommée de la classe ControlParameter à l'aide du nom de la propriété spécifié et du nom du contrôle pour identifier le contrôle à lier.

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)

Paramètres

name
String

Le nom du paramètre.

controlID
String

Nom du contrôle auquel est lié le paramètre. La valeur par défaut est Empty.

propertyName
String

Nom de la propriété sur le contrôle auquel le paramètre est lié. La valeur par défaut est Empty.

Exemples

Le code suivant montre comment créer ControlParameter des objets à l’aide du ControlParameter constructeur. Les paramètres se lient aux valeurs de et DropDownList aux contrôles pour TextBox entrer des données dans une base de données à partir d’une page de Web Forms.

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

Remarques

Un ControlParameter objet créé avec le ControlParameter constructeur est initialisé avec le nom, Control le nom et PropertyName la propriété de paramètre spécifiés, qui identifient le Control auquel le paramètre est lié. D’autres propriétés, notamment Type, Directionet ConvertEmptyStringToNull, sont initialisées avec des valeurs par défaut.

Voir aussi

S’applique à

ControlParameter(String, DbType, String, String)

Initialise une nouvelle instance de la classe ControlParameter en utilisant le nom de paramètre, le type de base de données, l'ID du contrôle et le nom de propriété spécifiés.

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)

Paramètres

name
String

Le nom du paramètre.

dbType
DbType

Type de données du paramètre.

controlID
String

Nom du contrôle auquel est lié le paramètre. La valeur par défaut est Empty.

propertyName
String

Nom de la propriété du contrôle auquel le paramètre est lié. La valeur par défaut est Empty.

S’applique à

ControlParameter(String, TypeCode, String, String)

Initialise une nouvelle instance nommée et fortement typée de la classe ControlParameter à l'aide du nom de la propriété spécifié et du nom du contrôle pour identifier le contrôle à lier.

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)

Paramètres

name
String

Le nom du paramètre.

type
TypeCode

Type que le paramètre représente. La valeur par défaut est Object.

controlID
String

Nom du contrôle auquel est lié le paramètre. La valeur par défaut est Empty.

propertyName
String

Nom de la propriété du contrôle auquel le paramètre est lié. La valeur par défaut est Empty.

Exemples

Le code suivant montre comment utiliser le ControlParameter constructeur pour créer deux ControlParameter objets et les associer à un SqlDataSource contrôle.


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

Remarques

Un ControlParameter objet créé avec le ControlParameter constructeur est initialisé avec le nom de paramètre, Type, le Control nom et PropertyName la propriété spécifiés. Seules les Direction propriétés et ConvertEmptyStringToNull sont initialisées avec des valeurs par défaut.

Voir aussi

S’applique à