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	Variabile
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 utilizzato per definire un oggetto (un'istanza di MicrosoftSQL ServerAnalysis Services, una gerarchia, un attributo e così via) ha un elemento Name come proprietà. Il valore di un elemento Name ha le seguenti restrizioni.

• Il valore non deve contenere spazi iniziali o finali. Se gli spazi iniziali o finali sono inclusi nel valore di un elemento Name, verranno rimossi implicitamente da Analysis 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 utilizzando il metodo GetNewName in SQL Server 2012, tramite AMO vengono cercati e, successivamente, rimossi tutti i caratteri di controllo, nonché gli spazi iniziali o finali nel nome. Per questo motivo, l'utilizzo di GetNewName è l'approccio consigliato per impostare i nomi degli oggetti.

  Tuttavia, se si imposta direttamente la proprietà Name, non vengono effettuati gli stessi controlli di convalida e, pertanto, potrebbero verificarsi 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 evitare quindi di compromettere le soluzioni precedenti, in SQL Server 2012 Analysis Services (SSAS) verranno ignorati i caratteri di controllo nel nome di un oggetto.

• 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 vengono elencati 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 Microsoft i nomi del computer di Windows. Gli indirizzi IP non sono validi.
DataSource	:/\*|?"()[]{}<>
Level, Elemento Attribute	.,;'`:/\*|?"&%$!+=[]{}<>
Tutti gli altri elementi padre	.,;'`:/\*|?"&%$!+=()[]{}<>

Vedere anche

Riferimento

Elemento ID (ASSL)

Proprietà (ASSL)