CompareInfo.IsPrefix Método

Definição

Espaço de Nomes:: System.Globalization

Assemblagens:: mscorlib.dll, System.Globalization.dll

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.Globalization.dll

Assemblagem:: System.Runtime.dll

Assemblagem:: mscorlib.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Determina se uma cadeia começa com um prefixo específico.

Sobrecargas

Name	Description
IsPrefix(String, String)	Determina se a cadeia de origem especificada começa com o prefixo especificado.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Determina se um intervalo de caracteres apenas de leitura começa com um prefixo específico.
IsPrefix(String, String, CompareOptions)	Determina se a cadeia de origem especificada começa com o prefixo especificado usando o valor especificado CompareOptions .
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Determina se uma cadeia começa com um prefixo específico.

IsPrefix(String, String)

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Determina se a cadeia de origem especificada começa com o prefixo especificado.

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

Parâmetros

source: String

A cadeia de caracteres para pesquisar.

prefix: String

A cadeia a comparar com o início de source.

Devoluções

Boolean

true se o comprimento de prefix for menor ou igual ao comprimento de source e source começar com prefix; caso contrário, false.

Exceções

ArgumentNullException

source é null.

-ou-

prefix é null.

Exemplos

O exemplo seguinte determina se uma cadeia é o prefixo ou sufixo de outra cadeia.

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

Observações

Cada cadeia começa e termina com uma subcadeia vazia (""); Portanto, se prefix for uma cadeia vazia, este método devolve true.

Note

Quando possível, deve chamar métodos de comparação de strings que tenham um parâmetro do tipo CompareOptions para especificar o tipo de comparação esperado. Como regra geral, use opções linguísticas (usando a cultura atual) para comparar cadeias de caracteres exibidas na interface do usuário e especificar CompareOptions.Ordinal ou CompareOptions.OrdinalIgnoreCase para comparações de segurança.

Ver também

IsSuffix(String, String, CompareOptions)

Aplica-se a

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

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Determina se um intervalo de caracteres apenas de leitura começa com um prefixo específico.

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

Parâmetros

source: ReadOnlySpan<Char>

O intervalo de caracteres apenas de leitura para pesquisar.

prefix: ReadOnlySpan<Char>

O prefixo para tentar corresponder no início de source.

options: CompareOptions

Uma combinação opcional de CompareOptions valores de enumeração para usar durante a correspondência. O valor predefinido é None.

Devoluções

Boolean

true se prefix ocorrer no início de source; caso contrário, false.

Exceções

ArgumentException

options contém uma combinação não suportada de flags.

Aplica-se a

IsPrefix(String, String, CompareOptions)

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Determina se a cadeia de origem especificada começa com o prefixo especificado usando o valor especificado 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

Parâmetros

source: String

A cadeia de caracteres para pesquisar.

prefix: String

A cadeia a comparar com o início de source.

options: CompareOptions

Um valor que define como source e prefix deve ser comparado. options é ou o valor Ordinalde enumeração , ou uma combinação bit a bit de um ou mais dos seguintes valores: IgnoreCase, IgnoreSymbols, IgnoreNonSpace, IgnoreWidth, e IgnoreKanaType.

Devoluções

Boolean

true se o comprimento de prefix for menor ou igual ao comprimento de source e source começar com prefix; caso contrário, false.

Exceções

ArgumentNullException

source é null.

-ou-

prefix é null.

ArgumentException

options contém um valor inválido CompareOptions .

Exemplos

O exemplo seguinte determina se uma cadeia é o prefixo ou sufixo de outra cadeia usando 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

Observações

Cada cadeia começa e termina com uma subcadeia vazia (""); Portanto, se prefix for uma cadeia vazia, este método devolve true.

Os CompareOptions.NumericOrdering valores e CompareOptions.StringSort não são válidos para este método.

Note

Ver também

Aplica-se a

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

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Determina se uma cadeia começa com um prefixo específico.

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

Parâmetros

source: ReadOnlySpan<Char>

O intervalo de caracteres apenas de leitura para pesquisar.

prefix: ReadOnlySpan<Char>

O intervalo de apenas leitura dos caracteres que contêm o prefixo para tentar corresponder no início de source.

options: CompareOptions

A CompareOptions usar durante o jogo.

matchLength: Int32

Quando este método retorna, contém o número de caracteres de source que corresponderam ao prefixo desejado. Isto pode ser diferente do comprimento de prefix se for realizada uma comparação linguística. Define para 0 se o prefixo não corresponder.

Devoluções

Boolean

true se prefix ocorrer no início de source; caso contrário, false.

Exceções

ArgumentException

options contém uma combinação não suportada de flags.

Observações

Este método tem maior sobrecarga do que outras IsPrefix(String, String, CompareOptions) sobrecargas que não exigem um matchLength argumento. Chame a isto sobrecarga apenas se precisar da informação sobre a duração do jogo.

Aplica-se a

Comentários

Esta página foi útil?