C# GetValueOrDefault(TKey)：获取具有指定键的元素的值，或者如果该键不存在，则返回默认值

C# GetValueOrDefault(TKey) 方法的完整攻略

方法介绍

在 Dictionary 类中，GetValueOrDefault(TKey) 方法用于获取与指定键关联的值。如果未找到键，则此方法将返回 TValue 类型的默认值。

方法签名

该方法的签名为：

public static TValue GetValueOrDefault<TKey, TValue>(this IDictionary<TKey, TValue> dictionary, TKey key);

参数说明

• dictionary：IDictionary 接口，表示要从中获取值的泛型字典。
• key：TKey 类型，表示要检索值的键。

返回值

如果字典包含指定键，则返回该键对应的值；否则返回 TValue 类型的默认值。

示例说明

下面是两个使用 GetValueOrDefault 方法的示例：

示例 1

using System;
using System.Collections.Generic;

class Program {
    static void Main() {
        Dictionary<string, int> numbers = new Dictionary<string, int>();
        numbers.Add("one", 1);
        numbers.Add("two", 2);
        numbers.Add("three", 3);

        // 获取存在的键
        int value1 = numbers.GetValueOrDefault("two");
        Console.WriteLine(value1);

        // 获取不存在的键
        int value2 = numbers.GetValueOrDefault("six");
        Console.WriteLine(value2);
    }
}

该示例创建了一个包含三个键值对的字典，然后使用 GetValueOrDefault 方法获取字典中的值。由于该示例中的字典包含键 "two"，所以第一个 GetValueOrDefault 方法调用返回了字典中与 "two" 关联的值 2。由于该字典不包含键 "six"，因此第二个 GetValueOrDefault 方法调用返回字典中默认值的类型 int 的默认值 0。

示例 2

using System;
using System.Collections.Generic;

class Program {
    static void Main() {
        Dictionary<string, string> dictionary = new Dictionary<string, string>();
        dictionary.Add("England", "London");
        dictionary.Add("France", "Paris");

        // TValue 类型为引用类型（string），并且字典中存在指定键，则返回该键对应的值
        string capital1 = dictionary.GetValueOrDefault("England");
        Console.WriteLine(capital1);

        // TValue 类型为引用类型（string），并且字典中不存在指定键，则返回默认值 null
        string capital2 = dictionary.GetValueOrDefault("Germany");
        Console.WriteLine(capital2);

        // TValue 类型为值类型（int），并且字典中不存在指定键，则返回默认值 0（即 TValue 的默认值）
        int value = dictionary.GetValueOrDefault("Spain");
        Console.WriteLine(value);
    }
}

该示例创建了一个包含两个键值对的字典，并使用 GetValueOrDefault 方法从字典中获取值。其中，capital1 和 capital2 变量都是字符串，因为字典中存储的值是引用类型 string。对于不存在于字典中的键 "Germany"，GetValueOrDefault 方法返回 null，因为该字典引用的值类型为字符串。对于不存在于字典中的键 "Spain"，GetValueOrDefault 方法返回默认值 0，因为该字典引用的值类型为字典类型 TValue 的默认值。

在第二个 GetValueOrDefault 方法调用中，由于 TValue 类型为引用类型（string），字典中不存在指定键，则返回默认值 null，类型为 TValue 的默认值。在第三个 GetValueOrDefault 方法调用中，由于 TValue 类型为值类型（int），字典中不存在指定键，则返回默认值 0，类型为 TValue 的默认值。

总结

GetValueOrDefault(TKey) 是 Dictionary 类型的扩展方法，用于获取与指定键关联的值。如果键不存在，该方法将返回 TValue 类型的默认值。在使用该方法时，请记得检查返回值是否为 null，以避免可能的 NullReferenceException 异常。