示例查询最多的应用场合是组合查询，我们常常需要在界面上提供若干的查询选项，然后根据用户的输入返回符合条件的结果。
使用代码直接进行处理往往需要涉及到复杂的条件，由于组合条件并不确定，导致逻辑判断语句结构复杂。对于多个可选的参数，情况会变得更加严重。
使用示例查询可以很方便地处理这种问题。
在查询的时候，将收集到的查询条件赋予一个对象的属性，当然，这个对象的类型就是需要查询的实体对象。
例如，在 NHibernate 中存在一个 User 的类型，我们需要对它的姓名和口令进行组合查询，User 的定义如下：
namespace Demo.Dao.Domain
{
// 用户对象
public class User
{
public virtual int UserId { set; get; }
public virtual string Username { set; get; }
public virtual string Password { set; get; }
public virtual Address Address { set; get; }
}
}
在界面中，我们提供用户输入的输入框。
<p>
<label for="<%= this.tbxName %>">
用户名：</label>
<asp:TextBox ID="tbxName" runat="server"></asp:TextBox>
</p>
<p>
<label for="<%= this.tbxPassword %>">
口令：</label>
<asp:TextBox ID="tbxPassword" runat="server"></asp:TextBox>
</p>
<p>
<asp:Button ID="btnSearch" runat="server" Text="查询" OnClick="btnSearch_Click"/>
</p>
在按钮的点击事件中，我们将用户的输入组合为一个示例对象。然后提交给 NHibernate 进行查询。
protected void btnSearch_Click(object sender, EventArgs e)
{
if (this.IsValid)
{
Demo.Dao.Domain.User example
= new Demo.Dao.Domain.User()
{
Username = this.tbxName.Text,
Password = this.tbxPassword.Text
};
IList<Demo.Dao.Domain.User> list = this.UserService.GetUsers(example);
this.Repeater1.DataSource = list;
this.Repeater1.DataBind();
}
}
在后台的服务中，我们使用示例查询进行处理。
示例查询类型定义在命名空间 NHibernate.Criterion 中，使用静态方法 Create 可以创建示例对象。
首先创建一个查询条件对象，然后使用 Example 的 Create 方法创建出查询示例对象。最后就是实际的查询。
public IList<Demo.Dao.Domain.User> GetUsers( Demo.Dao.Domain.User exampleUser)
{
// 创建查询标准
global::NHibernate.ICriteria criteria
= this.Session.CreateCriteria<Demo.Dao.Domain.User>();
// 创建查询示例
global::NHibernate.Criterion.Example example
= global::NHibernate.Criterion.Example.Create(exampleUser);
// 设置使用示例对象的查询条件
criteria.Add(example);
example.EnableLike(global::NHibernate.Criterion.MatchMode.Anywhere);
IList< Demo.Dao.Domain.User> list = criteria.List<Demo.Dao.Domain.User>();
return list;
}
对于字符串类型的条件来说，默认使用精确匹配，但是，可以通过示例的 EnableLike 进行设置。NHibernate.Criterion.MatchMode 是一个枚举，支持下面的匹配模式。
// 默认字符串是完全匹配，可以通过 EnableLike 进行设置
// Anywhere 表示任何位置匹配
// End 出现在最后位置
// Start 出现在起始位置
// Exact 完全匹配，默认设置
example.EnableLike(global::NHibernate.Criterion.MatchMode.Anywhere);
当在姓名的输入框中输入 a 的时候，NHibernate 生成的 SQL 语句如下：
SELECT this_.UserId as UserId0_0_, this_.Username as Username0_0_, this_.Password as Password0_0_, this_.AddressId as AddressId0_0_
FROM tbl_Users this_
WHERE (this_.Username like @p0)
除了强大的 EnableLike 之外，还提供了几个设置参数，比较常用的有 ExcludeZeroes() 方法，它可以排除属性中值为 0 的属性。
比如，在 User 中增加一个 Age 的整数类型属性，还导致查询语句变成下面的 SQL
SELECT this_.UserId as UserId0_0_, this_.Username as Username0_0_, this_.Password as Password0_0_,
this_.Age as Age0_0_, this_.AddressId as AddressId0_0_
FROM tbl_Users this_
WHERE (this_.Username like @p0 and this_.Age = @p1)
使用排除 0 的设置
// 排除值为 0 的属性
example.ExcludeZeroes();
现在的 SQL 又成为
SELECT this_.UserId as UserId0_0_, this_.Username as Username0_0_, this_.Password as Password0_0_,
this_.Age as Age0_0_, this_.AddressId as AddressId0_0_
FROM tbl_Users this_
WHERE (this_.Username like @p0)
不过，还有两个设置就要小心了。
ExcludeNulls() 方法，看起来是排除值为 null 的属性，不过，代码中是先调用了 ToString() 方法，然后再看字符串的长度，所以会使得前面的 ExcludeZeroes() 失效。
SELECT this_.UserId as UserId0_0_, this_.Username as Username0_0_, this_.Password as Password0_0_,
this_.Age as Age0_0_, this_.AddressId as AddressId0_0_
FROM tbl_Users this_
WHERE (this_.Username like @p0 and this_.Age = @p1)
ExcludeNone() 方法，表示需要使用示例对象的所有属性，也会使得 ExcludeZeroes() 失效。
SELECT this_.UserId as UserId0_0_, this_.Username as Username0_0_, this_.Password as Password0_0_,
this_.Age as Age0_0_, this_.AddressId as AddressId0_0_
FROM tbl_Users this_
WHERE (this_.Username like @p0 and this_.Password is null and this_.Age = @p1)
最后，还有一个 IgnoreCase() 方法， 使用不区分大小写的方法比较字符串，对于 Oracle 是有效的，对于 SQL Server 就用不到了。
SELECT this_.UserId as UserId0_0_, this_.Username as Username0_0_, this_.Password as Password0_0_,
this_.Age as Age0_0_, this_.AddressId as AddressId0_0_
FROM tbl_Users this_
WHERE (lower(this_.Username) like lower(@p0) and this_.Age = @p1)