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

String.StartsWith メソッド (String, Boolean, CultureInfo)

 

公開日: 2016年10月

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

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

public bool StartsWith(
	string value,
	bool ignoreCase,
	CultureInfo culture
)

パラメーター

value
Type: System.String

比較対象の文字列。

ignoreCase
Type: System.Boolean

比較時に大文字と小文字の区別を無視する場合は true。それ以外の場合は false

culture
Type: System.Globalization.CultureInfo

この文字列と value との比較方法を決定するカルチャ情報。 culturenull の場合は、現在のカルチャが使用されます。

戻り値

Type: System.Boolean

true パラメーターがこの文字列の先頭と一致する場合は value。それ以外の場合は false

Exception Condition
ArgumentNullException

valuenull です。

このメソッドを比較して、valueパラメーターと同じ長さであるこの文字列の先頭にある部分文字列をvalue、し、それらが等しいかどうかを示す値を返します。 等しく、value空の文字列を指定する必要があります (String.Empty)、この同じインスタンスへの参照があります。 または、このインスタンスの先頭に一致する必要があります。

このメソッドは、指定した大文字小文字の区別とカルチャを使用して、比較を実行します。

次の例では、文字列が別の文字列の先頭に出現するかどうかを判断します。 StartsWith大文字小文字の区別、大文字と小文字の区別、および検索の結果に影響する異なるカルチャを使用して数回メソッドが呼び出されます。

// This code example demonstrates the 
// System.String.StartsWith(String, ..., CultureInfo) method.

using System;
using System.Threading;
using System.Globalization;

class Sample 
{
    public static void Main() 
    {
    string msg1 = "Search for the target string \"{0}\" in the string \"{1}\".\n";
    string msg2 = "Using the {0} - \"{1}\" culture:";
    string msg3 = "  The string to search ends with the target string: {0}";
    bool result = false;
    CultureInfo ci;

// Define a target string to search for.
// U+00c5 = LATIN CAPITAL LETTER A WITH RING ABOVE
    string capitalARing = "\u00c5";

// Define a string to search. 
// The result of combining the characters LATIN SMALL LETTER A and COMBINING 
// RING ABOVE (U+0061, U+030a) is linguistically equivalent to the character 
// LATIN SMALL LETTER A WITH RING ABOVE (U+00e5).
    string aRingXYZ = "\u0061\u030a" + "xyz";

// Clear the screen and display an introduction.
    Console.Clear();

// Display the string to search for and the string to search.
    Console.WriteLine(msg1, capitalARing, aRingXYZ);

// Search using English-United States culture.
    ci = new CultureInfo("en-US");
    Console.WriteLine(msg2, ci.DisplayName, ci.Name);

    Console.WriteLine("Case sensitive:");
    result = aRingXYZ.StartsWith(capitalARing, false, ci);
    Console.WriteLine(msg3, result);

    Console.WriteLine("Case insensitive:");
    result = aRingXYZ.StartsWith(capitalARing, true, ci);
    Console.WriteLine(msg3, result);
    Console.WriteLine();

// Search using Swedish-Sweden culture.
    ci = new CultureInfo("sv-SE");
    Console.WriteLine(msg2, ci.DisplayName, ci.Name);

    Console.WriteLine("Case sensitive:");
    result = aRingXYZ.StartsWith(capitalARing, false, ci);
    Console.WriteLine(msg3, result);

    Console.WriteLine("Case insensitive:");
    result = aRingXYZ.StartsWith(capitalARing, true, ci);
    Console.WriteLine(msg3, result);
    }
}

/*
Note: This code example was executed on a console whose user interface 
culture is "en-US" (English-United States).

Search for the target string "�" in the string "a�xyz".

Using the English (United States) - "en-US" culture:
Case sensitive:
  The string to search ends with the target string: False
Case insensitive:
  The string to search ends with the target string: True

Using the Swedish (Sweden) - "sv-SE" culture:
Case sensitive:
  The string to search ends with the target string: False
Case insensitive:
  The string to search ends with the target string: False

*/

.NET Framework
2.0 以降で使用可能
トップに戻る
表示: