XmlDataSource 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.
Mewakili sumber data XML ke kontrol terikat data.
public ref class XmlDataSource : System::Web::UI::HierarchicalDataSourceControl, System::ComponentModel::IListSource, System::Web::UI::IDataSource[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.XmlDataSource))]
public class XmlDataSource : System.Web.UI.HierarchicalDataSourceControl, System.ComponentModel.IListSource, System.Web.UI.IDataSource[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.XmlDataSource))>]
type XmlDataSource = class
inherit HierarchicalDataSourceControl
interface IDataSource
interface IListSourcePublic Class XmlDataSource
Inherits HierarchicalDataSourceControl
Implements IDataSource, IListSource- Warisan
- Atribut
- Penerapan
Contoh
Bagian ini berisi dua contoh kode. Contoh kode pertama menunjukkan cara menggunakan XmlDataSource kontrol dengan TreeView kontrol untuk menampilkan data XML dari sampel file XML. Contoh kedua menunjukkan cara menggunakan XmlDataSource kontrol dengan kontrol templat Repeater untuk menampilkan data XML.
Contoh kode berikut menunjukkan cara menggunakan XmlDataSource kontrol dengan TreeView kontrol untuk menampilkan data XML. Memuat XmlDataSource data XML dari file XML yang diidentifikasi oleh DataFile properti .
<%@ Page Language="C#" %>
<!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 runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:xmldatasource
id="XmlDataSource1"
runat="server"
datafile="books.xml" />
<!- TreeView uses hierachical data, so the
XmlDataSource uses an XmlHierarchicalDataSourceView
when a TreeView is bound to it. -->
<asp:TreeView
id="TreeView1"
runat="server"
datasourceid="XmlDataSource1">
<databindings>
<asp:treenodebinding datamember="book" textfield="title"/>
</databindings>
</asp:TreeView>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!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 runat="server">
<title>ASP.NET Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:xmldatasource
id="XmlDataSource1"
runat="server"
datafile="books.xml" />
<!- TreeView uses hierachical data, so the
XmlDataSource uses an XmlHierarchicalDataSourceView
when a TreeView is bound to it. -->
<asp:TreeView
id="TreeView1"
runat="server"
datasourceid="XmlDataSource1">
<databindings>
<asp:treenodebinding datamember="book" textfield="title"/>
</databindings>
</asp:TreeView>
</form>
</body>
</html>
File XML dalam contoh kode memiliki data berikut:
<books>
<computerbooks>
<book title="Secrets of Silicon Valley" author="Sheryl Hunter"/>
<book title="Straight Talk About Computers" author="Dean Straight"/>
<book title="You Can Combat Computer Stress!" author="Marjorie Green"/>
</computerbooks>
<cookbooks>
<book title="Silicon Valley Gastronomic Treats" author="Innes del Castill"/>
</cookbooks>
</books>
Contoh kode berikut menunjukkan cara menggunakan XmlDataSource kontrol dengan kontrol templat Repeater untuk menampilkan data XML. Kontrol Repeater menggunakan ekspresi pengikatan data JalurX untuk mengikat item data dalam dokumen XML yang diwakili XmlDataSource . Untuk informasi selengkapnya tentang XPath dan XPathSelect sintaks pengikatan data, lihat XPathBinder kelas .
<%@ Page Language="C#" %>
<!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 runat="server">
<title>Order</title>
</head>
<body>
<form id="form1" runat="server">
<asp:XmlDataSource
runat="server"
id="XmlDataSource1"
XPath="orders/order"
DataFile="order.xml" />
<asp:Repeater ID="Repeater1"
runat="server"
DataSourceID="XmlDataSource1">
<ItemTemplate>
<h2>Order</h2>
<table>
<tr>
<td>Customer</td>
<td><%#XPath("customer/@id")%></td>
<td><%#XPath("customername/firstn")%></td>
<td><%#XPath("customername/lastn")%></td>
</tr>
<tr>
<td>Ship To</td>
<td><%#XPath("shipaddress/address1")%></font></td>
<td><%#XPath("shipaddress/city")%></td>
<td><%#XPath("shipaddress/state")%>,
<%#XPath("shipaddress/zip")%></td>
</tr>
</table>
<h3>Order Summary</h3>
<asp:Repeater ID="Repeater2"
DataSource='<%#XPathSelect("summary/item")%>'
runat="server">
<ItemTemplate>
<b><%#XPath("@dept")%></b> -
<%#XPath(".")%><br />
</ItemTemplate>
</asp:Repeater>
<hr />
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!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 runat="server">
<title>Order</title>
</head>
<body>
<form id="form1" runat="server">
<asp:XmlDataSource
runat="server"
id="XmlDataSource1"
XPath="orders/order"
DataFile="order.xml" />
<asp:Repeater ID="Repeater1"
runat="server"
DataSourceID="XmlDataSource1">
<ItemTemplate>
<h2>Order</h2>
<table>
<tr>
<td>Customer</td>
<td><%#XPath("customer/@id")%></td>
<td><%#XPath("customername/firstn")%></td>
<td><%#XPath("customername/lastn")%></td>
</tr>
<tr>
<td>Ship To</td>
<td><%#XPath("shipaddress/address1")%></font></td>
<td><%#XPath("shipaddress/city")%></td>
<td><%#XPath("shipaddress/state")%>,
<%#XPath("shipaddress/zip")%></td>
</tr>
</table>
<h3>Order Summary</h3>
<asp:Repeater ID="Repeater2"
DataSource='<%#XPathSelect("summary/item")%>'
runat="server">
<ItemTemplate>
<b><%#XPath("@dept")%></b> -
<%#XPath(".")%><br />
</ItemTemplate>
</asp:Repeater>
<hr />
</ItemTemplate>
</asp:Repeater>
</form>
</body>
</html>
File XML dalam contoh kode memiliki data berikut:
<?xml version="1.0" encoding="iso-8859-1"?>
<orders>
<order>
<customer id="12345" />
<customername>
<firstn>John</firstn>
<lastn>Smith</lastn>
</customername>
<transaction id="12345" />
<shipaddress>
<address1>1234 Tenth Avenue</address1>
<city>Bellevue</city>
<state>Washington</state>
<zip>98001</zip>
</shipaddress>
<summary>
<item dept="tools">screwdriver</item>
<item dept="tools">hammer</item>
<item dept="plumbing">fixture</item>
</summary>
</order>
</orders>
Keterangan
Dalam topik ini:
Pengantar
Kontrol XmlDataSource adalah kontrol sumber data yang menyajikan data XML ke kontrol terikat data. XmlDataSource Kontrol dapat digunakan oleh kontrol terikat data untuk menampilkan data hierarkis dan tabular. XmlDataSource Kontrol biasanya digunakan untuk menampilkan data XML hierarkis dalam skenario baca-saja. XmlDataSource Karena kontrol memperluas HierarchicalDataSourceControl kelas, kontrol berfungsi dengan data hierarkis. Kontrol ini XmlDataSource juga mengimplementasikan IDataSource antarmuka dan bekerja dengan data tabular, atau gaya daftar.
Catatan
Untuk tujuan keamanan, tidak ada XmlDataSource properti kontrol yang disimpan dalam status tampilan. Karena secara teknis dimungkinkan untuk mendekode konten status tampilan pada klien, menyimpan informasi sensitif tentang struktur data atau kontennya dapat mengekspos Anda ke ancaman pengungkapan informasi. Perhatikan bahwa jika Anda perlu menyimpan informasi seperti XPath properti dalam status tampilan, Anda dapat mengaktifkan enkripsi untuk melindungi konten dengan mengatur ViewStateEncryptionMode pada @ Page direktif.
Pengembang halaman XmlDataSource menggunakan kontrol untuk menampilkan data XML menggunakan kontrol terikat data.
Sumber Data XML
biasanya XmlDataSource memuat data XML dari file XML, yang ditentukan oleh DataFile properti . Data XML juga dapat disimpan langsung oleh kontrol sumber data dalam formulir string menggunakan Data properti . Jika Anda ingin mengubah data XML sebelum ditampilkan oleh kontrol terikat data, Anda dapat menyediakan lembar gaya Extensible Stylesheet Language (XSL) untuk transformasi. Seperti halnya data XML, Anda biasanya memuat lembar gaya dari file, yang ditunjukkan TransformFile oleh properti , tetapi Anda juga dapat menyimpannya dalam bentuk string secara langsung menggunakan Transform properti .
Memperbarui Data XML
XmlDataSource Kontrol ini biasanya digunakan dalam skenario data baca-saja di mana kontrol terikat data menampilkan data XML. Namun, Anda juga dapat menggunakan XmlDataSource kontrol untuk mengedit data XML. Untuk mengedit data XML, panggil GetXmlDocument metode untuk mengambil XmlDataDocument objek yang merupakan representasi dalam memori data XML. Anda dapat menggunakan model objek yang diekspos oleh XmlDataDocument objek dan XmlNode yang dikandungnya atau menggunakan ekspresi pemfilteran JalurX untuk memanipulasi data dalam dokumen. Ketika Anda telah membuat perubahan pada representasi dalam memori data XML, Anda dapat menyimpannya ke disk dengan memanggil Save metode .
Ada beberapa batasan untuk kemampuan XmlDataSource pengeditan kontrol:
Data XML harus dimuat dari file XML yang ditunjukkan oleh DataFile properti , bukan dari XML sebaris yang ditentukan dalam Data properti .
Tidak ada transformasi XSLT yang dapat ditentukan dalam Transform properti atau TransformFile .
Metode Save ini tidak menangani operasi penyimpanan bersamaan dengan permintaan yang berbeda. Jika lebih dari satu pengguna mengedit file XML melalui XmlDataSource, tidak ada jaminan bahwa semua pengguna beroperasi dengan data yang sama. Operasi juga dapat Save gagal karena masalah konkurensi yang sama ini.
Menentukan Transformasi XSL
Operasi umum yang dilakukan dengan data XML mengubahnya dari satu himpunan data XML ke himpunan data XML lainnya. Kontrol XmlDataSource mendukung transformasi XML dengan Transform properti dan TransformFile , yang menentukan lembar gaya XSL untuk diterapkan ke data XML sebelum diteruskan ke kontrol terikat data, dan TransformArgumentList properti , yang memungkinkan Anda menyediakan argumen lembar gaya XSLT dinamis untuk digunakan oleh lembar gaya XSL selama transformasi. Jika Anda menentukan ekspresi pemfilteran JalurX menggunakan XPath properti , ekspresi tersebut diterapkan setelah transformasi terjadi.
Catatan
Kelas XmlDataSource ini menggunakan kelas yang tidak XslTransform digunakan lagi untuk melakukan transformasi XSL. Jika Anda ingin menggunakan fitur lembar gaya yang diperkenalkan setelah XslTransform kelas tidak digunakan lagi, terapkan transformasi secara manual dengan menggunakan XslCompiledTransform kelas .
Pemfilteran menggunakan Ekspresi JalurX
Secara default, XmlDataSource kontrol memuat semua data XML dalam file XML yang diidentifikasi oleh DataFile properti atau ditemukan sebaris di Data properti , tetapi Anda dapat memfilter data menggunakan ekspresi JalurX. Properti XPath mendukung filter sintaks XPath yang diterapkan setelah data XML dimuat dan diubah.
penembolokan
Untuk tujuan performa, penembolokan diaktifkan untuk XmlDataSource kontrol secara default. Membuka dan membaca file XML di server setiap kali halaman yang diminta dapat mengurangi performa aplikasi Anda. Penembolokan memungkinkan Anda mengurangi beban pemrosesan di server Anda dengan mengorbankan memori di server Web; dalam kebanyakan kasus ini adalah trade-off yang baik. Cache XmlDataSource data secara otomatis saat EnableCaching properti diatur ke true, dan CacheDuration properti diatur ke jumlah detik cache menyimpan data sebelum cache tidak valid. Anda dapat menggunakan CacheExpirationPolicy untuk menyempurnakan perilaku penembolokan kontrol sumber data lebih lanjut.
Fitur Tambahan
Tabel berikut ini mencantumkan fitur tambahan yang didukung oleh XmlDataSource kontrol.
| Kemampuan | Deskripsi |
|---|---|
| Pengurutan | Tidak didukung oleh XmlDataSource kontrol. |
| Pemfilteran | Properti XPath dapat digunakan untuk memfilter data XML menggunakan ekspresi JalurX yang sesuai. |
| Penomoran | Tidak didukung oleh XmlDataSource kontrol. |
| Memperbarui | Didukung dengan memanipulasi XmlDataDocument secara langsung dan kemudian memanggil Save metode . |
| Menghapus | Didukung dengan memanipulasi XmlDataDocument secara langsung dan kemudian memanggil Save metode . |
| Memasukkan | Didukung dengan memanipulasi XmlDataDocument secara langsung dan kemudian memanggil Save metode . |
| penembolokan | Diaktifkan secara default, dengan properti diatur CacheDuration ke 0 (tak terbatas) dan CacheExpirationPolicy properti diatur ke Absolute. |
Objek Tampilan Data
XmlDataSource Karena kontrol mendukung kontrol terikat data yang menampilkan data hierarkis serta kontrol yang menampilkan data tabular, kontrol sumber data mendukung beberapa jenis objek tampilan sumber data pada data XML yang mendasarnya. Kontrol XmlDataSource mengambil satu objek bernama XmlDataSourceView saat digunakan dengan kontrol terikat data yang menampilkan data tabular. Metode GetViewNames mengidentifikasi tampilan bernama tunggal ini. Saat digunakan dengan kontrol terikat data yang menampilkan data hierarkis, XmlDataSource kontrol mengambil untuk jalur hierarkis unik yang XmlHierarchicalDataSourceView diteruskan ke GetHierarchicalView metode .
Sintaks Deklaratif
<asp:XmlDataSource
CacheDuration="string|Infinite"
CacheExpirationPolicy="Absolute|Sliding"
CacheKeyDependency="string"
DataFile="string"
EnableCaching="True|False"
EnableTheming="True|False"
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"
OnTransforming="Transforming event handler"
OnUnload="Unload event handler"
runat="server"
SkinID="string"
TransformArgumentList="string"
TransformFile="string"
Visible="True|False"
XPath="string"
>
<Data>string</Data>
<Transform>string</Transform>
</asp:XmlDataSource>
Konstruktor
| XmlDataSource() |
Membuat instans XmlDataSource baru kelas. |
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) |
| CacheDuration |
Mendapatkan atau mengatur lamanya waktu, dalam hitungan detik, bahwa kontrol sumber data menyimpan data yang telah diambilnya. |
| CacheExpirationPolicy |
Mendapatkan atau mengatur kebijakan kedaluwarsa cache yang dikombinasikan dengan durasi cache untuk menjelaskan perilaku penembolokan cache yang digunakan kontrol sumber data. |
| CacheKeyContext |
Mendapatkan atau mengatur nilai kunci cache untuk kontrol sumber data dari status tampilan, atau menambahkan kunci cache untuk melihat status. |
| CacheKeyDependency |
Mendapatkan atau mengatur dependensi kunci yang ditentukan pengguna yang ditautkan ke semua objek cache data yang dibuat oleh kontrol sumber data. Semua objek cache secara eksplisit kedaluwarsa saat kunci kedaluwarsa. |
| ChildControlsCreated |
Mendapatkan nilai yang menunjukkan apakah kontrol anak kontrol server telah dibuat. (Diperoleh dari Control) |
| ClientID |
Mendapatkan pengidentifikasi kontrol server yang dihasilkan oleh ASP.NET. (Diperoleh dari HierarchicalDataSourceControl) |
| ClientIDMode |
Properti ini tidak digunakan untuk kontrol sumber data. (Diperoleh dari HierarchicalDataSourceControl) |
| 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 HierarchicalDataSourceControl) |
| Data |
Mendapatkan atau mengatur blok data XML yang diikat kontrol sumber data. |
| DataFile |
Menentukan nama file XML yang diikat sumber data. |
| 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) |
| EnableCaching |
Mendapatkan atau menetapkan nilai yang menunjukkan apakah XmlDataSource kontrol mengaktifkan penembolokan data. |
| EnableTheming |
Mendapatkan nilai yang menunjukkan apakah kontrol ini mendukung tema. (Diperoleh dari HierarchicalDataSourceControl) |
| 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) |
| 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 HierarchicalDataSourceControl kontrol. (Diperoleh dari HierarchicalDataSourceControl) |
| 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) |
| Transform |
Mendapatkan atau mengatur blok data Extensible Stylesheet Language (XSL) yang menentukan transformasi XSLT yang akan dilakukan pada data XML yang XmlDataSource dikelola oleh kontrol. |
| TransformArgumentList |
Menyediakan daftar argumen XSLT yang digunakan dengan lembar gaya yang ditentukan oleh Transform properti atau TransformFile untuk melakukan transformasi pada data XML. |
| TransformFile |
Menentukan nama file file Extensible Stylesheet Language (XSL) (.xsl) yang menentukan transformasi XSLT yang akan dilakukan pada data XML yang XmlDataSource dikelola oleh kontrol. |
| 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 ditampilkan secara visual. (Diperoleh dari HierarchicalDataSourceControl) |
| XPath |
Menentukan ekspresi JalurX yang akan diterapkan ke data XML yang dimuat oleh Data properti atau oleh file XML yang ditunjukkan DataFile oleh properti . |
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 HierarchicalDataSourceControl) |
| 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 baru ControlCollection untuk menahan kontrol anak (baik harfiah maupun server) kontrol server. (Diperoleh dari HierarchicalDataSourceControl) |
| 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() |
Mengatur fokus input ke kontrol. (Diperoleh dari HierarchicalDataSourceControl) |
| GetDesignModeState() |
Mendapatkan data waktu desain untuk kontrol. (Diperoleh dari Control) |
| GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
| GetHierarchicalView(String) |
Mendapatkan objek tampilan sumber data untuk XmlDataSource kontrol. Parameter |
| 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) |
| GetXmlDocument() |
Memuat data XML ke dalam memori, baik langsung dari penyimpanan data yang mendasar atau dari cache, dan mengembalikannya dalam bentuk XmlDataDocument objek. |
| HasControls() |
Menentukan apakah kontrol server berisi kontrol anak apa pun. (Diperoleh dari HierarchicalDataSourceControl) |
| 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) |
| OnDataSourceChanged(EventArgs) |
Memunculkan kejadian DataSourceChanged. (Diperoleh dari HierarchicalDataSourceControl) |
| OnInit(EventArgs) |
Memunculkan kejadian Init. (Diperoleh dari Control) |
| OnLoad(EventArgs) |
Memunculkan kejadian Load. (Diperoleh dari Control) |
| OnPreRender(EventArgs) |
Memunculkan kejadian PreRender. (Diperoleh dari Control) |
| OnTransforming(EventArgs) |
Transforming Menaikkan peristiwa sebelum XmlDataSource kontrol melakukan transformasi XSLT pada data XML-nya. |
| 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 Control) |
| 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 HierarchicalDataSourceControl) |
| 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) |
| Save() |
Menyimpan data XML yang saat ini disimpan dalam memori oleh XmlDataSource kontrol ke disk jika DataFile properti diatur. |
| 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) |
| Transforming |
Terjadi sebelum lembar gaya yang ditentukan oleh Transform properti atau diidentifikasi oleh TransformFile properti diterapkan ke data XML. |
| 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. |
| GetDefaultValues(IDataSource) |
Mendapatkan kumpulan nilai default untuk sumber data yang ditentukan. |
| GetMetaTable(IDataSource) |
Mendapatkan metadata untuk tabel di objek sumber data yang ditentukan. |
| TryGetMetaTable(IDataSource, MetaTable) |
Menentukan apakah metadata tabel tersedia. |
Berlaku untuk
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk