Valori letterali (Entity SQL)
In questo argomento viene descritto il supporto Entity SQL per i valori letterali.
Null
Il valore letterale Null viene utilizzato per rappresentare il valore Null per qualsiasi tipo. Un valore letterale Null è compatibile con qualsiasi tipo.
I valori Null tipizzati possono essere creati tramite cast su un valore letterale Null. Per ulteriori informazioni, vedere CAST (Entity SQL).
Per le regole relative a dove è possibile utilizzare i valori letterali Null mobili, vedere Valori letterali null e inferenza dei tipi (Entity SQL).
Boolean
I valori letterali Boolean sono rappresentati dalle parole chiave true e false.
Integer
I valori letterali Integer possono essere di tipo Int32 o Int64. Un valore letterale Int32 è costituito da una serie di caratteri numerici. Un valore letterale Int64 è costituito da una serie di caratteri numerici seguiti da una L maiuscola.
Decimal
Un numero a virgola fissa, o decimale, è costituito da una serie di caratteri numerici, un separatore decimale e un'altra serie di caratteri numerici seguiti da una "M" maiuscola.
Float, Double
Un numero a virgola mobile con precisione doppia è costituito da una serie di caratteri numerici, un separatore decimale e un'altra serie di caratteri numerici che possono essere seguiti da un esponente. Un numero a virgola mobile con precisione singola, o float, è costituito dalla sintassi di un numero a virgola mobile con precisione doppia, seguita dalla f minuscola.
String
Una stringa è una serie di caratteri racchiusi tra virgolette. Le virgolette possono essere entrambe singole (') o entrambe doppie ("). I valori letterali carattere di tipo String possono essere Unicode o non Unicode. Per dichiarare un valore letterale carattere di tipo String come Unicode, anteporre una "N" maiuscola al valore. Per impostazione predefinita, i valori letterali carattere di tipo String sono non Unicode. Non possono essere presenti spazi tra la N e il payload del valore letterale di tipo String e la N deve essere maiuscola.
'hello' -- non-Unicode character string literal
N'hello' -- Unicode character string literal
"x"
N"This is a string!"
'so is THIS'
DateTime
Un valore letterale di tipo DateTime è indipendente dalle impostazioni locali ed è composto da una parte relativa alla data e da una parte relativa all'ora. Entrambe queste parti sono obbligatorie e non vi sono valori predefiniti.
La parte relativa alla data deve essere nel formato YYYY-MM-DD, dove YYYY è un valore dell'anno a quattro cifre compreso tra 0001 e 9999, MM è il mese, compreso tra 1 e 12, e DD è il valore del giorno valido per il mese MM specificato.
La parte relativa all'ora deve essere nel formato HH:MM[:SS[.fffffff]], dove HH è il valore dell'ora compreso tra 0 e 23, MM è il valore dei minuti compreso tra 0 e 59, SS è il valore dei secondi compreso tra 0 e 59 e fffffff è il valore dei secondi frazionari compreso tra 0 e 9999999. Tutti gli intervalli includono il primo e l'ultimo valore. I secondi frazionari sono facoltativi. I secondi sono facoltativi, a meno che non vengano specificati i secondi frazionari. In questo caso, i secondi sono obbligatori. Quando i secondi o i secondi frazionari non sono specificati, viene utilizzato il valore predefinito zero.
Tra il simbolo DATETIME e il payload con valore letterale può essere presente un numero qualsiasi di spazi ma non possono essere presenti nuove righe.
DATETIME'2006-10-1 23:11'
DATETIME'2006-12-25 01:01:00.0000000' -- same as DATETIME'2006-12-25 01:01'
Time
Un valore letterale Time è indipendente dalle impostazioni locali ed è composto solo da una parte relativa all'ora. La parte relativa all'ora è obbligatoria e non è previsto alcun valore predefinito. Questa parte deve essere nel formato HH:MM[:SS[.fffffff]], dove HH è il valore dell'ora compreso tra 0 e 23, MM è il valore dei minuti compreso tra 0 e 59, SS è il valore dei secondi compreso tra 0 e 59 e fffffff è il valore della frazione di secondo compreso tra 0 e 9999999. Tutti gli intervalli includono il primo e l'ultimo valore. I secondi frazionari sono facoltativi. I secondi sono facoltativi, a meno che non vengano specificati i secondi frazionari. In questo caso, i secondi sono obbligatori. Quando i secondi o le frazioni di secondo non sono specificati, viene utilizzato il valore predefinito zero.
Tra il simbolo TIME e il payload con valore letterale può essere presente un numero qualsiasi di spazi ma non possono essere presenti nuove righe.
TIME‘23:11’
TIME‘01:01:00.1234567’
DateTimeOffset
Un valore letterale di tipo DateTimeOffset è indipendente dalle impostazioni locali ed è composto da una parte relativa alla data, una parte relativa all'ora e una parte relativa all'offset. Tutte e tre le parti sono obbligatorie e non vi sono valori predefiniti. La parte relativa alla data deve essere nel formato YYYY-MM-DD, dove YYYY è un valore dell'anno a quattro cifre compreso tra 0001 e 9999, MM è il mese compreso tra 1 e 12, e DD è il valore del giorno valido per il mese specificato. La parte relativa all'ora deve essere nel formato HH:MM[:SS[.fffffff]], dove HH è il valore dell'ora compreso tra 0 e 23, MM è il valore dei minuti compreso tra 0 e 59, SS è il valore dei secondi compreso tra 0 e 59 e fffffff è il valore dei secondi frazionari compreso tra 0 e 9999999. Tutti gli intervalli includono il primo e l'ultimo valore. I secondi frazionari sono facoltativi. I secondi sono facoltativi, a meno che non vengano specificati i secondi frazionari. In questo caso, i secondi sono obbligatori. Quando i secondi o le frazioni di secondo non sono specificati, viene utilizzato il valore predefinito zero. La parte relativa all'offset deve essere nel formato {+ | -} HH:MM, dove HH e MM hanno lo stesso significato che nella parte relativa all'ora. L'intervallo dell'offset deve tuttavia essere compreso tra -14:00 e + 14:00.
Tra il simbolo DATETIMEOFFSET e il payload con valore letterale può essere presente un numero qualsiasi di spazi ma non possono essere presenti nuove righe.
DATETIMEOFFSET‘2006-10-1 23:11 +02:00’
DATETIMEOFFSET‘2006-12-25 01:01:00.0000000 -08:30’
.gif) Nota |
|---|
Un valore letterale Entity SQL valido può non rientrare negli intervalli supportati per CLR o per l'origine dati. Ciò potrebbe generare un'eccezione. |
Binary
Un valore letterale stringa di tipo Binary è una sequenza di cifre esadecimali delimitata da virgolette singole che seguono la parola chiave binary o il simbolo rapido X. Si noti che per la parola chiave binary non viene fatta distinzione tra maiuscole e minuscole. Tra la parola chiave binary e il valore della stringa binaria sono inoltre consentiti zero o più spazi.
Il simbolo rapido X deve essere maiuscolo e non possono essere presenti spazi tra il simbolo X e la stringa binaria. Anche per i caratteri esadecimali non viene fatta distinzione tra maiuscole e minuscole. Se il valore letterale è composto di un numero dispari di cifre esadecimali, verrà allineato alla cifra esadecimale pari successiva anteponendogli una cifra zero esadecimale. Non vi sono limiti formali alle dimensioni della stringa binaria.
Non possono essere presenti spazi tra il simbolo X e il payload con valore letterale stringa e il simbolo X deve essere maiuscolo. Tra il simbolo BINARY e il payload con valore letterale può essere presente un numero qualsiasi di spazi ma non possono essere presenti nuove righe.
Binary'00ffaabb'
X'ABCabc'
BINARY '0f0f0f0F0F0F0F0F0F0F'
X'' –- empty binary string
Guid
Un valore letterale GUID rappresenta un identificatore univoco globale. Si tratta di una sequenza formata dalla parola chiave GUID seguita da cifre esadecimali nel formato noto come formato del registro, ovvero 8-4-4-4-12, racchiuse tra virgolette singole. Per le cifre esadecimali non viene fatta distinzione tra maiuscole e minuscole.
Tra il simbolo GUID e il payload con valore letterale può essere presente un numero qualsiasi di spazi ma non possono essere presenti nuove righe.
Guid'1afc7f5c-ffa0-4741-81cf-f12eAAb822bf'
GUID '1AFC7F5C-FFA0-4741-81CF-F12EAAB822BF'