Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Int32 structure

 

Date de publication : novembre 2016

Représente un entier signé 32 bits.

Pour parcourir le code source .NET Framework pour ce type, consultez la Reference Source.

Espace de noms:   System
Assembly:  mscorlib (dans mscorlib.dll)

[SerializableAttribute]
[ComVisibleAttribute(true)]
public struct Int32 : IComparable, IFormattable, IConvertible, 
	IComparable<int>, IEquatable<int>

NomDescription
System_CAPS_pubmethodCompareTo(Int32)

Compare cette instance à un entier 32 bits signé et retourne une indication de leurs valeurs relatives.

System_CAPS_pubmethodCompareTo(Object)

Compare cette instance à un objet spécifié et retourne une indication de leurs valeurs relatives.

System_CAPS_pubmethodEquals(Int32)

Retourne une valeur indiquant si cette instance est égale à une valeur Int32 spécifiée.

System_CAPS_pubmethodEquals(Object)

Retourne une valeur indiquant si cette instance équivaut à un objet spécifié.(Remplace ValueType.Equals(Object).)

System_CAPS_pubmethodGetHashCode()

Retourne le code de hachage de cette instance.(Remplace ValueType.GetHashCode().)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodGetTypeCode()

Retourne le TypeCode du type valeur Int32.

System_CAPS_pubmethodSystem_CAPS_staticParse(String)

Convertit la représentation sous forme de chaîne d'un nombre en son équivalent entier 32 bits signé.

System_CAPS_pubmethodSystem_CAPS_staticParse(String, IFormatProvider)

Convertit la représentation d'un nombre sous forme de chaîne dans un format propre à une culture spécifié en entier 32 bits signé équivalent.

System_CAPS_pubmethodSystem_CAPS_staticParse(String, NumberStyles)

Convertit une représentation d'un nombre sous forme de chaîne dans un style spécifié en entier 32 bits signé équivalent.

System_CAPS_pubmethodSystem_CAPS_staticParse(String, NumberStyles, IFormatProvider)

Convertit la représentation sous forme de chaîne d'un nombre dans un style et un format propre à une culture spécifiés en entier 32 bits signé équivalent.

System_CAPS_pubmethodToString()

Convertit la valeur numérique de cette instance en sa représentation équivalente sous forme de chaîne.(Remplace ValueType.ToString().)

System_CAPS_pubmethodToString(IFormatProvider)

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l'aide des informations de format spécifiques à la culture donnée.

System_CAPS_pubmethodToString(String)

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente en utilisant le format spécifié.

System_CAPS_pubmethodToString(String, IFormatProvider)

Convertit la valeur numérique de cette instance en sa représentation sous forme de chaîne équivalente à l'aide du format spécifié et des informations de format spécifiques à la culture.

System_CAPS_pubmethodSystem_CAPS_staticTryParse(String, Int32)

Convertit la représentation sous forme de chaîne d'un nombre en son équivalent entier 32 bits signé. Une valeur de retour indique si la conversion a réussi.

System_CAPS_pubmethodSystem_CAPS_staticTryParse(String, NumberStyles, IFormatProvider, Int32)

Convertit la représentation sous forme de chaîne d'un nombre dans un style et un format propre à une culture spécifiés en entier 32 bits signé équivalent. Une valeur de retour indique si la conversion a réussi.

NomDescription
System_CAPS_pubfieldSystem_CAPS_staticMaxValue

Représente la plus grande valeur possible d'un Int32. Ce champ est constant.

System_CAPS_pubfieldSystem_CAPS_staticMinValue

Représente la plus petite valeur possible de Int32. Ce champ est constant.

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIConvertible.ToBoolean(IFormatProvider)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IConvertible.ToBoolean.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIConvertible.ToByte(IFormatProvider)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IConvertible.ToByte.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIConvertible.ToChar(IFormatProvider)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IConvertible.ToChar.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIConvertible.ToDateTime(IFormatProvider)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Cette conversion n'est pas prise en charge. Toute tentative d'utilisation de cette méthode lève une InvalidCastException.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIConvertible.ToDecimal(IFormatProvider)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IConvertible.ToDecimal.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIConvertible.ToDouble(IFormatProvider)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IConvertible.ToDouble.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIConvertible.ToInt16(IFormatProvider)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IConvertible.ToInt16.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIConvertible.ToInt32(IFormatProvider)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IConvertible.ToInt32.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIConvertible.ToInt64(IFormatProvider)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IConvertible.ToInt64.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIConvertible.ToSByte(IFormatProvider)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IConvertible.ToSByte.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIConvertible.ToSingle(IFormatProvider)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IConvertible.ToSingle.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIConvertible.ToType(Type, IFormatProvider)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IConvertible.ToType.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIConvertible.ToUInt16(IFormatProvider)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IConvertible.ToUInt16.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIConvertible.ToUInt32(IFormatProvider)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IConvertible.ToUInt32.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIConvertible.ToUInt64(IFormatProvider)

Cette API prend en charge l’infrastructure de produit et n’est pas destinée à être utilisée directement depuis votre code. Pour obtenir une description de ce membre, consultez IConvertible.ToUInt64.

System_CAPS_noteRemarque

Pour afficher le code source .NET Framework pour ce type, consultez la Reference Source. Vous pouvez parcourir le code source en ligne, télécharger la référence hors connexion et parcourir les sources (y compris les correctifs et mises à jour) pendant le débogage ; see instructions.

Int32 est un type immuable qui représente des entiers signés dont les valeurs comprises entre 2 147 483 648 négatif (ce qui est représenté par la Int32.MinValue constant) à 2 147 483 647 (qui est représenté par la Int32.MaxValue constante. Le .NET Framework inclut également un type de valeur d’entier non signé 32 bits, UInt32, qui représente des valeurs comprises entre 0 et 4 294 967 295.

Vous pouvez instancier un Int32 valeur de plusieurs façons :

  • Vous pouvez déclarer une Int32 variable et lui assigner une valeur de littéral entier qui se trouve dans la plage de la Int32 type de données. L’exemple suivant déclare deux Int32 variables et leur affecte des valeurs de cette façon.

    int number1 = 64301;
    int number2 = 25548612;
    
  • Vous pouvez affecter la valeur d’un type entier dont la plage est un sous-ensemble de la Int32 type. Il s’agit d’une conversion étendue qui ne nécessite pas un opérateur de cast en c# ou une méthode de conversion en Visual Basic.

    sbyte value1 = 124;
    short value2 = 1618;
    
    int number1 = value1;
    int number2 = value2;
    
  • Vous pouvez affecter la valeur d’un type numérique dont la plage dépasse celle de la Int32 type. Ceci est une conversion restrictive, elle nécessite un opérateur de cast en c# et en Visual Basic, une méthode de conversion si OptionStrict sur. Si la valeur numérique est un Single, Double, ou Decimal valeur qui inclut un composant fractionnaire, la gestion de sa partie fractionnaire dépend du compilateur qui effectue la conversion. L’exemple suivant effectue des conversions restrictives pour assigner plusieurs valeurs numériques aux Int32 variables.

    long lNumber = 163245617;
    try {
       int number1 = (int) lNumber;
       Console.WriteLine(number1);
    }
    catch (OverflowException) {
       Console.WriteLine("{0} is out of range of an Int32.", lNumber);
    }
    
    double dbl2 = 35901.997;
    try {
       int number2 = (int) dbl2;
       Console.WriteLine(number2);
    }   
    catch (OverflowException) {
       Console.WriteLine("{0} is out of range of an Int32.", dbl2);
    }
    
    BigInteger bigNumber = 132451;
    try {
       int number3 = (int) bigNumber;
       Console.WriteLine(number3);
    }
    catch (OverflowException) {
       Console.WriteLine("{0} is out of range of an Int32.", bigNumber);
    }    
    // The example displays the following output:
    //       163245617
    //       35902
    //       132451
    
  • Vous pouvez appeler une méthode de la Convert classe pour convertir une prise en charge de type à un Int32 valeur. Cela est possible, car Int32 prend en charge la IConvertible interface. L’exemple suivant illustre la conversion d’un tableau de Decimal valeurs Int32 valeurs.

    decimal[] values= { Decimal.MinValue, -1034.23m, -12m, 0m, 147m,
                        199.55m, 9214.16m, Decimal.MaxValue };
    int result;
    
    foreach (decimal value in values)
    {
       try {
          result = Convert.ToInt32(value);
          Console.WriteLine("Converted the {0} value '{1}' to the {2} value {3}.",
                            value.GetType().Name, value,
                            result.GetType().Name, result);
       }
       catch (OverflowException) {
          Console.WriteLine("{0} is outside the range of the Int32 type.",
                            value);
       }   
    }                                  
    // The example displays the following output:
    //    -79228162514264337593543950335 is outside the range of the Int32 type.
    //    Converted the Decimal value '-1034.23' to the Int32 value -1034.
    //    Converted the Decimal value '-12' to the Int32 value -12.
    //    Converted the Decimal value '0' to the Int32 value 0.
    //    Converted the Decimal value '147' to the Int32 value 147.
    //    Converted the Decimal value '199.55' to the Int32 value 200.
    //    Converted the Decimal value '9214.16' to the Int32 value 9214.
    //    79228162514264337593543950335 is outside the range of the Int32 type.
    
  • Vous pouvez appeler la Parse ou TryParse méthode pour convertir la représentation sous forme de chaîne d’un Int32 valeur à un Int32. La chaîne peut contenir des chiffres décimales ou hexadécimales. L’exemple suivant illustre l’opération d’analyse à l’aide d’un nombre décimal et une chaîne hexadécimale.

    string string1 = "244681";
    try {
       int number1 = Int32.Parse(string1);
       Console.WriteLine(number1);
    }
    catch (OverflowException) {
       Console.WriteLine("'{0}' is out of range of a 32-bit integer.", string1);
    }
    catch (FormatException) {
       Console.WriteLine("The format of '{0}' is invalid.", string1);
    }
    
    string string2 = "F9A3C";
    try {
       int number2 = Int32.Parse(string2,
                                System.Globalization.NumberStyles.HexNumber);
       Console.WriteLine(number2);
    }
    catch (OverflowException) {
       Console.WriteLine("'{0}' is out of range of a 32-bit integer.", string2);
    }
    catch (FormatException) {
       Console.WriteLine("The format of '{0}' is invalid.", string2);
    }
    // The example displays the following output:
    //       244681
    //       1022524
    

Le Int32 type prend en charge des opérations mathématiques standards telles que l’addition, soustraction, la division, multiplication, négation et négation unaire. Comme les autres types intégraux, le Int32 type prend également en charge l’opérateur de bits AND, OR, XOR, MAJ et les opérateurs de décalage vers la droite à gauche.

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

Vous pouvez également appeler les membres de la Math classe à exécuter un large éventail d’opérations numériques, y compris l’obtention de la valeur absolue d’un nombre, en calculant le quotient et le reste de la division intégrale, détermination de la valeur minimale ou maximale de deux entiers, obtenir le signe d’un nombre et arrondir un nombre.

Le Int32 type prend en charge les chaînes de format numériques standard et personnalisées. (Pour plus d’informations, consultez Mise en forme des types dans .NET Framework, Chaînes de format numériques standard, et Chaînes de format numériques personnalisées.)

Pour mettre en forme un Int32 valeur de chaîne d’entier sans zéros non significatifs, vous pouvez appeler la méthode sans paramètre ToString() méthode. En utilisant le spécificateur de format « D », vous pouvez également inclure un nombre spécifié de zéros non significatifs dans la représentation sous forme de chaîne. En utilisant le spécificateur de format « N », vous pouvez inclure des séparateurs de groupe et spécifier le nombre de décimales à afficher dans la représentation sous forme de chaîne du nombre. En utilisant le spécificateur de format « X », vous pouvez représenter une Int32 valeur sous forme de chaîne hexadécimale. L’exemple suivant met en forme les éléments dans un tableau de Int32 les valeurs de ces quatre manières.

int[] numbers = { -1403, 0, 169, 1483104 };
foreach (int number in numbers) {
   // Display value using default formatting.
   Console.Write("{0,-8}  -->   ", number.ToString());
   // Display value with 3 digits and leading zeros.
   Console.Write("{0,11:D3}", number);
   // Display value with 1 decimal digit.
   Console.Write("{0,13:N1}", number);
   // Display value as hexadecimal.
   Console.Write("{0,12:X2}", number);
   // Display value with eight hexadecimal digits.
   Console.WriteLine("{0,14:X8}", number);
}   
// The example displays the following output:
//    -1403     -->         -1403     -1,403.0    FFFFFA85      FFFFFA85
//    0         -->           000          0.0          00      00000000
//    169       -->           169        169.0          A9      000000A9
//    1483104   -->       1483104  1,483,104.0      16A160      0016A160

Vous pouvez également mettre en forme un Int32 valeur sous forme binaire, octal, décimale ou hexadécimale chaîne en appelant le ToString(Int32, Int32) (méthode) et en fournissant la base en tant que second paramètre de la méthode. L’exemple suivant appelle cette méthode pour afficher le fichier binaire, octal et les représentations hexadécimales d’un tableau de valeurs entières.

int[] numbers = { -146, 11043, 2781913 };
Console.WriteLine("{0,8}   {1,32}   {2,11}   {3,10}", 
                  "Value", "Binary", "Octal", "Hex");
foreach (int number in numbers) {
   Console.WriteLine("{0,8}   {1,32}   {2,11}   {3,10}", 
                     number, Convert.ToString(number, 2), 
                     Convert.ToString(number, 8), 
                     Convert.ToString(number, 16));
}      
// The example displays the following output:
//       Value                             Binary         Octal          Hex
//        -146   11111111111111111111111101101110   37777777556     ffffff6e
//       11043                     10101100100011         25443         2b23
//     2781913             1010100111001011011001      12471331       2a72d9

En plus de travailler avec des entiers individuels comme valeurs décimales, vous souhaiterez peut-être effectuer des opérations au niveau du bit des valeurs entières, ou utiliser les représentations binaires ou hexadécimales des valeurs entières. Int32 les valeurs sont représentées en 31 bits, avec le bit de trente secondes utilisé comme bit de signe. Les valeurs positives sont représentées à l’aide de représentation « signe et magnitude ». Les valeurs négatives sont dans la représentation de complément à deux. Il est important de garder à l’esprit lorsque vous effectuez des opérations au niveau du bit sur Int32 valeurs ou lorsque vous travaillez avec des bits. Pour effectuer une valeur numérique, booléen ou opération de comparaison sur deux valeurs non décimales, les deux valeurs doivent utiliser la même représentation.

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 1.1
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1

Tous les membres de ce type sont thread-safe. En réalité, les membres qui semblent modifier l'état de l'instance renvoie une nouvelle instance initialisée avec la nouvelle valeur. Comme avec tout autre type, la lecture et l'écriture sur 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.

Retour au début
Afficher: