OdbcConnectionStringBuilder.TryGetValue(String, Object) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
A megadott kulcsnak megfelelő értéket kér le ebből.OdbcConnectionStringBuilder
public:
override bool TryGetValue(System::String ^ keyword, [Runtime::InteropServices::Out] System::Object ^ % value);
public override bool TryGetValue(string keyword, out object? value);
public override bool TryGetValue(string keyword, out object value);
override this.TryGetValue : string * obj -> bool
Public Overrides Function TryGetValue (keyword As String, ByRef value As Object) As Boolean
Paraméterek
- keyword
- String
A lekérni kívánt elem kulcsa.
- value
- Object
A következő értéknek megfelelő keywordérték: .
Válaszok
true, ha keyword található a kapcsolati karakterlánc; egyébként false.
Példák
Az alábbi példa a metódus viselkedését TryGetValue mutatja be.
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.");
}
}
}
Imports System.Data.Odbc
Module Module1
Sub Main()
Dim builder As 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, Nothing)
Console.WriteLine("Press any key to continue.")
Console.ReadLine()
End Sub
Private Sub DisplayValue( _
ByVal builder As OdbcConnectionStringBuilder, ByVal key As String)
Dim value As Object = Nothing
' 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, value) Then
Console.WriteLine("{0}='{1}'", key, value)
Else
Console.WriteLine("Unable to retrieve value for '{0}'", key)
End If
Catch ex As ArgumentNullException
Console.WriteLine("Unable to retrieve value for null key.")
End Try
End Sub
Private Function GetConnectionString() As String
' 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;"
End Function
End Module
Megjegyzések
A TryGetValue módszer lehetővé teszi, hogy a fejlesztők biztonságosan lekérjenek egy értéket egy OdbcConnectionStringBuilder adott kulcsból anélkül, hogy ellenőrizni kellene, hogy a megadott kulcsnév érvényes kulcsnév-e. Mivel TryGetValue nem jelent kivételt, ha nem létező kulcsot ad át, az érték beolvasása előtt nem kell keresnie egy kulcsot. A nem létező kulccsal rendelkező TryGetValue hívása a null értéket (Nothing Visual Basic) helyezi el a value paraméterben.