LinqDataSourceSelectEventArgs.WhereParameters Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém a coleção de parâmetros que é usada para criar a cláusula de 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 de Propriedade
Um objeto que contém os parâmetros para a cláusula Where.
Exemplos
O exemplo seguinte mostra como adicionar um parâmetro à WhereParameters coleção. O parâmetro adicional limitará os produtos devolvidos apenas àqueles com valor de "Bicicleta" na Name propriedade. A AutoGenerateWhereClause propriedade é definida para true que o parâmetro seja automaticamente incluído 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>
Observações
Usas a WhereParameters propriedade para aceder aos parâmetros da cláusula Where num handler para o Selecting evento. Pode modificar a cláusula Where adicionando ou removendo parâmetros desta coleção. Por defeito, a WhereParameters propriedade do LinqDataSourceSelectEventArgs objeto contém quaisquer parâmetros que adicionaste ao WhereParametersLinqDataSource controlo.
Quando adiciona parâmetros através da coleção do LinqDataSourceSelectEventArgs objeto, deve incluir um marcador de lugar para o parâmetro na Where propriedade ou definir a AutoGenerateWhereClause propriedade para true.WhereParameters Por exemplo, se adicionar um parâmetro nomeado ProductName no handler de eventos do Selecting evento, deve definir a AutoGenerateWhereClause propriedade como true ou definir a Where propriedade para ProductName=@ProductName.