DimensionAttribute.NamingTemplate Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft ab, wie Ebenen in einer Hierarchie mit über- und untergeordneten Namen benannt werden, die vom DimensionAttribute-Objekt erstellt wurde, oder legt dies fest.
public string NamingTemplate { get; set; }member this.NamingTemplate : string with get, setPublic Property NamingTemplate As StringEigenschaftswert
Eine Zeichenfolge, die definiert, wie Ebenen in einer übergeordneten untergeordneten Hierarchie benannt werden, die aus dem DimensionAttribute-Objekt erstellt wurde.
Hinweise
Der Wert der NamingTemplate-Eigenschaft wird nur von übergeordneten Attributen verwendet (das heißt, der Wert der Verwendung wird auf Parent festgelegt). Wenn ein übergeordnetes Attribut zum Erstellen einer Hierarchie verwendet wird, werden die Ebenen der Hierarchie durch die Über-/Unterordnungsbeziehungen zwischen den Elementen, die im übergeordneten Attribut enthalten sind, bestimmt. Daher können die Ebenennamen nicht wie bei anderen Dimensionen von den Attributnamen, die für die Hierarchie verwendet werden, abgeleitet werden. Stattdessen wird eine Benennungsvorlage verwendet, um Ebenennamen für Über-/Unterordnungshierarchien zu generieren. Die im übergeordneten Attribut definierte NamingTemplate-Eigenschaft enthält einen Zeichenfolgenausdruck, der verwendet wird, um Ebenennamen zu definieren. Es gibt zwei Möglichkeiten, eine Benennungsvorlage für ein übergeordnetes Attribut zu definieren. Sie können entweder ein Benennungsmuster entwerfen, oder Sie können eine Namensliste angeben. Ein Benennungsmuster enthält ein Sternchen (*) als Platzhalterzeichen für einen Zähler, der mit jeder neuen und tieferen Ebene erhöht und in den Namen eingefügt wird. Beispielsweise führt die Verwendung von "Level *" zu den Ebenennamen "Level 01", "Level 02", "Level 03" usw., sofern für die Ebenen nicht (Alle) definiert ist. Wenn ein Benennungsmuster kein Platzhalterzeichen enthält, wird es zunächst in seiner ursprünglichen Form verwendet. Danach werden dann alle folgenden Ebenen durch Anhängen eines Leerzeichens und einer Zahl an das Ende des Musters gebildet. Beispielsweise führt die Verwendung von "Level" zu den Ebenennamen "Level", "Level 01", "Level 02" usw. Um einen bestimmten Namenssatz für die Benennung zu verwenden, wird der Wert der NamingTemplate-Eigenschaft auf eine durch Semikolons getrennte Liste von Ebenennamen festgelegt. Jeder Name in der Liste wird für einen nachfolgenden Ebenennamen verwendet. Wenn die Anzahl der Ebenen die Anzahl der Namen in der Liste überschreitet, wird der letzte Name in der Liste als Vorlage für etwaige zusätzliche Ebenennamen verwendet, wobei ein Leerzeichen und eine Ordnungszahl gemäß der Beschreibung oben an den letzten Namen angehängt wird. Beispielsweise führt die Verwendung von "Division;Group;Unit" zu den Ebenennamen "Division", "Group", "Unit", "Unit 01", "Unit 02" usw. Die Verwendung von "Division;Group;Unit *" führt hingegen zu den Ebenennamen "Division", "Group", "Unit 03", "Unit 04" usw. Jeder Name in der Liste wird als Vorlage behandelt, um die Eindeutigkeit von Ebenennamen sicherzustellen. Beispielsweise führt die Verwendung von "Manager;Team Lead;Manager;Team Lead;Worker *" zu den Ebenennamen "Manager", "Team Lead", "Manager 01", "Team Lead 01", "Worker 05", "Worker 06". Durch die Verwendung von zwei Sternchen (**) wird das Sternchen-Zeichen (*) als Teil einer Benennungsvorlage in einen Ebenennamen aufgenommen.