CompareInfo.IsPrefix Metode

Referensi

Definisi

Ruang nama:: System.Globalization

Rakitan:: System.Globalization.dll

Rakitan:: System.Runtime.dll

Rakitan:: mscorlib.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menentukan apakah string dimulai dengan awalan tertentu.

Overload

IsPrefix(String, String)	Menentukan apakah string sumber yang ditentukan dimulai dengan awalan yang ditentukan.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Menentukan apakah rentang karakter baca-saja dimulai dengan awalan tertentu.
IsPrefix(String, String, CompareOptions)	Menentukan apakah string sumber yang ditentukan dimulai dengan awalan yang ditentukan menggunakan nilai yang ditentukan CompareOptions .
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Menentukan apakah string dimulai dengan awalan tertentu.

IsPrefix(String, String)

Sumber:: CompareInfo.cs

Sumber:: CompareInfo.cs

Sumber:: CompareInfo.cs

Menentukan apakah string sumber yang ditentukan dimulai dengan awalan yang ditentukan.

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

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

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

public bool IsPrefix (string source, string prefix);

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

member this.IsPrefix : string * string -> bool

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

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

Parameter

source: String

String untuk dicari.

prefix: String

String untuk dibandingkan dengan awal source.

Mengembalikan

Boolean

true jika panjang prefix kurang dari atau sama dengan panjang source dan source dimulai dengan prefix; jika tidak, false.

Pengecualian

ArgumentNullException

sourceadalah null.

-atau-

prefixadalah null.

Contoh

Contoh berikut menentukan apakah string adalah awalan atau akhiran string lain.

using namespace System;
using namespace System::Globalization;
int 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 S"calle" and S"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 S"calle" and S"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

*/

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

Keterangan

Setiap string dimulai dan diakhbungi dengan substring kosong (""); oleh karena itu, jika prefix adalah string kosong, metode ini mengembalikan true.

Catatan

Jika memungkinkan, Anda harus memanggil metode perbandingan string yang memiliki parameter jenis CompareOptions untuk menentukan jenis perbandingan yang diharapkan. Sebagai aturan umum, gunakan opsi linguistik (menggunakan budaya saat ini) untuk membandingkan string yang ditampilkan di antarmuka pengguna dan menentukan CompareOptions.Ordinal atau CompareOptions.OrdinalIgnoreCase untuk perbandingan keamanan.

Lihat juga

IsSuffix(String, String, CompareOptions)

Berlaku untuk

IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)

Sumber:: CompareInfo.cs

Sumber:: CompareInfo.cs

Sumber:: CompareInfo.cs

Menentukan apakah rentang karakter baca-saja dimulai dengan awalan tertentu.

public bool IsPrefix (ReadOnlySpan<char> source, ReadOnlySpan<char> prefix, System.Globalization.CompareOptions options = System.Globalization.CompareOptions.None);

member this.IsPrefix : ReadOnlySpan<char> * ReadOnlySpan<char> * System.Globalization.CompareOptions -> bool

Public Function IsPrefix (source As ReadOnlySpan(Of Char), prefix As ReadOnlySpan(Of Char), Optional options As CompareOptions = System.Globalization.CompareOptions.None) As Boolean

Parameter

source: ReadOnlySpan<Char>

Rentang karakter baca-saja untuk dicari di dalamnya.

prefix: ReadOnlySpan<Char>

Awalan untuk mencoba mencocokkan di awal source.

options: CompareOptions

Kombinasi opsional nilai CompareOptions enumerasi untuk digunakan selama pencocokan. Nilai defaultnya adalah None.

Mengembalikan

Boolean

true jika prefix terjadi pada awal source; jika tidak, false.

Pengecualian

ArgumentException

options berisi kombinasi bendera yang tidak didukung.

Berlaku untuk

IsPrefix(String, String, CompareOptions)

Sumber:: CompareInfo.cs

Sumber:: CompareInfo.cs

Sumber:: CompareInfo.cs

Menentukan apakah string sumber yang ditentukan dimulai dengan awalan yang ditentukan menggunakan nilai yang ditentukan CompareOptions .

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

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

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

public 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

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

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

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

Parameter

source: String

String untuk dicari.

prefix: String

String untuk dibandingkan dengan awal source.

options: CompareOptions

Nilai yang menentukan bagaimana source dan prefix harus dibandingkan. optionsadalah nilai Ordinalenumerasi , atau kombinasi bitwise dari satu atau beberapa nilai berikut: IgnoreCase, , IgnoreSymbols, IgnoreNonSpace IgnoreWidth, dan IgnoreKanaType.

Mengembalikan

Boolean

true jika panjang prefix kurang dari atau sama dengan panjang source dan source dimulai dengan prefix; jika tidak, false.

Pengecualian

ArgumentNullException

sourceadalah null.

-atau-

prefixadalah null.

ArgumentException

options berisi nilai yang tidak valid CompareOptions .

Contoh

Contoh berikut menentukan apakah string adalah awalan atau akhiran string lain menggunakan CompareOptions.

using namespace System;
using namespace System::Globalization;
int 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
*/

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

Keterangan

Setiap string dimulai dan diakhbungi dengan substring kosong (""); oleh karena itu, jika prefix adalah string kosong, metode ini mengembalikan true.

Nilai CompareOptions.StringSort tidak valid untuk metode ini.

Catatan

Lihat juga

Berlaku untuk

IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)

Sumber:: CompareInfo.cs

Sumber:: CompareInfo.cs

Sumber:: CompareInfo.cs

Menentukan apakah string dimulai dengan awalan tertentu.

public:
 bool IsPrefix(ReadOnlySpan<char> source, ReadOnlySpan<char> prefix, System::Globalization::CompareOptions options, [Runtime::InteropServices::Out] int % matchLength);

public bool IsPrefix (ReadOnlySpan<char> source, ReadOnlySpan<char> prefix, System.Globalization.CompareOptions options, out int matchLength);

member this.IsPrefix : ReadOnlySpan<char> * ReadOnlySpan<char> * System.Globalization.CompareOptions * int -> bool

Public Function IsPrefix (source As ReadOnlySpan(Of Char), prefix As ReadOnlySpan(Of Char), options As CompareOptions, ByRef matchLength As Integer) As Boolean

Parameter

source: ReadOnlySpan<Char>

Rentang karakter baca-saja untuk dicari di dalamnya.

prefix: ReadOnlySpan<Char>

Rentang karakter baca-saja yang berisi awalan untuk mencoba mencocokkan di awal source.

options: CompareOptions

yang CompareOptions digunakan selama pencocokan.

matchLength: Int32

Ketika metode ini kembali, berisi jumlah karakter source yang cocok dengan awalan yang diinginkan. Ini mungkin berbeda dari panjang jika perbandingan prefix linguistik dilakukan. Atur ke 0 jika awalan tidak cocok.

Mengembalikan

Boolean

true jika prefix terjadi pada awal source; jika tidak, false.

Pengecualian

ArgumentException

options berisi kombinasi bendera yang tidak didukung.

Keterangan

Metode ini memiliki overhead yang lebih besar daripada kelebihan beban lain IsPrefix(String, String, CompareOptions) yang tidak mengambil matchLength argumen. Panggil kelebihan beban ini hanya jika Anda memerlukan informasi panjang pencocokan.

Berlaku untuk

CompareInfo.IsPrefix Metode

Definisi

Overload

IsPrefix(String, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)

Parameter

Mengembalikan

Pengecualian

Berlaku untuk

IsPrefix(String, String, CompareOptions)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: