Database │ Log │ │ Unmanaged │ │ │ x86 ●── │ ─ │ ─ │ ─ SQLite3 │ │ ●── ●── │ ─ Types │ │ ○ ─ ○ ─ │ ─ ●── Interfaces │ │ ●── ○ ─ │ ─ ●── │ ─ Generics │ │ ●── ●── │ ─ ●── │ ─ │ ─ Sys │ ●── ○ ─ ○ ─ │ ─ ●── ●── ●── │ ─ Dispatcher │ ●── ●── ○ ─ │ ─ ●── ○ ─ ●── │ ─ ●── Serializer │ ●── ●── ●── │ ─ ●── ●── ●── ●── ●── │ ─ Class ●── ●── ○ ─ ○ ─ ●── ●── ○ ─ ●── ○ ─ ○ ─ ●── ●── SeOSQLite3 │ ●── ●── ●── │ ─ ●── ●── ●── ○ ─ ●── │ ─ ●── │ ─ IO │ ○ ─ ○ ─ ○ ─ │ ─ ○ ─ ○ ─ ○ ─ ○ ─ ○ ─ │ ─ ○ ─ │ ─ ●── diub.AlphaVSS │ ●── ○ ─ ●── │ ─ ●── ○ ─ ○ ─ ○ ─ ○ ─ │ ─ ○ ─ │ ─ ●── │ ─ FTP │ ●── ○ ─ ●── │ ─ ●── ○ ─ ●── ○ ─ ○ ─ │ ─ ○ ─ │ ─ ●── │ ─ │ ─ WebDav ●── ●── ●── ○ ─ │ ─ ●── ●── ●── ○ ─ ○ ─ ●── ●── │ ─ ●── │ ─ │ ─ │ ─ PersistentIndex ●── ●── ●── ●── ●── ●── ●── ●── ●── ●── ●── ●── ●── ●── │ ─ │ ─ │ ─ ●── diub
#if DEBUG [DebuggerDisplay ("{DebuggerDisplay(),nq}")] #endif public class Example : IComparer<Object> { #if DEBUG /// <summary> /// Für die Ausgabe von "Text" im Debugger /// </summary> /// <returns></returns> public string DebuggerDisplay () { Text text; text = new Text (); text.AppendDebuggerDisplay (nameof (Date), ToString (WorldRegions.SystemDefault)); return text.ToString (); } #endif }
Wenn nur User-Code vom Debugger behandelt wird (Standardverhalten) kann mit diesem Funktions-Attribut ein Anhalten unterdrückt werden.
[System.Diagnostics.DebuggerNonUserCode] void Test () { try{ ... } catch(Exception) { } }
Für Designer unsichtbar machen
[Browsable (false), EditorBrowsable (EditorBrowsableState.Never)]
Nur Lesen
[ReadOnlyAttribute (true)]
CommonStatus
Der Status ist immer der erste Rückgabewert.
using diub.Universal; CommonStatus status; (status, setting) = Func (...);
https://docs.microsoft.com/de-de/dotnet/csharp/language-reference/configure-language-version
ProjektDatei ergänzen
<PropertyGroup> <Deterministic>false</Deterministic> </PropertyGroup>
Datei: Directory.Build.props
Im Projekt-Verzeichnis ablegen.
<Project> <PropertyGroup> <LangVersion>10</LangVersion> <Deterministic>false</Deterministic> </PropertyGroup> </Project>
InitializeComponent (); if (Setting.Designtime) return; // Öffnet den Dialog impliziet. StartUpDialog.Progress = 0; Setting.Init (this, App.DisplayButtons.None); // Icon aus PNG this.Icon = global::ConcatAudio.Properties.Resources.ConcatAudio.ToIcon (); Credits.Icon = this.Icon; Text = Credits.Copyright;
Laufzeitsicherung
if (Setting.Designtime) return; StartUpDialog.Progress = 5;
Persistenzen
Persistence.Initialize ();
Projektverwaltung mit eigenem Format
// siehe auch ProjectHandling project = new ProjectHandling<ProjType> (Firm.ExtSetSave) { FileFormat = FileFormats.Documenter, NewFunction = null, OpenFunction = OpenFile, SaveFunction = FileSaveAs, SaveAsFunction = FileSaveAs, UpdateRecentUsed = UpdateRecentUsed };
Projektverwaltung mit Standard-Format
//Projektverwaltung // siehe auch ProjectHandling project = new ProjectHandling<ProjType> (); // Menü & Toolstrip initialisieren project.InitMenuCallbacks (MenuFileNew, MenuFileOpen, MenuFileSave, MenuFileSaveAs, MenuFileRecentUsed); project.InitToolstripCallbacks (ToolFileNew, ToolFileOpen, ToolFileSave, ToolFileSaveAs); // Optional, falls Aktionen nach Öffnen oder Speichern notwendig sind project.OpenDone += OpenDone; project.SaveDone += SaveDone;
Ein Default-Projekt als Datei anlegen und Öffnen
private ProjectHandling<ProjType> project = new ProjectHandling<ProjType>(); if (!File.FileExists (PathFilename)) project.CreateProjectFile ( new RecentUsedItem (PathFilename, FileFormats.XML) ); else project.OpenProject ( new RecentUsedItem (PathFilename, FileFormats.XML), this );
Dann Verlauf der zuletzt verwendeten Dateien
Persistence.RecentUsed.InitRecentUsed ( MenuFileLastUsed, new EventHandler (project.MenuFileRecentUsed_Click) );
Logger
Logger.CleanUpOutdatedLogs (); Logger.Write (MsgLogLevel.System, "Load", "Start initiated.");
Sprache & Menüs erweitern
// Sprachen initialsieren Language.Init ("de,en,it", Persistence.LanguageInfo.MainId); // Dialoge anpassen Strip.BuildOptionsMenu (this, Menue, null, xKeys.NoName, true); Strip.BuildHelpMenu (this, MenuStrip); // Sprache darstellen Language.Paint (this);
Aktualisieren-Menü/-Schaltfläche
Strip.BuildUpdateMenu (this); Strip.BuildUpdateTool (this);
Dateiendung registrieren
string RegisterFiletypeId = "diub.CSVeditor2x"; RegisterFiletype.RegisterAs (RegisterFiletypeId, "csv");
Hotkeys
// Bindet den 'HotkeyMethodHandler' in die Tastaturbehandlung ein. // Sorgt für die Prüfung auf 'Enabled' des zugehörigen Steuerelements!! HotkeyMethodHandler.ExamineMethods (this); // Neu setzten der Zuordnungen aus einer vorherigen Sicherung. HotkeyMethodHandler.UpdateMethods (Vars.app_options.Hotkeys);
Initialisierungen des Programms
// zum Beispiel Listen find_items = new TimedList<string> ("FindItems", 50); replace_items = new TimedList<string> ("ReplaceItems", 50);
Skalierung
ScalePrefix ();
Zum persistenten Speichern von Optionen (Zustands-Variablen) die das ganze Programm betreffen.
// Beispiel-Klasse public class AppOptions : AppOptionsFrame<AppOptions> { public string LastSourcePath = null; } // Die Optionen wieder einlesen _app_options = AppOptions.Load (); // Die Optionen sichern (zur Verwendung im Close-Ereignis) _app_options.Store ();
Laufzeitsicherung
if (Setting.Designtime) return; StartUpDialog.Progress = 60;
Skalierung und Position
AsyncScaleRestorePosition ( FormAndControls.FormResizeMode.Enabled, ShownDone ); private void ShownDone (object sender, EventArgs e) { // Schließt den Dialog impliziet StartUpDialog.Progress = 100; }
Öffnen bei Programm-Start via Parameter
RecentUsedItem rui; string [] args = Environment.GetCommandLineArgs (); if (args.Length > 1) { rui = new RecentUsedItem (args [1], FileFormats. ...); project.OpenProject (rui, this); }
Ressource freigeben
// Geschieht bei 'SyncScaleRestorePosition' und 'AsyncScaleRestorePosition' impliziet Persistence.ReleaseSettings ();
Titel aktualisieren
Credits.UsageInfo = _project.UsedFilename;
Eine Übersicht findet sich unter: https://learn.microsoft.com/de-de/dotnet/standard/threading/overview-of-synchronization-primitives
Mutex (Mutual Exlusive)
Für exklusiven Zugriff: lässt immer nur einen einzelnen Thread zur Zeit aktiv werden; gegenseitige Ausschließlichkeit.
Semaphore / SemaphoreSlim
Zur Sperrung bzw. gleichzeitigen Nutzung durch eine definierte, maximale Anzahl von Threads. Dabei werden, falls mehr Anforderungen gestellt werden als maximal erlaubt, die zusätzlichen Threads suspendiert. Sie werden nacheinander freigegeben, sobald die maximale Anzahl unterschritten wird.
Falls Zähler gewünscht werden, siehe xSemaphore.
// MaxCount = maxmale Anzahl gleichzeitiger Zugriffe // FreeOnStart = zum Beginn die Anzahl der verfügbaren Zugriffe Semaphore sema = new Semaphore(FreeOnStart, MaxCount);
ManualResetEvent / ManualResetEventSlim
Zur manuellen Freigabe aller angeforderten Zugriffe. Die Sperrung erfolgt ebenfalls manuell!
Hinweis: nicht EventWaitHandle benutzten !
Zustände:
// False = Nicht signalisiert → Zugriffe werden aufgehalten ManualResetEvent mre = new ManualResetEvent(false);
AutoResetEvent
Zur manuellen Freigabe aller angeforderten Zugriffe. Die Sperrung erfolgt jedoch automatisch sofort (nach Freigabe der bis dahin aufgeaufenen Zugriffe).
Hinweis: nicht EventWaitHandle benutzten !
// False = Nicht signalisiert → Zugriffe werden aufgehalten AutoResetEvent are = new AutoResetEvent (false);
Monitor
Hinweis: in normalen Szenarien sollte statt Monitor besser Semaphore oder Mutex benutzt werden.
Minimal-Version eines eigenen Tickers.
private ManualResetEvent signal = new ManualResetEvent (false); public void Start () { signal.Reset(); (new Thread (Loop)).Start (); } public void Stop () { signal.Set (); } private void Loop () { do { // Tick...tick...tick while (!signal.WaitOne (Interval); } }
Delegat definieren
public delegate void DCmdKeyPressed (object sender, CmdKeyEventArgs e);
Event anlegen - sichtbar im Designer
[Category ("_diub")] [DesignerSerializationVisibility (DesignerSerializationVisibility.Visible)] [EditorBrowsable (EditorBrowsableState.Always)] [Browsable (true)] [Bindable (true)] [DefaultValue (null)] public event DCmdKeyPressed XKeyPressed;
Aufrufen
XKeyPressed?.Invoke (this, e);
// einfache *.bak Datei status = File.BackupThisFile (RUI.PathFilename); // Dateiname-[Datum-Zeit].Ext.Bak status = File.CreateTimedBackupFile (RUI.PathFilename, null, Vars.AppOptions.CommonOptions.GenerationBackups);
Hotkey Zuweisung
Hotkey = xKeys.Alt | xKeys.E;