ASP.NET Core'de kısmi görünümler

Steve Smith, Maher JENDOUBI, Rick Andersonve Scott Scott Jrer

Kısmi görünüm, html çıkışını başka bir işaretleme dosyasının işlenmiş çıktısı içinde işleme yönergesi olmayan bir işaretleme Razor dosyasıdır (.cshtml). @page

Örnek kodu görüntüleme veya indirme ( nasılindir)

Kısmi görünümler ne zaman kullanmalı?

Kısmi görünümler şunların etkili bir yolu olur:

• Büyük işaretleme dosyalarını daha küçük bileşenlere parçalara ayrılma.

  Birkaç mantıksal parçadan oluşan büyük, karmaşık bir işaretleme dosyasında, her parçayla kısmi görünümde yalıtılmış şekilde çalışmanın bir avantajı vardır. işaretlemesi yalnızca genel sayfa yapısını ve kısmi görünümlere başvuruları içerdiği için işaretleme dosyasındaki kod yönetilebilir.

• Biçimlendirme dosyaları arasında ortak işaretleme içeriğinin çoğaltılması sayısını azaltma.

  İşaretleme dosyalarında aynı işaretleme öğeleri kullanılırken, kısmi bir görünüm işaretleme içeriğinin çoğaltılması tek bir kısmi görünüm dosyasına kaldırır. Kısmi görünümde işaretleme değiştiriken, kısmi görünümü kullanan işaretleme dosyalarının işlenmiş çıktısını günceller.

Ortak düzen öğelerini korumak için kısmi görünümler kullanılmaması gerekir. Ortak düzen öğeleri _Layout.cshtml dosyalarında belirtilmelidir.

Işaretlemeyi işlemek için karmaşık işleme mantığının veya kod yürütmenin gerekli olduğu kısmi bir görünüm kullanma. Kısmi görünüm yerine bir görünüm bileşeni kullanın.

Kısmi görünümleri bildir

Kısmi görünüme başvuru

public IActionResult OnGetPartial() =>
    new PartialViewResult
    {
        ViewName = "_AuthorPartialRP",
        ViewData = ViewData,
    };

public IActionResult OnGetPartial() =>
    Partial("_AuthorPartialRP");

Biçimlendirme dosyasında kısmi görünüm kullanma

<partial name="_PartialName" />

<partial name="_PartialName.cshtml" />

<partial name="~/Pages/Folder/_PartialName.cshtml" />
<partial name="/Pages/Folder/_PartialName.cshtml" />

<partial name="~/Views/Folder/_PartialName.cshtml" />
<partial name="/Views/Folder/_PartialName.cshtml" />

<partial name="../Account/_PartialName.cshtml" />

Zaman Uyumsuz HTML Yardımcısı

HTML Yardımcısı kullanırken en iyi yöntem PartialAsync kullanmaktır. PartialAsync , içinde IHtmlContent sarmalanmış bir tür Task<TResult> döndürür. yöntemine, beklenen çağrının önüne bir karakter ek olarak @ başvurıldı:

@await Html.PartialAsync("_PartialName")

Dosya uzantısı mevcut olduğunda, HTML Yardımcısı kısmi görünümü çağıran işaretleme dosyasıyla aynı klasörde olması gereken kısmi bir görünüme başvurur:

@await Html.PartialAsync("_PartialName.cshtml")

Aşağıdaki örnek, uygulama kökünden kısmi bir görünüme başvurur. Tilde-slash ( ) veya eğik çizgi ( ) ile baş alan ~/ / yollar, uygulama köküne başvurur:

@await Html.PartialAsync("~/Pages/Folder/_PartialName.cshtml")
@await Html.PartialAsync("/Pages/Folder/_PartialName.cshtml")

@await Html.PartialAsync("~/Views/Folder/_PartialName.cshtml")
@await Html.PartialAsync("/Views/Folder/_PartialName.cshtml")

Aşağıdaki örnek göreli yola sahip kısmi bir görünüme başvurur:

@await Html.PartialAsync("../Account/_LoginPartial.cshtml")

Alternatif olarak, ile kısmi bir görünümü RenderPartialAsync işabilirsiniz. Bu yöntem bir IHtmlContent dönmez. İşlenen çıkışı doğrudan yanıta akışla iletir. yöntemi bir sonuç dönmez, bunun bir kod bloğu içinde Razor çağrılmış olması gerekir:

@{
    await Html.RenderPartialAsync("_AuthorPartial");
}

Akışlar RenderPartialAsync işlenen içerikler sayesinde bazı senaryolarda daha iyi performans sunar. Performans açısından kritik durumlarda, her iki yaklaşımı kullanarak sayfayı kıyaslama ve daha hızlı yanıt oluşturan yaklaşımı kullanın.

Zaman Uyumlu HTML Yardımcısı

Partial ve RenderPartial sırasıyla ve zaman uyumlu PartialAsync RenderPartialAsync eşdeğerleridir. Zaman uyumlu eşdeğerler önerilmez çünkü kilitlenmeleri olan senaryolar vardır. Zaman uyumlu yöntemler, gelecekteki bir sürümde kaldırılmasını hedefler.

Kısmi görünüm bulma

Dosya uzantısı olmadan bir kısmi görünüme adla başvurulsa, aşağıdaki konumlar belirtilen sırayla aranır:

Aşağıdaki kuralları kısmi görünüm bulma için geçerlidir:

• Kısmi görünümler farklı klasörlerde olduğunda aynı dosya adına sahip farklı kısmi görünümlere izin verilir.
• Dosya uzantısı olmadan bir kısmi görünüme başvurulsa ve kısmi görünüm hem çağıranın klasöründe hem de Paylaşılan klasöründe mevcutsa, çağıranın klasöründeki kısmi görünüm kısmi görünümü sağlar. Kısmi görünüm çağıranın klasöründe yoksa, kısmi görünüm Paylaşılan klasörden sağlanır. Paylaşılan klasördeki kısmi görünümler paylaşılan kısmi görünümler veya varsayılan kısmi görünümler olarak adlandırılan bir dosyadır.
• Kısmi görünümler, çağrılar tarafından döngüsel bir başvuru kurulmasa kısmi görünümler başka bir — kısmi görünümü çağırarak zincirleme olabilir. Göreli yollar her zaman geçerli dosyayla görelidir, dosyanın köküne veya üst öğesine göre değildir.

Kısmi görünümlerde verilere erişin

Kısmi bir görünüm örneği oluşturulduğunda, üst öğenin sözlüğünün bir kopyasını alır ViewData . Kısmi görünüm içindeki verilerde yapılan güncelleştirmeler üst görünümde kalıcı değildir. ViewData kısmi görünüm geri döndüğünde kısmi görünümdeki değişiklikler kaybolur.

Aşağıdaki örnek, bir ViewDataDictionary örneğinin kısmi bir görünüme nasıl geçirileceğini göstermektedir:

@await Html.PartialAsync("_PartialName", customViewData)

Bir modeli kısmi bir görünüme geçirebilirsiniz. Model özel bir nesne olabilir. Bir modeli ile geçirebilirsiniz PartialAsync (bir içerik bloğunu çağırana kaydedebilir) veya RenderPartialAsync (içeriği çıkışa akıp):

@await Html.PartialAsync("_PartialName", model)

@model ReadRPModel

<h2>@Model.Article.Title</h2>
@* Pass the author's name to Pages\Shared\_AuthorPartialRP.cshtml *@
@await Html.PartialAsync("../Shared/_AuthorPartialRP", Model.Article.AuthorName)
@Model.Article.PublicationDate

@* Loop over the Sections and pass in a section and additional ViewData to 
   the strongly typed Pages\ArticlesRP\_ArticleSectionRP.cshtml partial view. *@
@{
    var index = 0;

    foreach (var section in Model.Article.Sections)
    {
        await Html.PartialAsync("_ArticleSectionRP", 
                                section,
                                new ViewDataDictionary(ViewData)
                                {
                                    { "index", index }
                                });

        index++;
    }
}

@model string
<div>
    <h3>@Model</h3>
    This partial view from /Pages/Shared/_AuthorPartialRP.cshtml.
</div>

@using PartialViewsSample.ViewModels
@model ArticleSection

<h3>@Model.Title Index: @ViewData["index"]</h3>
<div>
    @Model.Content
</div>

Örnek uygulamada aşağıdaki biçimlendirme görünümleri/makaleleri/Read. cshtml görünümünü gösterir. Görünüm iki kısmi görünüm içerir. İkinci kısmi görünüm bir modelde ve ViewData kısmi görünüme geçer. ViewDataDictionaryOluşturucu aşırı yüklemesi, ViewData var olan sözlüğü korurken yeni bir sözlüğü geçirmek için kullanılır ViewData .

@model PartialViewsSample.ViewModels.Article

<h2>@Model.Title</h2>
@* Pass the author's name to Views\Shared\_AuthorPartial.cshtml *@
@await Html.PartialAsync("_AuthorPartial", Model.AuthorName)
@Model.PublicationDate

@* Loop over the Sections and pass in a section and additional ViewData to 
   the strongly typed Views\Articles\_ArticleSection.cshtml partial view. *@
@{
    var index = 0;

    foreach (var section in Model.Sections)
    {
        await Html.PartialAsync("_ArticleSection", 
                                section,
                                new ViewDataDictionary(ViewData)
                                {
                                    { "index", index }
                                });

        index++;
    }
}

Views/Shared/_AuthorPartial. cshtml , Read. cshtml biçimlendirme dosyası tarafından başvurulan ilk kısmi görünümdür:

@model string
<div>
    <h3>@Model</h3>
    This partial view from /Views/Shared/_AuthorPartial.cshtml.
</div>

Görünümler/makaleler/_ArticleSection. cshtml Read. cshtml biçimlendirme dosyası tarafından başvurulan ikinci kısmi görünümdür:

@using PartialViewsSample.ViewModels
@model ArticleSection

<h3>@Model.Title Index: @ViewData["index"]</h3>
<div>
    @Model.Content
</div>

Çalışma zamanında, partiler, kendisini paylaşılan _Layout. cshtml içinde işlenen üst biçimlendirme dosyasının işlenmiş çıktısına işlenir. İlk kısmi görünüm, makalenin adını ve yayımlama tarihini işler:

Abrayhelincoln

<Paylaşılan kısmi görünüm dosyası yolundan bu kısmi görünüm > . 11/19/1863 12:00:00

İkinci kısmi görünüm, makalenin bölümlerini işler:

Bölüm bir dizin: 0

Dört puan ve yedi yıl önce...

Bölüm Iki Dizin: 1

Artık harika bir hukuki War, test ediyor...

Bölüm üç Dizin: 2

Ancak, daha büyük bir fikir için ayıramıyoruz...

Ek kaynaklar