Khởi Tạo Đối Tượng C# Chuyên Nghiệp: Từ Khối Nội Dung Đến Gán Rõ Ràng

Khi làm việc với C#, bạn không chỉ đơn thuần là "new up" một đối tượng — bạn cần quyết định cách mà tính biểu đạt, an toàn, và dễ đọc của việc khởi tạo đó sẽ như thế nào. Dù bạn đang xây dựng một DTO từ Graph API hay kết nối các repository, phong cách khởi tạo của bạn rất quan trọng.

Dưới đây là hướng dẫn từng cấp độ cho bạn.

🟢 CƠ BẢN — "Chỉ cần cho tôi một đối tượng"

Khối khởi tạo nội tuyến (ngắn gọn, tuyên bố):

csharp Copy

var defaultCallee = new ParticipantEndpoint
{
    OdataType = "#microsoft.graph.callRecords.participantEndpoint",
    UserAgent = new UserAgent
    {
        OdataType = "#microsoft.graph.callRecords.clientUserAgent",
        HeaderValue = null,
        ApplicationVersion = null,
        AdditionalData =
        {
            ["Platform"] = "unknown",
            ["ProductFamily"] = "unknown",
            ["CommunicationServiceId"] = null,
            ["AzureADAppId"] = null
        }
    },
    AdditionalData = { ["Identity"] = null }
};

✅ Lợi ích:

Ngắn gọn, tuyên bố rõ ràng.
Tuyệt vời cho các DTO đơn giản, kiểm thử, giả lập.
Ít mã khởi tạo hơn.

⚠️ Cảnh báo:

Khó khăn trong việc gỡ lỗi theo từng dòng trong cửa sổ theo dõi.
Các khối khởi tạo lồng nhau có thể trở nên phức tạp.

🟡 TRUNG BÌNH — "Từng bước một, làm ơn"

Gán rõ ràng (quy trình, chi tiết):

csharp Copy

var defaultCallee = new ParticipantEndpoint();
defaultCallee.OdataType = "#microsoft.graph.callRecords.participantEndpoint";
defaultCallee.UserAgent = new UserAgent();
defaultCallee.UserAgent.OdataType = "#microsoft.graph.callRecords.clientUserAgent";
defaultCallee.UserAgent.HeaderValue = null;
defaultCallee.UserAgent.ApplicationVersion = null;
defaultCallee.UserAgent.AdditionalData["Platform"] = "unknown";
defaultCallee.UserAgent.AdditionalData["ProductFamily"] = "unknown";
defaultCallee.UserAgent.AdditionalData["CommunicationServiceId"] = null;
defaultCallee.UserAgent.AdditionalData["AzureADAppId"] = null;
defaultCallee.AdditionalData["Identity"] = null;

✅ Lợi ích:

Thân thiện với gỡ lỗi: bạn có thể đặt điểm dừng sau mỗi lần gán.
Dễ dàng hơn khi cần logic điều kiện.
Hoạt động tốt trong các hướng dẫn từng bước hoặc khi xây dựng từng phần.

⚠️ Cảnh báo:

Chi tiết và lặp lại.
Có thể che giấu ý định dưới "nhiễu".

🔵 NÂNG CAO — "Thiết kế cho khả năng bảo trì"

Khi nào nên chọn một trong hai?

Khởi tạo nội tuyến: Sử dụng khi đối tượng là một "bao dữ liệu" (DTO, bản ghi, ảnh chụp cấu hình). Hoàn hảo cho ý định tuyên bố.
Gán rõ ràng: Sử dụng khi khởi tạo liên quan đến điều kiện, vòng lặp, xác thực, hoặc dịch vụ. Hoàn hảo cho quy trình mệnh lệnh.

Ví dụ (kết hợp):

csharp Copy

var endpoint = new ParticipantEndpoint
{
    OdataType = "#microsoft.graph.callRecords.participantEndpoint",
    UserAgent = new UserAgent
    {
        OdataType = "#microsoft.graph.callRecords.clientUserAgent"
    }
};

// Thêm điều kiện sau
if (isUnknownPlatform)
    endpoint.UserAgent.AdditionalData["Platform"] = "unknown";

if (!string.IsNullOrEmpty(version))
    endpoint.UserAgent.ApplicationVersion = version;

🟣 CHUYÊN GIA — "Khởi tạo đối tượng là thiết kế OOP"

Nó không chỉ là cú pháp — nó là cách mà mô hình của bạn truyền đạt ý định:

Tính bất biến: ưu tiên các kiểu record với các setter chỉ khởi tạo khi dữ liệu không thể thay đổi sau khi xây dựng.
Đóng gói: ẩn đi khởi tạo phức tạp trong phương thức factory hoặc builders.
Hiệu suất: ít cấp phát hơn khi sử dụng khối khởi tạo so với nhiều câu lệnh.
Đọc được: các khối khởi tạo nhóm dữ liệu có liên quan; các gán trải rộng khắp mã.

👉 Ví dụ với một factory:

csharp Copy

public static ParticipantEndpoint CreateDefault(string? version = null)
    => new()
    {
        OdataType = "#microsoft.graph.callRecords.participantEndpoint",
        UserAgent = new UserAgent
        {
            OdataType = "#microsoft.graph.callRecords.clientUserAgent",
            ApplicationVersion = version,
            AdditionalData =
            {
                ["Platform"] = "unknown",
                ["ProductFamily"] = "unknown"
            }
        },
        AdditionalData = { ["Identity"] = null }
    };

Bây giờ logic xây dựng của bạn có thể tái sử dụng, có thể kiểm thử, và truyền đạt rõ ràng ý định.

⚡ Bảng Tóm Tắt

Mục Tiêu	Sử Dụng	Ví Dụ
DTO nhanh, ngắn gọn	Khởi tạo nội tuyến	`new Foo { A=1, B=2 }`
Thiết lập gỡ lỗi / điều kiện	Gán rõ ràng	`foo.A=1; if(x) foo.B=2;`
Thực thi bất biến	Factory hoặc Builder	`Foo.CreateDefault()`
Tính bất biến	`record` với `init`	`public record Foo { int A { get; init; } }`

🧠 Mô Hình Tư Duy

Hãy nghĩ về khởi tạo đối tượng trong C# như là các cấp độ ý định:

Tuyên bố hình dạng dữ liệu → khởi tạo nội tuyến.
Lắp ráp từng bước → gán rõ ràng.
Đóng gói phức tạp → mẫu factory/builder.

Chọn công cụ phù hợp với khả năng gỡ lỗi, đọc được, và mục tiêu thiết kế của bạn.

✍ Người viết: Cristian Sifuentes – Lập trình viên Full-stack tạo ra các ứng dụng có thể mở rộng với [.NET - Azure], [Angular - React], Git, SQL & tích hợp AI. Người yêu thích chế độ tối, mã sạch và các cam kết nguyên tử.

✨ Suy nghĩ Cuối Cùng:
Các khối khởi tạo và gán không phải là đối thủ — chúng bổ sung cho nhau. Sử dụng khối nội tuyến khi tuyên bố trạng thái; sử dụng gán khi kể lại logic. Động thái của chuyên gia? Bọc cả hai trong các trừu tượng sạch sẽ.

Khởi Tạo Đối Tượng C# Chuyên Nghiệp: Từ Khối Nội Dung Đến Gán Rõ Ràng