Condividi tramite

Convenzioni di maiuscole e minuscole

Annotazioni

Questo contenuto viene ristampato con il permesso di Pearson Education, Inc. da Framework Design Guidelines: Conventions, Idioms e Pattern per Librerie .NET Riutilizzabili, 2a Edizione. Tale edizione è stata pubblicata nel 2008 e il libro è stato completamente rivisto nella terza edizione. Alcune informazioni in questa pagina potrebbero non essere aggiornate.

Le linee guida di questo capitolo illustrano un metodo semplice per l'uso del caso che, se applicato in modo coerente, rendono gli identificatori per tipi, membri e parametri facili da leggere.

Regole sull'uso delle maiuscole per gli identificatori

Per distinguere le parole in un identificatore, in maiuscolo la prima lettera di ogni parola nell'identificatore. Non usare caratteri di sottolineatura per distinguere le parole, o per qualsiasi motivo, in alcun identificatore. Esistono due modi appropriati per capitalizzare gli identificatori, a seconda dell'uso dell'identificatore:

  • PascalCasing

  • camelCasing

La convenzione PascalCasing, usata per tutti gli identificatori tranne i nomi dei parametri, maiuscola il primo carattere di ogni parola (inclusi gli acronimi di lunghezza superiore a due lettere), come illustrato negli esempi seguenti:

PropertyDescriptor HtmlTag

Un caso speciale viene fatto per gli acronimi di due lettere in cui entrambe le lettere sono maiuscole, come illustrato nell'identificatore seguente:

IOStream

La convenzione camelCasing, usata solo per i nomi dei parametri, maiuscola il primo carattere di ogni parola tranne la prima parola, come illustrato negli esempi seguenti. Come anche l'esempio mostra, gli acronimi di due lettere che iniziano un identificatore con notazione camel case sono entrambi minuscoli.

propertyDescriptor ioStream htmlTag

✔️ DO Usa PascalCasing per tutti i nomi di membri, tipi e namespace pubblici costituiti da più parole.

✔️ Usa camelCasing per i nomi dei parametri.

Nella tabella seguente vengono descritte le regole di maiuscola per diversi tipi di identificatori.

Identificatore Maiuscole/minuscole Esempio
Namespace Pascal namespace System.Security { ... }
TIPO Pascal public class StreamReader { ... }
Interfaccia Pascal public interface IEnumerable { ... }
Metodo Pascal public class Object {
public virtual string ToString();
}
Proprietà Pascal public class String {
public int Length { get; }
}
Evento Pascal public class Process {
public event EventHandler Exited;
}
Campo Pascal public class MessageQueue {
public static readonly TimeSpan
InfiniteTimeout;
}
public struct UInt32 {
public const Min = 0;
}
Valore enumerato Pascal public enum FileMode {
Append,
...
}
Parametro Cammello public class Convert {
public static int ToInt32(string value);
}

Capitalizzazione delle parole composte e dei termini comuni

La maggior parte dei termini composti viene considerata come una singola parola ai fini della capitalizzazione.

❌ NON mettere in maiuscolo ogni parola nelle cosiddette parole composte a forma chiusa.

Si tratta di parole composte scritte come singola parola, ad esempio endpoint. Ai fini delle linee guida sulla gestione delle maiuscole, considera una parola composta in forma chiusa come una singola parola. Utilizzare un dizionario corrente per determinare se una parola composta viene scritta in formato chiuso.

Pascal Cammello Non
BitFlag bitFlag Bitflag
Callback callback CallBack
Canceled canceled Cancelled
DoNot doNot Don't
Email email EMail
Endpoint endpoint EndPoint
FileName fileName Filename
Gridline gridline GridLine
Hashtable hashtable HashTable
Id id ID
Indexes indexes Indices
LogOff logOff LogOut
LogOn logOn LogIn
Metadata metadata MetaData, metaData
Multipanel multipanel MultiPanel
Multiview multiview MultiView
Namespace namespace NameSpace
Ok ok OK
Pi pi PI
Placeholder placeholder PlaceHolder
SignIn signIn SignOn
SignOut signOut SignOff
UserName userName Username
WhiteSpace whiteSpace Whitespace
Writable writable Writeable

Distinzione tra maiuscole e minuscole

I linguaggi che possono essere eseguiti in CLR non sono tenuti a supportare la distinzione tra maiuscole e minuscole, anche se alcuni lo fanno. Anche se il linguaggio lo supporta, altri linguaggi che potrebbero accedere al framework non lo supportano. Tutte le API accessibili esternamente, pertanto, non possono basarsi solo su maiuscole e minuscole per distinguere tra due nomi nello stesso contesto.

❌ NON presupporre che tutti i linguaggi di programmazione facciano distinzione tra maiuscole e minuscole. Non lo sono. I nomi non possono essere diversi in base al solo caso.

© Porzioni 2005, 2009 Microsoft Corporation. Tutti i diritti riservati.

Ristampato dall'autorizzazione di Pearson Education, Inc. da Framework Design Guidelines: Conventions, Idioms e Patterns for Reusable .NET Libraries, 2nd Edition di Krzysztof Cwalina e Brad Abrams, pubblicato il 22 ottobre 2008 da Addison-Wesley Professional come parte della Serie di sviluppo di Microsoft Windows.

Vedere anche