SqlDataSource Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

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.

Stellt eine SQL-Datenbank für datengebundene Steuerelemente dar.

public ref class SqlDataSource : System::Web::UI::DataSourceControl

[System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.SqlDataSource))]
public class SqlDataSource : System.Web.UI.DataSourceControl

[<System.Drawing.ToolboxBitmap(typeof(System.Web.UI.WebControls.SqlDataSource))>]
type SqlDataSource = class
    inherit DataSourceControl

Public Class SqlDataSource
Inherits DataSourceControl

Vererbung: Object

Control

DataSourceControl
SqlDataSource

Abgeleitet: System.Web.UI.WebControls.AccessDataSource

Attribute: ToolboxBitmapAttribute

Beispiele

Dieser Abschnitt enthält vier Codebeispiele:

Im ersten Codebeispiel wird veranschaulicht, wie Daten aus SQL Server in einem GridView Steuerelement mit deklarativer Syntax angezeigt werden.
Im zweiten Codebeispiel wird veranschaulicht, wie Daten aus einer ODBC-kompatiblen Datenbank in einem GridView Steuerelement mithilfe deklarativer Syntax angezeigt werden.
Im dritten Codebeispiel wird veranschaulicht, wie Daten in einem GridView Steuerelement angezeigt und aktualisiert werden.
Im vierten Codebeispiel wird veranschaulicht, wie Daten in einem DropDownList Steuerelement angezeigt und aktualisiert werden.

Hinweis

In diesen Beispielen wird gezeigt, wie Sie die deklarative Syntax für den Datenzugriff verwenden. Informationen zum Zugreifen auf Daten mithilfe von Code anstelle von Markup finden Sie unter Zugreifen auf Daten in Visual Studio.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein SqlDataSource Steuerelement deklarativ verwenden, um Daten aus SQL Server abzurufen und in einem GridView Steuerelement anzuzeigen.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataReader"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

Im folgenden Codebeispiel wird veranschaulicht, wie Sie ein SqlDataSource Steuerelement deklarativ verwenden, um Daten aus einer ODBC-kompatiblen Datenbank abzurufen und in einem GridView Steuerelement anzuzeigen. Die ProviderName -Eigenschaft ist der Name des .NET Framework-Datenanbieters für ODBC, der lautet System.Data.Odbc.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >

  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataReader"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <!-- This example uses a Northwind database that is hosted by an ODBC-compliant
         database. To run this sample, create an ODBC DSN to any database that hosts
         the Northwind database, including Microsoft SQL Server or Microsoft Access,
         change the name of the DSN in the ConnectionString, and view the page.
    -->
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ProviderName="System.Data.Odbc"
          DataSourceMode="DataReader"
          ConnectionString="dsn=myodbc3dsn;"
          SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          DataSourceID="SqlDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

Im folgenden Codebeispiel wird ein allgemeines Anzeige- und Aktualisierungsszenario mit dem GridView -Steuerelement veranschaulicht. Wie in den vorherigen Beispielen werden Daten aus der Northwind-Datenbank im GridView -Steuerelement angezeigt. Da außerdem eine UpdateCommand Eigenschaft angegeben und die AutoGenerateEditButton Eigenschaft auf truefestgelegt ist, können Sie die Datensätze ohne zusätzlichen Code bearbeiten und aktualisieren. Das GridView Steuerelement verarbeitet automatisch das UpdateParameters Hinzufügen von Parametern zur Auflistung und ruft die Update -Methode auf, wenn auf die Schaltfläche Aktualisieren im GridView Steuerelement geklickt wird.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
          UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AutoGenerateColumns="False"
          DataKeyNames="EmployeeID"
          AutoGenerateEditButton="True"
          DataSourceID="SqlDataSource1">
          <columns>
              <asp:BoundField HeaderText="First Name" DataField="FirstName" />
              <asp:BoundField HeaderText="Last Name" DataField="LastName" />
              <asp:BoundField HeaderText="Title" DataField="Title" />
          </columns>

      </asp:GridView>

    </form>
  </body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          DataSourceMode="DataSet"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID,FirstName,LastName,Title FROM Employees"
          UpdateCommand="Update Employees SET FirstName=@FirstName,LastName=@LastName,Title=@Title WHERE EmployeeID=@EmployeeID">
      </asp:SqlDataSource>

      <asp:GridView
          id="GridView1"
          runat="server"
          AutoGenerateColumns="False"
          DataKeyNames="EmployeeID"
          AutoGenerateEditButton="True"
          DataSourceID="SqlDataSource1">
          <columns>
              <asp:BoundField HeaderText="First Name" DataField="FirstName" />
              <asp:BoundField HeaderText="Last Name" DataField="LastName" />
              <asp:BoundField HeaderText="Title" DataField="Title" />
          </columns>

      </asp:GridView>
    </form>
  </body>
</html>

Im folgenden Codebeispiel wird ein allgemeines Anzeige- und Aktualisierungsszenario mit den Steuerelementen DropDownList und TextBox veranschaulicht. Das DropDownList -Steuerelement fügt der UpdateParameters Auflistung weder automatisch Updateparameter hinzu, noch ruft die Update -Methode auf, daher müssen Sie dies tun. Die Updateparameter werden deklarativ angegeben, und Sie können einen Ereignishandler hinzufügen, um den Update Vorgang auszuführen, wenn ein Ereignis ausgelöst wird.

Wichtig

Dieses Beispiel enthält ein Textfeld, das Benutzereingaben akzeptiert, was eine potenzielle Sicherheitsgefährdung darstellt. Standardmäßig stellen ASP.NET-Webseiten sicher, dass Benutzereingaben keine Skript- oder HTML-Elemente enthalten. Weitere Informationen finden Sie unter Übersicht über Skriptangriffe.

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
 private void On_Click(Object source, EventArgs e) {
    try {
        SqlDataSource1.Update();
    }
    catch (Exception except) {
        // Handle the Exception.
    }

    Label2.Text="The record was updated successfully!";
 }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
          UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
          <UpdateParameters>
              <asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
              <asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
          </UpdateParameters>
      </asp:SqlDataSource>

      <asp:DropDownList
          id="DropDownList1"
          runat="server"
          DataTextField="LastName"
          DataValueField="EmployeeID"
          DataSourceID="SqlDataSource1">
      </asp:DropDownList>

      <br />
      <asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
        AssociatedControlID="TextBox1" />
      <asp:TextBox id="TextBox1" runat="server" />
      <asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />

      <br /><asp:Label id="Label2" runat="server" Text="" />

    </form>
  </body>
</html>

<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

 Sub On_Click(ByVal source As Object, ByVal e As EventArgs)
    Try
        SqlDataSource1.Update()
    Catch except As Exception
        ' Handle the Exception.
    End Try

    Label2.Text="The record was updated successfully!"

 End Sub 'On_Click
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <asp:SqlDataSource
          id="SqlDataSource1"
          runat="server"
          ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
          SelectCommand="SELECT EmployeeID, LastName, Address FROM Employees"
          UpdateCommand="UPDATE Employees SET Address=@Address WHERE EmployeeID=@EmployeeID">
          <UpdateParameters>
              <asp:ControlParameter Name="Address" ControlId="TextBox1" PropertyName="Text"/>
              <asp:ControlParameter Name="EmployeeID" ControlId="DropDownList1" PropertyName="SelectedValue"/>
          </UpdateParameters>
      </asp:SqlDataSource>

      <asp:DropDownList
          id="DropDownList1"
          runat="server"
          DataTextField="LastName"
          DataValueField="EmployeeID"
          DataSourceID="SqlDataSource1">
      </asp:DropDownList>

      <br />
      <asp:Label id="Label1" runat="server" Text="Enter a new address for the selected user."
        AssociatedControlID="TextBox1" />
      <asp:TextBox id="TextBox1" runat="server" />
      <asp:Button id="Submit" runat="server" Text="Submit" OnClick="On_Click" />

      <br /><asp:Label id="Label2" runat="server" Text="" />
    </form>
  </body>
</html>

Hinweise

In diesem Thema:

Introduction (Einführung)
Datenverbindungen
Ausführen von Datenvorgängen
Datenanbieter
Zwischenspeichern
Zusätzliche Features
Datenquellensicht
Deklarative Syntax

Einführung

Das SqlDataSource Datenquellensteuerelement stellt Daten in einer relationalen SQL-Datenbank für datengebundene Steuerelemente dar. Sie können das SqlDataSource Steuerelement in Verbindung mit einem datengebundenen Steuerelement verwenden, um Daten aus einer relationalen Datenbank abzurufen und Daten auf einer Webseite mit wenig oder ohne Code anzuzeigen, zu bearbeiten und zu sortieren.

Datenverbindungen

Um eine Verbindung mit einer Datenbank herzustellen, müssen Sie die ConnectionString -Eigenschaft auf eine gültige Verbindungszeichenfolge festlegen. Kann SqlDataSource jede relationale SQL-Datenbank unterstützen, mit der mithilfe eines ADO.NET Anbieters wie SqlClient, , OleDbOdbcoder OracleClient verbunden werden kann. Informationen zum Schützen von Verbindungszeichenfolgen finden Sie unter Vorgehensweise: Schützen von Verbindungszeichenfolgen bei Verwendung von Datenquellensteuerelementen.

Um Daten aus einer zugrunde liegenden Datenbank abzurufen, legen Sie die SelectCommand -Eigenschaft mit einer SQL-Abfrage fest. Wenn die Datenbank, der zugeordnet SqlDataSource ist, gespeicherte Prozeduren unterstützt, können Sie die SelectCommand -Eigenschaft auf den Namen einer gespeicherten Prozedur festlegen. Die von Ihnen angegebene SQL-Abfrage kann auch eine parametrisierte Abfrage sein. Sie können der SelectParameters Auflistung Objekte hinzufügenParameter, die einer parametrisierten Abfrage zugeordnet sind. Weitere Informationen zu parametrisierten SQL-Abfragen und deren Syntax finden Sie unter Verwenden von Parametern mit Datenquellensteuerelementen für das Filtern.

Das SqlDataSource -Steuerelement ruft Daten ab, wenn die Select -Methode aufgerufen wird. Diese Methode bietet programmgesteuerten Zugriff auf die Methode, die durch SelectMethod die -Eigenschaft angegeben wird. Die Select -Methode wird automatisch von Steuerelementen aufgerufen, die an das gebunden sind, wenn ihre SqlDataSource DataBind -Methode aufgerufen wird. Wenn Sie die DataSourceID -Eigenschaft eines datengebundenen Steuerelements festlegen, wird das Steuerelement bei Bedarf automatisch an Daten aus der Datenquelle gebunden. Das Festlegen der DataSourceID -Eigenschaft ist die empfohlene Methode zum Binden eines ObjectDataSource Steuerelements an ein datengebundenes Steuerelement. Alternativ können Sie die DataSource -Eigenschaft verwenden, aber dann müssen Sie explizit die DataBind -Methode des datengebundenen Steuerelements aufrufen. Beispiele für datengebundene Steuerelemente, die verwendet SqlDataSource werden können, sind DataGrid, DataList DetailsView, und DropDownList. Sie können die Select -Methode jederzeit programmgesteuert aufrufen, um Daten aus der zugrunde liegenden Datenbank abzurufen.

In deklarativen und programmgesteuerten ASP.NET Szenarien können Sie die DataSourceID -Eigenschaft des datengebundenen Steuerelements auf die ID des SqlDataSource Steuerelements festlegen. Sie können der -Eigenschaft des SqlDataSource datengebundenen Steuerelements auch eine Instanz der -Klasse DataSource zuweisen. Weitere Informationen zum Binden eines datengebundenen Steuerelements an Datenquellensteuerelemente finden Sie unter ASP.NET Datenzugriffsoptionen.

Ausführen von Datenvorgängen

Abhängig von den Funktionen des zugrunde liegenden Datenbankprodukts und der Konfiguration der Instanz der SqlDataSource -Klasse können Sie Datenvorgänge wie Updates, Einfügungen und Löschvorgänge ausführen. Um diese Datenvorgänge auszuführen, legen Sie den entsprechenden Befehlstext und alle zugehörigen Parameter für den Vorgang fest, den Sie ausführen möchten. Legen Sie beispielsweise für einen Aktualisierungsvorgang die UpdateCommand Eigenschaft auf eine SQL-Zeichenfolge oder den Namen einer gespeicherten Prozedur fest, und fügen Sie der UpdateParameters Auflistung alle erforderlichen Parameter hinzu. Die Aktualisierung wird ausgeführt, wenn die Update -Methode aufgerufen wird, entweder explizit durch Ihren Code oder automatisch durch ein datengebundenes Steuerelement. Das gleiche allgemeine Muster wird für Delete - und Insert -Vorgänge verwendet.

Die SQL-Abfragen und -Befehle, die Sie in den SelectCommandEigenschaften , UpdateCommand, InsertCommandund DeleteCommand verwenden, können parametrisiert werden. Dies bedeutet, dass die Abfrage oder der Befehl Anstelle von Literalwerten Platzhalter verwenden und die Platzhalter an Anwendungs- oder benutzerdefinierte Variablen binden kann. Sie können Parameter in SQL-Abfragen an Sitzungsvariablen, Werte, die in der Abfragezeichenfolge für eine Web Forms-Seite übergeben werden, die Eigenschaftswerte anderer Serversteuerelemente und vieles mehr binden. Weitere Informationen zur Verwendung von Parametern in SQL-Abfragen mit finden SqlDataSourceSie unter Verwenden von Parametern mit Datenquellensteuerelementen zum Filtern und Verwenden von Parametern mit dem SqlDataSource-Steuerelement.

Hinweis

Wenn einer der Parameter beim Ausführen eines Select Befehls istnull, werden standardmäßig keine Daten zurückgegeben, und es wird keine Ausnahme ausgelöst. Sie können dieses Verhalten ändern, indem Sie die CancelSelectOnNullParameter -Eigenschaft auf falsefestlegen.

Datenanbieter

Standardmäßig funktioniert das SqlDataSource Steuerelement mit dem .NET Framework-Datenanbieter für SQL Server, ist aber SqlDataSource nicht Microsoft SQL Server-spezifisch. Sie können das SqlDataSource Steuerelement mit jedem Datenbankprodukt verbinden, für das es einen verwalteten ADO.NET Anbieter gibt. Bei Verwendung mit dem System.Data.OleDb Anbieter kann mit SqlDataSource jeder OLE DB-kompatiblen Datenbank verwendet werden. Bei Verwendung mit dem System.Data.Odbc Anbieter kann mit SqlDataSource jedem ODBC-Treiber und jeder beliebigen Datenbank verwendet werden, einschließlich IBM DB2, MySQL und PostgreSQL. Bei Verwendung mit dem System.Data.OracleClient Anbieter kann mit SqlDataSource Oracle 8.1.7-Datenbanken und höher verwendet werden. Die Liste der zulässigen Anbieter ist im Abschnitt der DbProviderFactories Konfigurationsdatei registriert, entweder in der Machine.config- oder Web.config-Datei. Weitere Informationen finden Sie unter Auswählen von Daten mithilfe des SqlDataSource-Steuerelements.

Zwischenspeicherung

Wenn Sie Daten auf Ihrer Seite mithilfe eines SqlDataSource -Steuerelements anzeigen, können Sie die Leistung der Seite mithilfe der Datenzwischenspeicherungsfunktionen des Datenquellensteuerelements erhöhen. Zwischenspeichern reduziert die Verarbeitungslast auf den Datenbankservern auf Kosten des Arbeitsspeichers auf dem Webserver. in den meisten Fällen ist dies ein guter Kompromiss. Die SqlDataSource speichert Automatisch Daten zwischen, wenn die EnableCaching -Eigenschaft auf true festgelegt ist und die CacheDuration -Eigenschaft auf die Anzahl der Sekunden festgelegt wird, die der Cache speichert, bevor der Cacheeintrag verworfen wird. Sie können auch einen CacheExpirationPolicy und einen optionalen SqlCacheDependency Wert angeben.

Zusätzliche Funktionen

Stellt SqlDataSource zusätzliche Funktionen bereit, wie in der folgenden Tabelle aufgeführt.

Funktionalität	Anforderungen
Zwischenspeicherung	Legen Sie die DataSourceMode -Eigenschaft auf den DataSet Wert, die EnableCaching -Eigenschaft auf `true`und die CacheDuration Eigenschaften und CacheExpirationPolicy entsprechend dem zwischengespeicherten Zwischenspeicherungsverhalten fest.
Wird gelöscht	Legen Sie die DeleteCommand -Eigenschaft auf eine SQL-Anweisung fest, die zum Löschen von Daten verwendet wird. Diese Anweisung wird in der Regel parametrisiert.
Filtern	Legen Sie die DataSourceMode -Eigenschaft auf den DataSet -Wert fest. Legen Sie die FilterExpression -Eigenschaft auf einen Filterausdruck fest, der zum Filtern der Daten verwendet wird, wenn die Select -Methode aufgerufen wird.
Einfügen	Legen Sie die InsertCommand -Eigenschaft auf eine SQL-Anweisung fest, die zum Einfügen von Daten verwendet wird. Diese Anweisung wird in der Regel parametrisiert.
Paging	Wird derzeit nicht von SqlDataSourceunterstützt, aber einige datengebundene Steuerelemente, z GridView. B. , unterstützen das Paging, wenn Sie die DataSourceMode -Eigenschaft auf den DataSet -Wert festlegen.
Wählen Sie Folgendes aus:	Legen Sie die SelectCommand -Eigenschaft auf eine SQL-Anweisung fest, die zum Abrufen von Daten verwendet wird.
Sortieren	Legen Sie die DataSourceMode -Eigenschaft auf DataSetfest.
Wird aktualisiert	Legen Sie die UpdateCommand -Eigenschaft auf eine SQL-Anweisung fest, die zum Aktualisieren von Daten verwendet wird. Diese Anweisung wird in der Regel parametrisiert.

Datenquellensicht

Wie bei allen Datenquellensteuerelementen ist das SqlDataSource Steuerelement einer Datenquellensichtklasse zugeordnet. Dem SqlDataSource -Steuerelement ist nur ein zugeordnetes SqlDataSourceView- und es heißt immer Table.

Es gibt kein visuelles Rendering des Steuerelements. Es wird als Steuerelement implementiert, sodass Sie es deklarativ erstellen und optional an der SqlDataSource Zustandsverwaltung teilnehmen können. SqlDataSource Daher werden keine visuellen Features unterstützt, z. B. die von der - oder SkinID -EnableThemingEigenschaft bereitgestellten.

Deklarative Syntax

<asp:SqlDataSource
    CacheDuration="string|Infinite"
    CacheExpirationPolicy="Absolute|Sliding"
    CacheKeyDependency="string"
    CancelSelectOnNullParameter="True|False"
    ConflictDetection="OverwriteChanges|CompareAllValues"
    ConnectionString="string"
    DataSourceMode="DataReader|DataSet"
    DeleteCommand="string"
    DeleteCommandType="Text|StoredProcedure"
    EnableCaching="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    FilterExpression="string"
    ID="string"
    InsertCommand="string"
    InsertCommandType="Text|StoredProcedure"
    OldValuesParameterFormatString="string"
    OnDataBinding="DataBinding event handler"
    OnDeleted="Deleted event handler"
    OnDeleting="Deleting event handler"
    OnDisposed="Disposed event handler"
    OnFiltering="Filtering event handler"
    OnInit="Init event handler"
    OnInserted="Inserted event handler"
    OnInserting="Inserting event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelected="Selected event handler"
    OnSelecting="Selecting event handler"
    OnUnload="Unload event handler"
    OnUpdated="Updated event handler"
    OnUpdating="Updating event handler"
    ProviderName="string|System.Data.Odbc|System.Data.OleDb|
        System.Data.OracleClient|System.Data.SqlClient|
        Microsoft.SqlServerCe.Client"
    runat="server"
    SelectCommand="string"
    SelectCommandType="Text|StoredProcedure"
    SkinID="string"
    SortParameterName="string"
    SqlCacheDependency="string"
    UpdateCommand="string"
    UpdateCommandType="Text|StoredProcedure"
    Visible="True|False"
>
        <DeleteParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </DeleteParameters>
        <FilterParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </FilterParameters>
        <InsertParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </InsertParameters>
        <SelectParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </SelectParameters>
        <UpdateParameters>
                <asp:ControlParameter
                    ControlID="string"
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:CookieParameter
                    ConvertEmptyStringToNull="True|False"
                    CookieName="string"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:FormParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    FormField="string"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:Parameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:ProfileParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    PropertyName="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:QueryStringParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    QueryStringField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
                <asp:SessionParameter
                    ConvertEmptyStringToNull="True|False"
                    DefaultValue="string"
                    Direction="Input|Output|InputOutput|ReturnValue"
                    Name="string"
                    SessionField="string"
                    Size="integer"
                    Type="Empty|Object|DBNull|Boolean|Char|SByte|
                        Byte|Int16|UInt16|Int32|UInt32|Int64|UInt64|
                        Single|Double|Decimal|DateTime|String"
                />
        </UpdateParameters>
</asp:SqlDataSource>

Konstruktoren

SqlDataSource()	Initialisiert eine neue Instanz der SqlDataSource-Klasse.
SqlDataSource(String, String)	Initialisiert eine neue Instanz der SqlDataSource-Klasse mit der angegebenen Verbindungszeichenfolge und dem Select-Befehl.
SqlDataSource(String, String, String)	Initialisiert eine neue Instanz der SqlDataSource-Klasse mit der angegebenen Verbindungszeichenfolge und dem Select-Befehl.

Eigenschaften

Adapter	Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control)
AppRelativeTemplateSourceDirectory	Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest. (Geerbt von Control)
BindingContainer	Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Geerbt von Control)
CacheDuration	Ruft die Zeitspanne in Sekunden ab, die das Datenquellen-Steuerelement zum Zwischenspeichern der von der Select(DataSourceSelectArguments)-Methode abgerufenen Daten benötigt, oder legt diese fest.
CacheExpirationPolicy	Ruft das Cacheablaufverhalten ab, das in Kombination mit der Dauer das Verhalten des vom Datenquellen-Steuerelement verwendeten Caches beschreibt.
CacheKeyDependency	Ruft eine benutzerdefinierte Schlüsselabhängigkeit ab, die mit sämtlichen vom Datenquellen-Steuerelement erstellten Datencacheobjekten verknüpft ist, oder legt diese fest. Alle Cacheobjekte laufen explizit ab, wenn der Schlüssel abläuft.
CancelSelectOnNullParameter	Ruft einen Wert ab, der angibt, ob ein Datenabrufvorgang abgebrochen werden soll, wenn einer der in der SelectParameters-Auflistung enthaltenen Parameter mit `null` ausgewertet wird, oder legt diesen Wert fest.
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 Bezeichner des Serversteuerelements ab. (Geerbt von DataSourceControl)
ClientIDMode	Diese Eigenschaft wird nicht für Datenquellensteuerelemente verwendet. (Geerbt von DataSourceControl)
ClientIDSeparator	Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt. (Geerbt von Control)
ConflictDetection	Ruft einen Wert ab, der bestimmt, wie das SqlDataSource-Steuerelement Aktualisierungs- und Löschvorgänge ausführt, wenn die Daten einer Zeile in der zugrunde liegenden Datenbank während der Vorgangsausführung geändert werden, oder legt diesen Wert fest.
ConnectionString	Ruft die für den ADO.NET-Anbieter spezifische Zeichenfolge ab, die das SqlDataSource-Steuerelement für die Verbindung zu einer zugrunde liegenden Datenbank verwendet, oder legt diese Zeichenfolge fest.
Context	Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab. (Geerbt von Control)
Controls	Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt. (Geerbt von DataSourceControl)
DataItemContainer	Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird. (Geerbt von Control)
DataKeysContainer	Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird. (Geerbt von Control)
DataSourceMode	Ruft den Datenabrufmodus ab, mit dem das SqlDataSource-Steuerelement Daten abruft, oder legt diesen fest.
DeleteCommand	Ruft die SQL-Zeichenfolge ab, die vom SqlDataSource-Steuerelement zum Löschen von Daten aus der zugrunde liegenden Datenbank verwendet wird, oder legt diese Zeichenfolge fest.
DeleteCommandType	Ruft einen Wert ab, der angibt, ob der Text in der DeleteCommand-Eigenschaft eine SQL-Anweisung oder der Name einer gespeicherten Prozedur ist, oder legt diesen Wert fest.
DeleteParameters	Ruft die Parameterauflistung mit den Parametern ab, die von der DeleteCommand-Eigenschaft des dem SqlDataSourceView-Steuerelement zugeordneten SqlDataSource-Objekts verwendet werden.
DesignMode	Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control)
EnableCaching	Ruft einen Wert ab, der angibt, ob für das SqlDataSource-Steuerelement die Zwischenspeicherung von Daten aktiviert ist, oder legt diesen fest.
EnableTheming	Ruft einen Wert ab, der angibt, ob Designs von diesem Objekt unterstützt werden. (Geerbt von DataSourceControl)
EnableViewState	Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest. (Geerbt von Control)
Events	Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control)
FilterExpression	Ruft einen Filterausdruck ab, der angewendet wird, wenn die Select(DataSourceSelectArguments)-Methode aufgerufen wird, oder legt diesen fest.
FilterParameters	Ruft eine Auflistung von Parametern ab, die beliebigen Parameterplatzhaltern in der FilterExpression-Zeichenfolge zugeordnet sind.
HasChildViewState	Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind. (Geerbt von Control)
ID	Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control)
IdSeparator	Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab. (Geerbt von Control)
InsertCommand	Ruft die SQL-Zeichenfolge ab, die vom SqlDataSource-Steuerelement zum Einfügen von Daten in die zugrunde liegende Datenbank verwendet wird, oder legt diese Zeichenfolge fest.
InsertCommandType	Ruft einen Wert ab, der angibt, ob der Text in der InsertCommand-Eigenschaft eine SQL-Anweisung oder der Name einer gespeicherten Prozedur ist, oder legt diesen Wert fest.
InsertParameters	Ruft die Parameterauflistung mit den Parametern ab, die von der InsertCommand-Eigenschaft des dem SqlDataSourceView-Steuerelement zugeordneten SqlDataSource-Objekts verwendet werden.
IsChildControlStateCleared	Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen. (Geerbt von Control)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands 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 seinen Ansichtszustand über ID anstatt über den Index lädt. (Geerbt von Control)
NamingContainer	Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann. (Geerbt von Control)
OldValuesParameterFormatString	Ruft eine Formatzeichenfolge ab, die auf die Namen aller Parameter angewendet wird, die an die Delete()-Methode oder an die Update()-Methode übergeben werden, oder legt diese Formatzeichenfolge fest.
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 Steuerelementhierarchie der Seite ab. (Geerbt von Control)
ProviderName	Ruft den Namen des .NET Framework-Datenanbieters ab, mit dem das SqlDataSource-Steuerelement eine Bindung zu einer zugrunde liegenden Datenquelle herstellt, oder legt diesen Namen fest.
RenderingCompatibility	Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind. (Geerbt von Control)
SelectCommand	Ruft die SQL-Zeichenfolge ab, die vom SqlDataSource-Steuerelement zum Abrufen von Daten aus der zugrunde liegenden Datenbank verwendet wird, oder legt diese Zeichenfolge fest.
SelectCommandType	Ruft einen Wert ab, der angibt, ob der Text in der SelectCommand-Eigenschaft eine SQL-Abfrage oder der Name einer gespeicherten Prozedur ist, oder legt diesen Wert fest.
SelectParameters	Ruft die Parameterauflistung mit den Parametern ab, die von der SelectCommand-Eigenschaft des dem SqlDataSourceView-Steuerelement zugeordneten SqlDataSource-Objekts verwendet werden.
Site	Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control)
SkinID	Ruft die Skin ab, um sie auf das DataSourceControl-Steuerelement anzuwenden. (Geerbt von DataSourceControl)
SortParameterName	Ruft den Namen eines Parameters für eine gespeicherte Prozedur ab, mit der abgerufene Daten sortiert werden, sofern der Abruf mit einer gespeicherten Prozedur erfolgt ist, oder legt diesen Namen fest.
SqlCacheDependency	Ruft eine durch Semikolons getrennte Zeichenfolge ab, die die für die Microsoft SQL Server-Cacheabhängigkeit zu verwendenden Datenbanken und Tabellen angibt, oder legt diese fest.
TemplateControl	Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest. (Geerbt von Control)
TemplateSourceDirectory	Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist. (Geerbt von Control)
UniqueID	Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control)
UpdateCommand	Ruft die SQL-Zeichenfolge ab, die vom SqlDataSource-Steuerelement zum Aktualisieren von Daten in der zugrunde liegenden Datenbank verwendet wird, oder legt diese Zeichenfolge fest.
UpdateCommandType	Ruft einen Wert ab, der angibt, ob der Text in der UpdateCommand-Eigenschaft eine SQL-Anweisung oder der Name einer gespeicherten Prozedur ist, oder legt diesen Wert fest.
UpdateParameters	Ruft die Parameterauflistung mit den Parametern ab, die von der UpdateCommand-Eigenschaft des dem SqlDataSourceView-Steuerelement zugeordneten SqlDataSource-Steuerelements verwendet werden.
ValidateRequestMode	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft. (Geerbt von Control)
ViewState	Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von Control)
ViewStateIgnoresCase	Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird. (Geerbt von Control)
ViewStateMode	Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest. (Geerbt von Control)
Visible	Ruft einen Wert ab, der angibt, ob das Steuerelement visuell dargestellt wird, oder legt diesen fest. (Geerbt von DataSourceControl)

Methoden

AddedControl(Control, Int32)	Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde. (Geerbt von Control)
AddParsedSubObject(Object)	Benachrichtigt das Serversteuerelement, dass entweder ein XML-Element oder HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu. (Geerbt von Control)
ApplyStyleSheetSkin(Page)	Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement. (Geerbt von DataSourceControl)
BeginRenderTracing(TextWriter, Object)	Startet die Entwurfszeitablaufverfolgung des Renderns von Daten. (Geerbt von Control)
BuildProfileTree(String, Boolean)	Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control)
ClearCachedClientID()	Legt den zwischengespeicherten ClientID-Wert auf `null` fest. (Geerbt von Control)
ClearChildControlState()	Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearChildState()	Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearChildViewState()	Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearEffectiveClientIDMode()	Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest. (Geerbt von Control)
CreateChildControls()	Wird durch das ASP.NET-Seitenframework aufgerufen, um Serversteuerelemente anzuweisen, die eine kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf ein Postback oder Rendering enthalten. (Geerbt von Control)
CreateControlCollection()	Erstellt eine Auflistung zum Speichern untergeordneter Steuerelemente. (Geerbt von DataSourceControl)
CreateDataSourceView(String)	Erstellt ein Objekt für die Datenquellenansicht, das dem Datenquellen-Steuerelement zugeordnet ist.
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 der Option, das DataBinding-Ereignis auszulösen. (Geerbt von Control)
DataBindChildren()	Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
Delete()	Führt mithilfe der DeleteCommand-SQL-Zeichenfolge und allen Parametern, die in der DeleteParameters-Auflistung vorhanden sind, einen Löschvorgang aus.
Dispose()	Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird. (Geerbt von Control)
EndRenderTracing(TextWriter, Object)	Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten. (Geerbt von Control)
EnsureChildControls()	Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control)
EnsureID()	Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen. (Geerbt von Control)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FindControl(String)	Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen `id`-Parameter. (Geerbt von DataSourceControl)
FindControl(String, Int32)	Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen `id` und einer ganzen Zahl, die im `pathOffset`-Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl-Methode nicht überschreiben. (Geerbt von Control)
Focus()	Setzt den Eingabefokus auf das Steuerelement. (Geerbt von DataSourceControl)
GetDbProviderFactory()	Gibt das DbProviderFactory-Objekt zurück, das dem von der ProviderName-Eigenschaft bezeichneten ADO.NET-Anbieter zugeordnet ist.
GetDesignModeState()	Ruft die Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control)
GetHashCode()	Fungiert 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 den Type der aktuellen Instanz ab. (Geerbt von Object)
GetUniqueIDRelativeTo(Control)	Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control)
GetView(String)	Ruft die benannte Datenquellenansicht ab, die dem Datenquellen-Steuerelement zugeordnet ist.
GetViewNames()	Ruft eine Auflistung von Namen ab, die die Liste der Ansichtsobjekte darstellt, die dem SqlDataSource-Steuerelement zugeordnet sind.
HasControls()	Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Geerbt von DataSourceControl)
HasEvents()	Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden. (Geerbt von Control)
Insert()	Führt mithilfe der InsertCommand-SQL-Zeichenfolge und allen Parametern, die in der InsertParameters-Auflistung vorhanden sind, einen Einfügevorgang aus.
IsLiteralContent()	Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält. (Geerbt von Control)
LoadControlState(Object)	Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden. (Geerbt von Control)
LoadViewState(Object)	Lädt den Zustand der beizubehaltenden Eigenschaften im SqlDataSource-Steuerelement.
MapPathSecure(String)	Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist. (Geerbt von Control)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnBubbleEvent(Object, EventArgs)	Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben übergeben wird. (Geerbt von Control)
OnDataBinding(EventArgs)	Löst das DataBinding-Ereignis aus. (Geerbt von Control)
OnInit(EventArgs)	Fügt einen LoadComplete-Ereignishandler zum Page-Steuerelement hinzu, das das SqlDataSource-Steuerelement enthält.
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 zum Lesen einer Datei ab. (Geerbt von Control)
RaiseBubbleEvent(Object, EventArgs)	Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu. (Geerbt von Control)
RaiseDataSourceChangedEvent(EventArgs)	Löst das DataSourceChanged-Ereignis aus. (Geerbt von DataSourceControl)
RemovedControl(Control)	Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde. (Geerbt von Control)
Render(HtmlTextWriter)	Sendet den Inhalt des Steuerelements an ein angegebenes HtmlTextWriter-Objekt, das den auf dem Client zu rendernden Inhalt schreibt. (Geerbt von Control)
RenderChildren(HtmlTextWriter)	Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den auf dem Client zu rendernden Inhalt schreibt. (Geerbt von Control)
RenderControl(HtmlTextWriter)	Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist. (Geerbt von DataSourceControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus. (Geerbt von Control)
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)	Konvertiert eine URL in eine vom anfordernden Client verwendbare URL. (Geerbt von Control)
SaveControlState()	Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde. (Geerbt von Control)
SaveViewState()	Speichert den aktuellen Ansichtszustand des SqlDataSource-Steuerelements.
Select(DataSourceSelectArguments)	Ruft Daten aus der zugrunde liegenden Datenbank mithilfe der SelectCommand-SQL-Zeichenfolge und aller Parameter in der SelectParameters-Auflistung ab.
SetDesignModeState(IDictionary)	Legt die Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control)
SetRenderMethodDelegate(RenderMethod)	Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern. (Geerbt von Control)
SetTraceData(Object, Object)	Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest. (Geerbt von Control)
SetTraceData(Object, Object, Object)	Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest. (Geerbt von Control)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TrackViewState()	Verfolgt Änderungen des Ansichtszustands für das SqlDataSource-Steuerelement, sodass die Änderungen im StateBag-Objekt für das Steuerelement gespeichert werden können.
Update()	Führt mithilfe der UpdateCommand-SQL-Zeichenfolge und allen Parametern, die in der UpdateParameters-Auflistung vorhanden sind, einen Aktualisierungsvorgang aus.

Ereignisse

DataBinding	Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt. (Geerbt von Control)
Deleted	Tritt ein, wenn ein Löschvorgang abgeschlossen ist.
Deleting	Tritt vor einem Löschvorgang ein.
Disposed	Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite. (Geerbt von Control)
Filtering	Tritt vor einem Filtervorgang auf.
Init	Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus. (Geerbt von Control)
Inserted	Tritt ein, wenn ein Einfügevorgang abgeschlossen wurde.
Inserting	Tritt vor einem Einfügevorgang ein.
Load	Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird. (Geerbt von Control)
PreRender	Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein. (Geerbt von Control)
Selected	Tritt ein, wenn ein Datenabrufvorgang abgeschlossen wurde.
Selecting	Tritt vor einem Datenabrufvorgang ein.
Unload	Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird. (Geerbt von Control)
Updated	Tritt ein, wenn ein Aktualisierungsvorgang abgeschlossen wurde.
Updating	Tritt vor einem Aktualisierungsvorgang ein.

Explizite Schnittstellenimplementierungen

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

Erweiterungsmethoden

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 Metatabellenobjekt für das enthaltende Datensteuerelement zurück.
GetDefaultValues(IDataSource)	Ruft die Auflistung von Standardwerten 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:

Freigeben über