Name 元素 (ASSL)

包含父元素的名称。

语法

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

元素特征

特征	说明
数据类型和长度	String（最多 100 个字符）
默认值	不定
基数	1-1：出现一次且仅出现一次的必需元素。

元素关系

关系	元素
父元素	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
子元素	无

注释

每个用于定义对象（Microsoft SQL Server Analysis Services 实例、层次结构、属性等）的元素都有一个作为属性的 Name 元素。 Name 元素的值具有下列限制：

• 该值不可包含前导空格或尾随空格。 如果 Name 元素的值中包含前导空格或尾随空格，则这些空格将会被 Analysis Services 隐式删除。

• 该值不应包含控制字符。 强烈建议名称中不要出现控制字符，这些字符有时会导致 XML 验证错误。

  对于使用 SQL Server 2012 中的 GetNewName 方法创建的对象，AMO 将检查并随后删除名称中的任何控制字符、前导空格或尾随空格。 因此，使用 GetNewName 是设置对象名称的推荐方法。

  但是，如果直接设置 Name 属性，将不会执行相同的验证检查，这可能导致 XML 验证错误。 实际是否会出现错误取决于名称中出现的是哪种控制字符。

  虽然对象名称中绝对不应该使用控制字符，但 Analysis Services 并未严格阻止它们。 之前版本的 Analysis Services 有时接受对象名称中的控制字符。 因此，SQL Server 2012 Analysis Services (SSAS) 将忽略对象名称中的控制字符以避免使早期的解决方案失效。

• 不可使用以下保留值：

  • AUX

  • CLOCK$

  • COM1 到 COM9（COM1、COM2、COM3 等）

  • CON

  • LPT1 到 LPT9（LPT1、LPT2、LPT3 等）

  • NUL

  • PRN

下表列出了不可在 Name 元素的值中使用的其他字符，具体取决于父元素。

父元素	无效字符
Server	此名称必须遵循 Microsoft Windows 计算机名称规则。 IP 地址无效。
DataSource	:/\*|?"()[]{}<>
Level、Attribute Element	.,;'`:/\*|?"&%$!+=[]{}<>
所有其他父元素	.,;'`:/\*|?"&%$!+=()[]{}<>

请参阅

参考

ID 元素 (ASSL)

属性 (ASSL)