SqlDataSource.Select(DataSourceSelectArguments) Méthode

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

Paramètres

Retours

Liste IEnumerable de lignes de données.

Exceptions

Exemples

Les exemples suivants montrent comment appeler par programmation la Select méthode et définir des valeurs en fonction du résultat de la requête. L’exemple suivant montre le code déclaratif pour les contrôles Web.

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

L’exemple suivant montre comment appeler la Select méthode par programmation. Le SqlDataSource contrôle retourne un entier. La valeur de l’entier est utilisée pour définir le texte d’un Label contrôle et pour déterminer s’il faut afficher un HyperLink contrôle.

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

Remarques

La Select méthode est automatiquement appelée pendant la PreRender phase du cycle de vie de la page. Elle est appelée par les contrôles liés aux données qui ont été attachés à un SqlDataSource contrôle via leur DataSourceID propriété .

La Select méthode retourne un DataView objet si la DataSourceMode propriété est définie sur la DataSet valeur . La Select méthode retourne un IDataReader objet si la DataSourceMode propriété est définie sur la DataReader valeur . Fermez l’objet IDataReader lorsque vous avez terminé de lire les données.

Avant l’exécution de l’opération Select , la OnSelecting méthode est appelée pour déclencher l’événement Selecting . Vous pouvez gérer cet événement pour examiner les valeurs des paramètres et effectuer tout traitement avant l’opération Select .

Une fois l’opération Select terminée, la OnSelected méthode est appelée pour déclencher l’événement Selected . Vous pouvez gérer cet événement pour examiner les valeurs de retour et les codes d’erreur et effectuer tout post-traitement.

Si la DataSourceMode propriété est définie SqlDataSourceMode.DataSet sur et que la mise en cache est activée, l’objet SqlDataSource récupère les données de et les enregistre dans le cache pendant l’opération Select . Le cache est créé, ignoré ou actualisé en fonction du comportement de mise en cache spécifié par la combinaison des CacheDuration propriétés et CacheExpirationPolicy .

Si la DataSourceMode propriété a la valeur SqlDataSourceMode.DataSet et qu’une FilterExpression propriété a été spécifiée, l’expression de filtre est évaluée avec toutes les propriétés fournies FilterParameters et le filtre résultant est appliqué à la liste des données pendant l’opération Select .

La Select méthode délègue à la Select méthode de l’objet SqlDataSourceView associé au SqlDataSource contrôle . Pour effectuer une opération de récupération de données, génère un DbCommand objet à l’aide SqlDataSourceView du SelectCommand texte et des valeurs associéesSelectParameters, puis exécute sur DbCommand la base de données sous-jacente.

S’applique à

Voir aussi

• SelectCommand
• SelectParameters
• Contrôles serveur Web de sources de données
• Vue d’ensemble du contrôle serveur web SqlDataSource
• Vue d’ensemble du cycle de vie des pages ASP.NET