Convenzioni di denominazione per i parametri
È importante attenersi scrupolosamente a queste convenzioni di denominazione per i parametri, poiché gli strumenti di progettazione visiva che forniscono funzionalità di guida sensibile al contesto e browser di classi determinano la visualizzazione agli utenti dei nomi dei parametri dei metodi nella finestra di progettazione. Le convenzioni di denominazione per i parametri sono definite dalle regole riportate di seguito.
- Utilizzare le maiuscole/minuscole camel per i nomi di parametri.
- Utilizzare nomi di parametri descrittivi. I nomi di parametri devono essere sufficientemente descrittivi per consentire che il nome del parametro e il relativo tipo possano essere utilizzati per determinarne il significato nella maggior parte degli scenari. Negli strumenti di progettazione visiva che forniscono una guida sensibile al contesto, ad esempio, i parametri dei metodi vengono visualizzati agli sviluppatori durante la digitazione. In questo scenario, i nomi di parametri devono essere sufficientemente descrittivi da consentire allo sviluppatore di specificare i parametri corretti.
- Utilizzare nomi che descrivono il significato di un parametro anziché nomi che descrivono il tipo di un parametro. È necessario che gli strumenti di sviluppo forniscano informazioni significative sul tipo di un parametro. Il nome di un parametro, quindi, può risultare più utile se descrive il significato. Utilizzare nomi di parametri basati sul tipo solo nei casi appropriati.
- Non utilizzare parametri riservati. I parametri riservati sono parametri privati che, se necessario, potrebbero essere esposti in una versione futura. Se, al contrario, sono necessari più dati in una versione futura della libreria di classi, aggiungere un nuovo overload per un metodo.
- Non aggiungere come prefisso la notazione del tipo ungherese ai nomi dei parametri.
Di seguito sono riportati alcuni esempi di parametri denominati correttamente.
GetType(typeName As String)As Type
Format(format As String, args() As object)As String
[C#]
Type GetType(string typeName)
string Format(string format, object[] args)
Vedere anche
Istruzioni di progettazione per gli sviluppatori di librerie di classi | Istruzioni per l'uso dei parametri