out (C#-verwijzing)

Gebruik het out trefwoord in twee contexten:

• Als parameteraanpassing, die u gebruikt om een argument door te geven aan een methode op basis van verwijzing in plaats van op waarde.
• In algemene typeparameterdeclaraties voor interfaces en gemachtigden, die u gebruikt om op te geven dat een typeparameter covariant is.

De C#-taalreferentiedocumenten beschrijven de meest recent uitgebrachte versie van de C#-taal. Het bevat ook de eerste documentatie voor functies in openbare previews voor de aanstaande taalrelease.

De documentatie identificeert alle functies die voor het eerst zijn geïntroduceerd in de laatste drie versies van de taal of in de huidige openbare previews.

Aanbeveling

Raadpleeg het artikel over de versiegeschiedenis van de C#-taal om te achterhalen wanneer een functie voor het eerst is geïntroduceerd in C#.

De out parameteraanpassing is vooral handig wanneer een methode meer dan één waarde moet retourneren, omdat u meer dan één out parameter kunt gebruiken. Bijvoorbeeld

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

De volgende beperkingen gelden voor het gebruik van het out trefwoord:

• U kunt geen parameters gebruiken out in asynchrone methoden.
• U kunt geen parameters gebruiken out in iterator-methoden.
• U kunt eigenschappen niet doorgeven als out parameters.