Name 元素 (ASSL)

  • 發行項

包含父元素的名稱。

語法

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

元素特性

特性 描述
資料類型和長度 字串 (最多 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、 Partition、 許可權、 透視圖、 PerspectiveCalculation、 ReportFormatParameter、 ReportParameter、 Role、 Server、 ServerProperty、 Trace
子元素 None

備註

每個用來定義物件 (實例 Analysis Services、階層、屬性等等的專案，) 都具有 Name 元素做為屬性。 Name元素的值具有下列限制：

  • 此值不得包含開頭或尾端空格。 如果 名稱 專案的值中包含前置或尾端空格，這些空格將會隱含地移除 byAnalysis Services。

  • 此值不應該包含控制字元。 強烈建議名稱中不要出現控制字元，這有時可能會導致 XML 驗證錯誤。

    針對使用 SQL Server 中的GetNewName方法所建立的物件，AMO 會檢查並接著移除名稱中的任何控制字元、開頭空白或尾端空格。 基於這個理由，使用 GetNewName 是設定物件名稱的建議方法。

    但是，如果您直接設定 Name 屬性，就不會執行相同的驗證檢查，可能會產生 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

下表列出的其他字元無法在 Name 專案的值內使用，端視父元素而定。

父元素 無效字元
Server 名稱必須遵循 Windows 電腦名稱稱的規則。 IP 位址無效。
資料來源 :/\\*&#124;?"()[]{}<> `
Level、 Attribute 元素 .,;':/\\*&#124;?"&%$!+=[]{}<> `
所有其他的父元素。 .,;':/\\*&#124;?"&%$!+=()[]{}<> `

另請參閱

ID 元素 (ASSL)
屬性 (ASSL)