MSDN ライブラリ
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

String.Split メソッド (Char[], StringSplitOptions)

2013/12/12

指定された Unicode 文字の配列の要素で区切られた、この文字列の部分文字列を格納する文字列配列を返します。空の配列要素を返すかどうかをパラメーターで指定します。

Namespace:  System
アセンブリ:  mscorlib (mscorlib.dll 内)

public string[] Split(
	char[] separator,
	StringSplitOptions options
)

パラメーター

separator
型: System.Char []
この文字列での部分文字列の区切り文字である Unicode 文字の配列、区切り文字が含まれない空の配列、または null
options
型: System.StringSplitOptions
返される配列に空の要素を含めるかどうかを示すフラグ。返される配列で空の要素を省略する場合は StringSplitOptions.RemoveEmptyEntries を指定します。返される配列に空の要素を含める場合は StringSplitOptions.None を指定します。

戻り値

型: System.String []
この文字列を、separator 配列のいずれかまたは複数の要素 (文字) で区切ることによって取り出された部分文字列を格納する配列。詳細については、「解説」を参照してください。

例外条件
ArgumentException

optionsStringSplitOptions 列挙体のメンバーではありません。

返される配列要素に区切り記号文字は含まれません。

このインスタンスに、separator に指定されたいずれの文字も含まれていない場合、返される配列には、そのインスタンス自体を保持する要素が 1 つだけ格納されます。separator パラメーターが null の場合または文字が含まれていなかった場合、区切り記号に空白文字が指定されたものとして実行されます。Split メソッドで空白として解釈される文字の一覧については、String.Split(Char[]) メソッドの「解説」の表を参照してください (この一覧は、Trim() メソッドで認識される空白文字の一覧とは少し異なることに注意してください)。ただし、このメソッド オーバーロードの呼び出しの separator パラメーターが null の場合、コンパイラのオーバーロード解決は失敗します。呼び出されたメソッドを明確に識別するには、コードが null 型を指定する必要があります。このオーバーロードを明確に識別するいくつかの方法を次の例に示します。


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

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

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

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


separator の各要素は、区切り記号の文字を定義します。options パラメーターが RemoveEmptyEntries で、このインスタンスの長さがゼロの場合、空の配列が返されます。

options パラメーターが None で、2 つの区切り記号が隣接している場合、または、区切り記号がこのインスタンスの先頭か末尾に見つかった場合、対応する配列の要素には Empty が格納されます。

パフォーマンスに関する考慮事項

Split メソッドでは、返される配列オブジェクト用と、各配列要素の String オブジェクト用にメモリが確保されます。アプリケーション開発においてパフォーマンスの最適化が必要とされる場合、または、アプリケーション開発においてメモリ割り当ての管理がきわめて重要な要件となる場合は、IndexOf メソッドまたは IndexOfAny メソッドと、(必要に応じて) Compare メソッドを使用して文字列から部分文字列を検索します。

区切り記号文字の位置で文字列を分割する場合は、IndexOf メソッドまたは IndexOfAny メソッドを使用して、文字列中の区切り記号文字を検索します。区切り記号文字列の位置で文字列を分割する場合は、IndexOf メソッドまたは IndexOfAny メソッドを使用して、区切り記号文字列の最初の文字を検索します。次に、Compare メソッドを使用して、最初の文字に続く文字が区切り記号文字の残りの文字に等しいかどうかを判断します。

また、複数の Split メソッド呼び出しで同じ文字セットが文字列の分割に使用される場合は、配列を 1 つだけ作成して各メソッド呼び出しで参照することを検討してください。こうすることで、各メソッド呼び出しのオーバーヘッドを大幅に低減できます。

Split メソッドによって返される部分文字列を結果に含めるか除外するかを StringSplitOptions 列挙値を使って指定する例を次に示します。


using System;

class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      string s1 = ",ONE,,TWO,,,THREE,,";
      string s2 = "[stop]" +
                  "ONE[stop][stop]" +
                  "TWO[stop][stop][stop]" +
                  "THREE[stop][stop]";
      char[] charSeparators = { ',' };
      string[] stringSeparator = {"[stop]"};
      string[] result;
      // ------------------------------------------------------------------------------
      // Split a string delimited by characters.
      // ------------------------------------------------------------------------------
      outputBlock.Text += "1) Split a string delimited by characters:\n" + "\n";

      // Display the original string and delimiter characters.
      outputBlock.Text += String.Format("1a )The original string is \"{0}\".", s1) + "\n";
      outputBlock.Text += String.Format("The delimiter character is '{0}'.\n",
                         charSeparators[0]) + "\n";

      // Split a string delimited by characters and return all elements.
      outputBlock.Text += String.Format("1b) Split a string delimited by characters and " +
                        "return all elements:") + "\n";
      result = s1.Split(charSeparators, StringSplitOptions.None);
      Show(outputBlock, result);

      // Split a string delimited by characters and return all non-empty elements.
      outputBlock.Text += String.Format("1c) Split a string delimited by characters and " +
                        "return all non-empty elements:") + "\n";
      result = s1.Split(charSeparators, StringSplitOptions.RemoveEmptyEntries);
      Show(outputBlock, result);

      // ------------------------------------------------------------------------------
      // Split a string delimited by another string.
      // ------------------------------------------------------------------------------
      outputBlock.Text += "2) Split a string delimited by another string:\n" + "\n";

      // Display the original string and delimiter string.
      outputBlock.Text += String.Format("2a) The original string is \"{0}\".", s2) + "\n";
      outputBlock.Text += String.Format("The delimiter string is \"{0}\".\n", stringSeparator[0]) + "\n";

      // Split a string delimited by another string and return all elements.
      outputBlock.Text += String.Format("2b) Split a string delimited by another string and " +
                        "return all elements:") + "\n";
      result = s2.Split(stringSeparator, StringSplitOptions.None);
      Show(outputBlock, result);

      // Split the original string at the delimiter and return all non-empty elements.
      outputBlock.Text += String.Format("2c) Split a string delimited by another string and " +
                        "return all non-empty elements:") + "\n";
      result = s2.Split(stringSeparator, StringSplitOptions.RemoveEmptyEntries);
      Show(outputBlock, result);
   }

   // Display the array of separated strings.
   public static void Show(System.Windows.Controls.TextBlock outputBlock, string[] entries)
   {
      outputBlock.Text += String.Format("The return value contains these {0} elements:", entries.Length) + "\n";
      foreach (string entry in entries)
      {
         outputBlock.Text += String.Format("<{0}>", entry);
      }
      outputBlock.Text += "\n\n";
   }
}
/*
This example produces the following results:

1) Split a string delimited by characters:

1a )The original string is ",ONE,,TWO,,,THREE,,".
The delimiter character is ','.

1b) Split a string delimited by characters and return all elements:
The return value contains these 9 elements:
<><ONE><><TWO><><><THREE><><>

1c) Split a string delimited by characters and return all non-empty elements:
The return value contains these 3 elements:
<ONE><TWO><THREE>

2) Split a string delimited by another string:

2a) The original string is "[stop]ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]".
The delimiter string is "[stop]".

2b) Split a string delimited by another string and return all elements:
The return value contains these 9 elements:
<><ONE><><TWO><><><THREE><><>

2c) Split a string delimited by another string and return all non-empty elements:
The return value contains these 3 elements:
<ONE><TWO><THREE>

*/


Windows Phone OS

サポート: 8.0, 7.1, 7.0

表示:
© 2016 Microsoft