Razor C# (Geliştiriciler İçin Nasıl Çalışır)

Ön Koşullar

Razor dünyasına dalmadan önce, aşağıdakilerin yüklü olduğundan emin olun:

1. .NET Core SDK
2. Visual Studio

Razor View Motoru ve bu eğitim için kullanacağımız proje şablonlarını sağladıklarından gerekli olanlardır. Ayrıca, Windows, Linux veya macOS olması fark etmeksizin birden fazla işletim sistemi üzerinde çalışabilirler.

Adım 1 Yeni Bir Razor Sayfaları Projesi Oluşturma

Microsoft Visual Studio'yu açın ve şu adımları izleyin:

1. "Dosya"" > "Yeni" > "Proje""'ye tıklayın.
2. Proje şablonunu seçme ekranında, "Blazor Sunucu Uygulaması" seçenek.

3. Projenizi "IronPDFExample" olarak adlandırın ve "Oluştur" a tıklayın.

4. Açılır menülerden ".NET 7.0" veya daha yeni bir sürümünü seçin.

Artık yeni bir Razor Sayfaları projeniz var.

Razor Sözdizimi ve Dosyalarını Anlamak

Razor dosyaları, C# (bu yüzden 'cs') ile HTML birleştirerek .cshtml dosya uzantısını kullanır. Visual Basic kullanıyor olsaydık, dosya uzantısı .vbhtml olarak değişecekti.

Çözüm Gezgini'nde, "Index.cshtml" adlı .cshtml uzantı dosyasını bulun ve açın. HTML kodu ve C# kodunun birleşimini burada göreceksiniz. Bu karışım, Razor Parser tarafından mümkün kılınmaktadır.

<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>

Dinamik İçerik için Razor İşaretlemesi Kullanımı

Razor İşaretlemesi, HTML işaretlememizin içine sunucu tarafı kod eklememize izin verir. Kod blokları, satır içi ifadeler ve HTML kodlanmış ifadeler gibi çeşitli kod yapıları kullanabiliriz.

<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>
'}

Tag Helpers Anlamak

ASP.NET MVC'deki Tag Helpers, sunucu tarafı kodunun Razor dosyalarında HTML öğeleri oluşturmasına ve render etmesine olanak tanır. HTML yardımcılarına biraz benzerler ancak daha HTML benzeri bir sözdizimine sahiptirler. Razor görünümlerinizdeki HTML benzeri öğeleri, müşterinin tarayıcısına gönderilen HTML işaretlemesine dönüştürürler. Bir bağlantı Tag Helper kod örneğini düşünün:

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

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

Kullanıcı Etkileşimini Yönetme

Razor Sayfaları, kullanıcı etkileşimlerini yönetmek için işleyici yöntemleri kullanır. Örneğin, form gönderimini işlemek için Razor Sayfası'nın ilgili Sayfa Modeli dosyasında OnPostAsync adlı bir metot oluşturabiliriz.

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'da Açıklamalar

Razor ayrıca C# stilinde açıklamaları destekler. Unutmayın, Razor açıklamaları sunucu tarafıdır, yani tarayıcıya gönderilmezler. Böyle görünürler:

@* 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 *@

Ve bu çok satırlı bir açıklamadır:

@*
    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 görünüm ve sayfaları HTML açıklamalarını içerebilir. Bu açıklamalar tarayıcıya gönderilen HTML çıktısında görünür.

Modelleri Bir Razor Sayfasına Geçirme

Razor, sunucudan sayfaya modeller aktarabilmenizi sağlar. @model yönergesi, geçirilen nesnenin türünü belirtmek için kullanılır. Bu model özelliği, aşağıdaki örnekte gösterildiği gibi Razor sayfasında erişilebilir.

@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>

Razor'da IronPDF ile PDF Oluşturma

IronPDF for .NET, geliştiricilerin .NET'te HTML'den PDF, resimler ve hatta mevcut web sayfaları oluşturmalarına olanak tanıyan popüler bir kütüphanedir. Raporlar, faturalar ve standart baskı formatının gerekli olduğu diğer tüm belgeler için mükemmel bir araçtır. IronPDF, ASP.NET MVC ve ASP.NET Razor Sayfaları çerçevesinde mükemmel çalışır.

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);
    }
}

Sonuç

Razor C#'nin temellerini başarıyla öğrendiniz ve IronPDF ile uygulamanızda PDF dosyaları oluşturmayı nasıl entegre edeceğinizi keşfettiniz. Visual Studio'da yeni bir proje oluşturarak başladınız ve ardından dinamik web sayfaları oluşturmak için Razor söz dizimini nasıl kullanacağınızı öğrendiniz. Ayrıca IronPDF'nin HTML kodundan ve hatta tamamlanmış Razor Görünümlerinden PDF oluşturmak için nasıl kullanılabileceğini de keşfettiniz.

Şimdi, daha gelişmiş uygulamalar oluşturmaya devam ederken, IronPDF'nin sunduğu güçlü özelliklerden yararlanabilirsiniz. IronPDF'yi ücretsiz deneyebilir ve değerli bulursanız, ihtiyaçlarınıza uygun bir lisans satın alabilirsiniz.