SqlDataSourceView.SelectCommand Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri vagy beállítja azt az SQL-sztringet, amelyet az SqlDataSourceView objektum az alapul szolgáló adatbázis adatainak lekéréséhez használ.
public:
property System::String ^ SelectCommand { System::String ^ get(); void set(System::String ^ value); };
public string SelectCommand { get; set; }
member this.SelectCommand : string with get, set
Public Property SelectCommand As String
Tulajdonság értéke
Az adatok lekérésére használt SQL-sztring SqlDataSourceView .
Példák
Ez a szakasz két példakódot tartalmaz. Az első példakód bemutatja, hogyan állíthatja be a SelectCommand szöveget egy egyszerű SQL-lekérdezésre, amely adatokat kér le egy Microsoft SQL Server-adatbázis, és hogyan jelenítheti meg egy DropDownList vezérlőelemben. A második példakód bemutatja, hogyan állíthatja be a SelectCommand szöveget egy tárolt eljárás nevére, amely adatokat kér le egy SQL Server adatbázisból, és hogyan jelenítheti meg egy DropDownList.
Az alábbi példakód bemutatja, hogyan állíthatja be a SelectCommand szöveget egy egyszerű SQL-lekérdezésre, amely adatokat kér le egy SQL Server-adatbázisból, és hogyan jelenítheti meg azokat egy DropDownList vezérlőelemben. A Button vezérlők egyszerű TextBox felületként vannak megadva a kiválasztott felhasználó címének frissítéséhez a DropDownList.
<%@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>
Az alábbi példakód bemutatja, hogyan állíthatja be a SelectCommand szöveget egy tárolt eljárás nevére, amely adatokat kér le egy SQL Server adatbázisból, és hogyan jelenítheti meg egy DropDownList vezérlőelemben. A SelectCommand tulajdonság lehet SQL-lekérdezés vagy tárolt eljárás neve, ha az adatforrás támogatja a tárolt eljárásokat.
<!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:DropDownList
id="DropDownList1"
runat="server"
DataTextField="LastName"
DataSourceID="SqlDataSource1" />
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommandType="StoredProcedure"
SelectCommand="sp_lastnames">
</asp:SqlDataSource>
<!--
The sp_lastnames stored procedure is
CREATE PROCEDURE sp_lastnames AS
SELECT LastName FROM Employees
GO
-->
</form>
</body>
</html>
<!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:DropDownList
id="DropDownList1"
runat="server"
DataTextField="LastName"
DataSourceID="SqlDataSource1" />
<asp:SqlDataSource
id="SqlDataSource1"
runat="server"
ConnectionString="<%$ ConnectionStrings:MyNorthwind%>"
SelectCommandType = "StoredProcedure"
SelectCommand="sp_lastnames">
</asp:SqlDataSource>
<!--
The sp_lastnames stored procedure is
CREATE PROCEDURE sp_lastnames AS
SELECT LastName FROM Employees
GO
-->
</form>
</body>
</html>
Megjegyzések
Mivel a különböző adatbázis-termékek különböző SQL-típusokat használnak, az SQL-sztring szintaxisa az aktuális ADO.NET-szolgáltatótól függ, amelyet a ProviderName tulajdonság azonosít. Ha az SQL-sztring paraméteres lekérdezés vagy parancs, a paraméter helyőrzője a használt ADO.NET szolgáltatótól is függ. Ha például a szolgáltató az System.Data.SqlClientosztály alapértelmezett szolgáltatójaSqlDataSource, akkor a paraméter helyőrzője.'@parameterName' Ha azonban a szolgáltató az System.Data.Odbc vagy System.Data.OleDb, akkor a paraméter helyőrzője .'?' A paraméteres SQL-lekérdezésekkel és -parancsokkal kapcsolatos további információkért lásd: Paraméterek használata az SqlDataSource-vezérlővel.
A SelectCommand tulajdonság lehet SQL-sztring vagy tárolt eljárás neve, ha az adatforrás támogatja a tárolt eljárásokat.
Important
Biztonságosabb a tárolt eljárás használata, mint a tulajdonság SQL-utasítása SelectCommand .
A tulajdonság értéke SelectCommand megtekintési állapotban van tárolva.