OdbcConnectionStringBuilder.TryGetValue Method
Retrieves a value corresponding to the supplied key from this OdbcConnectionStringBuilder.
Assembly: System.Data (in System.Data.dll)
Parameters
- keyword
- Type: System.String
The key of the item to retrieve.
- value
- Type: System.Object%
The value corresponding to keyword.
Return Value
Type: System.Booleantrue if keyword was found within the connection string; otherwise false.
The TryGetValue method lets developers safely retrieve a value from a OdbcConnectionStringBuilder without needing to verify that the supplied key name is a valid key name. Because TryGetValue does not raise an exception when you pass in a nonexistent key, you do not have to look for a key before retrieving its value. Calling TryGetValue with a nonexistent key places the value null (Nothing in Visual Basic) in the value parameter.
The following example demonstrates the behavior of the TryGetValue method.
using System.Data.Odbc; class Program { static void Main() { OdbcConnectionStringBuilder builder = new OdbcConnectionStringBuilder(); builder.ConnectionString = GetConnectionString(); // Call TryGetValue method for multiple // key names. Demonstrate that the search is not // case sensitive. DisplayValue(builder, "Driver"); DisplayValue(builder, "SERVER"); // How about a property you did not set? DisplayValue(builder, "DNS"); // Invalid keys? DisplayValue(builder, "Invalid Key"); // Null values? DisplayValue(builder, null); Console.WriteLine("Press any key 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 using the // System.Configuration.ConfigurationSettings.AppSettings property. return "Driver={SQL Server};Server=(local);" + "Database=AdventureWorks;Trusted_Connection=yes;"; } private static void DisplayValue(OdbcConnectionStringBuilder builder, string key) { object value = null; // Although TryGetValue handles missing keys, // it does not handle passing in a null (Nothing in Visual Basic) // key. This example traps for that particular error, but // throws any other unknown exceptions back out to the // caller. try { if (builder.TryGetValue(key, out value)) { Console.WriteLine("{0}='{1}'", key, value); } else { Console.WriteLine("Unable to retrieve value for '{0}'", key); } } catch (ArgumentNullException ex) { Console.WriteLine("Unable to retrieve value for null key."); } } }
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.