Sitecore a une classe d’assistance relativement inconnue qui contient de nombreuses fonctions intéressantes très utiles pour les développeurs. Dans cette série d’articles, je vais lister les fonctions présentes dans la classe Sitecore.Mainutils de Sitecore 10.
Ces fonctions seront plus tard déplacées vers les classes StringUtil et FileUtil.
Les autres classes d’assistance sont:
- Sitecore.StringUtil
- Sitecore.IO.FileUtil
- Sitecore.DateUtil
- Sitecore.Web.HtmlUtil
- Sitecore.Web.WebUtil
- Sitecore.Xml.XmlUtil
WorkingSetSize
Obtient la taille de l’ensemble de travail (working set)
Paramètres: aucun
Résultat: La taille de l’ensemble de travail
Exemple:
long setSize = Sitecore.MainUtil.WorkingSetSize
AddArrays
Concatène deux tableaux en effectuant un casting explicite
Paramètres:
- Array1: Le premier tableau
- Array2: Le second tableau
- elementType: Le type des éléments
Résultat: Le tableau résultant de la concaténation
Exemple:
string[] array1 = "hello world".Split(' ');
string[] array2 = "Je suis sitecore".Split(' ');
Array result = Sitecore.MainUtil.AddArrays(array1, array2, typeof(string));AppendMissingIDBrace
Ajoute une accolade fermante manquante “}” si le paramètre commence par une accolade “{“
Paramètres:
- sPath: Une suite de charactères
Résultat: Le paramètre entrant, fermé par une accolade fermante si besoin est
Cette fonction est généralement appelée pour garantir qu’un GUID se termine par une accolade fermante “}”. Cela peut se produire si une page Web est ouverte à partir d’Outlook par un lien collé car Outlook n’inclut pas automatiquement l’accolade de fin “}”
Exemple
string path = StringUtil.GetString(Request.QueryString["path"]);
string id = MainUtil.AppendMissingIDBrace(path);BoolToString
Convertit une valeur booléenne à “true” ou “false”.
Paramètres:
- b: Une valeur booléenne
Résultat: Si le paramètre entrant est true, le résultat sera “true”, sinon “false”
Exemple
string trueString = MainUtil.BoolToString(1 = 1); // "true"
string falseString = MainUtil.BoolToString(1 = 0); // "false"BuildHashtable
Construit facilement la table de hachage à partir d’un ensemble d’objets
Paramètres:
- objects: Une table d’objets pour construire la table de hachage
Résultat: Une table de hashage
Exemple
Hashtable table = Sitecore.MainUtil.BuildHashtable(new object[] {1, 3, "jj"});Cast
Convertit l’objet spécifié en un autre type
Paramètres:
- Typeparam T: Le type du résultat après conversion.
- obj: L’objet
- type: Le type
Résultat: L’objet convertit
Le paramètre “type” n’est pas utilisé dans l’implémentation
Exemple
string one = Sitecore.MainUtil.Cast<string>(1, "string");ClearBit
Réinitialise un bit dans un nombre
Paramètres:
- bit: Le bit
- bits: Les bits
Résultat: bits & ~bit;
ColorToString
Convertit une couleur en une chaine de charactères
Paramètres:
- color: la couleur
Résultat: Le nom de la couleur. si possible, sinon une chaine de charactères RGB
Exemple
string color = MainUtil.ColorToString(Color.Aqua)CombineArrays
Ajoute une valeur à un tableau
Paramètres:
- Typeparam: Le type du tableau
- values: Les valeurs du tableau
- value: La valeur a ajouter au tableau
Résultat: Le nouveau tableau
CombineArrays
Contacatène deux tableaux.
Paramètres:
- Typeparam: Le type des tableaux
- values1: Le premier tableau de valeurs
- values2: Le second tableau de valeurs
Résultat: Le nouveau tableau
CompactArray
Enlève les valeurs nulles dans un tableau.
Paramètres:
- array: Un tableau d’objets
- elementtype: le type des éléments du tableau
Résultat: Le nouveau tableau
CompactArray
Enlève les valeurs nulles dans un tableau de strings.
Paramètres:
- array: Un tableau de strings
Résultat: Le nouveau tableau
Exemple
string[] texts = new string[] {"My", "", "Text, ""};
string[] compact = MainUtil.CompactArray(texts): // { "My", "Text" }ContainsUnicodeCharacters
Détermine si la chaîne spécifiée contient des caractères Unicode.
Paramètres:
- str: La chaine de catactères
Résultat: true si la chaîne spécifiée contient des caractères Unicode; sinon, false
jesuissitecore.com 