out (C# referencia)

Használja a out kulcsszót két környezetben:

• Paraméter-módosítóként, amellyel argumentumot ad át egy metódusnak hivatkozással, nem pedig érték alapján.
• Az interfészek és meghatalmazottak általános típusparaméter-deklarációiban , amelyekkel megadhatja, hogy a típusparaméter kovarianikus.

A C# nyelv referenciadokumentuma a C# nyelv legújabb kiadású verzióját ismerteti. Emellett a közelgő nyelvi kiadás nyilvános előzetes verziójú funkcióinak kezdeti dokumentációját is tartalmazza.

A dokumentáció azonosítja azokat a funkciókat, amelyeket először a nyelv utolsó három verziójában vagy az aktuális nyilvános előzetes verziókban vezetnek be.

Jótanács

Ha meg szeretné tudni, hogy mikor jelent meg először egy funkció a C#-ban, tekintse meg a C# nyelvi verzióelőzményeiről szóló cikket.

A out paramétermódosító különösen akkor hasznos, ha egy metódusnak több értéket kell visszaadnia, mivel több out paramétert is használhat. Például

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

A kulcsszó használatára a out következő korlátozások vonatkoznak:

• A paraméterek nem használhatók out aszinkron metódusokban.
• Az iterátor metódusokban nem használhat out paramétereket.
• Paraméterekként out nem adhat át tulajdonságokat.