التشغيل السريع: استخدام ‎.NET Core (C#) للاستعلام عن قاعدة بيانات

ينطبق على:قاعدة بيانات Azure SQL مثيل Azure SQL المُدار Azure Synapse Analytics

في هذا التشغيل السريع، ستستخدم التعليمات البرمجية ‎.NET Core وC# للاتصال بقاعدة بيانات. ثم ستقوم بتشغيل عبارة Transact-SQL للاستعلام عن البيانات.

تلميح

تساعدك وحدة Microsoft Learn التالية على تعلم كيفية تطوير وتكوين تطبيق ASP.NET يستعلم عن قاعدة بيانات في Azure SQL Database مجانًا

المتطلبات الأساسية

للتشغيل السريع، تحتاج إلى:

إنشاء مشروع ‎.NET Core جديد

  1. افتح موجه الأوامر، وقم بإنشاء مجلد يسمى sqltest. انتقل إلى هذا المجلد، ثم قم بتشغيل هذا الأمر.

    dotnet new console
    

    ينشئ هذا الأمر ملفات مشروع تطبيق جديد، بما في ذلك ملف أولي للتعليمات البرمجية C# ‏(Program.cs)، وملف تكوين XML ‏(sqltest.csproj)، وثنائيات مطلوبة.

  2. في محرر النصوص، افتح sqltest.csproj، والصق XML التالية بين علامات <Project>. يضيف XML هذا System.Data.SqlClient كتبعية.

    <ItemGroup>
        <PackageReference Include="System.Data.SqlClient" Version="4.6.0" />
    </ItemGroup>
    

إدراج تعليمات برمجية للاستعلام عن قاعدة البيانات في Azure SQL Database

  1. في محرر النصوص، افتح Program.cs.

  2. استبدل المحتويات بالرمز التالي وأضف القيم المناسبة لخادمك وقاعدة بياناتك واسم المستخدم وكلمة المرور.

ملاحظة

لاستخدام سلسلة اتصال 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(); 
        }
    }
}

تشغيل التعليمات البرمجية

  1. في الموجه، قم بتشغيل الأوامر التالية.

    dotnet restore
    dotnet run
    
  2. تحقق من أن يتم إرجاع الصفوف.

    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. اختر Enter لإغلاق نافذة التطبيق.

الخطوات التالية