Bagikan melalui


DataSourceControl Kelas

Definisi

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
DataSourceControl
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 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 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 id .

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.

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.

Berlaku untuk

Lihat juga