Valori letterali (Entity SQL)

In questo argomento viene descritto il supporto di Entity SQL per i valori letterali.

Nullo

Il valore letterale Null viene usato per rappresentare il valore Null per qualsiasi tipo. Un valore letterale Null è compatibile con qualsiasi tipo.

I valori Null tipizzato possono essere creati da un cast su un valore letterale Null. Per altre informazioni, vedere CAST.

Per le regole sulla posizione in cui è possibile usare valori letterali Null a virgola mobile, vedere Valori letterali Null e Inferenza dei tipi.

Booleano

I valori letterali booleani sono rappresentati dalle parole chiave true e false.

Integer

I valori letterali integer possono essere di tipo Int32 o Int64. Un Int32 valore letterale è una serie di caratteri numerici. Un Int64 valore letterale è una serie di caratteri numerici seguiti da un L maiuscolo.

Decimale

Un numero a virgola fissa (decimale) è una serie di caratteri numerici, un punto (.) e un'altra serie di caratteri numerici seguiti da una "M" maiuscola.

Float, Double

Un numero a virgola mobile a precisione doppia è una serie di caratteri numerici, un punto (.) e un'altra serie di caratteri numerici eventualmente seguiti da un esponente. Un numero a virgola mobile a precisione singola (o float) è una sintassi numerica a virgola mobile a precisione doppia seguita da f minuscolo.

Stringa

Una stringa è una serie di caratteri racchiusi tra virgolette. Le virgolette possono essere sia virgolette singole (') sia virgolette doppie ("). I valori letterali stringa di caratteri possono essere Unicode o non Unicode. Per dichiarare un valore letterale stringa di caratteri come Unicode, anteporre al valore letterale "N" maiuscolo. Il valore predefinito è valori letterali stringa di caratteri non Unicode. Non possono essere presenti spazi tra il payload N e il payload letterale stringa e N deve essere maiuscolo.

'hello' -- non-Unicode character string literal
N'hello' -- Unicode character string literal
"x"
N"This is a string!"
'so is THIS'

Data e ora

Un valore letterale datetime è indipendente dalle impostazioni locali ed è composto da una parte della data e da una parte dell'ora. Le parti di data e ora sono obbligatorie e non esistono valori predefiniti.

La parte date deve avere il formato , YYYYDD-MM-dove YYYY è un valore anno a quattro cifre compreso tra 0001 e 9999, MM è il mese compreso tra 1 e 12 ed DD è il valore del giorno valido per il mese MMspecificato.

La parte temporale deve avere il formato: HH:MM[:SS[.fffffff]], dove HH è il valore dell'ora compreso tra 0 e 23, MM è il valore del minuto compreso tra 0 e 59, SS è il secondo valore compreso tra 0 e 59 e fffffff è il secondo valore frazionaria compreso tra 0 e 9999999. Tutti gli intervalli di valori sono inclusivi. I secondi frazionari sono facoltativi. I secondi sono facoltativi a meno che non vengano specificati secondi frazionari; in questo caso, sono necessari secondi. Quando non vengono specificati secondi o secondi frazionari, verrà invece usato il valore predefinito zero.

Può essere presente un numero qualsiasi di spazi tra il simbolo DATETIME e il payload letterale, ma non nuove righe.

DATETIME'2006-10-1 23:11'
DATETIME'2006-12-25 01:01:00.0000000' -- same as DATETIME'2006-12-25 01:01'

Tempo

Un valore letterale ora è indipendente dalle impostazioni locali e composto solo da una parte dell'ora. La parte relativa all'ora è obbligatoria e non esiste alcun valore predefinito. Deve avere il formato HH:MM[:SS[.fffffff]], dove HH è il valore dell'ora compreso tra 0 e 23, MM è il valore del minuto compreso tra 0 e 59, SS è il secondo valore compreso tra 0 e 59 e fffffff è il secondo valore fra 0 e 9999999. Tutti gli intervalli di valori sono inclusivi. I secondi frazionari sono facoltativi. I secondi sono facoltativi a meno che non vengano specificati secondi frazionari; in questo caso, sono necessari secondi. Quando non vengono specificati secondi o frazioni, verrà invece usato il valore predefinito zero.

Può essere presente un numero qualsiasi di spazi tra il simbolo TIME e il payload letterale, ma nessuna nuova riga.

TIME'23:11'
TIME'01:01:00.1234567'

DateTimeOffset (struttura per gestire data e ora con fuso orario)

Un valore letterale datetimeoffset è indipendente dalle impostazioni locali e composto da una parte di data, una parte dell'ora e una parte di offset. Tutte le parti di data, ora e offset sono obbligatorie e non esistono valori predefiniti. La parte data deve avere il formato AAAA-MM-GG, dove AAAA è un valore 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 avere il formato HH:MM[:SS[.fffffff]], dove HH è il valore dell'ora compreso tra 0 e 23, MM è il valore minuto compreso tra 0 e 59, SS è il secondo valore compreso tra 0 e 59 e fffffff è il secondo valore frazionaria compreso tra 0 e 9999999. Tutti gli intervalli di valori sono inclusivi. I secondi frazionari sono facoltativi. I secondi sono facoltativi a meno che non vengano specificati secondi frazionari; in questo caso, sono necessari secondi. Quando non vengono specificati secondi o frazioni, verrà invece usato il valore predefinito zero. La parte offset deve avere il formato {+|-}HH:MM, dove HH e MM hanno lo stesso significato della parte temporale. L'intervallo dell'offset, tuttavia, deve essere compreso tra -14:00 e + 14:00

Può essere presente un numero qualsiasi di spazi tra il simbolo DATETIMEOFFSET e il payload letterale, ma nessuna nuova riga.

DATETIMEOFFSET'2006-10-1 23:11 +02:00'
DATETIMEOFFSET'2006-12-25 01:01:00.0000000 -08:30'

Annotazioni

Un valore letterale Entity SQL valido può non rientrare negli intervalli supportati per CLR o l'origine dati. Ciò potrebbe causare un'eccezione

Binario

Un valore letterale stringa binaria è una sequenza di cifre esadecimali delimitate da virgolette singole che seguono la parola chiave binaria o il simbolo X di scelta rapida o x. Il simbolo X di scelta rapida non fa distinzione tra maiuscole e minuscole. Tra la parola chiave binary e il valore della stringa binaria sono consentiti zero o più spazi.

Anche i caratteri esadecimali non fanno distinzione tra maiuscole e minuscole. Se il valore letterale è composto da un numero dispari di cifre esadecimali, il valore letterale verrà allineato alla cifra esadecimale successiva anteponendo al valore letterale una cifra zero esadecimale. Non esiste alcun limite formale per le dimensioni della stringa binaria.

Binary'00ffaabb'
X'ABCabc'
BINARY    '0f0f0f0F0F0F0F0F0F0F'
X'' -- empty binary string

Guid

Un GUID valore letterale 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 di sistema : 8-4-4-4-12 racchiuso tra virgolette singole. Le cifre esadecimali non fanno distinzione tra maiuscole e minuscole.

Può essere presente un numero qualsiasi di spazi tra il simbolo GUID e il payload letterale, ma non nuove righe.

Guid'1afc7f5c-ffa0-4741-81cf-f12eAAb822bf'
GUID  '1AFC7F5C-FFA0-4741-81CF-F12EAAB822BF'

Vedere anche

• Panoramica di Entity SQL