التشغيل السريع: استخدام .NET Core (C#) للاستعلام عن قاعدة بيانات
ينطبق على:قاعدة بيانات Azure SQL مثيل Azure SQL المُدار Azure Synapse Analytics
في هذا التشغيل السريع، ستستخدم التعليمات البرمجية .NET Core وC# للاتصال بقاعدة بيانات. ثم ستقوم بتشغيل عبارة Transact-SQL للاستعلام عن البيانات.
تلميح
تساعدك وحدة Microsoft Learn التالية على تعلم كيفية تطوير وتكوين تطبيق ASP.NET يستعلم عن قاعدة بيانات في Azure SQL Database مجانًا
المتطلبات الأساسية
للتشغيل السريع، تحتاج إلى:
حساب Azure باشتراك نشط. إنشاء حساب مجاناً.
قاعدة بيانات حيث يمكنك تشغيل الاستعلام الخاص بك.
يمكنك استخدام إحدى هذه الخطوات السريعة لإنشاء قاعدة بيانات ثم تكوينها:
إجراء قاعدة بيانات SQL مثيل SQL المدار SQL Server على Azure VM Azure Synapse Analytics إنشاء المدخل المدخل المدخل المدخل CLI CLI PowerShell PowerShell PowerShell PowerShell قالب النشر قالب النشر تكوين قاعدة جدار حماية IP على مستوى الخادم الاتصال من جهاز ظاهري الاتصال من أماكن محلية الاتصال بمثيل SQL Server الحصول على معلومات الاتصال Azure SQL Azure SQL SQL VM Synapse SQL
إنشاء مشروع .NET Core جديد
افتح موجه الأوامر، وقم بإنشاء مجلد يسمى sqltest. انتقل إلى هذا المجلد، ثم قم بتشغيل هذا الأمر.
dotnet new console
ينشئ هذا الأمر ملفات مشروع تطبيق جديد، بما في ذلك ملف أولي للتعليمات البرمجية C# (Program.cs)، وملف تكوين XML (sqltest.csproj)، وثنائيات مطلوبة.
في محرر النصوص، افتح sqltest.csproj، والصق XML التالية بين علامات
<Project>
. يضيف XML هذاSystem.Data.SqlClient
كتبعية.<ItemGroup> <PackageReference Include="System.Data.SqlClient" Version="4.6.0" /> </ItemGroup>
إدراج تعليمات برمجية للاستعلام عن قاعدة البيانات في Azure SQL Database
في محرر النصوص، افتح Program.cs.
استبدل المحتويات بالرمز التالي وأضف القيم المناسبة لخادمك وقاعدة بياناتك واسم المستخدم وكلمة المرور.
ملاحظة
لاستخدام سلسلة اتصال ADO.NET، استبدل الأسطر الأربعة في رمز إعداد الخادم وقاعدة البيانات واسم المستخدم وكلمة المرور بالسطر أدناه. في السلسلة، قم بتعيين اسم المستخدم وكلمة المرور.
builder.ConnectionString="<your_ado_net_connection_string>";
using System;
using System.Data.SqlClient;
using System.Text;
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();
}
}
}
تشغيل التعليمات البرمجية
في الموجه، قم بتشغيل الأوامر التالية.
dotnet restore dotnet run
تحقق من أن يتم إرجاع الصفوف.
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.
اختر Enter لإغلاق نافذة التطبيق.
الخطوات التالية
- الشروع في العمل مع .NET Core على أنظمة التشغيل Windows / Linux / macOS باستخدام سطر الأوامر.
- تعرف على كيفية الاتصال بـ Azure SQL Database أو Azure SQL Managed Instance والاستعلام عنها باستخدام .NET Framework وVisual Studio.
- تعلم كيفية تصميم قاعدة البيانات الأولى مع SSMS أو تصميم قاعدة بيانات والاتصال بـ C# وADO.NET.
- لمزيد من المعلومات حول .NET، راجع وثائق .NET.