SqlConnectionStringBuilder.Remove(String) Metode

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.dll

Menghapus entri dengan kunci yang ditentukan dari instans SqlConnectionStringBuilder.

public:
 override bool Remove(System::String ^ keyword);

public override bool Remove (string keyword);

override this.Remove : string -> bool

Public Overrides Function Remove (keyword As String) As Boolean

Parameter

keyword

String

Kunci pasangan kunci/nilai yang akan dihapus dari string koneksi dalam SqlConnectionStringBuilderini .

Mengembalikan

Boolean

true jika kunci ada dalam string koneksi dan dihapus; false jika kunci tidak ada.

Pengecualian

ArgumentNullException

keyword null (Nothing di Visual Basic)

Contoh

Contoh berikut mengonversi string koneksi yang ada dari menggunakan Autentikasi SQL Server ke Autentikasi Windows (keamanan terintegrasi). Contohnya berfungsi dengan menghapus nama pengguna dan kata sandi dari string koneksi, lalu mengatur properti IntegratedSecurity objek SqlConnectionStringBuilder.

Peringatan

Microsoft tidak menyarankan untuk memberikan nama pengguna dan kata sandi Anda secara langsung, karena ini adalah pola yang tidak aman. Jika memungkinkan, gunakan alur autentikasi yang lebih aman, seperti identitas terkelola untuk sumber daya Azure, atau autentikasi Windows untuk SQL Server.

using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Data Source=(local);User ID=ab;Password=myPassw0rd;" +
                "Initial Catalog=AdventureWorks";

            SqlConnectionStringBuilder builder = new(connectString);
            Console.WriteLine($"Original: {builder.ConnectionString}");

            // Remove the User ID and Password.
            builder.Remove("User ID");
            builder.Remove("Password");

            // Enable integrated security.
            builder.IntegratedSecurity = true;

            Console.WriteLine($"Modified: {builder.ConnectionString}");
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }
}
/* This code example produces the following output:
 * Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password=myPassw0rd
 * Modified: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True
 */

    Dim connectString As String =
     "Data Source=(local);User ID=ab;Password=a1Pass@@11;" &
     "Initial Catalog=AdventureWorks"

    Dim builder As New SqlConnectionStringBuilder(connectString)
    Console.WriteLine("Original: " & builder.ConnectionString)

    ' Remove the user ID and password.
    builder.Remove("User ID")
    builder.Remove("Password")

    ' Turn on integrated security:
    builder.IntegratedSecurity = True

    Console.WriteLine("Modified: " & builder.ConnectionString)

Catch ex As Exception
    Console.WriteLine(ex.Message)
End Try

' This code produces the following output:
' Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password=a1Pass@@11
' Modified: Data Source = (local);Initial Catalog=AdventureWorks;Integrated Security=True

Keterangan

Karena metode Hapus mengembalikan nilai yang menunjukkan keberhasilannya, tidak perlu mencari kunci sebelum mencoba menghapus pasangan kunci/nilai dari instans SqlConnectionStringBuilder. Karena SqlConnectionStringBuilder mempertahankan kumpulan ukuran tetap pasangan kunci/nilai, memanggil metode Remove hanya mengatur ulang nilai pasangan kunci/nilai kembali ke nilai defaultnya.

Karena kumpulan kunci yang didukung oleh SqlConnectionStringBuilder diperbaiki, setiap item dalam koleksi memiliki nilai default yang diketahui. Tabel berikut mencantumkan kunci, dan nilai untuk masing-masing ketika SqlConnectionStringBuilder pertama kali diinisialisasi, atau setelah metode Remove dipanggil.

Kunci	Nilai default
Nama Aplikasi	".Net SqlClient Data Provider"
Pemrosesan Asinkron	Palsu
AttachDBFilename	String kosong
Batas Waktu Koneksi	15
Koneksi Konteks	Palsu
Bahasa Saat Ini	String kosong
Sumber Data	String kosong
Mengenkripsi	Palsu
Daftar enlist	Benar
Mitra Failover	String kosong
Katalog Awal	String kosong
Keamanan Terintegrasi	Palsu
Batas Waktu Keseimbangan Beban	0
Ukuran Kumpulan Maks	100
Ukuran Kumpulan Min	0
MultipleActiveResultSets	Palsu
Pustaka Jaringan	String kosong
Ukuran Paket	8000
Kata sandi	String kosong
Pertahankan Info Keamanan	Palsu
Penggabungan	Benar
Replikasi	Palsu
Pengikatan Transaksi	Unbind Implisit
ID Pengguna	String kosong
Instans Pengguna	Palsu
ID Stasiun Kerja	String kosong

Lihat juga

• String Koneksi di ADO.NET
• Gambaran Umum ADO.NET