.NET Framework satır içi ifadeleri ASP.NET

Makale
07/17/2023

Bu makale, aşağıdaki ASP.NET satır içi ifadelere giriş niteliğindedir:

<% ... %>
<%= ... %>
<%@ ... %>
<%# ... %>
<%$ ... %>
<%-- ... --%>

Orijinal ürün sürümü: .NET Framework
Özgün KB numarası: 976112

<% ... %> eklenmiş kod blokları

Katıştırılmış kod bloğu, klasik ASP ile geriye dönük uyumluluğu korumak için kullanılır. Bloktaki kod, sayfa işleme aşamasında geçerli sayfa sınıfında programlama deyimlerini yürütebilir ve işlevleri çağırabilir.

Aşağıdaki örnekte, bir döngünün sonuçlarını görüntülemek için eklenmiş kod bloğunda örnek Microsoft Visual Basic .NET kodu içeren bir ASP.NET sayfası gösterilmektedir:

<%@ Page Language="VB" %>
<html>
<body>
    <form id="form1" runat="server">
        <% For i As Integer = 16 To 24 Step 2%>
            <div style="font-size: <% Response.Write(i)%>">
                Hello World<br />
            </div>
        <% Next%>
    </form>
</body>
</html>

Katıştırılmış kod bloğu her zaman Köprü Metni Biçimlendirme Dili (HTML) kaynağıyla karıştırılır, geliştiricilerin bunları okuması ve koruması zordur.

ASP.NET Web sayfalarındaki ekli kod blokları hakkında daha fazla bilgi için ASP.NET Web Forms Sayfalarda Eklenmiş Kod Blokları sayfasını ziyaret edin.

<%= ... %> görüntüleme ifadesi

<%= ... %> Görüntülenen ifade, yalnızca deyimini içeren eklenmiş kod bloğunun eşdeğeridirResponse.Write(...). Tek bir dize, int değişkeni veya sabit gibi bilgileri görüntülemenin en basit yoludur.

Örneğin, aşağıdaki örnek kod geçerli saati görüntüler:

<%@ Page Language="VB" %>
<html>
    <body>
        <form id="form1" runat="server">
            <%=DateTime.Now.ToString() %>
        </form>
    </body>
</html>

Görüntülenen ifadenin sunucu denetimlerinin özniteliklerinde kullanılamayacağını unutmayın. Bunun nedeni, .NET Framework özniteliğinin değeri olarak içeriği görüntülemek yerine ifadenin tamamını doğrudan derlemesidir.

ASP.NET bilgileri görüntüleme hakkında daha fazla bilgi için ASP.NET'dan görüntüleme sayfasını ziyaret edin.

<%@ ... %> yönerge ifadesi

Yönerge ifadesi, web formu (.aspx) sayfaları ve Kullanıcı Denetimi (.ascx) dosyalarını ASP.NET işlerken sayfa ve kullanıcı denetimi derleyicileri tarafından kullanılan ayarları belirten söz dizimidir.

ASP.NET sayfa çerçevesi aşağıdaki yönergeleri destekler:

Yönergesi	Açıklama
`@ Page`	ASP.NET sayfa ayrıştırıcısı ve derleyicisi tarafından kullanılan sayfaya özgü öznitelikleri tanımlar. Yalnızca .aspx dosyalarına eklenebilir. Bu yönerge adı yalnızca ASP.NET Web Formu sayfalarında kullanılabilir.
`@ Control`	ASP.NET sayfa ayrıştırıcısı ve derleyicisi tarafından kullanılan denetime özgü öznitelikleri tanımlar. Yalnızca .ascx dosyalarına (kullanıcı denetimleri) eklenebilir. Yönerge adı yalnızca Kullanıcı Denetimi dosyalarında kullanılabilir.
`@ Import`	Ad alanını bir sayfaya veya kullanıcı denetimine açıkça içeri aktarır.
`@ Implements`	Bildirim temelli olarak, bir sayfanın veya kullanıcı denetiminin belirtilen .NET Framework arabirimini uyguladığını gösterir.
`@ Register`	Diğer adları ad alanlarıyla ve sınıf adlarıyla ilişkilendirir. Bu, kullanıcı denetimlerinin ve özel sunucu denetimlerinin istenen bir sayfaya veya kullanıcı denetimine dahil edildiğinde işlenmesini sağlar.
`@ Assembly`	Derleme sırasında derlemeyi geçerli sayfaya bağlar. Derlemenin tüm sınıflarını ve arabirimlerini sayfada kullanılabilir hale getirir.
`@ Master`	bir ASP.NET ana sayfasını tanımlar.
`@ WebHandler`	ASP.NET IHttpHandler sayfasını tanımlar.
`@ PreviousPageType`	PreviousPage özelliği aracılığıyla erişilen önceki sayfada güçlü yazma elde etmek için bir yol sağlar.
`@ MasterType`	Bir ASP.NET sayfasının Master özelliğine sınıf adı atar. ASP.NET ana sayfasına kesin olarak yazılan bir başvuru oluşturmak için bir yol sağlar.
`@ OutputCache`	Bir sayfanın veya kullanıcı denetiminin çıkış önbelleğe alma ilkelerini bildirimli olarak denetler.
`@ Reference`	Bir sayfayı veya kullanıcı denetimini geçerli sayfaya veya kullanıcı denetimine bildirimli olarak bağlar.

Yönerge söz dizimi hakkında daha fazla bilgi için Metin Şablonu Yönerge söz dizimi sayfasını ziyaret edin.

<%# ... %> veri bağlama ifadesi

Veri bağlama ifadesi, denetimin bu sunucu denetiminin DataBind yöntemi sayfada çağrıldığında bir sunucu denetimi özelliği ile veri kaynağı arasında bağlama oluşturur.

Aşağıdaki örnekte, bir işlevdeki dizeyi etiketin Text özelliğine bağlamak için veri bağlama ifadesinin nasıl kullanılacağı gösterilmektedir:

<%@ Page Language="VB" %>
<script runat="server">
    Protected Function SayHello() As String
        Return "Hello World"
    End Function

    Protected Sub Page_PreRender(ByVal sender As Object, ByVal e As System.EventArgs)
        lblHello.DataBind()
    End Sub
</script>
<html>
    <body>
        <form id="form1" runat="server">
            <asp:Label ID="lblHello" runat="server" Text="<%# SayHello%>"></asp:Label>
        </form>
    </body>
</html>

Veri bağlama ifadesi söz dizimi hakkında daha fazla bilgi için Veri Bağlama İfade söz dizimi sayfasını ziyaret edin.

<%$ ... %> ifade oluşturucusu

İfade oluşturucusu, bir uygulamanın yapılandırmasında veya kaynak dosyalarında yer alan bilgilere göre denetim özelliklerinin değerlerini ayarlamak için kullanılır. Aşağıdaki örnek, ifade oluşturucusunun temel söz dizimidir:
<%$ Expression Prefix: Expression Value %>

Dolar işareti ($), aşağıdaki ifadenin bir ifade oluşturucusu olduğunu ASP.NET gösterir. İfade ön eki, , ConnectionStringsveya Resourcesgibi AppSettingsifade türünü tanımlar. Ayrıca, kendi ifade oluşturucunuzu oluşturabilir ve tanımlayabilirsiniz. İki nokta üst üste (:)) izleyen ifade değeri, ASP.NET aslında belirli bir özelliğin değeri olarak kullanacağı değerdir.

Aşağıdaki tanıtımda, Web.config dosyasındaki düğümden AppSettings bir Web sitesinin telif hakkını almak için ifade oluşturucusunun nasıl kullanılacağı ve telif hakkı bilgilerinin Değişmez Değerin Text özelliğinin değeri olarak nasıl ayarlanacağı gösterilmektedir.

AppSettingsWeb.config dosyasındaki düğüm:

<appSettings>
    <add key="copyright" value="(c) Copyright 2009 WebSiteName.com"/>
</appSettings>

ASP.NET Web Formu sayfasındaki ifade oluşturucusu:

<div id="footer">
    <asp:Literal ID="Literal1" runat="server" Text="<%$ AppSettings: copyright %>"></asp:Literal>
</div>

ASP.NET ifadeler hakkında daha fazla bilgi için ASP.NET İfadelere Genel Bakış sayfasını ziyaret edin.

<%-- ... -- %> sunucu tarafı açıklama bloğu

Sunucu tarafı açıklamalar bloğu, geliştiricilerin kod açıklamalarını ASP.NET Web Formu sayfalarının HTML kaynağının herhangi bir konumuna eklemesine olanak tanır (kod blokları dışında <script> ). Sunucu tarafı açıklama bloğunun açma ve kapatma etiketleri arasındaki içerik sunucuda işlenmez veya sonuçta elde edilen sayfada işlenmez.

Aşağıdaki kod örneği, bir ASP.NET sayfasında sunucu tarafı açıklamalar bloğunun nasıl kullanılacağını gösterir:

<%@ Page Language="VB" %>
<script runat="server">
    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
        Dim strName As String
        strName = Session("userName")
        lblUserName.Text = strName
    End Sub
</script>
<html>
    <body>
        <form id="form1" runat="server">
            <%-- Label for UserName --%>
            <asp:Label ID="lblUserName" runat="server" Text=""></asp:Label>
        </form>
    </body>
</html>

Sunucu tarafı açıklamaları hakkında daha fazla bilgi için Sunucu Tarafı Açıklamaları sayfasını ziyaret edin.