Quickstart: .NET (C#) gebruiken om een query uit te voeren op een database
Van toepassing op: Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics
In deze quickstart gebruikt u .NET - en C#-code om verbinding te maken met een database. Vervolgens moet u een Transact-SQL-instructie uitvoeren om een query op gegevens uit te voeren. Deze quickstart is van toepassing op Windows, Linux en macOS en maakt gebruik van het geïntegreerde .NET-platform.
Fooi
Deze gratis Learn-module laat zien hoe u een ASP.NET-toepassing ontwikkelt en configureert waarmee een query wordt uitgevoerd op een database in Azure SQL Database
Vereisten
U hebt het volgende nodig om deze snelstartgids te voltooien:
Een Azure-account met een actief abonnement. Gratis een account maken
.NET SDK voor uw besturingssysteem geïnstalleerd.
Een database waarin u een query kunt uitvoeren.
U kunt een van deze quickstarts gebruiken om een database te maken en vervolgens te configureren:
Actie SQL Database SQL Managed Instance SQL Server op Azure VM Azure Synapse Analytics Maken Portal Portal Portal Portal CLI CLI PowerShell PowerShell PowerShell PowerShell Implementatiesjabloon Implementatiesjabloon Implementatiesjabloon Implementatiesjabloon Configureren IP-firewallregel op serverniveau Connectiviteit vanaf een VM instellingen voor Verbinding maken iviteit Connectiviteit vanaf on-premises Verbinding maken met een SQL Server-exemplaar Verbindingsgegevens ophalen Azure SQL Azure SQL SQL-VM Synapse SQL
Een nieuw .NET-project maken
Open een opdrachtprompt en maak een map met de naam sqltest. Navigeer naar deze map en voer deze opdracht uit.
dotnet new console
Met deze opdracht maakt u nieuwe app-projectbestanden, waaronder een eerste C#-codebestand (Program.cs), een XML-configuratiebestand (sqltest.csproj) en de benodigde binaire bestanden.
Voer deze opdracht uit vanaf de bovenstaande opdrachtprompt.
dotnet add package Microsoft.Data.SqlClient
Met deze opdracht wordt het
Microsoft.Data.SqlClient
pakket aan het project toegevoegd.
Code invoegen om query's uit te voeren op de database in Azure SQL Database
Open Program.cs in een teksteditor zoals Visual Studio Code.
Vervang de inhoud door de volgende code en voeg de juiste waarden toe voor de server, de database, de gebruikersnaam en het wachtwoord.
Notitie
Als u een ADO.NET-verbindingsreeks wilt gebruiken, vervangt u de vier regels in de code waarmee de server, de database, de gebruikersnaam en het wachtwoord worden ingesteld door de onderstaande regel. Stel in de verbindingsreeks uw gebruikersnaam en wachtwoord in.
builder.ConnectionString="<your_ado_net_connection_string>";
using Microsoft.Data.SqlClient;
namespace sqltest
{
class Program
{
static void Main(string[] args)
{
try
{
SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder();
builder.DataSource = "<your_server.database.windows.net>";
builder.UserID = "<your_username>";
builder.Password = "<your_password>";
builder.InitialCatalog = "<your_database>";
using (SqlConnection connection = new SqlConnection(builder.ConnectionString))
{
Console.WriteLine("\nQuery data example:");
Console.WriteLine("=========================================\n");
connection.Open();
String sql = "SELECT name, collation_name FROM sys.databases";
using (SqlCommand command = new SqlCommand(sql, connection))
{
using (SqlDataReader reader = command.ExecuteReader())
{
while (reader.Read())
{
Console.WriteLine("{0} {1}", reader.GetString(0), reader.GetString(1));
}
}
}
}
}
catch (SqlException e)
{
Console.WriteLine(e.ToString());
}
Console.WriteLine("\nDone. Press enter.");
Console.ReadLine();
}
}
}
De code uitvoeren
Voer in de prompt de volgende opdrachten uit.
dotnet restore dotnet run
Controleer of de rijen worden geretourneerd. De uitvoer kan andere waarden bevatten.
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.
Kies Enter om het toepassingsvenster te sluiten.
Volgende stappen
- Zelfstudie: Een .NET-consoletoepassing maken met Visual Studio Code.
- Meer informatie over het maken van verbinding met Azure SQL Database met behulp van Azure Data Studio in Windows/Linux/macOS.
- Meer informatie over ontwikkelen met .NET en SQL.
- Meer informatie over het verbinden en opvragen van Azure SQL Database of Azure SQL Managed Instance met behulp van .NET in Visual Studio.
- Meer informatie over het ontwerpen van uw eerste database met SSMS.
- Raadpleeg de .NET-documentatie voor meer informatie over .NET.