SqlConnectionStringBuilder.Remove(String) Metode

Definisi

Ruang nama:

System.Data.SqlClient

Rakitan:

System.Data.dll

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

Mengembalikan

Boolean

truejika 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 berfungsi 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 System.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();
    }
}

Imports System.Data.SqlClient
    
Module Module1
  Sub Main()
    Try
      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)

      ' 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 connection As New SqlConnection(builder.ConnectionString)
        connection.Open()
        ' Now use the open connection.
        Console.WriteLine("Database = " & connection.Database)
      End Using

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

    Console.WriteLine("Press any key to finish.")
    Console.ReadLine()
  End Sub
End Module

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 mereset 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	"Penyedia Data.Net SqlClient"
Pemrosesan Asinkron	FALSE
AttachDBFilename	String kosong
Waktu Tunggu Koneksi Habis	15
Koneksi Konteks	FALSE
Bahasa Saat Ini	String kosong
Sumber Data.	String kosong
Encrypt	Salah
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	Salah
Penggabungan	True
Replikasi	Salah
Pengikatan Transaksi	Terikat secara implisit
ID Pengguna	String kosong
Instans Pengguna	FALSE
ID Stasiun Kerja	String kosong

Lihat juga

• String Koneksi dalam ADO.NET
• Ringkasan ADO.NET