Elemento Name (ASSL)

Contém o nome do elemento pai.

Sintaxe

  
<Action> <!-- or one of the elements listed below in the Element Relationships table -->  
   ...  
   <Name>...</Name>  
   ...  
</Action>  

Características do elemento

Característica	Descrição
Comprimento e tipo de dados	Cadeia de caracteres (até 100 caracteres)
Valor padrão	Varia
Cardinalidade	1-1: elemento obrigatório que ocorre apenas uma única vez

Relações do elemento

Relação	Elemento
Elementos pai	Ação, agregação, AggregationDesign, AlgorithmParameter, anotação, assembly, ClrAssemblyFile, cubo, CubeDimension, CubeHierarchy, banco de dados, DataSource, DataSourceView, dimensão, DimensionAttribute, grupo, hierarquia, KPI, nível, MdxScript, medida, MeasureGroup, MemberProperty, MiningModel, MiningModelColumn, MiningStructure, MiningStructureColumn, partição, permissão, perspectiva, PerspectiveCalculation, ReportFormatParameter, ReportParameter, função, servidor, ServerProperty, rastreamento
Elementos filho	Nenhum

Comentários

Cada elemento usado para definir um objeto (uma instância de Analysis Services, uma hierarquia, um atributo e assim por diante) tem um elemento Name como uma propriedade. O valor de um elemento Name tem as seguintes restrições:

• O valor não pode conter espaços à esquerda ou direita. Se espaços à esquerda ou à direita forem incluídos no valor de um elemento de nome , esses espaços serão removidos implicitamente os serviços byAnalysiss.

• O valor não deve conter caracteres de controle. A presença de caracteres de controle em um nome não é recomendada, podendo, algumas vezes, resultar em erros de validação do XML.

  para objetos criados usando o método getnewname no SQL Server, o AMO verifica e subsequentemente remove quaisquer caracteres de controle, espaços à esquerda ou espaços à direita no nome. Por esse motivo, o uso de GetNewName é a abordagem recomendada para a configuração de nomes de objeto.

  No entanto, se você definir a propriedade Name diretamente, as mesmas verificações de validação não serão executadas, possivelmente resultando em erros de validação de XML. A geração de um erro dependerá de qual caractere de controle aparece no nome.

  Embora os caracteres de controle nunca devam ser usados em um nome de objeto, o Analysis Services não os evita expressamente. As versões anteriores do Analysis Services às vezes aceitavam caracteres de controle em um nome de objeto. por esse motivo, SQL Server 2016 Analysis Services e posteriores ignorarão os caracteres de controle em um nome de objeto para evitar a quebra de soluções mais antigas.

• Os valores reservados a seguir não podem ser usados:

  • AUX

  • CLOCK$

  • COM1 a COM9 (COM1, COM2, COM3 e assim por diante)

  • CON

  • LPT1 a LPT9 (LPT1, LPT2, LPT3 e assim por diante)

  • NUL

  • PRN

A tabela a seguir lista os caracteres adicionais que não podem ser usados dentro do valor de um elemento Name , dependendo do elemento pai.

Elemento pai	Caracteres inválidos
Servidor	o nome deve seguir as regras para Windows nomes de computador. Os endereços IP não são válidos.
DataSource	:/\\*&#124;?"()[]{}<> `
Elemento de nível, atributo	.,;':/\\*&#124;?"&%$!+=[]{}<> `
Todos os outros elementos pai	.,;':/\\*&#124;?"&%$!+=()[]{}<> `

Consulte Também

Elemento ID (ASSL)
Propriedades (ASSL)