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

Sobrecargas

Name	Description
IsSuffix(String, String)	Determina se a cadeia de origem especificada termina com o sufixo especificado.
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Determina se um intervalo de caracteres apenas de leitura termina com um sufixo específico.
IsSuffix(String, String, CompareOptions)	Determina se a cadeia de origem especificada termina com o sufixo especificado usando o valor especificado CompareOptions .
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Determina se uma cadeia 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 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 para pesquisar.

suffix: String

A cadeia para comparar com o final de source.

Devoluções

Boolean

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

Exceções

ArgumentNullException

source é null.

-ou-

suffix é 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 suffix 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

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 de caracteres apenas de leitura 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 de caracteres apenas de leitura para pesquisar.

suffix: ReadOnlySpan<Char>

O sufixo para tentar corresponder no final 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 suffix ocorrer no final de source; caso contrário, false.

Exceções

ArgumentException

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

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 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 para pesquisar.

suffix: String

A cadeia para comparar com o final de source.

options: CompareOptions

Um valor que define como source e suffix deve ser comparado. options é ou o valor Ordinal de enumeração usado por si próprio, ou a 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 suffix for menor ou igual ao comprimento de source e source terminar em 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 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 suffix 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

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 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 de caracteres apenas de leitura para pesquisar.

suffix: ReadOnlySpan<Char>

O intervalo de apenas leitura dos caracteres contendo o sufixo para tentar corresponder no final 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 sufixo desejado. Isto pode ser diferente do comprimento de suffix se for realizada uma comparação linguística. Definido para 0 se o sufixo não corresponder.

Devoluções

Boolean

true se suffix ocorrer no final 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 IsSuffix(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?