SqlDataSource Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje bazę danych SQL do kontrolek powiązanych z danymi.

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

Dziedziczenie: Object

Control

DataSourceControl
SqlDataSource

Pochodne: System.Web.UI.WebControls.AccessDataSource

Atrybuty: ToolboxBitmapAttribute

Przykłady

Ta sekcja zawiera cztery przykłady kodu:

Pierwszy przykład kodu pokazuje, jak wyświetlać dane z programu SQL Server w kontrolce przy użyciu składni deklaratywnej GridView .
Drugi przykład kodu pokazuje, jak wyświetlać dane z bazy danych zgodnej ze standardem ODBC w kontrolce przy użyciu składni deklaratywnej GridView .
Trzeci przykład kodu pokazuje, jak wyświetlać i aktualizować dane w kontrolce GridView .
Czwarty przykład kodu pokazuje, jak wyświetlać i aktualizować dane w kontrolce DropDownList .

Uwaga

W tych przykładach pokazano, jak używać składni deklaratywnej na potrzeby dostępu do danych. Aby uzyskać informacje na temat uzyskiwania dostępu do danych przy użyciu kodu zamiast znaczników, zobacz Uzyskiwanie dostępu do danych w programie Visual Studio.

W poniższym przykładzie kodu pokazano, jak deklaratywnie używać SqlDataSource kontrolki do pobierania danych z programu SQL Server i wyświetlania ich w kontrolce GridView .

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

W poniższym przykładzie kodu pokazano, jak deklaratywnie używać SqlDataSource kontrolki do pobierania danych z bazy danych zgodnej ze standardem ODBC i wyświetlania jej w kontrolce GridView . Właściwość ProviderName jest nazwą dostawcy danych .NET Framework dla ODBC, czyli 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>

Poniższy przykład kodu przedstawia typowy scenariusz wyświetlania i aktualizowania za pomocą kontrolki GridView . Podobnie jak w poprzednich przykładach, dane z bazy danych Northwind są wyświetlane w kontrolce GridView . Ponadto, ponieważ UpdateCommand właściwość jest określona, a AutoGenerateEditButton właściwość jest ustawiona na true, można edytować i aktualizować rekordy bez dodatkowego kodu. Kontrolka GridView automatycznie obsługuje dodawanie parametrów do UpdateParameters kolekcji i wywołuje Update metodę po kliknięciu przycisku Aktualizuj w kontrolce GridView .

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

Poniższy przykład kodu przedstawia typowy scenariusz wyświetlania i aktualizowania za pomocą DropDownList kontrolek i .TextBox Kontrolka DropDownList nie dodaje automatycznie parametrów aktualizacji do UpdateParameters kolekcji ani nie wywołuje Update metody, dlatego należy to zrobić. Parametry aktualizacji są określane deklaratywnie i można dodać procedurę obsługi zdarzeń, aby wykonać operację po wystąpieniu Update zdarzenia.

Ważne

Ten przykład zawiera pole tekstowe, które akceptuje dane wejściowe użytkownika, co jest potencjalnym zagrożeniem bezpieczeństwa. Domyślnie ASP.NET strony sieci Web weryfikują, czy dane wejściowe użytkownika nie zawierają skryptów ani elementów HTML. Aby uzyskać więcej informacji, zobacz Omówienie luk w zabezpieczeniach skryptów.

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

Uwagi

W tym temacie:

Wprowadzenie
Połączenia danych
Wykonywanie operacji na danych
Dostawca danych
Buforowanie
Dodatkowe funkcje
Widok źródła danych
Składnia deklaracyjna

Wprowadzenie

Kontrolka SqlDataSource źródła danych reprezentuje dane w relacyjnej bazie danych SQL do kontrolek powiązanych z danymi. Kontrolkę SqlDataSource można używać w połączeniu z kontrolką powiązaną z danymi, aby pobierać dane z relacyjnej bazy danych oraz wyświetlać, edytować i sortować dane na stronie sieci Web bez kodu.

Połączenia danych

Aby nawiązać połączenie z bazą danych, należy ustawić ConnectionString właściwość na prawidłowe parametry połączenia. Może SqlDataSource obsługiwać dowolną relacyjną bazę danych SQL, z którą można nawiązać połączenie przy użyciu dostawcy ADO.NET, takiego jak SqlClientdostawca , OleDb, Odbclub OracleClient . Aby uzyskać informacje na temat zabezpieczania parametrów połączenia, zobacz How To: Secure Connection Strings when Using Data Source Controls (Instrukcje: zabezpieczanie parametrów połączenia podczas korzystania z kontrolek źródła danych).

Aby pobrać dane z bazowej bazy danych, ustaw SelectCommand właściwość za pomocą zapytania SQL. Jeśli baza danych SqlDataSource skojarzona z obsługuje procedury składowane, można ustawić SelectCommand właściwość na nazwę procedury składowanej. Określone zapytanie SQL może być również zapytaniem sparametryzowanym. Do kolekcji można dodawać Parameter obiekty skojarzone z sparametryzowanym zapytaniem SelectParameters . Aby uzyskać więcej informacji na temat sparametryzowanych zapytań SQL i ich składni, zobacz Using Parameters with Data Source Controls for Filtering (Używanie parametrów z kontrolkami źródła danych do filtrowania).

Kontrolka SqlDataSource pobiera dane za każdym razem, gdy jest wywoływana Select metoda. Ta metoda zapewnia programowy dostęp do metody określonej przez SelectMethod właściwość. Metoda Select jest wywoływana automatycznie przez kontrolki powiązane z wywołaną SqlDataSource DataBind metodą . Jeśli ustawisz DataSourceID właściwość kontrolki powiązanej z danymi, kontrolka automatycznie wiąże się z danymi ze źródła danych zgodnie z potrzebami. DataSourceID Ustawienie właściwości jest zalecaną metodą powiązania kontrolki ObjectDataSource z formantem powiązanym z danymi. Alternatywnie można użyć DataSource właściwości , ale następnie należy jawnie wywołać DataBind metodę kontrolki powiązanej z danymi. Niektóre przykłady kontrolek powiązanych z danymi, których można użyć SqlDataSource , to DataGrid, DetailsView, DataListi DropDownList. Metodę Select można wywołać programowo w dowolnym momencie, aby pobrać dane z bazowej bazy danych.

W scenariuszach deklaratywnych i programowych ASP.NET można ustawić DataSourceID właściwość kontrolki powiązanej z danymi na identyfikator kontrolki SqlDataSource . Możesz również przypisać wystąpienie SqlDataSource klasy do DataSource właściwości kontrolki powiązanej z danymi. Aby uzyskać więcej informacji na temat powiązania kontroli powiązanej z danymi do kontrolek źródła danych, zobacz ASP.NET Opcje dostępu do danych.

Wykonywanie operacji na danych

W zależności od możliwości bazowego produktu bazy danych i konfiguracji wystąpienia SqlDataSource klasy można wykonywać operacje danych, takie jak aktualizacje, wstawianie i usuwanie. Aby wykonać te operacje danych, ustaw odpowiedni tekst polecenia i wszystkie skojarzone parametry dla operacji, którą chcesz wykonać. Na przykład w przypadku operacji aktualizacji ustaw UpdateCommand właściwość na ciąg SQL lub nazwę procedury składowanej i dodaj do kolekcji wszystkie wymagane parametry UpdateParameters . Aktualizacja jest wykonywana po wywołaniu Update metody jawnie przez kod lub automatycznie za pomocą kontrolki powiązanej z danymi. Ten sam ogólny wzorzec jest obserwowany dla Delete operacji i .Insert

Zapytania SQL i polecenia używane w SelectCommandwłaściwościach , UpdateCommand, InsertCommandi DeleteCommand można sparametryzować. Oznacza to, że zapytanie lub polecenie może używać symboli zastępczych zamiast wartości literałów i powiązać symbole zastępcze ze zmiennymi aplikacji lub zdefiniowanymi przez użytkownika. Parametry w zapytaniach SQL można powiązać ze zmiennymi sesji, wartościami przekazywanymi w ciągu zapytania dla strony formularzy sieci Web, wartościami właściwości innych kontrolek serwera i nie tylko. Aby uzyskać więcej informacji na temat używania parametrów w zapytaniach SQL z elementem , zobacz Using Parameters with Data Source Controls for Filtering and Using Parameters with the SqlDataSource Control (Używanie parametrów z kontrolką SqlDataSource).SqlDataSource

Uwaga

Domyślnie, jeśli jeden z parametrów jest null podczas wykonywania Select polecenia, żadne dane nie zostaną zwrócone i nie zostanie zgłoszony żaden wyjątek. To zachowanie można zmienić, ustawiając CancelSelectOnNullParameter właściwość na false.

Dostawca danych

Domyślnie kontrolka SqlDataSource współpracuje z dostawcą danych programu .NET Framework dla programu SQL Server, ale SqlDataSource nie jest specyficzna dla programu Microsoft SQL Server. Kontrolkę SqlDataSource można połączyć z dowolnym produktem bazy danych, dla którego istnieje zarządzany dostawca ADO.NET. W przypadku użycia z dostawcą System.Data.OleDb usługa SqlDataSource może pracować z dowolną bazą danych zgodną z ole DB. W przypadku użycia z dostawcą System.Data.Odbc SqlDataSource można go używać z dowolnym sterownikiem i bazą danych ODBC, w tym IBM DB2, MySQL i PostgreSQL. W przypadku użycia z dostawcą System.Data.OracleClient SqlDataSource program może pracować z bazami danych Oracle 8.1.7 i nowszymi wersjami. Lista dozwolonych dostawców jest zarejestrowana w DbProviderFactories sekcji pliku konfiguracji w pliku Machine.config lub Web.config. Aby uzyskać więcej informacji, zobacz Wybieranie danych przy użyciu kontrolki SqlDataSource.

Buforowanie

Jeśli dane na stronie są wyświetlane przy użyciu SqlDataSource kontrolki, możesz zwiększyć wydajność strony przy użyciu funkcji buforowania danych kontroli źródła danych. Buforowanie zmniejsza obciążenie przetwarzania na serwerach baz danych kosztem pamięci na serwerze sieci Web; w większości przypadków jest to dobry kompromis. Właściwość SqlDataSource automatycznie buforuje dane, gdy EnableCaching właściwość jest ustawiona true na , a CacheDuration właściwość jest ustawiona na liczbę sekund, w których pamięć podręczna przechowuje dane przed odrzuceniem wpisu pamięci podręcznej. Można również określić CacheExpirationPolicy wartość i opcjonalną SqlCacheDependency .

Dodatkowe funkcje

Zapewnia SqlDataSource dodatkowe możliwości, jak pokazano w poniższej tabeli.

Możliwość	Wymagania
Buforowanie	DataSourceMode Ustaw właściwość na DataSet wartość , EnableCaching właściwość na `true`, i CacheDuration CacheExpirationPolicy właściwości zgodnie z zachowaniem buforowania, które ma być przechowywane w pamięci podręcznej.
Usuwanie	DeleteCommand Ustaw właściwość na instrukcję SQL używaną do usuwania danych. Ta instrukcja jest zwykle sparametryzowana.
Filtrowanie	DataSourceMode Ustaw właściwość na DataSet wartość . FilterExpression Ustaw właściwość na wyrażenie filtrowania używane do filtrowania danych po Select wywołaniu metody.
Wstawianie	InsertCommand Ustaw właściwość na instrukcję SQL używaną do wstawiania danych. Ta instrukcja jest zwykle sparametryzowana.
Stronicowanie	Obecnie nieobsługiwane przez kontrolki SqlDataSource, jednak niektóre kontrolki powiązane z danymi, takie jak GridView, obsługują stronicowanie podczas ustawiania DataSourceMode właściwości na DataSet wartość.
Wybieranie	SelectCommand Ustaw właściwość na instrukcję SQL używaną do pobierania danych.
Sortowanie	DataSourceMode Ustaw właściwość na DataSet.
Aktualizowanie	UpdateCommand Ustaw właściwość na instrukcję SQL używaną do aktualizowania danych. Ta instrukcja jest zwykle sparametryzowana.

Widok źródła danych

Podobnie jak w przypadku wszystkich kontrolek źródła danych, kontrolka SqlDataSource jest skojarzona z klasą widoku źródła danych. Kontrolka SqlDataSource ma tylko jeden skojarzony element SqlDataSourceViewi zawsze nosi nazwę Table.

Nie ma wizualnego SqlDataSource renderowania kontrolki. Jest on implementowany jako kontrolka, dzięki czemu można ją utworzyć deklaratywnie i opcjonalnie, aby umożliwić jej uczestnictwo w zarządzaniu stanem. W związku z tym element SqlDataSource nie obsługuje funkcji wizualnych, takich jak te, które są udostępniane przez EnableTheming właściwość lub SkinID .

Składnia deklaracyjna

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

Konstruktory

SqlDataSource()	Inicjuje nowe wystąpienie klasy SqlDataSource.
SqlDataSource(String, String)	Inicjuje SqlDataSource nowe wystąpienie klasy z określonymi parametrami połączenia i polecenie Select.
SqlDataSource(String, String, String)	Inicjuje SqlDataSource nowe wystąpienie klasy z określonymi parametrami połączenia i polecenie Select.

Właściwości

Adapter	Pobiera kartę specyficzną dla przeglądarki dla kontrolki. (Odziedziczone po Control)
AppRelativeTemplateSourceDirectory	Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę. (Odziedziczone po Control)
BindingContainer	Pobiera kontrolkę zawierającą powiązanie danych tej kontrolki. (Odziedziczone po Control)
CacheDuration	Pobiera lub ustawia czas w sekundach, przez który kontrola źródła danych buforuje dane pobierane przez metodę Select(DataSourceSelectArguments) .
CacheExpirationPolicy	Pobiera lub ustawia zachowanie wygasania pamięci podręcznej, które w połączeniu z czasem trwania opisuje zachowanie pamięci podręcznej używanej przez kontrolę źródła danych.
CacheKeyDependency	Pobiera lub ustawia zależność klucza zdefiniowanego przez użytkownika, która jest połączona z wszystkimi obiektami pamięci podręcznej danych utworzonymi przez kontrolę źródła danych. Wszystkie obiekty pamięci podręcznej są jawnie wygasły po wygaśnięciu klucza.
CancelSelectOnNullParameter	Pobiera lub ustawia wartość wskazującą, czy operacja pobierania danych jest anulowana, gdy dowolny parametr zawarty w SelectParameters kolekcji ma `null`wartość .
ChildControlsCreated	Pobiera wartość wskazującą, czy kontrolka podrzędna kontrolki serwera została utworzona. (Odziedziczone po Control)
ClientID	Pobiera identyfikator kontroli serwera wygenerowany przez ASP.NET. (Odziedziczone po DataSourceControl)
ClientIDMode	Ta właściwość nie jest używana w przypadku kontrolek źródła danych. (Odziedziczone po DataSourceControl)
ClientIDSeparator	Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości . (Odziedziczone po Control)
ConflictDetection	Pobiera lub ustawia wartość wskazującą, jak SqlDataSource kontrolka wykonuje aktualizacje i usuwa dane w wierszu w bazowej bazie danych zmienia się w czasie operacji.
ConnectionString	Pobiera lub ustawia parametry połączenia specyficzne dla dostawcy ADO.NET używane SqlDataSource przez kontrolkę do nawiązywania połączenia z bazową bazą danych.
Context	HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web. (Odziedziczone po Control)
Controls	ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika. (Odziedziczone po DataSourceControl)
DataItemContainer	Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement . (Odziedziczone po Control)
DataKeysContainer	Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement . (Odziedziczone po Control)
DataSourceMode	Pobiera lub ustawia tryb pobierania danych używany SqlDataSource przez kontrolkę do pobierania danych.
DeleteCommand	Pobiera lub ustawia ciąg SQL używany SqlDataSource przez kontrolkę do usuwania danych z bazowej bazy danych.
DeleteCommandType	Pobiera lub ustawia wartość wskazującą, czy tekst we DeleteCommand właściwości jest instrukcją SQL, czy nazwą procedury składowanej.
DeleteParameters	Pobiera kolekcję parametrów zawierającą parametry używane przez DeleteCommand właściwość z SqlDataSourceView obiektu skojarzonego z kontrolką SqlDataSource .
DesignMode	Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej. (Odziedziczone po Control)
EnableCaching	Pobiera lub ustawia wartość wskazującą, czy kontrolka SqlDataSource ma włączoną buforowanie danych.
EnableTheming	Pobiera wartość wskazującą, czy ta kontrolka obsługuje motywy. (Odziedziczone po DataSourceControl)
EnableViewState	Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku, oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta żądającego. (Odziedziczone po Control)
Events	Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu. (Odziedziczone po Control)
FilterExpression	Pobiera lub ustawia wyrażenie filtrowania, które jest stosowane po wywołaniu Select(DataSourceSelectArguments) metody.
FilterParameters	Pobiera kolekcję parametrów skojarzonych z dowolnymi symbolami zastępczymi parametrów, które znajdują się w FilterExpression ciągu.
HasChildViewState	Pobiera wartość wskazującą, czy kontrolka podrzędna bieżącej kontrolki serwera ma jakiekolwiek zapisane ustawienia stanu widoku. (Odziedziczone po Control)
ID	Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera. (Odziedziczone po Control)
IdSeparator	Pobiera znak używany do oddzielania identyfikatorów kontrolek. (Odziedziczone po Control)
InsertCommand	Pobiera lub ustawia ciąg SQL używany SqlDataSource przez kontrolkę do wstawiania danych do bazowej bazy danych.
InsertCommandType	Pobiera lub ustawia wartość wskazującą, czy tekst we InsertCommand właściwości jest instrukcją SQL, czy nazwą procedury składowanej.
InsertParameters	Pobiera kolekcję parametrów zawierającą parametry używane przez InsertCommand właściwość z SqlDataSourceView obiektu skojarzonego z kontrolką SqlDataSource .
IsChildControlStateCleared	Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli. (Odziedziczone po Control)
IsTrackingViewState	Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku. (Odziedziczone po Control)
IsViewStateEnabled	Pobiera wartość wskazującą, czy stan widoku jest włączony dla tej kontrolki. (Odziedziczone po Control)
LoadViewStateByID	Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu ID widoku zamiast indeksu. (Odziedziczone po Control)
NamingContainer	Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do różnicowania między kontrolkami serwera o tej samej ID wartości właściwości. (Odziedziczone po Control)
OldValuesParameterFormatString	Pobiera lub ustawia ciąg formatu, który ma być stosowany do nazw wszystkich parametrów przekazywanych do Delete() metody lub Update() .
Page	Pobiera odwołanie do Page wystąpienia zawierającego kontrolkę serwera. (Odziedziczone po Control)
Parent	Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii kontrolek strony. (Odziedziczone po Control)
ProviderName	Pobiera lub ustawia nazwę dostawcy danych .NET Framework, którego SqlDataSource kontrolka używa do nawiązywania połączenia z bazowym źródłem danych.
RenderingCompatibility	Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny. (Odziedziczone po Control)
SelectCommand	Pobiera lub ustawia ciąg SQL używany SqlDataSource przez kontrolkę do pobierania danych z bazowej bazy danych.
SelectCommandType	Pobiera lub ustawia wartość wskazującą, czy tekst we SelectCommand właściwości jest zapytaniem SQL, czy nazwą procedury składowanej.
SelectParameters	Pobiera kolekcję parametrów zawierającą parametry używane przez SelectCommand właściwość z SqlDataSourceView obiektu skojarzonego z kontrolką SqlDataSource .
Site	Pobiera informacje o kontenerze hostujące bieżącą kontrolkę podczas renderowania na powierzchni projektowej. (Odziedziczone po Control)
SkinID	Pobiera skórę do zastosowania do kontrolki DataSourceControl . (Odziedziczone po DataSourceControl)
SortParameterName	Pobiera lub ustawia nazwę parametru procedury składowanej używanego do sortowania pobranych danych podczas pobierania danych przy użyciu procedury składowanej.
SqlCacheDependency	Pobiera lub ustawia rozdzielany średnikami ciąg wskazujący, które bazy danych i tabele mają być używane dla zależności pamięci podręcznej programu Microsoft SQL Server.
TemplateControl	Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę. (Odziedziczone po Control)
TemplateSourceDirectory	Pobiera katalog wirtualny elementu Page lub UserControl , który zawiera bieżącą kontrolkę serwera. (Odziedziczone po Control)
UniqueID	Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera. (Odziedziczone po Control)
UpdateCommand	Pobiera lub ustawia ciąg SQL używany SqlDataSource przez kontrolkę do aktualizowania danych w bazowej bazie danych.
UpdateCommandType	Pobiera lub ustawia wartość wskazującą, czy tekst we UpdateCommand właściwości jest instrukcją SQL, czy nazwą procedury składowanej.
UpdateParameters	Pobiera kolekcję parametrów zawierającą parametry używane przez UpdateCommand właściwość z SqlDataSourceView kontrolki skojarzonej z kontrolką SqlDataSource .
ValidateRequestMode	Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości. (Odziedziczone po Control)
ViewState	Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach dla tej samej strony. (Odziedziczone po Control)
ViewStateIgnoresCase	Pobiera wartość wskazującą, czy StateBag obiekt jest niewrażliwy na wielkość liter. (Odziedziczone po Control)
ViewStateMode	Pobiera lub ustawia tryb stanu widoku tej kontrolki. (Odziedziczone po Control)
Visible	Pobiera lub ustawia wartość wskazującą, czy kontrolka jest wyświetlana wizualnie. (Odziedziczone po DataSourceControl)

Metody

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

Zdarzenia

DataBinding	Występuje, gdy kontrolka serwera wiąże się ze źródłem danych. (Odziedziczone po Control)
Deleted	Występuje po zakończeniu operacji usuwania.
Deleting	Występuje przed operacją usuwania.
Disposed	Występuje, gdy kontrola serwera jest zwalniana z pamięci, co jest ostatnim etapem cyklu życia kontroli serwera, gdy jest żądana strona ASP.NET. (Odziedziczone po Control)
Filtering	Występuje przed operacją filtrowania.
Init	Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia. (Odziedziczone po Control)
Inserted	Występuje po zakończeniu operacji wstawiania.
Inserting	Występuje przed operacją wstawiania.
Load	Występuje, gdy kontrolka serwera jest ładowana do Page obiektu. (Odziedziczone po Control)
PreRender	Występuje po załadowaniu Control obiektu, ale przed renderowaniem. (Odziedziczone po Control)
Selected	Występuje po zakończeniu operacji pobierania danych.
Selecting	Występuje przed operacją pobierania danych.
Unload	Występuje, gdy kontrolka serwera jest zwalniana z pamięci. (Odziedziczone po Control)
Updated	Występuje po zakończeniu operacji aktualizacji.
Updating	Występuje przed operacją aktualizacji.

Jawne implementacje interfejsu

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

Metody rozszerzania

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

Dotyczy

Udostępnij za pośrednictwem