REPLACE (espressione SSIS)REPLACE (SSIS Expression)

Viene restituita un'espressione di caratteri dopo aver sostituito una stringa di caratteri nell'espressione con un'altra stringa di caratteri o una stringa vuota.Returns a character expression after replacing a character string within the expression with either a different character string or an empty string.

Nota

Vengono utilizzate spesso stringhe lunghe dalla funzione REPLACE.The REPLACE function frequently uses long strings. Le conseguenze del troncamento possono essere gestite normalmente oppure generare un avviso o un errore.The consequences of truncation can be handled gracefully or cause a warning or an error. Per altre informazioni, vedere Sintassi (SSIS).For more information, see Syntax (SSIS).

SintassiSyntax


REPLACE(character_expression,searchstring,replacementstring)  

ArgomentiArguments

character_expressioncharacter_expression
Espressione di caratteri valida in cui la funzione esegue la ricerca.Is a valid character expression that the function searches.

searchstringsearchstring
Espressione di caratteri valida che la funzione tenta di individuare.Is a valid character expression that the function attempts to locate.

replacementstringreplacementstring
Espressione di caratteri valida che costituisce l'espressione da sostituire.Is a valid character expression that is the replacement expression.

Tipi restituitiResult Types

DT_WSTRDT_WSTR

OsservazioniRemarks

La lunghezza di searchstring deve essere diversa da zero.The length of searchstring must not be zero.

La lunghezza di replacementstring può essere zero.The length of replacementstring may be zero.

Gli argomenti searchstring e replacementstring possono usare variabili e colonne.The searchstring and replacementstring arguments can use variables and columns.

È possibile utilizzare REPLACE solo con il tipo di dati DT_WSTR.REPLACE works only with the DT_WSTR data type. Per gli argomenticharacter_expression1, character_expression2, e character_expression3 costituiti da valori letterali stringa o da colonne di dati con tipo di dati DT_STR, prima di eseguire l'operazione della funzione REPLACE viene eseguito il cast implicito al tipo di dati DT_WSTR.character_expression1, character_expression2, and character_expression3 arguments that are string literals or data columns with the DT_STR data type are implicitly cast to the DT_WSTR data type before REPLACE performs its operation. Per gli altri tipi di dati è necessario il cast esplicito al tipo di dati DT_WSTR.Other data types must be explicitly cast to the DT_WSTR data type. Per altre informazioni, vedere Cast (espressione SSIS).For more information, see Cast (SSIS Expression).

Se un argomento qualsiasi è Null, REPLACE restituirà Null.REPLACE returns a null result if any argument is null.

Esempi di espressioneExpression Examples

In questo esempio viene utilizzato un valore letterale stringa.This example uses a string literal. Il risultato restituito è "All Terrain Bike".The return result is "All Terrain Bike".

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

In questo esempio viene rimossa la stringa "Bike" dalla colonna Product .This example removes the string "Bike" from the Product column.

REPLACE(Product, "Bike","")  

In questo esempio vengono sostituiti alcuni valori nella colonna DaysToManufacture .This example replaces values in the DaysToManufacture column. La colonna ha tipo di dati integer e l'espressione include il cast di DaysToManufacture al tipo di dati DT_WSTR.The column has an integer data type and the expression includes casting DaysToManufacture to the DT_WSTR data type.

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

Vedere ancheSee Also

SOTTOSTRINGA ( Espressione SSIS ) SUBSTRING (SSIS Expression)
Funzioni ( Espressione SSIS )Functions (SSIS Expression)