Share via


QUOTENAME (Transact-SQL)

Retorna uma cadeia de caracteres Unicode com os delimitadores adicionados para tornar a cadeia de caracteres de entrada um identificador delimitado válido do SQL Server.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

QUOTENAME ( 'character_string' [ , 'quote_character' ] ) 

Argumentos

  • 'character_string'
    É uma cadeia de caracteres de dados de caracteres Unicode. character_string é sysname e é limitado a 128 caracteres. Entradas maior que 128 caracteres retornam NULL.

  • 'quote_character'
    É uma cadeia de um caractere a ser usada como o delimitador. Pode ser uma aspa simples ( ' ), um colchete esquerdo ou direito ( [] ) ou aspas duplas ( " ). Se quote_character não for especificado, serão usados colchetes.

Tipos de retorno

nvarchar(258)

Exemplos

O exemplo a seguir obtém a cadeia de caracteres abc[]def e usa os caracteres [ e ] para criar um identificador delimitado válido do SQL Server.

SELECT QUOTENAME('abc[]def')

Aqui está o conjunto de resultados.

[abc[]]def]

(1 row(s) affected)

Observe que o colchete direito na cadeia de caracteres abc[]def é duplicado para indicar um caractere de escape.