Dictionary.TryGetValue 方法 试用记 Mark

 1 if (name == null || name == "")
 2                return null;
 3            XLine obj;
 4            if (xlines.TryGetValue(name, out obj))
 5            {
 6                return obj;
 7            }
 8            else
 9            {
10                return null;
11            }

在盖次的MSDN里找到一些东东．
http://msdn.microsoft.com/zh-cn/library/zkw5c9ak(VS.80).aspx

.NET Framework 类库

Dictionary.TryGetValue 方法

注意：此方法在 .NET Framework 2.0 版中是新增的。

获取与指定的键相关联的值。

命名空间:System.Collections.Generic
程序集:mscorlib（在 mscorlib.dll 中）

 语法

Visual Basic（声明）

Public Function TryGetValue ( _
key As TKey, _
<OutAttribute> ByRef value As TValue _
) As Boolean

Visual Basic（用法）

Dim instance As Dictionary(Of TKey, TValue)
Dim key As TKey
Dim value As TValue
Dim returnValue As Boolean
returnValue = instance.TryGetValue(key, value)

C#

public bool TryGetValue (
TKey key,
out TValue value
)

C++

public:
virtual bool TryGetValue (
TKey key,
[OutAttribute] TValue% value
) sealed

J#

public final boolean TryGetValue (
TKey key,
/** @attribute OutAttribute() */ /** @ref */ TValue value
)

JScript

JScript 不支持通过引用传递值类型参数。

参数

key

要获取的值的键。

value

当此方法返回值时，如果找到该键，便会返回与指定的键相关联的值；否则，则会返回 value 参数的类型默认值。该参数未经初始化即被传递。

返回值

如果 Dictionary 包含具有指定键的元素，则为 true；否则为 false。

 异常

异常类型	条件
ArgumentNullException	key 为 空引用（在 Visual Basic 中为 Nothing）。

 备注

此方法将 ContainsKey 方法与 Item 属性的功能结合在一起。

如果未找到键，value 参数便为值类型 TValue 获取适当的默认值；例如，为 integer 类型获取 0（零），为布尔值类型获取 false，为引用类型获取 空引用（在 Visual Basic 中为 Nothing）。

如果代码频繁尝试访问字典中不存在的键，则可使用 TryGetValue 方法。使用此方法比捕获 Item 属性引发的 KeyNotFoundException 更为有效。

此方法的运算复杂度接近 O(1)。

 示例

该示例演示当程序频繁尝试字典中不存在的键时，如何使用 TryGetValue 方法来作为检索值的一种更有效的方法。为了对比，该示例还演示 Item 属性（在 C# 中为索引器）在试图检索不存在的键时如何引发异常。

此代码示例摘自一个为 Dictionary 类提供的更大的示例。

 1     // When a program often has to try keys that turn out not to
 2        // be in the dictionary, TryGetValue can be a more efficient 
 3        // way to retrieve values.
 4        string value = "";
 5        if (openWith.TryGetValue("tif", out value))
 6        {
 7            Console.WriteLine("For key = \"tif\", value = {0}.", value);
 8        }
 9        else
10        {
11            Console.WriteLine("Key = \"tif\" is not found.");
12        }
13<br /><span space="preserve"></span><br />        // The indexer throws an exception if the requested key is
14        // not in the dictionary.
15        try
16        {
17            Console.WriteLine("For key = \"tif\", value = {0}.", 
18                openWith["tif"]);
19        }
20        catch (KeyNotFoundException)
21        {
22            Console.WriteLine("Key = \"tif\" is not found.");
23        }
24