• 项目

DATALENGTH (Transact-SQL)

返回用于表示任何表达式的字节数。

主题链接图标Transact-SQL 语法约定

语法

DATALENGTH ( expression )

参数

  • expression
    任何数据类型的表达式。

返回类型

如果 expression 的数据类型为 varchar(max)、nvarchar(max) 或 varbinary(max) 数据类型，则返回 bigint；否则返回 int。

注释

对于 varchar、varbinary、text、image、nvarchar 和 ntext 数据类型，DATALENGTH 尤其有用，因为这些数据类型可以存储长度可变的数据。

NULL 的 DATALENGTH 的结果是 NULL。

注意注意

兼容级别可能影响返回值。有关兼容级别的详细信息，请参阅 ALTER DATABASE 兼容级别 (Transact-SQL)。

示例

下面的示例查找 Product 表中的 Name 列的长度。

USE AdventureWorks;
GO
SELECT length = DATALENGTH(Name), Name
FROM Production.Product
ORDER BY Name;
GO