Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Proprietà ObjectDataSource.FilterParameters

 

Ottiene un insieme di parametri associati ai segnaposto di parametro nella stringa FilterExpression.

Spazio dei nomi:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

[PersistenceModeAttribute(PersistenceMode.InnerProperty)]
public ParameterCollection FilterParameters { get; }

Valore proprietà

Type: System.Web.UI.WebControls.ParameterCollection

Oggetto ParameterCollection contenente un insieme di parametri associato a tutti i segnaposto di parametro presenti nella proprietà FilterExpression.

Exception Condition
NotSupportedException

Viene imposta la proprietà FilterExpression e il metodo Select non restituisce un oggetto DataSet o DataTable.

Il controllo ObjectDataSource supporta il filtraggio dei dati solo quando il metodo Select restituisce un oggetto DataSet o DataTable.

La sintassi utilizzata per la proprietà FilterExpression è un'espressione di stile della stringa di formato.La sintassi dell'espressione di filtro è uguale a quella accettata dalla proprietà Expression.Se vengono aggiunti parametri all'insieme FilterParameters, è possibile includere segnaposto di stringa di formato.Includere ad esempio "{0}" nell'espressione in sostituzione dei valori di parametro.I segnaposto vengono sostituiti in base all'indice del parametro nell'insieme FilterParameters.

È possibile includere parametri nella proprietà FilterExpression.Se il parametro è di tipo stringa o carattere, racchiuderlo tra virgolette singole.Se il parametro è di tipo numerico, le virgolette non sono necessarie.

La proprietà FilterParameters recupera la proprietà FilterParameters contenuta dall'oggetto ObjectDataSourceView associato al controllo ObjectDataSource.

In questa sezione sono inclusi due esempi di codice.Nel primo esempio di codice viene illustrato come visualizzare i dati filtrati utilizzando un oggetto ObjectDataSource per recuperare i dati da un oggetto business di livello intermedio e un controllo GridView per visualizzare i risultati.Nel secondo esempio di codice viene fornito un esempio di un oggetto business di livello intermedio utilizzato nel primo esempio di codice.

Nell'esempio di codice riportato di seguito viene illustrato come visualizzare i dati filtrati utilizzando un controllo ObjectDataSource per recuperare i dati da un oggetto business di livello intermedio e un controllo GridView per visualizzare i risultati.Mediante il controllo ObjectDataSource è possibile filtrare dati soltanto quando il metodo recupera i dati come oggetto DataSet oppure DataTable.Per questo motivo, la proprietà SelectMethod identifica un metodo di oggetto business che recupera dati come oggetto DataSet.

L'esempio di codice include un controllo TextBox, un controllo GridView, il controllo ObjectDataSource e un pulsante Invia.Per impostazione predefinita, nell'oggetto TextBox viene inserito il nome di uno dei dipendenti di Northwind Traders.Nell'oggetto GridView vengono visualizzate informazioni sul dipendente identificato dal nome nell'oggetto TextBox.Per recuperare dati di un altro dipendente, nell'oggetto TextBox, inserire il nome completo del dipendente e fare clic sul pulsante Invia.

La proprietà FilterExpression specifica un'espressione utilizzata per filtrare i dati recuperati dalla proprietà SelectMethod.e utilizza segnaposto di parametro restituiti ai parametri contenuti nell'insieme FilterParameters.Nell'esempio, il segnaposto del parametro è racchiuso tra virgolette singole perché è di tipo stringa e può contenere spazi.Se il parametro è di tipo numerico o data, le virgolette di delimitazione non sono necessarie.L'insieme FilterParameters contiene un parametro, un oggetto FormParameter associato al controllo TextBox.

System_CAPS_security Sicurezza Nota

È necessario convalidare qualsiasi valore di parametro di filtro ricevuto dal client.Il runtime sostituisce soltanto il valore di parametro nell'espressione di filtro e lo applica all'oggetto DataView restituito dal metodo Select.Se si utilizza la proprietà FilterExpression come misura di sicurezza per limitare il numero di elementi restituiti, è necessario convalidare i valori di parametro prima dell'esecuzione del filtraggio.

<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    protected void ObjectDataSource1_Filtering(object sender, ObjectDataSourceFilteringEventArgs e)
    {
        if (Textbox1.Text == "")
        {
            e.ParameterValues.Clear();
            e.ParameterValues.Add("FullName", "Nancy Davolio");
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ObjectDataSource - C# Example</title>
  </head>
  <body>
    <form id="Form1" method="post" runat="server">

        <p>Show all users with the following name.</p>

        <asp:textbox id="Textbox1" runat="server" text="Nancy Davolio" />

        <asp:gridview
          id="GridView1"
          runat="server"
          datasourceid="ObjectDataSource1"
          autogeneratecolumns="False">
          <columns>
            <asp:boundfield headertext="ID" datafield="EmpID" />
            <asp:boundfield headertext="Name" datafield="FullName" />
            <asp:boundfield headertext="Street Address" datafield="Address" />
          </columns>
        </asp:gridview>

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

        <asp:objectdatasource
          id="ObjectDataSource1"
          runat="server"
          selectmethod="GetAllEmployeesAsDataSet"
          typename="Samples.AspNet.CS.EmployeeLogic"
          filterexpression="FullName='{0}'" OnFiltering="ObjectDataSource1_Filtering">
            <filterparameters>
              <asp:formparameter name="FullName" formfield="Textbox1" defaultvalue="Nancy Davolio" />
            </filterparameters>
        </asp:objectdatasource>

        <p><asp:button id="Button1" runat="server" text="Search" /></p>

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

Nell'esempio di codice riportato di seguito viene fornito un esempio di oggetto business di livello intermedio utilizzato dall'esempio di codice precedente.L'esempio di codice è costituito da due classi di base:

  • La classe EmployeeLogic, vale a dire una classe che incapsula la logica business.

  • La classe NorthwindEmployee, vale a dire una classe modello che contiene soltanto la funzionalità di base richiesta per caricare e mantenere i dati dal livello dati.

Per semplicità, mediante la classe EmployeeLogic viene creato un insieme statico di dati, anziché recuperare i dati da un livello dati.È inoltre utile per questo esempio, perché richiede all'utente di fornire il nome completo di un dipendente Northwind Traders per illustrare l'operazione di filtro.Per un esempio funzionante completo, è necessario compilare e utilizzare queste classi con gli esempi di codice Web Form forniti.

namespace Samples.AspNet.CS {

using System;
using System.Collections;
using System.Data;
using System.Web.UI.WebControls;
  //
  // EmployeeLogic is a stateless business object that encapsulates 
  // the operations you can perform on a NorthwindEmployee object.
  //
  public class EmployeeLogic {


    // Returns a collection of NorthwindEmployee objects.
    public static ICollection GetAllEmployees () {
      ArrayList data = new ArrayList();

      data.Add(new NorthwindEmployee(1,"Nancy","Davolio","507 - 20th Ave. E. Apt. 2A"));
      data.Add(new NorthwindEmployee(2,"Andrew","Fuller","908 W. Capital Way"));
      data.Add(new NorthwindEmployee(3,"Janet","Leverling","722 Moss Bay Blvd."));
      data.Add(new NorthwindEmployee(4,"Margaret","Peacock","4110 Old Redmond Rd."));
      data.Add(new NorthwindEmployee(5,"Steven","Buchanan","14 Garrett Hill"));
      data.Add(new NorthwindEmployee(6,"Michael","Suyama","Coventry House Miner Rd."));
      data.Add(new NorthwindEmployee(7,"Robert","King","Edgeham Hollow Winchester Way"));

      return data;
    }

    public static NorthwindEmployee GetEmployee(object anID) {
      ArrayList data = GetAllEmployees() as ArrayList;     
      int empID = Int32.Parse(anID.ToString());      
      return data[empID] as NorthwindEmployee;
    }

    // 
    // To support basic filtering, the employees cannot
    // be returned as an array of objects, rather as a 
    // DataSet of the raw data values. 
    public static DataSet GetAllEmployeesAsDataSet () {
      ICollection employees = GetAllEmployees();

      DataSet ds = new DataSet("Table");

      // Create the schema of the DataTable.
      DataTable dt = new DataTable();
      DataColumn dc;
      dc = new DataColumn("EmpID",   typeof(int));    dt.Columns.Add(dc);
      dc = new DataColumn("FullName",typeof(string)); dt.Columns.Add(dc);
      dc = new DataColumn("Address", typeof(string)); dt.Columns.Add(dc);

      // Add rows to the DataTable.
      DataRow row;

      foreach (NorthwindEmployee ne in employees) {                
        row = dt.NewRow();
        row["EmpID"]    = ne.EmpID;
        row["FullName"] = ne.FullName;
        row["Address"]  = ne.Address;
        dt.Rows.Add(row);
      } 
      // Add the complete DataTable to the DataSet.
      ds.Tables.Add(dt);

      return ds;
    }    
  }

  public class NorthwindEmployee {

    public NorthwindEmployee (int anID, 
                              string aFirstName,
                              string aLastName,
                              string anAddress) {
      ID = anID;
      firstName = aFirstName;
      lastName = aLastName;   
      address = anAddress;
    }

    private object ID;
    public string EmpID {
      get { return ID.ToString();  }
    }

    private string lastName;
    public string LastName {
      get { return lastName; }
      set { lastName = value; }
    }

    private string firstName;
    public string FirstName {
      get { return firstName; }
      set { firstName = value;  }
    }

    public string FullName {
      get { return FirstName  + " " +  LastName; }
    }

    private string address;
    public string Address {
      get { return address; }
      set { address = value;  }
    }    

  }
}

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: