CompareInfo.IsPrefix メソッド

定義

名前空間:: System.Globalization

アセンブリ:: mscorlib.dll, System.Globalization.dll

アセンブリ:: mscorlib.dll

アセンブリ:: System.Globalization.dll

アセンブリ:: netstandard.dll

重要

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

文字列が特定のプレフィックスで始まるかどうかを判断します。

オーバーロード

名前	説明
IsPrefix(String, String)	指定したソース文字列が、指定したプレフィックスで始まるかどうかを判断します。
IsPrefix(String, String, CompareOptions)	指定した CompareOptions 値を使用して、指定したソース文字列が指定したプレフィックスで始まるかどうかを判断します。

IsPrefix(String, String)

指定したソース文字列が、指定したプレフィックスで始まるかどうかを判断します。

public:
 virtual bool IsPrefix(System::String ^ source, System::String ^ prefix);

public virtual bool IsPrefix(string source, string prefix);

abstract member IsPrefix : string * string -> bool
override this.IsPrefix : string * string -> bool

Public Overridable Function IsPrefix (source As String, prefix As String) As Boolean

パラメーター

source: String

検索する文字列。

prefix: String

sourceの先頭と比較する文字列。

返品

Boolean

true prefixの長さがsourceの長さ以下で、sourceがprefixで始まる場合はfalse。

例外

ArgumentNullException

source は nullです。

-または-

prefix は nullです。

例

次の例では、文字列が別の文字列のプレフィックスかサフィックスかを決定します。

using System;
using System.Globalization;

public class SamplesCompareInfo  {

   public static void Main()  {

      // Defines the strings to compare.
      String myStr1 = "calle";
      String myStr2 = "llegar";
      String myXfix = "lle";

      // Uses the CompareInfo property of the InvariantCulture.
      CompareInfo myComp = CultureInfo.InvariantCulture.CompareInfo;

      // Determines whether myXfix is a prefix of "calle" and "llegar".
      Console.WriteLine( "IsPrefix( {0}, {1} ) : {2}", myStr1, myXfix, myComp.IsPrefix( myStr1, myXfix ) );
      Console.WriteLine( "IsPrefix( {0}, {1} ) : {2}", myStr2, myXfix, myComp.IsPrefix( myStr2, myXfix ) );

      // Determines whether myXfix is a suffix of "calle" and "llegar".
      Console.WriteLine( "IsSuffix( {0}, {1} ) : {2}", myStr1, myXfix, myComp.IsSuffix( myStr1, myXfix ) );
      Console.WriteLine( "IsSuffix( {0}, {1} ) : {2}", myStr2, myXfix, myComp.IsSuffix( myStr2, myXfix ) );
   }
}


/*
This code produces the following output.

IsPrefix( calle, lle ) : False
IsPrefix( llegar, lle ) : True
IsSuffix( calle, lle ) : True
IsSuffix( llegar, lle ) : False

*/

Imports System.Globalization

Public Class SamplesCompareInfo

   Public Shared Sub Main()

      ' Defines the strings to compare.
      Dim myStr1 As [String] = "calle"
      Dim myStr2 As [String] = "llegar"
      Dim myXfix As [String] = "lle"

      ' Uses the CompareInfo property of the InvariantCulture.
      Dim myComp As CompareInfo = CultureInfo.InvariantCulture.CompareInfo

      ' Determines whether myXfix is a prefix of "calle" and "llegar".
      Console.WriteLine("IsPrefix( {0}, {1} ) : {2}", myStr1, myXfix, myComp.IsPrefix(myStr1, myXfix))
      Console.WriteLine("IsPrefix( {0}, {1} ) : {2}", myStr2, myXfix, myComp.IsPrefix(myStr2, myXfix))

      ' Determines whether myXfix is a suffix of "calle" and "llegar".
      Console.WriteLine("IsSuffix( {0}, {1} ) : {2}", myStr1, myXfix, myComp.IsSuffix(myStr1, myXfix))
      Console.WriteLine("IsSuffix( {0}, {1} ) : {2}", myStr2, myXfix, myComp.IsSuffix(myStr2, myXfix))

   End Sub

End Class


'This code produces the following output.
'
'IsPrefix( calle, lle ) : False
'IsPrefix( llegar, lle ) : True
'IsSuffix( calle, lle ) : True
'IsSuffix( llegar, lle ) : False

注釈

すべての文字列は、空の部分文字列 ("") で始まり、終わります。したがって、 prefix が空の文字列の場合、このメソッドは trueを返します。

Note

可能であれば、 CompareOptions 型のパラメーターを持つ文字列比較メソッドを呼び出して、予想される比較の種類を指定する必要があります。一般的なルールとして、ユーザーインターフェイスに表示される文字列を比較するために言語オプション (現在のカルチャを使用) を使用し、セキュリティ比較に CompareOptions.Ordinal または CompareOptions.OrdinalIgnoreCase を指定します。

こちらもご覧ください

IsSuffix(String, String, CompareOptions)

適用対象

IsPrefix(String, String, CompareOptions)

指定した CompareOptions 値を使用して、指定したソース文字列が指定したプレフィックスで始まるかどうかを判断します。

public:
 virtual bool IsPrefix(System::String ^ source, System::String ^ prefix, System::Globalization::CompareOptions options);

public virtual bool IsPrefix(string source, string prefix, System.Globalization.CompareOptions options);

abstract member IsPrefix : string * string * System.Globalization.CompareOptions -> bool
override this.IsPrefix : string * string * System.Globalization.CompareOptions -> bool

Public Overridable Function IsPrefix (source As String, prefix As String, options As CompareOptions) As Boolean

パラメーター

source: String

検索する文字列。

prefix: String

sourceの先頭と比較する文字列。

options: CompareOptions

sourceとprefixの比較方法を定義する値。 options は、列挙値 Ordinalか、 IgnoreCase、 IgnoreSymbols、 IgnoreNonSpace、 IgnoreWidth、 IgnoreKanaTypeのいずれかの値のビットごとの組み合わせです。

返品

Boolean

true prefixの長さがsourceの長さ以下で、sourceがprefixで始まる場合はfalse。

例外

ArgumentNullException

source は nullです。

-または-

prefix は nullです。

ArgumentException

options には無効な CompareOptions 値が含まれています。

例

次の例では、 CompareOptionsを使用して、文字列が別の文字列のプレフィックスまたはサフィックスであるかどうかを判断します。

using System;
using System.Globalization;

public class SamplesCompareInfo  {

   public static void Main()  {

      // Defines the strings to compare.
      String myStr1 = "calle";
      String myStr2 = "llegar";
      String myXfix = "LLE";

      // Uses the CompareInfo property of the InvariantCulture.
      CompareInfo myComp = CultureInfo.InvariantCulture.CompareInfo;

      Console.WriteLine( "IsSuffix \"{0}\", \"{1}\"", myStr1, myXfix );
      Console.WriteLine( "   With no CompareOptions            : {0}", myComp.IsSuffix( myStr1, myXfix ) );
      Console.WriteLine( "   With None                         : {0}", myComp.IsSuffix( myStr1, myXfix, CompareOptions.None ) );
      Console.WriteLine( "   With Ordinal                      : {0}", myComp.IsSuffix( myStr1, myXfix, CompareOptions.Ordinal ) );
      Console.WriteLine( "   With IgnoreCase                   : {0}", myComp.IsSuffix( myStr1, myXfix, CompareOptions.IgnoreCase ) );

      Console.WriteLine( "IsPrefix \"{0}\", \"{1}\"", myStr2, myXfix );
      Console.WriteLine( "   With no CompareOptions            : {0}", myComp.IsPrefix( myStr2, myXfix ) );
      Console.WriteLine( "   With None                         : {0}", myComp.IsPrefix( myStr2, myXfix, CompareOptions.None ) );
      Console.WriteLine( "   With Ordinal                      : {0}", myComp.IsPrefix( myStr2, myXfix, CompareOptions.Ordinal ) );
      Console.WriteLine( "   With IgnoreCase                   : {0}", myComp.IsPrefix( myStr2, myXfix, CompareOptions.IgnoreCase ) );
   }
}


/*
This code produces the following output.

IsSuffix "calle", "LLE"
   With no CompareOptions            : False
   With None                         : False
   With Ordinal                      : False
   With IgnoreCase                   : True
IsPrefix "llegar", "LLE"
   With no CompareOptions            : False
   With None                         : False
   With Ordinal                      : False
   With IgnoreCase                   : True

*/

Imports System.Globalization

Public Class SamplesCompareInfo

   Public Shared Sub Main()

      ' Defines the strings to compare.
      Dim myStr1 As [String] = "calle"
      Dim myStr2 As [String] = "llegar"
      Dim myXfix As [String] = "LLE"

      ' Uses the CompareInfo property of the InvariantCulture.
      Dim myComp As CompareInfo = CultureInfo.InvariantCulture.CompareInfo

      Console.WriteLine("IsSuffix ""{0}"", ""{1}""", myStr1, myXfix)
      Console.WriteLine("   With no CompareOptions            : {0}", myComp.IsSuffix(myStr1, myXfix))
      Console.WriteLine("   With None                         : {0}", myComp.IsSuffix(myStr1, myXfix, CompareOptions.None))
      Console.WriteLine("   With Ordinal                      : {0}", myComp.IsSuffix(myStr1, myXfix, CompareOptions.Ordinal))
      Console.WriteLine("   With IgnoreCase                   : {0}", myComp.IsSuffix(myStr1, myXfix, CompareOptions.IgnoreCase))

      Console.WriteLine("IsPrefix ""{0}"", ""{1}""", myStr2, myXfix)
      Console.WriteLine("   With no CompareOptions            : {0}", myComp.IsPrefix(myStr2, myXfix))
      Console.WriteLine("   With None                         : {0}", myComp.IsPrefix(myStr2, myXfix, CompareOptions.None))
      Console.WriteLine("   With Ordinal                      : {0}", myComp.IsPrefix(myStr2, myXfix, CompareOptions.Ordinal))
      Console.WriteLine("   With IgnoreCase                   : {0}", myComp.IsPrefix(myStr2, myXfix, CompareOptions.IgnoreCase))

   End Sub

End Class


'This code produces the following output.
'
'IsSuffix "calle", "LLE"
'   With no CompareOptions            : False
'   With None                         : False
'   With Ordinal                      : False
'   With IgnoreCase                   : True
'IsPrefix "llegar", "LLE"
'   With no CompareOptions            : False
'   With None                         : False
'   With Ordinal                      : False
'   With IgnoreCase                   : True

注釈

すべての文字列は、空の部分文字列 ("") で始まり、終わります。したがって、 prefix が空の文字列の場合、このメソッドは trueを返します。

CompareOptions.NumericOrderingとCompareOptions.StringSortの値は、このメソッドでは無効です。

Note

こちらもご覧ください

適用対象

フィードバック

このページはお役に立ちましたか?