String.Splitとは？ わかりやすく解説

.NET Framework クラス ライブラリ リファレンス
索引トップ 用語の索引 ランキング
日本マイクロソフト株式会社日本マイクロソフト株式会社

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

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Visual Basic (宣言)
<ComVisibleAttribute(False)> _
Public Function Split ( _
    separator As String(), _
    count As Integer, _
    options As StringSplitOptions _
) As String()
Visual Basic (使用法)
Dim instance As String
Dim separator As String()
Dim count As Integer
Dim options As StringSplitOptions
Dim returnValue As String()

returnValue = instance.Split(separator, count, options)
C#
[ComVisibleAttribute(false)] 
public string[] Split (
    string[] separator,
    int count,
    StringSplitOptions options
)
C++
[ComVisibleAttribute(false)] 
public:
array<String^>^ Split (
    array<String^>^ separator, 
    int count, 
    StringSplitOptions options
)
J#
/** @attribute ComVisibleAttribute(false) */ 
public String[] Split (
    String[] separator, 
    int count, 
    StringSplitOptions options
)
JScript
ComVisibleAttribute(false) 
public function Split (
    separator : String[], 
    count : int, 
    options : StringSplitOptions
) : String[]

パラメータ

separator

この文字列から部分文字列を取り出すために区切り文字として使用する文字列の配列、区切り文字が含まれていない空の配列、または null 参照 (Visual Basic では Nothing)。

count

返される最大の部分文字列数。

options

返される配列で空の要素を省略する場合は RemoveEmptyEntries。返される配列に空の要素も含める場合は None。

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

例外例外
例外の種類条件

ArgumentOutOfRangeException

count が負の値です。

ArgumentException

options が StringSplitOptions 値ではありません。

解説解説
戻り値に関する情報

戻り値の配列要素に区切り記号文字列は含まれません。区切り記号は、序数に基づく比較を使用して検出されます。

このインスタンスに、separator に指定されたいずれの文字列も含まれていなかった場合、戻り値の配列には、そのインスタンス自体を保持する要素が 1 つだけ格納されます。separator パラメータが null 参照 (Visual Basic では Nothing) の場合または文字が含まれていなかった場合、区切り記号に空白文字が指定されたものとして実行されます。

count パラメータがゼロの場合、または、options パラメータが RemoveEmptyEntries で、このインスタンスの長さがゼロの場合、空の配列が返されます。

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

このインスタンスに count を超える部分文字列が含まれていた場合、count - 1 番目にある最初の部分文字列が、戻り値の count - 1 番目の最初の要素として返されます。このインスタンスに含まれるそれ以外の文字は、戻り値の最後の要素として返されます。

count が部分文字列の数よりも多い場合、取り出せるだけの部分文字列が返され、例外はスローされません。

比較に関する情報

Split メソッドは、この文字列を、separator パラメータで指定された 1 つまたは複数の文字列で区切ることによって部分文字列を抽出し、これらの部分文字列を配列の要素として返します。

Split メソッドが区切り記号を検索する際の比較処理では、大文字と小文字は区別され、序数の並べ替え規則が使用されます。単語、文字列、序数の並べ替えの詳細については、System.Globalization.CompareOptions 列挙値のトピックを参照してください。

Split メソッドでは、値が null 参照 (Visual Basic では Nothing) または空の文字列 ("") である separator の要素は無視されます。

separator に格納された複数の文字列に共通の文字が使用されていた場合にあいまいな結果が生じるのを防ぐため、Split メソッドは、対象のインスタンスの値を先頭から最後まで解析し、separator 内の要素と最初に一致した要素を区切り文字として使用します。インスタンスにおける部分文字列の出現順が、separator における要素の格納順よりも優先されます。

たとえば、値が "abcdef" であるインスタンスがあるとします。separator の 1 つ目の要素が "ef"、2 つ目の要素が "bcde" であった場合、分割処理の結果は "a" と "f" になります。インスタンス内の部分文字列 "bcde" が、部分文字列 "f" よりも先に separator 内の要素と一致するためです。

ただし、separator の 1 つ目の要素が "bcd" で、2 つ目の要素が "bc" であった場合、分割処理の結果は "a" と "ef" になります。これは、"bcd" が、separator に格納された要素のうち、インスタンス内の区切り記号と一致する最初の要素であるためです。separator に格納された要素の順序が逆だった場合、つまり、1 つ目の要素が "bc" で、2 つ目の要素が "bcd" であった場合、分割処理の結果は "a" と "def" となります。

使用例使用例

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

Visual Basic
' This example demonstrates the String() methods that use
' the StringSplitOptions enumeration.
Imports System

Class Sample
    Public Shared Sub Main()
 
        Dim s1 As String
 = ",ONE,,TWO,,,THREE,,"
        Dim s2 As String
 = "[stop]" & _
                           "ONE[stop][stop]" &
 _
                           "TWO[stop][stop][stop]"
 & _
                           "THREE[stop][stop]"
        Dim charSeparators() As Char
 = {","c}
        Dim stringSeparators() As String
 = {"[stop]"}
        Dim result() As String
        ' ------------------------------------------------------------------------------
        ' Split a string delimited by characters.
        ' ------------------------------------------------------------------------------
        Console.WriteLine("1) Split a string delimited by characters:"
 & vbCrLf)
        
        ' Display the original string and delimiter characters.
        Console.WriteLine("1a )The original string is ""{0}"".",
 s1)
        Console.WriteLine("The delimiter character is '{0}'."
 & vbCrLf, charSeparators(0))
        
        ' Split a string delimited by characters and return all elements.
        Console.WriteLine("1b) Split a string delimited by characters
 and " & _
                          "return all elements:")
        result = s1.Split(charSeparators, StringSplitOptions.None)
        Show(result)
        
        ' Split a string delimited by characters and return all non-empty
 elements.
        Console.WriteLine("1c) Split a string delimited by characters
 and " & _
                          "return all non-empty elements:")
        result = s1.Split(charSeparators, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
        
        ' Split the original string into the string and empty string
 before the 
        ' delimiter and the remainder of the original string after the
 delimiter.
        Console.WriteLine("1d) Split a string delimited by characters
 and " & _
                          "return 2 elements:")
        result = s1.Split(charSeparators, 2, StringSplitOptions.None)
        Show(result)
        
        ' Split the original string into the string after the delimiter
 and the 
        ' remainder of the original string after the delimiter.
        Console.WriteLine("1e) Split a string delimited by characters
 and " & _
                          "return 2 non-empty elements:")
        result = s1.Split(charSeparators, 2, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
        
        ' ------------------------------------------------------------------------------
        ' Split a string delimited by another string.
        ' ------------------------------------------------------------------------------
        Console.WriteLine("2) Split a string delimited by another
 string:" & vbCrLf)
        
        ' Display the original string and delimiter string.
        Console.WriteLine("2a) The original string is ""{0}"".",
 s2)
        Console.WriteLine("The delimiter string is ""{0}""."
 & vbCrLf, stringSeparators(0))
        
        ' Split a string delimited by another string and return all
 elements.
        Console.WriteLine("2b) Split a string delimited by another
 string and " & _
                          "return all elements:")
        result = s2.Split(stringSeparators, StringSplitOptions.None)
        Show(result)
        
        ' Split the original string at the delimiter and return all
 non-empty elements.
        Console.WriteLine("2c) Split a string delimited by another
 string and " & _
                          "return all non-empty elements:")
        result = s2.Split(stringSeparators, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
        
        ' Split the original string into the empty string before the
 
        ' delimiter and the remainder of the original string after the
 delimiter.
        Console.WriteLine("2d) Split a string delimited by another
 string and " & _
                          "return 2 elements:")
        result = s2.Split(stringSeparators, 2, StringSplitOptions.None)
        Show(result)
        
        ' Split the original string into the string after the delimiter
 and the 
        ' remainder of the original string after the delimiter.
        Console.WriteLine("2e) Split a string delimited by another
 string and " & _
                          "return 2 non-empty elements:")
        result = s2.Split(stringSeparators, 2, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
    
    End Sub 'Main
    
    
    ' Display the array of separated strings.
    Public Shared Sub Show(ByVal
 entries() As String) 
        Console.WriteLine("The return value contains these {0}
 elements:", entries.Length)
        Dim entry As String
        For Each entry In
  entries
            Console.Write("<{0}>", entry)
        Next entry
        Console.Write(vbCrLf & vbCrLf)
    
    End Sub 'Show
End Class 'Sample
'
'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>
'
'1d) Split a string delimited by characters and return 2 elements:
'The return value contains these 2 elements:
'<><ONE,,TWO,,,THREE,,>
'
'1e) Split a string delimited by characters and return 2 non-empty elements:
'The return value contains these 2 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>
'
'2d) Split a string delimited by another string and return 2 elements:
'The return value contains these 2 elements:
'<><ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]>
'
'2e) Split a string delimited by another string and return 2 non-empty
 elements:
'The return value contains these 2 elements:
'<ONE><TWO[stop][stop][stop]THREE[stop][stop]>
'
C#
// This example demonstrates the String() methods that use
// the StringSplitOptions enumeration.
using System;

class Sample 
{
    public static void Main()
 
    {
    string s1 = ",ONE,,TWO,,,THREE,,";
    string s2 = "[stop]" +
                "ONE[stop][stop]" +
                "TWO[stop][stop][stop]" +
                "THREE[stop][stop]";
    char[] charSeparators = new char[]
 {','};
    string[] stringSeparators = new string[]
 {"[stop]"};
    string[] result;
// ------------------------------------------------------------------------------
// Split a string delimited by characters.
// ------------------------------------------------------------------------------
    Console.WriteLine("1) Split a string delimited by characters:\n");

// Display the original string and delimiter characters.
    Console.WriteLine("1a )The original string is \"{0}\".",
 s1);
    Console.WriteLine("The delimiter character is '{0}'.\n", 
                       charSeparators[0]);

// Split a string delimited by characters and return all elements.
    Console.WriteLine("1b) Split a string delimited by characters
 and " +
                      "return all elements:");
    result = s1.Split(charSeparators, StringSplitOptions.None);
    Show(result);

// Split a string delimited by characters and return all non-empty elements.
    Console.WriteLine("1c) Split a string delimited by characters
 and " +
                      "return all non-empty elements:");
    result = s1.Split(charSeparators, StringSplitOptions.RemoveEmptyEntries);
    Show(result);

// Split the original string into the string and empty string before
 the 
// delimiter and the remainder of the original string after the delimiter.
    Console.WriteLine("1d) Split a string delimited by characters
 and " +
                      "return 2 elements:");
    result = s1.Split(charSeparators, 2, StringSplitOptions.None);
    Show(result);

// Split the original string into the string after the delimiter and
 the 
// remainder of the original string after the delimiter.
    Console.WriteLine("1e) Split a string delimited by characters
 and " +
                      "return 2 non-empty elements:");
    result = s1.Split(charSeparators, 2, StringSplitOptions.RemoveEmptyEntries);
    Show(result);

// ------------------------------------------------------------------------------
// Split a string delimited by another string.
// ------------------------------------------------------------------------------
    Console.WriteLine("2) Split a string delimited by another
 string:\n");

// Display the original string and delimiter string.
    Console.WriteLine("2a) The original string is \"{0}\".",
 s2);
    Console.WriteLine("The delimiter string is \"{0}\".\n",
 stringSeparators[0]);

// Split a string delimited by another string and return all elements.
    Console.WriteLine("2b) Split a string delimited by another
 string and " +
                      "return all elements:");
    result = s2.Split(stringSeparators, StringSplitOptions.None);
    Show(result);

// Split the original string at the delimiter and return all non-empty
 elements.
    Console.WriteLine("2c) Split a string delimited by another
 string and " +
                      "return all non-empty elements:");
    result = s2.Split(stringSeparators, StringSplitOptions.RemoveEmptyEntries);
    Show(result);

// Split the original string into the empty string before the 
// delimiter and the remainder of the original string after the delimiter.
    Console.WriteLine("2d) Split a string delimited by another
 string and " +
                      "return 2 elements:");
    result = s2.Split(stringSeparators, 2, StringSplitOptions.None);
    Show(result);

// Split the original string into the string after the delimiter and
 the 
// remainder of the original string after the delimiter.
    Console.WriteLine("2e) Split a string delimited by another
 string and " + 
                      "return 2 non-empty elements:");
    result = s2.Split(stringSeparators, 2, StringSplitOptions.RemoveEmptyEntries);
    Show(result);
    }

// Display the array of separated strings.
    public static void Show(string[]
 entries)
    {
    Console.WriteLine("The return value contains these {0}
 elements:", entries.Length);
    foreach (string entry in
 entries)
        {
        Console.Write("<{0}>", entry);
        }
    Console.Write("\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>

1d) Split a string delimited by characters and return
 2 elements:
The return value contains these 2 elements:
<><ONE,,TWO,,,THREE,,>

1e) Split a string delimited by characters and return
 2 non-empty elements:
The return value contains these 2 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>

2d) Split a string delimited by another string
 and return 2 elements:
The return value contains these 2 elements:
<><ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]>

2e) Split a string delimited by another string
 and return 2 non-empty elements:
The return value contains these 2 elements:
<ONE><TWO[stop][stop][stop]THREE[stop][stop]>

*/
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
String クラス
String メンバ
System 名前空間

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

このインスタンス内の、指定された Char 配列の要素で区切られた部分文字列を格納する String 配列を返します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Visual Basic (宣言)
Public Function Split ( _
    ParamArray separator As Char()
 _
) As String()
Visual Basic (使用法)
Dim instance As String
Dim separator As Char()
Dim returnValue As String()

returnValue = instance.Split(separator)
C#
public string[] Split (
    params char[] separator
)
C++
public:
array<String^>^ Split (
    ... array<wchar_t>^ separator
)
J#
public String[] Split (
    char[] separator
)
JScript
public function Split (
    ... separator : char[]
) : String[]

パラメータ

separator

このインスタンスでの部分文字列の区切り文字である Unicode 文字の配列、区切り文字が含まれていない空の配列、または null 参照 (Visual Basic では Nothing)。

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

解説解説

戻り値の配列要素に区切り記号文字は含まれません。区切り記号は、序数に基づく比較を使用して検出されます。

このインスタンスに、separator に指定されたいずれの文字も含まれていなかった場合、戻り値の配列には、そのインスタンス自体を保持する要素が 1 つだけ格納されます。separator パラメータが null 参照 (Visual Basic では Nothing) の場合または文字が含まれていなかった場合、区切り記号に空白文字が指定されたものとして実行されます。

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

次に例を示します。

入力

区切り記号

出力

"42, 12, 19"

new Char[] {',', ' '}

{"42", "", "12", "", "19"}

"42..12..19"

new Char[] {'.'}

{"42", "", "12", "", "19"}

"Banana"

new Char[] {'.'}

{"Banana"}

"Darb\nSmarba"

new Char[] {}

{"Darb", "Smarba"}

"Darb\nSmarba"

null

{"Darb", "Smarba"}

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

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

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

使用例使用例

Split メソッドを使用して、文字列をトークン化する方法については、次のコード例を参照してください。

Visual Basic
Imports System

Public Class SplitTest
    
    Public Shared Sub Main()
        Dim words As String
 = "this is a list of words, with: a bit of punctuation."
        Dim split As String()
 = words.Split(New [Char]() {" "c,
 ","c, "."c, ":"c})
                
        Dim s As String
        For Each s In  split
            If s.Trim() <> ""
 Then
                
                Console.WriteLine(s)
            End If
        Next s
    End Sub 'Main
End Class 'SplitTest
C#
using System;

public class SplitTest {
    public static void Main()
 {

        string words = "this is a list
 of words, with: a bit of punctuation.";

        string [] split = words.Split(new Char
 [] {' ', ',', '.', ':'});

        foreach (string s in
 split) {

            if (s.Trim() != "")
                Console.WriteLine(s);
        }
    }
}
C++
using namespace System;
using namespace System::Collections;
int main()
{
   String^ words = "this is a list of words, with: a bit
 of punctuation.";
   array<Char>^chars = {' ',',','->',':'};
   array<String^>^split = words->Split( chars );
   IEnumerator^ myEnum = split->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      String^ s = safe_cast<String^>(myEnum->Current);
      if (  !s->Trim()->Equals( "" ) )
            Console::WriteLine( s );
   }
}
J#
import System.*;

public class SplitTest
{
    public static void main(String[]
 args)
    {
        String words = "this is a list of words, with: a
 bit of punctuation.";
        String split[] = words.Split(new char[]
 { ' ', ',', '.', ':' });

        for (int iCtr = 0; iCtr < split.get_Length();
 iCtr++) {
            String s = (String)split.get_Item(iCtr);
            if (!(s.Trim().Equals(""))) {
                Console.WriteLine(s);
            }
        }
    } //main
} //SplitTest
JScript
import System;

public class SplitTest {
    public static function
 Main() : void  {

        var words : String = "this is
 a list of words, with: a bit of punctuation.";
        var separators : char[] = [' ', ',', '.', ':'];
        var split : String [] = words.Split(separators);

        for (var i : int
 in split) {
            var s : String = split[i];
            if (s.Trim() != "")
                Console.WriteLine(s);
        }
    }
}
SplitTest.Main();
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0
参照参照
関連項目
String クラス
String メンバ
System 名前空間
Char 構造体
Concat
Insert
Join
Remove
Replace
Substring
Trim

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

このインスタンス内の、指定された Char 配列の要素で区切られた部分文字列を格納する String 配列を返します。パラメータには、取得する部分文字列の最大数を指定します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Visual Basic (宣言)
Public Function Split ( _
    separator As Char(), _
    count As Integer _
) As String()
Visual Basic (使用法)
Dim instance As String
Dim separator As Char()
Dim count As Integer
Dim returnValue As String()

returnValue = instance.Split(separator, count)
C#
public string[] Split (
    char[] separator,
    int count
)
C++
public:
array<String^>^ Split (
    array<wchar_t>^ separator, 
    int count
)
J#
public String[] Split (
    char[] separator, 
    int count
)
JScript
public function Split (
    separator : char[], 
    count : int
) : String[]

パラメータ

separator

このインスタンスでの部分文字列の区切り文字である Unicode 文字の配列、区切り文字が含まれていない空の配列、または null 参照 (Visual Basic では Nothing)。

count

返される最大の部分文字列数。

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

例外例外
例外の種類条件

ArgumentOutOfRangeException

count が負の値です。

解説解説

戻り値の配列要素に区切り記号文字は含まれません。区切り記号は、序数に基づく比較を使用して検出されます。

このインスタンスに、separator に指定されたいずれの文字も含まれていなかった場合、戻り値の配列には、そのインスタンス自体を保持する要素が 1 つだけ格納されます。separator パラメータが null 参照 (Visual Basic では Nothing) の場合または文字が含まれていなかった場合、区切り記号に空白文字が指定されたものとして実行されます。count がゼロの場合、空の配列が返されます。

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

このインスタンスに count を超える部分文字列が含まれていた場合、count - 1 番目にある最初の部分文字列が、戻り値の count - 1 番目の最初の要素として返されます。このインスタンスに含まれるそれ以外の文字は、戻り値の最後の要素として返されます。

count が部分文字列の数よりも多い場合、取り出せるだけの部分文字列が返され、例外はスローされません。

次に例を示します。

入力

区切り記号、カウント

出力

"42, 12, 19"

new Char[] {',', ' '}, 2

{"42", " 12, 19"}

"42..12..19"

new Char[] {'.'}, 4

{"42", "", "12", ".19"}

"Banana"

new Char[] {'.'}, 2

{"Banana"}

"Darb\nSmarba"

new Char[] {}, 1

{"Darb\nSmarba"}

"Darb\nSmarba"

new Char[] null, 2

{"Darb", "Smarba"}

"Darb\nSmarba"

new Char[] null, 100

{"Darb", "Smarba"}

使用例使用例

count が、Split によって返される文字列の数に与える影響については、次のコード例を参照してください。

Visual Basic
Imports System
Imports Microsoft.VisualBasic
 _

Public Class StringSplit2
   
   Public Shared Sub Main()
      
      Dim delimStr As String
 = " ,.:"
      Dim delimiter As Char()
 = delimStr.ToCharArray()
      Dim words As String
 = "one two,three:four."
      Dim split As String()
 = Nothing
      
      Console.WriteLine("The delimiters are -{0}-",
 delimStr)
      Dim x As Integer
      For x = 1 To 5
         split = words.Split(delimiter, x)
         Console.WriteLine(ControlChars.Cr + "count = {0,2} ..............",
 x)
         Dim s As String
         For Each s In 
 split
            Console.WriteLine("-{0}-", s)
         Next s
      Next x
   End Sub 'Main
End Class 'StringSplit2
C#
using System;

public class StringSplit2 {
    public static void Main()
 {

        string delimStr = " ,.:";
    char [] delimiter = delimStr.ToCharArray();
        string words = "one two,three:four.";
        string [] split = null;

    Console.WriteLine("The delimiters are -{0}-", delimStr);
    for (int x = 1; x <= 5; x++) {
        split = words.Split(delimiter, x);
            Console.WriteLine("\ncount = {0,2} ..............", x);
        foreach (string s in
 split) {
                Console.WriteLine("-{0}-", s);
              }
    }
    }
}
C++
using namespace System;
using namespace System::Collections;
int main()
{
   String^ delimStr = " ,.:";
   array<Char>^delimiter = delimStr->ToCharArray();
   String^ words = "one two,three:four.";
   array<String^>^split = nullptr;
   Console::WriteLine( "The delimiters are -{0}-", delimStr );
   for ( int x = 1; x <= 5; x++ )
   {
      split = words->Split( delimiter, x );
      Console::WriteLine( "\ncount = {0, 2} ..............", x );
      IEnumerator^ myEnum = split->GetEnumerator();
      while ( myEnum->MoveNext() )
      {
         String^ s = safe_cast<String^>(myEnum->Current);
         Console::WriteLine( "-{0}-", s );
      }

   }
}
J#
import System.*;

public class StringSplit2
{
    public static void main(String[]
 args)
    {
        String delimStr = " ,.:";
        char delimiter[] = delimStr.ToCharArray();
        String words = "one two,three:four.";
        String split[] = null;

        Console.WriteLine("The delimiters are -{0}-", delimStr);
        for (int x = 1; x <= 5; x++) {
            split = words.Split(delimiter, x);
            Console.WriteLine("\ncount = {0,2} ..............",
                System.Convert.ToString(x));
            for (int iCtr = 0; iCtr < split.get_Length();
 iCtr++) {
                String s = split[iCtr];
                Console.WriteLine("-{0}-", s);
            }
        }
    } //main
} //StringSplit2
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
String クラス
String メンバ
System 名前空間
Char 構造体
Array クラス
Int32 構造体
Concat
Insert
Join
Remove
Replace
Substring
Trim

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

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Visual Basic (宣言)
<ComVisibleAttribute(False)> _
Public Function Split ( _
    separator As Char(), _
    options As StringSplitOptions _
) As String()
Visual Basic (使用法)
Dim instance As String
Dim separator As Char()
Dim options As StringSplitOptions
Dim returnValue As String()

returnValue = instance.Split(separator, options)
C#
[ComVisibleAttribute(false)] 
public string[] Split (
    char[] separator,
    StringSplitOptions options
)
C++
[ComVisibleAttribute(false)] 
public:
array<String^>^ Split (
    array<wchar_t>^ separator, 
    StringSplitOptions options
)
J#
/** @attribute ComVisibleAttribute(false) */ 
public String[] Split (
    char[] separator, 
    StringSplitOptions options
)
JScript
ComVisibleAttribute(false) 
public function Split (
    separator : char[], 
    options : StringSplitOptions
) : String[]

パラメータ

separator

この文字列から部分文字列を取り出すために区切り文字として使用する Unicode 文字の配列、区切り文字が含まれていない空の配列、または null 参照 (Visual Basic では Nothing)。

options

返される配列で空の要素を省略する場合は RemoveEmptyEntries。返される配列に空の要素も含める場合は None。

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

例外例外
例外の種類条件

ArgumentException

options が StringSplitOptions 値ではありません。

解説解説

戻り値の配列要素に区切り記号文字は含まれません。区切り記号は、序数に基づく比較を使用して検出されます。

このインスタンスに、separator に指定されたいずれの文字も含まれていなかった場合、戻り値の配列には、そのインスタンス自体を保持する要素が 1 つだけ格納されます。separator パラメータが null 参照 (Visual Basic では Nothing) の場合または文字が含まれていなかった場合、区切り記号に空白文字が指定されたものとして実行されます。

options パラメータが RemoveEmptyEntries で、このインスタンスの長さがゼロの場合、空の配列が返されます。

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

使用例使用例

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

Visual Basic
' This example demonstrates the String() methods that use
' the StringSplitOptions enumeration.
Imports System

Class Sample
    Public Shared Sub Main()
 
        Dim s1 As String
 = ",ONE,,TWO,,,THREE,,"
        Dim s2 As String
 = "[stop]" & _
                           "ONE[stop][stop]" &
 _
                           "TWO[stop][stop][stop]"
 & _
                           "THREE[stop][stop]"
        Dim charSeparators() As Char
 = {","c}
        Dim stringSeparators() As String
 = {"[stop]"}
        Dim result() As String
        ' ------------------------------------------------------------------------------
        ' Split a string delimited by characters.
        ' ------------------------------------------------------------------------------
        Console.WriteLine("1) Split a string delimited by characters:"
 & vbCrLf)
        
        ' Display the original string and delimiter characters.
        Console.WriteLine("1a )The original string is ""{0}"".",
 s1)
        Console.WriteLine("The delimiter character is '{0}'."
 & vbCrLf, charSeparators(0))
        
        ' Split a string delimited by characters and return all elements.
        Console.WriteLine("1b) Split a string delimited by characters
 and " & _
                          "return all elements:")
        result = s1.Split(charSeparators, StringSplitOptions.None)
        Show(result)
        
        ' Split a string delimited by characters and return all non-empty
 elements.
        Console.WriteLine("1c) Split a string delimited by characters
 and " & _
                          "return all non-empty elements:")
        result = s1.Split(charSeparators, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
        
        ' Split the original string into the string and empty string
 before the 
        ' delimiter and the remainder of the original string after the
 delimiter.
        Console.WriteLine("1d) Split a string delimited by characters
 and " & _
                          "return 2 elements:")
        result = s1.Split(charSeparators, 2, StringSplitOptions.None)
        Show(result)
        
        ' Split the original string into the string after the delimiter
 and the 
        ' remainder of the original string after the delimiter.
        Console.WriteLine("1e) Split a string delimited by characters
 and " & _
                          "return 2 non-empty elements:")
        result = s1.Split(charSeparators, 2, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
        
        ' ------------------------------------------------------------------------------
        ' Split a string delimited by another string.
        ' ------------------------------------------------------------------------------
        Console.WriteLine("2) Split a string delimited by another
 string:" & vbCrLf)
        
        ' Display the original string and delimiter string.
        Console.WriteLine("2a) The original string is ""{0}"".",
 s2)
        Console.WriteLine("The delimiter string is ""{0}""."
 & vbCrLf, stringSeparators(0))
        
        ' Split a string delimited by another string and return all
 elements.
        Console.WriteLine("2b) Split a string delimited by another
 string and " & _
                          "return all elements:")
        result = s2.Split(stringSeparators, StringSplitOptions.None)
        Show(result)
        
        ' Split the original string at the delimiter and return all
 non-empty elements.
        Console.WriteLine("2c) Split a string delimited by another
 string and " & _
                          "return all non-empty elements:")
        result = s2.Split(stringSeparators, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
        
        ' Split the original string into the empty string before the
 
        ' delimiter and the remainder of the original string after the
 delimiter.
        Console.WriteLine("2d) Split a string delimited by another
 string and " & _
                          "return 2 elements:")
        result = s2.Split(stringSeparators, 2, StringSplitOptions.None)
        Show(result)
        
        ' Split the original string into the string after the delimiter
 and the 
        ' remainder of the original string after the delimiter.
        Console.WriteLine("2e) Split a string delimited by another
 string and " & _
                          "return 2 non-empty elements:")
        result = s2.Split(stringSeparators, 2, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
    
    End Sub 'Main
    
    
    ' Display the array of separated strings.
    Public Shared Sub Show(ByVal
 entries() As String) 
        Console.WriteLine("The return value contains these {0}
 elements:", entries.Length)
        Dim entry As String
        For Each entry In
  entries
            Console.Write("<{0}>", entry)
        Next entry
        Console.Write(vbCrLf & vbCrLf)
    
    End Sub 'Show
End Class 'Sample
'
'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>
'
'1d) Split a string delimited by characters and return 2 elements:
'The return value contains these 2 elements:
'<><ONE,,TWO,,,THREE,,>
'
'1e) Split a string delimited by characters and return 2 non-empty elements:
'The return value contains these 2 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>
'
'2d) Split a string delimited by another string and return 2 elements:
'The return value contains these 2 elements:
'<><ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]>
'
'2e) Split a string delimited by another string and return 2 non-empty
 elements:
'The return value contains these 2 elements:
'<ONE><TWO[stop][stop][stop]THREE[stop][stop]>
'
C#
// This example demonstrates the String() methods that use
// the StringSplitOptions enumeration.
using System;

class Sample 
{
    public static void Main()
 
    {
    string s1 = ",ONE,,TWO,,,THREE,,";
    string s2 = "[stop]" +
                "ONE[stop][stop]" +
                "TWO[stop][stop][stop]" +
                "THREE[stop][stop]";
    char[] charSeparators = new char[]
 {','};
    string[] stringSeparators = new string[]
 {"[stop]"};
    string[] result;
// ------------------------------------------------------------------------------
// Split a string delimited by characters.
// ------------------------------------------------------------------------------
    Console.WriteLine("1) Split a string delimited by characters:\n");

// Display the original string and delimiter characters.
    Console.WriteLine("1a )The original string is \"{0}\".",
 s1);
    Console.WriteLine("The delimiter character is '{0}'.\n", 
                       charSeparators[0]);

// Split a string delimited by characters and return all elements.
    Console.WriteLine("1b) Split a string delimited by characters
 and " +
                      "return all elements:");
    result = s1.Split(charSeparators, StringSplitOptions.None);
    Show(result);

// Split a string delimited by characters and return all non-empty elements.
    Console.WriteLine("1c) Split a string delimited by characters
 and " +
                      "return all non-empty elements:");
    result = s1.Split(charSeparators, StringSplitOptions.RemoveEmptyEntries);
    Show(result);

// Split the original string into the string and empty string before
 the 
// delimiter and the remainder of the original string after the delimiter.
    Console.WriteLine("1d) Split a string delimited by characters
 and " +
                      "return 2 elements:");
    result = s1.Split(charSeparators, 2, StringSplitOptions.None);
    Show(result);

// Split the original string into the string after the delimiter and
 the 
// remainder of the original string after the delimiter.
    Console.WriteLine("1e) Split a string delimited by characters
 and " +
                      "return 2 non-empty elements:");
    result = s1.Split(charSeparators, 2, StringSplitOptions.RemoveEmptyEntries);
    Show(result);

// ------------------------------------------------------------------------------
// Split a string delimited by another string.
// ------------------------------------------------------------------------------
    Console.WriteLine("2) Split a string delimited by another
 string:\n");

// Display the original string and delimiter string.
    Console.WriteLine("2a) The original string is \"{0}\".",
 s2);
    Console.WriteLine("The delimiter string is \"{0}\".\n",
 stringSeparators[0]);

// Split a string delimited by another string and return all elements.
    Console.WriteLine("2b) Split a string delimited by another
 string and " +
                      "return all elements:");
    result = s2.Split(stringSeparators, StringSplitOptions.None);
    Show(result);

// Split the original string at the delimiter and return all non-empty
 elements.
    Console.WriteLine("2c) Split a string delimited by another
 string and " +
                      "return all non-empty elements:");
    result = s2.Split(stringSeparators, StringSplitOptions.RemoveEmptyEntries);
    Show(result);

// Split the original string into the empty string before the 
// delimiter and the remainder of the original string after the delimiter.
    Console.WriteLine("2d) Split a string delimited by another
 string and " +
                      "return 2 elements:");
    result = s2.Split(stringSeparators, 2, StringSplitOptions.None);
    Show(result);

// Split the original string into the string after the delimiter and
 the 
// remainder of the original string after the delimiter.
    Console.WriteLine("2e) Split a string delimited by another
 string and " + 
                      "return 2 non-empty elements:");
    result = s2.Split(stringSeparators, 2, StringSplitOptions.RemoveEmptyEntries);
    Show(result);
    }

// Display the array of separated strings.
    public static void Show(string[]
 entries)
    {
    Console.WriteLine("The return value contains these {0}
 elements:", entries.Length);
    foreach (string entry in
 entries)
        {
        Console.Write("<{0}>", entry);
        }
    Console.Write("\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>

1d) Split a string delimited by characters and return
 2 elements:
The return value contains these 2 elements:
<><ONE,,TWO,,,THREE,,>

1e) Split a string delimited by characters and return
 2 non-empty elements:
The return value contains these 2 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>

2d) Split a string delimited by another string
 and return 2 elements:
The return value contains these 2 elements:
<><ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]>

2e) Split a string delimited by another string
 and return 2 non-empty elements:
The return value contains these 2 elements:
<ONE><TWO[stop][stop][stop]THREE[stop][stop]>

*/
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
String クラス
String メンバ
System 名前空間

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

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Visual Basic (宣言)
<ComVisibleAttribute(False)> _
Public Function Split ( _
    separator As Char(), _
    count As Integer, _
    options As StringSplitOptions _
) As String()
Visual Basic (使用法)
Dim instance As String
Dim separator As Char()
Dim count As Integer
Dim options As StringSplitOptions
Dim returnValue As String()

returnValue = instance.Split(separator, count, options)
C#
[ComVisibleAttribute(false)] 
public string[] Split (
    char[] separator,
    int count,
    StringSplitOptions options
)
C++
[ComVisibleAttribute(false)] 
public:
array<String^>^ Split (
    array<wchar_t>^ separator, 
    int count, 
    StringSplitOptions options
)
J#
/** @attribute ComVisibleAttribute(false) */ 
public String[] Split (
    char[] separator, 
    int count, 
    StringSplitOptions options
)
JScript
ComVisibleAttribute(false) 
public function Split (
    separator : char[], 
    count : int, 
    options : StringSplitOptions
) : String[]

パラメータ

separator

この文字列から部分文字列を取り出すために区切り文字として使用する Unicode 文字の配列、区切り文字が含まれていない空の配列、または null 参照 (Visual Basic では Nothing)。

count

返される最大の部分文字列数。

options

返される配列で空の要素を省略する場合は RemoveEmptyEntries。返される配列に空の要素も含める場合は None。

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

例外例外
例外の種類条件

ArgumentOutOfRangeException

count が負の値です。

ArgumentException

options が StringSplitOptions 値ではありません。

解説解説

戻り値の配列要素に区切り記号文字は含まれません。区切り記号は、序数に基づく比較を使用して検出されます。

このインスタンスに、separator に指定されたいずれの文字も含まれていなかった場合、戻り値の配列には、そのインスタンス自体を保持する要素が 1 つだけ格納されます。separator パラメータが null 参照 (Visual Basic では Nothing) の場合または文字が含まれていなかった場合、区切り記号に空白文字が指定されたものとして実行されます。

count パラメータがゼロの場合、または、options パラメータが RemoveEmptyEntries で、このインスタンスの長さがゼロの場合、空の配列が返されます。

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

このインスタンスに count を超える部分文字列が含まれていた場合、count - 1 番目にある最初の部分文字列が、戻り値の count - 1 番目の最初の要素として返されます。このインスタンスに含まれるそれ以外の文字は、戻り値の最後の要素として返されます。

count が部分文字列の数よりも多い場合、取り出せるだけの部分文字列が返され、例外はスローされません。

使用例使用例

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

Visual Basic
' This example demonstrates the String() methods that use
' the StringSplitOptions enumeration.
Imports System

Class Sample
    Public Shared Sub Main()
 
        Dim s1 As String
 = ",ONE,,TWO,,,THREE,,"
        Dim s2 As String
 = "[stop]" & _
                           "ONE[stop][stop]" &
 _
                           "TWO[stop][stop][stop]"
 & _
                           "THREE[stop][stop]"
        Dim charSeparators() As Char
 = {","c}
        Dim stringSeparators() As String
 = {"[stop]"}
        Dim result() As String
        ' ------------------------------------------------------------------------------
        ' Split a string delimited by characters.
        ' ------------------------------------------------------------------------------
        Console.WriteLine("1) Split a string delimited by characters:"
 & vbCrLf)
        
        ' Display the original string and delimiter characters.
        Console.WriteLine("1a )The original string is ""{0}"".",
 s1)
        Console.WriteLine("The delimiter character is '{0}'."
 & vbCrLf, charSeparators(0))
        
        ' Split a string delimited by characters and return all elements.
        Console.WriteLine("1b) Split a string delimited by characters
 and " & _
                          "return all elements:")
        result = s1.Split(charSeparators, StringSplitOptions.None)
        Show(result)
        
        ' Split a string delimited by characters and return all non-empty
 elements.
        Console.WriteLine("1c) Split a string delimited by characters
 and " & _
                          "return all non-empty elements:")
        result = s1.Split(charSeparators, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
        
        ' Split the original string into the string and empty string
 before the 
        ' delimiter and the remainder of the original string after the
 delimiter.
        Console.WriteLine("1d) Split a string delimited by characters
 and " & _
                          "return 2 elements:")
        result = s1.Split(charSeparators, 2, StringSplitOptions.None)
        Show(result)
        
        ' Split the original string into the string after the delimiter
 and the 
        ' remainder of the original string after the delimiter.
        Console.WriteLine("1e) Split a string delimited by characters
 and " & _
                          "return 2 non-empty elements:")
        result = s1.Split(charSeparators, 2, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
        
        ' ------------------------------------------------------------------------------
        ' Split a string delimited by another string.
        ' ------------------------------------------------------------------------------
        Console.WriteLine("2) Split a string delimited by another
 string:" & vbCrLf)
        
        ' Display the original string and delimiter string.
        Console.WriteLine("2a) The original string is ""{0}"".",
 s2)
        Console.WriteLine("The delimiter string is ""{0}""."
 & vbCrLf, stringSeparators(0))
        
        ' Split a string delimited by another string and return all
 elements.
        Console.WriteLine("2b) Split a string delimited by another
 string and " & _
                          "return all elements:")
        result = s2.Split(stringSeparators, StringSplitOptions.None)
        Show(result)
        
        ' Split the original string at the delimiter and return all
 non-empty elements.
        Console.WriteLine("2c) Split a string delimited by another
 string and " & _
                          "return all non-empty elements:")
        result = s2.Split(stringSeparators, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
        
        ' Split the original string into the empty string before the
 
        ' delimiter and the remainder of the original string after the
 delimiter.
        Console.WriteLine("2d) Split a string delimited by another
 string and " & _
                          "return 2 elements:")
        result = s2.Split(stringSeparators, 2, StringSplitOptions.None)
        Show(result)
        
        ' Split the original string into the string after the delimiter
 and the 
        ' remainder of the original string after the delimiter.
        Console.WriteLine("2e) Split a string delimited by another
 string and " & _
                          "return 2 non-empty elements:")
        result = s2.Split(stringSeparators, 2, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
    
    End Sub 'Main
    
    
    ' Display the array of separated strings.
    Public Shared Sub Show(ByVal
 entries() As String) 
        Console.WriteLine("The return value contains these {0}
 elements:", entries.Length)
        Dim entry As String
        For Each entry In
  entries
            Console.Write("<{0}>", entry)
        Next entry
        Console.Write(vbCrLf & vbCrLf)
    
    End Sub 'Show
End Class 'Sample
'
'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>
'
'1d) Split a string delimited by characters and return 2 elements:
'The return value contains these 2 elements:
'<><ONE,,TWO,,,THREE,,>
'
'1e) Split a string delimited by characters and return 2 non-empty elements:
'The return value contains these 2 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>
'
'2d) Split a string delimited by another string and return 2 elements:
'The return value contains these 2 elements:
'<><ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]>
'
'2e) Split a string delimited by another string and return 2 non-empty
 elements:
'The return value contains these 2 elements:
'<ONE><TWO[stop][stop][stop]THREE[stop][stop]>
'
C#
// This example demonstrates the String() methods that use
// the StringSplitOptions enumeration.
using System;

class Sample 
{
    public static void Main()
 
    {
    string s1 = ",ONE,,TWO,,,THREE,,";
    string s2 = "[stop]" +
                "ONE[stop][stop]" +
                "TWO[stop][stop][stop]" +
                "THREE[stop][stop]";
    char[] charSeparators = new char[]
 {','};
    string[] stringSeparators = new string[]
 {"[stop]"};
    string[] result;
// ------------------------------------------------------------------------------
// Split a string delimited by characters.
// ------------------------------------------------------------------------------
    Console.WriteLine("1) Split a string delimited by characters:\n");

// Display the original string and delimiter characters.
    Console.WriteLine("1a )The original string is \"{0}\".",
 s1);
    Console.WriteLine("The delimiter character is '{0}'.\n", 
                       charSeparators[0]);

// Split a string delimited by characters and return all elements.
    Console.WriteLine("1b) Split a string delimited by characters
 and " +
                      "return all elements:");
    result = s1.Split(charSeparators, StringSplitOptions.None);
    Show(result);

// Split a string delimited by characters and return all non-empty elements.
    Console.WriteLine("1c) Split a string delimited by characters
 and " +
                      "return all non-empty elements:");
    result = s1.Split(charSeparators, StringSplitOptions.RemoveEmptyEntries);
    Show(result);

// Split the original string into the string and empty string before
 the 
// delimiter and the remainder of the original string after the delimiter.
    Console.WriteLine("1d) Split a string delimited by characters
 and " +
                      "return 2 elements:");
    result = s1.Split(charSeparators, 2, StringSplitOptions.None);
    Show(result);

// Split the original string into the string after the delimiter and
 the 
// remainder of the original string after the delimiter.
    Console.WriteLine("1e) Split a string delimited by characters
 and " +
                      "return 2 non-empty elements:");
    result = s1.Split(charSeparators, 2, StringSplitOptions.RemoveEmptyEntries);
    Show(result);

// ------------------------------------------------------------------------------
// Split a string delimited by another string.
// ------------------------------------------------------------------------------
    Console.WriteLine("2) Split a string delimited by another
 string:\n");

// Display the original string and delimiter string.
    Console.WriteLine("2a) The original string is \"{0}\".",
 s2);
    Console.WriteLine("The delimiter string is \"{0}\".\n",
 stringSeparators[0]);

// Split a string delimited by another string and return all elements.
    Console.WriteLine("2b) Split a string delimited by another
 string and " +
                      "return all elements:");
    result = s2.Split(stringSeparators, StringSplitOptions.None);
    Show(result);

// Split the original string at the delimiter and return all non-empty
 elements.
    Console.WriteLine("2c) Split a string delimited by another
 string and " +
                      "return all non-empty elements:");
    result = s2.Split(stringSeparators, StringSplitOptions.RemoveEmptyEntries);
    Show(result);

// Split the original string into the empty string before the 
// delimiter and the remainder of the original string after the delimiter.
    Console.WriteLine("2d) Split a string delimited by another
 string and " +
                      "return 2 elements:");
    result = s2.Split(stringSeparators, 2, StringSplitOptions.None);
    Show(result);

// Split the original string into the string after the delimiter and
 the 
// remainder of the original string after the delimiter.
    Console.WriteLine("2e) Split a string delimited by another
 string and " + 
                      "return 2 non-empty elements:");
    result = s2.Split(stringSeparators, 2, StringSplitOptions.RemoveEmptyEntries);
    Show(result);
    }

// Display the array of separated strings.
    public static void Show(string[]
 entries)
    {
    Console.WriteLine("The return value contains these {0}
 elements:", entries.Length);
    foreach (string entry in
 entries)
        {
        Console.Write("<{0}>", entry);
        }
    Console.Write("\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>

1d) Split a string delimited by characters and return
 2 elements:
The return value contains these 2 elements:
<><ONE,,TWO,,,THREE,,>

1e) Split a string delimited by characters and return
 2 non-empty elements:
The return value contains these 2 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>

2d) Split a string delimited by another string
 and return 2 elements:
The return value contains these 2 elements:
<><ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]>

2e) Split a string delimited by another string
 and return 2 non-empty elements:
The return value contains these 2 elements:
<ONE><TWO[stop][stop][stop]THREE[stop][stop]>

*/
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
String クラス
String メンバ
System 名前空間

String.Split メソッド

このインスタンス内の、指定された Char 配列または String 配列の要素で区切られた部分文字列を格納する String 配列を返します。
オーバーロードの一覧オーバーロードの一覧

名前 説明
String.Split (Char[]) このインスタンス内の、指定された Char 配列の要素で区切られた部分文字列を格納する String 配列を返します。

.NET Compact Framework によってサポートされています。

String.Split (Char[], Int32) このインスタンス内の、指定された Char 配列の要素で区切られた部分文字列を格納する String 配列を返します。パラメータには、取得する部分文字列の最大数を指定します。

.NET Compact Framework によってサポートされています。

String.Split (Char[], StringSplitOptions) この文字列内の、指定された Char 配列の要素で区切られた部分文字列を格納する String 配列を返します。空の配列要素を返すかどうかをパラメータで指定します。

.NET Compact Framework によってサポートされています。

String.Split (String[], StringSplitOptions) この文字列内の、指定された String 配列の要素で区切られた部分文字列を格納する String 配列を返します。空の配列要素を返すかどうかをパラメータで指定します。

.NET Compact Framework によってサポートされています。

String.Split (Char[], Int32, StringSplitOptions) この文字列内の、指定された Char 配列の要素で区切られた部分文字列を格納する String 配列を返します。返される部分文字列の最大数と、空の配列要素を返すかどうかをパラメータで指定します。

.NET Compact Framework によってサポートされています。

String.Split (String[], Int32, StringSplitOptions) この文字列内の、指定された String 配列の要素で区切られた部分文字列を格納する String 配列を返します。返される部分文字列の最大数と、空の配列要素を返すかどうかをパラメータで指定します。

.NET Compact Framework によってサポートされています。

参照参照

関連項目

String クラス
String メンバ
System 名前空間
Char 構造体
Concat
Insert
Join
Remove
Replace
Substring
Trim

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

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文構文

Visual Basic (宣言)
<ComVisibleAttribute(False)> _
Public Function Split ( _
    separator As String(), _
    options As StringSplitOptions _
) As String()
Visual Basic (使用法)
Dim instance As String
Dim separator As String()
Dim options As StringSplitOptions
Dim returnValue As String()

returnValue = instance.Split(separator, options)
C#
[ComVisibleAttribute(false)] 
public string[] Split (
    string[] separator,
    StringSplitOptions options
)
C++
[ComVisibleAttribute(false)] 
public:
array<String^>^ Split (
    array<String^>^ separator, 
    StringSplitOptions options
)
J#
/** @attribute ComVisibleAttribute(false) */ 
public String[] Split (
    String[] separator, 
    StringSplitOptions options
)
JScript
ComVisibleAttribute(false) 
public function Split (
    separator : String[], 
    options : StringSplitOptions
) : String[]

パラメータ

separator

この文字列から部分文字列を取り出すために区切り文字として使用する文字列の配列、区切り文字が含まれていない空の配列、または null 参照 (Visual Basic では Nothing)。

options

返される配列で空の要素を省略する場合は RemoveEmptyEntries。返される配列に空の要素も含める場合は None。

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

例外例外
例外の種類条件

ArgumentException

options が StringSplitOptions 値ではありません。

解説解説
戻り値に関する情報

戻り値の配列要素に区切り記号文字列は含まれません。区切り記号は、序数に基づく比較を使用して検出されます。

このインスタンスに、separator に指定されたいずれの文字列も含まれていなかった場合、戻り値の配列には、そのインスタンス自体を保持する要素が 1 つだけ格納されます。separator パラメータが null 参照 (Visual Basic では Nothing) の場合または文字が含まれていなかった場合、区切り記号に空白文字が指定されたものとして実行されます。

options パラメータが RemoveEmptyEntries で、このインスタンスの長さがゼロの場合、空の配列が返されます。

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

比較に関する情報

Split メソッドは、この文字列を、separator パラメータで指定された 1 つまたは複数の文字列で区切ることによって部分文字列を抽出し、これらの部分文字列を配列の要素として返します。

Split メソッドが区切り記号を検索する際の比較処理では、大文字と小文字は区別され、序数の並べ替え規則が使用されます。単語、文字列、序数の並べ替えの詳細については、System.Globalization.CompareOptions 列挙値のトピックを参照してください。

Split メソッドでは、値が null 参照 (Visual Basic では Nothing) または空の文字列 ("") である separator の要素は無視されます。

separator に格納された複数の文字列に共通の文字が使用されていた場合にあいまいな結果が生じるのを防ぐため、Split の処理では、対象のインスタンスの値を先頭から最後まで解析し、separator 内の要素と最初に一致した要素を区切り文字として使用します。インスタンスにおける部分文字列の出現順が、separator における要素の格納順よりも優先されます。

たとえば、値が "abcdef" であるインスタンスがあるとします。separator の 1 つ目の要素が "ef"、2 つ目の要素が "bcde" であった場合、分割処理の結果は "a" と "f" になります。インスタンス内の部分文字列 "bcde" が、部分文字列 "f" よりも先に separator 内の要素と一致するためです。

ただし、separator の 1 つ目の要素が "bcd" で、2 つ目の要素が "bc" であった場合、分割処理の結果は "a" と "ef" になります。これは、"bcd" が、separator に格納された要素のうち、インスタンス内の区切り記号と一致する最初の要素であるためです。separator に格納された要素の順序が逆だった場合、つまり、1 つ目の要素が "bc" で、2 つ目の要素が "bcd" であった場合、分割処理の結果は "a" と "def" となります。

使用例使用例

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

Visual Basic
' This example demonstrates the String() methods that use
' the StringSplitOptions enumeration.
Imports System

Class Sample
    Public Shared Sub Main()
 
        Dim s1 As String
 = ",ONE,,TWO,,,THREE,,"
        Dim s2 As String
 = "[stop]" & _
                           "ONE[stop][stop]" &
 _
                           "TWO[stop][stop][stop]"
 & _
                           "THREE[stop][stop]"
        Dim charSeparators() As Char
 = {","c}
        Dim stringSeparators() As String
 = {"[stop]"}
        Dim result() As String
        ' ------------------------------------------------------------------------------
        ' Split a string delimited by characters.
        ' ------------------------------------------------------------------------------
        Console.WriteLine("1) Split a string delimited by characters:"
 & vbCrLf)
        
        ' Display the original string and delimiter characters.
        Console.WriteLine("1a )The original string is ""{0}"".",
 s1)
        Console.WriteLine("The delimiter character is '{0}'."
 & vbCrLf, charSeparators(0))
        
        ' Split a string delimited by characters and return all elements.
        Console.WriteLine("1b) Split a string delimited by characters
 and " & _
                          "return all elements:")
        result = s1.Split(charSeparators, StringSplitOptions.None)
        Show(result)
        
        ' Split a string delimited by characters and return all non-empty
 elements.
        Console.WriteLine("1c) Split a string delimited by characters
 and " & _
                          "return all non-empty elements:")
        result = s1.Split(charSeparators, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
        
        ' Split the original string into the string and empty string
 before the 
        ' delimiter and the remainder of the original string after the
 delimiter.
        Console.WriteLine("1d) Split a string delimited by characters
 and " & _
                          "return 2 elements:")
        result = s1.Split(charSeparators, 2, StringSplitOptions.None)
        Show(result)
        
        ' Split the original string into the string after the delimiter
 and the 
        ' remainder of the original string after the delimiter.
        Console.WriteLine("1e) Split a string delimited by characters
 and " & _
                          "return 2 non-empty elements:")
        result = s1.Split(charSeparators, 2, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
        
        ' ------------------------------------------------------------------------------
        ' Split a string delimited by another string.
        ' ------------------------------------------------------------------------------
        Console.WriteLine("2) Split a string delimited by another
 string:" & vbCrLf)
        
        ' Display the original string and delimiter string.
        Console.WriteLine("2a) The original string is ""{0}"".",
 s2)
        Console.WriteLine("The delimiter string is ""{0}""."
 & vbCrLf, stringSeparators(0))
        
        ' Split a string delimited by another string and return all
 elements.
        Console.WriteLine("2b) Split a string delimited by another
 string and " & _
                          "return all elements:")
        result = s2.Split(stringSeparators, StringSplitOptions.None)
        Show(result)
        
        ' Split the original string at the delimiter and return all
 non-empty elements.
        Console.WriteLine("2c) Split a string delimited by another
 string and " & _
                          "return all non-empty elements:")
        result = s2.Split(stringSeparators, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
        
        ' Split the original string into the empty string before the
 
        ' delimiter and the remainder of the original string after the
 delimiter.
        Console.WriteLine("2d) Split a string delimited by another
 string and " & _
                          "return 2 elements:")
        result = s2.Split(stringSeparators, 2, StringSplitOptions.None)
        Show(result)
        
        ' Split the original string into the string after the delimiter
 and the 
        ' remainder of the original string after the delimiter.
        Console.WriteLine("2e) Split a string delimited by another
 string and " & _
                          "return 2 non-empty elements:")
        result = s2.Split(stringSeparators, 2, StringSplitOptions.RemoveEmptyEntries)
        Show(result)
    
    End Sub 'Main
    
    
    ' Display the array of separated strings.
    Public Shared Sub Show(ByVal
 entries() As String) 
        Console.WriteLine("The return value contains these {0}
 elements:", entries.Length)
        Dim entry As String
        For Each entry In
  entries
            Console.Write("<{0}>", entry)
        Next entry
        Console.Write(vbCrLf & vbCrLf)
    
    End Sub 'Show
End Class 'Sample
'
'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>
'
'1d) Split a string delimited by characters and return 2 elements:
'The return value contains these 2 elements:
'<><ONE,,TWO,,,THREE,,>
'
'1e) Split a string delimited by characters and return 2 non-empty elements:
'The return value contains these 2 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>
'
'2d) Split a string delimited by another string and return 2 elements:
'The return value contains these 2 elements:
'<><ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]>
'
'2e) Split a string delimited by another string and return 2 non-empty
 elements:
'The return value contains these 2 elements:
'<ONE><TWO[stop][stop][stop]THREE[stop][stop]>
'
C#
// This example demonstrates the String() methods that use
// the StringSplitOptions enumeration.
using System;

class Sample 
{
    public static void Main()
 
    {
    string s1 = ",ONE,,TWO,,,THREE,,";
    string s2 = "[stop]" +
                "ONE[stop][stop]" +
                "TWO[stop][stop][stop]" +
                "THREE[stop][stop]";
    char[] charSeparators = new char[]
 {','};
    string[] stringSeparators = new string[]
 {"[stop]"};
    string[] result;
// ------------------------------------------------------------------------------
// Split a string delimited by characters.
// ------------------------------------------------------------------------------
    Console.WriteLine("1) Split a string delimited by characters:\n");

// Display the original string and delimiter characters.
    Console.WriteLine("1a )The original string is \"{0}\".",
 s1);
    Console.WriteLine("The delimiter character is '{0}'.\n", 
                       charSeparators[0]);

// Split a string delimited by characters and return all elements.
    Console.WriteLine("1b) Split a string delimited by characters
 and " +
                      "return all elements:");
    result = s1.Split(charSeparators, StringSplitOptions.None);
    Show(result);

// Split a string delimited by characters and return all non-empty elements.
    Console.WriteLine("1c) Split a string delimited by characters
 and " +
                      "return all non-empty elements:");
    result = s1.Split(charSeparators, StringSplitOptions.RemoveEmptyEntries);
    Show(result);

// Split the original string into the string and empty string before
 the 
// delimiter and the remainder of the original string after the delimiter.
    Console.WriteLine("1d) Split a string delimited by characters
 and " +
                      "return 2 elements:");
    result = s1.Split(charSeparators, 2, StringSplitOptions.None);
    Show(result);

// Split the original string into the string after the delimiter and
 the 
// remainder of the original string after the delimiter.
    Console.WriteLine("1e) Split a string delimited by characters
 and " +
                      "return 2 non-empty elements:");
    result = s1.Split(charSeparators, 2, StringSplitOptions.RemoveEmptyEntries);
    Show(result);

// ------------------------------------------------------------------------------
// Split a string delimited by another string.
// ------------------------------------------------------------------------------
    Console.WriteLine("2) Split a string delimited by another
 string:\n");

// Display the original string and delimiter string.
    Console.WriteLine("2a) The original string is \"{0}\".",
 s2);
    Console.WriteLine("The delimiter string is \"{0}\".\n",
 stringSeparators[0]);

// Split a string delimited by another string and return all elements.
    Console.WriteLine("2b) Split a string delimited by another
 string and " +
                      "return all elements:");
    result = s2.Split(stringSeparators, StringSplitOptions.None);
    Show(result);

// Split the original string at the delimiter and return all non-empty
 elements.
    Console.WriteLine("2c) Split a string delimited by another
 string and " +
                      "return all non-empty elements:");
    result = s2.Split(stringSeparators, StringSplitOptions.RemoveEmptyEntries);
    Show(result);

// Split the original string into the empty string before the 
// delimiter and the remainder of the original string after the delimiter.
    Console.WriteLine("2d) Split a string delimited by another
 string and " +
                      "return 2 elements:");
    result = s2.Split(stringSeparators, 2, StringSplitOptions.None);
    Show(result);

// Split the original string into the string after the delimiter and
 the 
// remainder of the original string after the delimiter.
    Console.WriteLine("2e) Split a string delimited by another
 string and " + 
                      "return 2 non-empty elements:");
    result = s2.Split(stringSeparators, 2, StringSplitOptions.RemoveEmptyEntries);
    Show(result);
    }

// Display the array of separated strings.
    public static void Show(string[]
 entries)
    {
    Console.WriteLine("The return value contains these {0}
 elements:", entries.Length);
    foreach (string entry in
 entries)
        {
        Console.Write("<{0}>", entry);
        }
    Console.Write("\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>

1d) Split a string delimited by characters and return
 2 elements:
The return value contains these 2 elements:
<><ONE,,TWO,,,THREE,,>

1e) Split a string delimited by characters and return
 2 non-empty elements:
The return value contains these 2 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>

2d) Split a string delimited by another string
 and return 2 elements:
The return value contains these 2 elements:
<><ONE[stop][stop]TWO[stop][stop][stop]THREE[stop][stop]>

2e) Split a string delimited by another string
 and return 2 non-empty elements:
The return value contains these 2 elements:
<ONE><TWO[stop][stop][stop]THREE[stop][stop]>

*/
プラットフォームプラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報バージョン情報
.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0
参照参照
関連項目
String クラス
String メンバ
System 名前空間

急上昇のことば

四宮ありす
思わず
余人をもって替えがたい
社会死
救出
このページでは「.NET Framework クラス ライブラリ リファレンス」からString.Splitを検索した結果を表示しています。
Weblioに収録されているすべての辞書からString.Splitを検索する場合は、下記のリンクをクリックしてください。
 全ての辞書からString.Split を検索
英和和英テキスト翻訳>> Weblio翻訳
英語⇒日本語日本語⇒英語
  

辞書ショートカット

カテゴリ一覧

全て

＋ ビジネス

＋ 業界用語

＋ コンピュータ

＋ 電車

＋ 自動車・バイク

＋ 船

＋ 工学

＋ 建築・不動産

＋ 学問

＋ 文化

＋ 生活

＋ ヘルスケア

＋ 趣味

＋ スポーツ

＋ 生物

＋ 食品

＋ 人名

＋ 方言

＋ 辞書・百科事典

すべての辞書の索引

あいうえお
かきくけこ
さしすせそ
たちつてと
なにぬねの
はひふへほ
まみむめも
やゆよ
らりるれろ
わをん
がぎぐげご
ざじずぜぞ
だぢづでど
ばびぶべぼ
ぱぴぷぺぽ
ＡＢＣＤＥ
ＦＧＨＩＪ
ＫＬＭＮＯ
ＰＱＲＳＴ
ＵＶＷＸＹ
Ｚ
１２３４５
６７８９０
記号

Weblioのサービス

「String.Split」の関連用語

1
String.Split メソッド
.NET Framework クラス ライブラリ リファレンス
56% |||||

2
String.ToCharArray メソッド ()
.NET Framework クラス ライブラリ リファレンス
36% |||||

3
パイプライン演算子
百科事典
34% |||||

4
Strings.Split メソッド
.NET Framework クラス ライブラリ リファレンス
32% |||||

5
Regex.Split メソッド
.NET Framework クラス ライブラリ リファレンス
30% |||||

6
Strings クラス
.NET Framework クラス ライブラリ リファレンス
16% |||||

7
JSBuiltin 列挙体
.NET Framework クラス ライブラリ リファレンス
12% |||||

8
User.CurrentPrincipal プロパティ
.NET Framework クラス ライブラリ リファレンス
12% |||||

9
User.Name プロパティ
.NET Framework クラス ライブラリ リファレンス
12% |||||

10
User クラス
.NET Framework クラス ライブラリ リファレンス
8% |||||

String.Splitのお隣キーワード

String.Split

String.Split メソッド

String.StartsWith メソッド

StringSplitOptions 列挙体

Strings.Asc メソッド

Strings.AscW メソッド

Strings.Chr メソッド

検索ランキング

   

 英語⇒日本語
日本語⇒英語		    


String.Splitのページの著作権
Weblio 辞書 情報提供元は 参加元一覧 にて確認できます。

   
日本マイクロソフト株式会社日本マイクロソフト株式会社
© 2025 Microsoft.All rights reserved.

©2025 GRAS Group, Inc.RSS