C# Dictionnaire Trygetvalue (Comment ça marche pour les développeurs)

C# est un langage polyvalent et puissant qui offre de nombreuses fonctionnalités. Parmi eux, le dictionnaire C#.

Comprendre les bases du dictionnaire C

Avant de plonger dans la méthode TryGetValue, il est essentiel de comprendre ce qu'est un dictionnaire en C#. En termes simples, un dictionnaire est une collection de paires clé/valeur. Par exemple, vous pouvez avoir un dictionnaire dont les clés sont les noms des élèves(valeurs des chaînes de caractères)et les valeurs sont les âges correspondants(valeurs entières).

    Dictionary<string, int> studentAges = new Dictionary<string, int>
    {
        {"Alice", 20},
        {"Bob", 22},
        {"Charlie", 19}
    };

    Dictionary<string, int> studentAges = new Dictionary<string, int>
    {
        {"Alice", 20},
        {"Bob", 22},
        {"Charlie", 19}
    };

Dim studentAges As New Dictionary(Of String, Integer) From {
	{"Alice", 20},
	{"Bob", 22},
	{"Charlie", 19}
}

Les clés d'un dictionnaire sont uniques. Vous pouvez accéder aux clés pour récupérer la valeur correspondante, ce qui rend les dictionnaires incroyablement efficaces pour les fonctions de recherche.

L'approche conventionnelle : la méthode ContainsKey

Lorsque l'on travaille avec des dictionnaires C#, une tâche courante consiste à récupérer une valeur associée à une clé particulière. Cependant, l'accès direct à une clé qui n'existe pas peut provoquer une exception KeyNotFoundException, ce qui interrompt le déroulement de votre programme. Pour éviter cela, il est courant de vérifier si la clé spécifiée existe dans le dictionnaire. C'est là que la méthode ContainsKey entre en jeu.

La méthode ContainsKey est une fonction simple et intuitive qui vérifie si une certaine clé est présente dans le dictionnaire. Voici la syntaxe de base de la méthode ContainsKey :

Dictionary<TKey, TValue>.ContainsKey(TKey key)

Dictionary<TKey, TValue>.ContainsKey(TKey key)

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Dictionary<TKey, TValue>.ContainsKey(TKey key)

Elle prend la clé en paramètre et renvoie une valeur booléenne. Si la clé est dans le dictionnaire, elle renvoie vrai ; si ce n'est pas le cas, il renvoie false.

Prenons l'exemple suivant : nous avons un dictionnaire dont les clés sont les noms des étudiants et les valeurs les âges correspondants.

Dictionary<string, int> studentAges = new Dictionary<string, int>
{
    {"Alice", 20},
    {"Bob", 22},
    {"Charlie", 19}
};

Dictionary<string, int> studentAges = new Dictionary<string, int>
{
    {"Alice", 20},
    {"Bob", 22},
    {"Charlie", 19}
};

Dim studentAges As New Dictionary(Of String, Integer) From {
	{"Alice", 20},
	{"Bob", 22},
	{"Charlie", 19}
}

Maintenant, si vous voulez obtenir l'âge d'une étudiante nommée "Alice", vous devez d'abord utiliser la méthode ContainsKey pour vérifier si "Alice" est une clé du dictionnaire.

string student = "Alice";
if(studentAges.ContainsKey(student))
{
    int age = studentAges [student];
    Console.WriteLine($"{student} is {age} years old.");
}
else
{
    Console.WriteLine($"{student} does not exist in the dictionary.");
}

string student = "Alice";
if(studentAges.ContainsKey(student))
{
    int age = studentAges [student];
    Console.WriteLine($"{student} is {age} years old.");
}
else
{
    Console.WriteLine($"{student} does not exist in the dictionary.");
}

Dim student As String = "Alice"
If studentAges.ContainsKey(student) Then
	Dim age As Integer = studentAges (student)
	Console.WriteLine($"{student} is {age} years old.")
Else
	Console.WriteLine($"{student} does not exist in the dictionary.")
End If

Dans ce cas, le programme affichera "Alice a 20 ans" Si vous essayez d'obtenir l'âge d'un étudiant qui n'est pas présent dans le dictionnaire, la méthode ContainsKey empêchera la génération d'une exception KeyNotFoundException et affichera à la place un message indiquant que l'étudiant n'existe pas.

Cependant, si la méthode ContainsKey peut être utile, elle n'est pas toujours la plus efficace. Dans l'extrait de code ci-dessus, deux opérations de recherche sont effectuées sur le dictionnaire : une pour la méthode ContainsKey et une pour récupérer la valeur. Cette opération peut prendre beaucoup de temps, en particulier lorsqu'il s'agit de dictionnaires volumineux.

Bien que la méthode ContainsKey soit un moyen simple et intuitif de gérer les exceptions lorsqu'une clé spécifiée n'est pas trouvée dans un dictionnaire, il est intéressant de considérer des méthodes alternatives comme TryGetValue, qui peuvent atteindre des fonctionnalités similaires avec de meilleures performances. Nous discuterons de TryGetValue plus en détail dans les sections suivantes.

Combiner la vérification et la récupération avec TryGetValue (essayer la valeur)

C'est là que la méthode TryGetValue est utile. La méthode TryGetValue combine la vérification et la récupération de la valeur en une seule étape, offrant une fonctionnalité de code presque identique mais avec des performances améliorées.

La méthode TryGetValue requiert deux paramètres :

1. La clé que vous recherchez.

2. Un paramètre out qui contiendra la valeur si la clé existe.

   Voici la syntaxe :

Dictionary<TKey, TValue>.TryGetValue(TKey key, out TValue value)

Dictionary<TKey, TValue>.TryGetValue(TKey key, out TValue value)

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Dictionary<TKey, TValue>.TryGetValue(TKey key, out TValue value)

Le mot-clé out est utilisé pour signifier que cette méthode va changer le paramètre value. La valeur out sera la valeur par défaut du type de valeur si la clé spécifiée n'est pas trouvée(0 pour les entiers, null pour les types de référence). Dans le cas contraire, il contiendra la valeur correspondant à la clé fournie.

Voici comment utiliser TryGetValue :

string student = "Alice";
if(studentAges.TryGetValue(student, out int age))
{
    Console.WriteLine($"{student} is {age} years old.");
}
else
{
    Console.WriteLine($"{student} does not exist in the dictionary.");
}

string student = "Alice";
if(studentAges.TryGetValue(student, out int age))
{
    Console.WriteLine($"{student} is {age} years old.");
}
else
{
    Console.WriteLine($"{student} does not exist in the dictionary.");
}

Dim student As String = "Alice"
Dim age As Integer
If studentAges.TryGetValue(student, age) Then
	Console.WriteLine($"{student} is {age} years old.")
Else
	Console.WriteLine($"{student} does not exist in the dictionary.")
End If

Ce code fournit une fonctionnalité presque identique à l'exemple de la méthode ContainsKey, mais il est plus efficace car il ne recherche la clé qu'une seule fois.

exemple de code de TryGetValue en action

Pour mieux comprendre la méthode TryGetValue, examinons un exemple de code pratique. Prenons l'exemple d'une base de données scolaire dans laquelle chaque élève possède un identifiant unique et un nom correspondant. Ces données sont stockées dans un dictionnaire dont la clé est l'identifiant de l'étudiant et la valeur le nom.

Dictionary<int, string> studentNames = new Dictionary<int, string>
{
    {1, "Alice"},
    {2, "Bob"},
    {3, "Charlie"}
};

Dictionary<int, string> studentNames = new Dictionary<int, string>
{
    {1, "Alice"},
    {2, "Bob"},
    {3, "Charlie"}
};

Dim studentNames As New Dictionary(Of Integer, String) From {
	{1, "Alice"},
	{2, "Bob"},
	{3, "Charlie"}
}

Dans ce cas, disons que vous voulez extraire le nom de l'élève portant l'ID 2, mais que vous voulez aussi vous assurer que l'élève portant cet ID existe dans la base de données.

Traditionnellement, on utilise d'abord la méthode ContainsKey pour vérifier si la clé(iD de l'étudiant 2) existe et accède ensuite au dictionnaire pour obtenir la valeur correspondante(nom de l'étudiant). Cependant, avec la méthode TryGetValue, vous pouvez accomplir cela en une seule étape.

La méthode TryGetValue prend deux arguments : la clé que vous recherchez et un paramètre out qui contiendra la valeur associée à cette clé si elle existe. Si la clé est trouvée, la méthode renvoie vrai et affecte la valeur correspondante au paramètre out. Si ce n'est pas le cas, il retournera false, et le paramètre out prendra la valeur par défaut de son type.

int i = 2; // Student ID
if (studentNames.TryGetValue(i, out string value))
{
    Console.WriteLine($"The name of the student with ID {i} is {value}.");
}
else
{
    Console.WriteLine($"No student with ID {i} exists in the dictionary.");
}

int i = 2; // Student ID
if (studentNames.TryGetValue(i, out string value))
{
    Console.WriteLine($"The name of the student with ID {i} is {value}.");
}
else
{
    Console.WriteLine($"No student with ID {i} exists in the dictionary.");
}

Dim i As Integer = 2 ' Student ID
Dim value As String
If studentNames.TryGetValue(i, value) Then
	Console.WriteLine($"The name of the student with ID {i} is {value}.")
Else
	Console.WriteLine($"No student with ID {i} exists in the dictionary.")
End If

Dans ce cas, la méthode TryGetValue recherche la clé 2 dans le dictionnaire studentNames. S'il trouve la clé, il attribue la valeur correspondante à la variable valeur(le nom de l'élève)et la méthode renvoie vrai. Le programme imprime ensuite "Le nom de l'élève ayant l'ID 2 est Bob"

Si la méthode TryGetValue ne trouve pas la clé 2, elle lui attribue la valeur par défaut d'une chaîne de caractères(qui est nulle) à la variable valeur, et la méthode retournera false. Le code passe ensuite au bloc else, imprimant "Aucun élève avec l'ID 2 n'existe dans le dictionnaire"

TryGetValue rationalise votre code en combinant la vérification de l'existence de la clé et la récupération de la valeur en une seule étape. De plus, il permet d'améliorer les performances, en particulier avec les dictionnaires de grande taille, en éliminant le besoin de multiples opérations de recherche de clés.

Présentation d'Iron Suite

Au fur et à mesure que vous progressez dans votre parcours en C#, vous trouverez de nombreux outils et bibliothèques à votre disposition qui peuvent améliorer de manière significative vos capacités de programmation. Parmi celles-ci figurent les bibliothèques Iron, une suite d'outils spécialement conçus pour étendre les fonctionnalités des applications C#. Il s'agit d'IronPDF, IronXL, IronOCR et IronBarcode. Chacune de ces bibliothèques possède un ensemble unique de fonctionnalités, et elles offrent toutes des avantages significatifs lorsqu'elles sont utilisées en conjonction avec le C# standard.

IronPDF

Découvrez IronPDF for .NET pour la création de PDF est une bibliothèque C# conçue pourcréer des fichiers PDF à partir de HTML, de modifier et d'extraire le contenu des PDF dans les applications .NET. Avec IronPDF, vous pouvez générer par programme des rapports PDF, remplir des formulaires PDF et manipuler des documents PDF. La bibliothèque propose également des fonctions de conversion de HTML en PDF, ce qui permet de convertir facilement des contenus HTML existants en PDF.

Le point fort d'IronPDF est sonHTML vers PDF qui conserve toutes les mises en page et tous les styles intacts. Il vous permet de créer des PDF à partir de contenus web, adaptés aux rapports, aux factures et à la documentation. Les fichiers HTML, les URL et les chaînes HTML peuvent être convertis en PDF de manière transparente.

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main(ByVal args() As String)
		Dim renderer = New ChromePdfRenderer()

		' 1. Convert HTML String to PDF
		Dim htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>"
		Dim pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent)
		pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf")

		' 2. Convert HTML File to PDF
		Dim htmlFilePath = "path_to_your_html_file.html" ' Specify the path to your HTML file
		Dim pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath)
		pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf")

		' 3. Convert URL to PDF
		Dim url = "http://ironpdf.com" ' Specify the URL
		Dim pdfFromUrl = renderer.RenderUrlAsPdf(url)
		pdfFromUrl.SaveAs("URLToPDF.pdf")
	End Sub
End Class

Dans le contexte de notre sujet, imaginez un scénario dans lequel vous récupérez des données sur les élèves à partir d'un dictionnaire et souhaitez générer un rapport PDF. TryGetValue pourrait récupérer efficacement les données nécessaires, puis s'appuyer sur IronPDF pour créer le document PDF.

IronXL

Découvrez IronXL.Excel pour les interactions avec Excel est une bibliothèque Excel pour C# et .NET. Il permet aux développeurs de lire, écrire et créer des fichiers Excel dans des applications .NET sans interopérabilité. Il est parfait pour les scénarios dans lesquels vous devez exporter ou importer des données à partir d'une feuille de calcul Excel.

A propos de TryGetValue, supposons que vous ayez un Dictionnaire dont les clés représentent les ID des produits et les valeurs leurs quantités. Vous pourriez utiliser TryGetValue pour récupérer la quantité d'un produit spécifique et utiliser ensuite IronXL pour mettre à jour cette quantité dans une feuille de calcul Excel de gestion des stocks.

IronOCR

Libérez la puissance d'IronOCR pour la reconnaissance de texte est un OCR avancé(Reconnaissance optique de caractères) et la bibliothèque de lecture de BarCode pour .NET et C#. Il permet aux développeurs de lire du texte et des codes-barres à partir d'images et de PDF dans des applications .NET. Cela peut s'avérer particulièrement utile lorsque vous devez extraire des données de documents ou d'images numérisés et les utiliser dans votre code.

Prenons l'exemple d'un scénario dans lequel vous avez utilisé IronOCR pour extraire les identifiants des étudiants à partir de documents numérisés. Après le traitement, vous stockez les identifiants et les informations correspondantes sur les étudiants dans un dictionnaire. Lors de la récupération des détails d'un étudiant particulier, TryGetValue pourrait être utilisé pour récupérer les données du dictionnaire de manière efficace.

IronBarcode

En savoir plus sur IronBarcode pour les solutions de codes-barres est une bibliothèque de lecture et d'écriture de codes-barres pour .NET. Avec IronBarcode, les développeurs peuvent générer et lire divers formats de codes-barres et de codes QR. C'est un outil puissant pour coder et décoder des données dans un format compact et lisible par une machine.

En pratique, imaginez que vous utilisiez des codes-barres pour stocker des informations sur les produits dans un système de vente au détail. Chaque code-barres pourrait correspondre à un numéro d'identification unique du produit, stocké sous forme de clé dans un dictionnaire. Lorsqu'un code-barres est scanné, vous pouvez utiliser TryGetValue pour récupérer et afficher rapidement les détails du produit associé dans le dictionnaire.

Conclusion

Après avoir exploré les fonctionnalités des bibliothèques Iron en conjonction avec des fonctions C# standard telles que la méthode TryGetValue, il est clair que ces outils peuvent améliorer de manière significative votre processus de développement. Que vous travailliez avec des PDF, des fichiers Excel, de l'OCR ou des codes-barres, l'applicationIron Suite a une solution adaptée à vos besoins.

Ce qui est encore plus intéressant, c'est que chacun de ces produits offre uneessai gratuit des produits Iron Softwarevous permettant d'explorer et d'expérimenter les fonctionnalités gratuitement. Si vous décidez de continuer à utiliser les bibliothèques, la licence commence à partir de $749 pour chaque produit. Toutefois, si vous êtes intéressé par plusieurs bibliothèques Iron, vous pouvez acheter la suite complète Iron Suite au prix de deux produits individuels seulement.