Condividi tramite

Parametri dichiarativi (VB)

  • Articolo

di Scott Mitchell

Scarica il PDF

In questa esercitazione verrà illustrato come usare un set di parametri su un valore hardcoded per selezionare i dati da visualizzare in un controllo DetailsView.

Introduzione

Nell'ultima esercitazione sono stati esaminati i dati visualizzati con i controlli GridView, DetailsView e FormView associati a un controllo ObjectDataSource che ha richiamato il GetProducts() metodo dalla ProductsBLL classe . Il GetProducts() metodo restituisce una tabella DataTable fortemente tipizzata popolata con tutti i record della tabella del Products database Northwind. La ProductsBLL classe contiene metodi aggiuntivi per restituire solo subset dei prodotti , GetProductByProductID(productID), GetProductsByCategoryID(categoryID)e GetProductsBySupplierID(supplierID). Questi tre metodi prevedono un parametro di input che indica come filtrare le informazioni sul prodotto restituite.

ObjectDataSource può essere usato per richiamare metodi che prevedono parametri di input, ma per farlo è necessario specificare da dove provengono i valori per questi parametri. I valori dei parametri possono essere hardcoded o possono provenire da diverse origini dinamiche, tra cui: valori della stringa di query, variabili di sessione, il valore della proprietà di un controllo Web nella pagina o altri.

Per questa esercitazione si inizierà illustrando come usare un parametro impostato su un valore hardcoded. In particolare, si esaminerà l'aggiunta di un controllo DetailsView alla pagina che visualizza informazioni su un prodotto specifico, ovvero Chef Anton's Gumbo Mix, che ha un ProductID valore pari a 5. Verrà ora illustrato come impostare il valore del parametro in base a un controllo Web. In particolare, useremo un controllo TextBox per consentire all'utente di digitare un paese o un'area geografica, dopo di che è possibile fare clic su un pulsante per visualizzare l'elenco dei fornitori che risiedono in tale paese/area geografica.

Uso di un valore del parametro Hard-Coded

Per il primo esempio, iniziare aggiungendo un controllo DetailsView alla DeclarativeParams.aspx pagina nella BasicReporting cartella . Dallo smart tag DetailsView selezionare <Nuova origine> dati dall'elenco a discesa e scegliere di aggiungere objectDataSource.

Aggiungere objectDataSource alla pagina

Figura 1: Aggiungere objectDataSource alla pagina (fare clic per visualizzare l'immagine a dimensione intera)

Verrà avviata automaticamente la procedura guidata Scegli origine dati del controllo ObjectDataSource. Selezionare la ProductsBLL classe dalla prima schermata della procedura guidata.

Selezionare la classe ProductsBLL

Figura 2: Selezionare la classe (fare clic per visualizzare l'immagineProductsBLL a dimensione intera)

Poiché si vogliono visualizzare informazioni su un determinato prodotto, si vuole usare il GetProductByProductID(productID) metodo .

Scegliere il metodo GetProductByProductID(productID)

Figura 3: Scegliere il GetProductByProductID(productID) metodo (fare clic per visualizzare l'immagine a dimensione intera)

Poiché il metodo selezionato include un parametro, è disponibile un'altra schermata per la procedura guidata, in cui viene chiesto di definire il valore da usare per il parametro. L'elenco a sinistra mostra tutti i parametri per il metodo selezionato. Per GetProductByProductID(productID) è presente un productIDsolo oggetto . A destra è possibile specificare il valore per il parametro selezionato. L'elenco a discesa origine parametri enumera le varie origini possibili per il valore del parametro. Poiché si vuole specificare un valore hardcoded pari a 5 per il productID parametro, lasciare l'origine parametro come Nessuno e immettere 5 nella casella di testo DefaultValue.

Verrà usato un valore di parametro Hard-Coded pari a 5 per il parametro productID

Figura 4: Verrà usato un valore di parametro Hard-Coded pari a 5 per il productID parametro (fare clic per visualizzare l'immagine a dimensione intera)

Al termine della procedura guidata Configura origine dati, il markup dichiarativo del controllo ObjectDataSource include un Parameter oggetto nell'insieme SelectParameters per ognuno dei parametri di input previsti dal metodo definito nella SelectMethod proprietà . Poiché il metodo usato in questo esempio prevede solo un singolo parametro di input, parameterID, è presente una sola voce qui. La SelectParameters raccolta può contenere qualsiasi classe che deriva dalla Parameter classe nello spazio dei System.Web.UI.WebControls nomi . Per i valori dei parametri hardcoded viene usata la classe di base Parameter , ma per le altre opzioni di origine dei parametri viene usata una classe derivata Parameter . Se necessario, è anche possibile creare tipi di parametro personalizzati.

<asp:ObjectDataSource ID="ObjectDataSource1" runat="server"
    SelectMethod="GetProductByProductID" TypeName="ProductsBLL">
    <SelectParameters>
        <asp:Parameter DefaultValue="5"
           Name="productID" Type="Int32" />
    </SelectParameters>
</asp:ObjectDataSource>

Nota

Se si segue nel proprio computer, il markup dichiarativo visualizzato a questo punto può includere valori per le InsertMethodproprietà , UpdateMethode DeleteMethod , nonché DeleteParameters. La procedura guidata Scegli origine dati di ObjectDataSource specifica automaticamente i metodi da ProductBLL usare per l'inserimento, l'aggiornamento e l'eliminazione, quindi, a meno che non vengano esplicitamente cancellati, questi verranno inclusi nel markup precedente.

Quando si visita questa pagina, il controllo Web dati richiamerà il metodo ObjectDataSource Select , che chiamerà il ProductsBLL metodo della GetProductByProductID(productID) classe usando il valore hardcoded di 5 per il productID parametro di input. Il metodo restituirà un oggetto fortemente tipizzato ProductDataTable che contiene una singola riga con informazioni su Chef Anton's Gumbo Mix (il prodotto con ProductID 5).

Vengono visualizzate informazioni sul mix Gumbo di Chef Anton

Figura 5: Vengono visualizzate informazioni sulla combinazione Gumbo di Chef Anton (fare clic per visualizzare l'immagine a dimensione intera)

Impostazione del valore del parametro sul valore della proprietà di un controllo Web

I valori dei parametri di ObjectDataSource possono essere impostati anche in base al valore di un controllo Web nella pagina. Per illustrare questo problema, si avrà un controllo GridView che elenca tutti i fornitori che si trovano in un paese specificato dall'utente. A tale scopo, aggiungere un controllo TextBox alla pagina in cui l'utente può immettere un nome di paese. Impostare la proprietà del ID controllo TextBox su CountryName. Aggiungere anche un controllo Web Button.

Aggiungere un controllo TextBox alla pagina con ID CountryName

Figura 6: Aggiungere un controllo TextBox alla pagina con IDCountryName (fare clic per visualizzare l'immagine a dimensione intera)

Aggiungere quindi un controllo GridView alla pagina e, dallo smart tag, scegliere di aggiungere un nuovo ObjectDataSource. Poiché si vogliono visualizzare le informazioni sul fornitore, selezionare la SuppliersBLL classe dalla prima schermata della procedura guidata. Nella seconda schermata selezionare il GetSuppliersByCountry(country) metodo .

Scegliere il metodo GetSuppliersByCountry(country)

Figura 7: Scegliere il GetSuppliersByCountry(country) metodo (fare clic per visualizzare l'immagine a dimensione intera)

Poiché il GetSuppliersByCountry(country) metodo ha un parametro di input, la procedura guidata include nuovamente una schermata finale per la scelta del valore del parametro. Questa volta, impostare Origine parametro su Controllo. Verrà popolato l'elenco a discesa ControlID con i nomi dei controlli nella pagina; selezionare il CountryName controllo dall'elenco. Quando la pagina viene visitata per la prima volta, textBox CountryName sarà vuota, quindi non vengono restituiti risultati e non viene visualizzato alcun risultato. Per visualizzare alcuni risultati per impostazione predefinita, impostare di conseguenza la casella di testo DefaultValue.

Impostare il valore del parametro sul valore del controllo CountryName

Figura 8: Impostare il valore del parametro sul valore del CountryName controllo (fare clic per visualizzare l'immagine a dimensione intera)

Il markup dichiarativo di ObjectDataSource è leggermente diverso dal primo esempio, usando controlParameter anziché l'oggetto standard Parameter . Un ControlParameter oggetto dispone di proprietà aggiuntive per specificare l'oggetto ID del controllo Web e il valore della proprietà da utilizzare per il parametro (PropertyName). La procedura guidata Configura origine dati è abbastanza intelligente per determinare che, per un controllo TextBox, è probabile che si voglia usare la Text proprietà per il valore del parametro. Se, tuttavia, si desidera utilizzare un valore di proprietà diverso dal controllo Web, è possibile modificare il PropertyName valore qui o facendo clic sul collegamento "Mostra proprietà avanzate" nella procedura guidata.

<asp:ObjectDataSource ID="ObjectDataSource2" runat="server"
    SelectMethod="GetSuppliersByCountry" TypeName="SuppliersBLL">
    <SelectParameters>
        <asp:ControlParameter ControlID="CountryName"
            Name="country" PropertyName="Text"
            Type="String" />
    </SelectParameters>
</asp:ObjectDataSource>

Quando si visita la pagina per la prima volta che TextBox CountryName è vuoto. Il metodo ObjectDataSource Select viene ancora richiamato da GridView, ma viene passato un valore di Nothing nel GetSuppliersByCountry(country) metodo . TableAdapter converte in Nothing un valore di database NULL (DBNull.Value), ma la query usata dal GetSuppliersByCountry(country) metodo viene scritta in modo che non restituisca valori quando viene specificato un NULL valore per il @CategoryID parametro . In breve, non vengono restituiti fornitori.

Quando il visitatore entra in un paese/area geografica, tuttavia, e fa clic sul pulsante Mostra fornitori per generare un postback, il metodo objectDataSource Select viene rieseguito, passando il valore del Text controllo TextBox come country parametro.

Vengono visualizzati i fornitori provenienti dal Canada

Figura 9: Vengono visualizzati i fornitori del Canada (fare clic per visualizzare l'immagine a dimensione intera)

Visualizzazione di tutti i fornitori per impostazione predefinita

Invece di mostrare nessuno dei fornitori quando si visualizza per la prima volta la pagina, è possibile visualizzare tutti i fornitori in un primo momento, consentendo all'utente di ridimensionare l'elenco immettendo un nome di paese nella casella di testo. Quando TextBox è vuoto, il metodo della GetSuppliersByCountry(country) classe viene passato Nothing per il SuppliersBLLcountry relativo parametro di input. Questo Nothing valore viene quindi passato al metodo DAL, in cui viene convertito in un valore di GetSupplierByCountry(country) database NULL per il @Country parametro nella query seguente:

SELECT     SupplierID, CompanyName, Address, City, Country, Phone
FROM         Suppliers
WHERE Country = @Country

L'espressione restituisce Country = NULL sempre False, anche per i record la cui Country colonna ha un NULL valore, pertanto non vengono restituiti record.

Per restituire tutti i fornitori quando il paese TextBox è vuoto, è possibile aumentare il GetSuppliersByCountry(country) metodo nel BLL per richiamare il GetSuppliers() metodo quando il parametro country è Nothing e per chiamare il metodo DAL GetSuppliersByCountry(country) in caso contrario. Ciò avrà l'effetto di restituire tutti i fornitori quando non viene specificato alcun paese e il subset appropriato di fornitori quando il parametro paese è incluso.

Modificare il GetSuppliersByCountry(country) metodo nella SuppliersBLL classe nel modo seguente:

Public Function GetSuppliersByCountry(country As String) _
    As Northwind.SuppliersDataTable
    If String.IsNullOrEmpty(country) Then
        Return GetSuppliers()
    Else
        Return Adapter.GetSuppliersByCountry(country)
    End If
End Function

Con questa modifica, la DeclarativeParams.aspx pagina mostra tutti i fornitori quando viene visitato per la prima volta (o ogni volta che textBox CountryName è vuoto).

Tutti i fornitori sono ora visualizzati per impostazione predefinita

Figura 10: Tutti i fornitori sono ora visualizzati per impostazione predefinita (fare clic per visualizzare l'immagine a dimensione intera)

Riepilogo

Per usare metodi con parametri di input, è necessario specificare i valori per i parametri nell'insieme SelectParameters ObjectDataSource. Diversi tipi di parametri consentono di ottenere il valore del parametro da origini diverse. Il tipo di parametro predefinito usa un valore hardcoded, ma altrettanto facilmente (e senza una riga di codice) i valori dei parametri possono essere ottenuti dalla stringa di query, dalle variabili di sessione, dai cookie e anche dai valori immessi dall'utente dai controlli Web nella pagina.

Negli esempi esaminati in questa esercitazione è stato illustrato come usare i valori dei parametri dichiarativi. Tuttavia, potrebbero esserci momenti in cui è necessario usare un'origine di parametri non disponibile, ad esempio la data e l'ora correnti oppure, se il sito usa l'appartenenza, l'ID utente del visitatore. Per questi scenari è possibile impostare i valori dei parametri a livello di codice prima di richiamare il metodo dell'oggetto sottostante. Verrà illustrato come eseguire questa operazione nell'esercitazione successiva.

Programmazione felice!

Informazioni sull'autore

Scott Mitchell, autore di sette libri ASP/ASP.NET e fondatore di 4GuysFromRolla.com, ha lavorato con le tecnologie Microsoft Web dal 1998. Scott lavora come consulente indipendente, allenatore e scrittore. Il suo ultimo libro è Sams Teach Yourself ASP.NET 2,0 in 24 Ore. Può essere raggiunto a mitchell@4GuysFromRolla.com. o tramite il suo blog, che può essere trovato in http://ScottOnWriting.NET.

Grazie speciali

Questa serie di esercitazioni è stata esaminata da molti revisori utili. Il revisore principale per questa esercitazione è stato Hilton Giesenow. Interessati a esaminare i prossimi articoli MSDN? In tal caso, lasciami una riga in mitchell@4GuysFromRolla.com.

IndietroAvanti