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.