Kategorie: Softwareentwicklung

Benutzerdefinierte Validierung unter ASP.NET MVC 👍 👎

Sehr praktisch unter ASP.NET MVC sind Attribute zur Validierung in Models. Standardmäßig bietet das .NET-Framework im Namensraum System.ComponentModel.DataAnnotations beispielsweise die Attribute Range, Required und StringLength, deren Verwendung wohl selbsterklärend sein dürfte.

Manchmal benötigt man jedoch etwas speziellere Validierungen und möchte naheliegenderweise dennoch auf eine einheitliche Vorgehensweise setzen. Hierfür steht das (abstrakte) Attribut Validation zur Verfügung, von welchem wir eine konkrete Implementierung für unser Vorhaben ableiten können.

Für unser Beispiel möchten wir ein Attribut zur Validierung implementieren, welches angibt, dass ein Feld (üblicherweise indirekt aus einem Formular vom Benutzer befüllt) mindestens eine Ziffer, zwei Großbuchstaben und drei Kleinbuchstaben enthalten muss. Wir halten es bewusst einfach, um uns auf den Kontext zu konzentrieren:
Benutzerdefiniertes Attribut zur Validierung implementieren
010203040506070809101112131415161718
[AttributeUsage(AttributeTargets.Property)]public class PasswordAttribute : ValidationAttribute {    public override bool IsValid(object value) {        string val = value as string;
if(!String.IsNullOrWhiteSpace(val)) { return ( val.Count(c => Char.IsDigit(c)) >= 1 && val.Count(c => Char.IsUpper(c)) >= 2 && val.Count(c => Char.IsLower(c)) >= 3 ); } else { return false; } }}
Dies ist eine sehr grundlegende Implementierung, die sich durchaus noch erweitern (und optimieren) lässt. Grundsätzlich genügt dieses Vorgehen jedoch bereits, um Verwendung zu finden. Das Attribut wird dazu wie üblich über der entsprechenden Eigenschaft der Model-Klasse deklariert:
Benutzerdefiniertes Attribut zur Validierung verwenden
01020304050607
public class User {    [Password]    public string Password {        get;        set;    }}
Eine allgemeine Einführung zum MVC-Framework möchte ich gerne in einem späteren Beitrag liefern.

Datei per ASP.NET MVC ausliefern 👍 👎

Häufig möchte man auf seiner Webpräsenz nicht nur mit HTML-Ansichten arbeiten, sondern beispielsweise auch Dateien zum Herunterladen anbieten. Das ist selbstverständlich auch unter ASP.NET MVC kein Problem, sondern erfordert lediglich eine Aktion mit dem Rückgabetyp FileResult.

Hierbei handelt es sich jedoch um eine abstrakte (Basis-)Klasse, konkrete Implementierungen stehen mit FileContentResult, FilePathResult und FileStreamResult zur Verfügung. Wir begnügen uns mit einem minimalistischen Beispiel und verwenden FilePathResult – was soweit selbsterklärend sein dürfte:
Download-Aktion im Controller "Gallery"
01020304050607
public class GalleryController : Controller {    public FileResult Download() {        return new FilePathResult(@"X:\Pfad\zur\Datei\MeinBild.png", "image/png") {            FileDownloadName = "Bild.png"  // Dateiname für Benutzer festlegen        };    }}
Sofern FileDownloadName gesetzt wird, sollte der Browser die Datei automatisch zum Speichern anbieten, ansonsten greift das jeweilige Standardverhalten. Weitere Möglichkeiten bieten euch die bereits erwähnten anderen Implementierungen, natürlich könnt ihr auch jederzeit selbst welche für eure eigenen Bedürfnisse ableiten.

Rundung in C# (und PHP) 👍 👎

Rundung erscheint auf den ersten Blick so selbstverständlich, dass so mancher geneigt scheint, sich darüber gar keine großen Gedanken zu machen. Beim Ab- und Aufrunden mit Methoden wie Math.Floor und Math.Ceiling gibt es auch tatsächlich keine großen Überraschungen bei den meisten Programmiersprachen:
Auf- und Abrunden
010203040506070809
  // Abrundungdouble floor1 = Math.Floor(1.3);  // 1double floor2 = Math.Floor(1.5);  // 1double floor3 = Math.Floor(1.7);  // 1  // Aufrundungdouble ceiling1 = Math.Ceiling(1.3);  // 2double ceiling2 = Math.Ceiling(1.5);  // 2double ceiling3 = Math.Ceiling(1.7);  // 2
Spannend wird es jedoch beim allgemeineren Rundungsverfahren mit Math.Round, bei welchem sich das Verhalten standardmäßig zu dem unterscheiden kann, was man beispielsweise aus der Schule als kaufmännisches Runden oder vom Standardverhalten von round aus PHP kennt. Der Unterschied liegt konkret beim Rundungsverhalten an der Ziffer 5:
Rundungsverhalten an der Ziffer "5"
01020304050607
double rounded11 = Math.Round(2.3);  // 2double rounded12 = Math.Round(2.5);  // 2 (!)double rounded13 = Math.Round(2.7);  // 3
double rounded21 = Math.Round(7.3); // 7double rounded22 = Math.Round(7.5); // 8double rounded23 = Math.Round(7.7); // 8
Die Ursache für dieses für manche möglicherweise überraschende Verhalten liegt darin begründet, dass bei C# das mathematische Rundungsverfahren zur Anwendung kommt, welches in so einem Fall standardmäßig die Rundung zur nächsten geraden Ziffer vorschreibt, anstatt pauschal aufzurunden. Das Anliegen dabei ist es, statistische Verzerrungen durch ausschließliches Aufrunden an dieser Stelle zu vermeiden. Dies ist in jedem Fall bei der Interoperabilität mit anderen Systemen, die auf eine gleiche Datenbasis zugreifen, zu berücksichtigen.

Sowohl bei C# als auch bei PHP lässt sich dieses Verhalten jedoch manuell anpassen (und dadurch nötigenfalls angleichen), indem man unter C# einen Wert der Enumeration MidpointRounding oder unter PHP eine der Konstanten PHP_ROUND_HALF_* an die entsprechende Methode/Funktion zur Rundung übergibt.

WPF-Fenster ohne Titelleiste verschieben 👍 👎

Ein WPF-Fenster, dessen Eigenschaft WindowStyle der Wert None zugewiesen ist, besitzt keine standardmäßige Titelleiste mehr – was ja letztlich auch Sinn der Sache ist.

Eine häufig gewünschte und auch meist sehr sinnvolle Funktionalität ist jedoch, dass der Benutzer das Fenster dennoch verschieben können soll. Dies ist – wie so oft, wenn man weiß, wie – sehr einfach zu lösen. Wir registrieren dazu einfach eine Ereignisbehandlung für MouseLeftButtonDown auf einem Steuerelement des Fensters (oder im Zweifelsfall gar auf dem Fenster selbst) und rufen die DragMove-Methode des Fensters auf:
Fenster per DragMove() verschiebbar machen
010203
private void Window_MouseLeftButtonDown(object sender, MouseButtonEventArgs e) {    this.DragMove();}
Schon lässt sich das Fenster wie gewohnt bei gedrückter linker Maustaste verschieben.

Attribute in C# 👍 👎

Attribute in C# sind eine komfortable Möglichkeit, um Klassen, Methoden und andere Member mit Metadaten anzureichern. Diese können anschließend während der Laufzeit per Reflexion ausgewertet werden.

Konkret möchten wir ein Attribut Description erzeugen, mit welchem wir Methoden eine Beschreibung geben können. Wir müssen uns dazu lediglich eine von Attribute abgeleitete Klasse erstellen, die die entsprechende Information aufnehmen kann:
"Description"-Attribut definieren
0102030405060708091011
[AttributeUsage(AttributeTargets.Method, AllowMultiple = false)]public class Description : Attribute {    public string Text {        get;        set;    }
public Description(string text) { this.Text = text; }}
Über das AttributeUsage-Attribut legen wir dabei fest, dass das Attribut lediglich (einmal) für eine Methode Verwendung finden können soll.

Nun setzen wir das Attribut für die Methode StartImportantAction einer Klasse ImportantClass:
"Description"-Attribut setzen
0102030405060708
public class ImportantClass {    [Description("Führt eine wichtige Aktion aus!")]    public void StartImportantAction() {        /**         * Aktion ausführen        **/    }}
Anschließend können wir jederzeit von anderer Stelle aus auf diese Information zugreifen:
"Description"-Attribut abrufen
0102030405060708
  // MethodInfo ermittelnMethodInfo methodInfo = typeof(ImportantClass).GetMethod("StartImportantAction");
// "Description"-Attribut ermittelnDescription description = methodInfo.GetCustomAttribute<Description>();
// Beschreibung auslesenstring text = description.Text; // "Führt eine wichtige Aktion aus!"
Auf ähnliche Art und Weise entsteht beispielsweise automatisch die Schnittstellenbeschreibung von BitStadt.de. Im MSDN findet sich auch eine Übersicht allgemeiner Attribute des .NET-Frameworks.

Projektverweise

Kategorien / Archiv  |  Übersicht RSS-Feed

Schlagworte

Suche