SqlConnectionStringBuilder.ApplicationName Properti

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Mendapatkan atau mengatur nama aplikasi yang terkait dengan string koneksi.

public:
 property System::String ^ ApplicationName { System::String ^ get(); void set(System::String ^ value); };

public string ApplicationName { get; set; }

member this.ApplicationName : string with get, set

Public Property ApplicationName As String

Nilai Properti

String

Nama aplikasi. Jika tidak ada nama yang diberikan, "Framework Microsoft SqlClient Data Provider" saat berjalan di .NET Framework dan "Core Microsoft SqlClient Data Provider" sebaliknya.

Pengecualian

ArgumentNullException

Untuk mengatur nilai ke null, gunakan Value.

Contoh

Contoh berikut membuat baru SqlConnectionStringBuilder dan menetapkan string koneksi di konstruktor objek. Kode menampilkan versi string koneksi yang diurai dan dibuat ulang, lalu memodifikasi ApplicationName properti objek. Terakhir, kode menampilkan string koneksi baru, termasuk pasangan kunci/nilai baru.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString = "Server=(local);Initial Catalog=AdventureWorks;" +
                "Integrated Security=true";
            SqlConnectionStringBuilder builder =
                new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Original: " + builder.ConnectionString);
            Console.WriteLine("ApplicationName={0}",
                builder.ApplicationName);

            builder.ApplicationName = "My Application";
            Console.WriteLine("Modified: " + builder.ConnectionString);

            Console.WriteLine("Press any key to finish.");
            Console.ReadLine();

        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}

Sampel menampilkan teks berikut di jendela konsol:

Original: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True  
ApplicationName="Core Microsoft SqlClient Data Provider"  
Modified: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True;Application Name="My Application"  

Keterangan

Properti ini sesuai dengan kunci "Nama Aplikasi" dan "aplikasi" dalam string koneksi.

Nama aplikasi bisa 128 karakter atau kurang.