Exporter (0) Imprimer
Développer tout

String.StartsWith, méthode (String, Boolean, CultureInfo)

Détermine si le début de cette chaîne correspond à la chaîne spécifiée lors d'une comparaison à l'aide de la culture spécifiée.

Espace de noms: System
Assembly : mscorlib (dans mscorlib.dll)

public bool StartsWith (
	string value,
	bool ignoreCase,
	CultureInfo culture
)
public boolean StartsWith (
	String value, 
	boolean ignoreCase, 
	CultureInfo culture
)
public function StartsWith (
	value : String, 
	ignoreCase : boolean, 
	culture : CultureInfo
) : boolean
Non applicable.

Paramètres

value

Objet String à comparer.

ignoreCase

true pour ignorer la casse lors de la comparaison de cette chaîne et de value ; sinon, false.

culture

Informations culturelles déterminant comment cette chaîne et value sont comparées. Si culture est référence Null (Nothing en Visual Basic), la culture en cours est utilisée.

Valeur de retour

true si le paramètre value correspond au début de cette chaîne ; sinon, false.

Type d'exceptionCondition

ArgumentNullException

value est référence Null (Nothing en Visual Basic).

Cette méthode compare le paramètre value à la sous-chaîne du début de chaîne qui est de même longueur que value, et retourne une valeur indiquant leur égalité éventuelle. Pour être égal, value doit être une chaîne vide (Empty), une référence à cette même instance, ou correspondre au début de cette instance.

Cette méthode effectue une comparaison de mots (dépendante de la culture) à l'aide de la culture et de la casse spécifiées.

L'exemple de code suivant détermine si une chaîne est présente au début d'une autre chaîne. La méthode StartsWith est appelée plusieurs fois avec respect de la casse, non-respect de la casse et différentes cultures qui influencent les résultats de la recherche.

// This code example demonstrates the 
// System.String.StartsWith(String, ..., CultureInfo) method.

using System;
using System.Threading;
using System.Globalization;

class Sample 
{
    public static void Main() 
    {
    string msg1 = "Search for the target string \"{0}\" in the string \"{1}\".\n";
    string msg2 = "Using the {0} - \"{1}\" culture:";
    string msg3 = "  The string to search ends with the target string: {0}";
    bool result = false;
    CultureInfo ci;

// Define a target string to search for.
// U+00c5 = LATIN CAPITAL LETTER A WITH RING ABOVE
    string capitalARing = "\u00c5";

// Define a string to search. 
// The result of combining the characters LATIN SMALL LETTER A and COMBINING 
// RING ABOVE (U+0061, U+030a) is linguistically equivalent to the character 
// LATIN SMALL LETTER A WITH RING ABOVE (U+00e5).
    string aRingXYZ = "\u0061\u030a" + "xyz";

// Clear the screen and display an introduction.
    Console.Clear();

// Display the string to search for and the string to search.
    Console.WriteLine(msg1, capitalARing, aRingXYZ);

// Search using English-United States culture.
    ci = new CultureInfo("en-US");
    Console.WriteLine(msg2, ci.DisplayName, ci.Name);

    Console.WriteLine("Case sensitive:");
    result = aRingXYZ.StartsWith(capitalARing, false, ci);
    Console.WriteLine(msg3, result);

    Console.WriteLine("Case insensitive:");
    result = aRingXYZ.StartsWith(capitalARing, true, ci);
    Console.WriteLine(msg3, result);
    Console.WriteLine();

// Search using Swedish-Sweden culture.
    ci = new CultureInfo("sv-SE");
    Console.WriteLine(msg2, ci.DisplayName, ci.Name);

    Console.WriteLine("Case sensitive:");
    result = aRingXYZ.StartsWith(capitalARing, false, ci);
    Console.WriteLine(msg3, result);

    Console.WriteLine("Case insensitive:");
    result = aRingXYZ.StartsWith(capitalARing, true, ci);
    Console.WriteLine(msg3, result);
    }
}

/*
Note: This code example was executed on a console whose user interface 
culture is "en-US" (English-United States).

Search for the target string "" in the string "axyz".

Using the English (United States) - "en-US" culture:
Case sensitive:
  The string to search ends with the target string: False
Case insensitive:
  The string to search ends with the target string: True

Using the Swedish (Sweden) - "sv-SE" culture:
Case sensitive:
  The string to search ends with the target string: False
Case insensitive:
  The string to search ends with the target string: False

*/

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0, 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft