byte (référence C#)
Le mot clé byte désigne un type intégral qui stocke des valeurs comme indiqué dans le tableau suivant.
Type |
Plage |
Taille |
Type .NET Framework |
|---|---|---|---|
byte |
0 à 255 |
Entier 8 bits non signé |
Littéraux
Vous pouvez déclarer et initialiser une variable byte en suivant l'exemple ci-après :
byte myByte = 255;
Dans la déclaration précédente, le littéral entier 255 est implicitement converti de type int en type byte. Si le littéral entier est en dehors de la plage de valeurs autorisées pour byte, une erreur de compilation se produit.
Conversions
Il y a une conversion implicite prédéfinie de byte en short, ushort, int, uint, long, ulong, float, double ou decimal.
Vous ne pouvez pas convertir implicitement les types numériques non littéraux de taille de stockage plus importante en byte. Pour plus d'informations sur les tailles de stockage des types intégraux, consultez Tableau des types intégraux (référence C#). Prenez l'exemple suivant de deux variables byte, x et y :
byte x = 10, y = 20;
L'instruction d'assignation suivante entraîne une erreur de compilation, car l'expression arithmétique située à droite de l'opérateur d'assignation correspond à int par défaut.
// Error: conversion from int to byte:
byte z = x + y;
Pour résoudre ce problème, utilisez une conversion explicite :
// OK: explicit conversion:
byte z = (byte)(x + y);
Il est cependant possible d'utiliser les instructions suivantes dans lesquelles la variable de destination possède une taille de stockage égale ou supérieure :
int x = 10, y = 20;
int m = x + y;
long n = x + y;
En outre, il n'y a pas de conversion implicite des types virgule flottante en type byte. Par exemple, l'instruction suivante génère une erreur de compilation si aucune conversion explicite n'est spécifiée :
// Error: no implicit conversion from double:
byte x = 3.0;
// OK: explicit conversion:
byte y = (byte)3.0;
Une conversion explicite doit être utilisée lors de l'appel de méthodes surchargées. Prenez l'exemple suivant de deux méthodes surchargées ayant pour paramètres byte et int :
public static void SampleMethod(int i) {}
public static void SampleMethod(byte b) {}
Le recours à un cast byte permet de garantir que le type correct sera appelé, comme indiqué ci-après :
// Calling the method with the int parameter:
SampleMethod(5);
// Calling the method with the byte parameter:
SampleMethod((byte)5);
Pour plus d'informations sur les expressions arithmétiques dans lesquelles coexistent des types virgule flottante et des types intégraux, consultez float et double.
Pour plus d'informations sur les règles de conversion numérique implicite, consultez Tableau des conversions numériques implicites (référence C#).
Spécification du langage C#
Pour plus d'informations, consultez la Spécification du langage C#. La spécification du langage est la source de référence pour la syntaxe C# et son utilisation.
Voir aussi
Référence
Tableau des types intégraux (référence C#)
Tableau des types intégrés (référence C#)
Tableau des conversions numériques implicites (référence C#)
Tableau des conversions numériques explicites (référence C#)