SqlConnectionStringBuilder.Remove(String) Metoda

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

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

Návraty

Boolean

true pokud klíč existoval v rámci připojovacího řetězce a byl odebrán; false pokud klíč neexistuje.

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ího řetězce a pak nastaví IntegratedSecurity vlastnost objektu SqlConnectionStringBuilder .

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 Microsoft.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();
    }
}

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	"Framework Microsoft SqlClient Data Provider" při spuštění v rozhraní .NET Framework. V opačném případě se jedná o základní zprostředkovatele dat Microsoft SqlClient.
Attachdbfilename	Prázdný řetězec
Časový limit připojení	15
Kontextové připojení (zastaralé)	Ne
Aktuální jazyk	Prázdný řetězec
Zdroj dat	Prázdný řetězec
Šifrování	False ve verzích starších než 4.0, Pravda ve verzích 4.0 a novějších
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