Name-Element (ASSL)

Artikel
05/08/2023

Enthält den Namen des übergeordneten Elements.

Syntax

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

Elementmerkmale

Merkmal	BESCHREIBUNG
Datentyp und -länge	Zeichenfolge (bis zu 100 Zeichen)
Standardwert	Varies
Kardinalität	1-1: Erforderliches Element, das nur einmal auftritt

Elementbeziehungen

Beziehung	Element
Übergeordnete Elemente	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
Untergeordnete Elemente	Keine

Beziehung

Element

Übergeordnete Elemente

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

Untergeordnete Elemente

Keine

Bemerkungen

Jedes Element, das zum Definieren eines Objekts verwendet wird (eine Instanz von Analysis Services, eine Hierarchie, ein Attribut usw.), verfügt über ein Name-Element als Eigenschaft. Der Wert eines Name -Elements hat die folgenden Einschränkungen:

Der Wert darf keine führenden oder nachgestellten Leerzeichen enthalten. Wenn führende oder nachfolgende Leerzeichen im Wert eines Name-Elements enthalten sind, werden diese Leerzeichen implizit vonAnalysis Services entfernt.
Der Wert sollte keine Steuerzeichen enthalten. Es wird dringend von Steuerzeichen in einem Namen abgeraten, da dies in einigen Fällen zu XML-Überprüfungsfehlern führen kann.

Für Objekte, die mit der GetNewName-Methode in SQL Server erstellt wurden, sucht AMO nach Steuerzeichen, führenden Leerzeichen oder nachgestellten Leerzeichen im Namen und entfernt diese anschließend. Aus diesem Grund wird empfohlen, GetNewName zum Festlegen von Objektnamen zu verwenden.

Beim direkten Festlegen der Name -Eigenschaft werden jedoch nicht die gleichen Überprüfungen ausgeführt, was zu XML-Überprüfungsfehlern führen kann. Ob ein Fehler tatsächlich auftritt, hängt davon ab, welches Steuerzeichen im Namen vorkommt.

Obwohl in Objektnamen grundsätzlich auf Steuerzeichen verzichtet werden sollte, wird deren Verwendung von Analysis Services nicht ausdrücklich untersagt. Von früheren Analysis Services-Versionen wurden manchmal Steuerzeichen in Objektnamen akzeptiert. Aus diesem Grund ignoriert SQL Server 2016 Analysis Services und höher Steuerzeichen in einem Objektnamen, um zu vermeiden, dass ältere Lösungen unterbrochen werden.
Die folgenden reservierten Werte können nicht verwendet werden:
- AUX
- CLOCK$
- COM1 bis COM9 (COM1, COM2, COM3 usw.)
- CON
- LPT1 bis LPT9 (LPT1, LPT2, LPT3 usw.)
- NUL
- PRN

Die folgende Tabelle führt zusätzliche Zeichen auf, die abhängig vom übergeordneten Element nicht im Wert eines Name -Elements verwendet werden können.

Übergeordnetes Element	Ungültige Zeichen
Server	Der Name muss den Regeln für Windows Computernamen entsprechen. IP-Adressen sind nicht gültig.
DataSource	`:/\\*\|?"()[]{}<>` `
Level, Attribute Element	`.,;':/\\*\|?"&%$!+=[]{}<>` `
Alle anderen übergeordneten Elemente	`.,;':/\\*\|?"&%$!+=()[]{}<>` `

Weitere Informationen

ID-Element (ASSL)
Eigenschaften (ASSL)

Freigeben über