Fonctions de chaînes canoniques
Entity SQL inclut des fonctions canoniques de chaîne.
Notes
Le tableau suivant présente les fonctions canoniques Entity SQL de chaîne.
| Fonction | Description |
|---|---|
Concat(string1, string2) |
Retourne une chaîne qui contient string2 ajouté à string1.Arguments string1 : chaîne à laquelle string2 est ajouté.string2 : chaîne ajoutée à string1.Valeur de retour Un String. Une erreur se produit si la longueur de la chaîne de valeur de retour est supérieure à la longueur maximale autorisée.Exemple -- The following example returns abcxyz.Concat('abc', 'xyz') |
Contains(string, target) |
Retourne true si target est contenu dans string.Arguments string : chaîne dans laquelle la recherche est effectuée.target : chaîne cible recherchée.Valeur de retour true si target est contenu dans string ; sinon, false.Exemple -- The following example returns true.Contains('abc', 'bc') |
EndsWith(string, target) |
Retourne true si target se termine par string.Arguments string : chaîne dans laquelle la recherche est effectuée.target : chaîne cible recherchée à la fin de string.Valeur de retour True si string se termine par target ; sinon, false.Exemple -- The following example returns true.EndsWith('abc', 'bc') Remarque : Si vous utilisez le fournisseur de données SQL Server, cette fonction retourne false si la chaîne est stockée dans une colonne de chaîne de longueur fixe et si target est une constante. Dans ce cas, la chaîne entière est recherchée, y compris les éventuels espaces de remplissage de fin. Une solution de contournement possible consiste à découper les données dans la chaîne de longueur fixe, comme dans l'exemple suivant : EndsWith(TRIM(string), target) |
IndexOf(target, string) |
Retourne la position de la chaîne target dans string ou 0 si elle est introuvable. Retourne 1 pour indiquer le début de string. La numérotation de l'index commence à 1.Arguments target : chaîne recherchée.string : chaîne dans laquelle la recherche est effectuée.Valeur de retour Élément Int32.Exemple -- The following example returns 4.IndexOf('xyz', 'abcxyz') |
Left(string, length) |
Retourne les length premiers caractères du côté gauche de string. Si la longueur de string est inférieure à length, la chaîne est retournée dans son intégralité.Arguments string : une String.length :Int16,Int32, Int64 ou Byte. length ne peut pas être inférieur à zéro.Valeur de retour Un String.Exemple -- The following example returns abc.Left('abcxyz', 3) |
Length(string) |
Retourne la longueur (Int32), en caractères, de la chaîne.Arguments string : une String.Valeur de retour Élément Int32.Exemple -- The following example returns 6.Length('abcxyz') |
LTrim(string) |
Retourne string sans espace de début.Arguments Un String.Valeur de retour Un String.Exemple -- The following example returns abc.LTrim(' abc') |
Replace(string1, string2, string3) |
Retourne string1, avec toutes les occurrences de string2 remplacées par string3.Arguments Un String.Valeur de retour Un String.Exemple -- The following example returns abcxyz.Concat('abc', 'xyz') |
Reverse(string) |
Retourne string avec l'ordre des caractères inversé.Arguments Un String.Valeur de retour Un String.Exemple -- The following example returns dcba.Reverse('abcd') |
Right(string, length) |
Retourne les length derniers caractères de string. Si la longueur de string est inférieure à length, la chaîne est retournée dans son intégralité.Arguments string : une String.length :Int16,Int32, Int64 ou Byte. length ne peut pas être inférieur à zéro.Valeur de retour Un String.Exemple -- The following example returns xyz.Right('abcxyz', 3) |
RTrim(string) |
Retourne string sans espace de fin.Arguments Un String.Valeur de retour Un String. |
Substring(string, start, length) |
Retourne la sous-chaîne de la chaîne qui commence à la position start et compte length caractères. La valeur 1 pour start indique le premier caractère de la chaîne. La numérotation de l'index commence à 1.Arguments string : une String.start : Int16, Int32, Int64 et Byte. start ne peut pas être inférieur à un.length : Int16, Int32, Int64 et Byte. length ne peut pas être inférieur à zéro.Valeur de retour Un String.Exemple -- The following example returns xyz.Substring('abcxyz', 4, 3) |
StartsWith(string, target) |
Retourne true si string commence par target.Arguments string : chaîne dans laquelle la recherche est effectuée.target : chaîne cible recherchée au début de string.Valeur de retour True si string commence par target ; sinon, false.Exemple -- The following example returns true.StartsWith('abc', 'ab') |
ToLower(string) |
Retourne string avec tous les caractères majuscules convertis en minuscules.Arguments Un String.Valeur de retour Un String.Exemple -- The following example returns abc.ToLower('ABC') |
ToUpper(string) |
Retourne string avec tous les caractères minuscules convertis en majuscules.Arguments Un String.Valeur de retour Un String.Exemple -- The following example returns ABC.ToUpper('abc') |
Trim(string) |
Retourne string sans espaces de début ni de fin.Arguments Un String.Valeur de retour Un String.Exemple -- The following example returns abc.Trim(' abc ') |
Ces fonctions retournent null si une entrée de valeur null est fournie.
Des fonctionnalités équivalentes sont disponibles dans le fournisseur managé Client Microsoft SQL. Pour plus d’informations, consultez Fonctions SqlClient pour l’Entity Framework.