Procedura dettagliata: utilizzo solo di stored procedure (C#)

Articolo
04/04/2024

In questa procedura dettagliata viene descritto uno scenario LINQ to SQL end-to-end di base per l'accesso ai dati eseguendo solo stored procedure. Questo approccio viene spesso è usato dagli amministratori di database per limitare l'accesso all'archivio dati.

Nota

È inoltre possibile usare stored procedure nelle applicazioni LINQ to SQL per eseguire l'override del comportamento predefinito, specialmente per i processi Create, Update e Delete. Per ulteriori informazioni, vedere Personalizzazione di operazioni di inserimento, aggiornamento ed eliminazione.

Per le finalità di questa procedura dettagliata si utilizzeranno due metodi di cui è stato eseguito il mapping alle stored procedure CustOrdersDetail e CustOrderHist nel database di esempio Northwind. Il mapping viene applicato quando si esegue lo strumento della riga di comando SqlMetal per generare un file C#. Per altre informazioni, vedere la sezione successiva relativa ai prerequisiti.

Questa procedura dettagliata non si basa su Object Relational Designer. Gli sviluppatori che utilizzano Visual Studio possono inoltre utilizzare Object Relational Designer per implementare la funzionalità delle stored procedure. Vedere Strumenti di LINQ to SQL in Visual Studio.

Nota

I nomi o i percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti potrebbero essere diversi nel computer in uso. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per altre informazioni, vedere Personalizzazione dell'IDE.

Questa procedura è stata scritta usando Impostazioni di sviluppo di Visual C#.

Prerequisiti

Per l'esecuzione di questa procedura sono richiesti i seguenti elementi:

Per i file usati nella procedura dettagliata viene usata una cartella dedicata ("c:\linqtest7"). Creare la cartella prima di avviare la procedura.
Il database di esempio Northwind.

Se questo database non è disponibile nel computer di sviluppo, è possibile scaricarlo dal sito di download Microsoft. Per istruzioni, vedere Download di database di esempio. Dopo avere scaricato il database, copiare il file northwnd.mdf nella cartella c:\linqtest7 .
Un file di codice C# generato dal database Northwind.

Questa procedura dettagliata è stata scritta usando lo strumento SqlMetal con la riga di comando seguente:

sqlmetal /code:"c:\linqtest7\northwind.cs" /language:csharp "c:\linqtest7\northwnd.mdf" /sprocs /functions /pluralize

Per altre informazioni, vedere SqlMetal.exe (strumento per la generazione del codice).

Panoramica

La procedura dettagliata è costituita da sei attività principali:

Configurazione della soluzione LINQ to SQL in Visual Studio.
Aggiunta dell'assembly System.Data.Linq al progetto.
Aggiunta del file di codice del database al progetto.
Creazione di una connessione con il database.
Impostazione dell'interfaccia utente.
Esecuzione e test dell'applicazione.

Creazione di una soluzione LINQ to SQL

In questa prima attività si crea una soluzione di Visual Studio contenente i riferimenti necessari per compilare ed eseguire un progetto LINQ to SQL.

Per creare una soluzione LINQ to SQL

In Visual Studio scegliere Nuovo dal menu File, quindi fare clic su Progetto.
Nel riquadro Tipi progetto presente nella finestra di dialogo Nuovo progetto, fare clic su Visual C#.
Nel riquadro Modelli scegliere Applicazione Windows Form.
Nella casella Nome., digitare SprocOnlyApp.
Nella casella Posizione verificare il percorso per l'archiviazione dei file di progetto.
Fare clic su OK.

Verrà aperto Progettazione Windows Form.

Aggiunta del riferimento all'assembly LINQ to SQL

L'assembly LINQ to SQL non è incluso nel modello Applicazione Windows Form standard. Sarà pertanto necessario aggiungere l'assembly manualmente, come descritto nei passaggi seguenti:

Per aggiungere System.Data.Linq.dll

In Esplora soluzioni fare clic con il pulsante destro del mouse su Riferimenti, quindi scegliere Aggiungi riferimento.
Nella finestra di dialogo Aggiungi riferimento fare clic su .NET, fare clic sull'assembly System.Data.Linq, quindi scegliere OK.

L'assembly verrà aggiunto al progetto.

Aggiunta del file di codice di Northwind al progetto

In questa procedura si presuppone che sia stato usato lo strumento SqlMetal per generare un file di codice dal database di esempio Northwind. Per altre informazioni, vedere la sezione precedente relativa ai prerequisiti.

Per aggiungere il file di codice di Northwind al progetto

Nel menu Progetto fare clic su Aggiungi elemento esistente.
Nella finestra di dialogo Aggiungi elemento esistente, passare a c:\linqtest7\northwind.cs, quindi fare clic su Aggiungi.

Il file northwind.cs viene aggiunto al progetto.

Creazione di connessioni a database

In questo passaggio si definirà la connessione al database di esempio Northwind. Per questa procedura dettagliata viene usato il percorso "c:\linqtest7\northwnd.mdf".

Per creare la connessione al database

In Esplora soluzioni, fare clic con il pulsante destro del mouse su Form1.cs, quindi fare clic su Visualizza codice.

Digitare il codice riportato di seguito nella classe Form1.

Northwnd db = new Northwnd(@"c:\linqtest7\northwnd.mdf");

Impostazione dell'interfaccia utente

In questa attività verrà impostata un'interfaccia per consentire agli utenti di eseguire stored procedure per l'accesso ai dati nel database. Nelle applicazioni create con questa procedura dettagliata gli utenti potranno accedere ai dati nel database solo usando le stored procedure incorporate nell'applicazione.

Per impostare l'interfaccia utente

Tornare a Progettazione Windows Form facendo clic su Form1.cs[Design].
Scegliere Casella degli strumenti dal menu Visualizza.

Verrà aperta la Casella degli strumenti.

Nota

Fare clic sull'icona Nascondi automaticamente raffigurante una puntina da disegno per tenere aperta la Casella degli strumenti mentre si eseguono i passaggi rimanenti di questa sezione.
Trascinare due pulsanti, due caselle di testo e due etichette dalla casella degli strumenti in Form1.

Disporre i controlli come raffigurato nell'illustrazione. Espandere Form1 per facilitare l'adattamento dei controlli.
Fare clic con il pulsante destro del mouse su label1, quindi fare clic su Proprietà.
Modificare la proprietà Text da label1 in Enter OrderID:.
Allo stesso modo per label2, modificare la proprietà Text da label2 in Enter CustomerID:.
Modificare inoltre la proprietà Text per button1 in Order Details.
Modificare la proprietà Text per button2 in Order History.

Ampliare i controlli pulsante in modo che tutto il testo sia visibile.

Per gestire i clic sui pulsanti

Fare doppio clic su Order Details in Form1 per aprire il gestore eventi button1 nell'editor di codice.

Digitare il codice riportato di seguito nel gestore eventi button1:

// Declare a variable to hold the contents of
// textBox1 as an argument for the stored
// procedure.
string param = textBox1.Text;

// Declare a variable to hold the results
// returned by the stored procedure.
var custquery = db.CustOrdersDetail(Convert.ToInt32(param));

// Execute the stored procedure and display the results.
string msg = "";
foreach (CustOrdersDetailResult custOrdersDetail in custquery)
{
    msg = msg + custOrdersDetail.ProductName + "\n";
}
if (msg == "")
    msg = "No results.";
MessageBox.Show(msg);

// Clear the variables before continuing.
param = "";
textBox1.Text = "";

Ora fare doppio clic su button2 in Form1 per aprire il gestore button2

Digitare il codice riportato di seguito nel gestore eventi button2:

// Comments in the code for button2 are the same
// as for button1.
string param = textBox2.Text;

var custquery = db.CustOrderHist(param);

string msg = "";
foreach (CustOrderHistResult custOrdHist in custquery)
{
    msg = msg + custOrdHist.ProductName + "\n";
}
MessageBox.Show(msg);

param = "";
textBox2.Text = "";

Test dell'applicazione

A questo punto è possibile procedere al test dell'applicazione. Notare che il contatto con l'archivio dati è limitato alle azioni supportate dalle due stored procedure che, in questo caso, consistono nel restituire i prodotti inclusi per qualsiasi ID ordine immesso o nel restituire una cronologia dei prodotti ordinati per qualsiasi ID cliente immesso.

Per testare l'applicazione

Premere F5 per avviare il debug.

Viene visualizzato Form1.
Nella casella Enter OrderID, digitare 10249, quindi fare clic su Order Details.

I prodotti inclusi nell'ordine 10249 vengono elencati in una finestra di messaggio.

Fare clic su OK per chiudere la finestra di messaggio.
Nella casella Enter CustomerID, digitare ALFKI, quindi fare clic su Order History.

Viene visualizzata una finestra di messaggio con l'elenco della cronologia degli ordini per il cliente ALFKI.

Fare clic su OK per chiudere la finestra di messaggio.
Nella casella Enter OrderID, digitare 123, quindi fare clic su Order Details.

Viene visualizzata una finestra di messaggio con l'indicazione che non è stato trovato alcun risultato.

Fare clic su OK per chiudere la finestra di messaggio.
Nel menu Debug, fare clic su Termina debug.

La sessione di debug viene chiusa.
Al termine delle prove è possibile fare clic su Chiudi progetto nel menu File e salvare il progetto quando viene richiesto.

Passaggi successivi

Questo progetto può essere migliorato apportandovi alcune modifiche. Ad esempio, è possibile elencare le stored procedure disponibili in una casella di riepilogo, in modo che l'utente possa selezionare quella da eseguire. È inoltre possibile trasmettere l'output dei rapporti a un file di testo.