Avvio rapido: usare .NET (C#) per eseguire query su un database
Si applica a: Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics
In questa guida di avvio rapido si useranno .NET e il codice C# per la connessione a un database. Si eseguirà quindi un'istruzione Transact-SQL per eseguire query sui dati. Questa guida introduttiva è applicabile a Windows, Linux e macOS, e sfrutta la piattaforma .NET unificata.
Suggerimento
Questo modulo gratuito di Learn contiene informazioni su come Sviluppare e configurare un'applicazione ASP.NET che esegue query su un database SQL di Azure.
Prerequisiti
Per completare l'esercitazione introduttiva, sono necessari gli elementi seguenti:
Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
.NET SDK per il sistema operativo installato.
Un database in cui sia possibile eseguire la query.
Per creare, quindi configurare un database è possibile usare una di queste guide di avvio rapido:
Azione Database SQL Istanza gestita di SQL SQL Server in una macchina virtuale Azure Azure Synapse Analytics Creazione Portale Portale Portale Portale CLI CLI PowerShell PowerShell PowerShell PowerShell Modello di distribuzione Modello di distribuzione Modello di distribuzione Modello di distribuzione Configurare Regola del firewall IP a livello di server Connettività da una VM Impostazioni della connettività Connettività dall'ambiente locale Connettersi a un'istanza di SQL Server Ottenere informazioni di connessione Azure SQL Azure SQL VM SQL Synapse SQL
Creare un nuovo progetto .NET
Aprire un prompt dei comandi e creare una cartella denominata sqltest. Passare a questa cartella ed eseguire questo comando.
dotnet new console
Vengono creati nuovi file di progetto dell'app, inclusi un iniziale file di codice C# (Program.cs), un file di configurazione XML (sqltest. csproj) e i file binari necessari.
Nel prompt dei comandi di cui sopra eseguire questo comando:
dotnet add package Microsoft.Data.SqlClient
Questo comando aggiunge il pacchetto
Microsoft.Data.SqlClient
al progetto.
Inserire il codice per eseguire query sul database nel database SQL di Azure
In un editor di testo, ad esempio Visual Studio Code, aprire Program.cs.
Sostituire il contenuto con il codice seguente e aggiungere i valori appropriati per il server, il database, il nome utente e la password.
Nota
Per usare una stringa di connessione ADO.NET, sostituire le 4 righe di codice impostando server, database, nome utente e password con la riga seguente. Immettere il proprio nome utente e la password.
builder.ConnectionString="<your_ado_net_connection_string>";
using Microsoft.Data.SqlClient;
using System;
using System.Threading.Tasks;
namespace sqltest
{
class Program
{
static async Task Main(string[] args)
{
var builder = new SqlConnectionStringBuilder
{
DataSource = "<your_server.database.windows.net>",
UserID = "<your_username>",
Password = "<your_password>",
InitialCatalog = "<your_database>"
};
var connectionString = builder.ConnectionString;
try
{
await using var connection = new SqlConnection(connectionString);
Console.WriteLine("\nQuery data example:");
Console.WriteLine("=========================================\n");
await connection.OpenAsync();
var sql = "SELECT name, collation_name FROM sys.databases";
await using var command = new SqlCommand(sql, connection);
await using var reader = await command.ExecuteReaderAsync();
while (await reader.ReadAsync())
{
Console.WriteLine("{0} {1}", reader.GetString(0), reader.GetString(1));
}
}
catch (SqlException e) when (e.Number == /* specific error number */)
{
Console.WriteLine($"SQL Error: {e.Message}");
}
catch (Exception e)
{
Console.WriteLine(e.ToString());
}
Console.WriteLine("\nDone. Press enter.");
Console.ReadLine();
}
}
}
Ricordarsi di sostituire <your_server.database.windows.net>
, <your_username>
, <your_password>
e <your_database>
con i dettagli effettivi di SQL Server. Sostituire anche /* specific error number */
con il numero errore SQL effettivo che si vuole gestire.
Eseguire il codice
Al prompt eseguire i seguenti comandi.
dotnet restore dotnet run
Verificare che le righe vengano restituite; l'output può includere altri valori.
Query data example: ========================================= master SQL_Latin1_General_CP1_CI_AS tempdb SQL_Latin1_General_CP1_CI_AS WideWorldImporters Latin1_General_100_CI_AS Done. Press enter.
Scegliere INVIO per chiudere la finestra dell'applicazione.
Contenuto correlato
- Esercitazione: Creare un'applicazione console .NET con Visual Studio Code
- connettersi a un database SQL di Azure usando Azure Data Studio su Windows/Linux/macOS
- sviluppo con .NET e SQL
- connettersi ed eseguire query su un database SQL di Azure o un'Istanza gestita di SQL di Azure usando .NET in Visual Studio
- Progettare il primo database con SSMS
- Documentazione di .NET