C# 주 생성자 (개발자를 위한 작동 원리)

기초 이해하기: C#의 생성자

생성자는 객체 지향 프로그래밍에서 중요한 역할을 하며, 객체를 초기화하는 청사진 역할을 합니다. 전통적으로, C# 개발자는 자신의 클래스의 초기 상태를 설정하기 위해 기본 생성자나 매개변수가 있는 생성자를 사용해왔습니다. 그러나 Primary Constructors의 도입은 C# 개발의 필수적인 측면에 대해 더 간결한 접근을 제공합니다.

Primary Constructors의 본질

C#의 Primary Constructor는 클래스 선언 내에서 속성을 간단히 선언하고 초기화하는 방법입니다. 이 메커니즘은 속성의 정의 및 값 할당 프로세스를 단순화하여 더욱 선언적이고 읽기 쉬운 문법을 제공합니다.

Primary Constructors의 이점

1. 간결성: Primary constructors는 틀에 박힌 코드를 줄이고 가독성을 높이는 간결한 문법을 제공합니다.
2. 스코프: 전통적인 생성자와는 달리, Primary constructors의 매개변수는 클래스나 구조 내에서 유연하게 사용될 수 있는 스코프 내에 있습니다.
3. 기본값: 기본 매개변수 값은 객체 생성을 더 편리하게 만들어 개발자를 돕습니다.

Primary Constructor 선언

Primary Constructor의 문법은 클래스 헤더에서 속성을 직접 선언하는 것을 포함합니다. 기본 Person 클래스 예제를 고려해 봅시다:

public class Person(string name, int age)
{
    public string Name { get; } = name;
    public int Age { get; } = age;
    public override string ToString() => $"Name: {Name}, Age: {Age}";
}

public class Person(string name, int age)
{
    public string Name { get; } = name;
    public int Age { get; } = age;
    public override string ToString() => $"Name: {Name}, Age: {Age}";
}

Public Class Person(String name, Integer age)
	Public ReadOnly Property Name() As String = name
	Public ReadOnly Property Age() As Integer = age
	Public Overrides Function ToString() As String
		Return $"Name: {Name}, Age: {Age}"
	End Function
End Class

위 코드 스니펫에서 Person 클래스에는 인스턴스 멤버 Name과 인스턴스 멤버 Age 속성을 초기화하는 Primary Constructor가 있습니다. 생성자 매개변수는 클래스 또는 구조체 이름으로 선언되며, 공용 속성을 정의할 때 매개변수 값이 할당됩니다.

public readonly struct Point(double x, double y)
{
    public double X { get; } = x;
    public double Y { get; } = y;
    public double Magnitude => Math.Sqrt(X * X + Y * Y);
}

public readonly struct Point(double x, double y)
{
    public double X { get; } = x;
    public double Y { get; } = y;
    public double Magnitude => Math.Sqrt(X * X + Y * Y);
}

'INSTANT VB WARNING: VB has no equivalent to the C# readonly struct:
'ORIGINAL LINE: public readonly struct Point(double x, double y)
Public Structure Point(Double x, Double y)
	Public ReadOnly Property X() As Double = x
	Public ReadOnly Property Y() As Double = y
	Public ReadOnly Property Magnitude() As Double
		Get
			Return Math.Sqrt(X * X + Y * Y)
		End Get
	End Property
End Structure

public class Logger(string filePath = "log.txt", LogLevel level = LogLevel.Info)
{
    private readonly string _filePath = filePath;
    private readonly LogLevel _level = level;

    public void Log(string message)
    {
        // Actual logging implementation using _filePath and _level
    }
}

public class Logger(string filePath = "log.txt", LogLevel level = LogLevel.Info)
{
    private readonly string _filePath = filePath;
    private readonly LogLevel _level = level;

    public void Log(string message)
    {
        // Actual logging implementation using _filePath and _level
    }
}

'INSTANT VB TODO TASK: The following line contains an assignment within expression that was not extracted by Instant VB:
'ORIGINAL LINE: public class Logger(string filePath = "log.txt", LogLevel level = LogLevel.Info)
Public Class Logger(String filePath = "log.txt", LogLevel level = LogLevel.Info)
	Private ReadOnly _filePath As String = filePath
	Private ReadOnly _level As LogLevel = level

	Public Sub Log(ByVal message As String)
		' Actual logging implementation using _filePath and _level
	End Sub
End Class

public interface IService
{
    Distance GetDistance();
}

public class ExampleController(IService service) : ControllerBase
{
    public ActionResult<Distance> Get() => service.GetDistance();
}

public interface IService
{
    Distance GetDistance();
}

public class ExampleController(IService service) : ControllerBase
{
    public ActionResult<Distance> Get() => service.GetDistance();
}

Public Interface IService
	Function GetDistance() As Distance
End Interface

Public Class ExampleController(IService service)
	Inherits ControllerBase

	Public Function [Get]() As ActionResult(Of Distance)
		Return service.GetDistance()
	End Function
End Class

public abstract class Shape(double width, double height)
{
    public double Width { get; } = width;
    public double Height { get; } = height;
    public abstract double CalculateArea();
}

public class Rectangle(double width, double height) : Shape(width, height)
{
    public override double CalculateArea() => Width * Height;
}

public class Circle : Shape
{
    public Circle(double radius) : base(radius * 2, radius * 2) { }
    public override double CalculateArea() => Math.PI * Math.Pow(Width / 2, 2);
}

public abstract class Shape(double width, double height)
{
    public double Width { get; } = width;
    public double Height { get; } = height;
    public abstract double CalculateArea();
}

public class Rectangle(double width, double height) : Shape(width, height)
{
    public override double CalculateArea() => Width * Height;
}

public class Circle : Shape
{
    public Circle(double radius) : base(radius * 2, radius * 2) { }
    public override double CalculateArea() => Math.PI * Math.Pow(Width / 2, 2);
}

Public MustInherit Class Shape(Double width, Double height)
	Public ReadOnly Property Width() As Double = width
	Public ReadOnly Property Height() As Double = height
	Public MustOverride Function CalculateArea() As Double
End Class

Public Class Rectangle(Double width, Double height)
	Inherits Shape(width, height)

	Public Overrides Function CalculateArea() As Double
		Return Width * Height
	End Function
End Class

Public Class Circle
	Inherits Shape

	Public Sub New(ByVal radius As Double)
		MyBase.New(radius * 2, radius * 2)
	End Sub
	Public Overrides Function CalculateArea() As Double
		Return Math.PI * Math.Pow(Width / 2, 2)
	End Function
End Class

IronPDF 소개

IronPDF는 개발자가 PDF 파일을 쉽게 생성, 조작 및 변환할 수 있게 하는 다재다능한 C# 라이브러리입니다. 청구서, 보고서 또는 기타 문서를 생성하든 IronPDF는 C# 애플리케이션 내에서 HTML 콘텐츠를 세련되고 전문적인 PDF로 원활하게 변환할 수 있게 합니다.

IronPDF는 웹페이지, URLs, 및 HTML을 PDF로 변환할 수 있게 하는 개발자에게 유용한 도구입니다. PDF는 모든 형식과 스타일을 그대로 유지하여 원래 웹 페이지처럼 보이는 것이 가장 큰 장점입니다. 보고서 및 청구서와 같은 웹 콘텐츠에서 PDF를 생성하는 데 완벽합니다.

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class

Install-Package IronPdf

var htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";
// Create a new PDF document
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderHtmlAsPdf(htmlContent).SaveAs("C:/GeneratedDocument.pdf");

var htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>";
// Create a new PDF document
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderHtmlAsPdf(htmlContent).SaveAs("C:/GeneratedDocument.pdf");

Dim htmlContent = "<html><body><h1>Hello, IronPDF!</h1></body></html>"
' Create a new PDF document
Dim pdfDocument = New IronPdf.ChromePdfRenderer()
pdfDocument.RenderHtmlAsPdf(htmlContent).SaveAs("C:/GeneratedDocument.pdf")

C# 주 생성자와 IronPDF 통합

C# 주 생성자는 주로 클래스 초기화에 중점을 둔 언어 기능이지만, IronPDF와의 직접적인 통합은 흔치 않은 사용 사례일 수 있습니다. IronPDF의 핵심 기능은 PDF 문서 생성 및 조작에 있으며, 클래스 초기화의 구체적인 사항은 이 작업 흐름과 직접적으로 일치하지 않을 수 있습니다.

그러나 개발자는 IronPDF 구성이나 데이터 모델과 관련된 사용자 정의 클래스 또는 구조를 정의할 때 C# 주 생성자를 활용할 수 있습니다. 예를 들어, 애플리케이션에서 PDF 관련 설정이나 구성을 관리하기 위한 특정 클래스 구조가 필요하다면 C# 주 생성자는 이러한 클래스를 간결하게 초기화하기 위한 유용한 도구가 될 수 있습니다.

public class PdfGenerationSettings(string title, bool includeHeader, bool includeFooter)
{
    public string Title { get; } = title;
    public bool IncludeHeader { get; } = includeHeader;
    public bool IncludeFooter { get; } = includeFooter;
    // Additional properties...
}

// Usage with IronPDF
var pdfSettings = new PdfGenerationSettings("My PDF Title", true, false);
var renderOptions = new ChromePdfRenderOptions
{
    PaperSize = IronPdf.Rendering.PdfPaperSize.A4,
    MarginTop = 20,
    MarginBottom = 20,
    MarginLeft = 10,
    MarginRight = 10,
    Title = pdfSettings.Title
};
// Apply settings from PdfGenerationSettings
if (pdfSettings.IncludeHeader)
{
    renderOptions.TextHeader = new TextHeaderFooter
    {
        CenterText = "Page {page} of {total-pages}",
        DrawDividerLine = true
    };
}
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderingOptions = renderOptions;
pdfDocument.RenderHtmlAsPdf("<html><body><h1>Hello, IronPDF!</h1></body></html>").SaveAs("CustomizedDocument.pdf");

public class PdfGenerationSettings(string title, bool includeHeader, bool includeFooter)
{
    public string Title { get; } = title;
    public bool IncludeHeader { get; } = includeHeader;
    public bool IncludeFooter { get; } = includeFooter;
    // Additional properties...
}

// Usage with IronPDF
var pdfSettings = new PdfGenerationSettings("My PDF Title", true, false);
var renderOptions = new ChromePdfRenderOptions
{
    PaperSize = IronPdf.Rendering.PdfPaperSize.A4,
    MarginTop = 20,
    MarginBottom = 20,
    MarginLeft = 10,
    MarginRight = 10,
    Title = pdfSettings.Title
};
// Apply settings from PdfGenerationSettings
if (pdfSettings.IncludeHeader)
{
    renderOptions.TextHeader = new TextHeaderFooter
    {
        CenterText = "Page {page} of {total-pages}",
        DrawDividerLine = true
    };
}
var pdfDocument = new IronPdf.ChromePdfRenderer();
pdfDocument.RenderingOptions = renderOptions;
pdfDocument.RenderHtmlAsPdf("<html><body><h1>Hello, IronPDF!</h1></body></html>").SaveAs("CustomizedDocument.pdf");

Public Class PdfGenerationSettings(String title, Boolean includeHeader, Boolean includeFooter)
	Public ReadOnly Property Title() As String = title
	Public ReadOnly Property IncludeHeader() As Boolean = includeHeader
	Public ReadOnly Property IncludeFooter() As Boolean = includeFooter
	' Additional properties...
End Class

' Usage with IronPDF
Private pdfSettings = New PdfGenerationSettings("My PDF Title", True, False)
Private renderOptions = New ChromePdfRenderOptions With {
	.PaperSize = IronPdf.Rendering.PdfPaperSize.A4,
	.MarginTop = 20,
	.MarginBottom = 20,
	.MarginLeft = 10,
	.MarginRight = 10,
	.Title = pdfSettings.Title
}
' Apply settings from PdfGenerationSettings
If pdfSettings.IncludeHeader Then
	renderOptions.TextHeader = New TextHeaderFooter With {
		.CenterText = "Page {page} of {total-pages}",
		.DrawDividerLine = True
	}
End If
Dim pdfDocument = New IronPdf.ChromePdfRenderer()
pdfDocument.RenderingOptions = renderOptions
pdfDocument.RenderHtmlAsPdf("<html><body><h1>Hello, IronPDF!</h1></body></html>").SaveAs("CustomizedDocument.pdf")

이 예에서 PdfGenerationSettings 클래스는 PDF 생성 설정과 관련된 속성을 초기화하기 위해 C# 주 생성자를 사용하여 나중에 어떤 렌더링 옵션을 추가하고 어떤 것을 생략할지 결정할 수 있습니다. 출력에는 기본 생성자 매개변수를 사용하여 설정되었기 때문에 헤더 텍스트 및 제목이 포함됩니다.

결론

결론적으로, C#의 주 생성자는 클래스 초기화에 대한 정제되고 표현력 있는 접근 방식을 제공합니다. 그들의 선언적 구문은 코드 가독성을 향상시키고, 불변성을 촉진하며, 기본값으로 객체를 생성하는 과정을 단순화합니다. 속성을 정의하거나 불변성을 적용하거나 기본값을 수용할 때, 주 생성자는 C# 프로그래밍의 역동적인 세계에서 클래스 초기화 예술을 익힐 수 있도록 개발자를 강화합니다.

C# 주 생성자와 IronPDF의 직접적인 통합은 주요 초점이 아닐 수 있지만, 이 두 요소는 조화롭게 함께 작동할 수 있습니다. C# 주 생성자는 클래스 초기화의 명확성과 단순성을 향상하여 IronPDF 작업 흐름과 관련된 구조 또는 구성을 정의하는 데 유용합니다.

IronPDF의 강력한 PDF 생성 기능을 활용하고, 클래스 초기화의 우아함이 중요한 곳에서 C# 주 생성자를 사용하세요. 이 동적 듀오는 창의적이고 효율적으로 문서 생성의 복잡성을 다룰 수 있도록 C# 프로그래밍 활기 넘치는 세계에서 여러분을 강화합니다.

IronPDF는 무료 체험판을 제공하며, 기본 라이센스는 $799부터 시작합니다.