ContentPlaceHolder Kelas

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

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.

Menentukan wilayah untuk konten di halaman master ASP.NET.

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

Warisan: Object

Control
ContentPlaceHolder

Penerapan: INamingContainer

Contoh

Contoh kode berikut menunjukkan bagaimana ContentPlaceHolder kontrol digunakan untuk menentukan wilayah konten untuk halaman master. Halaman Web pertama adalah halaman master, dan menentukan wilayah konten menggunakan ContentPlaceHolder kontrol.

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

Contoh kode berikut menunjukkan halaman konten untuk halaman master sebelumnya. Teks, markup, dan kontrol server apa pun yang ditentukan dalam Content templat kontrol dirender ke ContentPlaceHolder halaman master.

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

Keterangan

ContentPlaceHolder Kontrol menentukan wilayah relatif untuk konten di halaman master, dan merender semua kontrol teks, markup, dan server dari kontrol terkait Content yang ditemukan di halaman konten.

Content Kontrol dikaitkan dengan ContentPlaceHolder menggunakan propertinyaContentPlaceHolderID. Atur ContentPlaceHolderID properti ke nilai ID properti kontrol terkait ContentPlaceHolder di halaman master. Lebih dari satu ContentPlaceHolder dapat dideklarasikan dalam halaman master.

Dalam halaman konten, hanya satu Content kontrol yang dapat menyediakan konten untuk ContentPlaceHolder di halaman master. Namun, di setiap halaman konten yang menggunakan halaman master, Anda dapat memiliki kontrol terpisah Content yang terkait dengan ContentPlaceHolder. Misalnya, Anda dapat menentukan ContentPlaceHolder untuk judul halaman di halaman master. Untuk setiap halaman konten yang menggunakan halaman master, Anda bisa menambahkan Content kontrol yang menyediakan teks dan markup untuk judul halaman.

Catatan

Untuk kepatuhan XHTML, elemen judul kosong dibuat jika judul belum ditentukan atau tidak dapat ditemukan.

Anda dapat menentukan konten default yang ditempatkan dalam ContentPlaceHolder tag kontrol, tetapi konten ini digantikan oleh konten apa pun di halaman konten terkait.

Untuk informasi selengkapnya tentang halaman master dan halaman konten, lihat DEL: ASP.NET Halaman Master.

Sintaks Deklaratif

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

Konstruktor

ContentPlaceHolder()

Menginisialisasi instans baru kelas ContentPlaceHolder.

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 mengimplementasikan IDataItemContainer. (Diperoleh dari Control)
DataKeysContainer	Mendapatkan referensi ke kontainer penamaan jika kontainer penamaan mengimplementasikan IDataKeysControl. (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 setiap kontrol anak 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 anak 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)
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 akan kompatibel dengan HTML yang dirender. (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)
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 kontrol server bahwa elemen, baik XML atau HTML, diurai, dan menambahkan elemen ke objek kontrol ControlCollection server. (Diperoleh dari Control)
ApplyStyleSheetSkin(Page)	Menerapkan properti gaya yang ditentukan dalam lembar gaya halaman ke kontrol. (Diperoleh dari Control)
BeginRenderTracing(TextWriter, Object)	Memulai pelacakan waktu desain untuk merender data. (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 `null`. (Diperoleh dari Control)
ClearChildControlState()	Menghapus informasi status-kontrol untuk kontrol anak 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 anak 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 baru ControlCollection untuk menahan kontrol anak (baik literal maupun server) dari kontrol server. (Diperoleh dari Control)
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 dilepaskan dari memori. (Diperoleh dari Control)
EndRenderTracing(TextWriter, Object)	Mengakhiri pelacakan waktu desain penyajian data. (Diperoleh dari Control)
EnsureChildControls()	Menentukan apakah kontrol server memuat kontrol turunan. Jika tidak, ia 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 `id` . (Diperoleh dari Control)
FindControl(String, Int32)	Mencari kontainer penamaan saat ini untuk kontrol server dengan bilangan bulat dan yang ditentukan `id` , yang ditentukan dalam `pathOffset` parameter , yang membantu dalam pencarian. Anda tidak boleh mengambil alih versi FindControl metode ini. (Diperoleh dari Control)
Focus()	Mengatur fokus input ke kontrol. (Diperoleh dari Control)
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 dari 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 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 Terbiasa 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 Control)
RenderChildren(HtmlTextWriter)	Menghasilkan 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 dilepaskan 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

IControlBuilderAccessor.ControlBuilder	Untuk deskripsi anggota ini, lihat ControlBuilder. (Diperoleh dari Control)
IControlDesignerAccessor.GetDesignModeState()	Untuk deskripsi anggota ini, lihat GetDesignModeState(). (Diperoleh dari Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Untuk deskripsi anggota ini, lihat SetDesignModeState(IDictionary). (Diperoleh dari Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Untuk deskripsi anggota ini, lihat SetOwnerControl(Control). (Diperoleh dari Control)
IControlDesignerAccessor.UserData	Untuk deskripsi anggota ini, lihat UserData. (Diperoleh dari Control)
IDataBindingsAccessor.DataBindings	Untuk deskripsi anggota ini, lihat DataBindings. (Diperoleh dari Control)
IDataBindingsAccessor.HasDataBindings	Untuk deskripsi anggota ini, lihat HasDataBindings. (Diperoleh dari Control)
IExpressionsAccessor.Expressions	Untuk deskripsi anggota ini, lihat Expressions. (Diperoleh dari Control)
IExpressionsAccessor.HasExpressions	Untuk deskripsi anggota ini, lihat HasExpressions. (Diperoleh dari Control)
IParserAccessor.AddParsedSubObject(Object)	Untuk deskripsi anggota ini, lihat AddParsedSubObject(Object). (Diperoleh dari Control)

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.
GetDefaultValues(INamingContainer)	Mendapatkan kumpulan nilai default untuk kontrol data yang ditentukan.
GetMetaTable(INamingContainer)	Mendapatkan metadata tabel untuk kontrol data yang ditentukan.
SetMetaTable(INamingContainer, MetaTable)	Mengatur metadata tabel untuk kontrol data yang ditentukan.
SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)	Mengatur metadata tabel dan pemetaan nilai default untuk kontrol data yang ditentukan.
SetMetaTable(INamingContainer, MetaTable, Object)	Mengatur metadata tabel dan pemetaan nilai default untuk kontrol data yang ditentukan.
TryGetMetaTable(INamingContainer, MetaTable)	Menentukan apakah metadata tabel tersedia.
EnableDynamicData(INamingContainer, Type)	Mengaktifkan perilaku Data Dinamis untuk kontrol data yang ditentukan.
EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)	Mengaktifkan perilaku Data Dinamis untuk kontrol data yang ditentukan.
EnableDynamicData(INamingContainer, Type, Object)	Mengaktifkan perilaku Data Dinamis untuk kontrol data yang ditentukan.

Berlaku untuk

Bagikan melalui