Name 元素 (ASSL)

包含父元素的名称。

语法

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

元素特征

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

元素关系

关系	元素
父元素	Action、 聚合、 AggregationDesign、 AlgorithmParameter、 Annotation、 Assembly、 ClrAssemblyFile、 Cube、 CubeDimension、 CubeHierarchy、 Database、 DataSource、 DataSourceView、 Dimension、 DimensionAttribute、 Group、 层次结构、 Kpi、 Level、 MdxScript、 Measure、 MeasureGroup、 是 memberproperty 类型、 MiningModel、 MiningModelColumn、 MiningStructure、 MiningStructureColumn、 分区、 权限、 透视、 PerspectiveCalculation、 ReportFormatParameter、 ReportParameter、 Role、 Server、 ServerProperty、 Trace
子元素	无

备注

用于定义对象的每个元素 (Analysis Services、层次结构、特性等) 的一个 名称 元素都是属性。 Name元素的值具有下列限制：

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

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

  对于在 SQL Server 中使用GetNewName方法创建的对象，AMO 会检查并删除名称中的任何控制字符、前导空格或尾随空格。 出于此原因，建议使用 GetNewName 来设置对象名称。

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

  虽然对象名称中绝对不应该使用控制字符，但 Analysis Services 并未严格阻止它们。 之前版本的 Analysis Services 有时接受对象名称中的控制字符。 出于此原因，SQL Server 2016 Analysis Services 和更高版本将忽略对象名称中的控制字符，以避免破坏旧版本的解决方案。

• 不可使用以下保留值：

  • AUX

  • CLOCK$

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

  • CON

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

  • NUL

  • PRN

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

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

另请参阅

ID 元素 (ASSL)
属性 (ASSL)