SqlConnectionStringBuilder.Remove(String) Metoda

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.dll

Odebere z instance položku se zadaným SqlConnectionStringBuilder klíčem.

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

Parametry

keyword

String

Klíč dvojice klíč/hodnota, který se má odebrat z připojovací řetězec v tomto SqlConnectionStringBuildersouboru .

Návraty

Boolean

truepokud klíč existoval v rámci připojovací řetězec a byl odebrán; false pokud klíč neexistoval.

Výjimky

ArgumentNullException

keyword is null (Nothing v jazyce Visual Basic)

Příklady

Následující příklad převede existující připojovací řetězec z ověřování systému Windows na použití integrovaného zabezpečení. Příklad funguje tak, že odebere uživatelské jméno a heslo z připojovací řetězec a pak nastaví IntegratedSecurity vlastnost objektuSqlConnectionStringBuilder.

Poznámka

Tento příklad obsahuje heslo, které ukazuje, jak SqlConnectionStringBuilder funguje s připojovacími řetězci. Ve vašich aplikacích doporučujeme používat ověřování systému Windows. Pokud je nutné použít heslo, nevkládejte do své aplikace pevně zakódované heslo.

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

V příkladu se v okně konzoly zobrazí následující text:

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

Poznámky

Vzhledem k tomu, Že Metoda Remove vrátí hodnotu, která označuje její úspěch, není nutné hledat klíč před pokusem o odebrání páru klíč-hodnota z SqlConnectionStringBuilder instance. Vzhledem k tomu, že SqlConnectionStringBuilder objekt udržuje kolekci párů klíč/hodnota s pevnou velikostí, volání Remove metody jednoduše resetuje hodnotu páru klíč/hodnota zpět na výchozí hodnotu.

Vzhledem k tomu, že kolekce klíčů podporovaných parametrem SqlConnectionStringBuilder je pevná, má každá položka v kolekci známou výchozí hodnotu. Následující tabulka obsahuje seznam klíčů a hodnoty pro každý z nich při SqlConnectionStringBuilder první inicializaci nebo po Remove zavolání metody.

Klíč	Výchozí hodnota
Název aplikace	"Zprostředkovatel dat .Net SqlClient"
Asynchronní zpracování	Ne
Attachdbfilename	Prázdný řetězec
Časový limit připojení	15
Kontextové připojení	Ne
Aktuální jazyk	Prázdný řetězec
Zdroj dat	Prázdný řetězec
Encrypt	Ne
Zařazení	Ano
Partner pro převzetí služeb při selhání	Prázdný řetězec
Počáteční katalog	Prázdný řetězec
Integrované zabezpečení	Ne
Vypršení časového limitu vyrovnávání zatížení	0
Maximální velikost fondu	100
Minimální velikost fondu	0
MultipleActiveResultSets	Ne
Síťová knihovna	Prázdný řetězec
Velikost paketu	8000
Heslo	Prázdný řetězec
Zachování bezpečnostních údajů	Ne
Sdružování	Ano
Replikace	Ne
Vazba transakce	Implicitní zrušení vazby
ID uživatele	Prázdný řetězec
Instance uživatele	Ne
ID pracovní stanice	Prázdný řetězec

Viz také

• Připojovací řetězce v ADO.NET
• Přehled ADO.NET