Test dans un environnement réel
Test en production sans filigrane.
Fonctionne partout où vous en avez besoin.
C# est un langage polyvalent et puissant qui offre de nombreuses fonctionnalités. Parmi eux, le 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.
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.
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 :
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.
TryGetValue
en actionPour 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.
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 est une bibliothèque C# conçue pour cré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 son HTML 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 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 est un OCR avancé (Reconnaissance optique de caractères) & Bibliothèque de lecture de codes-barres 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 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.
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'application Iron Suite a une solution adaptée à vos besoins.
Ce qui est encore plus intéressant, c'est que chacun de ces produits offre une essai gratuitvous 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.
9 produits de l'API .NET pour vos documents de bureau