C# 속성이란 무엇이며 어떻게 작동하나요?

C# 속성은 클래스, 메서드, 속성과 같은 코드 엔티티에 메타데이터를 첨부하는 데 사용할 수 있는 선언적 태그입니다. 이들은 기본 코드를 변경하지 않고 코드의 표현력과 기능을 향상시키며, 컴파일러, 런타임 환경, 도구에 추가 정보를 제공합니다.

C#에서 사용자 정의 속성을 어떻게 만들 수 있나요?

C#에서 사용자 정의 속성을 만들려면 System.Attribute 에서 확장된 클래스를 정의해야 합니다. AttributeUsage 속성을 사용하여 대상 요소를 지정할 수 있으며, 사용자 정의 속성을 어디에 적용할 수 있는지 제어할 수 있습니다.

속성이 PDF 생성에 어떻게 도움이 되나요?

속성은 PDF 문서에서 제목 및 저자와 같은 메타데이터를 맞춤화하고, 페이지 크기 및 여백과 같은 레이아웃 설정을 제어하는 데 사용될 수 있습니다. IronPDF와 같은 라이브러리는 동적이고 맞춤화된 PDF 생성을 가능하게 하기 위해 속성을 활용합니다.

C#에서 [Serializable] 속성은 무엇에 사용되나요?

[Serializable] 속성은 클래스 인스턴스가 직렬화될 수 있음을 나타내는 데 사용됩니다. 이는 데이터 지속성 및 스트림 작업에 중요하며, 객체를 쉽게 저장하거나 전송할 수 있는 형식으로 변환할 수 있게 합니다.

ASP.NET MVC에서 속성은 어떻게 사용되나요?

ASP.NET MVC에서는 [Route]와 같은 속성을 사용하여 컨트롤러 액션에 대한 URL 라우팅 템플릿을 정의합니다. 이를 통해 응용 프로그램의 라우팅 기능을 향상시키는 조직적이고 읽기 쉬운 URL 구조를 생성할 수 있습니다.

코드 문서화에서 속성은 어떤 역할을 하나요?

[Obsolete]와 같은 속성은 사용하지 말아야 할 요소를 표시하고 대안을 제안하며, 더 이상 사용되지 않는 코드에 대해 개발자에게 경고를 제공함으로써 문서화 목적을 수행합니다.

속성이 단위 테스트에 어떻게 도움이 되나요?

단위 테스트 프레임워크에서는 [TestMethod]와 같은 속성이 테스트 메서드의 식별 및 실행을 가능하게 합니다. 테스트 도구는 이를 사용하여 테스트를 효율적으로 조직하고 실행하는 메타데이터를 제공합니다.

사용자 정의 속성의 AllowMultiple 속성의 중요성은 무엇인가요?

사용자 정의 속성의 AllowMultiple 속성은 속성이 단일 프로그램 요소에 대해 여러 인스턴스로 적용될 수 있는지를 결정하며, 메타데이터가 첨부되는 방식에 유연성을 제공합니다.

도구 통합에 속성이 사용될 수 있나요?

예, 속성은 도구가 처리할 수 있는 메타데이터를 제공하여 도구 통합을 촉진합니다. 여기에는 직렬화, 라우팅, 문서 생성과 같은 작업을 위한 프레임워크와의 통합이 포함됩니다.

C#의 일반적인 내장 속성은 무엇인가요?

C#의 일반적인 내장 속성에는 [Serializable], [Obsolete], [Conditional], [TestMethod]가 있습니다. 이러한 속성은 직렬화, 사용 중지, 조건부 컴파일, 테스트 메서드 식별과 같은 다양한 목적을 수행합니다.

C# PDF 라이브러리

Explore IronPDF 무료 체험 시작하기

HTML을 PDF로 변환

Online Demo 코드 예제 모두 보기

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

PM >Install-Package IronPdf

Install-Package IronPdf

개발자 업데이트

C# 어트리뷰트 (개발자를 위한 작동 원리)

Jacob Mellor

Updated: 2026년 4월 21일

C# 프로그래밍 세계에서 메타데이터는 코드의 의미와 동작을 풍부하게하는 중요한 역할을 합니다. C# 속성은 개발자가 코드 내 다양한 엔티티에 메타데이터를 첨부하여 컴파일러, 도구 및 런타임 환경이 해당 엔티티를 해석하고 상호작용하는 방식을 형성하는 강력한 도구로 떠올랐습니다.

이 포괄적인 가이드에서는 C# 속성을 살펴보고, 그들의 문법, 응용 및 코드 표현력과 기능성을 증대시키는 다양한 메커니즘으로 어떻게 사용할 수 있는지 탐구할 것입니다.

C# 속성 이해: 입문서

속성은 대괄호([])로 표시되며, 코드 요소 위에 위치하여 추가 정보를 제공합니다. 이 추가 정보, 즉 메타데이터는 코드의 기본 기능에 영향을 주지 않지만 컴파일러, 런타임 환경 및 도구에게 귀중한 통찰력을 제공합니다.

C#에서 객체 속성은 클래스나 메서드와 같은 프로그램 엔티티에 연관된 메타데이터를 나타냅니다. 속성 구문을 사용하여 정의된 속성 인스턴스는 Conditional("DEBUG")를 사용하여 코드의 조건부 포함과 같은 프로그램 엔티티의 설명을 강화합니다.

다음은 C#에서 속성을 사용하는 기본 예입니다:

[Serializable]
public class Person
{
    // Class Implementation
}

[Serializable]
public class Person
{
    // Class Implementation
}

<Serializable>
Public Class Person
	' Class Implementation
End Class

<Serializable>
Public Class Person
	' Class Implementation
End Class

이 예시에서 Serializable 속성은 Person 클래스의 인스턴스를 직렬화할 수 있음을 나타냅니다.

C# 속성의 종류

속성은 C# 코드의 다양한 요소에 적용됩니다:

어셈블리: 전체 어셈블리에 적용되어 컴파일 및 실행 중 행동에 영향을 줍니다.

[assembly: AssemblyVersion("1.0.0.0")]

[assembly: AssemblyVersion("1.0.0.0")]

<Assembly: AssemblyVersion("1.0.0.0")>

<Assembly: AssemblyVersion("1.0.0.0")>

모듈: 어셈블리 내의 모듈에 적용되어 자체에 대한 정보를 제공합니다.

[module: SomeCustomModuleAttribute]

[module: SomeCustomModuleAttribute]

<Module: SomeCustomModuleAttribute>

<Module: SomeCustomModuleAttribute>

타입: 유형에 적용되어 행동에 영향을 주거나 추가 정보를 제공합니다.

[Serializable]
public class Person
{
    // Class Implementation
}

[Serializable]
public class Person
{
    // Class Implementation
}

<Serializable>
Public Class Person
	' Class Implementation
End Class

<Serializable>
Public Class Person
	' Class Implementation
End Class

메서드: 메서드에 적용되어 행동을 변경하거나 도구에 정보를 제공합니다.

[Obsolete("Use the newMethod instead.")]
public void DeprecatedMethod()
{
    // Method implementation
}

[Obsolete("Use the newMethod instead.")]
public void DeprecatedMethod()
{
    // Method implementation
}

<Obsolete("Use the newMethod instead.")>
Public Sub DeprecatedMethod()
	' Method implementation
End Sub

<Obsolete("Use the newMethod instead.")>
Public Sub DeprecatedMethod()
	' Method implementation
End Sub

속성, 필드, 이벤트 등: 특정 멤버에 적용되어 해당 멤버에 관련된 메타데이터를 제공합니다.

public class Example
{
    [DefaultValue(42)]
    public int Answer { get; set; }
}

public class Example
{
    [DefaultValue(42)]
    public int Answer { get; set; }
}

Public Class Example
	<DefaultValue(42)>
	Public Property Answer() As Integer
End Class

Public Class Example
	<DefaultValue(42)>
	Public Property Answer() As Integer
End Class

Creating Custom Attributes in C#

C#은 수많은 기본 제공 속성을 제공하지만, 개발자는 코드에 대한 특정 정보를 전달하기 위해 사용자 정의 속성을 만들 수 있습니다. 사용자 정의 속성은 System.Attribute를 상속하는 클래스를 만들어 정의합니다:

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true)]
public class CustomAttribute : Attribute
{
    // Attribute Implementation
}

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true)]
public class CustomAttribute : Attribute
{
    // Attribute Implementation
}

<AttributeUsage(AttributeTargets.Class Or AttributeTargets.Method, AllowMultiple := True)>
Public Class CustomAttribute
	Inherits Attribute

	' Attribute Implementation
End Class

<AttributeUsage(AttributeTargets.Class Or AttributeTargets.Method, AllowMultiple := True)>
Public Class CustomAttribute
	Inherits Attribute

	' Attribute Implementation
End Class

이 예시에서 CustomAttribute는 클래스와 메서드에 적용될 수 있으며, AllowMultiple 속성은 단일 대상에 대해 속성의 여러 인스턴스가 허용되는지를 지정합니다. 사용자 정의 속성 클래스를 만들 때, 클래스 이름에 "Attribute" 접미사를 추가하여 일반 클래스와 구별합니다. 속성 생성자는 이러한 속성을 초기화하며, 위치 매개변수는 코드에서 속성에 값을 전달하는 역할을 합니다.

C# 속성의 응용

1. 코드 문서화

속성은 코드 문서화 및 개발자나 도구에 추가 정보를 제공하는 데 중요한 역할을 합니다. 예를 들어, [Obsolete] 속성은 특정 요소를 더 이상 사용하지 말아야 하며, 개발자들이 대체 항목으로 이동해야 한다는 것을 나타냅니다.

[Obsolete("This method is obsolete. Use the newMethod instead.")]
public void DeprecatedMethod()
{
    // Method Implementation
}

[Obsolete("This method is obsolete. Use the newMethod instead.")]
public void DeprecatedMethod()
{
    // Method Implementation
}

<Obsolete("This method is obsolete. Use the newMethod instead.")>
Public Sub DeprecatedMethod()
	' Method Implementation
End Sub

<Obsolete("This method is obsolete. Use the newMethod instead.")>
Public Sub DeprecatedMethod()
	' Method Implementation
End Sub

2. 직렬화 및 지속성

[Serializable] 속성과 같은 속성은 유형 인스턴스가 직렬화될 수 있음을 런타임 환경에 알립니다. 이것은 데이터 지속성과 같은 시나리오를 처리할 때 매우 중요합니다.

[Serializable]
public class Person
{
    // Class implementation
}

[Serializable]
public class Person
{
    // Class implementation
}

<Serializable>
Public Class Person
	' Class implementation
End Class

<Serializable>
Public Class Person
	' Class implementation
End Class

3. 코드 분석 및 도구 통합

속성은 정적 분석 및 코드 생성 도구에 기여합니다. 예를 들어, 단위 테스트 프레임워크 같은 도구는 테스트 메서드를 식별하기 위해 TestMethod와 같은 속성을 사용합니다.

[TestClass]
public class MyTestClass
{
    [TestMethod]
    public void TestMethod()
    {
        // Test method implementation
    }
}

[TestClass]
public class MyTestClass
{
    [TestMethod]
    public void TestMethod()
    {
        // Test method implementation
    }
}

<TestClass>
Public Class MyTestClass
	<TestMethod>
	Public Sub TestMethod()
		' Test method implementation
	End Sub
End Class

<TestClass>
Public Class MyTestClass
	<TestMethod>
	Public Sub TestMethod()
		' Test method implementation
	End Sub
End Class

4. ASP.NET MVC 라우팅

ASP.NET MVC에서 속성은 라우팅에 광범위하게 사용됩니다. Route 속성은 개발자가 액션 메서드에 대한 경로 템플릿을 지정할 수 있도록 합니다.

[Route("api/[controller]")]
public class SampleController : Controller
{
    [HttpGet]
    [Route("GetSampleData")]
    public IActionResult GetSampleData()
    {
        // Action method implementation
    }
}

[Route("api/[controller]")]
public class SampleController : Controller
{
    [HttpGet]
    [Route("GetSampleData")]
    public IActionResult GetSampleData()
    {
        // Action method implementation
    }
}

<Route("api/[controller]")>
Public Class SampleController
	Inherits Controller

	<HttpGet>
	<Route("GetSampleData")>
	Public Function GetSampleData() As IActionResult
		' Action method implementation
	End Function
End Class

<Route("api/[controller]")>
Public Class SampleController
	Inherits Controller

	<HttpGet>
	<Route("GetSampleData")>
	Public Function GetSampleData() As IActionResult
		' Action method implementation
	End Function
End Class

IronPDF 소개: 간단한 개요

IronPDF 개요는 PDF 생성 및 조작을 위한 다양한 도구 세트를 제공하는 C# .NET Framework 개발자를 위해 맞춤형으로 설계된 다목적 라이브러리입니다. HTML에서 PDF를 생성하는 것부터 기존 문서에서 내용을 추출하는 것까지, IronPDF는 복잡한 작업을 단순화하여 개발자의 도구 상자에서 귀중한 자산이 됩니다.

C# 속성 (개발자를 위한 작동 방식): 그림 1 - IronPDF 웹페이지

IronPDF 설치: 빠른 시작

C# 프로젝트에서 IronPDF 라이브러리를 활용하려면 IronPDF NuGet 패키지를 쉽게 설치할 수 있습니다. 패키지 관리자 콘솔에서 다음 명령을 사용하십시오:

PM > Install-Package IronPdf

Install-Package IronPdf

또한, NuGet 패키지 관리자에서 "IronPDF"를 검색하여 설치할 수 있습니다.

C# 속성: 간단한 개요

C# 속성은 클래스, 메서드 또는 속성 등 코드의 엔티티에 대한 추가 정보를 제공하는 선언적 태그입니다. 위에서 언급한 것처럼 코드의 핵심 기능을 변경하지 않고 메타데이터를 추가하거나 동작을 정의할 수 있습니다. 속성을 IronPDF와 통합하는 것을 탐색하면서, PDF 생성에 더 정교한 접근 방식을 제공할 수 있는 방법을 발견하게 될 것입니다.

C# 속성으로 PDF 생성 강화하기

1. 문서 메타데이터 사용자 정의

속성은 PDF 문서와 관련된 메타데이터를 풍부하게 하는 데 사용될 수 있습니다. IronPDF는 개발자가 제목, 저자, 주제 등과 같은 메타데이터 요소를 사용자 정의할 수 있게 합니다. 속성을 사용하면 생성된 PDF에 이 정보를 동적으로 주입할 수 있습니다. 다음 예제는 IronPDF에서 다양한 속성 클래스를 사용하는 방법을 보여줍니다:

// Define the DocumentMetadataAttribute
public class DocumentMetadataAttribute : Attribute
{
    public string Title { get; set; }
    public string Author { get; set; }
    public string Subject { get; set; }
}

[DocumentMetadata(Title = "Custom PDF Title", Author = "John Doe", Subject = "Document Subject")]
public class PdfGenerationWithAttributes
{
    public void GeneratePdf()
    {
        // Instantiate IronPDF PdfDocument
        var pdfDocument = new PdfDocument("StyledDocument.pdf");
        // Retrieve DocumentMetadataAttribute using reflection
        var documentMetadata = typeof(PdfGenerationWithAttributes)
            .GetCustomAttributes(typeof(DocumentMetadataAttribute), false)
            .FirstOrDefault() as DocumentMetadataAttribute;
        // Set metadata values
        pdfDocument.MetaData.Title = documentMetadata?.Title;
        pdfDocument.MetaData.Author = documentMetadata?.Author;
        pdfDocument.MetaData.Subject = documentMetadata?.Subject;
        // Perform document generation
        pdfDocument.SaveAs("CustomizedDocument.pdf");
    }
}

// Usage
PdfGenerationWithAttributes obj = new PdfGenerationWithAttributes();
obj.GeneratePdf();

// Define the DocumentMetadataAttribute
public class DocumentMetadataAttribute : Attribute
{
    public string Title { get; set; }
    public string Author { get; set; }
    public string Subject { get; set; }
}

[DocumentMetadata(Title = "Custom PDF Title", Author = "John Doe", Subject = "Document Subject")]
public class PdfGenerationWithAttributes
{
    public void GeneratePdf()
    {
        // Instantiate IronPDF PdfDocument
        var pdfDocument = new PdfDocument("StyledDocument.pdf");
        // Retrieve DocumentMetadataAttribute using reflection
        var documentMetadata = typeof(PdfGenerationWithAttributes)
            .GetCustomAttributes(typeof(DocumentMetadataAttribute), false)
            .FirstOrDefault() as DocumentMetadataAttribute;
        // Set metadata values
        pdfDocument.MetaData.Title = documentMetadata?.Title;
        pdfDocument.MetaData.Author = documentMetadata?.Author;
        pdfDocument.MetaData.Subject = documentMetadata?.Subject;
        // Perform document generation
        pdfDocument.SaveAs("CustomizedDocument.pdf");
    }
}

// Usage
PdfGenerationWithAttributes obj = new PdfGenerationWithAttributes();
obj.GeneratePdf();

' Define the DocumentMetadataAttribute
Public Class DocumentMetadataAttribute
	Inherits Attribute

	Public Property Title() As String
	Public Property Author() As String
	Public Property Subject() As String
End Class

<DocumentMetadata(Title := "Custom PDF Title", Author := "John Doe", Subject := "Document Subject")>
Public Class PdfGenerationWithAttributes
	Public Sub GeneratePdf()
		' Instantiate IronPDF PdfDocument
		Dim pdfDocument As New PdfDocument("StyledDocument.pdf")
		' Retrieve DocumentMetadataAttribute using reflection
		Dim documentMetadata = TryCast(GetType(PdfGenerationWithAttributes).GetCustomAttributes(GetType(DocumentMetadataAttribute), False).FirstOrDefault(), DocumentMetadataAttribute)
		' Set metadata values
		pdfDocument.MetaData.Title = documentMetadata?.Title
		pdfDocument.MetaData.Author = documentMetadata?.Author
		pdfDocument.MetaData.Subject = documentMetadata?.Subject
		' Perform document generation
		pdfDocument.SaveAs("CustomizedDocument.pdf")
	End Sub
End Class

' Usage
Private obj As New PdfGenerationWithAttributes()
obj.GeneratePdf()

' Define the DocumentMetadataAttribute
Public Class DocumentMetadataAttribute
	Inherits Attribute

	Public Property Title() As String
	Public Property Author() As String
	Public Property Subject() As String
End Class

<DocumentMetadata(Title := "Custom PDF Title", Author := "John Doe", Subject := "Document Subject")>
Public Class PdfGenerationWithAttributes
	Public Sub GeneratePdf()
		' Instantiate IronPDF PdfDocument
		Dim pdfDocument As New PdfDocument("StyledDocument.pdf")
		' Retrieve DocumentMetadataAttribute using reflection
		Dim documentMetadata = TryCast(GetType(PdfGenerationWithAttributes).GetCustomAttributes(GetType(DocumentMetadataAttribute), False).FirstOrDefault(), DocumentMetadataAttribute)
		' Set metadata values
		pdfDocument.MetaData.Title = documentMetadata?.Title
		pdfDocument.MetaData.Author = documentMetadata?.Author
		pdfDocument.MetaData.Subject = documentMetadata?.Subject
		' Perform document generation
		pdfDocument.SaveAs("CustomizedDocument.pdf")
	End Sub
End Class

' Usage
Private obj As New PdfGenerationWithAttributes()
obj.GeneratePdf()

이 예시에서 DocumentMetadataAttribute는 메타데이터 정보를 전달하는 사용자 지정 속성으로 작용하여 PDF 생성 중 동적 사용자 지정이 가능하게 합니다. 제공된 코드는 C#에서 DocumentMetadataAttribute라는 사용자 지정 속성 클래스를 정의합니다. 속성은 클래스, 메서드, 속성과 같은 프로그램 엔티티에 메타데이터나 선언적 정보를 추가하는 방법입니다. 이러한 속성은 반사를 통해 PDF 문서의 MetaData를 편집하는 데 사용됩니다.

C# 속성 (개발자를 위한 작동 방식): 그림 2 - '문서 속성'을 통해 출력된 PDF의 메타데이터 보기

2. 속성으로 PDF 레이아웃 제어

속성은 또한 PDF 문서의 레이아웃을 제어하는 데 사용될 수 있습니다. IronPDF는 페이지 크기, 여백, 방향을 설정하는 옵션을 제공합니다. 속성을 사용하여 이러한 레이아웃 설정을 특정 요구 사항에 따라 매개변수화할 수 있습니다:

// Define the PageLayoutAttribute
public class PageLayoutAttribute : Attribute
{
    public IronPdf.Rendering.PdfPaperSize Size { get; set; }
    public int MarginTop { get; set; }
    public int MarginBottom { get; set; }
    public int MarginLeft { get; set; }
    public int MarginRight { get; set; }
}

[PageLayout(Size = IronPdf.Rendering.PdfPaperSize.A4, MarginTop = 20, MarginBottom = 20, MarginLeft = 10, MarginRight = 10)]
public class PdfGenerationWithLayoutAttributes
{
    public void GeneratePdf()
    {
        // Instantiate IronPDF PdfDocument
        var pdfDocument = new ChromePdfRenderer();
        // Retrieve PageLayoutAttribute using reflection
        var pageLayout = typeof(PdfGenerationWithLayoutAttributes)
            .GetCustomAttributes(typeof(PageLayoutAttribute), false)
            .FirstOrDefault() as PageLayoutAttribute;
        // Set layout values
        pdfDocument.RenderingOptions.PaperSize = pageLayout?.Size;
        pdfDocument.RenderingOptions.MarginTop = pageLayout?.MarginTop ?? 0;
        pdfDocument.RenderingOptions.MarginBottom = pageLayout?.MarginBottom ?? 0;
        pdfDocument.RenderingOptions.MarginLeft = pageLayout?.MarginLeft ?? 0;
        pdfDocument.RenderingOptions.MarginRight = pageLayout?.MarginRight ?? 0;
        // Perform document generation
        pdfDocument.RenderHtmlAsPdf("<html><body><h1>Hello, IronPDF!</h1></body></html>")
            .SaveAs("CustomLayoutDocument.pdf");
    }
}

// Usage
PdfGenerationWithLayoutAttributes obj = new PdfGenerationWithLayoutAttributes();
obj.GeneratePdf();

// Define the PageLayoutAttribute
public class PageLayoutAttribute : Attribute
{
    public IronPdf.Rendering.PdfPaperSize Size { get; set; }
    public int MarginTop { get; set; }
    public int MarginBottom { get; set; }
    public int MarginLeft { get; set; }
    public int MarginRight { get; set; }
}

[PageLayout(Size = IronPdf.Rendering.PdfPaperSize.A4, MarginTop = 20, MarginBottom = 20, MarginLeft = 10, MarginRight = 10)]
public class PdfGenerationWithLayoutAttributes
{
    public void GeneratePdf()
    {
        // Instantiate IronPDF PdfDocument
        var pdfDocument = new ChromePdfRenderer();
        // Retrieve PageLayoutAttribute using reflection
        var pageLayout = typeof(PdfGenerationWithLayoutAttributes)
            .GetCustomAttributes(typeof(PageLayoutAttribute), false)
            .FirstOrDefault() as PageLayoutAttribute;
        // Set layout values
        pdfDocument.RenderingOptions.PaperSize = pageLayout?.Size;
        pdfDocument.RenderingOptions.MarginTop = pageLayout?.MarginTop ?? 0;
        pdfDocument.RenderingOptions.MarginBottom = pageLayout?.MarginBottom ?? 0;
        pdfDocument.RenderingOptions.MarginLeft = pageLayout?.MarginLeft ?? 0;
        pdfDocument.RenderingOptions.MarginRight = pageLayout?.MarginRight ?? 0;
        // Perform document generation
        pdfDocument.RenderHtmlAsPdf("<html><body><h1>Hello, IronPDF!</h1></body></html>")
            .SaveAs("CustomLayoutDocument.pdf");
    }
}

// Usage
PdfGenerationWithLayoutAttributes obj = new PdfGenerationWithLayoutAttributes();
obj.GeneratePdf();

' Define the PageLayoutAttribute
Public Class PageLayoutAttribute
	Inherits Attribute

	Public Property Size() As IronPdf.Rendering.PdfPaperSize
	Public Property MarginTop() As Integer
	Public Property MarginBottom() As Integer
	Public Property MarginLeft() As Integer
	Public Property MarginRight() As Integer
End Class

<PageLayout(Size := IronPdf.Rendering.PdfPaperSize.A4, MarginTop := 20, MarginBottom := 20, MarginLeft := 10, MarginRight := 10)>
Public Class PdfGenerationWithLayoutAttributes
	Public Sub GeneratePdf()
		' Instantiate IronPDF PdfDocument
		Dim pdfDocument = New ChromePdfRenderer()
		' Retrieve PageLayoutAttribute using reflection
		Dim pageLayout = TryCast(GetType(PdfGenerationWithLayoutAttributes).GetCustomAttributes(GetType(PageLayoutAttribute), False).FirstOrDefault(), PageLayoutAttribute)
		' Set layout values
		pdfDocument.RenderingOptions.PaperSize = pageLayout?.Size
		pdfDocument.RenderingOptions.MarginTop = If(pageLayout?.MarginTop, 0)
		pdfDocument.RenderingOptions.MarginBottom = If(pageLayout?.MarginBottom, 0)
		pdfDocument.RenderingOptions.MarginLeft = If(pageLayout?.MarginLeft, 0)
		pdfDocument.RenderingOptions.MarginRight = If(pageLayout?.MarginRight, 0)
		' Perform document generation
		pdfDocument.RenderHtmlAsPdf("<html><body><h1>Hello, IronPDF!</h1></body></html>").SaveAs("CustomLayoutDocument.pdf")
	End Sub
End Class

' Usage
Private obj As New PdfGenerationWithLayoutAttributes()
obj.GeneratePdf()

' Define the PageLayoutAttribute
Public Class PageLayoutAttribute
	Inherits Attribute

	Public Property Size() As IronPdf.Rendering.PdfPaperSize
	Public Property MarginTop() As Integer
	Public Property MarginBottom() As Integer
	Public Property MarginLeft() As Integer
	Public Property MarginRight() As Integer
End Class

<PageLayout(Size := IronPdf.Rendering.PdfPaperSize.A4, MarginTop := 20, MarginBottom := 20, MarginLeft := 10, MarginRight := 10)>
Public Class PdfGenerationWithLayoutAttributes
	Public Sub GeneratePdf()
		' Instantiate IronPDF PdfDocument
		Dim pdfDocument = New ChromePdfRenderer()
		' Retrieve PageLayoutAttribute using reflection
		Dim pageLayout = TryCast(GetType(PdfGenerationWithLayoutAttributes).GetCustomAttributes(GetType(PageLayoutAttribute), False).FirstOrDefault(), PageLayoutAttribute)
		' Set layout values
		pdfDocument.RenderingOptions.PaperSize = pageLayout?.Size
		pdfDocument.RenderingOptions.MarginTop = If(pageLayout?.MarginTop, 0)
		pdfDocument.RenderingOptions.MarginBottom = If(pageLayout?.MarginBottom, 0)
		pdfDocument.RenderingOptions.MarginLeft = If(pageLayout?.MarginLeft, 0)
		pdfDocument.RenderingOptions.MarginRight = If(pageLayout?.MarginRight, 0)
		' Perform document generation
		pdfDocument.RenderHtmlAsPdf("<html><body><h1>Hello, IronPDF!</h1></body></html>").SaveAs("CustomLayoutDocument.pdf")
	End Sub
End Class

' Usage
Private obj As New PdfGenerationWithLayoutAttributes()
obj.GeneratePdf()

이 예시에서 PageLayoutAttribute는 페이지 레이아웃 설정을 캡슐화하여 속성 값에 따라 동적 조정이 가능하도록 합니다.

결론

결론적으로, C# 속성은 코드 내에 메타데이터를 내장하는 데 있어 도구, 컴파일러, 런타임 환경이 그 코드를 해석하고 처리하는 데 영향을 미치는 귀중한 메커니즘으로 작용합니다. 내장된 속성을 사용하든 사용자 정의 속성을 만들든, 개발자는 속성을 활용하여 코드의 표현력을 향상시키고 도구 통합을 가능하게 하며 애플리케이션의 동작을 지정할 수 있습니다.

C# 속성과 IronPDF의 통합은 더 세련되고 동적인 PDF 생성을 위한 길을 엽니다. 메타데이터를 사용자 정의하든 레이아웃 설정을 미세 조정하든, 속성은 IronPDF의 기능을 향상시키는 선언적 접근 방식을 제공합니다. 가능성을 탐험하면서, PDF 생성 작업의 특정 요구 사항과 속성이 IronPDF와 함께 더 맞춤화되고 효율적인 프로세스에 어떻게 기여할 수 있는지 고려하십시오.

IronPDF는 몇 가지 제한 사항이 있는 개발에 무료로 제공되며, 완전한 IronPDF 기능 테스트를 위한 라이센스로 잠금을 해제할 수 있습니다.

Jacob Mellor

지금 바로 엔지니어링 팀과 채팅하세요

최고기술책임자

제이콥 멜러는 Iron Software의 최고 기술 책임자(CTO)이자 C# PDF 기술을 개척한 선구적인 엔지니어입니다. Iron Software의 핵심 코드베이스를 최초로 개발한 그는 창립 초기부터 회사의 제품 아키텍처를 설계해 왔으며, CEO인 캐머런 리밍턴과 함께 회사를 NASA, 테슬라, 그리고 전 세계 정부 기관에 서비스를 제공하는 50명 이상의 직원을 보유한 기업으로 성장시켰습니다.

...

더 읽어보기