Schnellstart: Verwenden von .NET (C#) zum Abfragen einer Datenbank
Gilt für: Azure SQL-Datenbank Azure SQL Managed Instance Azure 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:
Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
.NET SDK für Ihr Betriebssystem ist installiert.
Eine Datenbank, in der Sie die Abfrage ausführen können.
In den folgenden Schnellstartanleitungen erfahren Sie jeweils, wie Sie eine Datenbank erstellen und anschließend konfigurieren:
Aktion SQL-Datenbank Verwaltete SQL-Instanz SQL Server auf Azure-VMs Azure Synapse Analytics Erstellen Portal Portal Portal Portal BEFEHLSZEILENSCHNITTSTELLE (CLI) BEFEHLSZEILENSCHNITTSTELLE (CLI) PowerShell PowerShell PowerShell PowerShell Bereitstellungsvorlage Bereitstellungsvorlage Bereitstellungsvorlage Bereitstellungsvorlage Konfigurieren IP-Firewallregel auf Serverebene Verbindung von einem virtuellen Computer Konnektivitätseinstellungen Verbindungen von lokalen Computern Herstellen einer Verbindung mit einer SQL Server-Instanz Abrufen von Verbindungsinformationen Azure SQL Azure SQL SQL-VM Synapse SQL
Erstellen eines neuen .NET-Projekts
Ö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.
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
Öffnen Sie Program.cs in einem Text-Editor wie Visual Studio Code.
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
Führen Sie an der Eingabeaufforderung die folgenden Befehle aus:
dotnet restore dotnet run
Ü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.
Drücken Sie die EINGABETASTE, um das Anwendungsfenster zu schließen.
Nächste Schritte
- Tutorial: Erstellen einer .NET-Konsolenanwendung mit Visual Studio Code
- Weitere Informationen finden Sie unter Verwenden von Azure Data Studio unter Windows/Linux/macOS zum Herstellen einer Verbindung mit Azure SQL-Datenbank.
- Weitere Informationen finden Sie unter Entwickeln mit .NET und SQL.
- Weitere Informationen finden Sie unter Verwenden von .NET in Visual Studio, um eine Verbindung mit Azure SQL-Datenbank oder Azure SQL Managed Instance herzustellen und diese abzufragen.
- Weitere Informationen finden Sie unterEntwerfen Ihrer ersten Datenbank mit SSMS.
- Weitere Informationen zu .NET finden Sie in der .NET-Dokumentation.
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für