SQLServer数据类型映射——.NET Framework类型、DbType和SqlDbType枚举以及SqlDataReader的访问器方法

SQL Server 和 .NET Framework 基于不同的类型系统。 例如，.NET Framework Decimal 结构的最大小数位数为 28，而 SQL Server 的 decimal 和 numeric 数据类型的最大小数位数为 38。 为在读取和写入数据时维护数据完整性，SqlDataReader 将公开用于返回 System.Data.SqlTypes 的对象的 SQL Server 特定的类型化访问器方法以及用于返回 .NET Framework 类型的访问器方法。 SQL Server 类型和 .NET Framework 类型也可通过 DbType 和 SqlDbType 类中的枚举表示，当您指定 SqlParameter 数据类型时可以使用这些枚举。

下表显示了推断的 .NET Framework 类型、DbType 和 SqlDbType 枚举以及 SqlDataReader 的访问器方法。

SQL Server 数据库引擎类型	.NET Framework 类型	SqlDbType 枚举	SqlDataReader SqlTypes 类型化访问器	DbType 枚举	SqlDataReader DbType 类型化访问器
bigint	Int64	BigInt	GetSqlInt64	Int64	GetInt64
binary	Byte[]	VarBinary	GetSqlBinary	Binary	GetBytes
bit	布尔	Bit	GetSqlBoolean	Boolean	GetBoolean
char	String Char[]	Char	GetSqlString	AnsiStringFixedLength, String	GetString GetChars
date \\1 （SQL Server 2008 及更高版本）	DateTime	DateDate	GetSqlDateTime	DateDate	GetDateTime
datetime	DateTime	DateTime	GetSqlDateTime	DateTime	GetDateTime
datetime2 （SQL Server 2008 及更高版本）	DateTime	DateTime2	无	DateTime2	GetDateTime
datetimeoffset （SQL Server 2008 及更高版本）	DateTimeOffset	DateTimeOffset	无	DateTimeOffset	GetDateTimeOffset
Decimal	小数	Decimal	GetSqlDecimal	Decimal	GetDecimal
FILESTREAM attribute (varbinary(max))	Byte[]	VarBinary	GetSqlBytes	Binary	GetBytes
FLOAT	Double	Float	GetSqlDouble	Double	GetDouble
image	Byte[]	Binary	GetSqlBinary	Binary	GetBytes
int	Int32	Int	GetSqlInt32	Int32	GetInt32
money	小数	Money	GetSqlMoney	Decimal	GetDecimal
nchar	String Char[]	NChar	GetSqlString	StringFixedLength	GetString GetChars
ntext	String Char[]	NText	GetSqlString	String	GetString GetChars
numeric	小数	Decimal	GetSqlDecimal	Decimal	GetDecimal
nvarchar	String Char[]	NVarChar	GetSqlString	String	GetString GetChars
real	Single	Real	GetSqlSingle	Single	GetFloat
rowversion	Byte[]	Timestamp	GetSqlBinary	Binary	GetBytes
smalldatetime	DateTime	DateTime	GetSqlDateTime	DateTime	GetDateTime
smallint	Int16	SmallInt	GetSqlInt16	Int16	GetInt16
smallmoney	小数	SmallMoney	GetSqlMoney	Decimal	GetDecimal
sql_variant	Object \\2	Variant	GetSqlValueGetSqlValue	Object	GetValueGetValue
text	String Char[]	Text	GetSqlString	String	GetString GetChars
time （SQL Server 2008 及更高版本）	TimeSpan	Time	无	Time	GetDateTime
timestamp	Byte[]	Timestamp	GetSqlBinary	Binary	GetBytes
tinyint	Byte	TinyInt	GetSqlByte	Byte	GetByte
uniqueidentifier	Guid	UniqueIdentifier	GetSqlGuid	Guid	GetGuid
varbinary	Byte[]	VarBinary	GetSqlBinary	Binary	GetBytes
varchar	String Char[]	VarChar	GetSqlString	AnsiString, String	GetString GetChars
xml	Xml	Xml	GetSqlXml	Xml	无

\\1 无法将 SqlParameter 的 属性设置为 SqlDbType.Date。
\\2 如果已知 的基础类型，则使用特定的类型化访问器。

SQL Server 文档

有关 SQL Server 数据类型的详细信息，请参阅数据类型 (Transact-SQL)。

另请参阅

• SQL Server 数据类型和 ADO.NET
• SQL Server 二进制和大值数据
• ADO.NET 中的数据类型映射
• 配置参数和参数数据类型
• ADO.NET 概述

SQL Server 数据类型映射 - ADO.NET | Microsoft Docs