COL_LENGTH (Transact-SQL)

Data aggiornamento: 17 luglio 2006

Restituisce la lunghezza definita di una colonna, espressa in byte.

Convenzioni della sintassi Transact-SQL

Sintassi

COL_LENGTH ( 'table' , 'column' ) 

Argomenti

• 'table'
  Nome della tabella a cui appartiene la colonna per cui si desidera ottenere informazioni sulla lunghezza. table è un'espressione di tipo nvarchar.

• 'column'
  Nome della colonna per cui si desidera ottenere informazioni sulla lunghezza. column è un'espressione di tipo nvarchar.

Tipo restituito

smallint

Eccezioni

Restituisce NULL in caso di errore o se un chiamante non dispone dell'autorizzazione necessaria per visualizzare l'oggetto.

In SQL Server 2005 un utente può visualizzare esclusivamente i metadati delle entità a protezione diretta di cui è proprietario o per cui ha ricevuto un'autorizzazione. Di conseguenza, le funzioni predefinite di creazione dei metadati come COL_LENGTH possono restituire NULL se l'utente non dispone di alcuna autorizzazione per l'oggetto. Per ulteriori informazioni, vedere Configurazione della visibilità dei metadati e Risoluzione dei problemi relativi alla visibilità dei metadati.

Osservazioni

Per le colonne di tipo varchar dichiarate con l'identificatore max (varchar(max)), COL_LENGTH restituisce il valore –1.

Esempi

Nell'esempio seguente vengono illustrati i valori restituiti per una colonna di tipo varchar(40) e una colonna di tipo 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;

Set di risultati:

VarChar     NVarChar
40          80

Vedere anche

Riferimento

Espressioni (Transact-SQL)
Funzioni per i metadati (Transact-SQL)
COL_NAME (Transact-SQL)
COLUMNPROPERTY (Transact-SQL)

Altre risorse

Modifica delle proprietà delle colonne

Guida in linea e informazioni

Assistenza su SQL Server 2005

Cronologia modifiche

Versione	Cronologia
17 luglio 2006	Nuovo contenuto: Aggiunta della sezione "Eccezioni".