C#操作操作类库五（字符串的常用扩展方法）

public  static  class ExtendedString

{

     ///   <summary>

     ///  验证字符串是否由正负号（+-）、数字、小数点构成，并且最多只有一个小数点

     ///   </summary>

     ///   <param name="str"></param>

     ///   <returns></returns>

     public  static  bool IsNumeric( this  string str)

    {

        Regex regex =  new Regex( @" ^[+-]?\d+[.]?\d*$ ");

         return regex.IsMatch(str);            

    }

 

     ///   <summary>

     ///  验证字符串是否仅由[0-9]构成

     ///   </summary>

     ///   <param name="str"></param>

     ///   <returns></returns>

     public  static  bool IsNumericOnly( this  string str)

    {

        Regex regex =  new Regex( " [0-9] ");

         return regex.IsMatch(str);

    }

 

     ///   <summary>

     ///  验证字符串是否由字母和数字构成

     ///   </summary>

     ///   <param name="str"></param>

     ///   <returns></returns>

     public  static  bool IsNumericOrLetters( this  string str)

    {

        Regex regex =  new Regex( " [a-zA-Z0-9] ");

         return regex.IsMatch(str);

    }

 

     ///   <summary>

     ///  验证是否为空字符串。若无需裁切两端空格，建议直接使用 String.IsNullOrEmpty(string)

     ///   </summary>

     ///   <param name="str"></param>

     ///   <returns></returns>

     ///   <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 时会先调用 <see cref="uoLib.Common.Functions.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>

     ///   <param name="str"> 旧字符串 </param>

     ///   <param name="len"> 新字符串长度 </param>

     ///   <remarks>

     ///   <para> 注意： <ol>

     ///   <li> 若字符串被截断则会在末尾追加“...”，反之则直接返回原始字符串。 </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)

    {

         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

        {

            Regex re =  new Regex(RegexPatterns.HtmlTag, RegexOptions.IgnoreCase);

             return re.Replace(str,  "");

        }

    }

 

     ///   <summary>

     ///  获取字符串长度。与string.Length不同的是，该方法将中文作 2 个字符计算。

     ///   </summary>

     ///   <param name="str"> 目标字符串 </param>

     ///   <returns></returns>

     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>

     ///   <param name="formatedSize"> 形如 10.1MB 格式的文件大小字符串 </param>

     ///   <remarks>

     ///  参见： <see cref="uoLib.Common.Functions.FormatFileSize(long)"/>

     ///   </remarks>

     ///   <returns></returns>

     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>

     ///   <param name="color"> RGB颜色，如：#00ccff | #039 | ffffcc </param>

     ///   <returns></returns>

     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);

        }

    }

 

     public  static  string GetJsSafeStr( this  string str)

    {

         if ( string.IsNullOrEmpty(str))

             return  string.Empty;

 

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

    }

}