有关AutoCompleteBox组件的研究[3]_FilterMode和ItemFilter——Silverlight学习笔记[38]-优快云博客

本文介绍如何为AutoCompleteBox组件设置不同过滤模式(FilterMode)，包括起始匹配、包含匹配及完全匹配等，并演示了如何实现自定义过滤规则。

对于AutoCompleteBox组件而言，设置合理的过滤模式有利于对数据的精确筛选。本文将为大家介绍如何为该组件设置不同的过滤模式(FilterMode)以及设置自定义项过滤(ItemFilter)。

※ 过滤模式

AutoCompleteBox组件的默认过滤模式是起始匹配同时非字母大小写敏感。但有时我们需要使用到其他的过滤模式。下表列出了AutoCompleteBox组件FilterMode的可选值。

FilterMode的可选值

说明

None

指定不使用筛选器。将返回所有项。

StartsWith

指定区分区域性但不区分大小写的筛选器，其中返回的项以指定的文本开头。该筛选器使用 String.StartsWith 方法，并且将 StringComparer.CurrentCultureIgnoreCase 指定为字符串比较条件。

StartsWithCaseSensitive

指定区分区域性且区分大小写的筛选器，其中返回的项以指定的文本开头。该筛选器使用 String. StartsWith 方法，并且将 StringComparer. CurrentCulture 指定为字符串比较条件。

StartsWithOrdinal

指定带序号的不区分大小写的筛选器，其中返回的项以指定的文本开头。该筛选器使用 String.StartsWith 方法，并且将 StringComparer.OrdinalIgnoreCase 指定为字符串比较条件。

StartsWithOrdinalCaseSensitive

指定带序号的区分大小写的筛选器，其中返回的项以指定的文本开头。该筛选器使用 String.tartsWith 方法，并且将 StringComparer.Ordinal 指定为字符串比较条件。

Contains

指定区分区域性但不区分大小写的筛选器，其中返回的项包含指定的文本。

ContainsCaseSensitive

指定区分区域性且区分大小写的筛选器，其中返回的项包含指定的文本。

ContainsOrdinal

指定带序号的不区分大小写的筛选器，其中返回的项包含指定的文本。

ContainsOrdinalCaseSensitive

指定带序号的区分大小写的筛选器，其中返回的项包含指定的文本。

Equals

指定区分区域性但不区分大小写的筛选器，其中返回的项等于指定的文本。该筛选器使用 String.Equals 方法，且将StringComparer. CurrentCultureIgnoreCase 指定为搜索比较条件。

EqualsCaseSensitive

指定区分区域性且区分大小写的筛选器，其中返回的项等于指定的文本。该筛选器使用 String.Equals 方法，并且将 StringComparer.CurrentCulture 指定为字符串比较条件。

EqualsOrdinal

指定带序号的不区分大小写的筛选器，其中返回的项等于指定的文本。该筛选器使用 String.Equals 方法，并且将 StringComparer.OrdinalIgnoreCase 指定为字符串比较条件。

EqualsOrdinalCaseSensitive

指定带序号的区分大小写的筛选器，其中返回的项等于指定的文本。该筛选器使用 String.Equals 方法，并且将 StringComparer.Ordinal 指定为字符串比较条件。

Custom

指定使用自定义筛选器。在设置了 AutoCompleteBox.TextFilter 或 AutoCompleteBox.ItemFilter 属性时使用此模式。

引自：MSDN AutoCompleteFilterMode 枚举

※ 项过滤

有时候我们需要自定义过滤规则时，就将FilterMode设为Custom。此时，即可通过设置AutoCompleteBox的ItemFilter属性来设置自定义过滤。

实例：

详细的说明在代码注释中给出。

MainPage.xaml文件代码：

<UserControl

xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

xmlns:d="http://schemas.microsoft.com/expression/blend/2008" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"

mc:Ignorable="d" xmlns:input="clr-namespace:System.Windows.Controls;assembly=System.Windows.Controls.Input" x:Class="SilverlightClient.MainPage"

d:DesignWidth="320" d:DesignHeight="240">

<input:AutoCompleteBox x:Name="acb" Height="23" Margin="8,43,148,0" VerticalAlignment="Top"/>

</Grid>

</UserControl>

MainPage.xaml.cs文件代码：

using System;

using System.Collections.Generic;

using System.Linq;

using System.Net;

using System.Windows;

using System.Windows.Controls;

using System.Windows.Documents;

using System.Windows.Input;

using System.Windows.Media;

using System.Windows.Media.Animation;

using System.Windows.Shapes;

namespace SilverlightClient

{

//业务辅助类

public class FilterModeHelper

{

public string FilterModeName { get; set; }

public AutoCompleteFilterMode theFilterMode { get; set; }

}

public partial class MainPage : UserControl

{

public MainPage()

{

InitializeComponent();

this.Loaded += new RoutedEventHandler(MainPage_Loaded);

this.cbFilterMode.SelectionChanged +=

new SelectionChangedEventHandler(cbFilterMode_SelectionChanged);

}

void cbFilterMode_SelectionChanged(object sender, SelectionChangedEventArgs e)

{

if (cbFilterMode.SelectedItem != null)

{

FilterModeHelper fmh = cbFilterMode.SelectedItem as FilterModeHelper;

if (fmh.FilterModeName == "Custom")

{

acb.FilterMode = fmh.theFilterMode;

acb.ItemFilter = (search, item) =>

{

string employeename = item as string;

if (employeename != null)

{

string filter = search.ToLower();

//包含filter和字符n的EmployeeName返回true

return employeename.ToLower().Contains(filter) ||

employeename.ToLower().Contains("n");

}

return false;

};

}

else

{

acb.FilterMode = fmh.theFilterMode;

acb.ItemFilter = null;

}

void MainPage_Loaded(object sender, RoutedEventArgs e)

{

//为cbFilterMode提供数据源

cbFilterMode.ItemsSource = GetFilter();

cbFilterMode.DisplayMemberPath = "FilterModeName";

//为AutoCompleteBox提供数据源

acb.ItemsSource = GetEmployeeName();

}

//cbFilterMode的数据源

List<FilterModeHelper> GetFilter()

{

List<FilterModeHelper> returnedValue = new List<FilterModeHelper>();

returnedValue.Add(new FilterModeHelper() { FilterModeName = "None", theFilterMode = AutoCompleteFilterMode.None });

returnedValue.Add(new FilterModeHelper() { FilterModeName = "StartsWith", theFilterMode = AutoCompleteFilterMode.StartsWith });

returnedValue.Add(new FilterModeHelper() { FilterModeName = "StartsWithCaseSensitive", theFilterMode = AutoCompleteFilterMode.StartsWithCaseSensitive });

returnedValue.Add(new FilterModeHelper() { FilterModeName = "StartsWithOrdinal", theFilterMode = AutoCompleteFilterMode.StartsWithOrdinal });

returnedValue.Add(new FilterModeHelper() { FilterModeName = "StartsWithOrdinalCaseSensitive", theFilterMode = AutoCompleteFilterMode.StartsWithOrdinalCaseSensitive });

returnedValue.Add(new FilterModeHelper() { FilterModeName = "Contains", theFilterMode = AutoCompleteFilterMode.Contains });

returnedValue.Add(new FilterModeHelper() { FilterModeName = "ContainsCaseSensitive", theFilterMode = AutoCompleteFilterMode.ContainsCaseSensitive });

returnedValue.Add(new FilterModeHelper() { FilterModeName = "ContainsOrdinal", theFilterMode = AutoCompleteFilterMode.ContainsOrdinal });

returnedValue.Add(new FilterModeHelper() { FilterModeName = "ContainsOrdinalCaseSensitive", theFilterMode = AutoCompleteFilterMode.ContainsOrdinalCaseSensitive });

returnedValue.Add(new FilterModeHelper() { FilterModeName = "Equals", theFilterMode = AutoCompleteFilterMode.Equals });

returnedValue.Add(new FilterModeHelper() { FilterModeName = "EqualsCaseSensitive", theFilterMode = AutoCompleteFilterMode.EqualsCaseSensitive });

returnedValue.Add(new FilterModeHelper() { FilterModeName = "EqualsOrdinal", theFilterMode = AutoCompleteFilterMode.EqualsOrdinal });

returnedValue.Add(new FilterModeHelper() { FilterModeName = "EqualsOrdinalCaseSensitive", theFilterMode = AutoCompleteFilterMode.EqualsOrdinalCaseSensitive });

returnedValue.Add(new FilterModeHelper() { FilterModeName = "Custom", theFilterMode = AutoCompleteFilterMode.Custom });

return returnedValue;

}

//AutoCompleteBox的数据源

List<string> GetEmployeeName()

{

List<string> returnedValue = new List<string>();

returnedValue.Add("Alice");

returnedValue.Add("Allen");

returnedValue.Add("Benedict");

returnedValue.Add("Bill");

returnedValue.Add("Black");