Leggere in inglese

Condividi tramite

Struct System.Boolean

  • Articolo

Questo articolo fornisce osservazioni supplementari alla documentazione di riferimento per questa API.

Un'istanza Boolean può avere uno dei due valori: true o false.

La Boolean struttura fornisce metodi che supportano le attività seguenti:

Questo articolo illustra queste attività e altri dettagli sull'utilizzo.

Formattare valori booleani

La rappresentazione di stringa di un Boolean oggetto è "True" per un true valore o "False" per un false valore. La rappresentazione di stringa di un Boolean valore è definita dai campi e FalseString di sola TrueString lettura.

Utilizzare il ToString metodo per convertire i valori booleani in stringhe. La struttura booleana include due ToString overload: il metodo senza ToString() parametri e il metodo , che include un parametro che controlla la ToString(IFormatProvider) formattazione. Tuttavia, poiché questo parametro viene ignorato, i due overload producono stringhe identiche. Il ToString(IFormatProvider) metodo non supporta la formattazione sensibile alle impostazioni cultura.

Nell'esempio seguente viene illustrata la formattazione con il ToString metodo . Si noti che gli esempi C# e VB usano la funzionalità di formattazione composita, mentre l'esempio F# usa l'interpolazione di stringhe. In entrambi i casi il ToString metodo viene chiamato in modo implicito.

C# 
using System;

public class Example10
{
   public static void Main()
   {
      bool raining = false;
      bool busLate = true;

      Console.WriteLine("It is raining: {0}", raining);
      Console.WriteLine("The bus is late: {0}", busLate);
   }
}
// The example displays the following output:
//       It is raining: False
//       The bus is late: True

Poiché la Boolean struttura può avere solo due valori, è facile aggiungere formattazione personalizzata. Per una formattazione personalizzata semplice in cui altri valori letterali stringa vengono sostituiti con "True" e "False", è possibile usare qualsiasi funzionalità di valutazione condizionale supportata dal linguaggio, ad esempio l'operatore condizionale in C# o l'operatore If in Visual Basic. Nell'esempio seguente viene usata questa tecnica per formattare Boolean i valori come "Sì" e "No" anziché "True" e "False".

C# 
using System;

public class Example11
{
    public static void Main()
    {
        bool raining = false;
        bool busLate = true;

        Console.WriteLine("It is raining: {0}",
                          raining ? "Yes" : "No");
        Console.WriteLine("The bus is late: {0}",
                          busLate ? "Yes" : "No");
    }
}
// The example displays the following output:
//       It is raining: No
//       The bus is late: Yes

Per operazioni di formattazione personalizzate più complesse, inclusa la formattazione sensibile alle impostazioni cultura, è possibile chiamare il String.Format(IFormatProvider, String, Object[]) metodo e fornire un'implementazione ICustomFormatter . Nell'esempio seguente vengono implementate le ICustomFormatter interfacce e IFormatProvider per fornire stringhe booleane sensibili alle impostazioni cultura per le impostazioni cultura inglese (Stati Uniti), francese (Francia) e russo (Russia).

C# 
using System;
using System.Globalization;

public class Example4
{
   public static void Main()
   {
      String[] cultureNames = { "", "en-US", "fr-FR", "ru-RU" };
      foreach (var cultureName in cultureNames) {
         bool value = true;
         CultureInfo culture = CultureInfo.CreateSpecificCulture(cultureName);
         BooleanFormatter formatter = new BooleanFormatter(culture);

         string result = string.Format(formatter, "Value for '{0}': {1}", culture.Name, value);
         Console.WriteLine(result);
      }
   }
}

public class BooleanFormatter : ICustomFormatter, IFormatProvider
{
   private CultureInfo culture;

   public BooleanFormatter() : this(CultureInfo.CurrentCulture)
   { }

   public BooleanFormatter(CultureInfo culture)
   {
      this.culture = culture;
   }

   public Object GetFormat(Type formatType)
   {
      if (formatType == typeof(ICustomFormatter))
         return this;
      else
         return null;
   }

   public string Format(string fmt, Object arg, IFormatProvider formatProvider)
   {
      // Exit if another format provider is used.
      if (! formatProvider.Equals(this)) return null;

      // Exit if the type to be formatted is not a Boolean
      if (! (arg is Boolean)) return null;

      bool value = (bool) arg;
      switch (culture.Name) {
         case "en-US":
            return value.ToString();
         case "fr-FR":
            if (value)
               return "vrai";
            else
               return "faux";
         case "ru-RU":
            if (value)
               return "верно";
            else
               return "неверно";
         default:
            return value.ToString();
      }
   }
}
// The example displays the following output:
//       Value for '': True
//       Value for 'en-US': True
//       Value for 'fr-FR': vrai
//       Value for 'ru-RU': верно

Facoltativamente, è possibile usare i file di risorse per definire stringhe booleane specifiche delle impostazioni cultura.

Convertire in e da valori booleani

La Boolean struttura implementa l'interfaccia IConvertible . Di conseguenza, è possibile usare la Convert classe per eseguire conversioni tra un Boolean valore e qualsiasi altro tipo primitivo in .NET oppure chiamare Boolean le implementazioni esplicite della struttura. Tuttavia, le conversioni tra un Boolean e i tipi seguenti non sono supportate, pertanto i metodi di conversione corrispondenti generano un'eccezione InvalidCastException :

Tutte le conversioni da numeri integrali o a virgola mobile a valori booleani converte valori diversi da zero a valori zero in truefalse. L'esempio seguente illustra questa operazione chiamando gli overload selezionati della Convert.ToBoolean classe .

C# 
using System;

public class Example2
{
   public static void Main()
   {
      Byte byteValue = 12;
      Console.WriteLine(Convert.ToBoolean(byteValue));
      Byte byteValue2 = 0;
      Console.WriteLine(Convert.ToBoolean(byteValue2));
      int intValue = -16345;
      Console.WriteLine(Convert.ToBoolean(intValue));
      long longValue = 945;
      Console.WriteLine(Convert.ToBoolean(longValue));
      SByte sbyteValue = -12;
      Console.WriteLine(Convert.ToBoolean(sbyteValue));
      double dblValue = 0;
      Console.WriteLine(Convert.ToBoolean(dblValue));
      float sngValue = .0001f;
      Console.WriteLine(Convert.ToBoolean(sngValue));
   }
}
// The example displays the following output:
//       True
//       False
//       True
//       True
//       True
//       False
//       True

Quando si esegue la conversione da booleano a valori numerici, i metodi di conversione della Convert classe vengono convertiti true in 1 e false in 0. Tuttavia, le funzioni di conversione di Visual Basic vengono convertite true in 255 (per le conversioni in Byte valori) o -1 (per tutte le altre conversioni numeriche). Nell'esempio seguente viene eseguita la conversione in valori numerici true utilizzando un Convert metodo e, nel caso dell'esempio di Visual Basic, utilizzando l'operatore di conversione del linguaggio Visual Basic.

C# 
using System;

public class Example3
{
   public static void Main()
   {
      bool flag = true;

      byte byteValue;
      byteValue = Convert.ToByte(flag);
      Console.WriteLine("{0} -> {1}", flag, byteValue);

      sbyte sbyteValue;
      sbyteValue = Convert.ToSByte(flag);
      Console.WriteLine("{0} -> {1}", flag, sbyteValue);

      double dblValue;
      dblValue = Convert.ToDouble(flag);
      Console.WriteLine("{0} -> {1}", flag, dblValue);

      int intValue;
      intValue = Convert.ToInt32(flag);
      Console.WriteLine("{0} -> {1}", flag, intValue);
   }
}
// The example displays the following output:
//       True -> 1
//       True -> 1
//       True -> 1
//       True -> 1

Per le conversioni da Boolean a valori stringa, vedere la sezione Formattare valori booleani. Per le conversioni da stringhe a Boolean valori, vedere la sezione Analizza valori booleani.

Analizzare i valori booleani

La Boolean struttura include due metodi di analisi statici e TryParseParse , che converte una stringa in un valore booleano. La rappresentazione di stringa di un valore booleano è definita dagli equivalenti senza distinzione tra maiuscole e minuscole dei valori dei TrueString campi e FalseString , rispettivamente, "True" e "False". In altre parole, le uniche stringhe che analizzano correttamente sono "True", "False", "true", "false" o un equivalente di maiuscole e minuscole miste. Non è possibile analizzare correttamente le stringhe numeriche, ad esempio "0" o "1". Gli spazi vuoti iniziali o finali non vengono considerati durante l'esecuzione del confronto tra stringhe.

Nell'esempio seguente vengono usati i Parse metodi e TryParse per analizzare una serie di stringhe. Si noti che solo gli equivalenti senza distinzione tra maiuscole e minuscole di "True" e "False" possono essere analizzati correttamente.

C# 
using System;

public class Example7
{
   public static void Main()
   {
      string[] values = { null, String.Empty, "True", "False",
                          "true", "false", "    true    ",
                           "TrUe", "fAlSe", "fa lse", "0",
                          "1", "-1", "string" };
      // Parse strings using the Boolean.Parse method.
      foreach (var value in values) {
         try {
            bool flag = Boolean.Parse(value);
            Console.WriteLine("'{0}' --> {1}", value, flag);
         }
         catch (ArgumentException) {
            Console.WriteLine("Cannot parse a null string.");
         }
         catch (FormatException) {
            Console.WriteLine("Cannot parse '{0}'.", value);
         }
      }
      Console.WriteLine();
      // Parse strings using the Boolean.TryParse method.
      foreach (var value in values) {
         bool flag = false;
         if (Boolean.TryParse(value, out flag))
            Console.WriteLine("'{0}' --> {1}", value, flag);
         else
            Console.WriteLine("Unable to parse '{0}'", value);
      }
   }
}
// The example displays the following output:
//       Cannot parse a null string.
//       Cannot parse ''.
//       'True' --> True
//       'False' --> False
//       'true' --> True
//       'false' --> False
//       '    true    ' --> True
//       'TrUe' --> True
//       'fAlSe' --> False
//       Cannot parse 'fa lse'.
//       Cannot parse '0'.
//       Cannot parse '1'.
//       Cannot parse '-1'.
//       Cannot parse 'string'.
//
//       Unable to parse ''
//       Unable to parse ''
//       'True' --> True
//       'False' --> False
//       'true' --> True
//       'false' --> False
//       '    true    ' --> True
//       'TrUe' --> True
//       'fAlSe' --> False
//       Cannot parse 'fa lse'.
//       Unable to parse '0'
//       Unable to parse '1'
//       Unable to parse '-1'
//       Unable to parse 'string'

Se si esegue la programmazione in Visual Basic, è possibile usare la CBool funzione per convertire la rappresentazione di stringa di un numero in un valore booleano. "0" viene convertito in falsee la rappresentazione di stringa di qualsiasi valore diverso da zero viene convertita in true. Se non si esegue la programmazione in Visual Basic, è necessario convertire la stringa numerica in un numero prima di convertirla in un valore booleano. L'esempio seguente illustra questa operazione convertendo una matrice di numeri interi in valori booleani.

C# 
using System;

public class Example8
{
   public static void Main()
   {
      String[] values = { "09", "12.6", "0", "-13 " };
      foreach (var value in values) {
         bool success, result;
         int number;
         success = Int32.TryParse(value, out number);
         if (success) {
            // The method throws no exceptions.
            result = Convert.ToBoolean(number);
            Console.WriteLine("Converted '{0}' to {1}", value, result);
         }
         else {
            Console.WriteLine("Unable to convert '{0}'", value);
         }
      }
   }
}
// The example displays the following output:
//       Converted '09' to True
//       Unable to convert '12.6'
//       Converted '0' to False
//       Converted '-13 ' to True

Confrontare i valori booleani

Poiché i valori booleani sono true o false, esiste un motivo minimo per chiamare in modo esplicito il CompareTo metodo , che indica se un'istanza è maggiore, minore o uguale a un valore specificato. In genere, per confrontare due variabili booleane, chiamare il metodo o usare l'operatore Equals di uguaglianza del linguaggio.

Tuttavia, quando si desidera confrontare una variabile booleana con il valore true booleano letterale o false, non è necessario eseguire un confronto esplicito, perché il risultato della valutazione di un valore booleano è che il valore booleano. Ad esempio, le due espressioni seguenti sono equivalenti, ma il secondo è più compatto. Tuttavia, entrambe le tecniche offrono prestazioni confrontabili.

C# 
if (booleanValue == true) {
C# 
if (booleanValue) {

Usare i valori booleani come valori binari

Un valore booleano occupa un byte di memoria, come illustrato nell'esempio seguente. L'esempio C# deve essere compilato con l'opzione /unsafe .

C# 
using System;

public struct BoolStruct
{
   public bool flag1;
   public bool flag2;
   public bool flag3;
   public bool flag4;
   public bool flag5;
}

public class Example9
{
   public static void Main()
   {
      unsafe {
         BoolStruct b = new BoolStruct();
         bool* addr = (bool*) &b;
         Console.WriteLine("Size of BoolStruct: {0}", sizeof(BoolStruct));
         Console.WriteLine("Field offsets:");
         Console.WriteLine("   flag1: {0}", (bool*) &b.flag1 - addr);
         Console.WriteLine("   flag1: {0}", (bool*) &b.flag2 - addr);
         Console.WriteLine("   flag1: {0}", (bool*) &b.flag3 - addr);
         Console.WriteLine("   flag1: {0}", (bool*) &b.flag4 - addr);
         Console.WriteLine("   flag1: {0}", (bool*) &b.flag5 - addr);
      }
   }
}
// The example displays the following output:
//       Size of BoolStruct: 5
//       Field offsets:
//          flag1: 0
//          flag1: 1
//          flag1: 2
//          flag1: 3
//          flag1: 4

Il bit di ordine basso del byte viene usato per rappresentarne il valore. Il valore 1 rappresenta true. Il valore 0 rappresenta false.

Suggerimento

È possibile utilizzare la System.Collections.Specialized.BitVector32 struttura per utilizzare i set di valori booleani.

È possibile convertire un valore booleano nella relativa rappresentazione binaria chiamando il BitConverter.GetBytes(Boolean) metodo . Il metodo restituisce una matrice di byte con un singolo elemento. Per ripristinare un valore booleano dalla relativa rappresentazione binaria, è possibile chiamare il BitConverter.ToBoolean(Byte[], Int32) metodo .

Nell'esempio seguente viene chiamato il BitConverter.GetBytes metodo per convertire un valore booleano nella relativa rappresentazione binaria e vengono visualizzati i singoli bit del valore e quindi viene chiamato il BitConverter.ToBoolean metodo per ripristinare il valore dalla relativa rappresentazione binaria.

C# 
using System;

public class Example1
{
    public static void Main()
    {
        bool[] flags = { true, false };
        foreach (var flag in flags)
        {
            // Get binary representation of flag.
            Byte value = BitConverter.GetBytes(flag)[0];
            Console.WriteLine("Original value: {0}", flag);
            Console.WriteLine("Binary value:   {0} ({1})", value,
                              GetBinaryString(value));
            // Restore the flag from its binary representation.
            bool newFlag = BitConverter.ToBoolean(new Byte[] { value }, 0);
            Console.WriteLine("Restored value: {0}\n", flag);
        }
    }

    private static string GetBinaryString(Byte value)
    {
        string retVal = Convert.ToString(value, 2);
        return new string('0', 8 - retVal.Length) + retVal;
    }
}
// The example displays the following output:
//       Original value: True
//       Binary value:   1 (00000001)
//       Restored value: True
//
//       Original value: False
//       Binary value:   0 (00000000)
//       Restored value: False

Eseguire operazioni con valori booleani

Questa sezione illustra come vengono usati i valori booleani nelle app. La prima sezione illustra l'uso come flag. Il secondo illustra l'uso per le operazioni aritmetiche.

Valori booleani come flag

Le variabili booleane vengono comunemente usate come flag per segnalare la presenza o l'assenza di una condizione. Ad esempio, nel String.Compare(String, String, Boolean) metodo , il parametro finale , ignoreCaseè un flag che indica se il confronto di due stringhe non fa distinzione tra maiuscole e minuscole (ignoreCase è true) o fa distinzione tra maiuscole e minuscole (ignoreCase è false). Il valore del flag può quindi essere valutato in un'istruzione condizionale.

L'esempio seguente usa una semplice app console per illustrare l'uso di variabili booleane come flag. L'app accetta parametri della riga di comando che consentono il reindirizzamento dell'output a un file specificato (opzione) e che consentono l'invio /f dell'output a un file specificato e alla console (opzione /b ). L'app definisce un flag denominato isRedirected per indicare se l'output deve essere inviato a un file e un flag denominato isBoth per indicare che l'output deve essere inviato alla console. L'esempio F# usa una funzione ricorsiva per analizzare gli argomenti.

C# 
using System;
using System.IO;
using System.Threading;

public class Example5
{
   public static void Main()
   {
      // Initialize flag variables.
      bool isRedirected = false;
      bool isBoth = false;
      String fileName = "";
      StreamWriter sw = null;

      // Get any command line arguments.
      String[] args = Environment.GetCommandLineArgs();
      // Handle any arguments.
      if (args.Length > 1) {
         for (int ctr = 1; ctr < args.Length; ctr++) {
            String arg = args[ctr];
            if (arg.StartsWith("/") || arg.StartsWith("-")) {
               switch (arg.Substring(1).ToLower())
               {
                  case "f":
                     isRedirected = true;
                     if (args.Length < ctr + 2) {
                        ShowSyntax("The /f switch must be followed by a filename.");
                        return;
                     }
                     fileName = args[ctr + 1];
                     ctr++;
                     break;
                  case "b":
                     isBoth = true;
                     break;
                  default:
                     ShowSyntax(String.Format("The {0} switch is not supported",
                                              args[ctr]));
                     return;
               }
            }
         }
      }

      // If isBoth is True, isRedirected must be True.
      if (isBoth &&  ! isRedirected) {
         ShowSyntax("The /f switch must be used if /b is used.");
         return;
      }

      // Handle output.
      if (isRedirected) {
         sw = new StreamWriter(fileName);
         if (!isBoth)
            Console.SetOut(sw);
      }
      String msg = String.Format("Application began at {0}", DateTime.Now);
      Console.WriteLine(msg);
      if (isBoth) sw.WriteLine(msg);
      Thread.Sleep(5000);
      msg = String.Format("Application ended normally at {0}", DateTime.Now);
      Console.WriteLine(msg);
      if (isBoth) sw.WriteLine(msg);
      if (isRedirected) sw.Close();
   }

   private static void ShowSyntax(String errMsg)
   {
      Console.WriteLine(errMsg);
      Console.WriteLine("\nSyntax: Example [[/f <filename> [/b]]\n");
   }
}

Operazioni booleane e aritmetiche

Un valore booleano viene talvolta utilizzato per indicare la presenza di una condizione che attiva un calcolo matematico. Ad esempio, una hasShippingCharge variabile può fungere da flag per indicare se aggiungere addebiti di spedizione a un importo della fattura.

Poiché un'operazione con un false valore non ha alcun effetto sul risultato di un'operazione, non è necessario convertire il valore booleano in un valore integrale da utilizzare nell'operazione matematica. È invece possibile usare la logica condizionale.

Nell'esempio seguente viene calcolato un importo costituito da un subtotale, un addebito di spedizione e un addebito facoltativo per il servizio. La hasServiceCharge variabile determina se viene applicato l'addebito del servizio. Anziché convertire hasServiceCharge in un valore numerico e moltiplicarlo per l'importo dell'addebito del servizio, nell'esempio viene usata la logica condizionale per aggiungere l'importo dell'addebito del servizio, se applicabile.

C# 
using System;

public class Example6
{
   public static void Main()
   {
      bool[] hasServiceCharges = { true, false };
      Decimal subtotal = 120.62m;
      Decimal shippingCharge = 2.50m;
      Decimal serviceCharge = 5.00m;

      foreach (var hasServiceCharge in hasServiceCharges) {
         Decimal total = subtotal + shippingCharge +
                                (hasServiceCharge ? serviceCharge : 0);
         Console.WriteLine("hasServiceCharge = {1}: The total is {0:C2}.",
                           total, hasServiceCharge);
      }
   }
}
// The example displays output like the following:
//       hasServiceCharge = True: The total is $128.12.
//       hasServiceCharge = False: The total is $123.12.

Valori booleani e interoperabilità

Anche se il marshalling dei tipi di dati di base a COM è in genere semplice, il Boolean tipo di dati è un'eccezione. È possibile applicare l'attributo MarshalAsAttribute per effettuare il marshalling del Boolean tipo a una delle rappresentazioni seguenti:

Tipo di enumerazione Formato non gestito
UnmanagedType.Bool Valore intero a 4 byte, dove qualsiasi valore diverso da zero rappresenta true e 0 rappresenta false. Questo è il formato predefinito di un Boolean campo in una struttura e di un Boolean parametro nelle chiamate platform invoke.
UnmanagedType.U1 Valore intero a 1 byte, dove 1 rappresenta true e 0 rappresenta false.
UnmanagedType.VariantBool Valore intero a 2 byte, dove -1 rappresenta true e 0 rappresenta false. Questo è il formato predefinito di un Boolean parametro nelle chiamate di interoperabilità COM.