out (Referenční dokumentace jazyka C#)

out Klíčové slovo použijte ve dvou kontextech:

• Jako modifikátor parametrů, který použijete k předání argumentu metodě odkazem, nikoli hodnotou.
• V deklarací parametru obecného typu pro rozhraní a delegáty, které slouží k určení, že parametr typu je kovariantní.

Referenční dokumentace jazyka C# dokumentuje naposledy vydané verze jazyka C#. Obsahuje také počáteční dokumentaci k funkcím ve verzi Public Preview pro nadcházející jazykovou verzi.

Dokumentace identifikuje všechny funkce, které byly poprvé představeny v posledních třech verzích jazyka nebo v aktuálních verzích Public Preview.

Návod

Informace o tom, kdy byla funkce poprvé představena v jazyce C#, najdete v článku o historii verzí jazyka C#.

Modifikátor out parametrů je zvlášť užitečný, když metoda potřebuje vrátit více než jednu hodnotu, protože můžete použít více než jeden out parametr. Příklad:

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

Pro použití klíčového out slova platí následující omezení:

• Parametry nemůžete použít out v asynchronních metodách.
• Parametry nemůžete použít out v metodách iterátoru.
• Vlastnosti nelze předat jako out parametry.