CompareInfo.IsSuffix Método

Definição

Namespace:: System.Globalization

Assemblies:: mscorlib.dll, System.Globalization.dll

Assemblies:: netstandard.dll, System.Runtime.dll

Assembly:: System.Globalization.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Determina se uma cadeia de caracteres termina com um sufixo específico.

Sobrecargas

Nome	Description
IsSuffix(String, String)	Determina se a cadeia de caracteres de origem especificada termina com o sufixo especificado.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Determina se um intervalo somente leitura de caracteres termina com um sufixo específico.
IsSuffix(String, String, CompareOptions)	Determina se a cadeia de caracteres de origem especificada termina com o sufixo especificado usando o valor especificado CompareOptions .
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Determina se uma cadeia de caracteres termina com um sufixo específico.

IsSuffix(String, String)

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Determina se a cadeia de caracteres de origem especificada termina com o sufixo especificado.

public:
 virtual bool IsSuffix(System::String ^ source, System::String ^ suffix);

public:
 bool IsSuffix(System::String ^ source, System::String ^ suffix);

public virtual bool IsSuffix(string source, string suffix);

public bool IsSuffix(string source, string suffix);

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

member this.IsSuffix : string * string -> bool

Public Overridable Function IsSuffix (source As String, suffix As String) As Boolean

Public Function IsSuffix (source As String, suffix As String) As Boolean

Parâmetros

source: String

A cadeia de caracteres na qual pesquisar.

suffix: String

A cadeia de caracteres a ser comparada com o final de source.

Retornos

Boolean

true se o comprimento for suffix menor ou igual ao comprimento e sourcesource terminar com suffix; caso contrário, false.

Exceções

ArgumentNullException

source é null.

- ou -

suffix é null.

Exemplos

O exemplo a seguir determina se uma cadeia de caracteres é o prefixo ou sufixo de outra cadeia de caracteres.

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

Comentários

Cada cadeia de caracteres começa e termina com uma subcadeia de caracteres vazia (""); portanto, se for uma cadeia de caracteres suffix vazia, esse método retornará true.

Note

Quando possível, você deve chamar métodos de comparação de cadeia de caracteres que têm um parâmetro de 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.

Confira também

IsPrefix(String, String, CompareOptions)

Aplica-se a

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

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Determina se um intervalo somente leitura de caracteres termina com um sufixo específico.

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

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

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

Parâmetros

source: ReadOnlySpan<Char>

O intervalo somente leitura de caracteres a serem pesquisados.

suffix: ReadOnlySpan<Char>

O sufixo a ser correspondido no final de source.

options: CompareOptions

Uma combinação opcional de valores de CompareOptions enumeração a serem usados durante a correspondência. O valor padrão é None.

Retornos

Boolean

true se suffix ocorrer no final de source; caso contrário, false.

Exceções

ArgumentException

options contém uma combinação sem suporte de sinalizadores.

Aplica-se a

IsSuffix(String, String, CompareOptions)

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Origem:: CompareInfo.cs

Determina se a cadeia de caracteres de origem especificada termina com o sufixo especificado usando o valor especificado CompareOptions .

public:
 virtual bool IsSuffix(System::String ^ source, System::String ^ suffix, System::Globalization::CompareOptions options);

public:
 bool IsSuffix(System::String ^ source, System::String ^ suffix, System::Globalization::CompareOptions options);

public virtual bool IsSuffix(string source, string suffix, System.Globalization.CompareOptions options);

public bool IsSuffix(string source, string suffix, System.Globalization.CompareOptions options);

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

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

Public Overridable Function IsSuffix (source As String, suffix As String, options As CompareOptions) As Boolean

Public Function IsSuffix (source As String, suffix As String, options As CompareOptions) As Boolean

Parâmetros

source: String

A cadeia de caracteres na qual pesquisar.

suffix: String

A cadeia de caracteres a ser comparada com o final de source.

options: CompareOptions

Um valor que define como source e suffix deve ser comparado. optionsé o valor Ordinal de enumeração usado por si mesmo ou a combinação bit a bit de um ou mais dos seguintes valores: IgnoreCase, , IgnoreSymbols, IgnoreNonSpacee IgnoreWidth IgnoreKanaType.

Retornos

Boolean

true se o comprimento for suffix menor ou igual ao comprimento e sourcesource terminar com suffix; caso contrário, false.

Exceções

ArgumentNullException

source é null.

- ou -

suffix é null.

ArgumentException

options contém um valor inválido CompareOptions .

Exemplos

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

Comentários

Cada cadeia de caracteres começa e termina com uma subcadeia de caracteres vazia (""); portanto, se for uma cadeia de caracteres suffix vazia, esse método retornará true.

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

Note

Confira também

Aplica-se a

IsSuffix(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 de caracteres termina com um sufixo específico.

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

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

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

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

Parâmetros

source: ReadOnlySpan<Char>

O intervalo somente leitura de caracteres a serem pesquisados.

suffix: ReadOnlySpan<Char>

O intervalo somente leitura de caracteres que contém o sufixo para tentar corresponder ao final de source.

options: CompareOptions

O CompareOptions para usar durante a correspondência.

matchLength: Int32

Quando esse método é retornado, contém o número de caracteres que source correspondem ao sufixo desejado. Isso pode ser diferente do tamanho de suffix se uma comparação linguística for executada. Defina como 0 se o sufixo não corresponder.

Retornos

Boolean

true se suffix ocorrer no final de source; caso contrário, false.

Exceções

ArgumentException

options contém uma combinação sem suporte de sinalizadores.

Comentários

Esse método tem uma sobrecarga maior do que outras IsSuffix(String, String, CompareOptions) sobrecargas que não assumem um matchLength argumento. Chame essa sobrecarga somente se você precisar das informações de comprimento da correspondência.

Aplica-se a

Comentários

Esta página foi útil?