SqlConnectionStringBuilder.ContainsKey(String) Метод

Определение

Определяет, содержит ли объект SqlConnectionStringBuilder указанный ключ.Determines whether the SqlConnectionStringBuilder contains a specific key.

public:
 override bool ContainsKey(System::String ^ keyword);
public override bool ContainsKey (string keyword);
override this.ContainsKey : string -> bool
Public Overrides Function ContainsKey (keyword As String) As Boolean

Параметры

keyword
String

Ключ, который требуется найти в SqlConnectionStringBuilder.The key to locate in the SqlConnectionStringBuilder.

Возвращаемое значение

Значение true, если в SqlConnectionStringBuilder содержится элемент с указанным ключом; в противном случае — значение false.true if the SqlConnectionStringBuilder contains an element that has the specified key; otherwise, false.

Исключения

Параметр keyword является пустой ссылкой (Nothing в Visual Basic).keyword is null (Nothing in Visual Basic)

Примеры

В следующем примере создается экземпляр SqlConnectionStringBuilder, устанавливаются некоторые его свойства, а затем производится попытка определить, существуют ли в объекте различные ключи путем вызова метода ContainsKey .The following example creates a SqlConnectionStringBuilder instance, sets some of its properties, and then tries to determine whether various keys exist within the object by calling the ContainsKey method.

using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        SqlConnectionStringBuilder builder =
            new SqlConnectionStringBuilder(GetConnectionString());
        Console.WriteLine("Connection string = " + builder.ConnectionString);

        // Keys you have provided return true.
        Console.WriteLine(builder.ContainsKey("Server"));

        // Comparison is case insensitive, and synonyms
        // are automatically converted to their "well-known"
        // names.
        Console.WriteLine(builder.ContainsKey("Database"));

        // Keys that are valid but have not been set return true.
        Console.WriteLine(builder.ContainsKey("Max Pool Size"));

        // Keys that do not exist return false.
        Console.WriteLine(builder.ContainsKey("MyKey"));

        Console.WriteLine("Press Enter to continue.");
        Console.ReadLine();

    }

    private static string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file. 
        return "Server=(local);Integrated Security=SSPI;" +
            "Initial Catalog=AdventureWorks";
    }
}
Imports System.Data.SqlClient

Module Module1
    Sub Main()
        Dim builder As _
         New SqlConnectionStringBuilder(GetConnectionString())
        Console.WriteLine("Connection string = " & builder.ConnectionString)

        ' Keys you have provided return true.
        Console.WriteLine(builder.ContainsKey("Server"))

        ' Comparison is case insensitive, and synonyms
        ' are automatically converted to their "well-known"
        ' names.
        Console.WriteLine(builder.ContainsKey("Database"))

        ' Keys that are valid but have not been set return true.
        Console.WriteLine(builder.ContainsKey("Max Pool Size"))

        ' Keys that do not exist return false.
        Console.WriteLine(builder.ContainsKey("MyKey"))

        Console.WriteLine("Press Enter to continue.")
        Console.ReadLine()
    End Sub

    Private Function GetConnectionString() As String
        ' To avoid storing the connection string in your code,
        ' you can retrieve it from a configuration file. 
        Return "Server=(local);Integrated Security=SSPI;" & _
          "Initial Catalog=AdventureWorks"
    End Function
End Module

В этом примере в окне консоли отображаются следующие выходные данные:The example displays the following output in the console window:

Connection string = Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True  
True  
True  
True  
False  

Комментарии

Поскольку класс SqlConnectionStringBuilder содержит коллекцию пар «ключ-значение» фиксированного размера, метод ContainsKey определяет только то, является ли данное имя ключа допустимым.Because the SqlConnectionStringBuilder contains a fixed-size collection of key/value pairs, the ContainsKey method determines only if a particular key name is valid.

Применяется к

Дополнительно