out （C# 参考）

在 out 两个上下文中使用关键字：

• 作为 参数修饰符，用于通过引用而不是值将参数传递给方法。
• 在接口和委托的 泛型类型参数声明中 ，用于指定类型参数是协变的。

C# 语言参考记录了 C# 语言的最新发布版本。 它还包含即将发布的语言版本公共预览版中功能的初始文档。

本文档标识了在语言的最后三个版本或当前公共预览版中首次引入的任何功能。

小窍门

若要查找 C# 中首次引入功能时，请参阅 有关 C# 语言版本历史记录的文章。

当方法需要返回多个值时，参数 out 修饰符特别有用，因为可以使用多个 out 参数。 例如，

    public void Main()
    {
        double radiusValue = 3.92781;
        //Calculate the circumference and area of a circle, returning the results to Main().
        CalculateCircumferenceAndArea(radiusValue, out double circumferenceResult, out var areaResult);
        System.Console.WriteLine($"Circumference of a circle with a radius of {radiusValue} is {circumferenceResult}.");
        System.Console.WriteLine($"Area of a circle with a radius of {radiusValue} is {areaResult}.");
        Console.ReadLine();
    }

    //The calculation worker method.
    public static void CalculateCircumferenceAndArea(double radius, out double circumference, out double area)
    {
        circumference = 2 * Math.PI * radius;
        area = Math.PI * (radius * radius);
    }

以下限制适用于使用 out 关键字：

• 不能在异步方法中使用 out 参数。
• 不能在迭代器方法中使用 out 参数。
• 不能将属性作为 out 参数传递。