SqlDataSource.Select(DataSourceSelectArguments) Methode

public:
 System::Collections::IEnumerable ^ Select(System::Web::UI::DataSourceSelectArguments ^ arguments);

public System.Collections.IEnumerable Select (System.Web.UI.DataSourceSelectArguments arguments);

member this.Select : System.Web.UI.DataSourceSelectArguments -> System.Collections.IEnumerable

Public Function Select (arguments As DataSourceSelectArguments) As IEnumerable

Parameter

Gibt zurück

Eine IEnumerable-Liste mit Datenzeilen.

Ausnahmen

Beispiele

In den folgenden Beispielen wird gezeigt, wie Sie die Select -Methode programmgesteuert aufrufen und Werte basierend auf dem Ergebnis der Abfrage festlegen. Das folgende Beispiel zeigt den deklarativen Code für die Websteuerelemente.

<asp:SqlDataSource 
    ID="SqlDataSource1" 
    runat="server" 
    ConnectionString="<%$ ConnectionStrings:ConnectionString %>" 
    SelectCommand="SELECT Count(*) FROM [Products] WHERE ([ReorderLevel] > 0)">
</asp:SqlDataSource>
<asp:Label 
    ID="Label1" 
    runat="server" 
    Text="">
</asp:Label>
<br />
<asp:Button 
    ID="Button1" 
    Text="Check Reorder Status" 
    runat="server" 
    onclick="Button1_Click" />

<asp:SqlDataSource 
    ID="SqlDataSource1" 
    runat="server" 
    ConnectionString="<%$ ConnectionStrings:ConnectionString %>" 
    SelectCommand="SELECT Count(*) FROM [Products] WHERE ([ReorderLevel] > 0)">
</asp:SqlDataSource>
<asp:Label 
    ID="Label1" 
    runat="server" 
    Text="">
</asp:Label>
<br />
<asp:Button 
   ID="Button1" 
   Text="Check Reorder Status" 
   runat="server" 
   onclick="Button1_Click" />

Im folgenden Beispiel wird gezeigt, wie die Select -Methode programmgesteuert aufgerufen wird. Das SqlDataSource Steuerelement gibt eine ganze Zahl zurück. Der Wert der ganzen Zahl wird verwendet, um den Text eines Label Steuerelements festzulegen und zu bestimmen, ob ein HyperLink Steuerelement angezeigt werden soll.

protected void CheckReorderStatus()
{
    DataView dv = (DataView)SqlDataSource1.Select(DataSourceSelectArguments.Empty);
    int reorderedProducts = (int)dv.Table.Rows[0][0];
    if (reorderedProducts > 0)
    {
        Label1.Text = "Number of products on reorder: " + reorderedProducts;
    }
    else
    {
        Label1.Text = "No products on reorder.";
    }
}

protected void Button1_Click(object sender, EventArgs e)
{
    CheckReorderStatus();
}

Protected Sub CheckReorderStatus()
    Dim dv As DataView
    Dim reorderedProducts As Integer

    dv = CType(SqlDataSource1.Select(DataSourceSelectArguments.Empty), DataView)
    reorderedProducts = CType(dv.Table.Rows(0)(0), Integer)
    If (reorderedProducts > 0) Then
        Label1.Text = "Number of products on reorder: " & reorderedProducts
    Else
        Label1.Text = "No products on reorder."
    End If
End Sub

Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
    CheckReorderStatus()
End Sub

Hinweise

Die Select -Methode wird während der PreRender Phase des Seitenlebenszyklus automatisch aufgerufen. Sie wird von datengebundenen Steuerelementen aufgerufen, die über ihre DataSourceID -Eigenschaft an ein SqlDataSource Steuerelement angefügt wurden.

Die Select -Methode gibt ein DataView -Objekt zurück, wenn die DataSourceMode -Eigenschaft auf den DataSet -Wert festgelegt ist. Die Select -Methode gibt ein IDataReader -Objekt zurück, wenn die DataSourceMode -Eigenschaft auf den DataReader -Wert festgelegt ist. Schließen Sie das IDataReader -Objekt, wenn Sie das Lesen der Daten abgeschlossen haben.

Bevor der Select Vorgang ausgeführt wird, wird die OnSelecting -Methode aufgerufen, um das Ereignis auszulösen Selecting . Sie können dieses Ereignis behandeln, um die Werte der Parameter zu untersuchen und eine beliebige Verarbeitung vor dem Select Vorgang auszuführen.

Nach Abschluss des Select Vorgangs wird die OnSelected -Methode aufgerufen, um das -Ereignis auszulösen Selected . Sie können dieses Ereignis behandeln, um Rückgabewerte und Fehlercodes zu untersuchen und eine nachbereitende Verarbeitung durchzuführen.

Wenn die DataSourceMode -Eigenschaft auf SqlDataSourceMode.DataSet festgelegt und das Zwischenspeichern aktiviert ist, ruft das Objekt während Select des SqlDataSource Vorgangs Daten aus dem Cache ab und speichert diese im Cache. Der Cache wird basierend auf dem Zwischenspeicherungsverhalten erstellt, verworfen oder aktualisiert, das durch die Kombination der CacheDuration Eigenschaften und CacheExpirationPolicy angegeben wird.

Wenn die DataSourceMode -Eigenschaft auf SqlDataSourceMode.DataSet festgelegt und eine FilterExpression Eigenschaft angegeben wurde, wird der Filterausdruck mit allen angegebenen FilterParameters Eigenschaften ausgewertet, und der resultierende Filter wird während des Vorgangs Select auf die Liste der Daten angewendet.

Die Select -Methode delegiert an die Select -Methode des SqlDataSourceView Objekts, das dem SqlDataSource Steuerelement zugeordnet ist. Um einen Datenabrufvorgang auszuführen, erstellt ein SqlDataSourceViewDbCommand -Objekt unter Verwendung des SelectCommand Texts und aller zugeordneten SelectParameters Werte und führt dann für die DbCommand zugrunde liegende Datenbank aus.

Gilt für:

Weitere Informationen

• SelectCommand
• SelectParameters
• Datengebundene Webserversteuerelemente
• Übersicht über das SqlDataSource-Webserversteuerelement
• Übersicht über den Lebenszyklus der ASP.NET Seite