Byte Structure

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Représente un entier non signé 8 bits.

public value class System::Byte : IComparable<System::Byte>, IConvertible, IEquatable<System::Byte>, IParsable<System::Byte>, ISpanParsable<System::Byte>, IUtf8SpanParsable<System::Byte>, System::Numerics::IAdditionOperators<System::Byte, System::Byte, System::Byte>, System::Numerics::IAdditiveIdentity<System::Byte, System::Byte>, System::Numerics::IBinaryInteger<System::Byte>, System::Numerics::IBinaryNumber<System::Byte>, System::Numerics::IBitwiseOperators<System::Byte, System::Byte, System::Byte>, System::Numerics::IComparisonOperators<System::Byte, System::Byte, bool>, System::Numerics::IDecrementOperators<System::Byte>, System::Numerics::IDivisionOperators<System::Byte, System::Byte, System::Byte>, System::Numerics::IEqualityOperators<System::Byte, System::Byte, bool>, System::Numerics::IIncrementOperators<System::Byte>, System::Numerics::IMinMaxValue<System::Byte>, System::Numerics::IModulusOperators<System::Byte, System::Byte, System::Byte>, System::Numerics::IMultiplicativeIdentity<System::Byte, System::Byte>, System::Numerics::IMultiplyOperators<System::Byte, System::Byte, System::Byte>, System::Numerics::INumber<System::Byte>, System::Numerics::INumberBase<System::Byte>, System::Numerics::IShiftOperators<System::Byte, int, System::Byte>, System::Numerics::ISubtractionOperators<System::Byte, System::Byte, System::Byte>, System::Numerics::IUnaryNegationOperators<System::Byte, System::Byte>, System::Numerics::IUnaryPlusOperators<System::Byte, System::Byte>, System::Numerics::IUnsignedNumber<System::Byte>

public readonly struct Byte : IComparable<byte>, IConvertible, IEquatable<byte>, IParsable<byte>, ISpanParsable<byte>, IUtf8SpanParsable<byte>, System.Numerics.IAdditionOperators<byte,byte,byte>, System.Numerics.IAdditiveIdentity<byte,byte>, System.Numerics.IBinaryInteger<byte>, System.Numerics.IBinaryNumber<byte>, System.Numerics.IBitwiseOperators<byte,byte,byte>, System.Numerics.IComparisonOperators<byte,byte,bool>, System.Numerics.IDecrementOperators<byte>, System.Numerics.IDivisionOperators<byte,byte,byte>, System.Numerics.IEqualityOperators<byte,byte,bool>, System.Numerics.IIncrementOperators<byte>, System.Numerics.IMinMaxValue<byte>, System.Numerics.IModulusOperators<byte,byte,byte>, System.Numerics.IMultiplicativeIdentity<byte,byte>, System.Numerics.IMultiplyOperators<byte,byte,byte>, System.Numerics.INumber<byte>, System.Numerics.INumberBase<byte>, System.Numerics.IShiftOperators<byte,int,byte>, System.Numerics.ISubtractionOperators<byte,byte,byte>, System.Numerics.IUnaryNegationOperators<byte,byte>, System.Numerics.IUnaryPlusOperators<byte,byte>, System.Numerics.IUnsignedNumber<byte>

type byte = struct
    interface IConvertible
    interface IFormattable
    interface IParsable<byte>
    interface ISpanFormattable
    interface ISpanParsable<byte>
    interface IAdditionOperators<byte, byte, byte>
    interface IAdditiveIdentity<byte, byte>
    interface IBinaryInteger<byte>
    interface IBinaryNumber<byte>
    interface IBitwiseOperators<byte, byte, byte>
    interface IComparisonOperators<byte, byte, bool>
    interface IEqualityOperators<byte, byte, bool>
    interface IDecrementOperators<byte>
    interface IDivisionOperators<byte, byte, byte>
    interface IIncrementOperators<byte>
    interface IModulusOperators<byte, byte, byte>
    interface IMultiplicativeIdentity<byte, byte>
    interface IMultiplyOperators<byte, byte, byte>
    interface INumber<byte>
    interface INumberBase<byte>
    interface ISubtractionOperators<byte, byte, byte>
    interface IUnaryNegationOperators<byte, byte>
    interface IUnaryPlusOperators<byte, byte>
    interface IUtf8SpanFormattable
    interface IUtf8SpanParsable<byte>
    interface IShiftOperators<byte, int, byte>
    interface IMinMaxValue<byte>
    interface IUnsignedNumber<byte>

Public Structure Byte
Implements IAdditionOperators(Of Byte, Byte, Byte), IAdditiveIdentity(Of Byte, Byte), IBinaryInteger(Of Byte), IBinaryNumber(Of Byte), IBitwiseOperators(Of Byte, Byte, Byte), IComparable(Of Byte), IComparisonOperators(Of Byte, Byte, Boolean), IConvertible, IDecrementOperators(Of Byte), IDivisionOperators(Of Byte, Byte, Byte), IEqualityOperators(Of Byte, Byte, Boolean), IEquatable(Of Byte), IIncrementOperators(Of Byte), IMinMaxValue(Of Byte), IModulusOperators(Of Byte, Byte, Byte), IMultiplicativeIdentity(Of Byte, Byte), IMultiplyOperators(Of Byte, Byte, Byte), INumber(Of Byte), INumberBase(Of Byte), IParsable(Of Byte), IShiftOperators(Of Byte, Integer, Byte), ISpanParsable(Of Byte), ISubtractionOperators(Of Byte, Byte, Byte), IUnaryNegationOperators(Of Byte, Byte), IUnaryPlusOperators(Of Byte, Byte), IUnsignedNumber(Of Byte), IUtf8SpanParsable(Of Byte)

Héritage

Object

ValueType

Byte

Implémente

IComparable IComparable<Byte> IConvertible IEquatable<Byte> IFormattable ISpanFormattable IComparable<TSelf> IEquatable<TSelf> IParsable<Byte> IParsable<TSelf> ISpanParsable<Byte> ISpanParsable<TSelf> IAdditionOperators<Byte,Byte,Byte> IAdditionOperators<TSelf,TSelf,TSelf> IAdditiveIdentity<Byte,Byte> IAdditiveIdentity<TSelf,TSelf> IBinaryInteger<Byte> IBinaryNumber<Byte> IBinaryNumber<TSelf> IBitwiseOperators<Byte,Byte,Byte> IBitwiseOperators<TSelf,TSelf,TSelf> IComparisonOperators<Byte,Byte,Boolean> IComparisonOperators<TSelf,TSelf,Boolean> IDecrementOperators<Byte> IDecrementOperators<TSelf> IDivisionOperators<Byte,Byte,Byte> IDivisionOperators<TSelf,TSelf,TSelf> IEqualityOperators<Byte,Byte,Boolean> IEqualityOperators<TSelf,TOther,TResult> IEqualityOperators<TSelf,TSelf,Boolean> IIncrementOperators<Byte> IIncrementOperators<TSelf> IMinMaxValue<Byte> IModulusOperators<Byte,Byte,Byte> IModulusOperators<TSelf,TSelf,TSelf> IMultiplicativeIdentity<Byte,Byte> IMultiplicativeIdentity<TSelf,TSelf> IMultiplyOperators<Byte,Byte,Byte> IMultiplyOperators<TSelf,TSelf,TSelf> INumber<Byte> INumber<TSelf> INumberBase<Byte> INumberBase<TSelf> IShiftOperators<Byte,Int32,Byte> IShiftOperators<TSelf,Int32,TSelf> ISubtractionOperators<Byte,Byte,Byte> ISubtractionOperators<TSelf,TSelf,TSelf> IUnaryNegationOperators<Byte,Byte> IUnaryNegationOperators<TSelf,TSelf> IUnaryPlusOperators<Byte,Byte> IUnaryPlusOperators<TSelf,TSelf> IUnsignedNumber<Byte> IUtf8SpanFormattable IUtf8SpanParsable<Byte> IUtf8SpanParsable<TSelf>

Remarques

Byte est un type de valeur immuable qui représente des entiers non signés avec des valeurs comprises entre 0 (qui est représentée par la Byte.MinValue constante) et 255 (qui est représentée par la Byte.MaxValue constante). .NET inclut également un type de valeur entière 8 bits signé, SByte, qui représente des valeurs comprises entre -128 et 127.

Instanciation d’une valeur d’octet

Vous pouvez instancier une Byte valeur de plusieurs façons :

• Vous pouvez déclarer une Byte variable et lui affecter une valeur entière littérale qui se trouve dans la plage du Byte type de données. L’exemple suivant déclare deux Byte variables et leur affecte des valeurs de cette façon.

  byte value1 = 64;
  byte value2 = 255;
  

  let value1 = 64uy
  let value2 = 255uy
  

  Dim value1 As Byte = 64
  Dim value2 As Byte = 255
  

• Vous pouvez affecter une valeur numérique non octet à un octet. Il s’agit d’une conversion restrictive. Elle nécessite donc un opérateur de cast en C# et F#, ou une méthode de conversion en Visual Basic si Option Strict est activé. Si la valeur non octet est une Singlevaleur , Doubleou Decimal qui inclut un composant fractionnaire, la gestion de sa partie fractionnaire dépend du compilateur effectuant la conversion. L’exemple suivant affecte plusieurs valeurs numériques à des Byte variables.

  int int1 = 128;
  try {
     byte value1 = (byte) int1;
     Console.WriteLine(value1);
  }
  catch (OverflowException) {
     Console.WriteLine("{0} is out of range of a byte.", int1);
  }
  
  double dbl2 = 3.997;
  try {
     byte value2 = (byte) dbl2;
     Console.WriteLine(value2);
  }
  catch (OverflowException) {
     Console.WriteLine("{0} is out of range of a byte.", dbl2);
  }
  // The example displays the following output:
  //       128
  //       3
  

  let int1 = 128
  try
      let value1 = byte int1
      printfn $"{value1}"
  with :? OverflowException ->
      printfn $"{int1} is out of range of a byte."
  
  let dbl2 = 3.997
  try
      let value2 = byte dbl2
      printfn $"{value2}"
  with :? OverflowException ->
      printfn $"{dbl2} is out of range of a byte."
  
  // The example displays the following output:
  //       128
  //       3
  

  Dim int1 As Integer = 128
  Try
     Dim value1 As Byte = CByte(int1)
     Console.WriteLine(value1)
  Catch e As OverflowException
     Console.WriteLine("{0} is out of range of a byte.", int1)
  End Try
  
  Dim dbl2 As Double = 3.997
  Try
     Dim value2 As Byte = CByte(dbl2)
     Console.WriteLine(value2)
  Catch e As OverflowException
     Console.WriteLine("{0} is out of range of a byte.", dbl2)
  End Try   
  ' The example displays the following output:
  '       128
  '       4
  

• Vous pouvez appeler une méthode de la Convert classe pour convertir n’importe quel type pris en charge en valeur Byte . Cela est possible, car Byte prend en charge l’interface IConvertible . L’exemple suivant illustre la conversion d’un tableau de Int32 valeurs en Byte valeurs.

  int[] numbers = { Int32.MinValue, -1, 0, 121, 340, Int32.MaxValue };
  byte result;
  foreach (int number in numbers)
  {
     try {
        result = Convert.ToByte(number);
        Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.",
                          number.GetType().Name, number,
                          result.GetType().Name, result);
     }
     catch (OverflowException) {
        Console.WriteLine("The {0} value {1} is outside the range of the Byte type.",
                          number.GetType().Name, number);
     }
  }
  // The example displays the following output:
  //       The Int32 value -2147483648 is outside the range of the Byte type.
  //       The Int32 value -1 is outside the range of the Byte type.
  //       Converted the Int32 value 0 to the Byte value 0.
  //       Converted the Int32 value 121 to the Byte value 121.
  //       The Int32 value 340 is outside the range of the Byte type.
  //       The Int32 value 2147483647 is outside the range of the Byte type.
  

  open System
  
  let numbers = [| Int32.MinValue; -1; 0; 121; 340; Int32.MaxValue |]
  
  for number in numbers do
      try
          let result = Convert.ToByte number
          printfn $"Converted the {number.GetType().Name} value {number} to the {result.GetType().Name} value {result}."
  
      with :? OverflowException ->
          printfn $"The {number.GetType().Name} value {number} is outside the range of the Byte type."
  
  
  // The example displays the following output:
  //       The Int32 value -2147483648 is outside the range of the Byte type.
  //       The Int32 value -1 is outside the range of the Byte type.
  //       Converted the Int32 value 0 to the Byte value 0.
  //       Converted the Int32 value 121 to the Byte value 121.
  //       The Int32 value 340 is outside the range of the Byte type.
  //       The Int32 value 2147483647 is outside the range of the Byte type.
  

  Dim numbers() As Integer = { Int32.MinValue, -1, 0, 121, 340, Int32.MaxValue }
  Dim result As Byte
  For Each number As Integer In numbers
     Try
        result = Convert.ToByte(number)
        Console.WriteLIne("Converted the {0} value {1} to the {2} value {3}.", _
                          number.GetType().Name, number, _
                          result.GetType().Name, result)
     Catch e As OverflowException
        Console.WriteLine("The {0} value {1} is outside the range of the Byte type.", _
                          number.GetType().Name, number)
     End Try
  Next
  ' The example displays the following output:
  '       The Int32 value -2147483648 is outside the range of the Byte type.
  '       The Int32 value -1 is outside the range of the Byte type.
  '       Converted the Int32 value 0 to the Byte value 0.
  '       Converted the Int32 value 121 to the Byte value 121.
  '       The Int32 value 340 is outside the range of the Byte type.
  '       The Int32 value 2147483647 is outside the range of the Byte type.
  

• Vous pouvez appeler la Parse méthode ou TryParse pour convertir la représentation sous forme de chaîne d’une Byte valeur en Byte. La chaîne peut contenir des chiffres décimaux ou hexadécimaux. L’exemple suivant illustre l’opération d’analyse à l’aide d’une chaîne décimale et d’une chaîne hexadécimale.

  string string1 = "244";
  try {
     byte byte1 = Byte.Parse(string1);
     Console.WriteLine(byte1);
  }
  catch (OverflowException) {
     Console.WriteLine("'{0}' is out of range of a byte.", string1);
  }
  catch (FormatException) {
     Console.WriteLine("'{0}' is out of range of a byte.", string1);
  }
  
  string string2 = "F9";
  try {
     byte byte2 = Byte.Parse(string2,
                             System.Globalization.NumberStyles.HexNumber);
     Console.WriteLine(byte2);
  }
  catch (OverflowException) {
     Console.WriteLine("'{0}' is out of range of a byte.", string2);
  }
  catch (FormatException) {
     Console.WriteLine("'{0}' is out of range of a byte.", string2);
  }
  // The example displays the following output:
  //       244
  //       249
  

  let string1 = "244"
  try
      let byte1 = Byte.Parse string1
      printfn $"{byte1}" 
  with
  | :? OverflowException ->
      printfn $"'{string1}' is out of range of a byte."
  | :? FormatException ->
      printfn $"'{string1}' is out of range of a byte."
  
  let string2 = "F9"
  try
      let byte2 = Byte.Parse(string2, System.Globalization.NumberStyles.HexNumber)
      printfn $"{byte2}"
  with
  | :? OverflowException ->
      printfn $"'{string2}' is out of range of a byte."
  | :? FormatException ->
      printfn $"'{string2}' is out of range of a byte."
  
  // The example displays the following output:
  //       244
  //       249
  

  Dim string1 As String = "244"
  Try
     Dim byte1 As Byte = Byte.Parse(string1)
     Console.WriteLine(byte1)
  Catch e As OverflowException
     Console.WriteLine("'{0}' is out of range of a byte.", string1)
  Catch e As FormatException
     Console.WriteLine("'{0}' is out of range of a byte.", string1)
  End Try
  
  Dim string2 As String = "F9"
  Try
     Dim byte2 As Byte = Byte.Parse(string2,
                               System.Globalization.NumberStyles.HexNumber)
     Console.WriteLine(byte2)
  Catch e As OverflowException
     Console.WriteLine("'{0}' is out of range of a byte.", string2)
  Catch e As FormatException
     Console.WriteLine("'{0}' is out of range of a byte.", string2)
  End Try
  ' The example displays the following output:
  '       244
  '       249
  

Exécution d’opérations sur des valeurs d’octets

Le Byte type prend en charge les opérations mathématiques standard telles que l’addition, la soustraction, la division, la multiplication, la soustraction, la négation et la négation unaire. Comme les autres types intégraux, le Byte type prend également en charge les opérateurs au niveau ANDdu bit , OR, XOR, décalage gauche et décalage vers la droite.

Vous pouvez utiliser les opérateurs numériques standard pour comparer deux Byte valeurs, ou vous pouvez appeler la CompareTo méthode ou Equals .

Vous pouvez également appeler les membres de la Math classe pour effectuer un large éventail d’opérations numériques, notamment obtenir la valeur absolue d’un nombre, calculer le quotient et le reste à partir de la division intégrale, déterminer la valeur maximale ou minimale de deux entiers, obtenir le signe d’un nombre et arrondir un nombre.

Représentation d’un octet sous forme de chaîne

Le Byte type fournit une prise en charge complète des chaînes de format numériques standard et personnalisées. (Pour plus d’informations, consultez Mise en forme des types, chaînes de format numériques standard et chaînes de format numériques personnalisées.) Toutefois, le plus souvent, les valeurs d’octets sont représentées sous la forme de valeurs d’un chiffre à trois chiffres sans mise en forme supplémentaire, ou de valeurs hexadécimales à deux chiffres.

Pour mettre en forme une Byte valeur en tant que chaîne intégrale sans zéros de début, vous pouvez appeler la méthode sans ToString() paramètre. En utilisant le spécificateur de format « D », vous pouvez également inclure un nombre spécifié de zéros de début dans la représentation sous forme de chaîne. En utilisant le spécificateur de format « X », vous pouvez représenter une Byte valeur sous la forme d’une chaîne hexadécimale. L’exemple suivant met en forme les éléments d’un tableau de Byte valeurs de ces trois façons.

byte[] numbers = { 0, 16, 104, 213 };
foreach (byte number in numbers) {
   // Display value using default formatting.
   Console.Write("{0,-3}  -->   ", number.ToString());
   // Display value with 3 digits and leading zeros.
   Console.Write(number.ToString("D3") + "   ");
   // Display value with hexadecimal.
   Console.Write(number.ToString("X2") + "   ");
   // Display value with four hexadecimal digits.
   Console.WriteLine(number.ToString("X4"));
}
// The example displays the following output:
//       0    -->   000   00   0000
//       16   -->   016   10   0010
//       104  -->   104   68   0068
//       213  -->   213   D5   00D5

let numbers = [| 0; 16; 104; 213 |]
for number in numbers do
    // Display value using default formatting.
    number.ToString()
    |> printf "%-3s  -->   "

    // Display value with 3 digits and leading zeros.
    number.ToString "D3"
    |> printf "%s   "
    
    // Display value with hexadecimal.
    number.ToString "X2"
    |> printf "%s   "
    
    // Display value with four hexadecimal digits.
    number.ToString "X4"
    |> printfn "%s"

// The example displays the following output:
//       0    -->   000   00   0000
//       16   -->   016   10   0010
//       104  -->   104   68   0068
//       213  -->   213   D5   00D5

Dim numbers() As Byte = { 0, 16, 104, 213 }
For Each number As Byte In numbers
   ' Display value using default formatting.
   Console.Write("{0,-3}  -->   ", number.ToString())
   ' Display value with 3 digits and leading zeros.
   Console.Write(number.ToString("D3") + "   ")
   ' Display value with hexadecimal.
   Console.Write(number.ToString("X2") + "   ")
   ' Display value with four hexadecimal digits.
   Console.WriteLine(number.ToString("X4"))
Next   
' The example displays the following output:
'       0    -->   000   00   0000
'       16   -->   016   10   0010
'       104  -->   104   68   0068
'       213  -->   213   D5   00D5

Vous pouvez également mettre en forme une Byte valeur en tant que chaîne binaire, octal, décimale ou hexadécimale en appelant la ToString(Byte, Int32) méthode et en fournissant la base comme deuxième paramètre de la méthode. L’exemple suivant appelle cette méthode pour afficher les représentations binaires, octales et hexadécimales d’un tableau de valeurs d’octets.

byte[] numbers ={ 0, 16, 104, 213 };
Console.WriteLine("{0}   {1,8}   {2,5}   {3,5}",
                  "Value", "Binary", "Octal", "Hex");
foreach (byte number in numbers) {
   Console.WriteLine("{0,5}   {1,8}   {2,5}   {3,5}",
                     number, Convert.ToString(number, 2),
                     Convert.ToString(number, 8),
                     Convert.ToString(number, 16));
}
// The example displays the following output:
//       Value     Binary   Octal     Hex
//           0          0       0       0
//          16      10000      20      10
//         104    1101000     150      68
//         213   11010101     325      d5

let numbers = [| 0; 16; 104; 213 |]
printfn "%s   %8s   %5s   %5s" "Value" "Binary" "Octal" "Hex"
for number in numbers do
    printfn $"%5i{number}   %8s{Convert.ToString(number, 2)}   %5s{Convert.ToString(number, 8)}   %5s{Convert.ToString(number, 16)}"
                    
// The example displays the following output:
//       Value     Binary   Octal     Hex
//           0          0       0       0
//          16      10000      20      10
//         104    1101000     150      68
//         213   11010101     325      d5

Dim numbers() As Byte = { 0, 16, 104, 213 }
Console.WriteLine("{0}   {1,8}   {2,5}   {3,5}", _
                  "Value", "Binary", "Octal", "Hex")
For Each number As Byte In numbers
   Console.WriteLine("{0,5}   {1,8}   {2,5}   {3,5}", _
                     number, Convert.ToString(number, 2), _
                     Convert.ToString(number, 8), _
                     Convert.ToString(number, 16))
Next      
' The example displays the following output:
'       Value     Binary   Octal     Hex
'           0          0       0       0
'          16      10000      20      10
'         104    1101000     150      68
'         213   11010101     325      d5

Utilisation de valeurs d’octets non décimaux

En plus d’utiliser des octets individuels en tant que valeurs décimales, vous pouvez effectuer des opérations au niveau du bit avec des valeurs d’octets, ou utiliser des tableaux d’octets ou des représentations binaires ou hexadécimales des valeurs d’octets. Par exemple, les surcharges de la BitConverter.GetBytes méthode peuvent convertir chacun des types de données primitifs en tableau d’octets, et la BigInteger.ToByteArray méthode convertit une BigInteger valeur en tableau d’octets.

Byte les valeurs sont représentées en 8 bits par leur magnitude uniquement, sans bit de signe. Il est important de garder à l’esprit quand vous effectuez des opérations au niveau du bit sur Byte des valeurs ou lorsque vous travaillez avec des bits individuels. Pour effectuer une opération numérique, booléenne ou de comparaison sur deux valeurs non décimales, les deux valeurs doivent utiliser la même représentation.

Lorsqu’une opération est effectuée sur deux Byte valeurs, les valeurs partagent la même représentation, de sorte que le résultat est précis. Cela est illustré dans l’exemple suivant, qui masque le bit d’ordre le plus bas d’une Byte valeur pour s’assurer qu’il est pair.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string[] values = { Convert.ToString(12, 16),
                          Convert.ToString(123, 16),
                          Convert.ToString(245, 16) };

      byte mask = 0xFE;
      foreach (string value in values) {
         Byte byteValue = Byte.Parse(value, NumberStyles.AllowHexSpecifier);
         Console.WriteLine("{0} And {1} = {2}", byteValue, mask,
                           byteValue & mask);
      }
   }
}
// The example displays the following output:
//       12 And 254 = 12
//       123 And 254 = 122
//       245 And 254 = 244

open System
open System.Globalization

let values = 
    [ Convert.ToString(12, 16)
      Convert.ToString(123, 16)
      Convert.ToString(245, 16) ]

let mask = 0xFEuy
for value in values do
    let byteValue = Byte.Parse(value, NumberStyles.AllowHexSpecifier)
    printfn $"{byteValue} And {mask} = {byteValue &&& mask}"
                    

// The example displays the following output:
//       12 And 254 = 12
//       123 And 254 = 122
//       245 And 254 = 244

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim values() As String = { Convert.ToString(12, 16), _
                                 Convert.ToString(123, 16), _
                                 Convert.ToString(245, 16) }
      
      Dim mask As Byte = &hFE
      For Each value As String In values
         Dim byteValue As Byte = Byte.Parse(value, NumberStyles.AllowHexSpecifier)
         Console.WriteLine("{0} And {1} = {2}", byteValue, mask, _ 
                           byteValue And mask)
      Next         
   End Sub
End Module
' The example displays the following output:
'       12 And 254 = 12
'       123 And 254 = 122
'       245 And 254 = 244

En revanche, lorsque vous travaillez avec des bits non signés et signés, les opérations au niveau du bit sont compliquées par le fait que les valeurs utilisent la SByte représentation de signe et de magnitude pour les valeurs positives, et la représentation complémentaire de deux pour les valeurs négatives. Pour effectuer une opération significative au niveau du bit, les valeurs doivent être converties en deux représentations équivalentes et les informations sur le bit de signe doivent être conservées. L’exemple suivant effectue cette opération pour masquer les bits 2 et 4 d’un tableau de valeurs 8 bits signées et non signées.

using System;
using System.Collections.Generic;
using System.Globalization;

public struct ByteString
{
   public string Value;
   public int Sign;
}

public class Example
{
   public static void Main()
   {
      ByteString[] values = CreateArray(-15, 123, 245);

      byte mask = 0x14;        // Mask all bits but 2 and 4.

      foreach (ByteString strValue in values) {
         byte byteValue = Byte.Parse(strValue.Value, NumberStyles.AllowHexSpecifier);
         Console.WriteLine("{0} ({1}) And {2} ({3}) = {4} ({5})",
                           strValue.Sign * byteValue,
                           Convert.ToString(byteValue, 2),
                           mask, Convert.ToString(mask, 2),
                           (strValue.Sign & Math.Sign(mask)) * (byteValue & mask),
                           Convert.ToString(byteValue & mask, 2));
      }
   }

   private static ByteString[] CreateArray(params int[] values)
   {
      List<ByteString> byteStrings = new List<ByteString>();

      foreach (object value in values) {
         ByteString temp = new ByteString();
         int sign = Math.Sign((int) value);
         temp.Sign = sign;

         // Change two's complement to magnitude-only representation.
         temp.Value = Convert.ToString(((int) value) * sign, 16);

         byteStrings.Add(temp);
      }
      return byteStrings.ToArray();
   }
}
// The example displays the following output:
//       -15 (1111) And 20 (10100) = 4 (100)
//       123 (1111011) And 20 (10100) = 16 (10000)
//       245 (11110101) And 20 (10100) = 20 (10100)

open System
open System.Collections.Generic
open System.Globalization

[<Struct>]
type ByteString =
    { Sign: int
      Value: string }

let createArray values =
    [ for value in values do
        let sign = sign value
        { Sign = sign
         // Change two's complement to magnitude-only representation.
          Value = Convert.ToString(value * sign, 16)} ]


let values = createArray [ -15; 123; 245 ]

let mask = 0x14uy        // Mask all bits but 2 and 4.

for strValue in values do
    let byteValue = Byte.Parse(strValue.Value, NumberStyles.AllowHexSpecifier)
    printfn $"{strValue.Sign * int byteValue} ({Convert.ToString(byteValue, 2)}) And {mask} ({Convert.ToString(mask, 2)}) = {(strValue.Sign &&& (int mask |> sign)) * int (byteValue &&& mask)} ({Convert.ToString(byteValue &&& mask, 2)})"

// The example displays the following output:
//       -15 (1111) And 20 (10100) = 4 (100)
//       123 (1111011) And 20 (10100) = 16 (10000)
//       245 (11110101) And 20 (10100) = 20 (10100)

Imports System.Collections.Generic
Imports System.Globalization

Public Structure ByteString
   Public Value As String
   Public Sign As Integer
End Structure

Module Example
   Public Sub Main()
      Dim values() As ByteString = CreateArray(-15, 123, 245)
      
      Dim mask As Byte = &h14        ' Mask all bits but 2 and 4.
      
      For Each strValue As ByteString In values
         Dim byteValue As Byte = Byte.Parse(strValue.Value, NumberStyles.AllowHexSpecifier)
         Console.WriteLine("{0} ({1}) And {2} ({3}) = {4} ({5})", _ 
                           strValue.Sign * byteValue, _ 
                           Convert.ToString(byteValue, 2), _
                           mask, Convert.ToString(mask, 2), _
                           (strValue.Sign And Math.Sign(mask)) * (byteValue And mask), _
                           Convert.ToString(byteValue And mask, 2))
      Next         
   End Sub
   
   Private Function CreateArray(ParamArray values() As Object) As ByteString()
      Dim byteStrings As New List(Of ByteString)
      For Each value As Object In values
         Dim temp As New ByteString()
         Dim sign As Integer = Math.Sign(value)
         temp.Sign = sign
         ' Change two's complement to magnitude-only representation.
         value = value * sign

         temp.Value = Convert.ToString(value, 16)
         byteStrings.Add(temp)
      Next
      Return byteStrings.ToArray()
   End Function   
End Module
' The example displays the following output:
'       -15 (1111) And 20 (10100) = 4 (100)
'       123 (1111011) And 20 (10100) = 16 (10000)
'       245 (11110101) And 20 (10100) = 20 (10100)

Champs

MaxValue	Représente la plus grande valeur possible d'un Byte. Ce champ est constant.
MinValue	Représente la plus petite valeur possible de Byte. Ce champ est constant.

Méthodes

Clamp(Byte, Byte, Byte)	Fixe une valeur à une valeur minimale et maximale inclusive.
CompareTo(Byte)	Compare cette instance à un entier non signé 8 bits et retourne une indication sur leurs valeurs relatives.
CompareTo(Object)	Compare cette instance à un objet spécifié et retourne une indication de leurs valeurs relatives.
CreateChecked<TOther>(TOther)	Crée une instance du type actuel à partir d’une valeur, lève une exception de dépassement de capacité pour toutes les valeurs qui se trouvent en dehors de la plage représentable du type actuel.
CreateSaturating<TOther>(TOther)	Crée une instance du type actuel à partir d’une valeur, saturant toutes les valeurs qui se trouvent en dehors de la plage représentable du type actuel.
CreateTruncating<TOther>(TOther)	Crée une instance du type actuel à partir d’une valeur, tronqué toutes les valeurs qui se trouvent en dehors de la plage représentable du type actuel.
DivRem(Byte, Byte)	Calcule le quotient et le reste de deux valeurs.
Equals(Byte)	Retourne une valeur indiquant si cette instance et un objet Byte spécifié représentent la même valeur.
Equals(Object)	Retourne une valeur indiquant si cette instance équivaut à un objet spécifié.
GetHashCode()	Retourne le code de hachage de cette instance.
GetTypeCode()	Retourne le TypeCode du type valeur Byte.
IsEvenInteger(Byte)	Détermine si une valeur représente un nombre intégral pair.
IsOddInteger(Byte)	Détermine si une valeur représente un nombre intégral impair.
IsPow2(Byte)	Détermine si une valeur est une puissance de deux.
LeadingZeroCount(Byte)	Calcule le nombre de zéros de début dans une valeur.
Log2(Byte)	Calcule le journal2 d’une valeur.
Max(Byte, Byte)	Compare deux valeurs au calcul, ce qui est supérieur.
Min(Byte, Byte)	Compare deux valeurs au calcul, ce qui est inférieur.
Parse(ReadOnlySpan<Byte>, IFormatProvider)	Analyse une étendue de caractères UTF-8 dans une valeur.
Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)	Analyse une étendue de caractères UTF-8 dans une valeur.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Analyse une étendue de caractères dans une valeur.
Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)	Convertit la représentation sous forme de plage d’un nombre, ayant un style et un format propre à la culture spécifiés, en sa représentation Byte équivalente.
Parse(String)	Convertit la représentation sous forme de chaîne d'un nombre en sa représentation Byte équivalente.
Parse(String, IFormatProvider)	Convertit la représentation sous forme de chaîne d'un nombre, ayant un format spécifique à la culture spécifié, en sa représentation Byte équivalente.
Parse(String, NumberStyles)	Convertit la représentation d'un nombre sous forme de chaîne dans un style spécifié en son équivalent Byte.
Parse(String, NumberStyles, IFormatProvider)	Convertit la représentation sous forme de chaîne d'un nombre, ayant un style et un format propre à la culture spécifiés, en sa représentation Byte équivalente.
PopCount(Byte)	Calcule le nombre de bits définis dans une valeur.
RotateLeft(Byte, Int32)	Fait pivoter une valeur restante d’un montant donné.
RotateRight(Byte, Int32)	Fait pivoter une valeur à droite d’un montant donné.
Sign(Byte)	Calcule le signe d’une valeur.
ToString()	Convertit la valeur de l'objet Byte actif en sa représentation équivalente sous forme de chaîne.
ToString(IFormatProvider)	Convertit la valeur numérique de l'objet Byte actuel en sa représentation sous forme de chaîne équivalente à l'aide des informations de mise en forme propres à la culture spécifiées.
ToString(String)	Convertit la valeur de l'objet Byte actuel en sa représentation sous forme de chaîne équivalente en utilisant le format spécifié.
ToString(String, IFormatProvider)	Convertit la valeur de l'objet Byte actif en sa représentation sous forme de chaîne équivalente à l'aide du format et des informations de mise en forme spécifiques à la culture spécifiés.
TrailingZeroCount(Byte)	Calcule le nombre de zéros de fin dans une valeur.
TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Tente de mettre en forme la valeur de la instance actuelle en UTF-8 dans l’étendue d’octets fournie.
TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)	Tente de mettre en forme la valeur de l’instance d’entier non signé 8 bits actuelle dans la plage de caractères fournie.
TryParse(ReadOnlySpan<Byte>, Byte)	Tente de convertir une étendue de caractères UTF-8 contenant la représentation sous forme de chaîne d’un nombre en son équivalent entier non signé 8 bits.
TryParse(ReadOnlySpan<Byte>, IFormatProvider, Byte)	Tente d’analyser une étendue de caractères UTF-8 dans une valeur.
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, Byte)	Tente d’analyser une étendue de caractères UTF-8 dans une valeur.
TryParse(ReadOnlySpan<Char>, Byte)	Essaie de convertir la représentation sous forme de plage d’un nombre en son équivalent Byte et retourne une valeur indiquant si la conversion a réussi.
TryParse(ReadOnlySpan<Char>, IFormatProvider, Byte)	Tente d’analyser une étendue de caractères dans une valeur.
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, Byte)	Convertit la représentation sous forme de plage d’un nombre, ayant un style et un format propre à la culture spécifiés, en sa représentation Byte équivalente. Une valeur de retour indique si la conversion a réussi ou a échoué.
TryParse(String, Byte)	Essaie de convertir la représentation sous forme de chaîne d'un nombre en son équivalent Byte et retourne une valeur indiquant si la conversion a réussi.
TryParse(String, IFormatProvider, Byte)	Tente d’analyser une chaîne dans une valeur.
TryParse(String, NumberStyles, IFormatProvider, Byte)	Convertit la représentation sous forme de chaîne d'un nombre, ayant un style et un format propre à la culture spécifiés, en sa représentation Byte équivalente. Une valeur de retour indique si la conversion a réussi ou a échoué.

Implémentations d’interfaces explicites

IAdditionOperators<Byte,Byte,Byte>.Addition(Byte, Byte)	Ajoute deux valeurs ensemble pour calculer leur somme.
IAdditionOperators<Byte,Byte,Byte>.CheckedAddition(Byte, Byte)	Ajoute deux valeurs ensemble pour calculer leur somme.
IAdditiveIdentity<Byte,Byte>.AdditiveIdentity	Obtient l’identité additive du type actuel.
IBinaryInteger<Byte>.GetByteCount()	Obtient le nombre d’octets qui seront écrits dans le cadre de TryWriteLittleEndian(Span<Byte>, Int32).
IBinaryInteger<Byte>.GetShortestBitLength()	Obtient la longueur, en bits, de la représentation complémentaire des deux plus courtes de la valeur actuelle.
IBinaryInteger<Byte>.TryReadBigEndian(ReadOnlySpan<Byte>, Boolean, Byte)	Représente un entier non signé 8 bits.
IBinaryInteger<Byte>.TryReadLittleEndian(ReadOnlySpan<Byte>, Boolean, Byte)	Représente un entier non signé 8 bits.
IBinaryInteger<Byte>.TryWriteBigEndian(Span<Byte>, Int32)	Tente d’écrire la valeur actuelle, au format big-endian, dans une étendue donnée.
IBinaryInteger<Byte>.TryWriteLittleEndian(Span<Byte>, Int32)	Tente d’écrire la valeur actuelle, au format little endian, dans une étendue donnée.
IBinaryNumber<Byte>.AllBitsSet	Obtient une instance du type binaire dans lequel tous les bits sont définis.
IBitwiseOperators<Byte,Byte,Byte>.BitwiseAnd(Byte, Byte)	Calcule la valeur au niveau du bit et de deux valeurs.
IBitwiseOperators<Byte,Byte,Byte>.BitwiseOr(Byte, Byte)	Calcule la valeur au niveau du bit ou de deux valeurs.
IBitwiseOperators<Byte,Byte,Byte>.ExclusiveOr(Byte, Byte)	Calcule l’exclusif ou de deux valeurs.
IBitwiseOperators<Byte,Byte,Byte>.OnesComplement(Byte)	Calcule la représentation du complément unique d’une valeur donnée.
IComparisonOperators<Byte,Byte,Boolean>.GreaterThan(Byte, Byte)	Compare deux valeurs pour déterminer laquelle est supérieure.
IComparisonOperators<Byte,Byte,Boolean>.GreaterThanOrEqual(Byte, Byte)	Compare deux valeurs pour déterminer laquelle est supérieure ou égale.
IComparisonOperators<Byte,Byte,Boolean>.LessThan(Byte, Byte)	Compare deux valeurs pour déterminer laquelle est inférieure.
IComparisonOperators<Byte,Byte,Boolean>.LessThanOrEqual(Byte, Byte)	Compare deux valeurs pour déterminer laquelle est inférieure ou égale.
IConvertible.ToBoolean(IFormatProvider)	Pour obtenir une description de ce membre, consultez ToBoolean(IFormatProvider).
IConvertible.ToByte(IFormatProvider)	Pour obtenir une description de ce membre, consultez ToByte(IFormatProvider).
IConvertible.ToChar(IFormatProvider)	Pour obtenir une description de ce membre, consultez ToChar(IFormatProvider).
IConvertible.ToDateTime(IFormatProvider)	Cette conversion n'est pas prise en charge. Toute tentative d'utilisation de cette méthode lève une InvalidCastException.
IConvertible.ToDecimal(IFormatProvider)	Pour obtenir une description de ce membre, consultez ToDecimal(IFormatProvider).
IConvertible.ToDouble(IFormatProvider)	Pour obtenir une description de ce membre, consultez ToDouble(IFormatProvider).
IConvertible.ToInt16(IFormatProvider)	Pour obtenir une description de ce membre, consultez ToInt16(IFormatProvider).
IConvertible.ToInt32(IFormatProvider)	Pour obtenir une description de ce membre, consultez ToInt32(IFormatProvider).
IConvertible.ToInt64(IFormatProvider)	Pour obtenir une description de ce membre, consultez ToInt64(IFormatProvider).
IConvertible.ToSByte(IFormatProvider)	Pour obtenir une description de ce membre, consultez ToSByte(IFormatProvider).
IConvertible.ToSingle(IFormatProvider)	Pour obtenir une description de ce membre, consultez ToSingle(IFormatProvider).
IConvertible.ToType(Type, IFormatProvider)	Pour obtenir une description de ce membre, consultez ToType(Type, IFormatProvider).
IConvertible.ToUInt16(IFormatProvider)	Pour obtenir une description de ce membre, consultez ToUInt16(IFormatProvider).
IConvertible.ToUInt32(IFormatProvider)	Pour obtenir une description de ce membre, consultez ToUInt32(IFormatProvider).
IConvertible.ToUInt64(IFormatProvider)	Pour obtenir une description de ce membre, consultez ToUInt64(IFormatProvider).
IDecrementOperators<Byte>.CheckedDecrement(Byte)	Décrémente une valeur.
IDecrementOperators<Byte>.Decrement(Byte)	Décrémente une valeur.
IDivisionOperators<Byte,Byte,Byte>.Division(Byte, Byte)	Divise une valeur par une autre pour calculer leur quotient.
IEqualityOperators<Byte,Byte,Boolean>.Equality(Byte, Byte)	Compare deux valeurs pour déterminer l’égalité.
IEqualityOperators<Byte,Byte,Boolean>.Inequality(Byte, Byte)	Compare deux valeurs pour déterminer l’inégalité.
IIncrementOperators<Byte>.CheckedIncrement(Byte)	Incrémente une valeur.
IIncrementOperators<Byte>.Increment(Byte)	Incrémente une valeur.
IMinMaxValue<Byte>.MaxValue	Obtient la valeur maximale du type actuel.
IMinMaxValue<Byte>.MinValue	Obtient la valeur minimale du type actuel.
IModulusOperators<Byte,Byte,Byte>.Modulus(Byte, Byte)	Divise deux valeurs pour calculer leur module ou leur reste.
IMultiplicativeIdentity<Byte,Byte>.MultiplicativeIdentity	Obtient l’identité multiplicative du type actuel.
IMultiplyOperators<Byte,Byte,Byte>.CheckedMultiply(Byte, Byte)	Multiplie deux valeurs ensemble pour calculer leur produit.
IMultiplyOperators<Byte,Byte,Byte>.Multiply(Byte, Byte)	Multiplie deux valeurs ensemble pour calculer leur produit.
INumber<Byte>.CopySign(Byte, Byte)	Copie le signe d’une valeur dans le signe d’une autre valeur.
INumber<Byte>.MaxNumber(Byte, Byte)	Compare deux valeurs pour calculer ce qui est supérieur et renvoyer l’autre valeur si une entrée est NaN.
INumber<Byte>.MinNumber(Byte, Byte)	Compare deux valeurs pour calculer ce qui est inférieur et retourner l’autre valeur si une entrée est NaN.
INumberBase<Byte>.Abs(Byte)	Calcule l’absolu d’une valeur.
INumberBase<Byte>.IsCanonical(Byte)	Détermine si une valeur se trouve dans sa représentation canonique.
INumberBase<Byte>.IsComplexNumber(Byte)	Détermine si une valeur représente un nombre complexe.
INumberBase<Byte>.IsFinite(Byte)	Détermine si une valeur est finie.
INumberBase<Byte>.IsImaginaryNumber(Byte)	Détermine si une valeur représente un nombre imaginaire pur.
INumberBase<Byte>.IsInfinity(Byte)	Détermine si une valeur est infinie.
INumberBase<Byte>.IsInteger(Byte)	Détermine si une valeur représente un nombre intégral.
INumberBase<Byte>.IsNaN(Byte)	Détermine si une valeur est NaN.
INumberBase<Byte>.IsNegative(Byte)	Détermine si une valeur est négative.
INumberBase<Byte>.IsNegativeInfinity(Byte)	Détermine si une valeur est l’infini négatif.
INumberBase<Byte>.IsNormal(Byte)	Détermine si une valeur est normale.
INumberBase<Byte>.IsPositive(Byte)	Détermine si une valeur est positive.
INumberBase<Byte>.IsPositiveInfinity(Byte)	Détermine si une valeur est positive à l’infini.
INumberBase<Byte>.IsRealNumber(Byte)	Détermine si une valeur représente un nombre réel.
INumberBase<Byte>.IsSubnormal(Byte)	Détermine si une valeur est sous-normale.
INumberBase<Byte>.IsZero(Byte)	Détermine si une valeur est égale à zéro.
INumberBase<Byte>.MaxMagnitude(Byte, Byte)	Compare deux valeurs au calcul, ce qui est supérieur.
INumberBase<Byte>.MaxMagnitudeNumber(Byte, Byte)	Compare deux valeurs au calcul qui a la plus grande amplitude et retourne l’autre valeur si une entrée est NaN.
INumberBase<Byte>.MinMagnitude(Byte, Byte)	Compare deux valeurs au calcul, ce qui est inférieur.
INumberBase<Byte>.MinMagnitudeNumber(Byte, Byte)	Compare deux valeurs au calcul qui a la plus petite amplitude et retourne l’autre valeur si une entrée est NaN.
INumberBase<Byte>.One	Obtient la valeur 1 du type.
INumberBase<Byte>.Radix	Obtient la base pour le type.
INumberBase<Byte>.TryConvertFromChecked<TOther>(TOther, Byte)	Représente un entier non signé 8 bits.
INumberBase<Byte>.TryConvertFromSaturating<TOther>(TOther, Byte)	Représente un entier non signé 8 bits.
INumberBase<Byte>.TryConvertFromTruncating<TOther>(TOther, Byte)	Représente un entier non signé 8 bits.
INumberBase<Byte>.TryConvertToChecked<TOther>(Byte, TOther)	Tente de convertir une instance du type actuel en un autre type, lève une exception de dépassement de capacité pour toutes les valeurs qui se trouvent en dehors de la plage représentable du type actuel.
INumberBase<Byte>.TryConvertToSaturating<TOther>(Byte, TOther)	Tente de convertir une instance du type actuel en un autre type, en saturant toutes les valeurs qui se trouvent en dehors de la plage représentable du type actuel.
INumberBase<Byte>.TryConvertToTruncating<TOther>(Byte, TOther)	Tente de convertir une instance du type actuel en un autre type, en tronqué toutes les valeurs qui se trouvent en dehors de la plage représentable du type actuel.
INumberBase<Byte>.Zero	Obtient la valeur 0 du type.
IShiftOperators<Byte,Int32,Byte>.LeftShift(Byte, Int32)	Déplace une valeur à gauche d’un montant donné.
IShiftOperators<Byte,Int32,Byte>.RightShift(Byte, Int32)	Déplace une valeur vers la droite d’un montant donné.
IShiftOperators<Byte,Int32,Byte>.UnsignedRightShift(Byte, Int32)	Déplace une valeur vers la droite d’un montant donné.
ISubtractionOperators<Byte,Byte,Byte>.CheckedSubtraction(Byte, Byte)	Soustrait deux valeurs pour calculer leur différence.
ISubtractionOperators<Byte,Byte,Byte>.Subtraction(Byte, Byte)	Soustrait deux valeurs pour calculer leur différence.
IUnaryNegationOperators<Byte,Byte>.CheckedUnaryNegation(Byte)	Calcule la négation unaire vérifiée d’une valeur.
IUnaryNegationOperators<Byte,Byte>.UnaryNegation(Byte)	Calcule la négation unaire d’une valeur.
IUnaryPlusOperators<Byte,Byte>.UnaryPlus(Byte)	Calcule le plus unaire d’une valeur.

Cohérence de thread

Tous les membres de ce type sont thread-safe. Les membres qui semblent modifier instance’état retournent en fait une nouvelle instance initialisée avec la nouvelle valeur. Comme pour tout autre type, la lecture et l’écriture dans une variable partagée qui contient une instance de ce type doivent être protégées par un verrou pour garantir la sécurité des threads.

Voir aussi

• SByte
• IComparable
• IFormattable
• IConvertible
• Exemple : utilitaire de mise en forme .NET Core WinForms (C#)
• Exemple : utilitaire de mise en forme .NET Core WinForms (Visual Basic)