Partager via

Fonctions canoniques de chaîne (Entity SQL)

  • Article

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

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')

Bb738534.note(fr-fr,VS.100).gifRemarque :
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

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 : String.

length: Int16, Int32, Int64 ou Byte. length ne peut pas être inférieur à zéro.

Valeur de retour

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 : String.

Valeur de retour

Objet Int32.

Exemple

-- The following example returns 6.

Legth('abcxyz')

LTrim( string )

Retourne string sans espace de début.

Arguments

Objet String.

Valeur de retour

Objet 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

Objet String.

Valeur de retour

String.

Exemple

-- The following example returns abcxyz.

Concat('abc', 'xyz')

Reverse ( string )

Retourne string avec l'ordre des caractères inversé.

Arguments

Objet String.

Valeur de retour

Objet 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 : String.

length: Int16, Int32, Int64 ou Byte. length ne peut pas être inférieur à zéro.

Valeur de retour

Objet String.

Exemple

-- The following example returns xyz.

Right('abcxyz', 3)

RTrim( string )

Retourne string sans espace de fin.

Arguments

Objet String.

Valeur de retour

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 : 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

Objet 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

Objet String.

Valeur de retour

String.

Exemple

-- The following example returns abc.

ToLower('ABC')

ToUpper( string )

Retourne string avec tous les caractères minuscules convertis en majuscules.

Arguments

Objet String.

Valeur de retour

String.

Exemple

-- The following example returns ABC.

ToUpper('abc')

Trim( string )

Retourne string sans espaces de début ni de fin.

Arguments

Objet String.

Valeur de retour

String.

Exemple

-- The following example returns abc.

Trim(' abc ')

Ces fonctions retournent la valeur Null si une valeur Null leur est fournie en entrée.

Des fonctionnalités équivalentes sont disponibles dans le fournisseur managé Client Microsoft SQL. Pour plus d'informations, voir Fournisseur de données .NET Framework pour SQL Server (SqlClient) pour les fonctions Entity Framework.

Voir aussi

Concepts

Fonctions canoniques (Entity SQL)