Le mot-clé C# ref est un outil essentiel que chaque débutant devrait apprendre. Il est utilisé pour passer des arguments par référence plutôt que par valeur, permettant aux modifications apportées à la variable du type référence à l'intérieur de la méthode appelée de se refléter à l'extérieur. Dans ce tutoriel, nous expliquerons en détail le mot clé ref et explorerons divers exemples de code console illustrant son fonctionnement.
Lorsque vous passez un paramètre de méthode en C#, par défaut, il est passé par valeur. Cela signifie qu'une copie de la valeur du paramètre est créée, et que toute modification apportée au sein de la méthode appelée n'affectera pas la variable d'origine à l'extérieur de la méthode. Le mot-clé ref change ce comportement, vous permettant de passer un paramètre par référence. Lorsqu'un paramètre est passé par référence, toute modification apportée au sein de la méthode affectera directement la variable d'origine à l'extérieur de la méthode.
ref : Utilisé pour indiquer qu'une variable est passée par référence.ref.Commençons par comprendre le concept de passage de variables par référence. Imaginez que vous avez une méthode qui incrémente un entier comme le montre le code suivant :
class Program
{
// Method increments the given integer by one
static void IncrementByOne(int num)
{
num++;
}
static void Main()
{
int value = 5;
IncrementByOne(value);
Console.WriteLine(value); // Output: 5
}
}Friend Class Program
' Method increments the given integer by one
Private Shared Sub IncrementByOne(ByVal num As Integer)
num += 1
End Sub
Shared Sub Main()
Dim value As Integer = 5
IncrementByOne(value)
Console.WriteLine(value) ' Output: 5
End Sub
End ClassDans le code ci-dessus, même si nous avons incrémenté num dans la méthode IncrementByOne, la value originale reste inchangée. C'est parce que num est une copie de la variable originale, et les modifications apportées ne l'affectent pas.
Voyons maintenant comment le mot-clé ref peut changer ce comportement. En utilisant ref, vous pouvez passer une variable par référence à la méthode comme montré dans un des exemples de code ci-dessous.
class Program
{
// Method increments the given integer by one using ref
static void IncrementByOneRef(ref int num)
{
num++;
}
static void Main()
{
int value = 5;
IncrementByOneRef(ref value);
Console.WriteLine(value); // Output: 6
}
}Friend Class Program
' Method increments the given integer by one using ref
Private Shared Sub IncrementByOneRef(ByRef num As Integer)
num += 1
End Sub
Shared Sub Main()
Dim value As Integer = 5
IncrementByOneRef(value)
Console.WriteLine(value) ' Output: 6
End Sub
End ClassRemarquez le mot-clé ref à la fois dans la signature de la méthode et dans l'appel. Cela indique à C# que vous souhaitez passer la variable value par référence. En conséquence, les changements effectués dans la méthode IncrementByOneRef se reflètent dans la variable value originale.
Le mot-clé ref est particulièrement utile lors de la manipulation de types tels que les entiers, les doubles et les structures. Ces types sont stockés directement en mémoire, et les passer par référence peut conduire à des améliorations de performances et à un contrôle plus précis de la manipulation des données.
Bien que le mot-clé ref soit couramment associé aux types valeur, il peut également être utilisé avec des variables de type référence. Les types de référence, comme les classes et les tableaux, stockent une référence aux données réelles en mémoire plutôt que les données elles-mêmes. Cela signifie que vous traitez avec une structure de type pointeur, et le passage par référence peut donner des résultats différents comme le montre l'exemple suivant :
class Person
{
public string Name { get; set; }
}
class Program
{
// Method changes the reference of the person variable to a new Person object
static void ChangeName(ref Person person)
{
person = new Person { Name = "Alice" };
}
static void Main()
{
Person person = new Person { Name = "Bob" };
ChangeName(ref person);
Console.WriteLine(person.Name); // Output: Alice
}
}Friend Class Person
Public Property Name() As String
End Class
Friend Class Program
' Method changes the reference of the person variable to a new Person object
Private Shared Sub ChangeName(ByRef person As Person)
person = New Person With {.Name = "Alice"}
End Sub
Shared Sub Main()
Dim person As New Person With {.Name = "Bob"}
ChangeName(person)
Console.WriteLine(person.Name) ' Output: Alice
End Sub
End ClassDans cet exemple, la méthode ChangeName modifie la référence de la variable person à un nouvel objet Person. En conséquence, la variable person originale pointe maintenant vers un objet différent, et son nom est " Alice ".
Vous pouvez avoir plusieurs méthodes avec le même nom mais des paramètres différents. Cela s'appelle la surcharge de méthode. Lorsque vous utilisez le mot-clé ref, la surcharge de méthode devient plus puissante.
class Calculator
{
// Method adds two integers and modifies the first using ref
public static void Add(ref int x, int y)
{
x += y;
}
// Method adds two doubles and modifies the first using ref
public static void Add(ref double x, double y)
{
x += y;
}
}
class Program
{
static void Main()
{
int intValue = 5;
double doubleValue = 7.5;
// Call overloaded Add methods with ref parameters
Calculator.Add(ref intValue, 3);
Calculator.Add(ref doubleValue, 2.5);
Console.WriteLine(intValue); // Output: 8
Console.WriteLine(doubleValue); // Output: 10.0
}
}Friend Class Calculator
' Method adds two integers and modifies the first using ref
Public Shared Sub Add(ByRef x As Integer, ByVal y As Integer)
x += y
End Sub
' Method adds two doubles and modifies the first using ref
Public Shared Sub Add(ByRef x As Double, ByVal y As Double)
x += y
End Sub
End Class
Friend Class Program
Shared Sub Main()
Dim intValue As Integer = 5
Dim doubleValue As Double = 7.5
' Call overloaded Add methods with ref parameters
Calculator.Add(intValue, 3)
Calculator.Add(doubleValue, 2.5)
Console.WriteLine(intValue) ' Output: 8
Console.WriteLine(doubleValue) ' Output: 10.0
End Sub
End ClassDans l'exemple ci-dessus, nous surchargeons la méthode Add pour fonctionner avec les types int et double. Le mot-clé ref permet aux méthodes de modifier directement les variables originales.
Un autre mot-clé associé est out. Il est similaire à ref mais a un objectif légèrement différent. Alors que ref exige que la variable soit initialisée avant d'être passée, le mot-clé out s'utilise lorsque vous souhaitez qu'une méthode assigne une valeur à un paramètre qui ne possède pas nécessairement de valeur initiale :
class Program
{
// Method computes the quotient and uses the out keyword to return it
static void Divide(int dividend, int divisor, out int quotient)
{
quotient = dividend / divisor;
}
static void Main()
{
int result;
Divide(10, 2, out result);
Console.WriteLine(result); // Output: 5
}
}Friend Class Program
' Method computes the quotient and uses the out keyword to return it
Private Shared Sub Divide(ByVal dividend As Integer, ByVal divisor As Integer, ByRef quotient As Integer)
quotient = dividend \ divisor
End Sub
Shared Sub Main()
Dim result As Integer = Nothing
Divide(10, 2, result)
Console.WriteLine(result) ' Output: 5
End Sub
End ClassDans cet exemple, la méthode Divide calcule le quotient et l'assigne à la variable quotient en utilisant le mot-clé out. Il est à noter que vous n'avez pas besoin d'initialiser result avant de le passer à la méthode.
Le mot-clé out est similaire au mot-clé ref mais diffère significativement. Un paramètre out n'a pas besoin d'une valeur initiale, tandis qu'un paramètre ref doit avoir une valeur initiale avant l'appel de la méthode.
Bien que les mots-clés ref et out puissent être des outils puissants, ils doivent être utilisés judicieusement. L'utilisation incorrecte de ces mots clés peut conduire à un code confus et à un comportement inattendu. Par exemple, vous ne pouvez pas utiliser une variable non-ref dans un paramètre ref ou out sans l'avoir initialisée d'abord, car cela entraînerait une erreur de compilation.
Comprendre la différence entre les types de référence et les types valeur est crucial lors de l'utilisation du mot-clé ref.
Utiliser ref avec des types valeur permet que les changements soient reflétés en dehors de la méthode, tandis que les variables de type référence se comportent intrinsèquement de cette manière.
Vous pouvez également utiliser le mot-clé ref avec des méthodes d'extension. Un exemple :
public static class StringExtensions
{
// Extension method that appends a value to the input string
public static void AppendValue(ref this string input, string value)
{
input += value;
}
}Public Module StringExtensions
' Extension method that appends a value to the input string
Public Sub AppendValue(ByRef Me input As String, ByVal value As String)
input &= value
End Sub
End ModuleSi vous oubliez d'inclure le mot-clé ref dans la signature de la méthode ou dans l'appel de méthode, cela entraînera une erreur du compilateur au moment de la compilation.
Async et paramètres refNotez que vous ne pouvez pas utiliser les paramètres ref avec des méthodes d'itérateur ou des méthodes async, car celles-ci nécessitent de passer le paramètre par valeur.
En plus de comprendre des concepts clés tels que le mot-clé ref en C#, il existe un ensemble d'outils puissants qui peuvent rendre la vie d'un développeur beaucoup plus facile. L'Iron Suite est une collection d'outils et de bibliothèques robustes qui incluent IronPDF, IronXL, IronOCR, et IronBarcode. Explorons ces outils et voyons comment ils peuvent améliorer votre expérience de codage sans aucun argument.
Découvrez IronPDF comme une partie essentielle de l'Iron Suite. C'est une bibliothèque qui permet aux développeurs de créer, lire, et éditer des fichiers PDF en C#. Si vous voulez convertir HTML en PDF, IronPDF a les outils dont vous avez besoin. Consultez le tutoriel sur la conversion HTML en PDF pour en savoir plus sur cette fonction.
Travailler avec des fichiers Excel en C# peut être difficile, mais les fonctionnalités d'IronXL simplifient cette tâche. Il vous permet de lire, écrire, éditer et manipuler des fichiers Excel sans avoir Excel installé. De l'importation de données à la création de nouveaux tableaux, IronXL facilite la gestion d'Excel en C#.
La reconnaissance optique de caractères (OCR) peut être complexe, mais découvrez IronOCR pour simplifier le processus. Avec cette bibliothèque, vous pouvez lire du texte à partir d'images et le convertir en texte lisible par machine. Que vous ayez besoin d'extraire du texte d'un document scanné ou de reconnaître des caractères à partir d'une image, IronOCR dispose de la fonctionnalité pour vous aider.
Les codes-barres sont couramment utilisés dans diverses industries, et les manipuler dans vos applications est désormais plus accessible avec la bibliothèque IronBarcode. Cette bibliothèque vous permet de créer, lire, et travailler avec des codes-barres en C#. IronBarcode prend en charge une large gamme de formats de codes QR et de codes-barres.
Vous pourriez vous demander comment ces outils se rapportent au mot-clé ref que nous avons discuté. Lorsque vous travaillez sur des projets complexes impliquant PDF, Excel, OCR ou codes-barres, utiliser efficacement le mot-clé ref et d'autres principes C# sera crucial pour gérer votre code efficacement.
Par exemple, lorsque vous manipulez de grands fichiers Excel avec IronXL, passer des objets par référence en utilisant le mot-clé ref peut rendre votre code plus efficace et plus maintenable. De même, travailler avec des documents PDF en utilisant IronPDF pourrait impliquer des méthodes où le mot-clé ref peut jouer un rôle.
Comprendre les fonctionnalités principales du langage comme le mot-clé ref et avoir accès à des outils comme l'Iron Suite vous équipe d'une combinaison puissante pour créer des applications efficaces, robustes et polyvalentes. L'Iron Suite est conçue pour fonctionner parfaitement avec votre connaissance existante de C#, et ensemble, ils peuvent vous aider à créer des solutions plus professionnelles et sophistiquées.
Le langage C#, avec des fonctionnalités comme le mot-clé ref, offre des capacités puissantes pour les développeurs. Combiné avec l'Iron Suite, incluant IronPDF, IronXL, IronOCR et IronBarcode, les possibilités deviennent encore plus vastes.
Chaque produit de l'Iron Suite propose un essai gratuit, vous permettant d'explorer et d'utiliser les fonctionnalités étendues sans aucun investissement immédiat. Si vous décidez de procéder avec une licence complète, le tarif commence à partir de $999 pour les composants individuels.
Si vous trouvez que l'ensemble de l'Iron Suite convient à vos besoins, une excellente offre vous attend. Vous pouvez acquérir l'ensemble complet pour le prix de seulement deux composants individuels.
Jacob Mellor est directeur de la technologie chez Iron Software et un ingénieur visionnaire pionnier de la technologie C# PDF. En tant que développeur à l'origine de la base de code centrale d'Iron Software, il a façonné l'architecture des produits de l'entreprise depuis sa création, la transformant aux côtés du PDG Cameron Rimington en une entreprise de plus de 50 personnes au service de la NASA, de Tesla et d'agences gouvernementales mondiales.
IronPDF fait partie de IRONSUITE
10 API .NET pour vos documents
Lorsque vous avez besoin que votre PDF ressemble à HTML, rapidement.
