Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Metodo String.StartsWith (String, StringComparison)

Consente di determinare se l'inizio di questa istanza di stringa corrisponde alla stringa specificata se confrontata utilizzando l'opzione di confronto specificata.

Spazio dei nomi:  System
Assembly:  mscorlib (in mscorlib.dll)

[ComVisibleAttribute(false)]
public bool StartsWith(
	string value,
	StringComparison comparisonType
)

Parametri

value
Tipo: System.String
Stringa da confrontare.
comparisonType
Tipo: System.StringComparison
Uno dei valori di enumerazione che consente di determinare la modalità di confronto tra questa stringa e value.

Valore restituito

Tipo: System.Boolean
true se l'istanza inizia con value; in caso contrario, false.

EccezioneCondizione
ArgumentNullException

value è null.

ArgumentException

Il parametro comparisonType non è un valore StringComparison.

Il metodo StartsWith confronta il parametro value con la sottostringa all'inizio di questa stringa e restituisce un valore che specifica se sono uguali. Per essere uguali, value deve essere un riferimento a questa stessa stringa, essere la stringa vuota ("") o corrispondere all'inizio di questa stringa. Il tipo di confronto eseguito dal metodo StartsWith dipende dal valore del parametro comparisonType. Il confronto può utilizzare le convenzioni delle impostazioni cultura correnti (StringComparison.CurrentCulture e StringComparison.CurrentCultureIgnoreCase) o delle impostazioni cultura associate alla lingua inglese (StringComparison.InvariantCulture e StringComparison.InvariantCultureIgnoreCase) o può essere costituito da un confronto carattere per carattere dei punti di codice (StringComparison.Ordinal o StringComparison.OrdinalIgnoreCase). Il confronto può anche rispettare la distinzione tra maiuscole e minuscole (StringComparison.CurrentCulture, StringComparison.InvariantCulture o StringComparison.Ordinal) o ignorarla (StringComparison.CurrentCultureIgnoreCase, StringComparison.InvariantCultureIgnoreCase, StringComparison.OrdinalIgnoreCase).

Nell'esempio seguente viene determinato se una stringa inizia con una sottostringa particolare. Inizializza una matrice di stringhe bidimensionale. Il primo elemento nella seconda dimensione contiene una stringa e il secondo elemento contiene la stringa da cercare all'inizio della prima stringa. I risultati variano a seconda delle impostazioni cultura scelte, dell'applicazione o meno della distinzione fra maiuscole e minuscole e dell'eventuale esecuzione di un confronto ordinale. Si noti che quando l'istanza di stringa contiene una legatura, i confronti dipendenti dalle impostazioni cultura con i relativi caratteri consecutivi corrispondono correttamente.


using System;

public class Example
{
   public static void Main()
   {
      string[,] strings = { {"ABCdef", "abc" },                    
                            {"ABCdef", "abc" },  
                            {"œil","oe" },
                            { "læring}", "lae" } };
      for (int ctr1 = strings.GetLowerBound(0); ctr1 <= strings.GetUpperBound(0); ctr1++)
      {
            foreach (string cmpName in Enum.GetNames(typeof(StringComparison)))
            { 
               StringComparison strCmp = (StringComparison) Enum.Parse(typeof(StringComparison), 
                                                      cmpName);
               string instance = strings[ctr1, 0];
               string value = strings[ctr1, 1];
               Console.WriteLine("{0} starts with {1}: {2} ({3} comparison)", 
                                 instance, value, 
                                 instance.StartsWith(value, strCmp), 
                                 strCmp); 
            }
            Console.WriteLine();   
      }   
   }
}
// The example displays the following output:
//       ABCdef starts with abc: False (CurrentCulture comparison)
//       ABCdef starts with abc: True (CurrentCultureIgnoreCase comparison)
//       ABCdef starts with abc: False (InvariantCulture comparison)
//       ABCdef starts with abc: True (InvariantCultureIgnoreCase comparison)
//       ABCdef starts with abc: False (Ordinal comparison)
//       ABCdef starts with abc: True (OrdinalIgnoreCase comparison)
//       
//       ABCdef starts with abc: False (CurrentCulture comparison)
//       ABCdef starts with abc: True (CurrentCultureIgnoreCase comparison)
//       ABCdef starts with abc: False (InvariantCulture comparison)
//       ABCdef starts with abc: True (InvariantCultureIgnoreCase comparison)
//       ABCdef starts with abc: False (Ordinal comparison)
//       ABCdef starts with abc: True (OrdinalIgnoreCase comparison)
//       
//       œil starts with oe: True (CurrentCulture comparison)
//       œil starts with oe: True (CurrentCultureIgnoreCase comparison)
//       œil starts with oe: True (InvariantCulture comparison)
//       œil starts with oe: True (InvariantCultureIgnoreCase comparison)
//       œil starts with oe: False (Ordinal comparison)
//       œil starts with oe: False (OrdinalIgnoreCase comparison)
//       
//       læring} starts with lae: True (CurrentCulture comparison)
//       læring} starts with lae: True (CurrentCultureIgnoreCase comparison)
//       læring} starts with lae: True (InvariantCulture comparison)
//       læring} starts with lae: True (InvariantCultureIgnoreCase comparison)
//       læring} starts with lae: False (Ordinal comparison)
//       læring} starts with lae: False (OrdinalIgnoreCase comparison)


.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Libreria di classi portabile

Supportato in: Libreria di classi portabile

.NET per applicazioni Windows Store

Supportato in: Windows 8

.NET per applicazioni Windows Phone

Supportato in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft