SqlConnectionStringBuilder.Remove(String) Metode

  • Referensi

Definisi

Ruang nama:
System.Data.SqlClient
Rakitan:
System.Data.SqlClient.dll
Rakitan:
System.Data.dll
Paket:
System.Data.SqlClient v4.8.6

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

Berlaku untuk

Lihat juga