Élément Name (ASSL)

Article
10/02/2012

Contient le nom de l'élément parent.

Syntaxe

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

Caractéristiques de l'élément

Caractéristique	Description
Type de données et longueur	Chaîne (jusqu'à 100 caractères)
Valeur par défaut	Variable
Cardinalité	1-1 : élément requis qui apparaît une fois et une seule.

Relations entre les éléments

Relation	Élément
Éléments parents	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
Éléments enfants	Aucun

Éléments parents

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

Éléments enfants

Aucun

Notes

Chaque élément utilisé pour définir un objet (une instance de Microsoft SQL Server Analysis Services, une hiérarchie, un attribut, et ainsi de suite) dispose d'un élément Name en tant que propriété. La valeur d'un élément Name est soumise aux restrictions suivantes :

La valeur ne peut pas contenir des espaces de début ou de fin. Si des espaces de début ou de fin apparaissent dans la valeur d'un élément Name, ils seront supprimés de manière implicite par Analysis Services.
La valeur ne doit pas contenir de caractères de contrôle. La présence de caractères de contrôle dans le nom est donc fortement déconseillée et peut parfois provoquer des erreurs de validation XML.

Pour les objets créés à l'aide de la méthode GetNewName dans SQL Server 2012, AMO vérifie et supprime ensuite tous les caractères de contrôle, les espaces de début et les espaces de fin dans le nom. C'est pourquoi l'utilisation de GetNewName est l'approche recommandée pour définir des noms d'objets.

Toutefois, si vous définissez la propriété Name directement, les mêmes contrôles de validation ne sont pas effectués, ce qui peut provoquer des erreurs de validation XML. Une erreur se produit en fonction du caractère de contrôle présent dans le nom.

Bien que les caractères de contrôle ne doivent jamais être utilisés dans un nom d'objet, Analysis Services ne les empêche pas expressément. Les versions antérieures d'Analysis Services autorisaient parfois des caractères de contrôle dans un nom d'objet. Pour cette raison, SQL Server 2012 Analysis Services (SSAS) ignore les caractères de contrôle dans un nom d'objet afin d'éviter de compromettre les solutions plus anciennes.
Les valeurs réservées suivantes ne peuvent pas être utilisées :
- AUX
- CLOCK$
- COM1 à COM9 (COM1, COM2, COM3 et ainsi de suite)
- CON
- LPT1 à LPT9 (LPT1, LPT2, LPT3, et ainsi de suite)
- NUL
- PRN

Le tableau suivant répertorie les caractères supplémentaires qui ne peuvent être employés dans la valeur d'un élément Name en fonction de l'élément parent.

Élément parent	Caractères non valides
Server	Le nom doit se conformer aux règles énoncées pour les noms des ordinateurs équipés de Microsoft Windows. Les adresses IP ne sont pas valides.
DataSource	:/\*\|?"()[]{}<>
Level, Élément Attribute	.,;'`:/\*\|?"&%$!+=[]{}<>
Tous les autres éléments parents	.,;'`:/\*\|?"&%$!+=()[]{}<>

Voir aussi

Référence

Élément ID (ASSL)

Propriétés (ASSL)

Partager via