Condividi tramite


Funzioni canoniche String (Entity SQL)

Entity SQL include funzioni canoniche string.

Osservazioni

Nella tabella seguente sono illustrate le funzioni canoniche di stringa 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

Tipo 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.

Arguments

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.

Arguments

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')

Bb738534.note(it-it,VS.100).gifNota:
Se si utilizza 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

Tipo 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: tipo String.

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

Valore restituito

Tipo String.

Esempio

-- The following example returns abc.

Left('abcxyz', 3)

Length ( string )

Restituisce la lunghezza (Int32), espressa in caratteri, della stringa.

Argomenti

string: tipo String.

Valore restituito

Tipo Int32.

Esempio

-- The following example returns 6.

Legth('abcxyz')

LTrim( string )

Restituisce string senza spazi iniziali.

Arguments

Tipo String.

Valore restituito

Tipo String.

Esempio

-- The following example returns abc.

LTrim(' abc')

Replace ( string1, string2, string3)

Restituisce string1, con tutte le occorrenze di string2 sostituite da string3.

Arguments

Tipo String.

Valore restituito

Tipo String.

Esempio

-- The following example returns abcxyz.

Concat('abc', 'xyz')

Reverse ( string )

Restituisce string con l'ordine dei caratteri invertito.

Argomenti

Tipo String.

Valore restituito

Tipo String.

Esempio

-- The following example returns dcba.

Reverse('abcd')

Right ( string, length)

Restituisce gli ultimi caratteri length di string. Se la lunghezza di string è inferiore a length, viene restituita la stringa intera.

Argomenti

string: tipo String.

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

Valore restituito

Tipo String.

Esempio

-- The following example returns xyz.

Right('abcxyz', 3)

RTrim( string )

Restituisce string senza spazi finali.

Arguments

Tipo String.

Valore restituito

Tipo 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: tipo 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

Tipo String.

Esempio

-- The following example returns xyz.

Substring('abcxyz', 4, 3)

StartsWith ( string, target)

Restituisce true se string inizia con target.

Arguments

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

Tipo String.

Valore restituito

Tipo String.

Esempio

-- The following example returns abc.

ToLower('ABC')

ToUpper( string )

Restituisce string con i caratteri minuscoli convertiti in caratteri maiuscoli.

Argomenti

Tipo String.

Valore restituito

Tipo String.

Esempio

-- The following example returns ABC.

ToUpper('abc')

Trim( string )

Restituisce string senza spazi finali e iniziali.

Arguments

Tipo String.

Valore restituito

Tipo 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 ulteriori informazioni, vedere Provider di dati .NET Framework per SQL Server (SqlClient) per le funzioni di Entity Framework.

Vedere anche

Concetti

Funzioni canoniche (Entity SQL)