Elemento Name (ASSL)

Contiene il nome dell'elemento padre.

Sintassi

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

Caratteristiche elemento

Caratteristica	Descrizione
Tipo di dati e lunghezza	Stringa (fino a 100 caratteri)
Valore predefinito	Varia
Cardinalità	1-1: elemento obbligatorio che si presenta una sola volta.

Relazioni elemento

Relazione	Elemento
Elementi padre	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
Elementi figlio	nessuno

Osservazioni

Ogni elemento usato per definire un oggetto (un'istanza di Analysis Services, una gerarchia, un attributo e così via) ha un elemento Name come proprietà. Il valore di un elemento Name presenta le restrizioni seguenti:

• Il valore non deve contenere spazi iniziali o finali. Se nel valore di un elemento Name sono inclusi spazi iniziali o finali, tali spazi verranno rimossi in modo implicito daAnalysis Services.

• Nel valore non dovrebbero essere contenuti caratteri di controllo. La presenza di caratteri di controllo in un nome è fortemente sconsigliata e può talvolta causare errori di convalida XML.

  Per gli oggetti creati usando il metodo GetNewName in SQL Server, AMO verifica e successivamente rimuove eventuali caratteri di controllo, spazi iniziali o spazi finali nel nome. Per questo motivo, l'uso di GetNewName è l'approccio consigliato per l'impostazione dei nomi degli oggetti.

  Tuttavia, se si imposta direttamente la proprietà Name , gli stessi controlli di convalida non vengono eseguiti, causando eventualmente errori di convalida XML. L'effettiva generazione di un errore dipende dal carattere di controllo visualizzato nel nome.

  Sebbene i caratteri di controllo non debbano mai essere utilizzati nel nome di un oggetto, non vengono impediti espressamente da Analysis Services. Talvolta, nelle versioni precedenti di Analysis Services venivano accettati i caratteri di controllo nel nome di un oggetto. Per questo motivo, SQL Server 2016 Analysis Services e versioni successive ignoreranno i caratteri di controllo nel nome di un oggetto per evitare di interrompere le soluzioni meno recenti.

• Impossibile utilizzare i seguenti valori riservati:

  • AUX

  • CLOCK$

  • COM1 tramite COM9 (COM1, COM2, COM3 e così via)

  • CON

  • LPT1 tramite LPT9 (LPT1, LPT2, LPT3 e così via)

  • NUL

  • PRN

Nella tabella seguente sono elencati i caratteri aggiuntivi che non possono essere utilizzati all'interno del valore di un elemento Name , a seconda dell'elemento padre.

Elemento padre	Caratteri non validi
Server	Il nome deve seguire le regole per i nomi Windows computer. Gli indirizzi IP non sono validi.
DataSource	:/\\*&#124;?"()[]{}<> `
Elemento Level, Attribute	.,;':/\\*&#124;?"&%$!+=[]{}<> `
Tutti gli altri elementi padre	.,;':/\\*&#124;?"&%$!+=()[]{}<> `

Vedere anche

Elemento ID (ASSL)
Proprietà (ASSL)