Schnellstart: Verwenden von .NET (C#) zum Abfragen einer Datenbank

Gilt für:Azure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse Analytics

In dieser Schnellstartanleitung verwenden Sie .NET und C#-Code, um eine Verbindung mit einer Datenbank herzustellen. Anschließend führen Sie eine Transact-SQL-Anweisung zum Abfragen von Daten aus. Diese Schnellstartanleitung gilt für Windows, Linux und macOS unter Verwendung der einheitlichen .NET-Plattform.

Tipp

In diesem kostenlosen Learn-Modul wird Folgendes gezeigt: Entwickeln und Konfigurieren einer ASP.NET-Anwendung zum Abfragen einer Azure SQL-Datenbank

Voraussetzungen

Für die Durchführung dieses Schnellstarts benötigen Sie Folgendes:

Erstellen eines neuen .NET-Projekts

  1. Öffnen Sie eine Eingabeaufforderung, und erstellen Sie einen Ordner namens sqltest. Navigieren Sie zu diesem Ordner, und führen Sie den folgenden Befehl aus:

    dotnet new console
    

    Mit diesem Befehl werden neue App-Projektdateien erstellt, darunter eine erste C#-Codedatei (Program.cs), eine XML-Konfigurationsdatei (sqltest.csproj) und erforderliche Binärdateien.

  2. Führen Sie an der oben verwendeten Eingabeaufforderung den folgenden Befehl aus.

    dotnet add package Microsoft.Data.SqlClient
    

    Mit diesem Befehl wird dem Projekt das Paket Microsoft.Data.SqlClient hinzugefügt.

Einfügen von Code zum Abfragen der Datenbank in Azure SQL-Datenbank

  1. Öffnen Sie Program.cs in einem Text-Editor wie Visual Studio Code.

  2. Ersetzen Sie den Inhalt durch den folgenden Code, und fügen Sie die entsprechenden Werte für Server, Datenbank, Benutzername und Kennwort hinzu.

Hinweis

Um eine ADO.NET-Verbindungszeichenfolge zu verwenden, ersetzen Sie die 4 Zeilen in der Codeeinstellung von Server, Datenbank, Benutzername und Kennwort durch die folgende Zeile. Geben Sie in der Zeichenfolge Ihren Benutzernamen und Ihr Kennwort ein.

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(); 
        }
    }
}

Ausführen des Codes

  1. Führen Sie an der Eingabeaufforderung die folgenden Befehle aus:

    dotnet restore
    dotnet run
    
  2. Überprüfen Sie, ob die Zeilen zurückgegeben werden. Ihre Ausgabe kann andere Werte enthalten.

    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. Drücken Sie die EINGABETASTE, um das Anwendungsfenster zu schließen.

Nächste Schritte