ControlParameter Classe

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Associa il valore di una proprietà di un Control oggetto a un oggetto parametro.

public ref class ControlParameter : System::Web::UI::WebControls::Parameter

public class ControlParameter : System.Web.UI.WebControls.Parameter

type ControlParameter = class
    inherit Parameter

Public Class ControlParameter
Inherits Parameter

Ereditarietà: Object

Parameter
ControlParameter

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare un ControlParameter oggetto per associare i dati visualizzati in un ListBox controllo al valore selezionato di un DropDownList controllo in uno scenario dichiarativo. L'oggetto ControlParameter viene aggiunto all'insieme SelectParameters del SqlDataSource controllo nel form e corrisponde al testo segnaposto "@Title" nella SelectCommand proprietà .

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

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">Sales Representative</asp:listitem>
          <asp:listitem>Sales Manager</asp:listitem>
          <asp:listitem>Vice President, Sales</asp:listitem>
      </asp:dropdownlist></p>

      <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

    </form>
  </body>
</html>

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

      <p><asp:dropdownlist
          id="DropDownList1"
          runat="server"
          autopostback="True">
          <asp:listitem selected="True">Sales Representative</asp:listitem>
          <asp:listitem>Sales Manager</asp:listitem>
          <asp:listitem>Vice President, Sales</asp:listitem>
      </asp:dropdownlist></p>

      <asp:sqldatasource
          id="SqlDataSource1"
          runat="server"
          connectionstring="<%$ ConnectionStrings:MyNorthwind%>"
          selectcommand="SELECT LastName FROM Employees WHERE Title = @Title">
          <selectparameters>
              <asp:controlparameter name="Title" controlid="DropDownList1" propertyname="SelectedValue"/>
          </selectparameters>
      </asp:sqldatasource>

      <p><asp:listbox
          id="ListBox1"
          runat="server"
          datasourceid="SqlDataSource1"
          datatextfield="LastName">
      </asp:listbox></p>

    </form>
  </body>
</html>

Commenti

È possibile usare la ControlParameter classe per associare il valore di una Control proprietà, ad esempio SelectedValue o SelectedIndex, a un parametro usato in una query SQL con parametri, in un metodo oggetto business o in un'espressione di filtro.

La ControlParameter classe fornisce due proprietà oltre a quelle ereditate dalla Parameter classe : ControlID e PropertyName. La ControlID proprietà identifica l'istanza Control a cui eseguire l'associazione e la PropertyName proprietà identifica la proprietà pubblica dell'oggetto Control da cui la ControlParameter classe recupera un valore.

Costruttori

Nome	Descrizione
ControlParameter()	Inizializza una nuova istanza senza nome della ControlParameter classe .
ControlParameter(ControlParameter)	Inizializza una nuova istanza della ControlParameter classe con valori dell'istanza specificata.
ControlParameter(String, DbType, String, String)	Inizializza una nuova istanza della ControlParameter classe utilizzando il nome del parametro, il tipo di database, l'ID di controllo e il nome della proprietà specificati.
ControlParameter(String, String, String)	Inizializza una nuova istanza denominata della ControlParameter classe utilizzando il nome della proprietà e il nome del controllo specificati per identificare il controllo a cui eseguire l'associazione.
ControlParameter(String, String)	Inizializza una nuova istanza denominata della ControlParameter classe utilizzando il nome del controllo specificato per identificare il controllo a cui eseguire l'associazione.
ControlParameter(String, TypeCode, String, String)	Inizializza una nuova istanza denominata e fortemente tipizzata della ControlParameter classe utilizzando il nome della proprietà e il nome del controllo specificati per identificare il controllo a cui eseguire l'associazione.

Proprietà

Nome	Descrizione
ControlID	Specifica il nome del controllo a cui l'oggetto ControlParameter è associato.
ConvertEmptyStringToNull	Ottiene o imposta un valore che indica se il valore a cui è associato l'oggetto Parameter deve essere convertito `null` in se è Empty. (Ereditato da Parameter)
DbType	Ottiene o imposta il tipo di database del parametro . (Ereditato da Parameter)
DefaultValue	Specifica un valore predefinito per il parametro , se il valore associato al parametro deve essere non inizializzato quando viene chiamato il Evaluate(HttpContext, Control) metodo . (Ereditato da Parameter)
Direction	Indica se l'oggetto Parameter viene utilizzato per associare un valore a un controllo o se il controllo può essere utilizzato per modificare il valore. (Ereditato da Parameter)
IsTrackingViewState	Ottiene un valore che indica se l'oggetto Parameter sta salvando le modifiche apportate allo stato di visualizzazione. (Ereditato da Parameter)
Name	Ottiene o imposta il nome del parametro. (Ereditato da Parameter)
PropertyName	Ottiene o imposta il nome della proprietà del controllo identificato dalla ControlID proprietà a cui l'oggetto ControlParameter è associato.
Size	Ottiene o imposta le dimensioni del parametro. (Ereditato da Parameter)
Type	Ottiene o imposta il tipo del parametro. (Ereditato da Parameter)
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un Parameter oggetto in più richieste per la stessa pagina. (Ereditato da Parameter)

Metodi

Nome	Descrizione
Clone()	Restituisce un duplicato dell'istanza corrente ControlParameter .
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Evaluate(HttpContext, Control)	Aggiorna e restituisce il valore dell'oggetto ControlParameter .
GetDatabaseType()	Ottiene il DbType valore equivalente al tipo CLR dell'istanza corrente Parameter . (Ereditato da Parameter)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
LoadViewState(Object)	Ripristina lo stato di visualizzazione salvata in precedenza della vista origine dati. (Ereditato da Parameter)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
OnParameterChanged()	Chiama il OnParametersChanged(EventArgs) metodo dell'insieme ParameterCollection che contiene l'oggetto Parameter . (Ereditato da Parameter)
SaveViewState()	Salva le modifiche apportate allo Parameter stato di visualizzazione dell'oggetto dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da Parameter)
SetDirty()	Contrassegna l'oggetto Parameter in modo che il relativo stato venga registrato nello stato di visualizzazione. (Ereditato da Parameter)
ToString()	Converte il valore di questa istanza nella rappresentazione di stringa equivalente. (Ereditato da Parameter)
TrackViewState()	Fa in modo che l'oggetto Parameter possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nell'oggetto del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da Parameter)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
ICloneable.Clone()	Restituisce un duplicato dell'istanza corrente Parameter . (Ereditato da Parameter)
IStateManager.IsTrackingViewState	Ottiene un valore che indica se l'oggetto Parameter sta salvando le modifiche apportate allo stato di visualizzazione. (Ereditato da Parameter)
IStateManager.LoadViewState(Object)	Ripristina lo stato di visualizzazione salvata in precedenza della vista origine dati. (Ereditato da Parameter)
IStateManager.SaveViewState()	Salva le modifiche apportate allo Parameter stato di visualizzazione dell'oggetto dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da Parameter)
IStateManager.TrackViewState()	Fa in modo che l'oggetto Parameter possa tenere traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nell'oggetto del ViewState controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da Parameter)

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?