out (C#-referens)

Använd nyckelordet out i två kontexter:

• Som parametermodifierare, som du använder för att skicka ett argument till en metod med referens i stället för efter värde.
• I allmänna typparameterdeklarationer för gränssnitt och ombud, som du använder för att ange att en typparameter är samvariant.

C#-språkreferensen dokumenterar den senaste versionen av C#-språket. Den innehåller även inledande dokumentation för funktioner i offentliga förhandsversioner för den kommande språkversionen.

Dokumentationen identifierar alla funktioner som först introducerades i de tre senaste versionerna av språket eller i aktuella offentliga förhandsversioner.

Tips/Råd

Information om när en funktion först introducerades i C# finns i artikeln om språkversionshistoriken för C#.

Parametermodifieraren out är särskilt användbar när en metod behöver returnera mer än ett värde eftersom du kan använda mer än en out parameter. Ett exempel:

    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);
    }

Följande begränsningar gäller för att använda nyckelordet out :

• Du kan inte använda out parametrar i asynkrona metoder.
• Du kan inte använda out parametrar i iteratormetoder.
• Du kan inte skicka egenskaper som out parametrar.