SqlConnectionStringBuilder.Remove(String) Metoda

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.dll

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

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íč páru klíč/hodnota, který se má odebrat z připojovacího řetězce v tomto SqlConnectionStringBuilder.

Návraty

Boolean

true, pokud klíč existoval v připojovacím řetězci a byl odebrán; false, pokud klíč neexistuje.

Výjimky

ArgumentNullException

keyword má hodnotu null (Nothing v jazyce Visual Basic)

Příklady

Následující příklad převede existující připojovací řetězec z použití ověřování SQL Serveru na ověřování systému Windows (integrované zabezpečení). Příklad funguje odebráním uživatelského jména a hesla z připojovacího řetězce a následným nastavením vlastnosti IntegratedSecurity objektu SqlConnectionStringBuilder.

Varování

Microsoft nedoporučuje zadat vaše uživatelské jméno a heslo přímo, protože se jedná o nezabezpečený vzor. Pokud je to možné, používejte bezpečnější toky ověřování, jako jsou spravované identity pro prostředky Azurenebo ověřování systému Windows pro SQL Server.

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

Poznámky

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

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

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

Viz také

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