CompareInfo.IsPrefix Metodo

Definizione

Spazio dei nomi:: System.Globalization

Assembly:: mscorlib.dll, System.Globalization.dll

Assembly:: netstandard.dll, System.Runtime.dll

Assembly:: System.Globalization.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Determina se una stringa inizia con un prefisso specifico.

Overload

Nome	Descrizione
IsPrefix(String, String)	Determina se la stringa di origine specificata inizia con il prefisso specificato.
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	Determina se un intervallo di caratteri di sola lettura inizia con un prefisso specifico.
IsPrefix(String, String, CompareOptions)	Determina se la stringa di origine specificata inizia con il prefisso specificato utilizzando il valore specificato CompareOptions .
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	Determina se una stringa inizia con un prefisso specifico.

IsPrefix(String, String)

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Determina se la stringa di origine specificata inizia con il prefisso specificato.

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

Parametri

source: String

Stringa in cui eseguire la ricerca.

prefix: String

Stringa da confrontare con l'inizio di source.

Valori restituiti

Boolean

true se la lunghezza di prefix è minore o uguale alla lunghezza di source e source inizia con prefix; in caso contrario, false.

Eccezioni

ArgumentNullException

source è null.

oppure

prefix è null.

Esempio

Nell'esempio seguente viene determinato se una stringa è il prefisso o il suffisso di un'altra stringa.

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

Commenti

Ogni stringa inizia e termina con una sottostringa vuota (""); pertanto, se prefix è una stringa vuota, questo metodo restituisce true.

Note

Quando possibile, è necessario chiamare metodi di confronto di stringhe con un parametro di tipo CompareOptions per specificare il tipo di confronto previsto. Come regola generale, usare le opzioni linguistiche (con la cultura corrente) per confrontare le stringhe visualizzate nell'interfaccia utente e specificare CompareOptions.Ordinal o CompareOptions.OrdinalIgnoreCase per confronti di sicurezza.

Vedi anche

IsSuffix(String, String, CompareOptions)

Si applica a

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

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Determina se un intervallo di caratteri di sola lettura inizia con un prefisso specifico.

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

Parametri

source: ReadOnlySpan<Char>

Intervallo di caratteri di sola lettura in cui eseguire la ricerca.

prefix: ReadOnlySpan<Char>

Prefisso per tentare la corrispondenza all'inizio di source.

options: CompareOptions

Combinazione facoltativa di valori di CompareOptions enumerazione da utilizzare durante la corrispondenza. Il valore predefinito è None.

Valori restituiti

Boolean

true se prefix si verifica all'inizio di source; in caso contrario, false.

Eccezioni

ArgumentException

options contiene una combinazione non supportata di flag.

Si applica a

IsPrefix(String, String, CompareOptions)

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Determina se la stringa di origine specificata inizia con il prefisso specificato utilizzando il valore specificato 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

Parametri

source: String

Stringa in cui eseguire la ricerca.

prefix: String

Stringa da confrontare con l'inizio di source.

options: CompareOptions

Valore che definisce come source e prefix deve essere confrontato. optionsè il valore Ordinaldi enumerazione o una combinazione bit per bit di uno o più dei valori seguenti: IgnoreCase, IgnoreSymbols IgnoreNonSpace, IgnoreWidth, e IgnoreKanaType.

Valori restituiti

Boolean

true se la lunghezza di prefix è minore o uguale alla lunghezza di source e source inizia con prefix; in caso contrario, false.

Eccezioni

ArgumentNullException

source è null.

oppure

prefix è null.

ArgumentException

options contiene un valore non valido CompareOptions .

Esempio

Nell'esempio seguente viene determinato se una stringa è il prefisso o il suffisso di un'altra stringa 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

Commenti

Ogni stringa inizia e termina con una sottostringa vuota (""); pertanto, se prefix è una stringa vuota, questo metodo restituisce true.

I CompareOptions.NumericOrdering valori e CompareOptions.StringSort non sono validi per questo metodo.

Note

Vedi anche

Si applica a

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

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Origine:: CompareInfo.cs

Determina se una stringa inizia con un prefisso specifico.

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

Parametri

source: ReadOnlySpan<Char>

Intervallo di caratteri di sola lettura in cui eseguire la ricerca.

prefix: ReadOnlySpan<Char>

Intervallo di caratteri di sola lettura contenente il prefisso per tentare di trovare una corrispondenza all'inizio di source.

options: CompareOptions

Oggetto CompareOptions da utilizzare durante la corrispondenza.

matchLength: Int32

Quando termina, questo metodo contiene il numero di caratteri di source che corrispondono al prefisso desiderato. Questo può essere diverso dalla lunghezza di prefix se viene eseguito un confronto linguistico. Impostare su 0 se il prefisso non corrisponde.

Valori restituiti

Boolean

true se prefix si verifica all'inizio di source; in caso contrario, false.

Eccezioni

ArgumentException

options contiene una combinazione non supportata di flag.

Commenti

Questo metodo ha un sovraccarico maggiore rispetto ad altri IsPrefix(String, String, CompareOptions) overload che non accettano un matchLength argomento. Chiamare questo overload solo se sono necessarie le informazioni sulla lunghezza della corrispondenza.

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?