この記事は機械翻訳されています。英語版の記事を表示するには、[英語] のチェック ボックスをオンにしてください。また、テキストにマウス ポインターを合わせると、ポップアップ ウィンドウに英語のテキストを表示することもできます。
翻訳
英語

String.StartsWith メソッド (String, StringComparison)

 

指定された比較オプションを使って比較した場合に、この文字列インスタンスの先頭が、指定された文字列と一致するかどうかを判断します。

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

[ComVisibleAttribute(false)]
public bool StartsWith(
	string value,
	StringComparison comparisonType
)

パラメーター

value
Type: System.String

比較対象の文字列。

comparisonType
Type: System.StringComparison

この文字列と value との比較方法を決定する列挙値の 1 つ。

戻り値

Type: System.Boolean

インスタンスが true で開始する場合は value。それ以外の場合は false

Exception Condition
ArgumentNullException

valuenull です。

ArgumentException

comparisonTypeStringComparison 値ではありません。

StartsWithメソッドに比較して、valueこの文字列の先頭にある部分文字列にパラメーターをそれらが等しいかどうかを示す値を返します。 等しく、valueこの同じ文字列への参照を指定する必要があります、空の文字列にする必要があります ("")、またはこの文字列の先頭に一致する必要があります。 によって実行される比較の種類、StartsWithメソッドの値によって異なります、comparisonTypeパラメーター。 比較は、現在のカルチャの規則を使用できます (StringComparison.CurrentCultureStringComparison.CurrentCultureIgnoreCase) のカルチャまたはインバリアント カルチャ (StringComparison.InvariantCultureStringComparison.InvariantCultureIgnoreCase)、または、コード ポイントの文字の比較で構成されていることができます (StringComparison.OrdinalまたはStringComparison.OrdinalIgnoreCase)。 比較は大文字小文字を区別することもできます (StringComparison.CurrentCultureStringComparison.InvariantCulture、またはStringComparison.Ordinal)、大文字小文字を区別、または (StringComparison.CurrentCultureIgnoreCaseStringComparison.InvariantCultureIgnoreCaseStringComparison.OrdinalIgnoreCase)。

次の例は、文字列の検索の"the"という単語で始まる長い文字列の先頭に"The"です。 例への呼び出しからの出力として、StartsWith(String, StringComparison)カルチャおよび大文字小文字 insensitive の比較を実行する呼び出し文字列と一致するときに、文字列に一致するカルチャを認識しないが、区別する比較を実行するメソッドが失敗します。

using System;

public class Example
{
   public static void Main()
   {
      String title = "The House of the Seven Gables";
      String searchString = "the";
      StringComparison comparison = StringComparison.InvariantCulture;
      Console.WriteLine("'{0}':", title);
      Console.WriteLine("   Starts with '{0}' ({1:G} comparison): {2}",
                        searchString, comparison,
                        title.StartsWith(searchString, comparison));

      comparison = StringComparison.InvariantCultureIgnoreCase;
      Console.WriteLine("   Starts with '{0}' ({1:G} comparison): {2}",
                        searchString, comparison,
                        title.StartsWith(searchString, comparison));
   }
}
// The example displays the following output:
//       'The House of the Seven Gables':
//          Starts with 'the' (InvariantCulture comparison): False
//          Starts with 'the' (InvariantCultureIgnoreCase comparison): True

次の例では、文字列が特定の部分文字列で始まるかどうかを判断します。 これには、2 次元の文字列配列を初期化します。 2 番目の次元内の最初の要素を含む文字列、および 2 番目の要素には、最初の文字列の開始時に検索する文字列が含まれています。 結果は、カルチャ、大文字と小文字の区別するかどうか、および序数に基づく比較を実行するかどうかの選択の影響を受けます。 文字列のインスタンスにする合字が含まれている場合、連続する文字のカルチャに依存した比較が正常に一致する注意してください。

using System;

public class Example
{
   public static void Main()
   {
      string[,] strings = { {"ABCdef", "abc" },                    
                            {"ABCdef", "abc" },  
                            {"œil","oe" },
                            { "læring}", "lae" } };
      for (int ctr1 = strings.GetLowerBound(0); ctr1 <= strings.GetUpperBound(0); ctr1++)
      {
            foreach (string cmpName in Enum.GetNames(typeof(StringComparison)))
            { 
               StringComparison strCmp = (StringComparison) Enum.Parse(typeof(StringComparison), 
                                                      cmpName);
               string instance = strings[ctr1, 0];
               string value = strings[ctr1, 1];
               Console.WriteLine("{0} starts with {1}: {2} ({3} comparison)", 
                                 instance, value, 
                                 instance.StartsWith(value, strCmp), 
                                 strCmp); 
            }
            Console.WriteLine();   
      }   
   }
}
// The example displays the following output:
//       ABCdef starts with abc: False (CurrentCulture comparison)
//       ABCdef starts with abc: True (CurrentCultureIgnoreCase comparison)
//       ABCdef starts with abc: False (InvariantCulture comparison)
//       ABCdef starts with abc: True (InvariantCultureIgnoreCase comparison)
//       ABCdef starts with abc: False (Ordinal comparison)
//       ABCdef starts with abc: True (OrdinalIgnoreCase comparison)
//       
//       ABCdef starts with abc: False (CurrentCulture comparison)
//       ABCdef starts with abc: True (CurrentCultureIgnoreCase comparison)
//       ABCdef starts with abc: False (InvariantCulture comparison)
//       ABCdef starts with abc: True (InvariantCultureIgnoreCase comparison)
//       ABCdef starts with abc: False (Ordinal comparison)
//       ABCdef starts with abc: True (OrdinalIgnoreCase comparison)
//       
//       œil starts with oe: True (CurrentCulture comparison)
//       œil starts with oe: True (CurrentCultureIgnoreCase comparison)
//       œil starts with oe: True (InvariantCulture comparison)
//       œil starts with oe: True (InvariantCultureIgnoreCase comparison)
//       œil starts with oe: False (Ordinal comparison)
//       œil starts with oe: False (OrdinalIgnoreCase comparison)
//       
//       læring} starts with lae: True (CurrentCulture comparison)
//       læring} starts with lae: True (CurrentCultureIgnoreCase comparison)
//       læring} starts with lae: True (InvariantCulture comparison)
//       læring} starts with lae: True (InvariantCultureIgnoreCase comparison)
//       læring} starts with lae: False (Ordinal comparison)
//       læring} starts with lae: False (OrdinalIgnoreCase comparison)

ユニバーサル Windows プラットフォーム
8 以降で使用可能
.NET Framework
2.0 以降で使用可能
ポータブル クラス ライブラリ
サポート対象: 移植可能 .NET プラットフォーム
Silverlight
2.0 以降で使用可能
Windows Phone Silverlight
7.0 以降で使用可能
Windows Phone
8.1 以降で使用可能
トップに戻る
表示: