Name 元素 (ASSL)

包含父元素的名稱。

語法

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

元素特性

特性	說明
資料類型和長度	字串 (最多 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 執行個體、階層、屬性 (Attribute) 等等) 的每個元素都具有一個 Name 元素當做屬性 (Property)。 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 元素	.,;'`:/\*|?"&%$!+=[]{}<>
所有其他的父元素。	.,;'`:/\*|?"&%$!+=()[]{}<>

請參閱

參考

ID 元素 (ASSL)

屬性 (ASSL)