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 參數傳遞。