COL_LENGTH (Transact-SQL)

發行項
12/15/2008

更新： 2006 年 7 月 17 日

傳回資料行的定義長度 (以位元組為單位)。

語法

COL_LENGTH ( 'table' , 'column' )

引數

'table'
這是要判斷資料行長度資訊的資料表名稱。table 是 nvarchar 類型的運算式。

'column'
這是要判斷長度的資料行名稱。column 是 nvarchar 類型的運算式。

傳回類型

smallint

例外

當發生錯誤，或呼叫者沒有檢視物件的權限時，便會傳回 NULL。

在 SQL Server 2005 中，使用者只能檢視使用者擁有或被授與某些權限之安全性實體的中繼資料。這表示發出中繼資料的內建函數 (例如，COL_LENGTH) 會在使用者不具有該物件任何權限時傳回 NULL。如需詳細資訊，請參閱＜中繼資料可見性組態＞和＜中繼資料可見性疑難排解＞。

備註

對於利用 max 規範 (varchar(max)) 來宣告的 varchar 類型的資料行，COL_LENGTH 會傳回 -1。

範例

下列範例會顯示 varchar(40) 類型之資料行和 nvarchar(40) 類型之資料行的傳回值。

USE AdventureWorks;
GO
CREATE TABLE t1
   (c1 varchar(40),
    c2 nvarchar(40)
   );
GO
SELECT COL_LENGTH('t1','c1')AS 'VarChar',
      COL_LENGTH('t1','c2')AS 'NVarChar';
GO
DROP TABLE t1;

以下為結果集：

VarChar     NVarChar
40          80

請參閱

變更歷程記錄

版本	歷程記錄
2006 年 7 月 17 日	新增內容：加入「例外狀況」一節。

共用方式為

COL_LENGTH (Transact-SQL)

語法

引數

傳回類型

例外

備註

範例

請參閱

參考

其他資源

說明及資訊

變更歷程記錄

其他資源