Quickstart: .NET (C#) gebruiken om een query uit te voeren op een database

  • Artikel

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 nieuw .NET-project maken

  1. 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.

  2. 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

  1. Open Program.cs in een teksteditor zoals Visual Studio Code.

  2. 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

  1. Voer in de prompt de volgende opdrachten uit.

    dotnet restore
dotnet run

  2. 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.

  3. Kies Enter om het toepassingsvenster te sluiten.

Volgende stappen