Condividi tramite


Funzioni stringa canoniche

Entity SQL include funzioni canoniche stringa.

Osservazioni:

Nella tabella seguente sono illustrate le funzioni canoniche stringa di Entity SQL.

Funzione Descrizione
Concat(string1, string2) Restituisce una stringa che contiene l'oggetto string2 aggiunto a string1.

Argomenti

string1: la stringa alla quale è aggiunto string2.

string2: la stringa aggiunta a string1.

Valore restituito

Un oggetto String. Se la lunghezza della stringa del valore restituito è superiore alla lunghezza massima consentita, si verificherà un errore.

Esempio

-- The following example returns abcxyz.

Concat('abc', 'xyz')
Contains(string, target) Restituisce true se target è contenuto in string.

Argomenti

string: la stringa nella quale viene eseguita la ricerca.

target: la stringa di destinazione che viene cercata.

Valore restituito

true se target è contenuto in string; in caso contrario, false.

Esempio

-- The following example returns true.

Contains('abc', 'bc')
EndsWith(string, target) Restituisce true se target termina con string.

Argomenti

string: la stringa nella quale viene eseguita la ricerca.

target: la stringa di destinazione che viene cercata alla fine di string.

Valore restituito

True se string termina con target; in caso contrario, false.

Esempio

-- The following example returns true.

EndsWith('abc', 'bc') Nota: se si usa il provider di dati SQL Server, questa funzione restituisce false se la stringa è memorizzata in una colonna di stringhe a larghezza fissa e se target è una costante. In questo caso, la ricerca viene eseguita nell'intera stringa, inclusa la spaziatura interna finale. Una possibile soluzione alternativa consiste nel tagliare la stringa a lunghezza, come nell'esempio seguente: EndsWith(TRIM(string), target)
IndexOf(target, string) Restituisce la posizione di target in string o 0 se non viene trovato. Restituisce 1 per indicare l'inizio di string. La numerazione dell'indice inizia da 1.

Argomenti

target: la stringa che viene cercata.

string: la stringa nella quale viene eseguita la ricerca.

Valore restituito

Oggetto Int32.

Esempio

-- The following example returns 4.

IndexOf('xyz', 'abcxyz')
Left(string, length) Restituisce i primi caratteri length dal lato sinistro di string. Se la lunghezza di string è inferiore a length, viene restituita la stringa intera.

Argomenti

string: valore String.

length: Int16,Int32, Int64 o Byte. length non può essere minore di zero.

Valore restituito

Un oggetto String.

Esempio

-- The following example returns abc.

Left('abcxyz', 3)
Length(string) Restituisce la lunghezza (Int32), espressa in caratteri, della stringa.

Argomenti

string: valore String.

Valore restituito

Oggetto Int32.

Esempio

-- The following example returns 6.

Length('abcxyz')
LTrim(string) Restituisce string senza spazi iniziali.

Argomenti

Un oggetto String.

Valore restituito

Un oggetto String.

Esempio

-- The following example returns abc.

LTrim(' abc')
Replace(string1, string2, string3) Restituisce string1, con tutte le occorrenze di string2 sostituite da string3.

Argomenti

Un oggetto String.

Valore restituito

Un oggetto String.

Esempio

-- The following example returns abcxyz.

Concat('abc', 'xyz')
Reverse(string) Restituisce string con l'ordine dei caratteri invertito.

Argomenti

Un oggetto String.

Valore restituito

Un oggetto String.

Esempio

-- The following example returns dcba.

Reverse('abcd')
Right(string, length) Restituisce gli ultimi length caratteri di string. Se la lunghezza di string è inferiore a length, viene restituita la stringa intera.

Argomenti

string: valore String.

length: Int16,Int32, Int64 o Byte. length non può essere minore di zero.

Valore restituito

Un oggetto String.

Esempio

-- The following example returns xyz.

Right('abcxyz', 3)
RTrim(string) Restituisce string senza spazi finali.

Argomenti

Un oggetto String.

Valore restituito

Un oggetto String.
Substring(string, start, length) Restituisce la sottostringa della stringa che inizia nella posizione start, con una lunghezza di length caratteri. Il valore iniziale 1 indica il primo carattere della stringa. La numerazione dell'indice inizia da 1.

Argomenti

string: valore String.

start: tipo Int16, Int32, Int64 e Byte. start non può essere minore di uno.

length: tipo Int16, Int32, Int64 e Byte. length non può essere minore di zero.

Valore restituito

Un oggetto String.

Esempio

-- The following example returns xyz.

Substring('abcxyz', 4, 3)
StartsWith(string, target) Restituisce true se string inizia con target.

Argomenti

string: la stringa nella quale viene eseguita la ricerca.

target: la stringa di destinazione che viene cercata all'inizio di string.

Valore restituito

True se string inizia con target; in caso contrario, false.

Esempio

-- The following example returns true.

StartsWith('abc', 'ab')
ToLower(string) Restituisce string con tutti i caratteri maiuscoli convertiti in caratteri minuscoli.

Argomenti

Un oggetto String.

Valore restituito

Un oggetto String.

Esempio

-- The following example returns abc.

ToLower('ABC')
ToUpper(string) Restituisce string con i caratteri minuscoli convertiti in caratteri maiuscoli.

Argomenti

Un oggetto String.

Valore restituito

Un oggetto String.

Esempio

-- The following example returns ABC.

ToUpper('abc')
Trim(string) Restituisce string senza spazi iniziali e finali.

Argomenti

Un oggetto String.

Valore restituito

Un oggetto String.

Esempio

-- The following example returns abc.

Trim(' abc ')

Queste funzioni restituiscono null se l'input è null.

Una funzionalità equivalente è disponibile nel provider gestito del client Microsoft SQL. Per altre informazioni, vedere SqlClient per funzioni di Entity Framework.

Vedi anche