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 전달할 수 없습니다.