String.Contains メソッド

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

オーバーロード

Contains(String, StringComparison)	指定された比較規則を使用して、指定された文字列がこの文字列内に含まれるかどうかを示す値を返します。
Contains(Char, StringComparison)	指定された比較規則を使用して、指定された文字がこの文字列内に含まれるかどうかを示す値を返します。
Contains(String)	指定した部分文字列がこの文字列内に存在するかどうかを示す値を返します。
Contains(Char)	指定した文字がこの文字列内に存在するかどうかを示す値を返します。

Contains(String, StringComparison)

ソース:

String.Searching.cs

指定された比較規則を使用して、指定された文字列がこの文字列内に含まれるかどうかを示す値を返します。

C#

public bool Contains (string value, StringComparison comparisonType);

パラメーター

value

String

シークする文字列。

comparisonType

StringComparison

比較で使用する規則を指定する列挙値の 1 つ。

戻り値

Boolean

value パラメーターがこの文字列内に存在するか、value が空の文字列 ("") の場合は true。それ以外の場合は false。

Contains(Char, StringComparison)

ソース:

String.Searching.cs

指定された比較規則を使用して、指定された文字がこの文字列内に含まれるかどうかを示す値を返します。

C#

public bool Contains (char value, StringComparison comparisonType);

パラメーター

value

Char

検索対象の文字。

comparisonType

StringComparison

比較で使用する規則を指定する列挙値の 1 つ。

戻り値

Boolean

value パラメーターがこの文字列内で発生する場合は true。それ以外の場合は false。

Contains(String)

ソース:

String.Searching.cs

指定した部分文字列がこの文字列内に存在するかどうかを示す値を返します。

C#

public bool Contains (string value);

パラメーター

value

String

シークする文字列。

戻り値

Boolean

value パラメーターがこの文字列内に存在するか、value が空の文字列 ("") の場合は true。それ以外の場合は false。

例外

ArgumentNullException

value が nullです。

例

次の例では、文字列 "fox" が使い慣れた引用符の部分文字列であるかどうかを判断します。 文字列に "fox" が見つかった場合は、開始位置も表示されます。

C#

string s1 = "The quick brown fox jumps over the lazy dog";
string s2 = "fox";
bool b = s1.Contains(s2);
Console.WriteLine("'{0}' is in the string '{1}': {2}",
                s2, s1, b);
if (b) {
    int index = s1.IndexOf(s2);
    if (index >= 0)
        Console.WriteLine("'{0} begins at character position {1}",
                      s2, index + 1);
}
// This example displays the following output:
//    'fox' is in the string 'The quick brown fox jumps over the lazy dog': True
//    'fox begins at character position 17

注釈

このメソッドは、序数 (大文字と小文字を区別し、カルチャを区別しない) 比較を実行します。 検索は、この文字列の最初の文字位置から始まり、最後の文字位置まで続きます。

カルチャに依存する比較または序数の大文字と小文字を区別しない比較を実行するには、次のようにします。

• .NET Core 2.1 以降のバージョンでは、代わりに オーバーロードを Contains(String, StringComparison) 呼び出します。

• .NET Framework: カスタム メソッドをCreateします。 次の例は、このようなアプローチの 1 つを示しています。 パラメーターを String 含む拡張メソッドを StringComparison 定義し、指定した形式の文字列比較を使用するときに文字列に部分文字列が含まれているかどうかを示します。

C#

using System;

public static class StringExtensions
{
   public static bool Contains(this String str, String substring, 
                               StringComparison comp)
   {                            
        if (substring == null)
            throw new ArgumentNullException("substring", 
                                         "substring cannot be null.");
        else if (! Enum.IsDefined(typeof(StringComparison), comp))
            throw new ArgumentException("comp is not a member of StringComparison",
                                     "comp");

        return str.IndexOf(substring, comp) >= 0;                      
   }
}

C#

String s = "This is a string.";
String sub1 = "this";
Console.WriteLine("Does '{0}' contain '{1}'?", s, sub1);
StringComparison comp = StringComparison.Ordinal;
Console.WriteLine("   {0:G}: {1}", comp, s.Contains(sub1, comp));

comp = StringComparison.OrdinalIgnoreCase;
Console.WriteLine("   {0:G}: {1}", comp, s.Contains(sub1, comp));

// The example displays the following output:
//       Does 'This is a string.' contain 'this'?
//          Ordinal: False
//          OrdinalIgnoreCase: True

現在のインスタンス内の部分文字列 value の位置に関心がある場合は、 メソッドを IndexOf 呼び出して最初に出現する位置を取得するか、 メソッドを呼び出 LastIndexOf して最後に出現した部分文字列の開始位置を取得できます。 この例では、文字列インスタンスで IndexOf(String) 部分文字列が見つかった場合に、 メソッドの呼び出しを含めます。

こちらもご覧ください

• IndexOf(Char)
• LastIndexOf(String)

Contains(Char)

ソース:

String.Searching.cs

指定した文字がこの文字列内に存在するかどうかを示す値を返します。

C#

public bool Contains (char value);

パラメーター

value

Char

検索対象の文字。

戻り値

Boolean

value パラメーターがこの文字列内で発生する場合は true。それ以外の場合は false。

注釈

このメソッドは、序数 (大文字と小文字を区別し、カルチャを区別しない) 比較を実行します。