CompareInfo.IsPrefix Metoda

Reference

Definice

Obor názvů:: System.Globalization

Sestavení:: System.Globalization.dll

Sestavení:: System.Runtime.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Určuje, zda řetězec začíná konkrétní předponou.

Přetížení

IsPrefix(String, String)	Určuje, zda zadaný zdrojový řetězec začíná zadanou předponou.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Určuje, zda rozsah znaků jen pro čtení začíná konkrétní předponou.
IsPrefix(String, String, CompareOptions)	Určuje, jestli zadaný zdrojový řetězec začíná zadanou předponou pomocí zadané CompareOptions hodnoty.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Určuje, zda řetězec začíná konkrétní předponou.

IsPrefix(String, String)

Zdroj:: CompareInfo.cs

Zdroj:: CompareInfo.cs

Zdroj:: CompareInfo.cs

Určuje, zda zadaný zdrojový řetězec začíná zadanou předponou.

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

Parametry

source: String

Řetězec, ve který se má hledat.

prefix: String

Řetězec, který se má porovnat se začátkem source.

Návraty

Boolean

true pokud je délka prefix menší než nebo rovna délce source a source začíná na prefix; v opačném případě false.

Výjimky

ArgumentNullException

source je null.

-nebo-

prefix je null.

Příklady

Následující příklad určuje, jestli je řetězec předponou nebo příponou jiného řetězce.

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

Poznámky

Každý řetězec začíná a končí prázdným podřetězcem (""); Proto pokud prefix je prázdný řetězec, tato metoda vrátí true.

Poznámka

Pokud je to možné, měli byste volat metody porovnávání řetězců, které mají parametr typu CompareOptions , abyste určili druh očekávaného porovnání. Obecně platí, že pro porovnávání řetězců zobrazených v uživatelském rozhraní a zadání nebo CompareOptions.OrdinalIgnoreCase pro porovnání zabezpečení používejte CompareOptions.Ordinal jazykové možnosti (s použitím aktuální jazykové verze).

Viz také

IsSuffix(String, String, CompareOptions)

Platí pro

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

Zdroj:: CompareInfo.cs

Zdroj:: CompareInfo.cs

Zdroj:: CompareInfo.cs

Určuje, zda rozsah znaků jen pro čtení začíná konkrétní předponou.

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

Parametry

source: ReadOnlySpan<Char>

Rozsah znaků jen pro čtení, ve které se má hledat.

prefix: ReadOnlySpan<Char>

Předpona, která se má pokusit o shodu na začátku .source

options: CompareOptions

Volitelná kombinace hodnot výčtu CompareOptions , které se mají použít během shody. Výchozí hodnota je None.

Návraty

Boolean

truepokud prefix se objeví na začátku , sourcejinak . false

Výjimky

ArgumentException

options obsahuje nepodporovanou kombinaci příznaků.

Platí pro

IsPrefix(String, String, CompareOptions)

Zdroj:: CompareInfo.cs

Zdroj:: CompareInfo.cs

Zdroj:: CompareInfo.cs

Určuje, jestli zadaný zdrojový řetězec začíná zadanou předponou pomocí zadané CompareOptions hodnoty.

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

Parametry

source: String

Řetězec, ve který se má hledat.

prefix: String

Řetězec, který se má porovnat se začátkem source.

options: CompareOptions

Hodnota, která definuje, jak source a prefix má být porovnána. options je buď hodnota Ordinalvýčtu , nebo bitová kombinace jedné nebo více následujících hodnot: IgnoreCase, IgnoreSymbols, IgnoreNonSpace, IgnoreWidtha IgnoreKanaType.

Návraty

Boolean

true pokud je délka prefix menší než nebo rovna délce source a source začíná na prefix; v opačném případě false.

Výjimky

ArgumentNullException

source je null.

-nebo-

prefix je null.

ArgumentException

options obsahuje neplatnou CompareOptions hodnotu.

Příklady

Následující příklad pomocí určuje, jestli je řetězec předponou nebo příponou jiného řetězce.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

Poznámky

Každý řetězec začíná a končí prázdným podřetězcem (""); Proto pokud prefix je prázdný řetězec, tato metoda vrátí true.

Hodnota CompareOptions.StringSort není pro tuto metodu platná.

Poznámka

Viz také

Platí pro

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

Zdroj:: CompareInfo.cs

Zdroj:: CompareInfo.cs

Zdroj:: CompareInfo.cs

Určuje, zda řetězec začíná konkrétní předponou.

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

Parametry

source: ReadOnlySpan<Char>

Rozsah znaků jen pro čtení, ve které se má hledat.

prefix: ReadOnlySpan<Char>

Rozsah znaků jen pro čtení obsahující předponu, která se má pokusit o shodu na začátku .source

options: CompareOptions

Hodnota CompareOptions , která se má použít během shody.

matchLength: Int32

Když se tato metoda vrátí, obsahuje počet znaků source , které odpovídají požadované předponě. Tato délka se může lišit od délky prefix , pokud se provede lingvistické porovnání. Pokud se předpona neshodovala, nastavte hodnotu 0.

Návraty

Boolean

truepokud prefix se objeví na začátku , sourcejinak . false

Výjimky

ArgumentException

options obsahuje nepodporovanou kombinaci příznaků.

Poznámky

Tato metoda má větší režii než jiná IsPrefix(String, String, CompareOptions) přetížení, která nepřebírají matchLength argument. Volání tohoto přetížení pouze v případě, že požadujete informace o délce shody.

Platí pro

Sdílet prostřednictvím

CompareInfo.IsPrefix Metoda

Definice

Přetížení

IsPrefix(String, String)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

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

Parametry

Návraty

Výjimky

Platí pro

IsPrefix(String, String, CompareOptions)

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

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

Parametry

Návraty

Výjimky

Poznámky

Platí pro

Další materiály