Partager via


Fonctions de chaîne

Le fournisseur de données .NET Framework pour SQL Server (SqlClient) fournit des String fonctions qui effectuent des opérations sur une entrée String et retournent un String résultat de valeur numérique. Ces fonctions se trouvent dans l’espace de noms SqlServer, qui est disponible lorsque vous utilisez SqlClient. La propriété d’espace de noms d’un fournisseur permet à Entity Framework de découvrir le préfixe utilisé par ce fournisseur pour des constructions spécifiques, telles que des types et des fonctions.

Le tableau suivant présente les fonctions SqlClient String .

Fonction Descriptif
ASCII(expression) Retourne la valeur de code ASCII du caractère le plus à gauche d’une expression de chaîne.

Arguments

expression: toute expression valide d’un type ASCII String .

valeur de retour

Élément Int32.

Exemple

SqlServer.ASCII('A')
CHAR(expression) Convertit un Int32 code en chaîne ASCII.

Arguments

expression : Int32.

valeur de retour

String ASCII.

Exemple

SqlServer.char(97)
CHARINDEX(expression1, expression2 [, start_location]) Retourne la position de départ de l’expression spécifiée dans une chaîne de caractères.

Arguments

expression1: expression qui contient la séquence de caractères à trouver. L’expression peut être d’un type String (ASCII ou Unicode) ou d’un type Binaire.

expression2: expression, généralement une colonne, à rechercher pour la séquence spécifiée. L’expression peut être d’un type String (ASCII ou Unicode) ou d’un type Binaire.

start_location:(Optional) Int64 (non retourné dans SQL Server 2000) ou Int32 qui représente la position de caractère pour commencer la recherche d’expression1 dans l’expression2. Si start_location n’est pas spécifié, est un nombre négatif ou est égal à zéro, la recherche commence au début de l’expression2.

valeur de retour

Élément Int32.

Exemple

SqlServer.CHARINDEX('h', 'habcdefgh', 2)
DIFFERENCE(expression, expression) Compare les SOUNDEX valeurs de deux chaînes et évalue la similarité entre elles.

Arguments

Type String ASCII ou Unicode. expression peut être une constante, une variable ou une colonne.

valeur de retour

Retourne une Int32 valeur qui représente la différence entre les valeurs SOUNDEX de deux expressions de caractères. La plage est comprise entre 0 et 4. 0 indique une similarité faible ou aucune similarité, et 4 indique une similarité forte ou les mêmes valeurs.

Exemple

// The following example returns a DIFFERENCE value of 4,

//the least possible difference or the best match.

SqlServer.DIFFERENCE('Green','Greene');
LEFT(expression, count) Retourne la partie gauche d’une chaîne de caractères avec le nombre spécifié de caractères.

Arguments

expression: Type de chaîne Unicode ou ASCII. Utilisez la fonction CAST pour convertir explicitement character_expression.

count : Un type Int64 (non retourné dans SQL Server 2000), ou type Int32 qui spécifie combien de caractères de character_expression seront retournés.

valeur de retour

Valeur String Unicode ou ASCII.

Exemple

SqlServer.LEFT('SQL Server', 4)
LEN(expression) Retourne le nombre de caractères de l'expression de type String spécifiée, à l'exception des espaces de fin.

Arguments

expression: expression d’un String type (Unicode ou ASCII) ou d’un Binary type

valeur de retour

Élément Int32.

Exemple

SqlServer.LEN('abcd')
LOWER(expression) Retourne une expression de type String après avoir converti les caractères majuscules en caractères minuscules.

Arguments

expression: toute expression valide du String type.

valeur de retour

String.

Exemple

SqlServer.LOWER('AbB')
LTRIM(expression) Retourne une expression String après avoir supprimé les espaces de début.

Arguments

expression: toute expression valide de String type.

valeur de retour

String.

Exemple

SqlServer.LTRIM(' d')
NCHAR(expression) Retourne un Unicode String avec le code entier spécifié, tel que défini par la norme Unicode.

Arguments

expression : Int32.

valeur de retour

String Unicode.

Exemple

SqlServer.NCHAR(65)
PATINDEX('%pattern%', expression) Retourne la position de départ de la première occurrence d’un modèle dans une expression spécifiée String .

Arguments

'%pattern%': type ASCII ou Unicode String . Les caractères génériques peuvent être utilisés ; toutefois, le caractère % doit venir avant et après le modèle (sauf dans les recherches pour les premiers ou les derniers caractères).

expression: ASCII ou Unicode String pour rechercher le motif spécifié.

valeur de retour

Élément Int32.

Exemple

SqlServer.PATINDEX('abc', 'ab')
QUOTENAME('char_string' [, 'quote_char']) Retourne un Unicode String avec les délimiteurs ajoutés pour rendre la chaîne d’entrée un identificateur délimité SQL Server 2005 valide.

Arguments

char_string : String Unicode.

quote_char: chaîne à caractère unique à utiliser comme délimiteur. Il peut s’agir d’un guillemet simple ( ' ), d’un crochet gauche ou droit ( [ ] ) ou d’un guillemet double ( " ). Si quote_char ce n’est pas spécifié, les crochets sont utilisés.

valeur de retour

String Unicode.

Exemple

SqlServer.QUOTENAME('abc[]def')
REPLACE(expression1, expression2, expression3) Remplace une expression de caractère par une autre expression de caractère.

Arguments

expression1: expression de chaîne à rechercher. expression1 peut être un type de chaîne Unicode ou ASCII.

expression2:La sous-chaîne à trouver. expression2 peut être un type de chaîne Unicode ou ASCII.

expression3 : chaîne de remplacement. expression3 peut être un type de chaîne Unicode ou ASCII.

Exemple

SqlServer.REPLACE('aabbcc', 'bc', 'zz')
REPLICATE(char_expression, int_expression) Répète une expression de caractère pour un nombre spécifié de fois.

Arguments

char_expression: type Unicode ou ASCII String .

int_expression: Int64 (non pris en charge dans SQL Server 2000) ou Int32.

valeur de retour

Type String Unicode ou ASCII.

Exemple

SqlServer.REPLICATE('aa',2)
REVERSE(expression) Retourne une chaîne Unicode ou ASCII avec ses positions de caractères inversées à partir de la chaîne d’entrée.

Arguments

expression: type Unicode ou ASCII String .

valeur de retour

Type String Unicode ou ASCII.

Exemple

SqlServer.REVERSE('abcd')
RIGHT(char_expression, count) Retourne la partie de droite d'une chaîne de caractères avec le nombre spécifié de caractères.

Arguments

char_expression:Type de chaîne Unicode ou ASCII. Utilisez la fonction CAST pour convertir explicitement character_expression.

count : Un type Int64 (non retourné dans SQL Server 2000), ou type Int32 qui spécifie combien de caractères de character_expression seront retournés.

valeur de retour

Type String ASCII.

Exemple

SqlServer.RIGHT('SQL Server', 6)
RTRIM(expression) Retourne une valeur String Unicode ou ASCII après la suppression des espaces de fin.

Arguments

expression: type Unicode ou ASCII String .

valeur de retour

Type String Unicode ou ASCII.

Exemple

SqlServer.RTRIM(' d e ')
SOUNDEX(expression) Retourne un code à quatre caractères (SOUNDEX) pour évaluer la similarité de deux chaînes. Arguments

expression: Type de chaîne Unicode ou ASCII.

valeur de retour

String ASCII. Un code à quatre caractères (SOUNDEX) est une chaîne qui évalue la similarité de deux chaînes.

Exemple

Select SqlServer.SOUNDEX('Smith'), SqlServer.SOUNDEX('Smythe') FROM {1}

Renvoie

----- ----- S530 S530
SPACE(int_expression) Retourne une chaîne String ASCII composée d'espaces consécutifs.

Arguments

int_expression Int64 : (non retourné dans SQL Server 2000) ou Int32 qui indique le nombre d’espaces.

valeur de retour

String ASCII.

Exemple

SqlServer.SPACE(2)
STR(float_expression [, length [, decimal]]) Retourne un ASCII String converti à partir de données numériques.

Arguments

float _expression: expression de type de données numérique approximatif (Double) avec un point décimal.

length: (facultatif) Un Int32 qui représente la longueur totale. Inclut la virgule décimale, le signe, les chiffres et les espaces. La valeur par défaut est 10.

decimal:(optionnel) Un Int32 qui représente le nombre de chiffres à droite de la virgule. la décimale doit être inférieure ou égale à 16. Si la décimale est supérieure à 16, le résultat est tronqué à seize emplacements à droite de la virgule décimale.

valeur de retour

String ASCII.

Exemple

SqlServer.STR(212.0)
STUFF(str_expression, start, length, str_expression_to_insert) Supprime une longueur spécifiée de caractères et insère un autre jeu de caractères à un point de départ spécifié dans une expression de chaîne.

Arguments

str_expression: Unicode ou ASCII String.

start: Valeur Int64 (non retournée dans SQL Server 2000) ou Int32 valeur qui spécifie l’emplacement pour démarrer la suppression et l’insertion.

length: valeur Int64 (non retournée dans SQL Server 2000) ou Int32 valeur qui spécifie le nombre de caractères à supprimer.

str_expression_to_insert: Unicode ou ASCII String.

valeur de retour

Valeur String Unicode ou ASCII.

Exemple

SqlServer.STUFF('abcd', 2, 2, 'zz')
SUBSTRING(str_expression, start, length) Retourne une partie d'une expression String.

Arguments

str_expression: expression d’un String type (ASCII ou Unicode) ou d’un Binary type.

start: ( Int64 non retourné dans SQL Server 2000) ou Int32 qui spécifie l’emplacement de démarrage de la sous-chaîne. 1 fait référence au premier caractère de la chaîne.

length: ( Int64 non retourné dans SQL Server 2000) ou Int32 qui spécifie le nombre de caractères de l’expression retournés.

valeur de retour

Type String (ASCII ou Unicode) ou type Binary.

Exemple

SqlServer.SUBSTRING('abcd', 2, 2)
UNICODE(expression) Retourne la valeur entière, telle que définie par la norme Unicode, pour le premier caractère de l’expression d’entrée.

Arguments

expression : String Unicode.

valeur de retour

Élément Int32.

Exemple

SqlServer.UNICODE('a')
UPPER(expression) Retourne une expression String après conversion en majuscules des données en caractères minuscules.

Arguments

expression: expression d’un type ASCII ou Unicode String.

valeur de retour

Type String ASCII ou Unicode.

Exemple

SqlServer.UPPER('AbB')

Pour plus d’informations sur les String fonctions que SqlClient prend en charge, consultez Fonctions de chaîne (Transact-SQL).

Voir aussi