Literal.Text 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 keterangan yang ditampilkan dalam Literal kontrol.
public:
property System::String ^ Text { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.Bindable(true)]
public string Text { get; set; }
[<System.ComponentModel.Bindable(true)>]
member this.Text : string with get, set
Public Property Text As String
Nilai Properti
Keterangan ditampilkan dalam Literal kontrol.
Penerapan
- Atribut
Contoh
Contoh berikut menunjukkan cara menggunakan Text properti untuk mengubah keterangan yang ditampilkan dalam Literal kontrol secara terprogram.
Catatan
Contoh berikut menggunakan model kode file tunggal dan mungkin tidak berfungsi dengan benar jika disalin langsung ke file code-behind. Contoh kode ini harus disalin ke dalam file teks kosong yang memiliki ekstensi .aspx. Untuk informasi selengkapnya tentang model kode Formulir Web, lihat Model Kode Halaman Formulir Web ASP.NET.
<%@ Page Language="C#" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Literal Example</title>
<script runat="server">
void ButtonClick(Object sender, EventArgs e)
{
Literal1.Text="Welcome to ASP.NET!!";
}
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Literal Example</h3>
<asp:Literal id="Literal1"
Text="Hello World!!"
runat="server"/>
<br /><br />
<asp:Button id="Button1"
Text="Change Literal Text"
OnClick="ButtonClick"
runat="server"/>
</form>
</body>
</html>
<%@ Page Language="VB" AutoEventWireup="True" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Literal Example</title>
<script runat="server">
Sub ButtonClick(sender As Object, e As EventArgs)
Literal1.Text="Welcome to ASP.NET!!"
End Sub
</script>
</head>
<body>
<form id="form1" runat="server">
<h3>Literal Example</h3>
<asp:Literal id="Literal1"
Text="Hello World!!"
runat="server"/>
<br /><br />
<asp:Button id="Button1"
Text="Change Literal Text"
OnClick="ButtonClick"
runat="server"/>
</form>
</body>
</html>
Keterangan
Text Gunakan properti untuk menentukan atau menentukan keterangan yang ditampilkan dalam Literal kontrol. Ini memungkinkan Anda untuk secara terprogram mengubah keterangan pada durasi.
Keterangan didekode HTML tergantung pada cara Anda menetapkan nilai ke properti ini. Jika Anda menetapkan nilai melalui atribut Literal kontrol, nilainya adalah HTML yang didekodekan sebelum ditampilkan. Misalnya, <asp:Literal id="DisplayLiteral" Text="A B"/>
dirender sebagai "A B" di browser. Namun, jika Anda mengatur properti ini secara terprogram atau dengan menempatkan teks antara tag pembuka dan penutup kontrol, keterangan tidak didekodekan HTML. Misalnya, <asp:Literal id="DisplayLiteral"> A B </asp:Literal>
dirender sebagai "A B".
Perhatian
Kontrol ini dapat digunakan untuk menampilkan input pengguna, yang mungkin menyertakan skrip klien berbahaya. Periksa informasi apa pun yang dikirim dari klien untuk skrip yang dapat dieksekusi, pernyataan SQL, atau kode lainnya sebelum menampilkannya di aplikasi Anda. ASP.NET menyediakan fitur validasi permintaan input untuk memblokir skrip dan HTML dalam input pengguna. Kontrol server validasi juga disediakan untuk menilai input pengguna. Untuk informasi selengkapnya, lihat Sintaks Kontrol Server Validasi.
Nilai properti ini, ketika diatur, dapat disimpan secara otomatis ke file sumber daya dengan menggunakan alat perancang. Untuk informasi selengkapnya, lihat LocalizableAttribute dan Globalisasi dan Pelokalan.