LinqDataSourceSelectEventArgs.WhereParameters Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém a coleção de parâmetros usados para criar a cláusula Where.
public:
property System::Collections::Generic::IDictionary<System::String ^, System::Object ^> ^ WhereParameters { System::Collections::Generic::IDictionary<System::String ^, System::Object ^> ^ get(); };
public System.Collections.Generic.IDictionary<string,object> WhereParameters { get; }
member this.WhereParameters : System.Collections.Generic.IDictionary<string, obj>
Public ReadOnly Property WhereParameters As IDictionary(Of String, Object)
Valor da propriedade
Um objeto que contém os parâmetros da cláusula Where.
Exemplos
O exemplo a seguir mostra como adicionar um parâmetro à WhereParameters coleção. O parâmetro adicionado limitará os produtos retornados apenas aos produtos com um valor "Bike" na Name
propriedade . A AutoGenerateWhereClause propriedade é definida como para true
que o parâmetro seja incluído automaticamente na cláusula Where.
<script runat="server">
protected void LinqDataSource_Selecting(object sender, LinqDataSourceSelectEventArgs e)
{
e.WhereParameters.Add("Name", "Bike");
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>Example Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:LinqDataSource
ContextTypeName="ExampleDataContext"
TableName="Products"
AutoGenerateWhereClause="true"
OnSelecting="LinqDataSource_Selecting"
ID="LinqDataSource1"
runat="server">
</asp:LinqDataSource>
<asp:GridView
DataSourceID="LinqDataSource1"
ID="GridView1"
runat="server">
</asp:GridView>
</div>
</form>
</body>
</html>
<script runat="server">
Protected Sub LinqDataSource_Selecting(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceSelectEventArgs)
e.WhereParameters.Add("Name", "Bike")
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
<title>Example Page</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:LinqDataSource
ContextTypeName="ExampleDataContext"
TableName="Products"
AutoGenerateWhereClause="true"
OnSelecting="LinqDataSource_Selecting"
ID="LinqDataSource1"
runat="server">
</asp:LinqDataSource>
<asp:GridView
DataSourceID="LinqDataSource1"
ID="GridView1"
runat="server">
</asp:GridView>
</div>
</form>
</body>
</html>
Comentários
Você usa a WhereParameters propriedade para acessar parâmetros para a cláusula Where em um manipulador para o Selecting evento. Você pode modificar a cláusula Where adicionando ou removendo parâmetros dessa coleção. Por padrão, a WhereParameters propriedade do LinqDataSourceSelectEventArgs objeto contém todos os parâmetros que você adicionou ao WhereParameters do LinqDataSource controle.
Ao adicionar parâmetros por meio da WhereParameters coleção do LinqDataSourceSelectEventArgs objeto , você deve incluir um espaço reservado para o parâmetro na Where propriedade ou definir a AutoGenerateWhereClause propriedade como true
. Por exemplo, se você adicionar um parâmetro chamado ProductName
no manipulador de eventos para o Selecting evento, deverá definir a AutoGenerateWhereClause propriedade como true
ou definir a Where propriedade como ProductName=@ProductName
.