Partager via


REPLACE (Expression SSIS)

Renvoie une expression de caractères après le remplacement d'une chaîne de caractères située dans l'expression par une autre chaîne de caractères ou une chaîne vide.

Notes

La fonction REPLACE utilise habituellement des chaînes longues, elle est donc plus exposée à la limitation fixée à 4000 caractères sur la longueur d'expression. Si le résultat de l'évaluation d'une expression donne le type de données Integration Services DT_WSTR ou DT_STR, cette expression sera réduite à 4000 caractères. Si le type du résultat d'une sous-expression est DT_STR ou DT_WSTR, cette sous-expression sera également tronquée à 4000 caractères, peu importe le type de résultat obtenu dans l'expression générale. Les conséquences de la troncation peuvent être gérées naturellement ou être à l'origine d'un avertissement ou d'un message d'erreur. Pour plus d'informations, consultez Syntaxe (SSIS).

Syntaxe

REPLACE(character_expression,searchstring,replacementstring)

Arguments

  • character_expression
    Expression de caractères valide où la fonction va effectuer la recherche.

  • searchstring
    Expression de caractères valide recherchée par la fonction.

  • replacementstring
    Expression de caractères valide qui est l'expression de remplacement.

Types des résultats

DT_WSTR

Notes

La longueur de l'argument searchstring doit être différente de zéro.

La longueur de l'argument replacementstring peut être égale à zéro.

Les arguments searchstring et replacementstring peuvent également utiliser des variables et des colonnes.

La fonction REPLACE s'utilise seulement avec le type de données DT_WSTR. Les arguments character_expression1, character_expression2, et character_expression3 qui représentent des littéraux de chaîne ou des colonnes de données du type de données DT_STR sont implicitement convertis dans le type de données DT_WSTR avant que la fonction REPLACE soit exécutée. Les autres types de données doivent être explicitement convertis vers le type de données DT_WSTR. Pour plus d'informations, consultez Cast (Expression SSIS) : conversion de types de données SSIS.

La fonction REPLACE renvoie un résultat NULL si un argument est NULL.

Exemples

L'exemple suivant utilise un littéral de chaîne. Le résultat obtenu est « All Terrain Bike ».

REPLACE("Mountain Bike", "Mountain","All Terrain")

L'exemple suivant supprime la chaîne « Bike » de la colonne Product.

REPLACE(Product, "Bike","")

L'exemple suivant remplace des valeurs dans la colonne DaysToManufacture. La colonne a un type de données integer et l'expression comprend la conversion de DaysToManufacture vers le type de données DT_WSTR.

REPLACE((DT_WSTR,8)DaysToManufacture,"6","5")