本主题介绍 Entity SQL 对于文字的支持。
null
空文字用于表示对任何类型均为空的值。 空文字与任何类型兼容。
强制转换可以在空文字之上创建类型空值。 有关详细信息,请参阅强制转换。
有关在何处规则自由浮动 null 文本可用,请参阅Null 文本和类型推理。
Boolean
布尔值文字由关键字 true 和 false 表示。
整数
整型文字可以为类型 xref:System.Int32 或 xref:System.Int64。 xref:System.Int32 文字是一系列数字字符。 xref:System.Int64 文字是一系列数字字符,后跟一个大写 L。
十进制
固定点数字(小数)是一系列数字字符、一个圆点 (.) 和另一系列数字字符,后跟一个大写“M”。
浮点,双精度
双精度浮点数字是一系列数字字符、一个圆点 (.) 和另一系列数字字符,后面可能跟一个指数。 单精度浮点数字(或浮点数)是双精度浮点数字语法后跟小写 f。
String
字符串是包含在引号内的一系列字符。 引号可以同时为单引号 (') 或同时为双引号 (")。 字符串文字可以是 Unicode 或非 Unicode。 若要将字符串文字声明为 Unicode,请在文字之前加上大写“N”作为前缀。 默认值为非 Unicode 字符串文字。 在 N 与字符串文字负载之间不能存在空格,并且 N 必须为大写。
'hello' -- non-Unicode character string literal
N'hello' -- Unicode character string literal
"x"
N"This is a string!"
'so is THIS'
DateTime
日期时间文字独立于区域设置并由日期部分和时间部分组成。 日期部分和时间部分都是必需的,并且没有默认值。
日期部分必须采用格式: YYYY - MM - DD,其中YYYY是介于 0001 与 9999 之间的四位年度值MM是介于 1 和 12 之间的月份和DD是对给定月份有效日期值MM。
时间部分的格式必须为:HH:MM[:SS[.fffffff]],其中 HH 为介于 0 至 23 之间的小时值,MM 为介于 0 至 59 之间的分钟值,SS 为介于 0 至 59 之间的秒值,而 fffffff 为介于 0 至 9999999 之间的秒的小数部分值。 所有值范围都包含两端。 秒的小数部分是可选的。 除非指定了秒的小数部分,否则秒是可选的;在指定了秒的小数部分时秒是必需的。 在未指定秒或秒的小数部分时,将使用默认值零。
在 DATETIME 符号与文字负载之间可以存在任意数目的空格,但是不能存在新行。
DATETIME'2006-10-1 23:11'
DATETIME'2006-12-25 01:01:00.0000000' -- same as DATETIME'2006-12-25 01:01'
时间
时间文字独立于区域设置并仅由时间部分组成。 时间部分为必选项,且没有默认值。 其格式必须为 HH:MM[:SS[.fffffff]],其中 HH 为介于 0 至 23 之间的小时值,MM 为介于 0 至 59 之间的分钟值,SS 为介于 0 至 59 之间的秒值,而 fffffff 为介于 0 至 9999999 之间的秒的小数部分值。 所有值范围都包含两端。 秒的小数部分是可选的。 除非指定了秒的小数部分,否则秒是可选的;在指定了秒的小数部分时秒是必需的。 在未指定秒或秒的小数部分时,将使用默认值零。
在 TIME 符号与文字负载之间可以存在任意数目的空格,但是不能存在新行。
TIME‘23:11’
TIME‘01:01:00.1234567’
DateTimeOffset
datetimeoffset 文字独立于区域设置并由日期部分、时间部分和偏移量部分组成。 所有日期、时间和偏移量部分都是必选项,并且没有默认值。 日期部分的格式必须为 YYYY-MM-DD,其中 YYYY 是介于 0001 与 9999 之间的四位年度值,MM 是介于 1 与 12 之间的月份,而 DD 是对给定月份有效的日期值。 时间部分的格式必须为 HH:MM[:SS[.fffffff]],其中 HH 为介于 0 至 23 之间的小时值,MM 为介于 0 至 59 之间的分钟值,SS 为介于 0 至 59 之间的秒值,而 fffffff 为介于 0 至 9999999 之间的秒的小数部分值。 所有值范围都包含两端。 秒的小数部分是可选的。 除非指定了秒的小数部分,否则秒是可选的;在指定了秒的小数部分时秒是必需的。 在未指定秒或秒的小数部分时,将使用默认值零。 偏移量的部分必须具有格式 {+|-} hh: mm,其中 HH 和 MM 具有相同的意义与时间部分。 但是,偏移量的范围必须介于 -14:00 至 + 14:00 之间。
在 DATETIMEOFFSET 符号与文字负载之间可以存在任意数目的空格,但是不能存在新行。
DATETIMEOFFSET‘2006-10-1 23:11 +02:00’
DATETIMEOFFSET‘2006-12-25 01:01:00.0000000 -08:30’
Note: 有效的 Entity SQL 文字值可能处于 CLR 或数据源所支持的范围之外。 这可能会导致异常。
二进制
二进制字符串文字是由单引号分隔的一系列十六进制数字,后跟关键字“binary”或快捷方式符号 X/x。 快捷方式符号 X 是不区分大小写的。 在关键字 binary 与二进制字符串值之间可以有零个或零个以上空格。
十六进制字符也不区分大小写。 如果文字由奇数个十六进制数字组成,则将通过在文字之前附加十六进制数字零作为前缀,使文字与下一个偶数十六进制数字对齐。 对于二进制字符串的大小,不存在正式的限制。
Binary'00ffaabb'
X'ABCabc'
BINARY '0f0f0f0F0F0F0F0F0F0F'
X'' –- empty binary string
GUID
GUID 文本表示全局唯一标识符。 它是一个序列,由关键字GUID跟十六进制数字构成,采用称为注册表格式:包含在单引号内的 8-4-4-4-12。 十六进制数字区分大小写。
在 GUID 符号与文字负载之间可以存在任意数目的空格,但是不能存在新行。
Guid'1afc7f5c-ffa0-4741-81cf-f12eAAb822bf'
GUID '1AFC7F5C-FFA0-4741-81CF-F12EAAB822BF'
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
