QueryStringParameter Classe

Riferimento

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 un campo della stringa di query della richiesta HTTP a un oggetto parametro.

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

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

type QueryStringParameter = class
    inherit Parameter

Public Class QueryStringParameter
Inherits Parameter

Ereditarietà: Object

Parameter
QueryStringParameter

Esempio

Nell'esempio seguente viene illustrato come creare un oggetto QueryStringParameter da utilizzare come filtro quando si visualizzano i dati in un controllo GridView. Aggiungere l'oggetto QueryStringParameter all'insieme di FilterParameters del controllo AccessDataSource. L'oggetto parametro associa il valore del campo della stringa di query denominato country alla relativa stringa di FilterExpression. Poiché non viene specificata alcuna proprietà DefaultValue per il parametro, se non viene passato alcun campo denominato country con la stringa di query, il controllo AccessDataSource genera un'eccezione NullReferenceException. Se viene passato un campo denominato country ma non ha alcun valore, il controllo GridView non visualizza dati.

<%@ Page language="C#"%>
<!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" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>
    </form>
  </body>
</html>

<%@ Page language="VB"%>
<!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" method="post" runat="server">

      <!-- Use a Query String with country=USA -->
      <asp:gridview
        id ="GridView1"
        runat="server"
        datasourceid="MyAccessDataSource" />

<!-- Security Note: The AccessDataSource uses a QueryStringParameter,
     Security Note: which does not perform validation of input from the client. -->

      <asp:accessdatasource
        id="MyAccessDataSource"
        runat="server"
        datafile="Northwind.mdb"
        selectcommand="SELECT EmployeeID, LastName, Address, PostalCode, Country FROM Employees"
        filterexpression="Country = '{0}'">
        <filterparameters>
          <asp:querystringparameter name="country" type="String" querystringfield="country" />
        </filterparameters>
      </asp:accessdatasource>

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

Commenti

È possibile usare la classe QueryStringParameter per associare il valore di un campo passato come parte di una stringa di query di richiesta HTTP a un parametro usato in una query o in un comando con parametri. Il campo viene recuperato dall'insieme QueryString.

I controlli che associano dati al parametro possono generare un'eccezione se viene fatto riferimento a un oggetto QueryStringParameter, ma non viene passata alcuna coppia nome/valore della stringa di query corrispondente. Analogamente, potrebbero non visualizzare dati se il nome del campo della stringa di query viene passato senza un valore corrispondente. Per evitare queste situazioni, impostare la proprietà DefaultValue, se appropriato.

La classe QueryStringParameter fornisce la proprietà QueryStringField, che identifica il nome del valore della stringa di query a cui eseguire l'associazione. Fornisce inoltre le proprietà ereditate dalla classe Parameter.

Importante

La classe QueryStringParameter non convalida il valore passato; fornisce il valore non elaborato. Tuttavia, è possibile convalidare il valore di un oggetto QueryStringParameter in un controllo origine dati. A tale scopo, gestire il Selecting, Updating, Insertingo Deleting evento del controllo origine dati e controllare il valore del parametro nel gestore eventi. Se il valore del parametro non supera i test di convalida, è possibile annullare l'operazione di dati impostando la proprietà Cancel della classe CancelEventArgs associata su true.

Costruttori

QueryStringParameter()	Inizializza una nuova istanza senza nome della classe QueryStringParameter.
QueryStringParameter(QueryStringParameter)	Inizializza una nuova istanza della classe QueryStringParameter utilizzando i valori dell'istanza specificata dal parametro `original`.
QueryStringParameter(String, DbType, String)	Inizializza una nuova istanza denominata della classe QueryStringParameter utilizzando il campo stringa di query specificato e il tipo di dati del parametro .
QueryStringParameter(String, String)	Inizializza una nuova istanza denominata della classe QueryStringParameter, utilizzando la stringa specificata per identificare il campo della stringa di query a cui eseguire l'associazione.
QueryStringParameter(String, TypeCode, String)	Inizializza una nuova istanza denominata e fortemente tipizzata della classe QueryStringParameter, utilizzando la stringa specificata per identificare il campo della stringa di query a cui eseguire l'associazione.

Proprietà

ConvertEmptyStringToNull	Ottiene o imposta un valore che indica se il valore a cui è associato l'oggetto Parameter deve essere convertito in `null` 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 metodo Evaluate(HttpContext, Control). (Ereditato da Parameter)
Direction	Indica se l'oggetto Parameter viene utilizzato per associare un valore a un controllo o se è possibile utilizzare il controllo per modificare il valore. (Ereditato da Parameter)
IsTrackingViewState	Ottiene un valore che indica se l'oggetto Parameter salva le modifiche apportate allo stato di visualizzazione. (Ereditato da Parameter)
Name	Ottiene o imposta il nome del parametro. (Ereditato da Parameter)
QueryStringField	Ottiene o imposta il nome del campo della stringa di query a cui il parametro è associato.
Size	Ottiene o imposta le dimensioni del parametro. (Ereditato da Parameter)
Type	Ottiene o imposta il tipo del parametro. (Ereditato da Parameter)
ValidateInput	Ottiene o imposta un valore che indica se il valore del parametro della stringa di query viene convalidato o meno.
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un oggetto Parameter in più richieste per la stessa pagina. (Ereditato da Parameter)

Metodi

Clone()	Restituisce un duplicato dell'istanza di QueryStringParameter corrente.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
Evaluate(HttpContext, Control)	Aggiorna e restituisce il valore dell'oggetto QueryStringParameter.
GetDatabaseType()	Ottiene il valore DbType equivalente al tipo CLR dell'istanza di Parameter corrente. (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 metodo OnParametersChanged(EventArgs) dell'insieme ParameterCollection che contiene l'oggetto Parameter. (Ereditato da Parameter)
SaveViewState()	Salva le modifiche apportate allo stato di visualizzazione dell'oggetto Parameter 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 sì che l'oggetto Parameter tiene traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nell'oggetto ViewState del controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da Parameter)

Implementazioni dell'interfaccia esplicita

ICloneable.Clone()	Restituisce un duplicato dell'istanza di Parameter corrente. (Ereditato da Parameter)
IStateManager.IsTrackingViewState	Ottiene un valore che indica se l'oggetto Parameter salva 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 stato di visualizzazione dell'oggetto Parameter dal momento in cui la pagina è stata pubblicata nel server. (Ereditato da Parameter)
IStateManager.TrackViewState()	Fa sì che l'oggetto Parameter tiene traccia delle modifiche apportate allo stato di visualizzazione in modo che possano essere archiviate nell'oggetto ViewState del controllo e mantenute tra le richieste per la stessa pagina. (Ereditato da Parameter)

Si applica a

Condividi tramite