# Vrh.Common
  A modul a Vonalkód Rendszerház fejlesztési környezetében szabványosított és
  hasznosan alkalmazható eszközeinek gyűjtőhelye.
  
  > Igényelt minimális framework verzió: **4.5**
  
  > Teljes funkcionalitás és hatékonyság kihasználásához szükséges legalacsonyabb framework verzió: **4.5**
  
  # Főbb összetevők
  ### Interfészek
  * **[IManage](##IManage)**
  
  ### Standard osztályok
  * **[CheckListJSON](##CheckListJSON)**
  * **[ReturnInfoJSON](##ReturnInfoJSON)**
  * **[SelectListJSON](##SelectListJSON)**
  
  ## IManage
  Generikus interfész, melyben azt a típust kell megadni, amely menedzselését végzi.
  ```javascript
  /// <summary>
  /// Meghatározza és előírja egy karbantartást és hozzáférést 
  /// biztosító osztály elvárt tulajdonságait és módszereit.
  /// </summary>
  public interface IManage<T>
  {
      /// <summary>
      /// A kezelt típust össze egyedét szolgáltató tulajdonság.
      /// </summary>
      List<T> All { get; }
  
      /// <summary>
      /// A kezelt típus egy elemét adja vissza az egyedi azonosító segítségével.
      /// </summary>
      /// <param name="id">Az elem egyedi azonosítója.</param>
      /// <returns></returns>
      T Get(int id);
      /// <summary>
      /// A kezelt típus egy elemét adja vissza a megadott név segítségével.
      /// </summary>
      /// <param name="name">Az elem egyedi neve.</param>
      /// <returns></returns>
      T Get(string name);
  
      /// <summary>
      /// Létrehozza a kezelt típus egy elemét.
      /// </summary>
      /// <param name="item">A kezelt típus egy eleme, amit hozzá kell adni.</param>
      void Create(T item);
  
      /// <summary>
      /// A kezelt típus egy elemét törli az egyedi azonosító alapján.
      /// </summary>
      /// <param name="id">A törlendő elem egyedi azonosítója.</param>
  	void Delete(int id);
      /// <summary>
      /// A kezelt típus egy elemét törli az egyedi neve alapján.
      /// </summary>
      /// <param name="name">A törlendő elem egyedi neve.</param>
  	void Delete(string name);
  
      /// <summary>
      /// A kezelt típus egy elemének módosítása.
      /// Ha nem létezik az hiba.
      /// </summary>
      /// <param name="item">A kezelt típus egy eleme.</param>
      void Update(T item);
  }
  ```
  
  ## CheckListJSON
  ```javascript
  /// <summary>
  /// Egy meghívott akció válaszüzenetének egy lehetséges meghatározott szerkezete.
  /// Valamely lista ellenőrzéshez használható, amelyben a Checked oszlopban jelölhető az ellenőrzés eredménye.
  /// </summary>
  public class CheckListJSON
  {
      /// <summary>
      /// Az ellenőrzendő illetve ellenőrzött azonosító.
      /// </summary>
      public string Value { get; set; }
  
      /// <summary>
      /// Az ellenőrzéskor megtalált név vagy leíró.
      /// </summary>
      public string Text { get; set; }
  
      /// <summary>
      /// Az ellenőrzés eredményét jelző logikai érték, mely a felhasználáskor
      /// az üzleti logikától függ.
      /// </summary>
      public bool Checked { get; set; }
  }
  ```
  
  ## ReturnInfoJSON
  ```javascript
  /// <summary>
  /// Egy meghívott akció válaszüzenetének egy lehetséges meghatározott szerkezete.
  /// A válasz érték (ReturnValue) és üzenet (ReturnMessage) formájú. 
  /// Sikeres végrehajtás esetén mindig 0 legyen a ReturnValue.
  /// Sikertelen esetben ettől eltérő, de ha nincs egyéb ok, akkor hiba esetén legyen -1.
  /// Alapértelmezett érték: 0, "Az indított akció sikeresen lezajlott!" }
  /// </summary>
  public class ReturnInfoJSON
  {
      /// <summary>
      /// Egy reprezentatív értéke, mely a sikerességtől függ.
      /// Ha nincs hiba az akció végrehajtásában, akkor 0 legyen az értéke.
      /// Alapértelmezett értéke: 0
      /// </summary>
      public int ReturnValue { get; set; } = 0;
  
      /// <summary>
      /// Az akció üzenete. Hiba esetén a hibaüzenet szövege.
      /// Alapértelmezett értéke: "Az indított akció sikeresen lezajlott!"
      /// </summary>
      public string ReturnMessage { get; set; } = "Az indított akció sikeresen lezajlott!";
  }
  ```
  
  ## SelectListJSON
  ```javascript
  /// <summary>
  /// Egy meghívott akció válaszüzenetének egy lehetséges meghatározott szerkezete.
  /// Egy listához használható, mely értékeit és azonosítóit fel lehet használni.
  /// </summary>
  /// <remarks>
  /// Egyenértékű a System.Web.Mvc.SelectListItem osztállyal, de nem onnan származik.
  /// Az ott szereplő leírás: 
  /// "Represents the selected item in an instance of the System.Web.Mvc.SelectList class."
  /// </remarks>
  public class SelectListJSON 
  {
      /// <summary>
      /// Jelzi, hogy ez az elem a listában letiltott.
      /// </summary>
      public bool Disabled { get; set; }
  
      /// <summary>
      /// A csoport jelölése. Alapértelmezett értéke: null
      /// </summary>
      public SelectListGroup Group { get; set; }
  
      /// <summary>
      /// Jelzi, hogy ez az elem a listában kiválasztott.
      /// </summary>
      public bool Selected { get; set; }
  
      /// <summary>
      /// A listelem szövege, ami megjelenik.
      /// </summary>
      public string Text { get; set; }
  
      /// <summary>
      /// A listelem értéke.
      /// </summary>
      public string Value { get; set; }
  }
  
  #region SelectListGroup public class
  /// <summary>
  /// Represents the optgroup HTML element and its attributes. In a select list, 
  /// multiple groups with the same name are supported. 
  /// They are compared with reference equality.
  /// </summary>
  /// <remarks>
  /// A System.Mvc.SelectListItem-mel való kompatibilitás miatt van itt.
  /// A 'summary' szövege is onnan másolt.
  /// </remarks>
  public class SelectListGroup
  {
      /// <summary>
      /// Beállítja, hogy az adott csoport engedélyezett-e.
      /// </summary>
      public bool Disabled { get; set; }
  
      /// <summary>
      /// A csoport neve.
      /// </summary>
      public string Name { get; set; }
  }
  #endregion SelectListGroup public class
  ```
  
  

  ### Version History:
  #### 2.25.0 (2022.10.23) Compatible change:
  - SmartOrder kiterjesztés kibővítése úgy, hogy navigációs tulajdonságok rendezését is elvégezze.
  Például mostantól elfogadja a propertyName paraméterben a "Warehouse.Name" vagy "Warehouse.Type.Name"
  rendezésre vonatkozó rendezési kérést is.  
  #### 2.24.1 Patch (nuget: 2022.10.11):
  #### 2.24.0 Compatible (nuget: 2022.10.11):
  - WildCardToRegex osztály létrehozása
  #### 2.23.1 Compatible (nuget: 2022.05.25):
  SelectListJSON strukturába a Value alias-aként az Id mező beillesztése
  #### 2.23.0 Compatible (nuget: 2022.01.31):
  - VrhCommon / LoadProperties metódus beillesztése
  - Extensions.IQueriable / ToTraceQuery és ToTraceString beillesztése
  #### 2.22.0 Compatible (nuget: 2021.12.03):
  -StringConstructorban regex group alapú ResolveConstructor megvalósítása
  #### 2.21.3 Patch (nuget):
  #### 2.21.2 Patch (nuget):
  - a StringConstructor.ResolveConstructor metódusok nem voltak rekurzívak, tehát ha egy változó értékében másik változó hivatkozás volt,
  akkor azt már nem oldotta fel; bevezetésre kerültek az azonos paraméterezésű ResolveConstructorR metódusok, amelyek már ebben az értelemben rekurzívan működnek
  #### 2.21.1 Patch (nuget):
  #### 2.21.0 Compatible (nuget):
  -StringConstructorban az adatrész kijelölés formátumának módosítása és a feldolgozás ennek megfelelő átalakítása
  #### 2.20.1 Patch (nuget):
  -StringConstructor.ResolveConstructor azonnal visszatér a megadott constructor értékével, ha az null, vagy nincs benne más csak whitespace, vagy ha a helyettesítő szótár üres;
  #### 2.20.0 Patch (nuget):
  - StringConstructor.ResolveConstructor-nak több varname separatort is meg lehet adni; a paraméterben
  a karakterpárok jelentik az alternatívákat, tehát a "{}@@" varnameseparator string a {} és a @@ karakterpárokat jelöli ki szeparátoroknak
  - ezen kívül javításra került egy hiba, ami az azonos bal és jobb zárókarakterekkel rendelkező varnameseparator értékenél hibás működést eredményezett
  #### 2.19.1 Patch (nuget):
  - CommandLine osztályban egy string indexelési hiba javítása
  #### 2.19.0  Compatible change (nuget):
  - XmlEscapes és AsciiControlCharacters string extension osztályok megvalósítása
  #### 2.18.1  Patch (nuget):
  #### 2.18.0  Compatible change (nuget):
  - ReturnInfoJSON struktúra kiegészítése egy "object ReturnData" mezővel.
  #### 2.17.1  Patch (nuget):
  #### 2.17.0  Patch (nuget):
  - A ResolveConstructor metódusok rendberakása; volt benne egy felesleges funkció, amit kitöröltem, emiatt azonban ez a metódus
  nem kompatibilis a 16.xx verziókkal, de a használó program újrafordítás után (mindennemű változtatás nélkül) ismét menni fog.
  Bocs, nem akartam 3-as verzióra térni.
  #### 2.16.2  Patch (nuget):
  #### 2.16.1  Compatible change (nuget):
  - Bekerült egy újabb ResolveConstructor metódus a StringConstructor osztályba
  #### 2.16.0  Compatible change (nuget):
  - Bekerült egy újabb ResolveConstructor metódus a StringConstructor osztályba, ami lehetővé teszi, hogy
  a konstruktor egy adatelem egy részkaraktersorozatának (substring) kiemelését írja elő {DENAME:from,len} formában
  
  #### 2.15.0-2 Compatible change (nuget):
  - Adding extension methods for integral types
  
  #### 2.14.1-3 Compatible change (nuget):
  - StringConstructor osztályban a nevekben lehet . (pont) karaktert használni, hogy megengedje a minősített neveket
  
  #### 2.14.0 Compatible change (nuget):
  - StringConstructor osztály hozzáadása
  

  #### 2.13.2 (2020.03.27) Patches:    
  - NuGet csomag módosítása úgy, hogy a modul ReadMe.md "Build Action" tulajdonsága "None" legyen a telepítés után. Install.ps1 hozzáadása.
  
  #### 2.13.1 (2020.03.26) Patches:    
  - Felesleges függések törlése.
  - XML comment dokumentáció pontosítása.
  
  #### 2.13.0 (2020.03.19) Compatible changes:    
  - Vrh.Web.Common.Lib egyes elemeinek átemelése ide
  
  #### 2.12.1 (2020.02.13) Patches:    
  - SelectListJSON egyenlőség vizsgálat javítása
  
  #### 2.12.0 (2020.02.13) Compatible changes:    
  - SelectListJSON struktúrába beépítésre került egy speciális egyenlőség vizsgálat, amely a Value, a Text és a Group mezők értékének egyenlősége
  esetén ad igaz értéket; a Disabled és a Selected mezők értéke az egyenlőség vizsgálatban nem játszik szerepet
  - CheckListJSON és ReturnInfoJSON strukturákhoz analóg módon, mely ugyanezekkel a feltételekkel dolgozik.
  
  #### 2.11.1-3 (2019.12.19) Compatible changes:    
  - CommandLine class hibák javítása.
  
  #### 2.11.0 (2019.12.17) Compatible changes:    
  - Topshelf formátumú parancssori paraméterek kezelése: -NAME:value
   
  #### 2.10.1 (2019.12.17) Patches:    
  - CommandLine osztályban egy javítás
  
  #### 2.10.1 (2019.12.05) Patches:    
  - SerializeObject metódusban a string-ek külön kezelése.
  
  #### 2.10.0 (2019.10.08) Compatible changes:      
  - ToEnum string extension hozzáadása, amelyik egy stringből megadott tipusú enumra konvertál, vagy a típus (Enum) defaultját adja
  
  #### 2.9.0 (2019.09.12) Compatible changes:      
  - EntryAsseblyFixer static class hozzáadása, ami beállítja  amegfelelő EntryAssembly-t, ha az alakalmazás tér dinamikus hostolású, ahol null, vagy dynamic az EntryAssembly
  - EntryAsseblyFixer egység tesztjei
  
  ## 2.8.1 (2019.09.07):
  ### Patch:
  - Name property típusa javítva.
  
  ## v2.8.0 (2019.09.06):
  ### Compatibility API changes:
  - ReturnDictJSON adatstruktúra hozzáadva.
  
  ## 2.7.0 (2019.08.15) Compatible changes:      
  ### Compatibility API changes:      
  - Az EntityFramework extension bővítése az AlreadyOrdered függvénynel, amely megmondja egy IQueryable-ről, hogy rendezett-e már (tehát a további rendezéséhez az OrderBy, vagy a ThenBy-t kell-e használni)
  
  ## 2.6.0 (2019.08.01) Compatible changes:      
  ### Compatibility API changes:      
  - Extensions bővítése az EntityFramework extension-nel, EntityFrameworkQueryHelper bővítő osztály, SmartOrder bővítő metódus (IQueryable típusra)
  
  ## 2.5.0 (2019.07.10) Compatible changes:      
  ### Compatibility API changes:      
  - ExtensionMethods bővítése az Enum extensionssel, Enumdata attribútum osztály
  
  ## 2.3.0 (2019.05.14) Compatible changes:      
  - IManage interfész áthelyezése Vrh.Web.Common.Lib 1.18.1-es változatából.
  - Standard osztályok (CheckListJSON, ReturnInfoJSON, SelectListJSON) áthelyezése Vrh.Web.Common.Lib 1.18.1-es változatából.
  
  ## 2.2.0 (2018.12.17)
  ### Compatible changes:      
  - VrhConvert.SerializeObject Private metódus publikussá tétele.
  
  ## 2.1.0 (2018.12.17)
  ### Compatible changes:      
  - Új függvények beillesztése a conversion részbe. 
  
  ## 2.0.1 (2018.12.12)
  ### Patches:      
  - ConnandLine osztály metóduasdinak kommentezése és egy apró javítás: a GetCommandLineArgument lekezeli, ha az argumentname paramétere üres string.
  
  ## 2.0.0 (2018.11.28)
  ### Braking change:
  - 3.5-ös .Net framwork verzi támogatásának megszüntetése új target verzió: 4.5
  ### Compatibility API changes:      
  - CommandLine static segéd osztály hozzáadása 
  
  ## 1.13.0 (2017.04.04)
  ### Compatibility API changes:      
  - String Extension method: FromHexOrThis      
  
  ## 1.12.0 (2017.03.29)     
  ### Compatibility API changes:      
  - FixStack class hozzáadása
  ### Patches:
  - UnitTest method elnevezések javítása (konvenció kidolgozása)
  
  ## 1.11.0 (2017.03.28)     
  ### Compatibility API changes:      
  - Assembly Extension methodok: Version, AssemblyAttribute
  
  ## 1.10.0 (2017.03.16)     
  ### Compatibility API changes:      
  - StringBuilder Extension methodok: AppendWithSeparator, Reverse      
  ### Patches:
  - Extension methodok helyének hozzáadása.
  - Test projekt hozzáadása 
  
  ## V1.9.2 (2017.02.21)
  ### Patches:
  - Projekt könyvrtárszerkezet rendbetétele.
  - AutoBuild Vrh Nuget csomaggá alakítás (összes Nuget-tel kapcsolatos elvárás átvezetése)
  - MinFramweork meghatározás