Vælg variabelnavne, der følger regler og konventioner

En softwareudvikler sagde engang berømt: "Den sværeste del af softwareudvikling er at navngive ting." Ikke alene skal navnet på en variabel følge visse syntaksregler, den bør også bruges til at gøre koden mere læsevenlig og forståelig for mennesker. Det er meget at bede om én kodelinje!

Regler for variabelnavne

Der er nogle regler for variabel navngivning, der gennemtvinges af C#-compileren.

• Variabelnavne kan indeholde alfanumeriske tegn og understregningstegn (_). Specialtegn som pund #, tankestreg -og dollartegn $ er ikke tilladt.
• Variabelnavne skal begynde med et alfabetisk bogstav eller et understregningstegn og ikke et tal. Brug af et understregningstegn til at starte et variabelnavn er typisk reserveret til private forekomstfelter. Du kan finde et link til yderligere læsning i moduloversigten.
• Variabelnavne må IKKE være et C#-nøgleord. Disse erklæringer om variabelnavne er f.eks. ikke tilladt: float float; eller string string;.
• Der skelnes mellem store og små bogstaver i variabelnavne, hvilket betyder, at der string MyValue;string myValue; er to forskellige variabler.

Konventioner for variabelnavne

Konventioner er forslag, der er aftalt af softwareudviklings community'et. Selvom du frit kan beslutte ikke at følge disse konventioner, er de så populære, at det kan gøre det svært for andre udviklere at forstå din kode. Du bør øve dig i at vedtage disse konventioner og gøre dem til en del af dine egne kodningsvaner.

• Variabelnavne bør bruge kamelbogstaver, som er en skrivestil, der bruger et lille bogstav i begyndelsen af det første ord og et stort bogstav i begyndelsen af hvert efterfølgende ord. For eksempel: string thisIsCamelCase;.
• Variabelnavne skal være beskrivende og meningsfulde i dit program. Du skal vælge et navn til variablen, der repræsenterer den type data, den indeholder (ikke datatypen). For eksempel: bool orderComplete;, IKKE bool isComplete;.
• Variabelnavne skal være et eller flere hele ord, der tilføjes sammen. Brug ikke sammentrækninger, fordi navnet på variablen kan være uklart for andre, der læser din kode. For eksempel: decimal orderAmount;, IKKE decimal odrAmt;.
• Variabelnavne må ikke indeholde variablens datatype. Du får måske vist nogle gode råd til at bruge en typografi som .string strMyValue; Det var en populær stil år siden. De fleste udviklere følger dog ikke længere dette råd, og der er gode grunde til ikke at bruge det.

Eksemplet string firstName; følger alle disse regler og konventioner, forudsat at du vil bruge denne variabel til at gemme data, der repræsenterer en persons fornavn.

Eksempler på variabelnavne

Her er et par eksempler på variabelerklæringer (ved hjælp af almindelige datatyper):

char userOption;

int gameScore;

float particlesPerMillion;

bool processedCustomer;

Andre navngivningskonventioner

De regler og konventioner, der er beskrevet ovenfor, er for lokale variabler. En lokal variabel er en variabel, der er begrænset inden for brødteksten i en metode, eller en variabel i et konsolprogram, der bruger sætninger på øverste niveau (som koden i dette modul).

Der er andre typer konstruktioner, som du kan bruge i dine programmer, og mange har deres egne konventioner. Klasser bruges f.eks. ofte i C#-programmering og har tilknyttede konventioner. Selvom du ikke opretter klasser i dette modul, er det vigtigt for dig at vide, at de navngivningskonventioner, du lige har lært om, passer ind i en større navngivningsramme.