Elemento Name (ASSL)

Artigo
10/02/2012

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	Action, Aggregation, AggregationDesign, AlgorithmParameter, Annotation, Assembly, ClrAssemblyFile, Cube, CubeDimension, CubeHierarchy, Database, DataSource, DataSourceView, Dimension, DimensionAttribute, Group, Hierarchy, Kpi, Level, MdxScript, Measure, MeasureGroup, MemberProperty, MiningModel, MiningModelColumn, MiningStructure, MiningStructureColumn, Partition, Permission, Perspective, PerspectiveCalculation, ReportFormatParameter, ReportParameter, Role, Server, ServerProperty, Trace
Elementos filho	Nenhum

Elementos pai

Action, Aggregation, AggregationDesign, AlgorithmParameter, Annotation, Assembly, ClrAssemblyFile, Cube, CubeDimension, CubeHierarchy, Database, DataSource, DataSourceView, Dimension, DimensionAttribute, Group, Hierarchy, Kpi, Level, MdxScript, Measure, MeasureGroup, MemberProperty, MiningModel, MiningModelColumn, MiningStructure, MiningStructureColumn, Partition, Permission, Perspective, PerspectiveCalculation, ReportFormatParameter, ReportParameter, Role, Server, ServerProperty, Trace

Elementos filho

Nenhum

Comentários

Cada elemento usado para definir um objeto (uma instância de Microsoft SQL Server Analysis Services, uma hierarquia, um atributo, etc.) 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 os espaços à esquerda ou direita forem incluídos no valor de um elemento Name, eles serão implicitamente removidos pelo Analysis Services.
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 através do método de GetNewName em SQL Server 2012, o AMO procura e descarta subsequentemente todos os caracteres de controle, espaços à esquerda ou espaços à direita no nome. Por isso, o uso de GetNewName é a abordagem recomendada para definir nomes de objeto.

No entanto, se você definir a propriedade Name diretamente, as mesmas verificações de validação não serão executadas, o que possivelmente resultará em erros de validação do 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 isso, o SQL Server 2012 Analysis Services (SSAS) ignorará os caracteres de controle em um nome de objeto para evitar o insucesso de soluções 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 no valor de um elemento Name, dependendo do elemento pai.

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

Consulte também

Referência

Elemento ID (ASSL)

Properties (ASSL)

Partilhar via