DataSourceControl Klasa

Definicja

Przestrzeń nazw:

System.Web.UI

Zestaw:

System.Web.dll

Służy jako klasa podstawowa kontrolek reprezentujących źródła danych do kontrolek powiązanych z danymi.

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

Dziedziczenie

Object

Control

DataSourceControl

Pochodne

System.Web.UI.WebControls.EntityDataSource

System.Web.UI.WebControls.ObjectDataSource

System.Web.UI.WebControls.QueryableDataSource

System.Web.UI.WebControls.SqlDataSource

Atrybuty

BindableAttribute

Implementuje

IListSource IDataSource

Przykłady

Poniższy przykład kodu pokazuje, jak klasa może rozszerzyć klasę DataSourceControl . Kontrolka CsvDataSource reprezentuje dane plików rozdzielanych przecinkami przechowywane w pliku .csv. Klasa CsvDataSource udostępnia własne implementacje GetViewmetod , GetViewNamesi innych, ponieważ implementacje klasy bazowej nie działają.

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

W poniższym przykładzie kodu pokazano, jak używać kontrolki CsvDataSource w formularzu sieci 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>

Uwagi

ASP.NET obsługuje architekturę powiązania danych sterowania, która umożliwia kontrolkom serwera sieci Web powiązanie z danymi w spójny sposób. Kontrolki serwera sieci Web powiązane z danymi są nazywane kontrolkami powiązanymi z danymi, a klasy, które ułatwiają tworzenie powiązań, są nazywane kontrolkami źródła danych. Kontrolki źródła danych mogą reprezentować dowolne źródło danych: relacyjną bazę danych, plik, strumień, obiekt biznesowy itd. Kontrolki źródła danych przedstawiają dane w spójny sposób na powiązane z danymi kontrolki niezależnie od źródła lub formatu danych bazowych.

Do wykonywania większości zadań programistycznych sieci Web używa się kontrolek źródła danych dostarczanych z ASP.NET, w tym SqlDataSource, AccessDataSourcei XmlDataSource. Klasa podstawowa DataSourceControl jest używana, gdy chcesz zaimplementować własną niestandardową kontrolę źródła danych.

Chociaż każda klasa, która implementuje IDataSource interfejs, jest kontrolą źródła danych, większość ASP.NET kontrolek źródła danych rozszerza klasę abstrakcyjną DataSourceControl , która zapewnia podstawową implementację interfejsu IDataSource . Klasa DataSourceControl udostępnia również implementację interfejsu IListSource , która umożliwia programowe przypisywanie kontroli źródła danych do DataSource właściwości kontrolki powiązanej z danymi i zwracanie danych do kontrolki jako podstawowej listy.

Każda kontrolka ASP.NET, która pochodzi z DataBoundControl klasy, może wiązać się z kontrolką źródła danych. Gdy element DataBoundControl jest powiązany z kontrolą źródła danych, powiązanie danych jest wykonywane automatycznie w czasie wykonywania. Możesz również użyć kontrolek źródła danych z kontrolkami ASP.NET, które uwidaczniają DataSource właściwość lub DataSourceID i obsługują podstawowe powiązanie danych, ale nie pochodzą z DataBoundControlelementu . W przypadku korzystania z tych kontrolek powiązanych z danymi należy jawnie wywołać metodę DataBind . Aby uzyskać więcej informacji na temat powiązania danych, zobacz ASP.NET Mapa zawartości dostępu do danych.

Kontrolkę źródła danych można traktować jako kombinację DataSourceControl obiektu i skojarzonych z nim list danych, nazywanych widokami źródła danych. Każda lista danych jest reprezentowana przez DataSourceView obiekt. Ponieważ bazowy magazyn danych zawiera co najmniej jedną listę danych, obiekt DataSourceControl jest zawsze skojarzony z co najmniej jednym nazwanym DataSourceView obiektem. Interfejs IDataSource definiuje metody używane przez wszystkie kontrolki źródła danych do interakcji z widokami źródła danych: GetViewNames metoda służy do wyliczania widoków źródła danych skojarzonych obecnie z kontrolą źródła danych, a GetView metoda jest używana do pobierania określonego wystąpienia widoku źródła danych według nazwy.

Możesz również traktować kontrolę źródła danych jako dwa odrębne interfejsy, które wywołujące używają do uzyskiwania dostępu do danych. Klasa DataSourceControl jest interfejsem, z którego deweloperzy stron korzystają bezpośrednio podczas tworzenia strony Web Forms, a DataSourceView klasa jest interfejsem, z którego korzystają autorzy kontrolek powiązanych z danymi i autorów kontrolek powiązanych z danymi. DataSourceView Ponieważ obiekt jest dostępny tylko w czasie wykonywania, każdy stan utrwalone dla kontroli źródła danych lub widoku źródła danych musi być uwidoczniony bezpośrednio przez kontrolę źródła danych.

Nie ma wizualnego renderowania kontrolek źródła danych ASP.NET; są one implementowane jako kontrolki, dzięki czemu można je utworzyć deklaratywnie i opcjonalnie umożliwić im uczestnictwo w zarządzaniu stanem. W związku z tym kontrolki źródła danych nie obsługują funkcji wizualnych, takich jak EnableTheming lub SkinID.

Konstruktory

DataSourceControl()

Inicjuje nowe wystąpienie klasy DataSourceControl.

Właściwości

Adapter	Pobiera kartę specyficzną dla przeglądarki dla kontrolki. (Odziedziczone po Control)
AppRelativeTemplateSourceDirectory	Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę. (Odziedziczone po Control)
BindingContainer	Pobiera kontrolkę zawierającą powiązanie danych tej kontrolki. (Odziedziczone po Control)
ChildControlsCreated	Pobiera wartość wskazującą, czy kontrolka podrzędna kontrolki serwera została utworzona. (Odziedziczone po Control)
ClientID	Pobiera identyfikator kontroli serwera wygenerowany przez ASP.NET.
ClientIDMode	Ta właściwość nie jest używana w przypadku kontrolek źródła danych.
ClientIDSeparator	Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości . (Odziedziczone po Control)
Context	HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web. (Odziedziczone po Control)
Controls	ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika.
DataItemContainer	Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement . (Odziedziczone po Control)
DataKeysContainer	Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement . (Odziedziczone po Control)
DesignMode	Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej. (Odziedziczone po Control)
EnableTheming	Pobiera wartość wskazującą, czy ta kontrolka obsługuje motywy.
EnableViewState	Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku, oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta żądającego. (Odziedziczone po Control)
Events	Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu. (Odziedziczone po Control)
HasChildViewState	Pobiera wartość wskazującą, czy kontrolka podrzędna bieżącej kontrolki serwera ma jakiekolwiek zapisane ustawienia stanu widoku. (Odziedziczone po Control)
ID	Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera. (Odziedziczone po Control)
IdSeparator	Pobiera znak używany do oddzielania identyfikatorów kontrolek. (Odziedziczone po Control)
IsChildControlStateCleared	Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli. (Odziedziczone po Control)
IsTrackingViewState	Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku. (Odziedziczone po Control)
IsViewStateEnabled	Pobiera wartość wskazującą, czy stan widoku jest włączony dla tej kontrolki. (Odziedziczone po Control)
LoadViewStateByID	Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu ID widoku zamiast indeksu. (Odziedziczone po Control)
NamingContainer	Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do różnicowania między kontrolkami serwera o tej samej ID wartości właściwości. (Odziedziczone po Control)
Page	Pobiera odwołanie do Page wystąpienia zawierającego kontrolkę serwera. (Odziedziczone po Control)
Parent	Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii kontrolek strony. (Odziedziczone po Control)
RenderingCompatibility	Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny. (Odziedziczone po Control)
Site	Pobiera informacje o kontenerze hostujące bieżącą kontrolkę podczas renderowania na powierzchni projektowej. (Odziedziczone po Control)
SkinID	Pobiera skórę do zastosowania do kontrolki DataSourceControl .
TemplateControl	Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę. (Odziedziczone po Control)
TemplateSourceDirectory	Pobiera katalog wirtualny elementu Page lub UserControl , który zawiera bieżącą kontrolkę serwera. (Odziedziczone po Control)
UniqueID	Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera. (Odziedziczone po Control)
ValidateRequestMode	Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości. (Odziedziczone po Control)
ViewState	Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach dla tej samej strony. (Odziedziczone po Control)
ViewStateIgnoresCase	Pobiera wartość wskazującą, czy StateBag obiekt jest niewrażliwy na wielkość liter. (Odziedziczone po Control)
ViewStateMode	Pobiera lub ustawia tryb stanu widoku tej kontrolki. (Odziedziczone po Control)
Visible	Pobiera lub ustawia wartość wskazującą, czy kontrolka jest wyświetlana wizualnie.

Metody

AddedControl(Control, Int32)	Wywoływana po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu. (Odziedziczone po Control)
AddParsedSubObject(Object)	Powiadamia kontrolkę serwera, że element , XML lub HTML, został przeanalizowany i dodaje element do obiektu kontrolki ControlCollection serwera. (Odziedziczone po Control)
ApplyStyleSheetSkin(Page)	Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki.
BeginRenderTracing(TextWriter, Object)	Rozpoczyna śledzenie czasu projektowania danych renderowania. (Odziedziczone po Control)
BuildProfileTree(String, Boolean)	Zbiera informacje o kontrolce serwera i dostarcza ją do Trace właściwości, która ma być wyświetlana po włączeniu śledzenia dla strony. (Odziedziczone po Control)
ClearCachedClientID()	Ustawia wartość buforowanej ClientID na null. (Odziedziczone po Control)
ClearChildControlState()	Usuwa informacje o stanie kontroli dla kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control)
ClearChildState()	Usuwa informacje o stanie widoku i stanie kontroli dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control)
ClearChildViewState()	Usuwa informacje o stanie widoku dla wszystkich kontrolek podrzędnych kontrolki serwera. (Odziedziczone po Control)
ClearEffectiveClientIDMode()	ClientIDMode Ustawia właściwość bieżącego wystąpienia kontrolki i wszystkich kontrolek podrzędnych na Inherit. (Odziedziczone po Control)
CreateChildControls()	Wywoływana przez platformę stron ASP.NET w celu powiadamiania kontrolek serwera, które używają implementacji opartej na kompozycji w celu utworzenia wszelkich kontrolek podrzędnych, które zawierają w ramach przygotowania do publikowania z powrotem lub renderowania. (Odziedziczone po Control)
CreateControlCollection()	Tworzy kolekcję do przechowywania kontrolek podrzędnych.
DataBind()	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi kontrolkami podrzędnymi. (Odziedziczone po Control)
DataBind(Boolean)	Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją zgłaszania zdarzenia DataBinding . (Odziedziczone po Control)
DataBindChildren()	Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera. (Odziedziczone po Control)
Dispose()	Umożliwia kontrolce serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci. (Odziedziczone po Control)
EndRenderTracing(TextWriter, Object)	Kończy śledzenie czasu projektowania danych renderowania. (Odziedziczone po Control)
EnsureChildControls()	Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne. (Odziedziczone po Control)
EnsureID()	Tworzy identyfikator kontrolek, które nie mają przypisanego identyfikatora. (Odziedziczone po Control)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FindControl(String)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego id parametru.
FindControl(String, Int32)	Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą id całkowitą określoną w parametrze pathOffset , co ułatwia wyszukiwanie. Nie należy zastąpić tej wersji FindControl metody. (Odziedziczone po Control)
Focus()	Ustawia fokus wejściowy na kontrolkę.
GetDesignModeState()	Pobiera dane w czasie projektowania dla kontrolki. (Odziedziczone po Control)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetRouteUrl(Object)	Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control)
GetRouteUrl(RouteValueDictionary)	Pobiera adres URL odpowiadający zestawowi parametrów trasy. (Odziedziczone po Control)
GetRouteUrl(String, Object)	Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control)
GetRouteUrl(String, RouteValueDictionary)	Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy. (Odziedziczone po Control)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)	Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki. (Odziedziczone po Control)
GetView(String)	Pobiera nazwany widok źródła danych skojarzony z kontrolą źródła danych.
GetViewNames()	Pobiera kolekcję nazw, reprezentującą listę obiektów skojarzonych DataSourceView z kontrolką DataSourceControl .
HasControls()	Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne.
HasEvents()	Zwraca wartość wskazującą, czy zdarzenia są rejestrowane dla kontrolki, czy jakiekolwiek kontrolki podrzędne. (Odziedziczone po Control)
IsLiteralContent()	Określa, czy kontrolka serwera zawiera tylko zawartość literału. (Odziedziczone po Control)
LoadControlState(Object)	Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez metodę SaveControlState() . (Odziedziczone po Control)
LoadViewState(Object)	Przywraca informacje o stanie widoku z poprzedniego żądania strony, które zostało zapisane przez metodę SaveViewState() . (Odziedziczone po Control)
MapPathSecure(String)	Pobiera ścieżkę fizyczną, z którą jest mapowa ścieżka wirtualna , bezwzględna lub względna. (Odziedziczone po Control)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnBubbleEvent(Object, EventArgs)	Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony. (Odziedziczone po Control)
OnDataBinding(EventArgs)	DataBinding Zgłasza zdarzenie. (Odziedziczone po Control)
OnInit(EventArgs)	Init Zgłasza zdarzenie. (Odziedziczone po Control)
OnLoad(EventArgs)	Load Zgłasza zdarzenie. (Odziedziczone po Control)
OnPreRender(EventArgs)	PreRender Zgłasza zdarzenie. (Odziedziczone po Control)
OnUnload(EventArgs)	Unload Zgłasza zdarzenie. (Odziedziczone po Control)
OpenFile(String)	Stream Pobiera element używany do odczytywania pliku. (Odziedziczone po Control)
RaiseBubbleEvent(Object, EventArgs)	Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki. (Odziedziczone po Control)
RaiseDataSourceChangedEvent(EventArgs)	DataSourceChanged Zgłasza zdarzenie.
RemovedControl(Control)	Wywoływane po usunięciu kontrolki podrzędnej Controls z kolekcji Control obiektu. (Odziedziczone po Control)
Render(HtmlTextWriter)	Wysyła zawartość kontroli serwera do udostępnionego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control)
RenderChildren(HtmlTextWriter)	Zwraca zawartość elementów podrzędnych kontrolki serwera do udostępnionego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie. (Odziedziczone po Control)
RenderControl(HtmlTextWriter)	Generuje zawartość serwera kontrolującą podaną HtmlTextWriter obiekt i przechowują informacje o śledzeniu dotyczące kontrolki, jeśli śledzenie jest włączone.
RenderControl(HtmlTextWriter, ControlAdapter)	Dane wyjściowe kontrolują zawartość serwera w podanym HtmlTextWriter obiekcie przy użyciu podanego ControlAdapter obiektu. (Odziedziczone po Control)
ResolveAdapter()	Pobiera kartę kontrolną odpowiedzialną za renderowanie określonej kontrolki. (Odziedziczone po Control)
ResolveClientUrl(String)	Pobiera adres URL, który może być używany przez przeglądarkę. (Odziedziczone po Control)
ResolveUrl(String)	Konwertuje adres URL na adres, który może być używany przez klienta żądającego. (Odziedziczone po Control)
SaveControlState()	Zapisuje wszelkie zmiany stanu kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Control)
SaveViewState()	Zapisuje wszelkie zmiany stanu widoku kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po Control)
SetDesignModeState(IDictionary)	Ustawia dane czasu projektowania dla kontrolki. (Odziedziczone po Control)
SetRenderMethodDelegate(RenderMethod)	Przypisuje delegata procedury obsługi zdarzeń, aby renderować kontrolkę serwera i jego zawartość do kontrolki nadrzędnej. (Odziedziczone po Control)
SetTraceData(Object, Object)	Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control)
SetTraceData(Object, Object, Object)	Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu obiektu śledzonego, klucza danych śledzenia i wartości danych śledzenia. (Odziedziczone po Control)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TrackViewState()	Powoduje śledzenie zmian stanu widoku w kontrolce serwera, dzięki czemu mogą być przechowywane w obiekcie kontroli StateBag serwera. Ten obiekt jest dostępny za pośrednictwem ViewState właściwości . (Odziedziczone po Control)

Zdarzenia

DataBinding	Występuje, gdy kontrolka serwera wiąże się ze źródłem danych. (Odziedziczone po Control)
Disposed	Występuje, gdy kontrola serwera jest zwalniana z pamięci, co jest ostatnim etapem cyklu życia kontroli serwera, gdy jest żądana strona ASP.NET. (Odziedziczone po Control)
Init	Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia. (Odziedziczone po Control)
Load	Występuje, gdy kontrolka serwera jest ładowana do Page obiektu. (Odziedziczone po Control)
PreRender	Występuje po załadowaniu Control obiektu, ale przed renderowaniem. (Odziedziczone po Control)
Unload	Występuje, gdy kontrolka serwera jest zwalniana z pamięci. (Odziedziczone po Control)

Jawne implementacje interfejsu

IControlBuilderAccessor.ControlBuilder	Aby uzyskać opis tego elementu członkowskiego, zobacz ControlBuilder. (Odziedziczone po Control)
IControlDesignerAccessor.GetDesignModeState()	Aby uzyskać opis tego elementu członkowskiego, zobacz GetDesignModeState(). (Odziedziczone po Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Aby uzyskać opis tego elementu członkowskiego, zobacz SetDesignModeState(IDictionary). (Odziedziczone po Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control). (Odziedziczone po Control)
IControlDesignerAccessor.UserData	Aby uzyskać opis tego elementu członkowskiego, zobacz UserData. (Odziedziczone po Control)
IDataBindingsAccessor.DataBindings	Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings. (Odziedziczone po Control)
IDataBindingsAccessor.HasDataBindings	Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings. (Odziedziczone po Control)
IDataSource.DataSourceChanged	Występuje, gdy kontrola źródła danych zmieniła się w sposób, który wpływa na kontrolki powiązane z danymi.
IDataSource.GetView(String)	Pobiera nazwany DataSourceView obiekt skojarzony z kontrolką DataSourceControl . Niektóre kontrolki źródła danych obsługują tylko jeden widok, a inne obsługują więcej niż jeden widok.
IDataSource.GetViewNames()	Pobiera kolekcję nazw, reprezentującą listę obiektów skojarzonych DataSourceView z kontrolką DataSourceControl .
IExpressionsAccessor.Expressions	Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions. (Odziedziczone po Control)
IExpressionsAccessor.HasExpressions	Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions. (Odziedziczone po Control)
IListSource.ContainsListCollection	Wskazuje, czy kontrolka źródła danych jest skojarzona z co najmniej jedną listą danych.
IListSource.GetList()	Pobiera listę kontrolek źródła danych, które mogą być używane jako źródła list danych.
IParserAccessor.AddParsedSubObject(Object)	Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object). (Odziedziczone po Control)

Metody rozszerzania

FindDataSourceControl(Control)	Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki.
FindFieldTemplate(Control, String)	Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonej kontrolki.
FindMetaTable(Control)	Zwraca obiekt metatable dla kontrolki zawierającej dane.
GetDefaultValues(IDataSource)	Pobiera kolekcję wartości domyślnych dla określonego źródła danych.
GetMetaTable(IDataSource)	Pobiera metadane dla tabeli w określonym obiekcie źródła danych.
TryGetMetaTable(IDataSource, MetaTable)	Określa, czy metadane tabeli są dostępne.

Zobacz też

• IDataSource
• DataSourceView
• DataBoundControl
• HierarchicalDataSourceControl