导出 (0) 打印
全部展开
此文章由机器翻译。 将光标移到文章的句子上,以查看原文。 更多信息。
译文
原文

String.Split 方法 (String[], StringSplitOptions)

返回的字符串数组包含此字符串中的子字符串(由指定字符串数组的元素分隔)。 参数指定是否返回空数组元素。

命名空间:  System
程序集:  mscorlib(在 mscorlib.dll 中)

[ComVisibleAttribute(false)]
public string[] Split(
	string[] separator,
	StringSplitOptions options
)

参数

separator
类型:System.String[]
分隔此字符串中的子字符串的字符串数组、不包含分隔符的空数组或 null
options
类型:System.StringSplitOptions
要省略返回的数组中的空数组元素,则为 RemoveEmptyEntries;要包含返回的数组中的空数组元素,则为 None

返回值

类型:System.String[]
一个数组,其元素包含此字符串中的子字符串,这些子字符串由 separator 中的一个或多个字符串分隔。 有关更多信息,请参见“备注”一节。

异常条件
ArgumentException

options 不是 StringSplitOptions 值之一。

返回值详细信息

返回的数组元素中不包含分隔符字符串。

如果此实例不包含 separator 中的任何字符串,则返回的数组由包含此实例的单个元素组成。 如果 separator 参数为 null 或不包含任何字符,则采用空白字符作为分隔符。 空白字符由 Unicode 标准定义,如果将它们传递给 Char.IsWhiteSpace 方法,将返回 true 但是,如果调用中的 separator 参数对于此方法重载为 null,则编译器重载决策失败。 要明确标识调用的方法,您的代码必须指示 null 类型。 下面的示例显示明确标识此重载的集中方法。


string phrase = "The quick  brown fox";
string[] words;

words = phrase.Split(default(string[]), StringSplitOptions.RemoveEmptyEntries);

words = phrase.Split((string[]) null, StringSplitOptions.RemoveEmptyEntries);

words = phrase.Split(null as string[], StringSplitOptions.RemoveEmptyEntries);


如果 options 参数为 RemoveEmptyEntries 且此实例的长度为零,则返回空数组。

separator 的每个元素定义单独的分隔符,包括一个或多个字符。 如果 options 参数为 None,且两个分隔符相邻,或者在此实例的开头或末尾找到分隔符,则相对应的数组元素包含 Empty

分隔符数组

如果在separator中的任何元素都由多个字符组成,那么只有该元素第一个字符被考虑作为分隔符,忽略后续字符。 例如,如果separator中有一个元素是“10”,尝试将字符串“This10is10a10string.”分解则返回下列4个元素的数组: { "This", "0is", "0a", "0string." }}.

比较详细信息

Split 方法提取此字符串中的子字符串,这些子字符串由 separator 参数中的一个或多个字符串分隔,然后该方法将这些子字符串作为数组的元素返回。

Split 方法使用区分大小写的序号排序规则执行比较,从而查找分隔符。 有关字、字符串和序号排序的更多信息,请参见 System.Globalization.CompareOptions 枚举。

Split 方法忽略 separator 的任何值为 null 或空字符串 ("") 的元素。

为了在 separator 中的字符串具有公共字符的情况下避免出现不明确的结果,Split 操作从实例值的开始进行到结尾,并匹配 separator 中与实例中的分隔符相等的第一个元素。 实例中子字符串的出现顺序优先于 separator 中元素的顺序。

例如,考虑值为"abcdef"的实例。 如果 separator 中的第一个元素为"ef",且第二个元素为"bcde",则拆分操作的结果将是"a"和"f"。 这是因为先遇到实例中的子字符串"bcde",且它匹配 separator 中的元素,然后才遇到子字符串"f"。

不过,如果 separator 的第一个元素为"bcd",且第二个元素为"bc",则拆分操作的结果将是"a"和"ef"。 这是因为"bcd"是 separator 中第一个与实例中的分隔符匹配的分隔符。 如果颠倒分隔符的顺序,使得第一个元素为"bc"且第二个元素为"bcd",则结果将是"a"和"def"。

性能注意事项

Split 方法为返回的数组对象分配内存,同时还为每一个数组元素分配一个 String 对象。 如果您的应用程序要求达到最佳性能,或者如果在您的应用程序中内存分配管理很关键,请考虑使用 IndexOfIndexOfAny 方法,也可以选择使用 Compare 方法,在字符串中定位子字符串。

如果在分隔符字符处分割字符串,请使用 IndexOfIndexOfAny 方法在字符串中定位分隔符字符。 如果在分隔符字符串处分割字符串,请使用 IndexOfIndexOfAny 方法定位分隔符字符串的第一个字符。 然后使用 Compare 方法确定第一个字符后面的字符是否等于分隔符字符串的其余字符。

此外,如果在多个 Split 方法调用中使用相同的字符集拆分字符串,请考虑创建一个数组并在每个方法调用中都引用该数组。 这可以极大地减少每个方法调用的额外系统开销。

对调用者的说明

在 .NET Framework 3.5 和早期版本中,如果为 Split 方法传递了值为 null 或不包含字符的 separator 参数,该方法用来分割字符串的字符集将与 Trim 方法用来修整字符串的字符集略有不同。 在 .NET Framework 4 中,这两种方法使用完全相同的 Unicode 空白字符集。

下面的示例演示了通过调用字符串的 String.Split(String[], StringSplitOptions) 方法(其 options 参数等于 StringSplitOptions.NoneStringSplitOptions.RemoveEmptyEntries)所返回的数组中的差异。


using System;

class Example 
{
   public static void Main() 
   {
      string source = "[stop]ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]";
      string[] stringSeparators = new string[] {"[stop]"};
      string[] result;

      // Display the original string and delimiter string.
      Console.WriteLine("Splitting the string:\n   \"{0}\".", source);
      Console.WriteLine();
      Console.WriteLine("Using the delimiter string:\n   \"{0}\"", 
                        stringSeparators[0]);
      Console.WriteLine();                           

      // Split a string delimited by another string and return all elements.
      result = source.Split(stringSeparators, StringSplitOptions.None);
      Console.WriteLine("Result including all elements ({0} elements):", 
                        result.Length);
      Console.Write("   ");
      foreach (string s in result)
      {
         Console.Write("'{0}' ", String.IsNullOrEmpty(s) ? "<>" : s);                   
      }
      Console.WriteLine();
      Console.WriteLine();

      // Split delimited by another string and return all non-empty elements.
      result = source.Split(stringSeparators, 
                            StringSplitOptions.RemoveEmptyEntries);
      Console.WriteLine("Result including non-empty elements ({0} elements):", 
                        result.Length);
      Console.Write("   ");
      foreach (string s in result)
      {
         Console.Write("'{0}' ", String.IsNullOrEmpty(s) ? "<>" : s);                   
      }
      Console.WriteLine();
   }
}
// The example displays the following output:
//    Splitting the string:
//       "[stop]ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]".
//    
//    Using the delimiter string:
//       "[stop]"
//    
//    Result including all elements (9 elements):
//       '<>' 'ONE' '<>' 'TWO' '<>' '<>' 'THREE' '<>' '<>'
//    
//    Result including non-empty elements (3 elements):
//       'ONE' 'TWO' 'THREE'


下面的示例定义了一个包括标点符号和空白字符的分隔符数组。 传递数组的StringSplitOptions.RemoveEmptyEntries值给 Split(String[], StringSplitOptions) 方法,返回来自该字符串的各个词的数组。


using System;

public class Example
{
   public static void Main()
   {
      string[] separators = {",", ".", "!", "?", ";", ":", " "};
      string value = "The handsome, energetic, young dog was playing with his smaller, more lethargic litter mate.";
      string[] words = value.Split(separators, StringSplitOptions.RemoveEmptyEntries);
      foreach (var word in words)
         Console.WriteLine(word);
   }
}
// The example displays the following output:
//       The
//       handsome
//       energetic
//       young
//       dog
//       was
//       playing
//       with
//       his
//       smaller
//       more
//       lethargic
//       litter
//       mate


请注意,以options 参数调用方法,方法将设置为 StringSplitOptions.RemoveEmptyEntries 阻止返回包含表示在标点符号和空白字符之间的空子字符串的匹配的String.Empty 值的数组。

.NET Framework

受以下版本支持:4.5.2、4.5.1、4.5、4、3.5、3.0、2.0

.NET Framework Client Profile

受以下版本支持:4、3.5 SP1

可移植类库

受以下版本支持:可移植类库

适用于 Windows 应用商店应用的 .NET

受以下版本支持:Windows 8

适用于 Windows Phone 应用的 .NET

受以下版本支持:Windows Phone 8、Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008(不支持服务器核心角色), Windows Server 2008 R2(支持带 SP1 或更高版本的服务器核心角色;不支持 Itanium)

.NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参阅.NET Framework 系统要求

社区附加资源

添加
显示:
© 2015 Microsoft