Compartilhar via


Usando várias cadeias de caracteres do SQL-DMO

Esse recurso será removido na próxima versão do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam.

As cadeias de caracteres múltiplas do SQL-DMO (SQL Distributed Management Objects) são usadas em diversos parâmetros em propriedades e métodos SQL-DMO. Usando cadeias de caracteres múltiplas, um usuário pode fornecer uma ou mais cadeias de caracteres delimitadas para o parâmetro e o SQL-DMO analisará a entrada em várias cadeias de caracteres.

Os objetos de banco de dados em instâncias do Microsoft SQL Server versão 6.5 e anteriores não podiam conter caracteres especiais como espaços, vírgulas e ponto-e-vírgulas. Assim, esses caracteres poderiam ser usados de modo intercambiável como caracteres delimitadores de cadeias de caracteres. Por exemplo, esta cadeia de caracteres múltipla contém quatro cadeias de caracteres separadas:

S1 S2,S3;S4

Entretanto, os objetos de banco de dados em instâncias do SQL Server versão 7.0 e posteriores podem conter quaisquer caracteres válidos no sistema operacional subjacente, incluindo espaços, vírgulas e ponto-e-vírgulas. Para acomodar esta alteração, o formato cadeias de caracteres múltiplas do SQL-DMO usa colchetes esquerdo e direito ([]) como delimitadores. O uso de espaços, vírgulas e ponto-e-vírgulas entre cadeias de caracteres entre colchetes é opcional. Por exemplo, estas duas cadeias de caracteres múltiplas, que contêm quatro cadeias de caracteres são idênticas:

[S1] [S2] [S3] [S4]
[S1] [S2],[S3];[S4]

Um colchete direito é usado como caractere de escape para uma cadeia de caracteres que contém um colchete direito. Por exemplo, a cadeia de caracteres "My]object" deve ser especificada como:

[My]]object]

Nenhum caractere de escape é necessário para um colchete esquerdo porque o SQL-DMO analisa cadeias de caracteres múltiplas da esquerda para a direita.

Para manter a compatibilidade com versões anteriores, ainda haverá suporte para o formato de cadeias de caracteres múltiplas se a cadeia de caracteres não contiver espaços, vírgulas, ponto-e-vírgulas ou colchetes. Se um aplicativo usa o formato de cadeias de caracteres múltiplas mais novo para uma cadeia de caracteres, o mesmo formato deverá ser usado para todas as cadeias de caracteres no parâmetro de cadeias de caracteres múltiplas.

As cadeias de caracteres múltiplas do SQL-DMO são usadas por estas propriedades e métodos: