DataSourceControl 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.
Berfungsi sebagai kelas dasar untuk kontrol yang mewakili sumber data ke kontrol terikat data.
public ref class DataSourceControl abstract : System::Web::UI::Control, System::ComponentModel::IListSource, System::Web::UI::IDataSource
[System.ComponentModel.Bindable(false)]
public abstract class DataSourceControl : System.Web.UI.Control, System.ComponentModel.IListSource, System.Web.UI.IDataSource
[<System.ComponentModel.Bindable(false)>]
type DataSourceControl = class
inherit Control
interface IDataSource
interface IListSource
Public MustInherit Class DataSourceControl
Inherits Control
Implements IDataSource, IListSource
- Warisan
- Turunan
- Atribut
- Penerapan
Contoh
Contoh kode berikut menunjukkan bagaimana kelas dapat memperluas DataSourceControl kelas.
CsvDataSource
Kontrol mewakili data file yang dipisahkan koma yang disimpan dalam file .csv. Kelas CsvDataSource
menyediakan implementasi sendiri dari GetView, GetViewNames, dan metode lainnya, karena implementasi kelas dasar tidak berfungsi.
using System;
using System.Collections;
using System.Data;
using System.IO;
using System.Security.Permissions;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
// The CsvDataSource is a data source control that retrieves its
// data from a comma-separated value file.
[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
public class CsvDataSource : DataSourceControl
{
public CsvDataSource() : base() {}
// The comma-separated value file to retrieve data from.
public string FileName {
get {
return ((CsvDataSourceView)this.GetView(String.Empty)).SourceFile;
}
set {
// Only set if it is different.
if ( ((CsvDataSourceView)this.GetView(String.Empty)).SourceFile != value) {
((CsvDataSourceView)this.GetView(String.Empty)).SourceFile = value;
RaiseDataSourceChangedEvent(EventArgs.Empty);
}
}
}
// Do not add the column names as a data row. Infer columns if the CSV file does
// not include column names.
public bool IncludesColumnNames {
get {
return ((CsvDataSourceView)this.GetView(String.Empty)).IncludesColumnNames;
}
set {
// Only set if it is different.
if ( ((CsvDataSourceView)this.GetView(String.Empty)).IncludesColumnNames != value) {
((CsvDataSourceView)this.GetView(String.Empty)).IncludesColumnNames = value;
RaiseDataSourceChangedEvent(EventArgs.Empty);
}
}
}
// Return a strongly typed view for the current data source control.
private CsvDataSourceView view = null;
protected override DataSourceView GetView(string viewName) {
if (null == view) {
view = new CsvDataSourceView(this, String.Empty);
}
return view;
}
// The ListSourceHelper class calls GetList, which
// calls the DataSourceControl.GetViewNames method.
// Override the original implementation to return
// a collection of one element, the default view name.
protected override ICollection GetViewNames() {
ArrayList al = new ArrayList(1);
al.Add(CsvDataSourceView.DefaultViewName);
return al as ICollection;
}
}
// The CsvDataSourceView class encapsulates the
// capabilities of the CsvDataSource data source control.
public class CsvDataSourceView : DataSourceView
{
public CsvDataSourceView(IDataSource owner, string name) :base(owner, DefaultViewName) {
}
// The data source view is named. However, the CsvDataSource
// only supports one view, so the name is ignored, and the
// default name used instead.
public static string DefaultViewName = "CommaSeparatedView";
// The location of the .csv file.
private string sourceFile = String.Empty;
internal string SourceFile {
get {
return sourceFile;
}
set {
// Use MapPath when the SourceFile is set, so that files local to the
// current directory can be easily used.
string mappedFileName = HttpContext.Current.Server.MapPath(value);
sourceFile = mappedFileName;
}
}
// Do not add the column names as a data row. Infer columns if the CSV file does
// not include column names.
private bool columns = false;
internal bool IncludesColumnNames {
get {
return columns;
}
set {
columns = value;
}
}
// Get data from the underlying data source.
// Build and return a DataView, regardless of mode.
protected override IEnumerable ExecuteSelect(DataSourceSelectArguments selectArgs) {
IEnumerable dataList = null;
// Open the .csv file.
if (File.Exists(this.SourceFile)) {
DataTable data = new DataTable();
// Open the file to read from.
using (StreamReader sr = File.OpenText(this.SourceFile)) {
// Parse the line
string s = "";
string[] dataValues;
DataColumn col;
// Do the following to add schema.
dataValues = sr.ReadLine().Split(',');
// For each token in the comma-delimited string, add a column
// to the DataTable schema.
foreach (string token in dataValues) {
col = new DataColumn(token,typeof(string));
data.Columns.Add(col);
}
// Do not add the first row as data if the CSV file includes column names.
if (! IncludesColumnNames)
data.Rows.Add(CopyRowData(dataValues, data.NewRow()));
// Do the following to add data.
while ((s = sr.ReadLine()) != null) {
dataValues = s.Split(',');
data.Rows.Add(CopyRowData(dataValues, data.NewRow()));
}
}
data.AcceptChanges();
DataView dataView = new DataView(data);
if (!string.IsNullOrEmpty(selectArgs.SortExpression)) {
dataView.Sort = selectArgs.SortExpression;
}
dataList = dataView;
}
else {
throw new System.Configuration.ConfigurationErrorsException("File not found, " + this.SourceFile);
}
if (null == dataList) {
throw new InvalidOperationException("No data loaded from data source.");
}
return dataList;
}
private DataRow CopyRowData(string[] source, DataRow target) {
try {
for (int i = 0;i < source.Length;i++) {
target[i] = source[i];
}
}
catch (System.IndexOutOfRangeException) {
// There are more columns in this row than
// the original schema allows. Stop copying
// and return the DataRow.
return target;
}
return target;
}
// The CsvDataSourceView does not currently
// permit deletion. You can modify or extend
// this sample to do so.
public override bool CanDelete {
get {
return false;
}
}
protected override int ExecuteDelete(IDictionary keys, IDictionary values)
{
throw new NotSupportedException();
}
// The CsvDataSourceView does not currently
// permit insertion of a new record. You can
// modify or extend this sample to do so.
public override bool CanInsert {
get {
return false;
}
}
protected override int ExecuteInsert(IDictionary values)
{
throw new NotSupportedException();
}
// The CsvDataSourceView does not currently
// permit update operations. You can modify or
// extend this sample to do so.
public override bool CanUpdate {
get {
return false;
}
}
protected override int ExecuteUpdate(IDictionary keys, IDictionary values, IDictionary oldValues)
{
throw new NotSupportedException();
}
}
Imports System.Collections
Imports System.Data
Imports System.IO
Imports System.Security.Permissions
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Namespace Samples.AspNet.VB.Controls
' The CsvDataSource is a data source control that retrieves its
' data from a comma-separated value file.
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
Public Class CsvDataSource
Inherits DataSourceControl
Public Sub New()
End Sub
' The comma-separated value file to retrieve data from.
Public Property FileName() As String
Get
Return CType(Me.GetView([String].Empty), CsvDataSourceView).SourceFile
End Get
Set
' Only set if it is different.
If CType(Me.GetView([String].Empty), CsvDataSourceView).SourceFile <> value Then
CType(Me.GetView([String].Empty), CsvDataSourceView).SourceFile = value
RaiseDataSourceChangedEvent(EventArgs.Empty)
End If
End Set
End Property
' Do not add the column names as a data row. Infer columns if the CSV file does
' not include column names.
Public Property IncludesColumnNames() As Boolean
Get
Return CType(Me.GetView([String].Empty), CsvDataSourceView).IncludesColumnNames
End Get
Set
' Only set if it is different.
If CType(Me.GetView([String].Empty), CsvDataSourceView).IncludesColumnNames <> value Then
CType(Me.GetView([String].Empty), CsvDataSourceView).IncludesColumnNames = value
RaiseDataSourceChangedEvent(EventArgs.Empty)
End If
End Set
End Property
' Return a strongly typed view for the current data source control.
Private view As CsvDataSourceView = Nothing
Protected Overrides Function GetView(viewName As String) As DataSourceView
If view Is Nothing Then
view = New CsvDataSourceView(Me, String.Empty)
End If
Return view
End Function 'GetView
' The ListSourceHelper class calls GetList, which
' calls the DataSourceControl.GetViewNames method.
' Override the original implementation to return
' a collection of one element, the default view name.
Protected Overrides Function GetViewNames() As ICollection
Dim al As New ArrayList(1)
al.Add(CsvDataSourceView.DefaultViewName)
Return CType(al, ICollection)
End Function 'GetViewNames
End Class
' The CsvDataSourceView class encapsulates the
' capabilities of the CsvDataSource data source control.
Public Class CsvDataSourceView
Inherits DataSourceView
Public Sub New(owner As IDataSource, name As String)
MyBase.New(owner, DefaultViewName)
End Sub
' The data source view is named. However, the CsvDataSource
' only supports one view, so the name is ignored, and the
' default name used instead.
Public Shared DefaultViewName As String = "CommaSeparatedView"
' The location of the .csv file.
Private aSourceFile As String = [String].Empty
Friend Property SourceFile() As String
Get
Return aSourceFile
End Get
Set
' Use MapPath when the SourceFile is set, so that files local to the
' current directory can be easily used.
Dim mappedFileName As String
mappedFileName = HttpContext.Current.Server.MapPath(value)
aSourceFile = mappedFileName
End Set
End Property
' Do not add the column names as a data row. Infer columns if the CSV file does
' not include column names.
Private columns As Boolean = False
Friend Property IncludesColumnNames() As Boolean
Get
Return columns
End Get
Set
columns = value
End Set
End Property
' Get data from the underlying data source.
' Build and return a DataView, regardless of mode.
Protected Overrides Function ExecuteSelect(selectArgs As DataSourceSelectArguments) _
As System.Collections.IEnumerable
Dim dataList As IEnumerable = Nothing
' Open the .csv file.
If File.Exists(Me.SourceFile) Then
Dim data As New DataTable()
' Open the file to read from.
Dim sr As StreamReader = File.OpenText(Me.SourceFile)
Try
' Parse the line
Dim dataValues() As String
Dim col As DataColumn
' Do the following to add schema.
dataValues = sr.ReadLine().Split(","c)
' For each token in the comma-delimited string, add a column
' to the DataTable schema.
Dim token As String
For Each token In dataValues
col = New DataColumn(token, System.Type.GetType("System.String"))
data.Columns.Add(col)
Next token
' Do not add the first row as data if the CSV file includes column names.
If Not IncludesColumnNames Then
data.Rows.Add(CopyRowData(dataValues, data.NewRow()))
End If
' Do the following to add data.
Dim s As String
Do
s = sr.ReadLine()
If Not s Is Nothing Then
dataValues = s.Split(","c)
data.Rows.Add(CopyRowData(dataValues, data.NewRow()))
End If
Loop Until s Is Nothing
Finally
sr.Close()
End Try
data.AcceptChanges()
Dim dataView As New DataView(data)
If Not selectArgs.SortExpression Is String.Empty Then
dataView.Sort = selectArgs.SortExpression
End If
dataList = dataView
Else
Throw New System.Configuration.ConfigurationErrorsException("File not found, " + Me.SourceFile)
End If
If dataList is Nothing Then
Throw New InvalidOperationException("No data loaded from data source.")
End If
Return dataList
End Function 'ExecuteSelect
Private Function CopyRowData([source]() As String, target As DataRow) As DataRow
Try
Dim i As Integer
For i = 0 To [source].Length - 1
target(i) = [source](i)
Next i
Catch iore As IndexOutOfRangeException
' There are more columns in this row than
' the original schema allows. Stop copying
' and return the DataRow.
Return target
End Try
Return target
End Function 'CopyRowData
' The CsvDataSourceView does not currently
' permit deletion. You can modify or extend
' this sample to do so.
Public Overrides ReadOnly Property CanDelete() As Boolean
Get
Return False
End Get
End Property
Protected Overrides Function ExecuteDelete(keys As IDictionary, values As IDictionary) As Integer
Throw New NotSupportedException()
End Function 'ExecuteDelete
' The CsvDataSourceView does not currently
' permit insertion of a new record. You can
' modify or extend this sample to do so.
Public Overrides ReadOnly Property CanInsert() As Boolean
Get
Return False
End Get
End Property
Protected Overrides Function ExecuteInsert(values As IDictionary) As Integer
Throw New NotSupportedException()
End Function 'ExecuteInsert
' The CsvDataSourceView does not currently
' permit update operations. You can modify or
' extend this sample to do so.
Public Overrides ReadOnly Property CanUpdate() As Boolean
Get
Return False
End Get
End Property
Protected Overrides Function ExecuteUpdate(keys As IDictionary, _
values As IDictionary, _
oldValues As IDictionary) As Integer
Throw New NotSupportedException()
End Function 'ExecuteUpdate
End Class
End Namespace
Contoh kode berikut menunjukkan cara menggunakan CsvDataSource
kontrol dalam formulir Web.
<%@ Page Language="C#" %>
<%@ Register Tagprefix="aspSample"
Namespace="Samples.AspNet.CS.Controls" %>
<!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:gridview
id="GridView1"
runat="server"
allowsorting="True"
datasourceid="CsvDataSource1" />
<aspSample:CsvDataSource
id = "CsvDataSource1"
runat = "server"
filename = "sample.csv"
includescolumnnames="True" />
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Register Tagprefix="aspSample"
Namespace="Samples.AspNet.VB.Controls" %>
<!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:gridview
id="GridView1"
runat="server"
allowsorting="True"
datasourceid="CsvDataSource1" />
<aspSample:CsvDataSource
id = "CsvDataSource1"
runat = "server"
filename = "sample.csv"
includescolumnnames="True" />
</form>
</body>
</html>
Keterangan
ASP.NET mendukung arsitektur pengikatan data kontrol yang memungkinkan kontrol server Web untuk mengikat data secara konsisten. Kontrol server web yang mengikat data disebut sebagai kontrol terikat data, dan kelas yang memfasilitasi bahwa pengikatan disebut kontrol sumber data. Kontrol sumber data dapat mewakili sumber data apa pun: database relasional, file, aliran, objek bisnis, dan sebagainya. Kontrol sumber data menyajikan data dengan cara yang konsisten untuk kontrol terikat data, terlepas dari sumber atau format data yang mendasar.
Anda menggunakan kontrol sumber data yang disediakan dengan ASP.NET, termasuk SqlDataSource, , AccessDataSourcedan XmlDataSource, untuk melakukan sebagian besar tugas pengembangan Web. Anda menggunakan kelas dasar DataSourceControl saat ingin menerapkan kontrol sumber data kustom Anda sendiri.
Meskipun kelas apa pun yang mengimplementasikan IDataSource antarmuka adalah kontrol sumber data, sebagian besar kontrol sumber data ASP.NET memperluas kelas abstrak DataSourceControl , yang menyediakan implementasi IDataSource dasar antarmuka. Kelas ini DataSourceControl juga menyediakan implementasi IListSource antarmuka, yang memungkinkan Anda menetapkan kontrol sumber data secara terprogram ke DataSource
properti kontrol terikat data dan mengembalikan data ke kontrol sebagai daftar dasar.
Kontrol ASP.NET apa pun yang berasal dari DataBoundControl kelas dapat mengikat kontrol sumber data.
DataBoundControl Saat terikat ke kontrol sumber data, pengikatan data dilakukan secara otomatis pada durasi. Anda juga dapat menggunakan kontrol sumber data dengan kontrol ASP.NET yang mengekspos DataSource
properti atau DataSourceID
dan mendukung pengikatan data dasar, tetapi tidak berasal dari DataBoundControl. Saat menggunakan kontrol terikat data ini, Anda harus secara eksplisit memanggil metode .DataBind
Untuk informasi selengkapnya tentang pengikatan data, lihat ASP.NET Peta Konten Akses Data.
Anda dapat menganggap kontrol sumber data sebagai kombinasi DataSourceControl objek dan daftar data terkait, yang disebut tampilan sumber data. Setiap daftar data diwakili oleh DataSourceView objek . Karena penyimpanan data yang mendasar berisi satu atau beberapa daftar data, DataSourceControl selalu dikaitkan dengan satu atau beberapa objek bernama DataSourceView . Antarmuka IDataSource menentukan metode yang digunakan semua kontrol sumber data untuk berinteraksi dengan tampilan sumber data: GetViewNames metode ini digunakan untuk menghitung tampilan sumber data yang saat ini terkait dengan kontrol sumber data, dan GetView metode digunakan untuk mengambil instans tampilan sumber data tertentu berdasarkan nama.
Anda juga dapat menganggap kontrol sumber data sebagai dua antarmuka berbeda yang digunakan pemanggil untuk mengakses data. Kelas DataSourceControl adalah antarmuka yang berinteraksi dengan pengembang halaman secara langsung saat mengembangkan halaman Formulir Web, dan DataSourceView kelas adalah antarmuka yang berinteraksi dengan kontrol terikat data dan penulis kontrol terikat data. DataSourceView Karena objek hanya tersedia pada waktu proses, status apa pun yang bertahan untuk kontrol sumber data atau tampilan sumber data harus diekspos langsung oleh kontrol sumber data.
Tidak ada penyajian visual kontrol sumber data ASP.NET; mereka diimplementasikan sebagai kontrol sehingga Anda dapat membuatnya secara deklaratif, dan secara opsional memungkinkan mereka untuk berpartisipasi dalam manajemen status. Akibatnya, kontrol sumber data tidak mendukung fitur visual seperti EnableTheming atau SkinID.
Konstruktor
DataSourceControl() |
Menginisialisasi instans baru kelas DataSourceControl. |
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 pengidentifikasi kontrol server yang dihasilkan oleh ASP.NET. |
ClientIDMode |
Properti ini tidak digunakan untuk kontrol sumber data. |
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. |
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 nilai yang menunjukkan apakah kontrol ini mendukung tema. |
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 kulit untuk diterapkan pada DataSourceControl kontrol. |
TemplateControl |
Mendapatkan atau mengatur referensi ke templat yang berisi kontrol ini. (Diperoleh dari Control) |
TemplateSourceDirectory |
Mendapatkan direktori Page virtual dari 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 ditampilkan secara visual. |
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. |
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 |
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 koleksi untuk menyimpan kontrol anak. |
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 |
FindControl(String, Int32) |
Mencari kontainer penamaan saat ini untuk kontrol server dengan bilangan bulat dan yang ditentukan |
Focus() |
Mengatur fokus input ke kontrol. |
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) |
GetView(String) |
Mendapatkan tampilan sumber data bernama yang terkait dengan kontrol sumber data. |
GetViewNames() |
Mendapatkan kumpulan nama, yang mewakili daftar DataSourceView objek yang terkait dengan DataSourceControl kontrol. |
HasControls() |
Menentukan apakah kontrol server berisi kontrol anak apa pun. |
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) |
RaiseDataSourceChangedEvent(EventArgs) |
Memunculkan kejadian DataSourceChanged. |
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. |
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 apa pun 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) |
IDataSource.DataSourceChanged |
Terjadi ketika kontrol sumber data telah berubah dengan cara yang memengaruhi kontrol terikat data. |
IDataSource.GetView(String) |
Mendapatkan objek bernama DataSourceView yang terkait dengan DataSourceControl kontrol. Beberapa kontrol sumber data hanya mendukung satu tampilan, sementara yang lain mendukung lebih dari satu tampilan. |
IDataSource.GetViewNames() |
Mendapatkan kumpulan nama, yang mewakili daftar DataSourceView objek yang terkait dengan DataSourceControl kontrol. |
IExpressionsAccessor.Expressions |
Untuk deskripsi anggota ini, lihat Expressions. (Diperoleh dari Control) |
IExpressionsAccessor.HasExpressions |
Untuk deskripsi anggota ini, lihat HasExpressions. (Diperoleh dari Control) |
IListSource.ContainsListCollection |
Menunjukkan apakah kontrol sumber data dikaitkan dengan satu atau beberapa daftar data. |
IListSource.GetList() |
Mendapatkan daftar kontrol sumber data yang dapat digunakan sebagai sumber daftar data. |
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(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. |