Name-Element (ASSL)

Artikel
10/02/2012

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	Unterschiedlich
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

Ü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

Hinweise

Jedes Element, das zum Definieren eines Objekts (einer Instanz von Microsoft SQL Server Analysis Services, einer Hierarchie, eines Attributs usw.) verwendet wird, 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 der Wert eines Name-Elements führende oder nachgestellte Leerzeichen enthält, werden diese Leerzeichen implizit von Analysis 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.

Bei Objekten, die mit der GetNewName-Methode in SQL Server 2012 erstellt wurden, sucht AMO alle Steuerzeichen sowie führende oder nachfolgende 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 2012 Analysis Services (SSAS) Steuerzeichen in Objektnamen, um zu gewährleisten, dass ältere Lösungen einwandfrei funktionieren.
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 Microsoft Windows-Computernamen entsprechen. IP-Adressen sind nicht gültig.
DataSource	:/\*\|?"()[]{}<>
Level, Attribute Element	.,;'`:/\*\|?"&%$!+=[]{}<>
Alle anderen übergeordneten Elemente	.,;'`:/\*\|?"&%$!+=()[]{}<>

Siehe auch

Verweis

ID-Element (ASSL)

Eigenschaften (ASSL)

Freigeben über