Regex.Split メソッド

リファレンス

定義

名前空間:: System.Text.RegularExpressions

アセンブリ:: System.Text.RegularExpressions.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

正規表現の一致箇所によって定義される位置で、入力文字列を部分文字列の配列に分割します。

オーバーロード

Split(String)	Regex コンストラクターで指定された正規表現パターンによって定義されている位置で入力文字列を分割し、部分文字列の配列に格納します。
Split(String, Int32)	Regex コンストラクターで指定された正規表現で定義されている位置で、入力文字列を指定されている最大回数だけ分割し、部分文字列の配列に格納します。
Split(String, String)	正規表現パターンによって定義されている位置で、入力文字列を部分文字列の配列に分割します。
Split(String, Int32, Int32)	Regex コンストラクターで指定された正規表現で定義されている位置で、入力文字列を指定されている最大回数だけ分割し、部分文字列の配列に格納します。正規表現パターンの検索は、入力文字列の指定した文字位置から開始します。
Split(String, String, RegexOptions)	指定された正規表現パターンによって定義されている位置で、入力文字列を部分文字列の配列に分割します。指定したオプションで、一致操作を変更します。
Split(String, String, RegexOptions, TimeSpan)	指定された正規表現パターンによって定義されている位置で、入力文字列を部分文字列の配列に分割します。追加のパラメーターでは、一致が見つからない場合に一致操作とタイムアウト間隔を変更するオプションを指定します。

Split(String)

Source:: Regex.Split.cs

Source:: Regex.Split.cs

Source:: Regex.Split.cs

Regex コンストラクターで指定された正規表現パターンによって定義されている位置で入力文字列を分割し、部分文字列の配列に格納します。

public:
 cli::array <System::String ^> ^ Split(System::String ^ input);

public string[] Split (string input);

member this.Split : string -> string[]

Public Function Split (input As String) As String()

パラメーター

input: String

分割する文字列。

戻り値

String[]

文字列の配列。

例外

ArgumentNullException

input が nullです。

RegexMatchTimeoutException

タイムアウトが発生しました。タイムアウトの詳細については、「解説」をご覧ください。

注釈

メソッドは Regex.Split メソッドに String.Split(Char[]) 似ていますが、文字列は Regex.Split 一連の文字ではなく正規表現によって決定される区切り記号で分割される点が除きます。文字列はできるだけ多くの回数分割されます。区切り記号が見つからない場合、戻り値には、値が元の入力文字列である 1 つの要素が含まれます。

複数の一致が互いに隣接している場合は、空の文字列が配列に挿入されます。たとえば、1 つのハイフンで文字列を分割すると、次のコードに示すように、返される配列に 2 つの隣接するハイフンが見つかった位置に空の文字列が含まれます。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      Regex regex = new Regex("-");         // Split on hyphens.
      string[] substrings = regex.Split("plum--pear");
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// The example displays the following output:
//    'plum'
//    ''
//    'pear'

Imports System.Text.RegularExpressions

Module RegexSplit
   Public Sub Main()
      Dim regex As Regex = New Regex("-")         ' Split on hyphens.
      Dim substrings() As String = regex.Split("plum--pear")
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub
End Module
' The example displays the following output:
'    'plum'
'    ''
'    'pear'

入力文字列の先頭または末尾に一致が見つかった場合は、返される配列の先頭または末尾に空の文字列が含まれます。次の例では、正規表現パターン \d+ を使用して、入力文字列を数値で分割します。文字列は一致する数値で始まり、終わるので、返される配列の最初の要素と最後の要素の値はです String.Empty。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"\d+";
      Regex rgx = new Regex(pattern);
      string input = "123ABCDE456FGHIJKL789MNOPQ012";
      
      string[] result = rgx.Split(input);
      for (int ctr = 0; ctr < result.Length; ctr++) {
         Console.Write("'{0}'", result[ctr]);
         if (ctr < result.Length - 1) 
            Console.Write(", ");
      }
      Console.WriteLine();
   }
}
// The example displays the following output:
//       '', 'ABCDE', 'FGHIJKL', 'MNOPQ', ''

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "\d+"
      Dim rgx As New Regex(pattern)
      Dim input As String = "123ABCDE456FGHIJKL789MNOPQ012"
      
      Dim result() As String = rgx.Split(input)
      For ctr As Integer = 0 To result.Length - 1
         Console.Write("'{0}'", result(ctr))
         If ctr < result.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine()
   End Sub               
End Module
' The example displays the following output:
'       '', 'ABCDE', 'FGHIJKL', 'MNOPQ', ''

キャプチャかっこが式で Regex.Split 使用されている場合、キャプチャされたテキストは結果の文字列配列に含まれます。たとえば、キャプチャかっこ内に配置されたハイフンに文字列 "plum-pear" を分割した場合、返される配列にはハイフンを含む文字列要素が含まれます。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      Regex regex = new Regex("(-)");         // Split on hyphens.
      string[] substrings = regex.Split("plum-pear");
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// The example displays the following output:
//    'plum'
//    '-'
//    'pear'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim regex As Regex = New Regex("(-)")          ' Split on hyphens.
      Dim substrings() As String = regex.Split("plum-pear")
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub
End Module
' The example displays the following output:
'    'plum'
'    '-'
'    'pear'

ただし、正規表現パターンに複数のキャプチャかっこセットが含まれている場合、このメソッドの動作は.NET Frameworkのバージョンによって異なります。 .NET Framework 1.0 および 1.1 では、キャプチャかっこの最初のセット内で一致するものが見つからない場合、追加のキャプチャかっこからキャプチャされたテキストは、返される配列に含まれません。 .NET Framework 2.0 以降では、キャプチャされたすべてのテキストも返される配列に追加されます。たとえば、次のコードでは、2 組のキャプチャかっこを使用して、日付文字列から日付の区切り記号を含む日付の要素を抽出します。かっこをキャプチャする最初のセットはハイフンをキャプチャし、2 番目のセットはスラッシュをキャプチャします。サンプルコードがコンパイルされ、.NET Framework 1.0 または 1.1 で実行される場合、スラッシュ文字は除外されます。コンパイルされ、.NET Framework 2.0 以降のバージョンで実行される場合は、それらの文字が含まれます。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = @"07/14/2007";   
      string pattern = @"(-)|(/)";
      Regex regex = new Regex(pattern);
      foreach (string result in regex.Split(input)) 
      {
         Console.WriteLine("'{0}'", result);
      }
   }
}
// Under .NET 1.0 and 1.1, the method returns an array of
// 3 elements, as follows:
//    '07'
//    '14'
//    '2007'
//
// Under .NET 2.0 and later, the method returns an array of
// 5 elements, as follows:
//    '07'
//    '/'
//    '14'
//    '/'
//    '2007'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "07/14/2007"   
      Dim pattern As String = "(-)|(/)"
      Dim regex As Regex = New Regex(pattern)
      For Each result As String In regex.Split(input) 
         Console.WriteLine("'{0}'", result)
      Next
   End Sub
End Module
' In .NET 1.0 and 1.1, the method returns an array of
' 3 elements, as follows:
'    '07'
'    '14'
'    '2007'
'
' In .NET 2.0 and later, the method returns an array of
' 5 elements, as follows:
'    '07'
'    '/'
'    '14'
'    '/'
'    '2007'

正規表現が空の文字列と一致する場合、 Split(String) 空の文字列区切り記号はすべての場所で見つかるため、文字列を 1 文字の文字列の配列に分割します。次に例を示します。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "characters";
      Regex regex = new Regex("");
      string[] substrings = regex.Split(input);
      Console.Write("{");
      for(int ctr = 0; ctr < substrings.Length; ctr++)
      {
         Console.Write(substrings[ctr]);
         if (ctr < substrings.Length - 1)
            Console.Write(", ");
      }
      Console.WriteLine("}");
   }
}
// The example displays the following output:   
//    {, c, h, a, r, a, c, t, e, r, s, }

Imports System.Text.RegularExpressions

Module Main
   Public Sub Main()
      Dim input As String = "characters"
      Dim regex As New Regex("")
      Dim substrings() As String = regex.Split(input)
      Console.Write("{")
      For ctr As Integer = 0 to substrings.Length - 1
         Console.Write(substrings(ctr))
         If ctr < substrings.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine("}")
   End Sub
End Module
' The example produces the following output:   
'    {, c, h, a, r, a, c, t, e, r, s, }

返される配列には、配列の先頭と末尾に空の文字列も含まれていることに注意してください。

RegexMatchTimeoutException分割操作の実行時間がコンストラクターで指定されたタイムアウト間隔を超えると、例外がRegex.Regex(String, RegexOptions, TimeSpan)スローされます。コンストラクターを呼び出すときにタイムアウト間隔を設定しない場合、オブジェクトが作成されるアプリケーションドメイン Regex に対して確立されたタイムアウト値を操作が超えると、例外がスローされます。コンストラクター呼び出しまたはアプリケーションドメインのプロパティで Regex タイムアウトが定義されていない場合、またはタイムアウト値がの場合、 Regex.InfiniteMatchTimeout例外はスローされません

こちらもご覧ください

正規表現言語 - クイックリファレンス

適用対象

Split(String, Int32)

Source:: Regex.Split.cs

Source:: Regex.Split.cs

Source:: Regex.Split.cs

Regex コンストラクターで指定された正規表現で定義されている位置で、入力文字列を指定されている最大回数だけ分割し、部分文字列の配列に格納します。

public:
 cli::array <System::String ^> ^ Split(System::String ^ input, int count);

public string[] Split (string input, int count);

member this.Split : string * int -> string[]

Public Function Split (input As String, count As Integer) As String()

パラメーター

input: String

分割対象の文字列。

count: Int32

分割を実行する最大回数。

戻り値

String[]

文字列の配列。

例外

ArgumentNullException

input が nullです。

RegexMatchTimeoutException

タイムアウトが発生しました。タイムアウトの詳細については、「解説」をご覧ください。

注釈

メソッドは Regex.Split メソッドに String.Split 似ていますが、文字列は Regex.Split 一連の文字ではなく正規表現によって決定される区切り記号で分割される点が除きます。パラメーターは count 、文字列を分割できる部分文字列 input の最大数を指定します。最後の文字列には、文字列の分割されていない剰余が含まれます。値が count 0 の場合、可能な限り複数回分割する既定の動作が提供されます。

複数の一致が互いに隣接している場合、またはの先頭または末尾 inputに一致が見つかり、検出された一致の数が少なくとも 2 つ未満 countの場合、空の文字列が配列に挿入されます。つまり、隣接する一致または入力文字列の先頭または末尾の一致に起因する空の文字列は、一致する部分文字列の数がと等しい countかどうかを判断する際にカウントされます。次の例では、正規表現 /d+ を使用して、1 つ以上の 10 進数を含む入力文字列を最大 3 つの部分文字列に分割します。入力文字列の先頭は正規表現パターンと一致するため、最初の配列要素にはが含まれており String.Empty、2 番目の要素には入力文字列の最初の英字セットが含まれており、3 番目の配列には 3 番目の一致に続く文字列の残りの部分が含まれます。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"\d+";
      Regex rgx = new Regex(pattern);
      string input = "123ABCDE456FGHIJKL789MNOPQ012";
      
      string[] result = rgx.Split(input, 3);
      for (int ctr = 0; ctr < result.Length; ctr++) {
         Console.Write("'{0}'", result[ctr]);
         if (ctr < result.Length - 1) 
            Console.Write(", ");
      }
      Console.WriteLine();
   }
}
// The example displays the following output:
//       '', 'ABCDE', 'FGHIJKL789MNOPQ012'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "\d+"
      Dim rgx As New Regex(pattern)
      Dim input As String = "123ABCDE456FGHIJKL789MNOPQ012"
      
      Dim result() As String = rgx.Split(input, 3)
      For ctr As Integer = 0 To result.Length - 1
         Console.Write("'{0}'", result(ctr))
         If ctr < result.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine()
   End Sub               
End Module
' The example displays the following output:
'       '', 'ABCDE', 'FGHIJKL789MNOPQ012'

キャプチャするかっこが正規表現で使用されている場合、キャプチャされたテキストはすべて分割文字列の配列に含まれます。ただし、キャプチャされたテキストを含む配列要素は、一致の数がに達した countかどうかを判断する際にはカウントされません。たとえば、文字列 "apple-apricot-plum-pear-banana" を最大 4 つの部分文字列に分割すると、次のコードに示すように 7 要素配列になります。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = "(-)";
      string input = "apple-apricot-plum-pear-banana";
      Regex regex = new Regex(pattern);         // Split on hyphens.
      string[] substrings = regex.Split(input, 4);
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// The example displays the following output:
//       'apple'
//       '-'
//       'apricot'
//       '-'
//       'plum'
//       '-'
//       'pear-banana'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "(-)"
      Dim input As String = "apple-apricot-plum-pear-banana"
      Dim regex As Regex = New Regex(pattern)         ' Split on hyphens.
      Dim substrings() As String = regex.Split(input, 4)
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub
End Module
' The example displays the following output:
'    'apple'
'    '-'
'    'apricot'
'    '-'
'    'plum'
'    '-'
'    'pear-banana'

ただし、正規表現パターンに複数のキャプチャかっこセットが含まれている場合、このメソッドの動作は.NET Frameworkのバージョンによって異なります。 .NET Framework 1.0 と 1.1 では、キャプチャするかっこの最初のセットからキャプチャされたテキストのみが、返される配列に含まれます。 .NET Framework 2.0 以降では、キャプチャされたすべてのテキストが返される配列に追加されます。ただし、キャプチャされたテキストを含む返される配列内の要素は、一致する部分文字列の数がと等しい countかどうかを判断する際にはカウントされません。たとえば、次のコードでは、正規表現で 2 組のキャプチャかっこを使用して、日付文字列から日付の要素を抽出します。かっこをキャプチャする最初のセットはハイフンをキャプチャし、2 番目のセットはスラッシュをキャプチャします。メソッドの Split(String, Int32) 呼び出しでは、返される配列内の最大 2 つの要素を指定します。コード例がコンパイルされ、.NET Framework 1.0 または 1.1 で実行される場合、メソッドは 2 要素の文字列配列を返します。コンパイルされ、.NET Framework 2.0 以降のバージョンで実行される場合、メソッドは 3 要素の文字列配列を返します。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = @"07/14/2007";   
      string pattern = @"(-)|(/)";
      Regex regex = new Regex(pattern);
      foreach (string result in regex.Split(input, 2)) 
      {
         Console.WriteLine("'{0}'", result);
      }
   }
}
// Under .NET 1.0 and 1.1, the method returns an array of
// 2 elements, as follows:
//    '07'
//    '14/2007'
//
// Under .NET 2.0 and later, the method returns an array of
// 3 elements, as follows:
//    '07'
//    '/'
//    '14/2007'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "07/14/2007"   
      Dim pattern As String = "(-)|(/)"
      Dim regex As Regex = New Regex(pattern)
      For Each result As String In regex.Split(input, 2) 
         Console.WriteLine("'{0}'", result)
      Next
   End Sub
End Module
' In .NET 1.0 and 1.1, the method returns an array of
' 2 elements, as follows:
'    '07'
'    '14/2007'
'
' In .NET 2.0 and later, the method returns an array of
' 3 elements, as follows:
'    '07'
'    '/'
'    '14/2007'

正規表現が空の文字列と一致する場合、 Split(String, Int32) 空の文字列区切り記号はすべての場所で見つかるため、文字列を 1 文字の文字列の配列に分割します。次の例では、文字列 "characters" を入力文字列内の要素と同じ数の要素に分割します。 null 文字列は入力文字列の先頭と一致するため、返される配列の先頭に null 文字列が挿入されます。これにより、10 番目の要素は、入力文字列の末尾にある 2 つの文字で構成されます。

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "characters"
      Dim regex As New Regex("")
      Dim substrings() As String = regex.Split(input, input.Length)
      Console.Write("{")
      For ctr As Integer = 0 to substrings.Length - 1
         Console.Write(substrings(ctr))
         if ctr < substrings.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine("}")
   End Sub
End Module
' The example displays the following output:   
'    {, c, h, a, r, a, c, t, e, rs}

こちらもご覧ください

正規表現言語 - クイックリファレンス

適用対象

Split(String, String)

Source:: Regex.Split.cs

Source:: Regex.Split.cs

Source:: Regex.Split.cs

正規表現パターンによって定義されている位置で、入力文字列を部分文字列の配列に分割します。

public:
 static cli::array <System::String ^> ^ Split(System::String ^ input, System::String ^ pattern);

public static string[] Split (string input, string pattern);

static member Split : string * string -> string[]

Public Shared Function Split (input As String, pattern As String) As String()

パラメーター

input: String

分割する文字列。

pattern: String

一致させる正規表現パターン。

戻り値

String[]

文字列の配列。

例外

ArgumentException

正規表現の解析エラーが発生しました。

ArgumentNullException

input または pattern が null です。

RegexMatchTimeoutException

タイムアウトが発生しました。タイムアウトの詳細については、「解説」をご覧ください。

注釈

メソッドは Regex.Split メソッドに String.Split 似ていますが、文字列は Regex.Split 一連の文字ではなく正規表現によって決定される区切り記号で分割される点が除きます。文字列は input できるだけ多くの回数分割されます。が文字列内にinput見つからない場合pattern、戻り値には、値が元inputの文字列である要素が 1 つ含まれます。

パラメーターは pattern 、一致する文字列をシンボル的に記述する正規表現言語要素で構成されます。正規表現の詳細については、「 .NET 正規表現と正規表現言語 - クイックリファレンス」を参照してください。

重要

静的 Split メソッドの呼び出しで使用されるコンパイル済みの正規表現は、自動的にキャッシュされます。コンパイルされた正規表現の有効期間を自分で管理するには、インスタンス Split メソッドを使用します。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "plum--pear";
      string pattern = "-";            // Split on hyphens
      
      string[] substrings = Regex.Split(input, pattern);
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// The method displays the following output:
//    'plum'
//    ''
//    'pear'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "plum--pear"
      Dim pattern As String = "-"          ' Split on hyphens
      
      Dim substrings() As String = Regex.Split(input, pattern)
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub  
End Module
' The example displays the following output:
'    'plum'
'    ''
'    'pear'

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"\d+";
      string input = "123ABCDE456FGHIJKL789MNOPQ012";
      string[] result = Regex.Split(input, pattern);
      for (int ctr = 0; ctr < result.Length; ctr++) {
         Console.Write("'{0}'", result[ctr]);
         if (ctr < result.Length - 1) 
            Console.Write(", ");
      }
      Console.WriteLine();
   }
}
// The example displays the following output:
//       '', 'ABCDE', 'FGHIJKL', 'MNOPQ', ''

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "\d+"
      Dim input As String = "123ABCDE456FGHIJKL789MNOPQ012"
      Dim result() As String = Regex.Split(input, pattern)
      For ctr As Integer = 0 To result.Length - 1
         Console.Write("'{0}'", result(ctr))
         If ctr < result.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine()
   End Sub               
End Module
' The example displays the following output:
'       '', 'ABCDE', 'FGHIJKL', 'MNOPQ', ''

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "plum-pear";
      string pattern = "(-)";

      string[] substrings = Regex.Split(input, pattern);    // Split on hyphens
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// The example displays the following output:
//    'plum'
//    '-'
//    'pear'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "plum-pear"
      Dim pattern As String = "(-)" 
      
      Dim substrings() As String = Regex.Split(input, pattern)    ' Split on hyphens.
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub
End Module
' The method writes the following to the console:
'    'plum'
'    '-'
'    'pear'

ただし、正規表現パターンにキャプチャかっこの複数のセットが含まれている場合、このメソッドの動作は.NET Frameworkのバージョンによって異なります。 .NET Framework 1.0 と 1.1 では、キャプチャかっこの最初のセット内に一致が見つからない場合、追加のキャプチャかっこからキャプチャされたテキストは、返される配列には含まれません。 .NET Framework 2.0 以降では、キャプチャされたすべてのテキストも返される配列に追加されます。たとえば、次のコードでは、かっこをキャプチャする 2 つのセットを使用して、日付文字列から日付区切り記号を含む日付の要素を抽出します。かっこをキャプチャする最初のセットはハイフンをキャプチャし、2 番目のセットはスラッシュをキャプチャします。コード例がコンパイルされ、.NET Framework 1.0 または 1.1 で実行される場合、スラッシュ文字は除外されます。コンパイルされ、.NET Framework 2.0 以降のバージョンで実行される場合は、それらの文字が含まれます。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = @"07/14/2007";   
      string pattern = @"(-)|(/)";

      foreach (string result in Regex.Split(input, pattern)) 
      {
         Console.WriteLine("'{0}'", result);
      }
   }
}
// In .NET 1.0 and 1.1, the method returns an array of
// 3 elements, as follows:
//    '07'
//    '14'
//    '2007'
//
// In .NET 2.0 and later, the method returns an array of
// 5 elements, as follows:
//    '07'
//    '/'
//    '14'
//    '/'
//    '2007'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "07/14/2007"   
      Dim pattern As String = "(-)|(/)"
      For Each result As String In Regex.Split(input, pattern) 
         Console.WriteLine("'{0}'", result)
      Next
   End Sub
End Module
' In .NET 1.0 and 1.1, the method returns an array of
' 3 elements, as follows:
'    '07'
'    '14'
'    '2007'
'
' In .NET 2.0 and later, the method returns an array of
' 5 elements, as follows:
'    '07'
'    '/'
'    '14'
'    '/'
'    '2007'

正規表現が空の文字列と一致する場合、 Split 空の文字列区切り記号はすべての場所で見つかるため、文字列を 1 文字の文字列の配列に分割します。次に例を示します。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "characters";
      string[] substrings = Regex.Split(input, "");
      Console.Write("{");
      for(int ctr = 0; ctr < substrings.Length; ctr++)
      {
         Console.Write("'{0}'", substrings[ctr]);
         if (ctr < substrings.Length - 1)
            Console.Write(", ");
      }
      Console.WriteLine("}");
   }
}
// The example produces the following output:   
//    {'', 'c', 'h', 'a', 'r', 'a', 'c', 't', 'e', 'r', 's', ''}

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "characters"
      Dim substrings() As String = Regex.Split(input, "")
      Console.Write("{")
      For ctr As Integer = 0 to substrings.Length - 1
         Console.Write("'{0}'", substrings(ctr))
         If ctr < substrings.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine("}")
   End Sub
End Module
' The example produces the following output:   
'    {'', 'c', 'h', 'a', 'r', 'a', 'c', 't', 'e', 'r', 's', ''}

返される配列には、配列の先頭と末尾に空の文字列も含まれていることに注意してください。

RegexMatchTimeoutException分割操作の実行時間が、メソッドが呼び出されるアプリケーションドメインに指定されたタイムアウト間隔を超えると、例外がスローされます。アプリケーションドメインのプロパティにタイムアウトが定義されていない場合、またはタイムアウト値がの場合は Regex.InfiniteMatchTimeout、例外はスローされません。

注意 (呼び出し元)

このメソッドは、メソッドが呼び出されるアプリケーションドメインの既定のタイムアウト値と等しい間隔の後にタイムアウトします。アプリケーションドメインにタイムアウト値が定義されていない場合は、メソッドのタイムアウトを妨げる値 InfiniteMatchTimeoutが使用されます。パターン一致でテキストを分割するための推奨される静的メソッドはです Split(String, String, RegexOptions, TimeSpan)。これにより、タイムアウト間隔を設定できます。

こちらもご覧ください

正規表現言語要素

適用対象

Split(String, Int32, Int32)

Source:: Regex.Split.cs

Source:: Regex.Split.cs

Source:: Regex.Split.cs

Regex コンストラクターで指定された正規表現で定義されている位置で、入力文字列を指定されている最大回数だけ分割し、部分文字列の配列に格納します。正規表現パターンの検索は、入力文字列の指定した文字位置から開始します。

public:
 cli::array <System::String ^> ^ Split(System::String ^ input, int count, int startat);

public string[] Split (string input, int count, int startat);

member this.Split : string * int * int -> string[]

Public Function Split (input As String, count As Integer, startat As Integer) As String()

パラメーター

input: String

分割対象の文字列。

count: Int32

分割を実行する最大回数。

startat: Int32

入力文字列中で検索を開始する文字位置。

戻り値

String[]

文字列の配列。

例外

ArgumentNullException

input が nullです。

ArgumentOutOfRangeException

startat が 0 未満か、input の長さを超えています。

RegexMatchTimeoutException

タイムアウトが発生しました。タイムアウトの詳細については、「解説」をご覧ください。

注釈

メソッドは Regex.Split メソッドに String.Split 似ていますが、文字列は Regex.Split 一連の文字ではなく正規表現によって決定される区切り記号で分割される点が除きます。パラメーターは count 、文字列が分割される部分文字列の最大数を input 指定します。最後の文字列には、文字列の非split 剰余が含まれます。 count値 0 は、可能な限り複数回分割する既定の動作を提供します。パラメーターは startat 、最初の区切り記号の検索を開始する位置を定義します (先頭の空白をスキップするために使用できます)。

の詳細 startatについては、の「解説」セクション Match(String, Int32)を参照してください。

文字列内の +1 位置から count一致するものが見つからない場合、メソッドは文字列を含む 1 要素の配列を input 返します。 1 つ以上の一致が見つかった場合、返される配列の最初の要素には、最初の文字から一致する前の 1 文字までの文字列の最初の部分が含まれます。

複数の一致が互いに隣接しており、検出された一致の数が少なくとも 2 つ未満 countの場合は、空の文字列が配列に挿入されます。同様に、文字列の最初の文字であるで startat一致が見つかった場合、返される配列の最初の要素は空の文字列です。つまり、隣接する一致に起因する空の文字列は、一致する部分文字列の数がと等しい countかどうかを判断する際にカウントされます。次の例では、正規表現 \d+ を使用して文字列内の数値の最初の部分文字列の開始位置を検索し、その位置から最大 3 回文字列を分割します。正規表現パターンは入力文字列の先頭と一致するため、返される文字列配列は空の文字列、5 文字のアルファベット文字列、および文字列の残りの部分で構成されます。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = @"\d+";
      Regex rgx = new Regex(pattern);
      string input = "123ABCDE456FGHIJ789KLMNO012PQRST";
      Match m = rgx.Match(input);
      if (m.Success) { 
         int startAt = m.Index;
         string[] result = rgx.Split(input, 3, startAt);
         for (int ctr = 0; ctr < result.Length; ctr++) {
            Console.Write("'{0}'", result[ctr]);
            if (ctr < result.Length - 1)
               Console.Write(", ");
         }
         Console.WriteLine();
      }
   }
}
// The example displays the following output:
//       '', 'ABCDE', 'FGHIJKL789MNOPQ012'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "\d+"
      Dim rgx As New Regex(pattern)
      Dim input As String = "123ABCDE456FGHIJ789KLMNO012PQRST"
      Dim m As Match = rgx.Match(input)
      If m.Success Then 
         Dim startAt As Integer = m.Index
         Dim result() As String = rgx.Split(input, 3, startAt)
         For ctr As Integer = 0 To result.Length - 1
            Console.Write("'{0}'", result(ctr))
            If ctr < result.Length - 1 Then Console.Write(", ")
         Next
         Console.WriteLine()
      End If
   End Sub               
End Module
' The example displays the following output:
'       '', 'ABCDE', 'FGHIJKL789MNOPQ012'

かっこのキャプチャが正規表現で使用されている場合、キャプチャされたテキストはすべて分割文字列の配列に含まれます。ただし、キャプチャされたテキストを含む配列要素は、一致の数がに達した countかどうかを判断する際にカウントされません。たとえば、次のコードに示すように、文字列 '"apple-apricot-plum-pear-pomegranate-banana-peach" を文字列の文字 15 から始まる最大 4 つの部分文字列に分割すると、7 要素の配列になります。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = "(-)";
      string input = "apple-apricot-plum-pear-pomegranate-pineapple-peach";

      // Split on hyphens from 15th character on
      Regex regex = new Regex(pattern);    
      // Split on hyphens from 15th character on
      string[] substrings = regex.Split(input, 4, 15);
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// The method writes the following to the console:
//    'apple-apricot-plum'
//    '-'
//    'pear'
//    '-'
//    'pomegranate'
//    '-'
//    'pineapple-peach'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "(-)"
      Dim input As String = "apple-apricot-plum-pear-pomegranate-pineapple-peach"

      Dim regex As Regex = New Regex(pattern)    
      ' Split on hyphens from 15th character on
      Dim substrings() As String = regex.Split(input, 4, 15)
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub  
End Module
' The example displays the following output:
'    'apple-apricot-plum'
'    '-'
'    'pear'
'    '-'
'    'pomegranate'
'    '-'
'    'pineapple-peach'

ただし、正規表現パターンにキャプチャかっこの複数のセットが含まれている場合、このメソッドの動作は.NET Frameworkのバージョンによって異なります。 .NET Framework 1.0 および 1.1 では、キャプチャかっこの最初のセット内に一致が見つからない場合、追加のキャプチャかっこからキャプチャされたテキストは、返される配列に含まれません。 .NET Framework 2.0 以降では、キャプチャされたすべてのテキストも返される配列に追加されます。たとえば、次のコードでは、かっこをキャプチャする 2 つのセットを使用して、文字列内の個々の単語を抽出します。かっこをキャプチャする最初のセットはハイフンをキャプチャし、2 番目のセットは垂直バーをキャプチャします。サンプルコードがコンパイルされ、.NET Framework 1.0 または 1.1 で実行される場合、垂直バー文字は除外されます。コンパイルされ、.NET Framework 2.0 以降のバージョンで実行される場合は、それらの文字が含まれます。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = "(-)|([|])";     // possible delimiters found in string
      string input = "apple|apricot|plum|pear|pomegranate|pineapple|peach";

      Regex regex = new Regex(pattern);    
      // Split on delimiters from 15th character on
      string[] substrings = regex.Split(input, 4, 15);
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// In .NET 2.0 and later, the method returns an array of
// 7 elements, as follows:
//    apple|apricot|plum'
//    '|'
//    'pear'
//    '|'
//    'pomegranate'
//    '|'
//    'pineapple|peach'
// In .NET 1.0 and 1.1, the method returns an array of
// 4 elements, as follows:
//    'apple|apricot|plum'
//    'pear'
//    'pomegranate'
//    'pineapple|peach'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "(-)|([|])"   ' possible delimiters found in string
      Dim input As String = "apple|apricot|plum|pear|pomegranate|pineapple|peach"

      Dim regex As Regex = New Regex(pattern)    
      ' Split on delimiters from 15th character on
      Dim substrings() As String = regex.Split(input, 4, 15)
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub
End Module
' In .NET 2.0, the method returns an array of
' 7 elements, as follows:
'    apple|apricot|plum'
'    '|'
'    'pear'
'    '|'
'    'pomegranate'
'    '|'
'    'pineapple|peach'
' In .NET 1.0 and 1.1, the method returns an array of
' 4 elements, as follows:
'    'apple|apricot|plum'
'    'pear'
'    'pomegranate'
'    'pineapple|peach'

正規表現が空の文字列と一致する場合、 Split 空の文字列区切り記号はすべての場所で見つかるため、文字列を 1 文字の文字列の配列に分割します。次の例では、文字列 "characters" を、入力文字列に含まれる数の要素 (文字 "a" から始まる) に分割します。 null 文字列は入力文字列の末尾と一致するため、返された配列の末尾に null 文字列が挿入されます。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "characters";
      Regex regex = new Regex("");
      string[] substrings = regex.Split(input, input.Length, input.IndexOf("a"));
      Console.Write("{");
      for(int ctr = 0; ctr < substrings.Length; ctr++)
      {
         Console.Write(substrings[ctr]);
         if (ctr < substrings.Length - 1)
            Console.Write(", ");
      }
      Console.WriteLine("}");
   }
}
// The example displays the following output:   
//    {, c, h, a, r, a, c, t, e, rs}

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "characters"
      Dim regex As New Regex("")
      Dim substrings() As String = regex.Split(input, input.Length, _
                                               input.IndexOf("a"))
      Console.Write("{")
      For ctr As Integer = 0 to substrings.Length - 1
         Console.Write(substrings(ctr))
         If ctr < substrings.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine("}")
   End Sub
End Module
' The example produces the following output:   
'    {, c, h, a, r, a, c, t, e, rs}

こちらもご覧ください

正規表現言語 - クイックリファレンス

適用対象

Split(String, String, RegexOptions)

Source:: Regex.Split.cs

Source:: Regex.Split.cs

Source:: Regex.Split.cs

指定された正規表現パターンによって定義されている位置で、入力文字列を部分文字列の配列に分割します。指定したオプションで、一致操作を変更します。

public:
 static cli::array <System::String ^> ^ Split(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);

public static string[] Split (string input, string pattern, System.Text.RegularExpressions.RegexOptions options);

static member Split : string * string * System.Text.RegularExpressions.RegexOptions -> string[]

Public Shared Function Split (input As String, pattern As String, options As RegexOptions) As String()

パラメーター

input: String

分割する文字列。

pattern: String

一致させる正規表現パターン。

options: RegexOptions

一致オプションを指定する列挙値のビットごとの組み合わせ。

戻り値

String[]

文字列の配列。

例外

ArgumentException

正規表現の解析エラーが発生しました。

ArgumentNullException

input または pattern が null です。

ArgumentOutOfRangeException

options は、RegexOptions 値のビットごとの正しい組み合わせではありません。

RegexMatchTimeoutException

タイムアウトが発生しました。タイムアウトの詳細については、「解説」をご覧ください。

注釈

メソッドは Regex.Split メソッドに String.Split(Char[]) 似ていますが、文字列は Regex.Split 一連の文字ではなく正規表現によって決定される区切り記号で分割される点が除きます。文字列はできるだけ多くの回数分割されます。区切り記号が見つからない場合、戻り値には、値が元 input の文字列である 1 つの要素が含まれます。

パラメーターは pattern 、一致する文字列を記号的に記述する正規表現言語要素で構成されます。正規表現の詳細については、「.NET 正規表現と正規表現言語 - クイックリファレンス」を参照してください。

重要

複数の一致が互いに隣接している場合は、空の文字列が配列に挿入されます。たとえば、1 つのハイフンで文字列を分割すると、返される配列に 2 つの隣接するハイフンが見つかった位置に空の文字列が含まれます。

入力文字列の先頭または末尾に一致が見つかった場合は、返される配列の先頭または末尾に空の文字列が含まれます。次の例では、正規表現パターン [a-z]+ を使用して、入力文字列を大文字または小文字のアルファベット文字で分割します。文字列は一致する英字で始まり、終わるので、返される配列の最初の要素と最後の要素の値はです String.Empty。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = "[a-z]+";
      string input = "Abc1234Def5678Ghi9012Jklm";
      string[] result = Regex.Split(input, pattern, 
                                    RegexOptions.IgnoreCase);
      for (int ctr = 0; ctr < result.Length; ctr++) {
         Console.Write("'{0}'", result[ctr]);
         if (ctr < result.Length - 1) 
            Console.Write(", ");
      }
      Console.WriteLine();
   }
}
// The example displays the following output:
//       '', '1234', '5678', '9012', ''

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "[a-z]+"
      Dim input As String = "Abc1234Def5678Ghi9012Jklm"
      Dim result() As String = Regex.Split(input, pattern, 
                                           RegexOptions.IgnoreCase)
      For ctr As Integer = 0 To result.Length - 1
         Console.Write("'{0}'", result(ctr))
         If ctr < result.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine()
   End Sub               
End Module
' The example displays the following output:
'       '', '1234', '5678', '9012', ''

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "plum-pear";
      string pattern = "(-)";

      string[] substrings = Regex.Split(input, pattern);    // Split on hyphens
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// The example displays the following output:
//    'plum'
//    '-'
//    'pear'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "plum-pear"
      Dim pattern As String = "(-)" 
      
      Dim substrings() As String = Regex.Split(input, pattern)    ' Split on hyphens.
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub
End Module
' The method writes the following to the console:
'    'plum'
'    '-'
'    'pear'

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = @"07/14/2007";   
      string pattern = @"(-)|(/)";

      foreach (string result in Regex.Split(input, pattern)) 
      {
         Console.WriteLine("'{0}'", result);
      }
   }
}
// In .NET 1.0 and 1.1, the method returns an array of
// 3 elements, as follows:
//    '07'
//    '14'
//    '2007'
//
// In .NET 2.0 and later, the method returns an array of
// 5 elements, as follows:
//    '07'
//    '/'
//    '14'
//    '/'
//    '2007'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "07/14/2007"   
      Dim pattern As String = "(-)|(/)"
      For Each result As String In Regex.Split(input, pattern) 
         Console.WriteLine("'{0}'", result)
      Next
   End Sub
End Module
' In .NET 1.0 and 1.1, the method returns an array of
' 3 elements, as follows:
'    '07'
'    '14'
'    '2007'
'
' In .NET 2.0 and later, the method returns an array of
' 5 elements, as follows:
'    '07'
'    '/'
'    '14'
'    '/'
'    '2007'

正規表現が空の文字列と一致する場合、 Split 空の文字列区切り記号はすべての場所で見つかるため、文字列を 1 文字の文字列の配列に分割します。

注意 (呼び出し元)

このメソッドは、メソッドが呼び出されるアプリケーションドメインの既定のタイムアウト値と等しい間隔の後にタイムアウトします。アプリケーションドメインに対してタイムアウト値が定義されていない場合は、メソッドのタイムアウトを妨げる値 InfiniteMatchTimeoutが使用されます。パターン一致でテキストを分割するための推奨される静的メソッドはです Split(String, String, RegexOptions, TimeSpan)。これにより、タイムアウト間隔を設定できます。

こちらもご覧ください

正規表現言語要素

適用対象

Split(String, String, RegexOptions, TimeSpan)

Source:: Regex.Split.cs

Source:: Regex.Split.cs

Source:: Regex.Split.cs

指定された正規表現パターンによって定義されている位置で、入力文字列を部分文字列の配列に分割します。追加のパラメーターでは、一致が見つからない場合に一致操作とタイムアウト間隔を変更するオプションを指定します。

public:
 static cli::array <System::String ^> ^ Split(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);

public static string[] Split (string input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

static member Split : string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> string[]

Public Shared Function Split (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As String()

パラメーター

input: String

分割する文字列。

pattern: String

一致させる正規表現パターン。

options: RegexOptions

一致オプションを指定する列挙値のビットごとの組み合わせ。

matchTimeout: TimeSpan

タイムアウト期間、またはメソッドがタイムアウトしないことを示す InfiniteMatchTimeout。

戻り値

String[]

文字列配列。

例外

ArgumentException

正規表現の解析エラーが発生しました。

ArgumentNullException

input または pattern が null です。

ArgumentOutOfRangeException

options は、RegexOptions 値のビットごとの正しい組み合わせではありません。

- または -

matchTimeout が負の値か、0 か、または約 24 日を超えています。

RegexMatchTimeoutException

タイムアウトが発生しました。タイムアウトの詳細については、「解説」をご覧ください。

注釈

重要

静的 Split メソッドの呼び出しで使用されるコンパイルされた正規表現は、自動的にキャッシュされます。コンパイルされた正規表現の有効期間を自分で管理するには、インスタンス Split メソッドを使用します。

複数の一致が互いに隣接している場合は、空の文字列が配列に挿入されます。たとえば、1 つのハイフンで文字列を分割すると、返される配列には、隣接する 2 つのハイフンが見つかった位置に空の文字列が含まれます。

入力文字列の先頭または末尾に一致が見つかった場合は、返される配列の先頭または末尾に空の文字列が含まれます。次の例では、正規表現パターン [a-z]+ を使用して、大文字または小文字のアルファベット文字で入力文字列を分割します。文字列は一致する英字で始まり、終わるので、返される配列の最初の要素と最後の要素の値はです String.Empty。

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string pattern = "[a-z]+";
      string input = "Abc1234Def5678Ghi9012Jklm";
      string[] result = Regex.Split(input, pattern, 
                                    RegexOptions.IgnoreCase,
                                    TimeSpan.FromMilliseconds(500));
      for (int ctr = 0; ctr < result.Length; ctr++) {
         Console.Write("'{0}'", result[ctr]);
         if (ctr < result.Length - 1) 
            Console.Write(", ");
      }
      Console.WriteLine();
   }
}
// The example displays the following output:
//       '', '1234', '5678', '9012', ''

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "[a-z]+"
      Dim input As String = "Abc1234Def5678Ghi9012Jklm"
      Dim result() As String = Regex.Split(input, pattern, 
                                           RegexOptions.IgnoreCase,
                                           TimeSpan.FromMilliseconds(500))
      For ctr As Integer = 0 To result.Length - 1
         Console.Write("'{0}'", result(ctr))
         If ctr < result.Length - 1 Then Console.Write(", ")
      Next
      Console.WriteLine()
   End Sub               
End Module
' The example displays the following output:
'       '', '1234', '5678', '9012', ''

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = "plum-pear";
      string pattern = "(-)";

      string[] substrings = Regex.Split(input, pattern);    // Split on hyphens
      foreach (string match in substrings)
      {
         Console.WriteLine("'{0}'", match);
      }
   }
}
// The example displays the following output:
//    'plum'
//    '-'
//    'pear'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "plum-pear"
      Dim pattern As String = "(-)" 
      
      Dim substrings() As String = Regex.Split(input, pattern)    ' Split on hyphens.
      For Each match As String In substrings
         Console.WriteLine("'{0}'", match)
      Next
   End Sub
End Module
' The method writes the following to the console:
'    'plum'
'    '-'
'    'pear'

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string input = @"07/14/2007";   
      string pattern = @"(-)|(/)";

      foreach (string result in Regex.Split(input, pattern)) 
      {
         Console.WriteLine("'{0}'", result);
      }
   }
}
// In .NET 1.0 and 1.1, the method returns an array of
// 3 elements, as follows:
//    '07'
//    '14'
//    '2007'
//
// In .NET 2.0 and later, the method returns an array of
// 5 elements, as follows:
//    '07'
//    '/'
//    '14'
//    '/'
//    '2007'

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "07/14/2007"   
      Dim pattern As String = "(-)|(/)"
      For Each result As String In Regex.Split(input, pattern) 
         Console.WriteLine("'{0}'", result)
      Next
   End Sub
End Module
' In .NET 1.0 and 1.1, the method returns an array of
' 3 elements, as follows:
'    '07'
'    '14'
'    '2007'
'
' In .NET 2.0 and later, the method returns an array of
' 5 elements, as follows:
'    '07'
'    '/'
'    '14'
'    '/'
'    '2007'

正規表現が空の文字列と一致する場合、 Split 空の文字列区切り記号はすべての場所で見つかるため、文字列を 1 文字の文字列の配列に分割します。

パラメーターは matchTimeout 、パターンマッチングメソッドがタイムアウトするまでに一致を検索する期間を指定します。タイムアウト間隔を設定すると、過剰なバックトラッキングに依存する正規表現が、近い一致を含む入力を処理するときに応答を停止するように見えなくなります。詳細については、「正規表現とバックトラッキングのベストプラクティス」を参照してください。その時間間隔で一致するものが見つからない場合、メソッドは例外を RegexMatchTimeoutException スローします。 matchTimeout は、メソッドが実行されるアプリケーションドメインに対して定義されている既定のタイムアウト値をオーバーライドします。

注意 (呼び出し元)

パラメーターを適切な値 (2 秒など) に設定 matchTimeout することをお勧めします。を指定してタイムアウトを InfiniteMatchTimeout無効にすると、正規表現エンジンのパフォーマンスが若干向上します。ただし、タイムアウトは次の条件でのみ無効にする必要があります。

正規表現によって処理される入力が既知の信頼できるソースから派生した場合、または静的テキストで構成されている場合。これにより、ユーザーによって動的に入力されたテキストが除外されます。
正規表現パターンが十分にテストされ、一致、一致しない、近い一致が効率的に処理されるようにする場合。
正規表現パターンに、近い一致を処理するときに過剰なバックトラッキングを引き起こすことがわかっている言語要素が含まれない場合。

こちらもご覧ください

正規表現言語要素

適用対象

Regex.Split メソッド

定義

オーバーロード

Split(String)

パラメーター

戻り値

例外

注釈

こちらもご覧ください

適用対象

Split(String, Int32)

パラメーター

戻り値

例外

注釈

こちらもご覧ください

適用対象

Split(String, String)

パラメーター

戻り値

例外

注釈

注意 (呼び出し元)

こちらもご覧ください

適用対象

Split(String, Int32, Int32)

パラメーター

戻り値

例外

注釈

こちらもご覧ください

適用対象

Split(String, String, RegexOptions)

パラメーター

戻り値

例外

注釈

注意 (呼び出し元)

こちらもご覧ください

適用対象

Split(String, String, RegexOptions, TimeSpan)

パラメーター

戻り値

例外

注釈

注意 (呼び出し元)

こちらもご覧ください

適用対象

フィードバック

その他のリソース