개체 이니셜라이저를 사용하여 형식에 대한 생성자를 명시적으로 호출하지 않고 선언적 방식으로 형식 개체를 초기화할 수 있습니다.
다음 예제에서는 명명된 개체와 함께 개체 이니셜라이저를 사용하는 방법을 보여 줍니다. 컴파일러는 먼저 매개 변수가 없는 인스턴스 생성자에 액세스한 다음 멤버 초기화를 처리하여 개체 이니셜라이저를 처리합니다. 따라서 매개 변수가 없는 생성자가 클래스에서와 같이 private 선언되면 공용 액세스가 필요한 개체 이니셜라이저가 실패합니다.
익명 형식을 정의하는 경우 개체 이니셜라이저를 사용해야 합니다. 자세한 내용은 쿼리에서 요소 속성의 하위 집합을 반환하는 방법을 참조하세요.
예시
다음 예제에서는 개체 이니셜라이저를 사용하여 새 StudentName 형식을 초기화하는 방법을 보여 줍니다. 다음은 StudentName 형식의 속성을 설정하는 예제입니다.
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;
}
}
개체 이니셜라이저를 사용하여 개체에서 인덱서를 설정할 수 있습니다. 다음 예제에서는 인덱서가 다른 위치에서 플레이어를 가져와서 설정하는 BaseballTeam 클래스를 정의합니다. 이니셜라이저는 포지션의 약어 또는 각 포지션 야구 성과 기록표에 사용되는 수에 따라 플레이어를 할당할 수 있습니다.
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"]);
}
}
다음 예제에서는 매개 변수를 사용 또는 사용하지 않고 생성자를 사용하여 생성자 및 멤버 초기화의 실행 순서를 보여 줍니다.
public class ObjectInitializersExecutionOrder
{
public static void Main()
{
new Person { FirstName = "Paisley", LastName = "Smith", City = "Dallas" };
new Dog(2) { Name = "Mike" };
}
public class Dog
{
private int age;
private string name;
public Dog(int age)
{
Console.WriteLine("Hello from Dog's non-parameterless constructor");
this.age = age;
}
public required string Name
{
get { return name; }
set
{
Console.WriteLine("Hello from setter of Dog's required property 'Name'");
name = value;
}
}
}
public class Person
{
private string firstName;
private string lastName;
private string city;
public Person()
{
Console.WriteLine("Hello from Person's parameterless constructor");
}
public required string FirstName
{
get { return firstName; }
set
{
Console.WriteLine("Hello from setter of Person's required property 'FirstName'");
firstName = value;
}
}
public string LastName
{
get { return lastName; }
init
{
Console.WriteLine("Hello from setter of Person's init property 'LastName'");
lastName = value;
}
}
public string City
{
get { return city; }
set
{
Console.WriteLine("Hello from setter of Person's property 'City'");
city = value;
}
}
}
// Output:
// Hello from Person's parameterless constructor
// Hello from setter of Person's required property 'FirstName'
// Hello from setter of Person's init property 'LastName'
// Hello from setter of Person's property 'City'
// Hello from Dog's non-parameterless constructor
// Hello from setter of Dog's required property 'Name'
}
키워드가 없는 new 개체 이니셜라이저
키워드 없이 new 개체 이니셜라이저 구문을 사용하여 중첩된 개체의 속성을 초기화할 수도 있습니다. 이 구문은 읽기 전용 속성에 특히 유용합니다.
public class ObjectInitializerWithoutNew
{
public class Address
{
public string Street { get; set; } = "";
public string City { get; set; } = "";
public string State { get; set; } = "";
}
public class Person
{
public string Name { get; set; } = "";
public Address HomeAddress { get; set; } = new(); // Property with setter
}
public static void Examples()
{
// Example 1: Using object initializer WITHOUT 'new' keyword
// This modifies the existing Address instance created in the constructor
var person1 = new Person
{
Name = "Alice",
HomeAddress = { Street = "123 Main St", City = "Anytown", State = "CA" }
};
// Example 2: Using object initializer WITH 'new' keyword
// This creates a completely new Address instance
var person2 = new Person
{
Name = "Bob",
HomeAddress = new Address { Street = "456 Oak Ave", City = "Somewhere", State = "NY" }
};
// Both approaches work, but they behave differently:
// - person1.HomeAddress is the same instance that was created in Person's constructor
// - person2.HomeAddress is a new instance, replacing the one from the constructor
Console.WriteLine($"Person 1: {person1.Name} at {person1.HomeAddress.Street}, {person1.HomeAddress.City}, {person1.HomeAddress.State}");
Console.WriteLine($"Person 2: {person2.Name} at {person2.HomeAddress.Street}, {person2.HomeAddress.City}, {person2.HomeAddress.State}");
}
}
이 방법은 새 개체를 만드는 대신 중첩된 개체의 기존 인스턴스를 수정합니다. 자세한 내용 및 예제는 클래스 형식 속성이 있는 개체 이니셜라이저를 참조하세요.
참고하십시오
GitHub에서 Microsoft와 공동 작업
이 콘텐츠의 원본은 GitHub에서 찾을 수 있으며, 여기서 문제와 끌어오기 요청을 만들고 검토할 수도 있습니다. 자세한 내용은 참여자 가이드를 참조하세요.
.NET