ASPxGridHeaderFilterEventArgs.AddValue(String, String) Method

Adds a new filter item to the header filter.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v23.2.dll

NuGet Package: DevExpress.Web

Declaration

C#

public void AddValue(
    string displayText,
    string value
)

VB.NET

Public Sub AddValue(
    displayText As String,
    value As String
)

Parameters

Name	Type	Description
displayText	String	A String value that specifies the filter item’s display text.
value	String	A String value that specifies the filter item’s value.

Remarks

This method uses the equality operator to compare values. To provide your own filter criteria, use the AddValue method’s overload with the query parameter.

Note that the grid header filter allows the use of HTML tags in the displayText parameter.

Example

This example creates custom filter items and displays them within the Units On Order column’s filter dropdown.

C#

protected void ASPxGridView1_HeaderFilterFillItems(object sender, DevExpress.Web.ASPxGridViewHeaderFilterEventArgs e) {
        if (e.Column.FieldName != "Quantity") return;
        e.AddValue("nonzero", string.Empty, "[Quantity] != 0");
        e.AddValue(String.Format("from {0} to {1}", 0, 50), string.Empty, String.Format("[Quantity] > {0} and [Quantity] < {1}", 0, 50));
        e.AddValue(String.Format(">= {0}", 50), string.Empty, String.Format("[Quantity] >= {0}", 50));
}

VB.NET

Protected Sub ASPxGridView1_HeaderFilterFillItems(ByVal sender As Object, ByVal e As DevExpress.Web.ASPxGridViewHeaderFilterEventArgs)
    If e.Column.FieldName <> "Quantity" Then Return
    e.AddValue("nonzero", String.Empty, "[Quantity] != 0")
    e.AddValue(String.Format("from {0} to {1}", 0, 50), String.Empty, String.Format("[Quantity] > {0} and [Quantity] < {1}", 0, 50))
    e.AddValue(String.Format(">= {0}", 50), String.Empty, String.Format("[Quantity] >= {0}", 50))
End Sub