ASP.NET常用代码有哪些？ | ASP.NET开发高效技巧大全

ASP.NET 常用核心代码精粹

ASP.NET 作为成熟的 Web 开发框架，其核心代码库是开发者高效构建稳健应用的基石，掌握以下关键代码片段，能显著提升开发效率与应用质量：

数据访问基石 (ADO.NET Core)

• 安全连接与执行 (参数化防注入)：

  string connectionString = Configuration.GetConnectionString("DefaultConnection");
  using (SqlConnection connection = new SqlConnection(connectionString))
  {
      await connection.OpenAsync();
      string sql = "SELECT  FROM Products WHERE CategoryId = @CategoryId AND Price > @MinPrice";
      using (SqlCommand command = new SqlCommand(sql, connection))
      {
          // 参数化查询是防御 SQL 注入的关键
          command.Parameters.AddWithValue("@CategoryId", categoryId);
          command.Parameters.AddWithValue("@MinPrice", minPrice);
          using (SqlDataReader reader = await command.ExecuteReaderAsync())
          {
              while (await reader.ReadAsync())
              {
                  // 安全处理数据
                  var productName = reader["ProductName"].ToString();
                  // ... 
              }
          }
      }
  }

高效数据绑定实践

• Repeater 控件动态绑定：

  protected async void Page_Load(object sender, EventArgs e)
  {
      if (!IsPostBack)
      {
          var products = await ProductService.GetFeaturedProductsAsync(); // 假设的异步服务方法
          ProductRepeater.DataSource = products;
          ProductRepeater.DataBind(); // 触发绑定
      }
  }

  <asp:Repeater ID="ProductRepeater" runat="server">
      <ItemTemplate>
          <div class="product-item">
              <h3><%# Eval("Name") %></h3>
              <p>Price: <%# Eval("Price", "{0:C}") %></p>
          </div>
      </ItemTemplate>
  </asp:Repeater>

身份认证与授权保障

• Cookie 基础认证配置 (Startup.cs):

  services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)
      .AddCookie(options =>
      {
          options.LoginPath = "/Account/Login"; // 未授权时重定向路径
          options.AccessDeniedPath = "/Account/AccessDenied"; // 无权限访问路径
          options.ExpireTimeSpan = TimeSpan.FromMinutes(30); // Cookie 有效期
          options.SlidingExpiration = true; // 滑动过期
      });
  services.AddAuthorization(options =>
  {
      options.AddPolicy("RequireAdminRole", policy => 
          policy.RequireRole("Administrator")); // 基于角色的策略
      options.AddPolicy("MinimumAge18", policy => 
          policy.RequireClaim("Age", "18")); // 基于声明的策略
  });

• 控制器/方法级授权：

  [Authorize] // 整个控制器需要登录
  public class AdminController : Controller
  {
      [Authorize(Policy = "RequireAdminRole")] // 特定方法需要管理员角色
      public IActionResult ManageUsers() { ... }
  }

异常处理与全局日志

• 全局异常捕获 (Startup.cs – Configure):

  

  app.UseExceptionHandler(errorApp =>
  {
      errorApp.Run(async context =>
      {
          context.Response.StatusCode = 500;
          context.Response.ContentType = "text/html";
          var exceptionHandlerPathFeature = context.Features.Get<IExceptionHandlerPathFeature>();
          var exception = exceptionHandlerPathFeature?.Error;
          // 关键：记录到日志系统 (如 Serilog, NLog)
          logger.LogError(exception, "全局捕获的未处理异常. Path: {Path}", context.Request.Path);
          await context.Response.WriteAsync("<h1>服务器内部错误</h1><p>已记录，工程师将尽快处理。</p>");
      });
  });

状态管理策略

• 会话状态存储用户数据：

  // 设置会话值 (需先启用 Session 中间件)
  HttpContext.Session.SetString("UserName", user.Username);
  HttpContext.Session.SetInt32("CartItemCount", cart.Items.Count);
  // 获取会话值
  string username = HttpContext.Session.GetString("UserName");
  int? cartCount = HttpContext.Session.GetInt32("CartItemCount");

• 临时数据跨请求传递：

  // Controller Action 1 (设置)
  TempData["SuccessMessage"] = "订单提交成功！";
  return RedirectToAction("Confirmation");
  // Controller Action 2 (获取)
  public IActionResult Confirmation()
  {
      if (TempData["SuccessMessage"] is string message)
      {
          ViewBag.Message = message;
      }
      return View();
  }

性能优化关键点

• 输出缓存提升响应：

  [OutputCache(Duration = 60, VaryByParam = "id")] // 缓存60秒，根据id参数区分
  public IActionResult ProductDetail(int id)
  {
      var product = _productRepository.GetById(id);
      return View(product);
  }

• 内存缓存高频数据：

  public IActionResult Index()
  {
      const string cacheKey = "PopularProducts";
      if (!_memoryCache.TryGetValue(cacheKey, out List<Product> products))
      {
          products = _productService.GetPopularProducts(); // 耗时操作
          var cacheOptions = new MemoryCacheEntryOptions()
              .SetSlidingExpiration(TimeSpan.FromMinutes(10)); // 滑动过期10分钟
          _memoryCache.Set(cacheKey, products, cacheOptions);
      }
      return View(products);
  }

安全加固代码

• XSS 防御 (Razor 视图自动编码)：

  <!-- Razor 默认对输出进行 HTML 编码 -->
  <p>用户输入: @Model.UserInput</p> <!-- 安全 -->
  <!-- 如需输出原始 HTML (信任来源)，谨慎使用 `Html.Raw` -->
  <p>信任的HTML内容: @Html.Raw(Model.SanitizedHtmlContent)</p>

• CSRF 防护：

  

  // 在 Form 中自动生成防伪令牌 (View)
  <form asp-action="UpdateProfile" method="post">
      @Html.AntiForgeryToken() 
      <!-- ... 表单字段 ... -->
  </form>
  // 在 Action 上验证令牌 (Controller)
  [HttpPost]
  [ValidateAntiForgeryToken] // 关键特性
  public IActionResult UpdateProfile(ProfileModel model)
  {
      if (ModelState.IsValid)
      {
          // ... 更新逻辑 ...
      }
      return View(model);
  }

文件操作规范

• 安全文件上传与验证：

  [HttpPost]
  public async Task<IActionResult> Upload(IFormFile file)
  {
      if (file == null || file.Length == 0)
      {
          ModelState.AddModelError("", "请选择有效文件");
          return View();
      }
      // 验证扩展名 (白名单更安全)
      var allowedExtensions = new[] { ".jpg", ".png", ".gif" };
      var fileExtension = Path.GetExtension(file.FileName).ToLowerInvariant();
      if (string.IsNullOrEmpty(fileExtension) || !allowedExtensions.Contains(fileExtension))
      {
          ModelState.AddModelError("", "仅支持 JPG, PNG, GIF 格式");
          return View();
      }
      // 验证 MIME 类型 (可选额外层)
      // if (!file.ContentType.StartsWith("image/")) ... 
      // 设置安全存储路径 (避免用户指定路径)
      var uploadsFolder = Path.Combine(_hostingEnvironment.WebRootPath, "uploads");
      var uniqueFileName = Guid.NewGuid().ToString() + fileExtension;
      var filePath = Path.Combine(uploadsFolder, uniqueFileName);
      using (var stream = new FileStream(filePath, FileMode.Create))
      {
          await file.CopyToAsync(stream); // 异步保存
      }
      // ... 保存文件信息到数据库等后续操作 ...
      return RedirectToAction("Success");
  }

这些代码段构成了 ASP.NET 应用开发的核心骨架，熟练运用它们能解决绝大多数业务场景，但切记：

1. 安全第一： 始终优先考虑参数化查询、输入验证、输出编码、CSRF/XSS 防护。
2. 性能意识： 合理使用缓存、异步编程,优化数据库交互。
3. 可维护性： 遵循 SOLID 原则，将数据访问、业务逻辑清晰分层。
4. 异步优先： 在 I/O 密集型操作（数据库、文件、网络调用）中拥抱 async/await。

你正在开发中遇到的哪些 ASP.NET 具体挑战，希望看到更深入的代码解决方案？ （欢迎在评论区分享你的实战场景！）