SqlConnectionStringBuilder.Remove(String) Yöntem

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.dll

Belirtilen anahtara sahip girdiyi ö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ı dizesi kaldırılacak anahtar/değer çiftinin anahtarı.

Döndürülenler

Boolean

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

Özel durumlar

ArgumentNullException

keyword is null (Nothing Visual Basic'te)

Örnekler

Aşağıdaki örnek, mevcut bir bağlantı dizesi Windows Kimlik Doğrulamasını kullanmaktan tümleşik güvenliği kullanmaya dönüştürür. Örnek, kullanıcı adını ve parolayı bağlantı dizesi kaldırıp nesnenin IntegratedSecuritySqlConnectionStringBuilder özelliğini 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 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

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

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

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 koleksiyon bulundurduğu için yöntemini çağırmakRemove, anahtar/değer çiftinin değerini varsayılan değerine geri sıfırlar.

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 her SqlConnectionStringBuilder birinin değeri ilk başlatıldığında veya yöntem çağrıldıktan sonra Remove 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
Encrypt	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ış
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

Ayrıca bkz.

• ADO.NET'da Bağlantı Dizeleri
• ADO.NET’e Genel Bakış