Substitution.MethodName Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan atau mengatur nama metode panggilan balik yang akan dipanggil saat Substitution kontrol dijalankan.
public:
virtual property System::String ^ MethodName { System::String ^ get(); void set(System::String ^ value); };
public virtual string MethodName { get; set; }
member this.MethodName : string with get, set
Public Overridable Property MethodName As String
Nilai Properti
String yang mewakili nama metode yang akan dipanggil saat Substitution kontrol dijalankan.
Contoh
Contoh kode berikut menunjukkan cara menambahkan Substitution kontrol secara deklaratif ke halaman Web yang di-cache output. Saat halaman dimuat, daftar berpoin statis ditampilkan kepada pengguna. Bagian halaman ini di-cache dan diperbarui hanya setiap 60 detik.
Substitution Ketika kontrol dijalankan, kontrol memanggil GetUser
metode , yang mengembalikan string yang mewakili pengguna saat ini. String ini ditampilkan di lokasi Substitution kontrol pada halaman. Bagian halaman ini tidak di-cache dan diperbarui setiap kali halaman disegarkan.
<%@ outputcache duration="60" varybyparam="none" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server" language="C#">
// The Substitution control calls this method to retrieve
// the name of the current user from the HttpContext object.
// This section of the page is exempt from output caching.
public static string GetUser(HttpContext context)
{
return context.User.Identity.Name;
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>Substitution.MethodName Property Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>Substitution.MethodName Property Example</h3>
<!--This section of the page is not cached.-->
Welcome to the site,
<asp:substitution id="Substitution1"
methodname="GetUser"
runat="Server">
</asp:substitution>
<br /><br />
<!--This section of the page is cached.-->
Product list:
<asp:bulletedlist id="ItemsBulletedList"
displaymode="Text"
runat="server">
<asp:ListItem>Product 1</asp:ListItem>
<asp:ListItem>Product 2</asp:ListItem>
<asp:ListItem>Product 3</asp:ListItem>
</asp:bulletedlist>
</form>
</body>
</html>
<%@ outputcache duration="60" varybyparam="none" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server" language="VB">
' The Substitution control calls this method to retrieve
' the name of the current user from the HttpContext object.
' This section of the page is exempt from output caching.
Shared Function GetUser(ByVal context As HttpContext) As String
Return context.User.Identity.Name
End Function
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>Substitution.MethodName Property Example</title>
</head>
<body>
<form id="Form1" runat="server">
<h3>Substitution.MethodName Property Example</h3>
<!--This section of the page is not cached.-->
Welcome to the site,
<asp:substitution id="Substitution1"
methodname="GetUser"
runat="Server">
</asp:substitution>
<br /><br />
<!--This section of the page is cached.-->
Product list:
<asp:bulletedlist id="ItemsBulletedList"
displaymode="Text"
runat="server">
<asp:ListItem>Product 1</asp:ListItem>
<asp:ListItem>Product 2</asp:ListItem>
<asp:ListItem>Product 3</asp:ListItem>
</asp:bulletedlist>
</form>
</body>
</html>
Keterangan
MethodName Gunakan properti untuk menentukan nama metode panggilan balik yang akan dipanggil saat Substitution kontrol dijalankan. Metode panggilan balik yang Anda tentukan harus merupakan metode statis pada halaman atau kontrol pengguna yang berisi Substitution kontrol. Tanda tangan untuk metode panggilan balik harus cocok dengan tanda tangan untuk HttpResponseSubstitutionCallback delegasi yang mengambil HttpContext parameter dan mengembalikan string. String yang dikembalikan metode panggilan balik adalah konten yang akan ditampilkan pada halaman di lokasi Substitution kontrol.
Parameter HttpContext merangkum semua informasi spesifik HTTP tentang permintaan HTTP individual. Anda dapat menggunakannya untuk mengakses variabel sesi, informasi otorisasi, dan detail personalisasi. Untuk informasi selengkapnya, lihat HttpResponseSubstitutionCallback.