Namngivningsparametrar
Kommentar
Det här innehållet skrivs om med behörighet från Pearson Education, Inc. från Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition. Den utgåvan publicerades 2008, och boken har sedan dess reviderats helt i den tredje utgåvan. En del av informationen på den här sidan kan vara inaktuell.
Utöver den uppenbara anledningen till läsbarhet är det viktigt att följa riktlinjerna för parameternamn eftersom parametrar visas i dokumentationen och i designern när visuella designverktyg tillhandahåller Intellisense- och klassbläddringsfunktioner.
✔️ ANVÄND camelCasing i parameternamn.
✔️ ANVÄND beskrivande parameternamn.
✔️ ÖVERVÄG att använda namn baserat på en parameters betydelse i stället för parameterns typ.
Överlagringsparametrar för namngivningsoperator
✔️ Använd left och right för parameternamn för binär operatoröverlagring om parametrarna inte har någon betydelse.
✔️ value Använd för namn på unary-operatorns överlagringsparameter om parametrarna inte har någon betydelse.
✔️ ÖVERVÄG meningsfulla namn för operatoröverlagringsparametrar om detta ger betydande värde.
❌ Använd INTE förkortningar eller numeriska index för operatoröverlagringsparameternamn.
Portioner © 2005, 2009 Microsoft Corporation. Med ensamrätt.
Reprinted by permission of Pearson Education, Inc. from Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition by Krzysztof Cwalina and Brad Abrams, publicerad 22 okt 2008 av Addison-Wesley Professional som en del av Microsoft Windows Development Series.