Razor C# (개발자를 위한 작동 방식)

필수 조건

Razor 세계로 들어가기 전에, 다음 항목이 설치되어 있는지 확인하십시오:

1. .NET Core SDK
2. Visual Studio

이들은 Razor View Engine과 이번 튜토리얼에서 사용할 프로젝트 템플릿을 제공합니다. 또한, 여러 운영 체제에서 작동할 수 있어 Windows, Linux, 또는 macOS의 어느 환경에서든 따라올 수 있습니다.

1단계: 새 Razor Pages 프로젝트 만들기

Microsoft Visual Studio를 열고 다음 단계를 따르세요:

1. "파일" > "새로 만들기" > "프로젝트"를 클릭합니다.
2. 프로젝트 템플릿 선택 화면에서 "Blazor 서버 앱"을 선택합니다.

3. 프로젝트 이름을 "IronPDFExample"로 지정하고 "만들기"를 클릭합니다.

4. 드롭다운에서 ".NET 7.0" 또는 그 이후 버전을 선택합니다.

이제 새로운 Razor Pages 프로젝트가 생겼습니다.

Razor 문법 및 파일 이해하기

Razor 파일은 .cshtml 파일 확장자를 사용하며, C#과 HTML이 결합됩니다. Visual Basic을 사용하고 있다면 파일 확장자가 .vbhtml로 변경될 것입니다.

솔루션 탐색기에서 'Index.cshtml'이라는 이름의 .cshtml 확장자 파일을 찾아 열어보세요. 여기에서 HTML 코드와 C# 코드의 결합을 볼 수 있습니다. 이 결합은 Razor 파서에 의해 가능합니다.

<p>The current time is @DateTime.Now</p>

<p>The current time is @DateTime.Now</p>

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<p> The current time is @DateTime.Now</p>

@page
@model IndexModel
@{
    ViewData["Title"] = "Home page";
}

<div class="text-center">
    <h1 class="display-4">Welcome</h1>
    <p>Learn about <a href="https://docs.microsoft.com/aspnet/core">building Web apps with ASP.NET Core</a>.</p>
</div>

@page
@model IndexModel
@{
    ViewData["Title"] = "Home page";
}

<div class="text-center">
    <h1 class="display-4">Welcome</h1>
    <p>Learn about <a href="https://docs.microsoft.com/aspnet/core">building Web apps with ASP.NET Core</a>.</p>
</div>

page model ReadOnly Property () As IndexModel
	ViewData("Title") = "Home page"
End Property

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<div class="text-center"> <h1 class="display-4"> Welcome</h1> <p> Learn about <a href="https://docs.microsoft.com/aspnet/core"> building Web apps @with ASP.NET Core</a>.</p> </div>

동적 콘텐츠를 위한 Razor 마크업 사용하기

Razor 마크업을 사용하여 HTML 마크업 내에 서버 측 코드를 삽입할 수 있습니다. 코드 블록, 인라인 표현식, HTML 인코딩된 표현식과 같은 다양한 코드 구조를 사용할 수 있습니다.

<p>Hello, my name is @Model.Name</p>

<p>Hello, my name is @Model.Name</p>

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<p> Hello, my name is @Model.Name</p>

@{
    var name = "IronPDF";
}
<p>Hello, my name is @name</p>

@{
    var name = "IronPDF";
}
<p>Hello, my name is @name</p>

@
If True Then
	Dim name = "IronPDF"
End If
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<p> Hello, my name is @name</p>

@{
    var count = 5;
}

@if (count > 3)
{
    <p>The count is greater than 3.</p>
}

@{
    var count = 5;
}

@if (count > 3)
{
    <p>The count is greater than 3.</p>
}

@
If True Then
	Dim count = 5
End If

'INSTANT VB TODO TASK: Local functions are not converted by Instant VB:
'@if(count > 3)
'{
'	<p> The count is greater than 3.</p>
'}

@{
    var fileFormat = "PDF";
    var message = "";

    switch (fileFormat) 
    {
        case "PDF":
            message = "You selected PDF.";
            break;
        default:
            message = "Invalid selection.";
            break;
    }
}

<p>@message</p>

@{
    var fileFormat = "PDF";
    var message = "";

    switch (fileFormat) 
    {
        case "PDF":
            message = "You selected PDF.";
            break;
        default:
            message = "Invalid selection.";
            break;
    }
}

<p>@message</p>

@
If True Then
	Dim fileFormat = "PDF"
	Dim message = ""

	Select Case fileFormat
		Case "PDF"
			message = "You selected PDF."
		Case Else
			message = "Invalid selection."
	End Select
End If

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<p> @message</p>

<p>@("Hello World")</p>

<p>@("Hello World")</p>

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<p> @("Hello World")</p>

@{
    var names = new List<string> { "John", "Doe", "Smith" };
}

@foreach (var name in names)
{
    <p>@name</p>
}

@{
    var names = new List<string> { "John", "Doe", "Smith" };
}

@foreach (var name in names)
{
    <p>@name</p>
}

@
If True Then
	Dim names = New List(Of String) From {"John", "Doe", "Smith"}
End If

'INSTANT VB TODO TASK: Local functions are not converted by Instant VB:
'@foreach(var name in names)
'{
'	<p> @name</p>
'}

태그 도우미 이해하기

ASP.NET MVC에서 태그 도우미는 서버 측 코드가 Razor 파일에서 HTML 요소를 생성하고 렌더링할 수 있도록 합니다. 태그 도우미는 HTML 도우미와 비슷하지만 더 HTML 같은 구문을 가집니다. 태그 도우미는 Razor 뷰의 HTML 같은 요소를 클라이언트 브라우저에 보내는 HTML 마크업으로 변환합니다. 다음 앵커 태그 도우미의 코드 예제를 고려해 보세요:

<a asp-controller="Home" asp-action="Index">Home</a>

<a asp-controller="Home" asp-action="Index">Home</a>

사용자 상호작용 처리하기

Razor 페이지는 사용자 상호작용을 관리하기 위해 핸들러 메서드를 사용합니다. 예를 들어, 양식 제출을 처리하기 위해 Razor 페이지의 해당 페이지 모델 파일에 OnPostAsync이라는 메서드를 생성할 수 있습니다.

public async Task<IActionResult> OnPostAsync()
{
    if (!ModelState.IsValid)
    {
        return Page();
    }

    // Perform some operation here

    return RedirectToPage("./Index");
}

public async Task<IActionResult> OnPostAsync()
{
    if (!ModelState.IsValid)
    {
        return Page();
    }

    // Perform some operation here

    return RedirectToPage("./Index");
}

Public Async Function OnPostAsync() As Task(Of IActionResult)
	If Not ModelState.IsValid Then
		Return Page()
	End If

	' Perform some operation here

	Return RedirectToPage("./Index")
End Function

Razor의 주석

Razor는 또한 C# 스타일의 주석을 지원합니다. Razor 주석은 서버 측 주석이므로 브라우저에 보내지지 않음을 기억하세요. Razor 주석은 이렇게 생겼습니다:

@* This is a Razor comment *@

@* This is a Razor comment *@

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'@* This is a Razor comment *@

그리고 이것은 여러 줄로 된 주석입니다:

@*
    This is a multi-line Razor comment.
    It's useful when you have a lot to say.
*@

@*
    This is a multi-line Razor comment.
    It's useful when you have a lot to say.
*@

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'@* This is a multi-line Razor comment.It's useful @when you have a lot @to say. *@

Razor 뷰와 페이지는 HTML 주석을 포함할 수 있습니다. 이 주석들은 브라우저에 보내는 HTML 출력에서 볼 수 있습니다.

모델을 Razor 페이지로 전달하기

Razor는 서버에서 페이지로 모델을 전달할 수 있도록 합니다. @model 지시는 전달되는 객체의 유형을 지정하는 데 사용됩니다. 아래 예제에 표시된 것처럼 이 모델 속성은 Razor 페이지에서 접근할 수 있습니다.

@page
@model ExampleModel

<h2>@Model.Title</h2>
<p>@Model.Description</p>

@page
@model ExampleModel

<h2>@Model.Title</h2>
<p>@Model.Description</p>

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'@page @model ExampleModel <h2> @Model.Title</h2> <p> @Model.Description</p>

IronPDF를 사용하여 Razor에서 PDF 생성하기

IronPDF for .NET은 개발자가 HTML, 이미지, 심지어 기존 웹 페이지를 .NET에서 PDF로 생성할 수 있게 해주는 인기 있는 라이브러리입니다. 이것은 보고서, 인보이스 및 표준 출력 형식이 필요한 기타 모든 문서를 작성하는 데 훌륭한 도구입니다. IronPDF는 ASP.NET MVC 및 ASP.NET Razor Pages 프레임워크 내에서 완벽하게 작동합니다.

Install-Package IronPdf

@using IronPdf;

@using IronPdf;

Dim IronPdf As [using]

@page "/pdf"
@using IronPdf;
@inject IJSRuntime JS

<PageTitle>Create PDF</PageTitle>

<h1>Create PDF</h1>

<div class="form-outline">
    <button class="btn btn-primary mt-3" @onclick="CreatePDF">Create PDF</button>
</div>

@code {
    private string htmlString { get; set; }

    private async Task CreatePDF()
    {
        var Renderer = new IronPdf.ChromePdfRenderer();
        Renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A2;

        var doc = Renderer.RenderUrlAsPdf("https://ironpdf.com/");

        using var Content = new DotNetStreamReference(stream: doc.Stream);

        await JS.InvokeVoidAsync("SubmitHTML", "ironpdf.pdf", Content);
    }
}

결론

성공적으로 Razor C#의 기초를 배우고 IronPDF를 통합하여 애플리케이션 내에서 PDF 파일을 생성하는 방법을 발견했습니다. Visual Studio에서 새로운 프로젝트를 생성하는 것으로 시작하여 Razor 구문을 사용하여 동적 웹 페이지를 생성하는 방법을 배웠습니다. HTML 코드와 심지어 Razor 뷰 전체에서 PDF를 생성하는 데 IronPDF를 사용할 수 있는 방법도 탐색했습니다.

이제 더 고급 애플리케이션을 계속 개발하면서 IronPDF가 제공하는 강력한 기능을 활용할 수 있습니다. IronPDF를 무료로 체험해 볼 수 있으며 가치 있다고 판단되면 필요한 요구 사항에 적합한 라이센스를 구매할 수 있습니다.