Localize Kelas
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.
Mencadangkan lokasi pada halaman Web untuk menampilkan teks statis yang dilokalkan.
public ref class Localize : System::Web::UI::WebControls::Literal
[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.Localize))]
public class Localize : System.Web.UI.WebControls.Literal
[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.Localize))>]
type Localize = class
inherit Literal
Public Class Localize
Inherits Literal
- Warisan
- Atribut
Contoh
Contoh kode berikut menunjukkan cara menggunakan Localize kontrol untuk menampilkan teks statis.
Catatan
Contoh kode 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>Localize Example</title>
<script runat="server">
void ButtonClick(Object sender, EventArgs e)
{
Localize1.Text="Welcome to ASP.NET!! This is localized text.";
}
</script>
</head>
<body>
<form id="Form1" runat="server">
<h3>Localize Example</h3>
<asp:Localize id="Localize1"
Text="Hello World!!"
runat="server"/>
<br /><br />
<asp:Button id="Button1"
Text="Change Localize 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>Localize Example</title>
<script runat="server">
Sub ButtonClick(ByVal sender As [Object], ByVal e As EventArgs)
Localize1.Text = "Welcome to ASP.NET!! This is localized text."
End Sub 'ButtonClick
</script>
</head>
<body>
<form id="Form1" runat="server">
<h3>Localize Example</h3>
<asp:Localize id="Localize1"
Text="Hello World!!"
runat="server"/>
<br /><br />
<asp:Button id="Button1"
Text="Change Localize Text"
OnClick="ButtonClick"
runat="server"/>
</form>
</body>
</html>
Keterangan
Dalam topik ini:
Pengantar
Localize Gunakan kontrol untuk memesan lokasi pada halaman Web untuk menampilkan teks yang dilokalkan.
Catatan
Kontrol yang berada di luar body
elemen diabaikan.
Localize Kontrol mewarisi dari Literal kontrol dan identik dengannya dalam segala hal. Kontrol Localize digunakan pada waktu desain untuk membedakan teks statis yang dapat dilokalkan dari teks statis lainnya. Label Meskipun kontrol memungkinkan Anda menerapkan gaya ke teks yang ditampilkan, Localize kontrol tidak. Anda dapat mengelola teks yang ditampilkan dalam kontrol secara terprogram dengan mengatur Literal.Text properti yang diwarisi dari Literal kontrol.
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 Mengamankan Kontrol Standar, Cara: Melindungi Dari Eksploitasi Skrip dalam Aplikasi Web dengan Menerapkan Pengodean HTML ke String, dan Memvalidasi Input Pengguna di Halaman Web ASP.NET.
Sintaks Deklaratif
<asp:Localize
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
Mode="Transform|PassThrough|Encode"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
Text="string"
Visible="True|False"
/>
Konstruktor
Localize() |
Menginisialisasi instans baru kelas Localize. |
Properti
Adapter |
Mendapatkan adaptor khusus browser untuk kontrol. (Diperoleh dari Control) |
AppRelativeTemplateSourceDirectory |
Mendapatkan atau mengatur direktori virtual relatif aplikasi dari Page objek atau UserControl yang berisi kontrol ini. (Diperoleh dari Control) |
BindingContainer |
Mendapatkan kontrol yang berisi pengikatan data kontrol ini. (Diperoleh dari Control) |
ChildControlsCreated |
Mendapatkan nilai yang menunjukkan apakah kontrol anak kontrol server telah dibuat. (Diperoleh dari Control) |
ClientID |
Mendapatkan ID kontrol untuk markup HTML yang dihasilkan oleh ASP.NET. (Diperoleh dari Control) |
ClientIDMode |
Mendapatkan atau mengatur algoritma yang digunakan untuk menghasilkan nilai ClientID properti. (Diperoleh dari Control) |
ClientIDSeparator |
Mendapatkan nilai karakter yang mewakili karakter pemisah yang digunakan dalam ClientID properti . (Diperoleh dari Control) |
Context |
Mendapatkan objek yang HttpContext terkait dengan kontrol server untuk permintaan Web saat ini. (Diperoleh dari Control) |
Controls |
ControlCollection Mendapatkan objek yang mewakili kontrol anak untuk kontrol server tertentu dalam hierarki UI. (Diperoleh dari Control) |
DataItemContainer |
Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan IDataItemContainermengimplementasikan . (Diperoleh dari Control) |
DataKeysContainer |
Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan IDataKeysControlmengimplementasikan . (Diperoleh dari Control) |
DesignMode |
Mendapatkan nilai yang menunjukkan apakah kontrol sedang digunakan pada permukaan desain. (Diperoleh dari Control) |
EnableTheming |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah tema berlaku untuk kontrol ini. (Diperoleh dari Control) |
EnableViewState |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server mempertahankan status tampilannya, dan status tampilan kontrol anak apa pun yang dikandungnya, ke klien yang meminta. (Diperoleh dari Control) |
Events |
Mendapatkan daftar delegasi penanganan aktivitas untuk kontrol. Properti ini bersifat hanya baca. (Diperoleh dari Control) |
HasChildViewState |
Mendapatkan nilai yang menunjukkan apakah kontrol turunan kontrol server saat ini memiliki pengaturan status tampilan yang disimpan. (Diperoleh dari Control) |
ID |
Mendapatkan atau mengatur pengidentifikasi terprogram yang ditetapkan ke kontrol server. (Diperoleh dari Control) |
IdSeparator |
Mendapatkan karakter yang digunakan untuk memisahkan pengidentifikasi kontrol. (Diperoleh dari Control) |
IsChildControlStateCleared |
Mendapatkan nilai yang menunjukkan apakah kontrol yang terkandung dalam kontrol ini memiliki status kontrol. (Diperoleh dari Control) |
IsTrackingViewState |
Mendapatkan nilai yang menunjukkan apakah kontrol server menyimpan perubahan pada status tampilannya. (Diperoleh dari Control) |
IsViewStateEnabled |
Mendapatkan nilai yang menunjukkan apakah status tampilan diaktifkan untuk kontrol ini. (Diperoleh dari Control) |
LoadViewStateByID |
Mendapatkan nilai yang menunjukkan apakah kontrol berpartisipasi dalam memuat status tampilannya dengan ID bukan indeks. (Diperoleh dari Control) |
Mode |
Mendapatkan atau mengatur nilai enumerasi yang menentukan bagaimana konten dalam kontrol dirender Literal . (Diperoleh dari Literal) |
NamingContainer |
Mendapatkan referensi ke kontainer penamaan kontrol server, yang membuat namespace unik untuk membedakan antara kontrol server dengan nilai properti yang sama ID . (Diperoleh dari Control) |
Page |
Mendapatkan referensi ke Page instans yang berisi kontrol server. (Diperoleh dari Control) |
Parent |
Mendapatkan referensi ke kontrol induk kontrol server dalam hierarki kontrol halaman. (Diperoleh dari Control) |
RenderingCompatibility |
Mendapatkan nilai yang menentukan versi ASP.NET yang dirender HTML akan kompatibel. (Diperoleh dari Control) |
Site |
Mendapatkan informasi tentang kontainer yang menghosting kontrol saat ini saat dirender pada permukaan desain. (Diperoleh dari Control) |
SkinID |
Mendapatkan atau mengatur kulit untuk diterapkan pada kontrol. (Diperoleh dari Control) |
TemplateControl |
Mendapatkan atau mengatur referensi ke templat yang berisi kontrol ini. (Diperoleh dari Control) |
TemplateSourceDirectory |
Mendapatkan direktori Page virtual atau UserControl yang berisi kontrol server saat ini. (Diperoleh dari Control) |
Text |
Mendapatkan atau mengatur keterangan yang ditampilkan dalam Literal kontrol. (Diperoleh dari Literal) |
UniqueID |
Mendapatkan pengidentifikasi unik yang memenuhi syarat secara hierarkis untuk kontrol server. (Diperoleh dari Control) |
ValidateRequestMode |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol memeriksa input klien dari browser untuk nilai yang berpotensi berbahaya. (Diperoleh dari Control) |
ViewState |
Mendapatkan kamus informasi status yang memungkinkan Anda menyimpan dan memulihkan status tampilan kontrol server di beberapa permintaan untuk halaman yang sama. (Diperoleh dari Control) |
ViewStateIgnoresCase |
Mendapatkan nilai yang menunjukkan apakah StateBag objek tidak peka huruf besar/kecil. (Diperoleh dari Control) |
ViewStateMode |
Mendapatkan atau mengatur mode view-state kontrol ini. (Diperoleh dari Control) |
Visible |
Mendapatkan atau mengatur nilai yang menunjukkan apakah kontrol server dirender sebagai UI di halaman. (Diperoleh dari Control) |
Metode
AddedControl(Control, Int32) |
Dipanggil setelah kontrol anak ditambahkan ke Controls koleksi Control objek. (Diperoleh dari Control) |
AddParsedSubObject(Object) |
Memberi tahu Literal kontrol bahwa elemen XML atau HTML diurai dan menambahkan elemen tersebut ke ControlCollection kontrol. (Diperoleh dari Literal) |
ApplyStyleSheetSkin(Page) |
Menerapkan properti gaya yang ditentukan dalam lembar gaya halaman ke kontrol. (Diperoleh dari Control) |
BeginRenderTracing(TextWriter, Object) |
Memulai pelacakan waktu desain dari data penyajian. (Diperoleh dari Control) |
BuildProfileTree(String, Boolean) |
Mengumpulkan informasi tentang kontrol server dan mengirimkannya ke properti yang Trace akan ditampilkan saat pelacakan diaktifkan untuk halaman. (Diperoleh dari Control) |
ClearCachedClientID() |
Mengatur nilai yang di-cache ClientID ke |
ClearChildControlState() |
Menghapus informasi status kontrol untuk kontrol turunan kontrol server. (Diperoleh dari Control) |
ClearChildState() |
Menghapus informasi status tampilan dan status kontrol untuk semua kontrol turunan kontrol server. (Diperoleh dari Control) |
ClearChildViewState() |
Menghapus informasi status tampilan untuk semua kontrol turunan kontrol server. (Diperoleh dari Control) |
ClearEffectiveClientIDMode() |
Mengatur properti instans ClientIDMode kontrol saat ini dan kontrol turunan apa pun ke Inherit. (Diperoleh dari Control) |
CreateChildControls() |
Dipanggil oleh kerangka kerja halaman ASP.NET untuk memberi tahu kontrol server yang menggunakan implementasi berbasis komposisi untuk membuat kontrol anak apa pun yang dikandungnya sebagai persiapan untuk memposting kembali atau merender. (Diperoleh dari Control) |
CreateControlCollection() |
Membuat objek untuk instans EmptyControlCollectionLiteral kontrol saat ini. (Diperoleh dari Literal) |
DataBind() |
Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya. (Diperoleh dari Control) |
DataBind(Boolean) |
Mengikat sumber data ke kontrol server yang dipanggil dan semua kontrol turunannya dengan opsi untuk menaikkan DataBinding peristiwa. (Diperoleh dari Control) |
DataBindChildren() |
Mengikat sumber data ke kontrol anak kontrol server. (Diperoleh dari Control) |
Dispose() |
Memungkinkan kontrol server untuk melakukan pembersihan akhir sebelum dirilis dari memori. (Diperoleh dari Control) |
EndRenderTracing(TextWriter, Object) |
Mengakhiri pelacakan waktu desain data penyajian. (Diperoleh dari Control) |
EnsureChildControls() |
Menentukan apakah kontrol server berisi kontrol anak. Jika tidak, itu membuat kontrol anak. (Diperoleh dari Control) |
EnsureID() |
Membuat pengidentifikasi untuk kontrol yang tidak memiliki pengidentifikasi yang ditetapkan. (Diperoleh dari Control) |
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
FindControl(String) |
Mencari kontainer penamaan saat ini untuk kontrol server dengan parameter yang ditentukan |
FindControl(String, Int32) |
Mencari kontainer penamaan saat ini untuk kontrol server dengan yang ditentukan |
Focus() |
Atur fokus input ke kontrol; Focus() metode kontrol dasar tidak didukung pada Literal kontrol. (Diperoleh dari Literal) |
GetDesignModeState() |
Mendapatkan data waktu desain untuk kontrol. (Diperoleh dari Control) |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetRouteUrl(Object) |
Mendapatkan URL yang sesuai dengan sekumpulan parameter rute. (Diperoleh dari Control) |
GetRouteUrl(RouteValueDictionary) |
Mendapatkan URL yang sesuai dengan sekumpulan parameter rute. (Diperoleh dari Control) |
GetRouteUrl(String, Object) |
Mendapatkan URL yang sesuai dengan sekumpulan parameter rute dan nama rute. (Diperoleh dari Control) |
GetRouteUrl(String, RouteValueDictionary) |
Mendapatkan URL yang sesuai dengan sekumpulan parameter rute dan nama rute. (Diperoleh dari Control) |
GetType() |
Mendapatkan instans Type saat ini. (Diperoleh dari Object) |
GetUniqueIDRelativeTo(Control) |
Mengembalikan bagian awalan dari UniqueID properti kontrol yang ditentukan. (Diperoleh dari Control) |
HasControls() |
Menentukan apakah kontrol server berisi kontrol anak apa pun. (Diperoleh dari Control) |
HasEvents() |
Mengembalikan nilai yang menunjukkan apakah peristiwa terdaftar untuk kontrol atau kontrol turunan apa pun. (Diperoleh dari Control) |
IsLiteralContent() |
Menentukan apakah kontrol server hanya menyimpan konten harfiah. (Diperoleh dari Control) |
LoadControlState(Object) |
Memulihkan informasi status kontrol dari permintaan halaman sebelumnya yang disimpan oleh SaveControlState() metode . (Diperoleh dari Control) |
LoadViewState(Object) |
Memulihkan informasi status tampilan dari permintaan halaman sebelumnya yang disimpan oleh SaveViewState() metode . (Diperoleh dari Control) |
MapPathSecure(String) |
Mengambil jalur fisik tempat jalur virtual, baik absolut atau relatif, dipetakan. (Diperoleh dari Control) |
MemberwiseClone() |
Membuat salinan dangkal dari yang saat ini Object. (Diperoleh dari Object) |
OnBubbleEvent(Object, EventArgs) |
Menentukan apakah peristiwa untuk kontrol server diteruskan ke hierarki kontrol server UI halaman. (Diperoleh dari Control) |
OnDataBinding(EventArgs) |
Memunculkan kejadian DataBinding. (Diperoleh dari Control) |
OnInit(EventArgs) |
Memunculkan kejadian Init. (Diperoleh dari Control) |
OnLoad(EventArgs) |
Memunculkan kejadian Load. (Diperoleh dari Control) |
OnPreRender(EventArgs) |
Memunculkan kejadian PreRender. (Diperoleh dari Control) |
OnUnload(EventArgs) |
Memunculkan kejadian Unload. (Diperoleh dari Control) |
OpenFile(String) |
Stream Menggunakan untuk membaca file. (Diperoleh dari Control) |
RaiseBubbleEvent(Object, EventArgs) |
Menetapkan sumber peristiwa apa pun dan informasinya ke induk kontrol. (Diperoleh dari Control) |
RemovedControl(Control) |
Dipanggil setelah kontrol anak dihapus dari Controls koleksi Control objek. (Diperoleh dari Control) |
Render(HtmlTextWriter) |
Mengirim konten kontrol server ke objek yang disediakan HtmlTextWriter , yang menulis konten yang akan dirender pada klien. (Diperoleh dari Literal) |
RenderChildren(HtmlTextWriter) |
Mengeluarkan konten turunan kontrol server ke objek yang disediakan HtmlTextWriter , yang menulis konten yang akan dirender pada klien. (Diperoleh dari Control) |
RenderControl(HtmlTextWriter) |
Output konten kontrol server ke objek yang disediakan HtmlTextWriter dan menyimpan informasi pelacakan tentang kontrol jika pelacakan diaktifkan. (Diperoleh dari Control) |
RenderControl(HtmlTextWriter, ControlAdapter) |
Output konten kontrol server ke objek yang disediakan HtmlTextWriter menggunakan objek yang disediakan ControlAdapter . (Diperoleh dari Control) |
ResolveAdapter() |
Mendapatkan adaptor kontrol yang bertanggung jawab untuk merender kontrol yang ditentukan. (Diperoleh dari Control) |
ResolveClientUrl(String) |
Mendapatkan URL yang dapat digunakan oleh browser. (Diperoleh dari Control) |
ResolveUrl(String) |
Mengonversi URL menjadi URL yang dapat digunakan pada klien yang meminta. (Diperoleh dari Control) |
SaveControlState() |
Menyimpan perubahan status kontrol server yang telah terjadi sejak halaman diposting kembali ke server. (Diperoleh dari Control) |
SaveViewState() |
Menyimpan perubahan status tampilan kontrol server yang telah terjadi sejak halaman diposting kembali ke server. (Diperoleh dari Control) |
SetDesignModeState(IDictionary) |
Mengatur data waktu desain untuk kontrol. (Diperoleh dari Control) |
SetRenderMethodDelegate(RenderMethod) |
Menetapkan delegasi penanganan aktivitas untuk merender kontrol server dan kontennya ke dalam kontrol induknya. (Diperoleh dari Control) |
SetTraceData(Object, Object) |
Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan kunci data pelacakan dan nilai data pelacakan. (Diperoleh dari Control) |
SetTraceData(Object, Object, Object) |
Mengatur data pelacakan untuk pelacakan waktu desain data penyajian, menggunakan objek yang dilacak, kunci data pelacakan, dan nilai data pelacakan. (Diperoleh dari Control) |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
TrackViewState() |
Menyebabkan pelacakan perubahan status tampilan pada kontrol server sehingga dapat disimpan di objek kontrol StateBag server. Objek ini dapat diakses melalui ViewState properti . (Diperoleh dari Control) |
Acara
DataBinding |
Terjadi ketika kontrol server mengikat ke sumber data. (Diperoleh dari Control) |
Disposed |
Terjadi ketika kontrol server dirilis dari memori, yang merupakan tahap terakhir dari siklus hidup kontrol server ketika halaman ASP.NET diminta. (Diperoleh dari Control) |
Init |
Terjadi ketika kontrol server diinisialisasi, yang merupakan langkah pertama dalam siklus hidupnya. (Diperoleh dari Control) |
Load |
Terjadi ketika kontrol server dimuat ke Page dalam objek. (Diperoleh dari Control) |
PreRender |
Terjadi setelah Control objek dimuat tetapi sebelum penyajian. (Diperoleh dari Control) |
Unload |
Terjadi ketika kontrol server dibongkar dari memori. (Diperoleh dari Control) |
Implementasi Antarmuka Eksplisit
Metode Ekstensi
FindDataSourceControl(Control) |
Mengembalikan sumber data yang terkait dengan kontrol data untuk kontrol yang ditentukan. |
FindFieldTemplate(Control, String) |
Mengembalikan templat bidang untuk kolom yang ditentukan dalam kontainer penamaan kontrol yang ditentukan. |
FindMetaTable(Control) |
Mengembalikan objek metatable untuk kontrol data yang berisi. |