Literal Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.UI.WebControls

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Statik metin görüntülemek için Web sayfasında bir konum ayırır.

public ref class Literal : System::Web::UI::Control

public ref class Literal : System::Web::UI::Control, System::Web::UI::ITextControl

public class Literal : System.Web.UI.Control

public class Literal : System.Web.UI.Control, System.Web.UI.ITextControl

type Literal = class
    inherit Control

type Literal = class
    inherit Control
    interface ITextControl

Public Class Literal
Inherits Control

Public Class Literal
Inherits Control
Implements ITextControl

Devralma: Object

Control
Literal

Türetilmiş: System.Web.UI.WebControls.Localize

Uygulamalar: ITextControl

Örnekler

Aşağıdaki örnekte, statik metin görüntülemek için denetimin Literal nasıl kullanılacağı gösterilmektedir.

Not

Aşağıdaki örnek tek dosyalı kod modelini kullanır ve doğrudan arka planda kod içeren bir dosyaya kopyalandığında düzgün çalışmayabilir. Bu kod örneği, .aspx uzantısına sahip boş bir metin dosyasına kopyalanmalıdır. Web Forms kod modeli hakkında daha fazla bilgi için bkz. ASP.NET Web Forms Sayfa Kodu Modeli.


<%@ 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>

Açıklamalar

Bu konuda:

Giriş
Tanımlayıcı Sözdizimi

Giriş

System.Web.UI.WebControls.Literal Web sayfasında metin görüntülemek üzere bir konum ayırmak için denetimi kullanın. Denetim Literal , görüntülenen metne Label stil uygulamanıza izin vermemesi dışında Literal denetime benzer. özelliğini ayarlayarak denetimde görüntülenen metni program aracılığıyla denetleyebilirsiniz Text .

Dikkat

Bu denetim, kötü amaçlı istemci betiği içerebilecek kullanıcı girişini görüntülemek için kullanılabilir. Uygulamanızda görüntülemeden önce istemciden yürütülebilir betik, SQL deyimleri veya başka kodlar için gönderilen tüm bilgileri denetleyin. ASP.NET, kullanıcı girişinde betiği ve HTML'yi engellemek için bir giriş isteği doğrulama özelliği sağlar. Kullanıcı girişini değerlendirmek için doğrulama sunucusu denetimleri de sağlanır.

Güvenlik hakkında daha fazla bilgi için bkz. Standart Denetimlerin Güvenliğini Sağlama, Nasıl yapılır: Dizelere HTML Kodlaması Uygulayarak ve ASP.NET Web Sayfalarında Kullanıcı Girişini Doğrulayarak Web Uygulamasında Betik Açıklarına Karşı Koruma.

Tanımlayıcı Sözdizimi

<asp:Literal
    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"
/>

Oluşturucular

Literal()

Literal sınıfının yeni bir örneğini başlatır.

Özellikler

Adapter	Denetim için tarayıcıya özgü bağdaştırıcıyı alır. (Devralındığı yer: Control)
AppRelativeTemplateSourceDirectory	Bu denetimi içeren veya nesnesinin Page uygulama göreli sanal dizinini alır veya UserControl ayarlar. (Devralındığı yer: Control)
BindingContainer	Bu denetimin veri bağlamasını içeren denetimi alır. (Devralındığı yer: Control)
ChildControlsCreated	Sunucu denetiminin alt denetimlerinin oluşturulup oluşturulmadığını gösteren bir değer alır. (Devralındığı yer: Control)
ClientID	ASP.NET tarafından oluşturulan HTML işaretlemesinin denetim kimliğini alır. (Devralındığı yer: Control)
ClientIDMode	özelliğinin değerini oluşturmak için kullanılan algoritmayı ClientID alır veya ayarlar. (Devralındığı yer: Control)
ClientIDSeparator	özelliğinde ClientID kullanılan ayırıcı karakteri temsil eden bir karakter değeri alır. (Devralındığı yer: Control)
Context	HttpContext Geçerli Web isteği için sunucu denetimiyle ilişkili nesneyi alır. (Devralındığı yer: Control)
Controls	ControlCollection Kullanıcı arabirimi hiyerarşisindeki belirtilen sunucu denetimi için alt denetimleri temsil eden bir nesnesi alır. (Devralındığı yer: Control)
DataItemContainer	Adlandırma kapsayıcısı uygularsa IDataItemContaineradlandırma kapsayıcısına bir başvuru alır. (Devralındığı yer: Control)
DataKeysContainer	Adlandırma kapsayıcısı uygularsa IDataKeysControladlandırma kapsayıcısına bir başvuru alır. (Devralındığı yer: Control)
DesignMode	Bir denetimin tasarım yüzeyinde kullanılıp kullanılmadığını belirten bir değer alır. (Devralındığı yer: Control)
EnableTheming	Temaların bu denetime uygulanıp uygulanmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: Control)
EnableViewState	Sunucu denetiminin görünüm durumunu ve içerdiği alt denetimlerin görünüm durumunu istekte bulunan istemciye kalıcı hale getirip getirmek olmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: Control)
Events	Denetim için olay işleyicisi temsilcilerinin listesini alır. Bu özellik salt okunur durumdadır. (Devralındığı yer: Control)
HasChildViewState	Geçerli sunucu denetiminin alt denetimlerinin kaydedilmiş görünüm durumu ayarlarına sahip olup olmadığını gösteren bir değer alır. (Devralındığı yer: Control)
ID	Sunucu denetimine atanan program tanımlayıcısını alır veya ayarlar. (Devralındığı yer: Control)
IdSeparator	Denetim tanımlayıcılarını ayırmak için kullanılan karakteri alır. (Devralındığı yer: Control)
IsChildControlStateCleared	Bu denetim içindeki denetimlerin denetim durumuna sahip olup olmadığını belirten bir değer alır. (Devralındığı yer: Control)
IsTrackingViewState	Sunucu denetiminin değişiklikleri görünüm durumuna kaydedip kaydetmediğini gösteren bir değer alır. (Devralındığı yer: Control)
IsViewStateEnabled	Bu denetim için görünüm durumunun etkinleştirilip etkinleştirilmediğini belirten bir değer alır. (Devralındığı yer: Control)
LoadViewStateByID	Denetimin dizin yerine görünüm durumunu ID yüklemeye katılıp katılmadığını belirten bir değer alır. (Devralındığı yer: Control)
Mode	Denetimdeki Literal içeriğin nasıl işleneceğini belirten bir numaralandırma değeri alır veya ayarlar.
NamingContainer	Aynı özellik değerine sahip sunucu denetimleri arasında ayrım yapmak için benzersiz bir ad alanı oluşturan sunucu denetiminin adlandırma kapsayıcısına ID başvuru alır. (Devralındığı yer: Control)
Page	Sunucu denetimini içeren örneğe başvuru Page alır. (Devralındığı yer: Control)
Parent	Sayfa denetimi hiyerarşisindeki sunucu denetiminin üst denetimine başvuru alır. (Devralındığı yer: Control)
RenderingCompatibility	HTML'nin uyumlu olacağı ASP.NET sürümünü belirten bir değer alır. (Devralındığı yer: Control)
Site	Tasarım yüzeyinde işlendiğinde geçerli denetimi barındıran kapsayıcı hakkında bilgi alır. (Devralındığı yer: Control)
SkinID	Denetime uygulanacak kaplamayı alır veya ayarlar. (Devralındığı yer: Control)
TemplateControl	Bu denetimi içeren şablona başvuru alır veya ayarlar. (Devralındığı yer: Control)
TemplateSourceDirectory	Geçerli sunucu denetimini içeren veya UserControl sanal dizinini Page alır. (Devralındığı yer: Control)
Text	Denetimde Literal görüntülenen başlık alır veya ayarlar.
UniqueID	Sunucu denetimi için benzersiz, hiyerarşik olarak nitelenmiş tanımlayıcıyı alır. (Devralındığı yer: Control)
ValidateRequestMode	Denetimin tarayıcıdan istemci girişini tehlikeli olabilecek değerler için denetlediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: Control)
ViewState	Aynı sayfa için birden çok istekte bir sunucu denetiminin görünüm durumunu kaydetmenize ve geri yüklemenize olanak tanıyan durum bilgileri sözlüğü alır. (Devralındığı yer: Control)
ViewStateIgnoresCase	Nesnenin StateBag büyük/küçük harfe duyarlı olup olmadığını gösteren bir değer alır. (Devralındığı yer: Control)
ViewStateMode	Bu denetimin görünüm durumu modunu alır veya ayarlar. (Devralındığı yer: Control)
Visible	Sunucu denetiminin sayfada kullanıcı arabirimi olarak işlenip işlenmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: Control)

Yöntemler

AddedControl(Control, Int32)	Nesne koleksiyonuna Controls bir alt denetim eklendikten sonra çağrılır Control . (Devralındığı yer: Control)
AddParsedSubObject(Object)	Bir XML veya HTML öğesinin Literal ayrıştırıldığını denetime bildirir ve bu öğeyi denetimin öğesine ControlCollection ekler.
ApplyStyleSheetSkin(Page)	Sayfa stili sayfasında tanımlanan stil özelliklerini denetime uygular. (Devralındığı yer: Control)
BeginRenderTracing(TextWriter, Object)	İşleme verilerinin tasarım zamanı izlemeye başlar. (Devralındığı yer: Control)
BuildProfileTree(String, Boolean)	Sunucu denetimi hakkında bilgi toplar ve sayfa için izleme etkinleştirildiğinde görüntülenecek özelliğe teslim eder Trace . (Devralındığı yer: Control)
ClearCachedClientID()	Önbelleğe alınan ClientID değeri olarak `null`ayarlar. (Devralındığı yer: Control)
ClearChildControlState()	Sunucu denetiminin alt denetimleri için denetim durumu bilgilerini siler. (Devralındığı yer: Control)
ClearChildState()	Tüm sunucu denetiminin alt denetimleri için görünüm durumu ve denetim durumu bilgilerini siler. (Devralındığı yer: Control)
ClearChildViewState()	Tüm sunucu denetiminin alt denetimleri için görünüm durumu bilgilerini siler. (Devralındığı yer: Control)
ClearEffectiveClientIDMode()	ClientIDMode Geçerli denetim örneğinin ve alt denetimlerin özelliğini olarak Inheritayarlar. (Devralındığı yer: Control)
CreateChildControls()	ASP.NET sayfa çerçevesi tarafından, geri gönderme veya işleme hazırlığında içerdikleri alt denetimleri oluşturmak üzere birleşim tabanlı uygulama kullanan sunucu denetimlerini bilgilendirmek için çağrılır. (Devralındığı yer: Control)
CreateControlCollection()	Denetimin geçerli örneği Literal için bir EmptyControlCollection nesne oluşturur.
DataBind()	Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine bağlar. (Devralındığı yer: Control)
DataBind(Boolean)	Bir veri kaynağını çağrılan sunucu denetimine ve tüm alt denetimlerine olayı tetikle DataBinding seçeneğiyle bağlar. (Devralındığı yer: Control)
DataBindChildren()	Bir veri kaynağını sunucu denetiminin alt denetimlerine bağlar. (Devralındığı yer: Control)
Dispose()	Sunucu denetiminin bellekten serbest bırakılmadan önce son temizleme işlemini gerçekleştirmesini sağlar. (Devralındığı yer: Control)
EndRenderTracing(TextWriter, Object)	İşleme verilerinin tasarım zamanı izlemesini sonlandırır. (Devralındığı yer: Control)
EnsureChildControls()	Sunucu denetiminin alt denetimler içerip içermediğini belirler. Aksi takdirde alt denetimler oluşturur. (Devralındığı yer: Control)
EnsureID()	Atanmış tanımlayıcısı olmayan denetimler için bir tanımlayıcı oluşturur. (Devralındığı yer: Control)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
FindControl(String)	Belirtilen `id` parametreyle geçerli adlandırma kapsayıcısında bir sunucu denetimi arar. (Devralındığı yer: Control)
FindControl(String, Int32)	Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde belirtilen `id` bir tamsayı ile bir sunucu denetimi arar ve bu da `pathOffset` aramaya yardımcı olur. Yöntemin bu sürümünü FindControl geçersiz kılmamalısınız. (Devralındığı yer: Control)
Focus()	Giriş odağını bir denetime ayarlayın; Focus() temel denetim yöntemi bir Literal denetimde desteklenmez.
Focus()	Giriş odağını bir denetime ayarlar. (Devralındığı yer: Control)
GetDesignModeState()	Denetim için tasarım zamanı verilerini alır. (Devralındığı yer: Control)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetRouteUrl(Object)	Bir yol parametreleri kümesine karşılık gelen URL'yi alır. (Devralındığı yer: Control)
GetRouteUrl(RouteValueDictionary)	Bir yol parametreleri kümesine karşılık gelen URL'yi alır. (Devralındığı yer: Control)
GetRouteUrl(String, Object)	Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır. (Devralındığı yer: Control)
GetRouteUrl(String, RouteValueDictionary)	Bir yol parametreleri kümesine ve yol adına karşılık gelen URL'yi alır. (Devralındığı yer: Control)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
GetUniqueIDRelativeTo(Control)	Belirtilen denetimin özelliğinin UniqueID ön ekli bölümünü döndürür. (Devralındığı yer: Control)
HasControls()	Sunucu denetiminin alt denetimler içerip içermediğini belirler. (Devralındığı yer: Control)
HasEvents()	Olayların denetim için mi yoksa alt denetimler için mi kaydedildiğini gösteren bir değer döndürür. (Devralındığı yer: Control)
IsLiteralContent()	Sunucu denetiminin yalnızca değişmez değer içeriğini barındırdığını belirler. (Devralındığı yer: Control)
LoadControlState(Object)	yöntemi tarafından SaveControlState() kaydedilen önceki bir sayfa isteğinden denetim durumu bilgilerini geri yükler. (Devralındığı yer: Control)
LoadViewState(Object)	yöntemi tarafından SaveViewState() kaydedilen önceki bir sayfa isteğinden görünüm durumu bilgilerini geri yükler. (Devralındığı yer: Control)
MapPathSecure(String)	Bir sanal yolun mutlak veya göreli olarak eşlene olduğu fiziksel yolu alır. (Devralındığı yer: Control)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnBubbleEvent(Object, EventArgs)	Sunucu denetimi olayının sayfanın UI sunucu denetim hiyerarşisine geçirilip geçirilmeyeceğini belirler. (Devralındığı yer: Control)
OnDataBinding(EventArgs)	Olayı tetikler DataBinding . (Devralındığı yer: Control)
OnInit(EventArgs)	Olayı tetikler Init . (Devralındığı yer: Control)
OnLoad(EventArgs)	Olayı tetikler Load . (Devralındığı yer: Control)
OnPreRender(EventArgs)	Olayı tetikler PreRender . (Devralındığı yer: Control)
OnUnload(EventArgs)	Olayı tetikler Unload . (Devralındığı yer: Control)
OpenFile(String)	Stream Bir dosyayı okumak için kullanılan alır. (Devralındığı yer: Control)
RaiseBubbleEvent(Object, EventArgs)	Olayın tüm kaynaklarını ve bilgilerini denetimin üst öğesine atar. (Devralındığı yer: Control)
RemovedControl(Control)	Alt denetim nesne koleksiyonundan Controls kaldırıldıktan sonra çağrılır Control . (Devralındığı yer: Control)
Render(HtmlTextWriter)	Sunucu denetimi içeriğini, istemcide işlenecek içeriği yazan sağlanan HtmlTextWriter bir nesneye gönderir.
RenderChildren(HtmlTextWriter)	Sunucu denetiminin alt öğelerinin içeriğini sağlanan bir HtmlTextWriter nesneye aktarır ve istemcide işlenecek içeriği yazar. (Devralındığı yer: Control)
RenderControl(HtmlTextWriter)	Sunucu denetimi içeriğini sağlanan HtmlTextWriter bir nesneye aktarır ve izleme etkinse denetimle ilgili izleme bilgilerini depolar. (Devralındığı yer: Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Sağlanan bir nesneyi kullanarak sağlanan HtmlTextWriter bir nesneye sunucu denetimi içeriği çıkışı sağlar ControlAdapter . (Devralındığı yer: Control)
ResolveAdapter()	Belirtilen denetimin işlenmesinden sorumlu denetim bağdaştırıcısını alır. (Devralındığı yer: Control)
ResolveClientUrl(String)	Tarayıcı tarafından kullanılabilecek bir URL alır. (Devralındığı yer: Control)
ResolveUrl(String)	URL'yi istekte bulunan istemcide kullanılabilen bir URL'ye dönüştürür. (Devralındığı yer: Control)
SaveControlState()	Sayfanın sunucuya geri gönderildiği zamandan bu yana gerçekleşen tüm sunucu denetim durumu değişikliklerini kaydeder. (Devralındığı yer: Control)
SaveViewState()	Sayfanın sunucuya geri gönderildiği zamandan bu yana gerçekleşen tüm sunucu denetimi görünüm durumu değişikliklerini kaydeder. (Devralındığı yer: Control)
SetDesignModeState(IDictionary)	Denetim için tasarım zamanı verilerini ayarlar. (Devralındığı yer: Control)
SetRenderMethodDelegate(RenderMethod)	Sunucu denetimini ve içeriğini üst denetimine işlemek için bir olay işleyicisi temsilcisi atar. (Devralındığı yer: Control)
SetTraceData(Object, Object)	İzleme veri anahtarını ve izleme verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar. (Devralındığı yer: Control)
SetTraceData(Object, Object, Object)	İzlenen nesneyi, izleme veri anahtarını ve izleme verisi değerini kullanarak işleme verilerinin tasarım zamanı izlemesi için izleme verilerini ayarlar. (Devralındığı yer: Control)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
TrackViewState()	Sunucu denetiminin nesnesinde depolanabilmeleri için sunucu denetiminde görünüm durumu değişikliklerinin izlenmesine StateBag neden olur. Bu nesneye özelliği aracılığıyla ViewState erişilebilir. (Devralındığı yer: Control)

Ekinlikler

DataBinding	Sunucu denetimi bir veri kaynağına bağlandığında gerçekleşir. (Devralındığı yer: Control)
Disposed	ASP.NET sayfası istendiğinde sunucu denetimi yaşam döngüsünün son aşaması olan bellekten bir sunucu denetimi serbest bırakıldığında gerçekleşir. (Devralındığı yer: Control)
Init	Sunucu denetimi başlatıldığında gerçekleşir ve bu, yaşam döngüsünün ilk adımıdır. (Devralındığı yer: Control)
Load	Sunucu denetimi nesneye Page yüklendiğinde gerçekleşir. (Devralındığı yer: Control)
PreRender	Nesne yüklendikten sonra Control ancak işlemeden önce gerçekleşir. (Devralındığı yer: Control)
Unload	Sunucu denetimi bellekten kaldırıldığında gerçekleşir. (Devralındığı yer: Control)

Belirtik Arabirim Kullanımları

IControlBuilderAccessor.ControlBuilder	Bu üyenin açıklaması için bkz ControlBuilder. . (Devralındığı yer: Control)
IControlDesignerAccessor.GetDesignModeState()	Bu üyenin açıklaması için bkz GetDesignModeState(). . (Devralındığı yer: Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Bu üyenin açıklaması için bkz SetDesignModeState(IDictionary). . (Devralındığı yer: Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Bu üyenin açıklaması için bkz SetOwnerControl(Control). . (Devralındığı yer: Control)
IControlDesignerAccessor.UserData	Bu üyenin açıklaması için bkz UserData. . (Devralındığı yer: Control)
IDataBindingsAccessor.DataBindings	Bu üyenin açıklaması için bkz DataBindings. . (Devralındığı yer: Control)
IDataBindingsAccessor.HasDataBindings	Bu üyenin açıklaması için bkz HasDataBindings. . (Devralındığı yer: Control)
IExpressionsAccessor.Expressions	Bu üyenin açıklaması için bkz Expressions. . (Devralındığı yer: Control)
IExpressionsAccessor.HasExpressions	Bu üyenin açıklaması için bkz HasExpressions. . (Devralındığı yer: Control)
IParserAccessor.AddParsedSubObject(Object)	Bu üyenin açıklaması için bkz AddParsedSubObject(Object). . (Devralındığı yer: Control)

Uzantı Metotları

FindDataSourceControl(Control)	Belirtilen denetim için veri denetimiyle ilişkili veri kaynağını döndürür.
FindFieldTemplate(Control, String)	Belirtilen denetimin adlandırma kapsayıcısında belirtilen sütun için alan şablonunu döndürür.
FindMetaTable(Control)	İçeren veri denetimi için metatablo nesnesini döndürür.

Şunlara uygulanır