Partager via


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é

System.Byte

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

Mots clés C#

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#)

Byte

Concepts

Guide de programmation C#

Autres ressources

Référence C#