Compartilhar via


DimensionAttribute.NamingTemplate Propriedade

Definição

Obtém ou define como os níveis são nomeados em uma hierarquia de pai-filho construída com base no objeto DimensionAttribute.

public string NamingTemplate { get; set; }
member this.NamingTemplate : string with get, set
Public Property NamingTemplate As String

Valor da propriedade

Uma cadeia de caracteres que define como os níveis são nomeados em uma hierarquia pai-filho construída a partir do objeto DimensionAttribute.

Comentários

O valor da propriedade NamingTemplate é usado apenas por atributos pai (ou seja, o valor de Usage é definido como Pai). Quando um atributo pai é usado para construir uma hierarquia, os níveis da hierarquia são determinados pelas relações pai-filho entre os membros contidos no atributo pai. Entretanto, ao contrário de outras dimensões, os nomes de nível não podem ser formulados a partir dos nomes de atributo que são usados para a hierarquia. Em vez disso, um modelo de nomeação é usado para gerar os nomes de nível para hierarquias pai-filho. A propriedade NamingTemplate, definida no atributo pai, contém uma expressão de cadeia de caracteres usada para definir os nomes de nível. Existem duas formas para definir um modelo de nomeação para um atributo pai. Você pode projetar um padrão de nomeação ou pode especificar uma lista de nomes. Um padrão de nomeação contém um asterisco (*) como um caractere de espaço reservado para um contador que é incrementado e inserido no nome de cada nível novo e que vai mais adiante. Por exemplo, o uso de Level * resulta em nomes de nível como Level 01, Level 02, Level 03 e assim por diante, no caso de nenhum (Todos) nível ter sido definido. Se um padrão de nomeação não tiver o caractere de espaço reservado, a primeira ocorrência será usada conforme seu nome original, e aos nomes de nível subsequentes serão anexados um espaço e um número no final do padrão. Por exemplo, o uso de Level resulta em nomes de nível como Level, Level 01, Level 02 e assim por diante. Para usar um conjunto de nomes específico para a nomeação, o valor da propriedade NamingTemplate é definido como uma lista de nomes de nível delimitada por ponto-e-vírgula. Cada um dos nomes na lista é usado para um nome de nível subsequente. Se o número de níveis exceder o número de nomes na lista, o último nome na lista será usado como um modelo para os demais nomes de nível, e a eles serão aplicados um espaço e um número ordinal anexado ao último nome, conforme descrito anteriormente. Por exemplo, usar Division;Group;Unit resulta em nomes de nível Division, Group, Unit, Unit 01, Unit 02 e assim por diante. Por contraste, usar Division;Group;Unit * resulta em nomes de nível Division, Group, Unit 03, Unit 04 e assim por diante. Cada nome na lista é tratado como um modelo para garantir a exclusividade dos nomes de nível. Por exemplo, usar Manager;Team Lead;Manager;Team Lead;Worker * resulta em nomes de nível Manager, Team Lead, Manager 01, Team Lead 01, Worker 05, Worker 06 Use dois asteriscos (**) para incluir o caractere de asterisco (*) em um nome de nível que faça parte de um modelo de nomeação.

Aplica-se a