Coding Conventions: Unterschied zwischen den Versionen
Justus (Diskussion | Beiträge) →Interfaces: Tipp-/Sinnfehler |
K Änderungen von Dietsch (Diskussion) wurden auf die letzte Version von Greitschus zurückgesetzt Markierung: Zurücksetzung |
||
(60 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
{{Stub}} | {{Stub}} | ||
Mit '''Coding Conventions''' sind ein mehr oder weniger fester Satz von Regeln gemeint, an die sich alle an einem Projekt teilnehmenden Programmierer halten sollten um den Quellcode leichter les- und wartbar zu machen. | Mit '''Coding Conventions''' sind ein mehr oder weniger fester Satz von Regeln gemeint, an die sich alle an einem Projekt teilnehmenden Programmierer halten sollten um den Quellcode leichter les- und wartbar zu machen. | ||
Hierbei werden zum Beispiel Namenskonventionen und ihre Schreibweise ausgemacht. Aber auch auf die Einrückungstiefe des Quellcodes, das Benutzen von Leerzeichen oder Tabstopps sowie andere Richtlinien bei der Codeerstellung kann hier eingegangen werden. | Hierbei werden zum Beispiel Namenskonventionen und ihre Schreibweise ausgemacht. Aber auch auf die Einrückungstiefe des Quellcodes, das Benutzen von Leerzeichen oder Tabstopps sowie andere Richtlinien bei der Codeerstellung kann hier eingegangen werden. | ||
Die Coding Conventions, die Sie im SoPra verwenden, werden durch das Visual Studio Plugin Resharper (im [[Downloads|Downloadbereich]] herunterladbar) durchgesetzt. Jeder Teilnehmer des Softwarepraktikums hat sich an diese Coding Conventions zu halten. Die Coding Conventions für ReSharper sind in der Datei [[Datei:UserSettings.zip]] enthalten. Eine Installationsanleitung für die benutzerspezifischen Einstellungen befindet sich [[Downloads#ReSharper|hier]]. Es ist wichtig, dass Ihr Programm keine Warnungen und Fehlermeldungen von ReSharper enthält (vgl. [[Anforderungen#Technische Anforderungen|Technische Anfoderungen]]). | |||
Die genauen Einzelheiten der Coding Conventions finden Sie bitte selbst heraus. Hier soll nur eine kurze Liste der wichtigsten Dinge benannt werden: | |||
== Namenskonventionen == | |||
Die folgenden Namenskonventionen sind einzuhalten: | |||
* [[Datentyp|Typen]] und [[Namensraum|Namespaces]]: <tt>UpperCamelCase</tt> | |||
* [[Interface]]s: <tt>IUpperCamelCase</tt> | |||
* [[Generic|Typ Parameter]]: <tt>TUpperCamelCase</tt> | |||
* [[Methode]]n, [[Property|Properties]] und Events: <tt>UpperCamelCase</tt> | |||
* Lokale [[Variable]]n: <tt>lowerCamelCase</tt> | |||
* Lokale [[Variable#Konstanten|Konstanten]]: <tt>lowerCamelCase</tt> | |||
* [[Methode#Parameter|Parameter]]: <tt>lowerCamelCase</tt> | |||
* [[Klasse|Felder]] (nicht private): <tt>mUpperCamelCase</tt> | |||
* Instanzvariablen (private): <tt>mUpperCamelCase</tt> | |||
* Statische Felder (nicht private): <tt>sUpperCamelCase</tt> | |||
* Konstante Felder (nicht private): <tt>UpperCamelCase</tt> | |||
* Konstante Felder (private): <tt>UpperCamelCase</tt> | |||
* Statische [[Modifizierer|Readonly]] Felder (nicht private): <tt>sUpperCamelCase</tt> | |||
* Statische Readonly Felder (private): <tt>sUpperCamelCase</tt> | |||
* [[Enum]] Member: <tt>UpperCamelCase</tt> | |||
* Alles andere: <tt>UpperCamelCase</tt> | |||
== Klammerung == | |||
* Geschweifte Klammern stehen immer alleine in einer Zeile (einzige Ausnahme sind einzeilige [[Property|Properties]]). Beispiel: | |||
<source lang="csharp"> | <source lang="csharp"> | ||
class Class1 | |||
{ | { | ||
private int mVariable; | |||
// Braces in methods | |||
int Main() | |||
{ | |||
int a = 3; | |||
if (a < 3) | |||
{ | |||
return 1; | |||
} | |||
else | |||
{ | |||
return 0; | |||
} | |||
} | |||
// Single-line Property | |||
public | public int Variable | ||
{ | { | ||
get { return mVariable; } | |||
set { mVariable = value; } | |||
} | |||
} | } | ||
</source> | </source> | ||
* Runde Klammern (zum Beispiel bei der Verwendung von Parametern) haben keine Leerzeichen nach dem Öffnen der Klammer: | |||
<source lang="csharp"> | <source lang="csharp"> | ||
void Method(string s) | |||
{ | { | ||
} | } | ||
</source> | </source> | ||
== Sprache im Code == | |||
Die vornehmliche Sprache für alles, was mit dem Quelltext zu tun hat, ist Englisch. Das bedeutet, dass alle Variablen-, Methoden- und Klassenvariablen englisch benannt werden, um die Verständlichkeit des Codes zu erhöhen. Auch für Kommentare wird Englisch empfohlen, ist hier jedoch nicht ganz so wichtig. | |||
[[Kategorie:Begriffe]] [[Kategorie:Code-Beispiele]] | [[Kategorie:Begriffe]] | ||
[[Kategorie:Entwurf]] | |||
[[Kategorie:MS01]] [[Kategorie:Code-Beispiele]] |
Aktuelle Version vom 5. August 2021, 13:09 Uhr
Mit Coding Conventions sind ein mehr oder weniger fester Satz von Regeln gemeint, an die sich alle an einem Projekt teilnehmenden Programmierer halten sollten um den Quellcode leichter les- und wartbar zu machen.
Hierbei werden zum Beispiel Namenskonventionen und ihre Schreibweise ausgemacht. Aber auch auf die Einrückungstiefe des Quellcodes, das Benutzen von Leerzeichen oder Tabstopps sowie andere Richtlinien bei der Codeerstellung kann hier eingegangen werden.
Die Coding Conventions, die Sie im SoPra verwenden, werden durch das Visual Studio Plugin Resharper (im Downloadbereich herunterladbar) durchgesetzt. Jeder Teilnehmer des Softwarepraktikums hat sich an diese Coding Conventions zu halten. Die Coding Conventions für ReSharper sind in der Datei Datei:UserSettings.zip enthalten. Eine Installationsanleitung für die benutzerspezifischen Einstellungen befindet sich hier. Es ist wichtig, dass Ihr Programm keine Warnungen und Fehlermeldungen von ReSharper enthält (vgl. Technische Anfoderungen).
Die genauen Einzelheiten der Coding Conventions finden Sie bitte selbst heraus. Hier soll nur eine kurze Liste der wichtigsten Dinge benannt werden:
Namenskonventionen
Die folgenden Namenskonventionen sind einzuhalten:
- Typen und Namespaces: UpperCamelCase
- Interfaces: IUpperCamelCase
- Typ Parameter: TUpperCamelCase
- Methoden, Properties und Events: UpperCamelCase
- Lokale Variablen: lowerCamelCase
- Lokale Konstanten: lowerCamelCase
- Parameter: lowerCamelCase
- Felder (nicht private): mUpperCamelCase
- Instanzvariablen (private): mUpperCamelCase
- Statische Felder (nicht private): sUpperCamelCase
- Konstante Felder (nicht private): UpperCamelCase
- Konstante Felder (private): UpperCamelCase
- Statische Readonly Felder (nicht private): sUpperCamelCase
- Statische Readonly Felder (private): sUpperCamelCase
- Enum Member: UpperCamelCase
- Alles andere: UpperCamelCase
Klammerung
- Geschweifte Klammern stehen immer alleine in einer Zeile (einzige Ausnahme sind einzeilige Properties). Beispiel:
class Class1
{
private int mVariable;
// Braces in methods
int Main()
{
int a = 3;
if (a < 3)
{
return 1;
}
else
{
return 0;
}
}
// Single-line Property
public int Variable
{
get { return mVariable; }
set { mVariable = value; }
}
}
- Runde Klammern (zum Beispiel bei der Verwendung von Parametern) haben keine Leerzeichen nach dem Öffnen der Klammer:
void Method(string s)
{
}
Sprache im Code
Die vornehmliche Sprache für alles, was mit dem Quelltext zu tun hat, ist Englisch. Das bedeutet, dass alle Variablen-, Methoden- und Klassenvariablen englisch benannt werden, um die Verständlichkeit des Codes zu erhöhen. Auch für Kommentare wird Englisch empfohlen, ist hier jedoch nicht ganz so wichtig.