C#自定义字符串操作增强类 StringPlus 实现与解析

沿途有光

发布时间：2026-10-14| 3人浏览过

原创

本文详细介绍了一款专为解决 C# 开发中繁琐字符串处理问题而设计的自定义工具类 StringPlus。该类将日常开发中常用的字符串拆分、格式化、转换及安全校验功能进行了高度封装，提供了一系列静态方法供直接调用，能够有效简化数据处理流程并提升代码整洁度。

设计目标与核心功能

StringPlus 旨在为 .NET 开发者提供一个轻量级且全面的字符串操作库。它覆盖了从基础的数据类型转换到复杂的多正则表达式分割等一系列场景。通过将常见的逻辑内聚于一个静态类中，不仅避免了在项目各处重复实现相同的辅助函数，还为数据的规范化输出和安全性校验提供了统一的标准。

其核心功能模块主要包括：

集合转换：实现字符串与数组（Array）、泛型列表（List<string>）之间的相互转换。
格式控制：支持将英文符号转换为中文标点的全角/半角互换，以及清理或重组字符串样式。
高级分割：除了基础的单字符分割，还集成了基于正则表达式的多模式分割功能。
数据清洗与安全：提供自动去除末尾特定字符的方法，以及针对 SQL 注入风险的基础字符转义。

关键操作详解

第 1 步：配置依赖与引入命名空间

由于 StringPlus 深度依赖于基础数据结构与正则引擎，在使用前请确保项目中已正确引入以下核心命名空间：

using System;
using System.Collections.Generic;
using System.Text;
using System.Text.RegularExpressions;

随后，在你的业务代码中导入 DotNet.Utilities 命名空间即可开始使用。注意：如果你使用的解决方案采用了不同的顶层命名规范，请将代码中的 namespace DotNet.Utilities 修改为你实际项目的对应命名空间。

第 2 步：实施字符串与集合的高频互转

在数据处理过程中，经常需要在逗号分隔的字符串和列表对象之间切换。此类提供了以下两种主要的转化方式：

1. 将字符串拆分为 List 或 Array：
使用 GetStrArray(string str, char speater, bool toLower) 可以根据指定的分隔符进行切分。若设置 toLower 为 true，还会自动将结果统一转为小写；该方法具备对空字符串的过滤能力。此外，还有重载方法 GetStrArray(string str) 专门用于默认以逗号 , 作为分隔符的快速切割。

2. 将集合组装为逗号分隔字符串：
当需要将多个值拼接回一个长字符串时，可以使用 GetArrayStr(List<int> list) 或带指定分隔符参数的 GetArrayStr(List<string> list, string speater)。系统底层采用 StringBuilder 构建，保证了大规模数据连接时的性能优势。

第 3 步：执行特殊字符转换与样式重构

针对部分涉及本地化显示或对输入格式有严格要求的场景，可调用对应的格式处理函数：

全角/半角转换：ToSBC() 将 ASCII 范围内的字符映射为全角形式（如空格变为），常用于数据库录入前的标准化；ToDBC() 则执行逆向还原操作。
移除尾部冗余：在处理由列表生成的字符串时，往往会遗留多余的尾随分隔符。DelLastComma() 能够快速定位并切除最后一个逗号，无需再手动判断索引边界。
动态样式重组：GetNewStyle() 接受一段原始文本和一个带有占位分隔符的“新样式模板”，能够智能地将原始文本根据模板中的位置进行重新排版并插入分隔符，极大地简化了前端报表或复杂标签的生成逻辑。

第 4 步：利用正则进行安全校验与多分割点处理

在进行 Web 应用或数据安全处理时，StringPlus 内置了必要的安全防护机制：

安全过滤（SqlSafeString）：接收待检查字符串及布尔标志 IsDel。若为 false，会将单引号和双引号替换为 HTML 实体编码（如 '），防止简单的注入攻击；若为 true，则直接剥离这些敏感字符。
数字身份校验：IsNumberId() 结合 QuickValidate() 正则引擎，高效判断传入的值是否符合正整数规范。
复杂规则分割（SplitMulti）：当源字符串需要通过复杂的正则表达式（如同时匹配逗号、制表符或换行）来切分时，此方法能一次性返回符合条件的字符串数组。

代码部署示例

以下保留了该类的完整实现代码。你可以将其作为独立文件 StringPlus.cs 添加到你的 C# 项目中。建议先对原有项目中的相关字符串工具逻辑进行备份，再用此版本覆盖，以确保兼容性与安全性的平滑过渡。

using System;
using System.Collections.Generic;
using System.Text;
using System.Text.RegularExpressions;
namespace DotNet.Utilities
{
  /// <summary>
  /// 字符串操作类
  /// 1、GetStrArray(string str, char speater, bool toLower) 把字符串按照分隔符转换成 List
  /// 2、GetStrArray(string str) 把字符串转 按照, 分割 换为数据
  /// 3、GetArrayStr(List list, string speater) 把 List 按照分隔符组装成 string
  /// 4、GetArrayStr(List list) 得到数组列表以逗号分隔的字符串
  /// 5、GetArrayValueStr(Dictionary<int, int> list)得到数组列表以逗号分隔的字符串
  /// 6、DelLastComma(string str)删除最后结尾的一个逗号
  /// 7、DelLastChar(string str, string strchar)删除最后结尾的指定字符后的字符
  /// 8、ToSBC(string input)转全角的函数(SBC case)
  /// 9、ToDBC(string input)转半角的函数(SBC case)
  /// 10、GetSubStringList(string o_str, char sepeater)把字符串按照指定分隔符装成 List 去除重复
  /// 11、GetCleanStyle(string StrList, string SplitString)将字符串样式转换为纯字符串
  /// 12、GetNewStyle(string StrList, string NewStyle, string SplitString, out string Error)将字符串转换为新样式
  /// 13、SplitMulti(string str, string splitstr)分割字符串
  /// 14、SqlSafeString(string String, bool IsDel)
  /// </summary>
  public class StringPlus
  {
    /// <summary>
    /// 把字符串按照分隔符转换成 List
    /// </summary>
    /// <param name="str">源字符串</param>
    /// <param name="speater">分隔符</param>
    /// <param name="toLower">是否转换为小写</param>
    /// <returns></returns>
    public static List<string> GetStrArray(string str, char speater, bool toLower)
    {
      List<string> list = new List<string>();
      string[] ss = str.Split(speater);
      foreach (string s in ss)
      {
        if (!string.IsNullOrEmpty(s) && s != speater.ToString())
        {
          string strVal = s;
          if (toLower)
          {
            strVal = s.ToLower();
          }
          list.Add(strVal);
        }
      }
      return list;
    }
    /// <summary>
    /// 把字符串转 按照, 分割 换为数据
    /// </summary>
    /// <param name="str"></param>
    /// <returns></returns>
    public static string[] GetStrArray(string str)
    {
      return str.Split(new Char[] { ',' });
    }
    /// <summary>
    /// 把 List<string> 按照分隔符组装成 string
    /// </summary>
    /// <param name="list"></param>
    /// <param name="speater"></param>
    /// <returns></returns>
    public static string GetArrayStr(List<string> list, string speater)
    {
      StringBuilder sb = new StringBuilder();
      for (int i = 0; i < list.Count; i++)
      {
        if (i == list.Count - 1)
        {
          sb.Append(list[i]);
        }
        else
        {
          sb.Append(list[i]);
          sb.Append(speater);
        }
      }
      return sb.ToString();
    }
    /// <summary>
    /// 得到数组列表以逗号分隔的字符串
    /// </summary>
    /// <param name="list"></param>
    /// <returns></returns>
    public static string GetArrayStr(List<int> list)
    {
      StringBuilder sb = new StringBuilder();
      for (int i = 0; i < list.Count; i++)
      {
        if (i == list.Count - 1)
        {
          sb.Append(list[i].ToString());
        }
        else
        {
          sb.Append(list[i]);
          sb.Append(",");
        }
      }
      return sb.ToString();
    }
    /// <summary>
    /// 得到数组列表以逗号分隔的字符串
    /// </summary>
    /// <param name="list"></param>
    /// <returns></returns>
    public static string GetArrayValueStr(Dictionary<int, int> list)
    {
      StringBuilder sb = new StringBuilder();
      foreach (KeyValuePair<int, int> kvp in list)
      {
        sb.Append(kvp.Value + ",");
      }
      if (list.Count > 0)
      {
        return DelLastComma(sb.ToString());
      }
      else
      {
        return "";
      }
    }
    #region 删除最后一个字符之后的字符
    /// <summary>
    /// 删除最后结尾的一个逗号
    /// </summary>
    public static string DelLastComma(string str)
    {
      return str.Substring(0, str.LastIndexOf(","));
    }
    /// <summary>
    /// 删除最后结尾的指定字符后的字符
    /// </summary>
    public static string DelLastChar(string str, string strchar)
    {
      return str.Substring(0, str.LastIndexOf(strchar));
    }
    #endregion
    /// <summary>
    /// 转全角的函数(SBC case)
    /// </summary>
    /// <param name="input"></param>
    /// <returns></returns>
    public static string ToSBC(string input)
    {
      //半角转全角：
      char[] c = input.ToCharArray();
      for (int i = 0; i < c.Length; i++)
      {
        if (c[i] == 32)
        {
          c[i] = (char)12288;
          continue;
        }
        if (c[i] < 127)
          c[i] = (char)(c[i] + 65248);
      }
      return new string(c);
    }
    /// <summary>
    /// 转半角的函数(SBC case)
    /// </summary>
    /// <param name="input">输入</param>
    /// <returns></returns>
    public static string ToDBC(string input)
    {
      char[] c = input.ToCharArray();
      for (int i = 0; i < c.Length; i++)
      {
        if (c[i] == 12288)
        {
          c[i] = (char)32;
          continue;
        }
        if (c[i] > 65280 && c[i] < 65375)
          c[i] = (char)(c[i] - 65248);
      }
      return new string(c);
    }
    /// <summary>
    /// 把字符串按照指定分隔符装成 List 去除重复
    /// </summary>
    /// <param name="o_str"></param>
    /// <param name="sepeater"></param>
    /// <returns></returns>
    public static List<string> GetSubStringList(string o_str, char sepeater)
    {
      List<string> list = new List<string>();
      string[] ss = o_str.Split(sepeater);
      foreach (string s in ss)
      {
        if (!string.IsNullOrEmpty(s) && s != sepeater.ToString())
        {
          list.Add(s);
        }
      }
      return list;
    }
    #region 将字符串样式转换为纯字符串
    /// <summary>
    /// 将字符串样式转换为纯字符串
    /// </summary>
    /// <param name="StrList"></param>
    /// <param name="SplitString"></param>
    /// <returns></returns>
    public static string GetCleanStyle(string StrList, string SplitString)
    {
      string RetrunValue = "";
      //如果为空，返回空值
      if (StrList == null)
      {
        RetrunValue = "";
      }
      else
      {
        //返回去掉分隔符
        string NewString = "";
        NewString = StrList.Replace(SplitString, "");
        RetrunValue = NewString;
      }
      return RetrunValue;
    }
    #endregion
    #region 将字符串转换为新样式
    /// <summary>
    /// 将字符串转换为新样式
    /// </summary>
    /// <param name="StrList"></param>
    /// <param name="NewStyle"></param>
    /// <param name="SplitString"></param>
    /// <param name="Error"></param>
    /// <returns></returns>
    public static string GetNewStyle(string StrList, string NewStyle, string SplitString, out string Error)
    {
      string ReturnValue = "";
      //如果输入空值，返回空，并给出错误提示
      if (StrList == null)
      {
        ReturnValue = "";
        Error = "请输入需要划分格式的字符串";
      }
      else
      {
        //检查传入的字符串长度和样式是否匹配,如果不匹配，则说明使用错误。给出错误信息并返回空值
        int strListLength = StrList.Length;
        int NewStyleLength = GetCleanStyle(NewStyle, SplitString).Length;
        if (strListLength != NewStyleLength)
        {
          ReturnValue = "";
          Error = "样式格式的长度与输入的字符长度不符，请重新输入";
        }
        else
        {
          //检查新样式中分隔符的位置
          string Lengstr = "";
          for (int i = 0; i < NewStyle.Length; i++)
          {
            if (NewStyle.Substring(i, 1) == SplitString)
            {
              Lengstr = Lengstr + "," + i;
            }
          }
          if (Lengstr != "")
          {
            Lengstr = Lengstr.Substring(1);
          }
          //将分隔符放在新样式中的位置
          string[] str = Lengstr.Split(',');
          foreach (string bb in str)
          {
            StrList = StrList.Insert(int.Parse(bb), SplitString);
          }
          //给出最后的结果
          ReturnValue = StrList;
          //因为是正常的输出，没有错误
          Error = "";
        }
      }
      return ReturnValue;
    }
    #endregion
    /// <summary>
    /// 分割字符串
    /// </summary>
    /// <param name="str"></param>
    /// <param name="splitstr"></param>
    /// <returns></returns>
    public static string[] SplitMulti(string str, string splitstr)
    {
      string[] strArray = null;
      if ((str != null) && (str != ""))
      {
        strArray = new Regex(splitstr).Split(str);
      }
      return strArray;
    }
    public static string SqlSafeString(string String, bool IsDel)
    {
      if (IsDel)
      {
        String = String.Replace("'", "");
        String = String.Replace("\"", "");
        return String;
      }
      String = String.Replace("'", "&#39;");
      String = String.Replace("\"", "&#34;");
      return String;
    }
    #region 获取正确的Id，如果不是正整数，返回0
    /// <summary>
    /// 获取正确的Id，如果不是正整数，返回0
    /// </summary>
    /// <param name="_value"></param>
    /// <returns>返回正确的整数ID，失败返回0</returns>
    public static int StrToId(string _value)
    {
      if (IsNumberId(_value))
        return int.Parse(_value);
      else
        return 0;
    }
    #endregion
    #region 检查一个字符串是否是纯数字构成的，一般用于查询字符串参数的有效性验证。
    /// <summary>
    /// 检查一个字符串是否是纯数字构成的，一般用于查询字符串参数的有效性验证。(0除外)
    /// </summary>
    /// <param name="_value">需验证的字符串。。</param>
    /// <returns>是否合法的bool值。</returns>
    public static bool IsNumberId(string _value)
    {
      return QuickValidate("^[1-9]*[0-9]*$", _value);
    }
    #endregion
    #region 快速验证一个字符串是否符合指定的正则表达式。
    /// <summary>
    /// 快速验证一个字符串是否符合指定的正则表达式。
    /// </summary>
    /// <param name="_express">正则表达式的内容。</param>
    /// <param name="_value">需验证的字符串。</param>
    /// <returns>是否合法的bool值。</returns>
    public static bool QuickValidate(string _express, string _value)
    {
      if (_value == null) return false;
      Regex myRegex = new Regex(_express);
      if (_value.Length == 0)
      {
        return false;
      }
      return myRegex.IsMatch(_value);
    }
    #endregion
  }
}