REPLICATE (espressione SSIS)REPLICATE (SSIS Expression)

Viene restituita un'espressione di caratteri ripetuta per il numero di volte specificato.Returns a character expression that is replicated a number of times. L'argomento numero di volte deve restituire un Integer.The times argument must evaluate to an integer.

Nota

La funzione REPLICATE utilizza spesso stringhe lunghe e pertanto è più facile che un'espressione superi il limite di 4000 caratteri di lunghezza.The REPLICATE function frequently uses long strings, and therefore is more likely to incur the 4000-character limit on expression length. Se il risultato della valutazione di un'espressione ha il tipo di dati Integration Services DT_WSTR o DT_STR, l'espressione verrà troncata a 4000 caratteri.If the evaluation result of an expression has the Integration Services data type DT_WSTR or DT_STR, the expression will be truncated at 4000 characters. Se il tipo di risultato di una sottoespressione è DT_STR o DT_WSTR, probabilmente la sottoespressione verrà troncata a 4000 caratteri, indipendentemente dal tipo di risultato dell'espressione globale.If the result type of a sub-expression is DT_STR or DT_WSTR, that sub-expression likewise will be truncated to 4000 characters, regardless of the overall expression result type. 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


REPLICATE(character_expression,times)  

ArgomentiArguments

character_expressioncharacter_expression
Espressione di caratteri da replicare.Is a character expression to replicate.

numero di voltetimes
Espressione Integer che specifica il numero di volte in cui character_expression viene replicata.Is an integer expression that specifies the number of times character_expression is replicated.

Tipi restituitiResult Types

DT_WSTRDT_WSTR

OsservazioniRemarks

Se il numero di volte ha valore zero, la funzione restituirà una stringa di lunghezza zero.If times is zero, the function returns a zero-length string.

Se il numero di volte è un numero negativo, la funzione restituirà un errore.If times is a negative number, the function returns an error.

L'argomento numero di volte può usare anche variabili e colonne.The times argument can also use variables and columns.

È possibile utilizzare REPLICATE solo con il tipo di dati DT_WSTR.REPLICATE works only with the DT_WSTR data type. Se l'argomento character_expression è un valore letterale stringa o una colonna di dati con tipo di dati DT_STR, prima di eseguire l'operazione prevista da REPLICATE verrà eseguito il cast implicito al tipo di dati DT_WSTR.A character_expression argument that is a string literal or a data column with the DT_STR data type is implicitly cast to the DT_WSTR data type before REPLICATE 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 Tipi di dati di Integration Services e Cast (espressione SSIS).For more information, see Integration Services Data Types and Cast (SSIS Expression).

Se l'argomento è Null, REPLICATE restituirà Null.REPLICATE returns a null result if either argument is null.

Esempi di espressioneExpression Examples

In questo esempio un valore letterale stringa viene replicato tre volte.This example replicates a string literal three times. Il risultato restituito è "Mountain BikeMountain BikeMountain Bike".The return result is "Mountain BikeMountain BikeMountain Bike".

REPLICATE("Mountain Bike", 3)  

In questo esempio i valori nella colonna Nome vengono replicati per il numero di volte indicato dal valore della variabile Numero di volte .This example replicates values in the Name column by the value in the Times variable. Se Numero di volte ha valore 3 e Nome contiene Touring Front Wheel, il risultato restituito sarà Touring Front WheelTouring Front WheelTouring Front Wheel.If Times is 3 and Name is Touring Front Wheel, the return result is Touring Front WheelTouring Front WheelTouring Front Wheel.

REPLICATE(Name, @Times)  

In questo esempio i valori nella variabile Nome vengono replicati per il numero di volte indicato dal valore nella colonna Numero di volte .This example replicates the value in the Name variable by the value in the Times column. La variabileNome ha un tipo di dati diverso da Integer e l'espressione include un cast esplicito a un tipo di dati Integer.Times has a non-integer data type and the expression includes an explicit cast to an integer data type. Se Nome contiene il testo Helmet e Numero di volte ha valore 2, il risultato restituito sarà "HelmetHelmet".If Name contains Helmet and Times is 2, the return result is "HelmetHelmet".

REPLICATE(@Name, (DT_I4(Times))  

Vedere ancheSee Also

Funzioni ( Espressione SSIS )Functions (SSIS Expression)