SqlConnectionStringBuilder.Remove(String) Yöntem

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.SqlClient.dll

Paket:

System.Data.SqlClient v4.9.0

Kaynak:

System.Data.SqlClient.notsupported.cs

Belirtilen anahtara sahip girişi SqlConnectionStringBuilder örneğinden 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 SqlConnectionStringBuilderbağlantı dizesinden kaldırılacak anahtar/değer çiftinin anahtarı.

Döndürülenler

Boolean

Anahtarın bağlantı dizesi içinde mevcut olup olmadığını ve kaldırılıp kaldırılmadığını true; Anahtarın mevcut olup olmadığını false.

Özel durumlar

ArgumentNullException

keyword null ( Visual Basic'teNothing)

Örnekler

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

Uyarı

Microsoft, güvenli olmayan bir desen olduğundan kullanıcı adınızı ve parolanızı doğrudan sağlamanızı önermez. Mümkün olduğunda,Azure kaynakları için Yönetilen Kimlikler veya SQL Server için Windows kimlik doğrulaması gibi daha güvenli kimlik doğrulama akışları kullanın.

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

Açıklamalar

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

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

Anahtar	Varsayılan değer
Uygulama Adı	".Net SqlClient Veri Sağlayıcısı"
Zaman Uyumsuz İşleme	Yanlış
AttachDBFilename	Boş dize
Bağlantı Zaman Aşımı	15
Bağlam Bağlantısı	Yanlış
Geçerli Dil	Boş dize
Veri Kaynağı	Boş dize
Şifrelemek	Yanlış
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ış
Havuzu	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

Ayrıca bkz.

• ADO.NET'da Bağlantı Dizelerini
• ADO.NET Genel Bakış