ContentPlaceHolder Sınıf
Tanım
Ö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.
ASP.NET ana sayfasındaki içerik için bir bölge tanımlar.
public ref class ContentPlaceHolder : System::Web::UI::Control
public class ContentPlaceHolder : System.Web.UI.Control
type ContentPlaceHolder = class
inherit Control
interface INamingContainer
Public Class ContentPlaceHolder
Inherits Control
- Devralma
- Uygulamalar
Örnekler
Aşağıdaki kod örneği, denetimin ContentPlaceHolder ana sayfa için içerik bölgesi tanımlamak için nasıl kullanıldığını gösterir. İlk Web sayfası bir ana sayfadır ve denetim kullanarak ContentPlaceHolder bir içerik bölgesi tanımlar.
<%@ Master Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>MasterPage Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:contentplaceholder id="ContentPlaceHolder1" runat="server" />
</div>
</form>
</body>
</html>
Aşağıdaki kod örneği, önceki ana sayfa için bir içerik sayfası gösterir. Denetim şablonunda Content tanımlanan metin, işaretleme ve tüm sunucu denetimleri ana sayfada öğesine işlenir ContentPlaceHolder .
public class SampleMasterClass : System.Web.UI.MasterPage {
private string sitename;
public string SiteName
{
get {return(sitename);}
set {sitename = value;}
}
}
Class SampleMasterClass
Inherits System.Web.UI.MasterPage
Dim asitename As String
Public Property SiteName() As String
Get
Return asitename
End Get
Set(ByVal Value as String)
asitename = Value
End Set
End Property
End Class
Açıklamalar
Denetim ContentPlaceHolder , ana sayfadaki içerik için göreli bir bölge tanımlar ve içerik sayfasında bulunan ilgili Content bir denetimden tüm metin, işaretleme ve sunucu denetimlerini işler.
DenetimContent, özelliğini ContentPlaceHolderID kullanan ile ContentPlaceHolder ilişkilendirilir. ContentPlaceHolderID özelliğini bir ana sayfadaki ilgili ContentPlaceHolder denetimin özelliğinin değerine ID ayarlayın. Ana sayfada birden ContentPlaceHolder fazla bildirilebilir.
İçerik sayfasında, ana sayfadaki için yalnızca Content bir ContentPlaceHolder denetim içerik sağlayabilir. Ancak, ana sayfa kullanan her içerik sayfasında, ile ContentPlaceHolderilişkilendirilmiş ayrı Content denetimleriniz olabilir. Örneğin, bir ana sayfada sayfa başlığı için öğesini tanımlayabilirsiniz ContentPlaceHolder . Ana sayfayı kullanan her içerik sayfası için, sayfa başlığı için metin ve işaretleme sağlayan bir Content denetim ekleyebilirsiniz.
Not
XHTML uyumluluğu için, bir başlık tanımlanmamışsa veya bulunamazsa boş bir başlık öğesi oluşturulur.
Denetim etiketlerine ContentPlaceHolder yerleştirilen varsayılan içeriği belirtebilirsiniz, ancak bu içerik ilişkili içerik sayfasındaki tüm içeriklerle değiştirilir.
Ana sayfalar ve içerik sayfaları hakkında daha fazla bilgi için bkz . DEL: ASP.NET Ana Sayfalar.
Tanımlayıcı Sözdizimi
<asp: ContentPlaceHolder
EnableViewState="True|False"
ID="string"
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"
Visible="True|False"
>
<!-- child controls -->
</asp:ContentPlaceHolder>
Oluşturucular
ContentPlaceHolder() |
ContentPlaceHolder 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 |
Kullanıcı arabirimi hiyerarşisinde belirtilen sunucu ControlCollection 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 uygulanmayacağı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 taşımadığı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ı belirten bir değer alır. (Devralındığı yer: Control) |
ID |
Sunucu denetimine atanan programlı tanımlayıcıyı 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 belirten 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) |
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) |
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) |
Sunucu denetimine XML veya HTML gibi bir öğenin ayrıştırıldığını bildirir ve öğeyi sunucu denetiminin ControlCollection nesnesine ekler. (Devralındığı yer: Control) |
ApplyStyleSheetSkin(Page) |
Sayfa stili sayfasında tanımlanan stil özelliklerini denetime uygular. (Devralındığı yer: Control) |
BeginRenderTracing(TextWriter, Object) |
İşleme verilerinin tasarım zamanı izlemesini başlatır. (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 Trace eder. (Devralındığı yer: Control) |
ClearCachedClientID() |
Önbelleğe alınan ClientID değeri olarak |
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 oluşturma tabanlı uygulama kullanan sunucu denetimlerini bilgilendirmek için çağrılır. (Devralındığı yer: Control) |
CreateControlCollection() |
Sunucu denetiminin alt denetimlerini (hem değişmez değer hem de sunucu) tutmak için yeni ControlCollection bir nesne oluşturur. (Devralındığı yer: Control) |
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 çıkmadan ö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 |
FindControl(String, Int32) |
Geçerli adlandırma kapsayıcısında belirtilen ve parametresinde |
Focus() |
Giriş odağını 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 belirten bir değer döndürür. (Devralındığı yer: Control) |
IsLiteralContent() |
Sunucu denetiminin yalnızca değişmez içeriği 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 sayfa isteğinden görünüm durumu bilgilerini geri yükler. (Devralındığı yer: Control) |
MapPathSecure(String) |
Mutlak veya göreli bir sanal yolun eşlendiğini 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 kullanıcı arabirimi sunucu denetimi 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) |
Bir 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. (Devralındığı yer: Control) |
RenderChildren(HtmlTextWriter) |
Sunucu denetiminin alt öğelerinin içeriğini sağlanan HtmlTextWriter bir 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 sunucu denetimi içeriğini sağlanan HtmlTextWriterControlAdapter bir nesneye aktarır. (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 bir sayfa 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. 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ı
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 meta tablo nesnesini döndürür. |
GetDefaultValues(INamingContainer) |
Belirtilen veri denetimi için varsayılan değerlerin koleksiyonunu alır. |
GetMetaTable(INamingContainer) |
Belirtilen veri denetimi için tablo meta verilerini alır. |
SetMetaTable(INamingContainer, MetaTable) |
Belirtilen veri denetimi için tablo meta verilerini ayarlar. |
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>) |
Belirtilen veri denetimi için tablo meta verilerini ve varsayılan değer eşlemesini ayarlar. |
SetMetaTable(INamingContainer, MetaTable, Object) |
Belirtilen veri denetimi için tablo meta verilerini ve varsayılan değer eşlemesini ayarlar. |
TryGetMetaTable(INamingContainer, MetaTable) |
Tablo meta verilerinin kullanılabilir olup olmadığını belirler. |
EnableDynamicData(INamingContainer, Type) |
Belirtilen veri denetimi için Dinamik Veri davranışını etkinleştirir. |
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>) |
Belirtilen veri denetimi için Dinamik Veri davranışını etkinleştirir. |
EnableDynamicData(INamingContainer, Type, Object) |
Belirtilen veri denetimi için Dinamik Veri davranışını etkinleştirir. |