SqlConnectionStringBuilder.Remove(String) Yöntem

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v6.0.2

Belirtilen anahtara sahip girişi örnekten SqlConnectionStringBuilder kaldırır.

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

Parametreler

keyword

String

Bu SqlConnectionStringBuilderiçindeki bağlantı dizesinden kaldırılacak anahtar/değer çiftinin anahtarı.

Döndürülenler

Boolean

true anahtar bağlantı dizesi içinde mevcutsa ve kaldırılmışsa; false anahtarı yoksa.

Özel durumlar

ArgumentNullException

keyword null (Nothing Visual Basic'te)

Örnekler

Aşağıdaki örnek, var olan bir bağlantı dizesini Windows Kimlik Doğrulaması'ndan tümleşik güvenliği kullanmaya dönüştürür. Örnek, bağlantı dizesinden kullanıcı adı ve parolayı kaldırıp nesnesinin IntegratedSecurity özelliğini SqlConnectionStringBuilder ayarlayarak çalışır.

Not

Bu örnek, bağlantı dizeleriyle nasıl SqlConnectionStringBuilder çalıştığını gösteren bir parola içerir. Uygulamalarınızda Windows Kimlik Doğrulaması kullanmanızı öneririz. Bir parola kullanmanız gerekiyorsa, uygulamanıza sabit kodlanmış bir parola eklemeyin.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        try
        {
            string connectString =
                "Data Source=(local);User ID=ab;Password=********;" +
                "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();
    }
}

Örnek, konsol penceresinde aşağıdaki metni görüntüler:

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

Açıklamalar

Remove yöntemi başarısını gösteren bir değer döndürdüğünden, anahtar/değer çiftini örnekten SqlConnectionStringBuilder kaldırmaya çalışmadan önce anahtar aramak gerekmez. SqlConnectionStringBuilder anahtar/değer çiftlerinden oluşan sabit boyutlu bir koleksiyonu sürdürdüğünden yöntemini çağırmakRemove, anahtar/değer çiftinin değerini varsayılan değerine geri döndürür.

tarafından SqlConnectionStringBuilder desteklenen anahtar koleksiyonu sabit olduğundan, koleksiyondaki her öğenin bilinen bir varsayılan değeri vardır. Aşağıdaki tabloda anahtarları ve ilk başlatıldığında veya yöntemi çağrıldıktan sonra Remove her SqlConnectionStringBuilder biri için değer listelenmiştir.

Anahtar	Varsayılan değer
Uygulama Adı	.NET Framework üzerinde çalışırken "Framework Microsoft SqlClient Veri Sağlayıcısı". "Core Microsoft SqlClient Veri Sağlayıcısı" aksi takdirde.
Attachdbfilename	Boş dize
Bağlantı Zaman Aşımı	15
Bağlam Bağlantısı (Eski)	Yanlış
Geçerli Dil	Boş dize
Veri Kaynağı	Boş dize
Şifreleme	4.0 öncesi sürümlerde False, 4.0 ve yukarı sürümlerde True
Askere	Doğru
Yük Devretme İş Ortağı	Boş dize
İlk Katalog	Boş dize
Tümleşik Güvenlik	Yanlış
Yük Dengeleme Zaman Aşımı	0
En Büyük Havuz Boyutu	100
En Düşük Havuz Boyutu	0
MultipleActiveResultSets	Yanlış
Ağ Kitaplığı	Boş dize
Paket Boyutu	8000
Parola	Boş dize
Güvenlik Bilgilerini Kalıcı Hale	Yanlış
Biriktirme	Doğru
Çoğaltma	Yanlış
İşlem Bağlama	Örtük Bağlamayı Kaldırma
Kullanıcı Kimliği	Boş dize
Kullanıcı Örneği	Yanlış
İş İstasyonu Kimliği	Boş dize