Funzioni Stringa

Il provider di dati .NET Framework per SQL Server (SqlClient) fornisce String funzioni che eseguono operazioni su un input String e restituiscono un risultato di valore String o numerico. Queste funzioni si trovano nello spazio dei nomi SqlServer, disponibile quando si usa SqlClient. La proprietà dello spazio dei nomi di un provider consente a Entity Framework di individuare il prefisso usato da questo provider per costrutti specifici, ad esempio tipi e funzioni.

La tabella seguente illustra le funzioni SqlClient String .

Funzione	Descrizione
ASCII(expression)	Restituisce il valore del codice ASCII del carattere più a sinistra di un'espressione stringa. Argomenti expression: qualsiasi espressione valida di un tipo ASCII String . Valore Restituito Un oggetto Int32. Esempio SqlServer.ASCII('A')
CHAR(expression)	Converte un Int32 codice in una stringa ASCII. Argomenti expression: un Int32. Valore Restituito Un ASCII String. Esempio SqlServer.char(97)
CHARINDEX(expression1, expression2 [, start_location])	Restituisce la posizione iniziale dell'espressione specificata in una stringa di caratteri. Argomenti expression1: espressione che contiene la sequenza di caratteri da trovare. L'espressione può essere di tipo String (ASCII o Unicode) o di un tipo Binary. expression2: espressione, in genere una colonna, da cercare nella sequenza specificata. L'espressione può essere di tipo String (ASCII o Unicode) o di un tipo Binary. start_location:(Opzionale) Un Int64 (non restituito in SQL Server 2000) o Int32 che rappresenta la posizione del carattere per iniziare la ricerca di expression1 in expression2. Se start_location non viene specificato, è un numero negativo o è zero, la ricerca inizia all'inizio di expression2. Valore Restituito Un oggetto Int32. Esempio SqlServer.CHARINDEX('h', 'habcdefgh', 2)
DIFFERENCE(expression, expression)	Confronta i SOUNDEX valori di due stringhe e valuta la somiglianza tra di essi. Argomenti Tipo ASCII o Unicode String . expression può essere una costante, una variabile o una colonna. Valore Restituito Restituisce un oggetto Int32 che rappresenta la differenza tra i valori SOUNDEX di due espressioni di caratteri. L'intervallo è compreso tra 0 e 4. 0 indica una somiglianza debole o nessuna somiglianza e 4 indica una somiglianza forte o gli stessi valori. Esempio // The following example returns a DIFFERENCE value of 4, //the least possible difference or the best match. SqlServer.DIFFERENCE('Green','Greene');
LEFT(expression, count)	Restituisce la parte sinistra di una stringa di caratteri con il numero di caratteri specificato. Argomenti expression: tipo String Unicode o ASCII. Usare la funzione CAST per convertire in modo esplicito character_expression. count: tipo Int64 (non restituito in SQL Server 2000) o Int32 che specifica il numero di caratteri di character_expression restituito. Valore Restituito Un Unicode o ASCII String. Esempio SqlServer.LEFT('SQL Server', 4)
LEN(expression)	Restituisce il numero di caratteri nell'espressione String specificata, esclusi gli spazi vuoti finali. Argomenti expression: espressione di un String tipo (Unicode o ASCII) o di un Binary tipo Valore Restituito Un oggetto Int32. Esempio SqlServer.LEN('abcd')
LOWER(expression)	Restituisce un'espressione String dopo la conversione dei dati di caratteri maiuscoli in lettere minuscole. Argomenti expression: qualsiasi espressione valida del String tipo. Valore Restituito Un oggetto String. Esempio SqlServer.LOWER('AbB')
LTRIM(expression)	Restituisce un'espressione String dopo la rimozione degli spazi iniziali. Argomenti expression: qualsiasi espressione valida di String tipo. Valore Restituito Un oggetto String. Esempio SqlServer.LTRIM(' d')
NCHAR(expression)	Restituisce un valore Unicode String con il codice integer specificato, come definito dallo standard Unicode. Argomenti expression: un Int32. Valore Restituito Un Unicode String. Esempio SqlServer.NCHAR(65)
PATINDEX('%pattern%', expression)	Restituisce la posizione iniziale della prima occorrenza di un modello in un'espressione specificata String. Argomenti '%pattern%': tipo ASCII o Unicode String . I caratteri jolly possono essere usati; tuttavia, il carattere % deve venire prima e dopo il modello (tranne quando si cercano i primi o gli ultimi caratteri). expression: ASCII o Unicode String per cercare il modello specificato. Valore Restituito Un oggetto Int32. Esempio SqlServer.PATINDEX('abc', 'ab')
QUOTENAME('char_string' [, 'quote_char'])	Restituisce un valore Unicode String con i delimitatori aggiunti per rendere la stringa di input un identificatore delimitato di SQL Server 2005 valido. Argomenti char_string: un Unicode String. quote_char: stringa di un carattere da usare come delimitatore. Può essere una virgoletta singola ( ' ), una parentesi quadra sinistra o destra ( [ ] ) o una virgoletta doppia ( " ). Se quote_char non viene specificato, vengono utilizzate le parentesi quadre. Valore Restituito Un Unicode String. Esempio SqlServer.QUOTENAME('abc[]def')
REPLACE(expression1, expression2, expression3)	Sostituisce un'espressione di caratteri con un'altra espressione di caratteri. Argomenti expression1: espressione stringa in cui eseguire la ricerca. expression1 può essere un tipo Unicode o ASCII String. expression2:La sottostringa da trovare. expression2 può essere un tipo Unicode o ASCII String. expression3; Stringa di sostituzione. expression3 può essere un tipo Unicode o ASCII String. Esempio SqlServer.REPLACE('aabbcc', 'bc', 'zz')
REPLICATE(char_expression, int_expression)	Ripete un'espressione di caratteri per un numero specificato di volte. Argomenti char_expression: tipo Unicode o ASCII String. int_expression: Int64 (non è supportato in SQL Server 2000) o Int32. Valore Restituito Un tipo Unicode o ASCII String. Esempio SqlServer.REPLICATE('aa',2)
REVERSE(expression)	Restituisce una stringa Unicode o ASCII con le relative posizioni di caratteri invertite dalla stringa di input. Argomenti expression: tipo Unicode o ASCII String. Valore Restituito Un tipo Unicode o ASCII String. Esempio SqlServer.REVERSE('abcd')
RIGHT(char_expression, count)	Restituisce la parte destra di una stringa di caratteri con il numero di caratteri specificato. Argomenti char_expression:Tipo Stringa Unicode o ASCII. Usare la funzione CAST per convertire in modo esplicito character_expression. count: tipo Int64 (non restituito in SQL Server 2000) o Int32 che specifica il numero di caratteri di character_expression restituito. Valore Restituito Tipo ASCII String . Esempio SqlServer.RIGHT('SQL Server', 6)
RTRIM(expression)	Restituisce una stringa Unicode o ASCII dopo la rimozione degli spazi finali. Argomenti expression: tipo Unicode o ASCII String. Valore Restituito Un tipo Unicode o ASCII String. Esempio SqlServer.RTRIM(' d e ')
SOUNDEX(expression)	Restituisce un codice a quattro caratteri (SOUNDEX) per valutare la somiglianza di due stringhe. Argomenti expression: tipo String Unicode o ASCII. Valore Restituito Un ASCII String. Un codice a quattro caratteri (SOUNDEX) è una stringa che valuta la somiglianza di due stringhe. Esempio Select SqlServer.SOUNDEX('Smith'), SqlServer.SOUNDEX('Smythe') FROM {1} Resi ----- ----- S530 S530
SPACE(int_expression)	Restituisce un ASCII String di spazi ripetuti. Argomenti int_expression: valore Int64 (non restituito in SQL Server 2000) o Int32 che indica il numero di spazi. Valore Restituito Un ASCII String. Esempio SqlServer.SPACE(2)
STR(float_expression [, length [, decimal]])	Restituisce un oggetto ASCII String convertito da dati numerici. Argomenti float _expression: espressione di tipo di dati numerico approssimativo (Double) con un punto decimale. length: (facoltativo) Un Int32 che rappresenta la lunghezza totale. Sono inclusi il separatore decimale, il segno, le cifre e gli spazi. Il valore predefinito è 10. decimal:(opzionale) Un Int32 che rappresenta il numero di posizioni a destra del separatore decimale. decimal deve essere minore o uguale a 16. Se il decimale è maggiore di 16, il risultato viene troncato a sedici posizioni a destra del punto decimale. Valore Restituito Un ASCII String. Esempio SqlServer.STR(212.0)
STUFF(str_expression, start, length, str_expression_to_insert)	Elimina una lunghezza specificata di caratteri e inserisce un altro set di caratteri in un punto iniziale specificato in un'espressione stringa. Argomenti str_expression: un Unicode o un ASCII String. start: Un Int64 (non restituito in SQL Server 2000) o Int32 valore che specifica la posizione da cui iniziare l'eliminazione e l'inserimento. length: valore Int64 (non restituito in SQL Server 2000) o Int32 valore che specifica il numero di caratteri da eliminare. str_expression_to_insert: un Unicode o un ASCII String. Valore Restituito Un Unicode o ASCII String. Esempio SqlServer.STUFF('abcd', 2, 2, 'zz')
SUBSTRING(str_expression, start, length)	Restituisce parte di un'espressione String . Argomenti str_expression: espressione di un String tipo (ASCII o Unicode) o di un Binary tipo . start: oggetto Int64 (non restituito in SQL Server 2000) o Int32 che specifica dove viene avviata la sottostringa. 1 fa riferimento al primo carattere nella stringa. length: valore Int64 (non restituito in SQL Server 2000) o Int32 che specifica il numero di caratteri dell'espressione restituito. Valore Restituito Tipo String (ASCII o Unicode) o Binary tipo. Esempio SqlServer.SUBSTRING('abcd', 2, 2)
UNICODE(expression)	Restituisce il valore intero, come definito dallo standard Unicode, per il primo carattere dell'espressione di input. Argomenti expression: un Unicode String. Valore Restituito Un oggetto Int32. Esempio SqlServer.UNICODE('a')
UPPER(expression)	Restituisce un'espressione String dopo la conversione dei dati di caratteri minuscoli in lettere maiuscole. Argomenti expression: espressione di un tipo string ASCII o Unicode. Valore Restituito Tipo ASCII o Unicode String . Esempio SqlServer.UPPER('AbB')

Per altre informazioni sulle String funzioni supportate da SqlClient, vedere Funzioni stringa (Transact-SQL).

Vedere anche

• SqlClient per funzioni di Entity Framework
• Problemi noti in SqlClient per Entity Framework