SqlConnectionStringBuilder.Remove(String) Metode

Definisi

Ruang nama:

Microsoft.Data.SqlClient

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Menghapus entri dengan kunci yang ditentukan dari SqlConnectionStringBuilder instans.

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 di ini SqlConnectionStringBuilder.

Mengembalikan

Boolean

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

Pengecualian

ArgumentNullException

keyword null (Nothing dalam Visual Basic)

Contoh

Contoh berikut mengonversi string koneksi yang ada dari menggunakan Autentikasi Windows menjadi menggunakan keamanan terintegrasi. Contohnya bekerja dengan menghapus nama pengguna dan kata sandi dari string koneksi, lalu mengatur IntegratedSecurity properti SqlConnectionStringBuilder objek.

Catatan

Contoh ini mencakup kata sandi untuk menunjukkan cara SqlConnectionStringBuilder kerja dengan string koneksi. Di aplikasi Anda, kami sarankan Anda menggunakan Autentikasi Windows. Jika Anda harus menggunakan kata sandi, jangan sertakan kata sandi yang dikodekan secara permanen di aplikasi Anda.

using Microsoft.Data.SqlClient;

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

            SqlConnectionStringBuilder builder = new SqlConnectionStringBuilder(connectString);
            Console.WriteLine("Original: " + builder.ConnectionString);

            // Use the Remove method
            // in order to reset the user ID and password back to their
            // default (empty string) values. 
            builder.Remove("User ID");
            builder.Remove("Password");

            // Turn on integrated security:
            builder.IntegratedSecurity = true;

            Console.WriteLine("Modified: " + builder.ConnectionString);

            using (SqlConnection
                       connection = new SqlConnection(builder.ConnectionString))
            {
                connection.Open();
                // Now use the open connection.
                Console.WriteLine("Database = " + connection.Database);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }

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

Contoh menampilkan teks berikut di jendela konsol:

Original: Data Source=(local);Initial Catalog=AdventureWorks;User ID=ab;Password= a1Pass@@11  
Modified: Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True  
Database = AdventureWorks  

Keterangan

Karena metode Hapus mengembalikan nilai yang menunjukkan keberhasilannya, tidak perlu mencari kunci sebelum mencoba menghapus pasangan kunci/nilai dari SqlConnectionStringBuilder instans. SqlConnectionStringBuilder Karena mempertahankan kumpulan pasangan kunci/nilai ukuran tetap, memanggil Remove metode 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 Remove metode dipanggil.

Kunci	Nilai default
Nama Aplikasi	"Framework Microsoft SqlClient Data Provider" saat berjalan di .NET Framework. "Inti Penyedia Data Microsoft SqlClient" jika tidak.
AttachDBFilename	String kosong
Waktu Tunggu Koneksi Habis	15
Koneksi Konteks(Usang)	FALSE
Bahasa Saat Ini	String kosong
Sumber Data.	String kosong
Mengenkripsi	False dalam versi sebelum 4.0, True dalam versi 4.0 ke atas
Daftar	True
Mitra Failover	String kosong
Katalog Awal	String kosong
Keamanan Terintegrasi	FALSE
Batas Waktu Keseimbangan Beban	0
Ukuran Kumpulan Maks	100
Ukuran Kumpulan Min	0
MultipleActiveResultSets	FALSE
Pustaka Jaringan	String kosong
Ukuran Paket	8000
Kata sandi	String kosong
Pertahankan Info Keamanan	FALSE
Penggabungan	True
Replikasi	FALSE
Pengikatan Transaksi	Terikat secara implisit
ID Pengguna	String kosong
Instans Pengguna	FALSE
ID Stasiun Kerja	String kosong