Gewusst wie: Initialisieren von Objekten mit einem Objektinitialisierer (C#-Programmierhandbuch)How to initialize objects by using an object initializer (C# Programming Guide)

Mit Objektinitialisierern können Sie deklarativ Typenobjekte initialisieren, ohne explizit einen Konstruktor für den Typ aufzurufen.You can use object initializers to initialize type objects in a declarative manner without explicitly invoking a constructor for the type.

Die folgenden Beispiele zeigen, wie Objektinitialisierer mit benannten Objekten verwendet werden.The following examples show how to use object initializers with named objects. Der Compiler verarbeitet Objektinitialisierer, indem zuerst auf den parameterlosen Instanzinstruktor zugegriffen wird und anschließend die Memeberinitialisierungen verarbeitet werden.The compiler processes object initializers by first accessing the parameterless instance constructor and then processing the member initializations. Daher tritt bei Objektinitialisierern, die öffentlichen Zugriff benötigen, ein Fehler auf, wenn der parameterlose Konstruktor in der Klasse als private deklariert wird.Therefore, if the parameterless constructor is declared as private in the class, object initializers that require public access will fail.

Sie müssen einen Objektinitialisierer verwenden, wenn Sie einen anonymen Typ definieren.You must use an object initializer if you're defining an anonymous type. Weitere Informationen finden Sie unter Vorgehensweise: Zurückgeben von Teilmengen von Elementeigenschaften in einer Abfrage.For more information, see How to return subsets of element properties in a query.

BeispielExample

Im folgenden Beispiel wird das Initialisieren eines neuen StudentName-Typs mithilfe eines Objektinitialisierers gezeigt.The following example shows how to initialize a new StudentName type by using object initializers. Dieses Beispiel legt Eigenschaften für den Typ StudentName fest:This example sets properties in the StudentName type:

public class HowToObjectInitializers
{
    public static void Main()
    {
        // Declare a StudentName by using the constructor that has two parameters.
        StudentName student1 = new StudentName("Craig", "Playstead");

        // Make the same declaration by using an object initializer and sending
        // arguments for the first and last names. The parameterless constructor is
        // invoked in processing this declaration, not the constructor that has
        // two parameters.
        StudentName student2 = new StudentName
        {
            FirstName = "Craig",
            LastName = "Playstead"
        };

        // Declare a StudentName by using an object initializer and sending
        // an argument for only the ID property. No corresponding constructor is
        // necessary. Only the parameterless constructor is used to process object
        // initializers.
        StudentName student3 = new StudentName
        {
            ID = 183
        };

        // Declare a StudentName by using an object initializer and sending
        // arguments for all three properties. No corresponding constructor is
        // defined in the class.
        StudentName student4 = new StudentName
        {
            FirstName = "Craig",
            LastName = "Playstead",
            ID = 116
        };

        Console.WriteLine(student1.ToString());
        Console.WriteLine(student2.ToString());
        Console.WriteLine(student3.ToString());
        Console.WriteLine(student4.ToString());
    }
    // Output:
    // Craig  0
    // Craig  0
    //   183
    // Craig  116

    public class StudentName
    {
        // This constructor has no parameters. The parameterless constructor
        // is invoked in the processing of object initializers.
        // You can test this by changing the access modifier from public to
        // private. The declarations in Main that use object initializers will
        // fail.
        public StudentName() { }

        // The following constructor has parameters for two of the three
        // properties.
        public StudentName(string first, string last)
        {
            FirstName = first;
            LastName = last;
        }

        // Properties.
        public string FirstName { get; set; }
        public string LastName { get; set; }
        public int ID { get; set; }

        public override string ToString() => FirstName + "  " + ID;
    }
}

Objektinitialisierer können dafür verwendet werden, Indexer in einem Objekt festzulegen.Object initializers can be used to set indexers in an object. Das folgende Beispiel definiert eine BaseballTeam-Klasse, die einen Indexer verwendet, um Player an verschiedenen Positionen abzurufen und festzulegen.The following example defines a BaseballTeam class that uses an indexer to get and set players at different positions. Der Initialisierer kann Player auf Grundlage der Abkürzung für die Position oder der Zahl, die für jede einzelne Position auf einem Baseball-Scoresheet verwendet wird, zuweisen:The initializer can assign players, based on the abbreviation for the position, or the number used for each position baseball scorecards:

public class HowToIndexInitializer
{
    public class BaseballTeam
    {
        private string[] players = new string[9];
        private readonly List<string> positionAbbreviations = new List<string>
        {
            "P", "C", "1B", "2B", "3B", "SS", "LF", "CF", "RF"
        };

        public string this[int position]
        {
            // Baseball positions are 1 - 9.
            get { return players[position-1]; }
            set { players[position-1] = value; }
        }
        public string this[string position]
        {
            get { return players[positionAbbreviations.IndexOf(position)]; }
            set { players[positionAbbreviations.IndexOf(position)] = value; }
        }
    }

    public static void Main()
    {
        var team = new BaseballTeam
        {
            ["RF"] = "Mookie Betts",
            [4] = "Jose Altuve",
            ["CF"] = "Mike Trout"
        };

        Console.WriteLine(team["2B"]);
    }
}

Siehe auchSee also