当前位置：首页 > 技术教程 > 正文

ASP.NET中如何通过存储过程实现模糊查询？附详细示例分享

admin
技术教程
2026-01-11
4147

在ASP.NET Web开发中，模糊查询（Fuzzy Query）是处理用户动态搜索需求的核心场景之一，例如在电商平台搜索“智能手机”相关商品、博客系统中检索标题包含“ASP.NET”的文章等，传统方式多通过LINQ to SQL或Entity Framework动态构建SQL语句实现模糊查询，但这种方式存在性能瓶颈（如SQL载入风险、查询计划重编译等问题），而利用存储过程（Stored Procedure）实现模糊查询，能显著提升查询性能、降低网络开销，且便于维护，本文将详细介绍如何在ASP.NET中利用存储过程实现模糊查询，并通过实际案例结合西西云云产品，提供可落地的解决方案。

基础概念：存储过程与模糊查询原理

存储过程（Stored Procedure） 是一组预编译的SQL语句集合，存储在数据库中，可通过应用程序调用执行，其核心优势包括：

性能提升：存储过程在首次执行时会被编译成执行计划，后续调用直接使用该计划，减少SQL解析和编译开销；
代码复用：将复杂逻辑封装在存储过程中，避免重复编写SQL语句；
安全性：通过参数化传递输入数据，有效防止SQL载入攻破；
事务控制：可在一个存储过程中执行多个SQL语句，并统一管理事务。

模糊查询通常通过SQL的LIKE运算符实现，其语法格式为WHERE 列名 LIKE '%搜索词%'，其中是通配符，表示任意长度（包括0）的字符序列，查询产品名称包含“手机”的商品，SQL语句为WHERE ProductName LIKE '%手机%'。

环境准备：数据库与ASP.NET项目搭建

1 数据库表结构设计

为演示模糊查询,我们设计一个简单的Products表，包含产品信息：

CREATE TABLE [dbo].[Products]( [ProductID] [int] IDENTITY(1,1) NOT NULL, [ProductName] [nvarchar](100) NOT NULL, [Description] [nvarchar](500) NULL, [Category] [nvarchar](50) NULL, [Price] [decimal](18, 2) NOT NULL );

插入少量测试数据：

INSERT INTO dbo.Products (ProductName, Description, Category, Price) VALUES ('iPhone 15 Pro', '苹果最新旗舰手机', '电子产品', 8999.00), ('华为Mate 60 Pro', '国产5G手机', '电子产品', 6999.00), ('小米Civi 4', '年轻群体手机', '电子产品', 2999.00), ('机械键盘', '游戏机械键盘', '电脑配件', 399.00);

2 ASP.NET MVC项目结构

使用Visual Studio创建ASP.NET Core Web应用程序（MVC模板），项目结构包括：

ASP.NET中如何通过存储过程实现模糊查询？附详细示例分享第1张

Models：定义数据模型（如Product.cs）；
Controllers：实现业务逻辑（如ProductsController.cs）；
Views：呈现数据（如Search.cshtml视图）；
appsettings.json：配置数据库连接字符串。

创建存储过程实现模糊查询

存储过程需在数据库中创建,并接受参数控制查询逻辑，以下是实现模糊查询的存储过程代码：

CREATE PROCEDURE [dbo].[GetProductsByProductName] @ProductName nvarchar(100) = NULL AS BEGIN SET NOCOUNT ON; -- 避免返回行计数 IF @ProductName IS NULL -- 全选所有产品 SELECT ProductID, ProductName, Description, Category, Price FROM dbo.Products ELSE -- 模糊匹配产品名称 SELECT ProductID, ProductName, Description, Category, Price FROM dbo.Products WHERE ProductName LIKE '%' + @ProductName + '%'; END

参数说明：

@ProductName：搜索关键词，可空（默认为NULL），若为空则返回所有产品，否则按名称模糊匹配；
SET NOCOUNT ON：防止存储过程返回行计数，提升性能；
LIKE '%' + @ProductName + '%'：实现模糊匹配，通配符匹配任意字符序列。

在ASP.NET中调用存储过程

1 Model层：定义数据模型

在Models/Product.cs中定义产品类：

public class Product { public int ProductID { get; set; } public string ProductName { get; set; } public string Description { get; set; } public string Category { get; set; } public decimal Price { get; set; } }

2 Controller层：实现搜索功能

在Controllers/ProductsController.cs中创建搜索方法：

ASP.NET中如何通过存储过程实现模糊查询？附详细示例分享第2张

关键点：

使用CommandType.StoredProcedure指定调用存储过程；
通过Parameters.AddWithValue传递参数，确保参数化查询，防止SQL载入；
使用DBNull.Value处理空参数情况，避免存储过程中@ProductName为NULL时引发错误。

3 视图层：呈现搜索结果

在Views/Products/Search.cshtml中展示结果：

@model List<Models.Product> @{ ViewData["Title"] = "产品搜索结果"; } <h2>产品搜索结果</h2> <p>搜索词：@ViewBag.SearchTerm</p> <table class="table"> <thead> <tr> <th>产品ID</th> <th>产品名称</th> <th>描述</th> <th>类别</th> <th>价格</th> </tr> </thead> <tbody> @foreach (var product in Model) { <tr> <td>@product.ProductID</td> <td>@product.ProductName</td> <td>@product.Description</td> <td>@product.Category</td> <td>@product.Price.ToString("C")</td> </tr> } </tbody> </table>

性能优化与最佳实践

1 参数化查询与SQL载入防护

存储过程的参数化机制是防止SQL载入的关键,若直接拼接SQL字符串（如WHERE ProductName = '" + productName + "'"），则可能导致载入攻破，存储过程的参数化传递（如上述示例）可确保输入数据被正确转义。

2 索引优化

模糊查询的LIKE '%keyword%'（前缀为）无法使用索引（因为索引不匹配），但可通过调整查询逻辑优化，将LIKE '%keyword%'改为LIKE 'keyword%'（前缀匹配），可利用索引提升性能，SQL Server 2019及以上版本支持全文索引（Full-Text Index），可对文本字段（如ProductName）建立全文索引，显著提升模糊查询性能。

3 限制结果集与分页

对于大型数据集,模糊查询结果可能包含大量数据，影响页面加载速度，可通过TOP N或分页技术限制结果数量，存储过程中添加分页逻辑：

ASP.NET中如何通过存储过程实现模糊查询？附详细示例分享第3张

CREATE PROCEDURE [dbo].[GetProductsByProductName] @ProductName nvarchar(100) = NULL, @PageSize int = 10, @PageNumber int = 1 AS BEGIN SET NOCOUNT ON; IF @ProductName IS NULL SELECT TOP (@PageSize) * FROM dbo.Products ORDER BY ProductName ELSE SELECT TOP (@PageSize) * FROM dbo.Products WHERE ProductName LIKE '%' + @ProductName + '%' ORDER BY ProductName END

在ASP.NET中调用时，通过@PageSize和@PageNumber参数实现分页。

西西云经验案例：云环境下存储过程的高效部署

西西云（Qufan Cloud）作为国内领先的云服务提供商，其云数据库服务（如SQL Server云实例）支持存储过程的快速部署与调优，某电商平台客户通过以下方案实现高并发模糊查询：

云数据库部署：将SQL Server数据库部署在西西云云数据库服务中，利用云的弹性资源应对流量峰值；
存储过程优化：结合全文索引，提升模糊查询性能（SQL Server 2019支持全文索引，西西云提供全文索引创建工具）；
读写分离：配置主从复制，将查询请求分发到从库，减轻主库压力；
缓存层：利用西西云Redis缓存热门搜索结果（如“手机”），减少数据库查询次数。

案例效果：该电商平台日活50万，通过上述方案将搜索响应时间从500ms降低至100ms以下，同时数据库资源利用率提升30%。

深度问答（FAQs）

如何处理存储过程中参数的默认值？

解答：存储过程中可通过参数的默认值（如@ProductName nvarchar(100) = NULL）实现默认逻辑，在ASP.NET调用时，若参数为空（如Search(productName: null)），直接传递null，存储过程会自动使用默认值。

[HttpGet] public IActionResult Search(string productName) { // productName可能为null string connectionString = Configuration["ConnectionStrings:DefaultConnection"]; // ... 其他代码 }