La classe Sitecore.MainUtils – Partie 1

This article in english

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

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: