C#实用字符串处理工具类代码分享

小石头

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

原创

本文整理并分享了一个C#字符串处理工具类 `ExtendedString`。该类通过扩展方法的形式，提供了包含数字格式校验、HTML标签过滤、按字符权重截取字符串、文件大小单位换算以及系统命名规范验证在内的多项常用功能，旨在简化开发中常见的字符串清洗与验证逻辑。

主要功能概览

该工具类主要解决以下实际场景中的问题：

格式验证：校验字符串是否仅包含数字、正负号及小数点，或是否为字母数字组合。
空值判断增强：在 `IsNullOrEmpty` 的基础上增加对空白字符的 Trim 处理。
文本截断：支持将中文视为两个字符长度进行截断，避免乱码，并提供带省略号的完整截断效果。
内容清洗：移除字符串中包含的 HTML 标签。
资源解析：将类似 "10.1MB" 的用户界面显示格式还原为字节级数值。
系统规范校验：依据 Windows 等系统的保留字规则，验证文件夹和文件命名的合法性。

核心实现代码

以下是完整的 ExtendedString 静态类代码。请注意，部分正则表达式模式（如 HtmlTag, FolderName）依赖于外部常量定义，在实际项目中需确保引入相应的配置或使用标准正则替换。

public static class ExtendedString
{
    /// <summary>
    /// 验证字符串是否由正负号（+-）、数字、小数点构成，并且最多只有一个小数点
    /// </summary>
    public static bool IsNumeric(this string str)
    {
        Regex regex = new Regex(@"^[+-]?\d+[.]?\d*$");
        return regex.IsMatch(str);
    }

    /// <summary>
    /// 验证字符串是否仅由[0-9]构成
    /// </summary>
    public static bool IsNumericOnly(this string str)
    {
        Regex regex = new Regex("[0-9]");
        // 注意：原代码此处仅为匹配子串，若需严格全串匹配建议改为 ^[0-9]+$ 
        return regex.IsMatch(str);
    }

    /// <summary>
    /// 验证字符串是否由字母和数字构成
    /// </summary>
    public static bool IsNumericOrLetters(this string str)
    {
        Regex regex = new Regex("[a-zA-Z0-9]");
        // 注意：原代码此处仅为匹配子串，若需严格全串匹配建议改为 ^[a-zA-Z0-9]+$ 
        return regex.IsMatch(str);
    }

    /// <summary>
    /// 验证是否为空字符串。若无需裁切两端空格，建议直接使用 String.IsNullOrEmpty(string)
    /// </summary>
    /// <remarks>
    /// 不同于String.IsNullOrEmpty(string)，此方法会增加一步Trim操作。如 IsNullOrEmptyStr(" ") 将返回 true。
    /// </remarks>
    public static bool IsNullOrEmptyStr(this string str)
    {
        if (string.IsNullOrEmpty(str)) { return true; }
        if (str.Trim().Length == 0) { return true; }
        return false;
    }

    /// <summary>
    /// 裁切字符串（中文按照两个字符计算）
    /// </summary>
    /// <param name="str">旧字符串</param>
    /// <param name="len">新字符串长度</param>
    /// <param name="HtmlEnable">为 false 时过滤 Html 标签后再进行裁切，反之则保留 Html 标签。</param>
    /// <remarks>
    /// <para>注意：<ol>
    /// <li>若字符串被截断则会在末尾追加“...”，反之则直接返回原始字符串。</li>
    /// <li>参数 <paramref name="HtmlEnable"/> 为 false 时会先调用HtmlFilter过滤掉 Html 标签再进行裁切。</li>
    /// <li>中文按照两个字符计算。若指定长度位置恰好只获取半个中文字符，则会将其补全，如下面的例子：<br/>
    /// <code><![CDATA[
    /// string str = "感谢使用uoLib。";
    /// string A = CutStr(str,4);   // A = "感谢..."
    /// string B = CutStr(str,5);   // B = "感谢使..."
    /// ]]></code></li>
    /// </ol>
    /// </para>
    /// </remarks>
    public static string CutStr(this string str, int len, bool HtmlEnable)
    {
        if (str == null || str.Length == 0 || len <= 0) { return string.Empty; }

        if (HtmlEnable == false) str = HtmlFilter(str);
        int l = str.Length;

        #region 计算长度
        int clen = 0;//当前长度
        while (clen < len && clen < l)
        {
            //每遇到一个中文，则将目标长度减一。
            if ((int)str[clen] > 128) { len--; }
            clen++;
        }
        #endregion

        if (clen < l)
        {
            return str.Substring(0, clen) + "...";
        }
        else
        {
            return str;
        }
    }

    /// <summary>
    /// 裁切字符串（中文按照两个字符计算，裁切前会先过滤 Html 标签）
    /// </summary>
    public static string CutStr(this string str, int len)
    {
        if (IsNullOrEmptyStr(str)) { return string.Empty; }
        else
        {
            return CutStr(str, len, false);
        }
    }

    /// <summary>
    /// 过滤HTML标签
    /// </summary>
    public static string HtmlFilter(this string str)
    {
        if (IsNullOrEmptyStr(str)) { return string.Empty; }
        else
        {
            // 假设存在公共类 RegexPatterns.HtmlTag
            Regex re = new Regex(RegexPatterns.HtmlTag, RegexOptions.IgnoreCase);
            return re.Replace(str, "");
        }
    }

    /// <summary>
    /// 获取字符串长度。与string.Length不同的是，该方法将中文作 2 个字符计算。
    /// </summary>
    public static int GetLength(this string str)
    {
        if (str == null || str.Length == 0) { return 0; }

        int l = str.Length;
        int realLen = l;

        #region 计算长度
        int clen = 0;//当前长度
        while (clen < l)
        {
            //每遇到一个中文，则将实际长度加一。
            if ((int)str[clen] > 128) { realLen++; }
            clen++;
        }
        #endregion

        return realLen;
    }

    /// <summary>
    /// 将形如 10.1MB 格式对用户友好的文件大小字符串还原成真实的文件大小，单位为字节。
    /// </summary>
    public static long GetFileSizeFromString(this string formatedSize)
    {
        if (IsNullOrEmptyStr(formatedSize)) throw new ArgumentNullException("formatedSize");

        long size;
        if (long.TryParse(formatedSize, out size)) return size;

        //去掉数字分隔符
        formatedSize = formatedSize.Replace(",", "");

        Regex re = new Regex(@"^([\d\.]+)((?:TB|GB|MB|KB|Bytes))$");
        if (re.IsMatch(formatedSize))
        {
            MatchCollection mc = re.Matches(formatedSize);
            Match m = mc[0];
            double s = double.Parse(m.Groups[1].Value);

            switch (m.Groups[2].Value)
            {
                case "TB":
                    s *= 1099511627776;
                    break;
                case "GB":
                    s *= 1073741824;
                    break;
                case "MB":
                    s *= 1048576;
                    break;
                case "KB":
                    s *= 1024;
                    break;
            }

            size = (long)s;
            return size;
        }

        throw new ArgumentException("formatedSize");
    }

    /// <summary>
    /// 根据文件夹命名规则验证字符串是否符合文件夹格式
    /// </summary>
    public static bool IsFolderName(this string folderName)
    {
        if (IsNullOrEmptyStr(folderName)) { return false; }
        else
        {
            // 不能以 “.” 开头
            folderName = folderName.Trim().ToLower();

            // “nul”、“aux”、“con”、“com1”、“lpt1”不能为文件夹/文件的名称
            switch (folderName)
            {
                case "nul":
                case "aux":
                case "con":
                case "com1":
                case "lpt1":
                    return false;
                default:
                    break;
            }

            Regex re = new Regex(RegexPatterns.FolderName, RegexOptions.IgnoreCase);
            return re.IsMatch(folderName);
        }
    }

    /// <summary>
    /// 根据文件名命名规则验证字符串是否符合文件名格式
    /// </summary>
    public static bool IsFileName(this string fileName)
    {
        if (IsNullOrEmptyStr(fileName)) { return false; }
        else
        {
            fileName = fileName.Trim().ToLower();
            // 不能以 “.” 开头
            // 作为文件名，第一个“.” 之前不能是“nul”、“aux”、“con”、“com1”、“lpt1”
            if (fileName.StartsWith(".")
                || fileName.StartsWith("nul.")
                || fileName.StartsWith("aux.")
                || fileName.StartsWith("con.")
                || fileName.StartsWith("com1.")
                || fileName.StartsWith("lpt1.")
            ) return false;

            Regex re = new Regex(RegexPatterns.FileName, RegexOptions.IgnoreCase);
            return re.IsMatch(fileName);
        }
    }

    /// <summary>
    /// 验证是否为合法的RGB颜色字符串
    /// </summary>
    public static bool IsRGBColor(this string color)
    {
        if (IsNullOrEmptyStr(color)) { return false; }
        else
        {
            Regex re = new Regex(RegexPatterns.HtmlColor, RegexOptions.IgnoreCase);
            return re.IsMatch(color);
        }
    }

    /// <summary>
    /// 获取JavaScript安全的字符串（转义反斜杠和双引号）
    /// </summary>
    public static string GetJsSafeStr(this string str)
    {
        if (string.IsNullOrEmpty(str))
            return string.Empty;

        return str.Replace("\\", "\\\\").Replace("\"", "\\\"");
    }
}

注意事项与建议

依赖项：上述代码中引用了 RegexPatterns 类中的静态字段。在生产环境中使用时，请确保定义了这些正则表达式常量，或者直接将正则字符串嵌入到对应的方法中。
字符编码：`GetLength` 和 `CutStr` 方法基于 ASCII 码值（大于128）来粗略判断中文字符。对于大多数常见中文环境有效，但如果涉及复杂的 Unicode 区域，建议使用更严谨的 `` 类进行处理。
性能优化：频繁调用的正则表达式建议在构造时编译为 Compiled 模式以提高性能，尤其是在处理大量文本输入时。

以上就是C#字符串的常用操作工具类代码分享的详细内容，更多关于C#字符串处理技巧的资料请关注本站其它相关文章！