SqlConnectionStringBuilder.ContainsKey(String) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет, содержит ли объект SqlConnectionStringBuilder указанный ключ.
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.
Возвращаемое значение
Значение true
, если в SqlConnectionStringBuilder содержится элемент с указанным ключом; в противном случае — значение false
.
Исключения
Параметр keyword
является пустой ссылкой (Nothing
в Visual Basic).
Примеры
В следующем примере создается SqlConnectionStringBuilder экземпляр , задаются некоторые его свойства, а затем пытается определить, существуют ли в объекте различные ключи, путем вызова метода ContainsKey .
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
В этом примере в окне консоли отображаются следующие выходные данные:
Connection string = Data Source=(local);Initial Catalog=AdventureWorks;Integrated Security=True
True
True
True
False
Комментарии
Поскольку класс SqlConnectionStringBuilder содержит коллекцию пар «ключ-значение» фиксированного размера, метод ContainsKey определяет только то, является ли данное имя ключа допустимым.