DataSourceControl Klasse

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Dient als Basisklasse für Steuerelemente, die Datenquellen für datengebundene Steuerelemente darstellen.

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

Vererbung: Object

Control
DataSourceControl

Abgeleitet: System.Web.UI.WebControls.EntityDataSource

System.Web.UI.WebControls.LinqDataSource

System.Web.UI.WebControls.ObjectDataSource

System.Web.UI.WebControls.QueryableDataSource

System.Web.UI.WebControls.SqlDataSource

Attribute: BindableAttribute

Implementiert: IListSource IDataSource

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie eine Klasse die DataSourceControl Klasse erweitern kann. Das CsvDataSource Steuerelement stellt durch Trennzeichen getrennte Dateidaten dar, die in einer .csv Datei gespeichert sind. Die CsvDataSource Klasse stellt eigene Implementierungen der GetViewMethoden , GetViewNamesund andere Methoden bereit, da die Basisklassenimplementierungen nicht funktionsfähig sind.

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

Im folgenden Codebeispiel wird die Verwendung des CsvDataSource Steuerelements in einem Webformular veranschaulicht.

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

Hinweise

ASP.NET unterstützt eine Steuerelementdatenbindungsarchitektur, mit der Webserversteuerelemente eine konsistente Bindung an Daten ermöglichen. Webserversteuerelemente, die an Daten gebunden sind, werden als datengebundene Steuerelemente bezeichnet, und die Klassen, die diese Bindung erleichtern, werden als Datenquellensteuerelemente bezeichnet. Datenquellensteuerelemente können eine beliebige Datenquelle darstellen: eine relationale Datenbank, eine Datei, ein Datenstrom, ein Geschäftsobjekt usw. Datenquellensteuerelemente stellen Daten auf konsistente Weise für datengebundene Steuerelemente dar, unabhängig von der Quelle oder dem Format der zugrunde liegenden Daten.

Sie verwenden die Datenquellensteuerelemente, die mit ASP.NET bereitgestellt werden, einschließlich SqlDataSource, AccessDataSource und XmlDataSource, um die meisten Webentwicklungsaufgaben auszuführen. Sie verwenden die Basisklasse DataSourceControl , wenn Sie ihr eigenes benutzerdefiniertes Datenquellensteuerelement implementieren möchten.

Während jede Klasse, die die schnittstelle IDataSource implementiert, ein Datenquellensteuerelement ist, erweitern die meisten ASP.NET Datenquellensteuerelemente die abstrakte DataSourceControl-Klasse, die eine Basisimplementierung der schnittstelle IDataSource bereitstellt. Die DataSourceControl Klasse bietet auch eine Implementierung der IListSource Schnittstelle, mit der Sie das Datenquellensteuerelement programmgesteuert der DataSource Eigenschaft eines datengebundenen Steuerelements zuweisen und Daten als einfache Liste an das Steuerelement zurückgeben können.

Jedes ASP.NET-Steuerelement, das von der klasse DataBoundControl abgeleitet wird, kann an ein Datenquellensteuerelement gebunden werden. Wenn eine DataBoundControl Datenquelle an ein Datenquellensteuerelement gebunden ist, wird die Datenbindung zur Laufzeit automatisch ausgeführt. Sie können Datenquellensteuerelemente auch mit ASP.NET Steuerelementen verwenden, die eine DataSource oder DataSourceID-Eigenschaft verfügbar machen und grundlegende Datenbindung unterstützen, aber nicht von DataBoundControl abgeleitet werden. Wenn Sie diese datengebundenen Steuerelemente verwenden, müssen Sie die DataBind Methode explizit aufrufen. Weitere Informationen zur Datenbindung finden Sie unter ASP.NET Datenzugriffsinhaltszuordnung.

Sie können sich ein Datenquellensteuerelement als Kombination aus dem DataSourceControl Objekt und den zugehörigen Listen von Daten vorstellen, die als Datenquellenansichten bezeichnet werden. Jede Liste der Daten wird durch ein DataSourceView Objekt dargestellt. Da der zugrunde liegende Datenspeicher eine oder mehrere Datenlisten enthält, wird ein DataSourceControl Objekt immer einem oder mehreren benannten DataSourceView Objekten zugeordnet. Die IDataSource Schnittstelle definiert die Methoden, die alle Datenquellensteuerelemente für die Interaktion mit Datenquellenansichten verwenden: Die GetViewNames Methode wird zum Aufzählen der Datenquellenansichten verwendet, die derzeit dem Datenquellensteuerelement zugeordnet sind, und die GetView Methode wird verwendet, um eine bestimmte Instanz der Datenquellenansicht anhand des Namens abzurufen.

Sie können sich das Datenquellensteuerelement auch als zwei unterschiedliche Schnittstellen vorstellen, die Aufrufer für den Zugriff auf Daten verwenden. Die DataSourceControl Klasse ist die Schnittstelle, mit der Seitenentwickler direkt interagieren, wenn Sie eine Web Forms-Seite entwickeln, und die Klasse ist die Schnittstelle, mit der DataSourceView datengebundene Steuerelemente und datengebundene Steuerelementautoren interagieren. Da das DataSourceView Objekt nur zur Laufzeit verfügbar ist, muss jeder Zustand, der für das Datenquellensteuerelement oder die Datenquellenansicht beibehalten wird, direkt vom Datenquellensteuerelement verfügbar gemacht werden.

Es gibt keine visuelle Darstellung von ASP.NET Datenquellensteuerelementen. Sie werden als Steuerelemente implementiert, sodass Sie sie deklarativ erstellen und optional die Teilnahme an der Zustandsverwaltung zulassen können. Daher unterstützen Datenquellensteuerelemente keine visuellen Features wie EnableTheming z. B. oder SkinID.

Konstruktoren

Name	Beschreibung
DataSourceControl()	Initialisiert eine neue Instanz der DataSourceControl-Klasse.

Eigenschaften

Name	Beschreibung
Adapter	Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control)
AppRelativeTemplateSourceDirectory	Dient zum Abrufen oder Festlegen des anwendungsrelativen virtuellen Verzeichnisses des Page Objekts UserControl , das dieses Steuerelement enthält. (Geerbt von Control)
BindingContainer	Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Geerbt von Control)
ChildControlsCreated	Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Geerbt von Control)
ClientID	Ruft den von ASP.NET generierten Serversteuerelementbezeichner ab.
ClientIDMode	Diese Eigenschaft wird nicht für Datenquellensteuerelemente verwendet.
ClientIDSeparator	Ruft einen Zeichenwert ab, der das Trennzeichen darstellt, das in der ClientID Eigenschaft verwendet wird. (Geerbt von Control)
Context	Ruft das Objekt ab, das HttpContext dem Serversteuerelement für die aktuelle Webanforderung zugeordnet ist. (Geerbt von Control)
Controls	Ruft ein ControlCollection Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Ui-Hierarchie darstellt.
DataItemContainer	Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataItemContainerimplementiert wird. (Geerbt von Control)
DataKeysContainer	Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataKeysControlimplementiert wird. (Geerbt von Control)
DesignMode	Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control)
EnableTheming	Ruft einen Wert ab, der angibt, ob dieses Steuerelement Designs unterstützt.
EnableViewState	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Serversteuerelement den Ansichtszustand und den Ansichtszustand aller enthaltenen untergeordneten Steuerelemente für den anfordernden Client behält. (Geerbt von Control)
Events	Ruft eine Liste von Ereignishandlerdelegatten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control)
HasChildViewState	Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des aktuellen Serversteuerelements über gespeicherte Ansichtszustandseinstellungen verfügen. (Geerbt von Control)
ID	Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control)
IdSeparator	Ruft das Zeichen ab, das zum Trennen von Steuerelementbezeichnern verwendet wird. (Geerbt von Control)
IsChildControlStateCleared	Ruft einen Wert ab, der angibt, ob In diesem Steuerelement enthaltene Steuerelemente den Steuerelementstatus aufweisen. (Geerbt von Control)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen am Ansichtszustand speichert. (Geerbt von Control)
IsViewStateEnabled	Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Geerbt von Control)
LoadViewStateByID	Ruft einen Wert ab, der angibt, ob das Steuerelement am Laden des Ansichtszustands anstelle ID von Index teilnimmt. (Geerbt von Control)
NamingContainer	Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben ID Eigenschaftswert erstellt. (Geerbt von Control)
Page	Ruft einen Verweis auf die Page Instanz ab, die das Serversteuerelement enthält. (Geerbt von Control)
Parent	Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Seitensteuerelementhierarchie ab. (Geerbt von Control)
RenderingCompatibility	Ruft einen Wert ab, der die ASP.NET Version angibt, mit der html gerendert wird, kompatibel ist. (Geerbt von Control)
Site	Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostt, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control)
SkinID	Ruft die Haut ab, die auf das DataSourceControl Steuerelement angewendet werden soll.
TemplateControl	Dient zum Abrufen oder Festlegen eines Verweises auf die Vorlage, die dieses Steuerelement enthält. (Geerbt von Control)
TemplateSourceDirectory	Ruft das virtuelle Verzeichnis des Page oder UserControl das aktuelle Serversteuerelement ab. (Geerbt von Control)
UniqueID	Ruft den eindeutigen hierarchisch qualifizierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control)
ValidateRequestMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement Clienteingaben aus dem Browser auf potenziell gefährliche Werte überprüft. (Geerbt von Control)
ViewState	Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements für mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von Control)
ViewStateIgnoresCase	Ruft einen Wert ab, der angibt, ob die Groß-/Kleinschreibung des StateBag Objekts nicht beachtet wird. (Geerbt von Control)
ViewStateMode	Ruft den Ansichtszustandsmodus dieses Steuerelements ab oder legt diesen fest. (Geerbt von Control)
Visible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement visuell angezeigt wird.

Methoden

Name	Beschreibung
AddedControl(Control, Int32)	Wird aufgerufen, nachdem der Auflistung des Objekts ein untergeordnetes Controls Steuerelement hinzugefügt Control wurde. (Geerbt von Control)
AddParsedSubObject(Object)	Benachrichtigt das Serversteuerelement, dass ein Element, entweder XML oder HTML, analysiert wurde, und fügt das Element dem Objekt des Serversteuerelements ControlCollection hinzu. (Geerbt von Control)
ApplyStyleSheetSkin(Page)	Wendet die Formatvorlageneigenschaften an, die im Seitenstylesheet definiert sind, auf das Steuerelement.
BeginRenderTracing(TextWriter, Object)	Beginnt mit der Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control)
BuildProfileTree(String, Boolean)	Sammelt Informationen über das Serversteuerelement und liefert sie an die Eigenschaft, die Trace angezeigt werden soll, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control)
ClearCachedClientID()	Legt den zwischengespeicherten ClientID Wert auf `null`. (Geerbt von Control)
ClearChildControlState()	Löscht die Steuerelementstatusinformationen für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearChildState()	Löscht die Ansichts- und Steuerelementstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearChildViewState()	Löscht die Ansichtsstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearEffectiveClientIDMode()	Legt die ClientIDMode Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit. (Geerbt von Control)
CreateChildControls()	Wird vom ASP.NET Seitenframework aufgerufen, um Serversteuerelemente zu benachrichtigen, die kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf das Veröffentlichen von Zurück- oder Rendering enthalten. (Geerbt von Control)
CreateControlCollection()	Erstellt eine Sammlung zum Speichern untergeordneter Steuerelemente.
DataBind()	Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente. (Geerbt von Control)
DataBind(Boolean)	Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit einer Option zum Auslösen des DataBinding Ereignisses. (Geerbt von Control)
DataBindChildren()	Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
Dispose()	Ermöglicht es einem Serversteuerelement, die endgültige Bereinigung durchzuführen, bevor es aus dem Arbeitsspeicher freigegeben wird. (Geerbt von Control)
EndRenderTracing(TextWriter, Object)	Beendet die Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control)
EnsureChildControls()	Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control)
EnsureID()	Erstellt einen Bezeichner für Steuerelemente, denen kein Bezeichner zugewiesen ist. (Geerbt von Control)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FindControl(String, Int32)	Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit der angegebenen `id` und einer ganzzahligen Zahl, die `pathOffset` im Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl Methode nicht außer Kraft setzen. (Geerbt von Control)
FindControl(String)	Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit dem angegebenen `id` Parameter.
Focus()	Legt den Eingabefokus auf das Steuerelement fest.
GetDesignModeState()	Ruft Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetRouteUrl(Object)	Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control)
GetRouteUrl(RouteValueDictionary)	Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control)
GetRouteUrl(String, Object)	Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control)
GetRouteUrl(String, RouteValueDictionary)	Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
GetUniqueIDRelativeTo(Control)	Gibt den präfixierten Teil der UniqueID Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control)
GetView(String)	Ruft die benannte Datenquellenansicht ab, die dem Datenquellensteuerelement zugeordnet ist.
GetViewNames()	Ruft eine Auflistung von Namen ab, die die Liste der DataSourceView objekte darstellt, die dem DataSourceControl Steuerelement zugeordnet sind.
HasControls()	Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält.
HasEvents()	Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder untergeordnete Steuerelemente registriert sind. (Geerbt von Control)
IsLiteralContent()	Bestimmt, ob das Serversteuerelement nur Literalinhalte enthält. (Geerbt von Control)
LoadControlState(Object)	Stellt Steuerstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveControlState() Methode gespeichert wurde. (Geerbt von Control)
LoadViewState(Object)	Stellt Ansichtsstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveViewState() Methode gespeichert wurde. (Geerbt von Control)
MapPathSecure(String)	Ruft den physischen Pfad ab, dem ein virtueller Pfad, entweder absolut oder relativ, zugeordnet ist. (Geerbt von Control)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnBubbleEvent(Object, EventArgs)	Bestimmt, ob das Ereignis für das Serversteuerelement an die Ui-Serversteuerelementhierarchie der Seite übergeben wird. (Geerbt von Control)
OnDataBinding(EventArgs)	Löst das DataBinding-Ereignis aus. (Geerbt von Control)
OnInit(EventArgs)	Löst das Init-Ereignis aus. (Geerbt von Control)
OnLoad(EventArgs)	Löst das Load-Ereignis aus. (Geerbt von Control)
OnPreRender(EventArgs)	Löst das PreRender-Ereignis aus. (Geerbt von Control)
OnUnload(EventArgs)	Löst das Unload-Ereignis aus. (Geerbt von Control)
OpenFile(String)	Ruft einen Stream Verwendeten zum Lesen einer Datei ab. (Geerbt von Control)
RaiseBubbleEvent(Object, EventArgs)	Weist alle Quellen des Ereignisses und dessen Informationen dem übergeordneten Element des Steuerelements zu. (Geerbt von Control)
RaiseDataSourceChangedEvent(EventArgs)	Löst das DataSourceChanged-Ereignis aus.
RemovedControl(Control)	Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls Auflistung des Control Objekts entfernt wurde. (Geerbt von Control)
Render(HtmlTextWriter)	Sendet Serversteuerelementinhalte an ein bereitgestelltes HtmlTextWriter Objekt, das den inhalt schreibt, der auf dem Client gerendert werden soll. (Geerbt von Control)
RenderChildren(HtmlTextWriter)	Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements in ein bereitgestelltes HtmlTextWriter Objekt aus, das den inhalt schreibt, der auf dem Client gerendert werden soll. (Geerbt von Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Gibt den Inhalt des Serversteuerelements mithilfe eines bereitgestellten Objekts an ein bereitgestelltes HtmlTextWriter ControlAdapter Objekt aus. (Geerbt von Control)
RenderControl(HtmlTextWriter)	Gibt Den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, wenn die Ablaufverfolgung aktiviert ist.
ResolveAdapter()	Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Geerbt von Control)
ResolveClientUrl(String)	Ruft eine URL ab, die vom Browser verwendet werden kann. (Geerbt von Control)
ResolveUrl(String)	Wandelt eine URL in eine URL um, die auf dem anfordernden Client verwendet werden kann. (Geerbt von Control)
SaveControlState()	Speichert alle Änderungen des Serversteuerelementstatus, die seit dem Zeitpunkt der Zurückpostung der Seite auf dem Server aufgetreten sind. (Geerbt von Control)
SaveViewState()	Speichert alle Änderungen des Ansichtszustands des Serversteuerelements, die seit dem Zeitpunkt, zu dem die Seite zurück auf den Server gepostet wurde, aufgetreten sind. (Geerbt von Control)
SetDesignModeState(IDictionary)	Legt Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control)
SetRenderMethodDelegate(RenderMethod)	Weist einen Ereignishandlerdelegat zu, um das Serversteuerelement und dessen Inhalt in seinem übergeordneten Steuerelement zu rendern. (Geerbt von Control)
SetTraceData(Object, Object, Object)	Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des ablaufverfolgungsobjekts, des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control)
SetTraceData(Object, Object)	Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TrackViewState()	Bewirkt die Nachverfolgung von Ansichtszustandsänderungen am Serversteuerelement, sodass sie im Objekt des Serversteuerelements StateBag gespeichert werden können. Auf dieses Objekt kann über die ViewState Eigenschaft zugegriffen werden. (Geerbt von Control)

Ereignisse

Name	Beschreibung
DataBinding	Tritt auf, wenn das Serversteuerelement eine Bindung an eine Datenquelle ausführt. (Geerbt von Control)
Disposed	Tritt auf, wenn ein Serversteuerelement aus dem Arbeitsspeicher freigegeben wird. Dies ist die letzte Phase des Lebenszyklus des Serversteuerelements, wenn eine ASP.NET Seite angefordert wird. (Geerbt von Control)
Init	Tritt auf, wenn das Serversteuerelement initialisiert wird, was der erste Schritt im Lebenszyklus ist. (Geerbt von Control)
Load	Tritt auf, wenn das Serversteuerelement in das Page Objekt geladen wird. (Geerbt von Control)
PreRender	Tritt ein, nachdem das Control Objekt geladen wurde, aber vor dem Rendern. (Geerbt von Control)
Unload	Tritt auf, wenn das Serversteuerelement aus dem Arbeitsspeicher entladen wird. (Geerbt von Control)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IControlBuilderAccessor.ControlBuilder	Eine Beschreibung dieses Mitglieds finden Sie unter ControlBuilder. (Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()	Eine Beschreibung dieses Mitglieds finden Sie unter GetDesignModeState(). (Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Eine Beschreibung dieses Mitglieds finden Sie unter SetDesignModeState(IDictionary). (Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Eine Beschreibung dieses Mitglieds finden Sie unter SetOwnerControl(Control). (Geerbt von Control)
IControlDesignerAccessor.UserData	Eine Beschreibung dieses Mitglieds finden Sie unter UserData. (Geerbt von Control)
IDataBindingsAccessor.DataBindings	Eine Beschreibung dieses Mitglieds finden Sie unter DataBindings. (Geerbt von Control)
IDataBindingsAccessor.HasDataBindings	Eine Beschreibung dieses Mitglieds finden Sie unter HasDataBindings. (Geerbt von Control)
IDataSource.DataSourceChanged	Tritt auf, wenn sich ein Datenquellensteuerelement auf eine Weise geändert hat, die sich auf datengebundene Steuerelemente auswirkt.
IDataSource.GetView(String)	Ruft das benannte DataSourceView Objekt ab, das dem DataSourceControl Steuerelement zugeordnet ist. Einige Datenquellensteuerelemente unterstützen nur eine Ansicht, während andere mehr als eine Ansicht unterstützen.
IDataSource.GetViewNames()	Ruft eine Auflistung von Namen ab, die die Liste der DataSourceView objekte darstellt, die dem DataSourceControl Steuerelement zugeordnet sind.
IExpressionsAccessor.Expressions	Eine Beschreibung dieses Mitglieds finden Sie unter Expressions. (Geerbt von Control)
IExpressionsAccessor.HasExpressions	Eine Beschreibung dieses Mitglieds finden Sie unter HasExpressions. (Geerbt von Control)
IListSource.ContainsListCollection	Gibt an, ob das Datenquellensteuerelement einer oder mehreren Datenlisten zugeordnet ist.
IListSource.GetList()	Ruft eine Liste der Datenquellensteuerelemente ab, die als Datenquellen von Datenlisten verwendet werden können.
IParserAccessor.AddParsedSubObject(Object)	Eine Beschreibung dieses Mitglieds finden Sie unter AddParsedSubObject(Object). (Geerbt von Control)

Erweiterungsmethoden

Name	Beschreibung
FindDataSourceControl(Control)	Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.
FindFieldTemplate(Control, String)	Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.
FindMetaTable(Control)	Gibt das metatable -Objekt für das enthaltende Datensteuerelement zurück.
GetDefaultValues(IDataSource)	Ruft die Auflistung der Standardwerte für die angegebene Datenquelle ab.
GetMetaTable(IDataSource)	Ruft die Metadaten für eine Tabelle im angegebenen Datenquellenobjekt ab.
TryGetMetaTable(IDataSource, MetaTable)	Bestimmt, ob Tabellenmetadaten verfügbar sind.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?