Boolean Estructura

Definición

Representa un valor booleano (true o false).

public value class bool : IComparable, IComparable<bool>, IConvertible, IEquatable<bool>
public value class bool : IComparable, IConvertible
public value class bool : IComparable, IComparable<bool>, IEquatable<bool>
public struct Boolean : IComparable, IComparable<bool>, IConvertible, IEquatable<bool>
[System.Serializable]
public struct Boolean : IComparable, IConvertible
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public struct Boolean : IComparable, IComparable<bool>, IConvertible, IEquatable<bool>
public struct Boolean : IComparable, IComparable<bool>, IEquatable<bool>
type bool = struct
    interface IConvertible
[<System.Serializable>]
type bool = struct
    interface IConvertible
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type bool = struct
    interface IConvertible
type bool = struct
Public Structure Boolean
Implements IComparable, IComparable(Of Boolean), IConvertible, IEquatable(Of Boolean)
Public Structure Boolean
Implements IComparable, IConvertible
Public Structure Boolean
Implements IComparable, IComparable(Of Boolean), IEquatable(Of Boolean)
Herencia
Boolean
Atributos
Implementaciones

Comentarios

Una Boolean instancia de puede tener dos valores: o true false .

La Boolean estructura proporciona métodos que admiten las tareas siguientes:

En las secciones siguientes se explican estas tareas y otros detalles de uso:

Dar formato a valores booleanos

La representación de cadena Boolean de es "True" para un true valor o "False" para un false valor. La representación de cadena de Boolean un valor se define mediante los campos y de solo TrueString FalseString lectura.

Use el método ToString para convertir valores booleanos en cadenas. La estructura booleana incluye dos sobrecargas: el método sin parámetros y el método , que ToString incluye un parámetro que controla el ToString() ToString(IFormatProvider) formato. Sin embargo, dado que este parámetro se omite, las dos sobrecargas generan cadenas idénticas. El ToString(IFormatProvider) método no admite el formato que distingue la referencia cultural.

En el ejemplo siguiente se muestra el formato con el ToString método . Tenga en cuenta que en el ejemplo se usa la característica de formato compuesto, por lo que se llama ToString implícitamente al método .

using System;

public class Example
{
   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
Module Example
   Public Sub Main()
      Dim raining As Boolean = False
      Dim busLate As Boolean = True

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

Dado que Boolean la estructura solo puede tener dos valores, es fácil agregar formato personalizado. Para un formato personalizado simple en el que otros literales de cadena se sustituyen por "True" y "False", puede usar cualquier característica de evaluación condicional compatible con su lenguaje, como el operador condicional en C# o el operador If en Visual Basic. En el ejemplo siguiente se usa esta técnica para dar formato a los valores Boolean como "Yes" y "No" en lugar de "True" y "False".

using System;

public class Example
{
   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
Module Example
   Public Sub Main()
      Dim raining As Boolean = False
      Dim busLate As Boolean = True

      Console.WriteLine("It is raining: {0}", 
                        If(raining, "Yes", "No"))
      Console.WriteLine("The bus is late: {0}", 
                        If(busLate, "Yes", "No"))
   End Sub
End Module
' The example displays the following output:
'       It is raining: No
'       The bus is late: Yes

Para operaciones de formato personalizadas más complejas, incluido el formato que tiene en cuenta la referencia cultural, puede llamar al método String.Format(IFormatProvider, String, Object[]) y proporcionar una ICustomFormatter implementación. En el ejemplo siguiente se implementan las interfaces y para proporcionar cadenas booleanas que tienen en cuenta la referencia cultural para las culturas inglés (Estados Unidos), francés (Francia) y ruso ICustomFormatter IFormatProvider (Rusia).

using System;
using System.Globalization;

public class Example
{
   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': верно
Imports System.Globalization

Module Example
   Public Sub Main()
      Dim cultureNames() As String = { "", "en-US", "fr-FR", "ru-RU" }
      For Each cultureName In cultureNames
         Dim value As Boolean = True
         Dim culture As CultureInfo = CultureInfo.CreateSpecificCulture(cultureName)
         Dim formatter As New BooleanFormatter(culture)
         
         Dim result As String = String.Format(formatter, "Value for '{0}': {1}", culture.Name, value)
         Console.WriteLine(result)
      Next
   End Sub
End Module

Public Class BooleanFormatter 
   Implements ICustomFormatter, IFormatProvider
   
   Private culture As CultureInfo
   
   Public Sub New()
      Me.New(CultureInfo.CurrentCulture)
   End Sub
   
   Public Sub New(culture As CultureInfo)
      Me.culture = culture 
   End Sub
   
   Public Function GetFormat(formatType As Type) As Object _
                   Implements IFormatProvider.GetFormat
      If formatType Is GetType(ICustomFormatter) Then
         Return Me
      Else
         Return Nothing
      End If                
   End Function
   
   Public Function Format(fmt As String, arg As Object, 
                          formatProvider As IFormatProvider) As String _
                   Implements ICustomFormatter.Format
      ' Exit if another format provider is used.
      If Not formatProvider.Equals(Me) Then Return Nothing
      
      ' Exit if the type to be formatted is not a Boolean
      If Not TypeOf arg Is Boolean Then Return Nothing
      
      Dim value As Boolean = CBool(arg)
      Select culture.Name
         Case "en-US"
            Return value.ToString()
         Case "fr-FR"
            If value Then
               Return "vrai"
            Else
               Return "faux"
            End If      
         Case "ru-RU"
            If value Then
               Return "верно"
            Else
               Return "неверно"
            End If   
         Case Else
            Return value.ToString()  
      End Select
   End Function
End Class
' The example displays the following output:
'          Value for '': True
'          Value for 'en-US': True
'          Value for 'fr-FR': vrai
'          Value for 'ru-RU': верно

Opcionalmente, puede usar archivos de recursos para definir cadenas booleanas específicas de la referencia cultural.

Conversión a y desde valores booleanos

La Boolean estructura implementa la interfaz IConvertible . Como resultado, puede usar la clase para realizar conversiones entre un valor y cualquier otro tipo primitivo en .NET, o puede llamar a las implementaciones Convert Boolean Boolean explícitas de la estructura. Sin embargo, no se admiten conversiones entre y los siguientes tipos, por lo que los métodos de Boolean conversión correspondientes inician una InvalidCastException excepción:

Todas las conversiones de números enteros o de punto flotante a valores booleanos convierten valores distintos de cero en true valores y cero en false . En el ejemplo siguiente se muestra esto mediante una llamada a las sobrecargas seleccionadas de la Convert.ToBoolean clase .

using System;

public class Example
{
   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
Module Example
   Public Sub Main()
      Dim byteValue As Byte = 12
      Console.WriteLine(Convert.ToBoolean(byteValue))
      Dim byteValue2 As Byte = 0
      Console.WriteLine(Convert.ToBoolean(byteValue2))
      Dim intValue As Integer = -16345
      Console.WriteLine(Convert.ToBoolean(intValue))
      Dim longValue As Long = 945
      Console.WriteLine(Convert.ToBoolean(longValue))
      Dim sbyteValue As SByte = -12
      Console.WriteLine(Convert.ToBoolean(sbyteValue))
      Dim dblValue As Double = 0
      Console.WriteLine(Convert.ToBoolean(dblValue))
      Dim sngValue As Single = .0001
      Console.WriteLine(Convert.ToBoolean(sngValue))
   End Sub
End Module
' The example displays the following output:
'       True
'       False
'       True
'       True
'       True
'       False
'       True

Al convertir valores booleanos a numéricos, los métodos de conversión de la Convert clase se true convierten en 1 false y en 0. Sin embargo, Visual Basic de conversión se convierten en 255 (para conversiones a valores) o -1 (para todas las true demás conversiones Byte numéricas). En el ejemplo siguiente se convierte en valores numéricos mediante un método y, en el caso del ejemplo Visual Basic, mediante el operador de conversión propio del lenguaje true Convert Visual Basic.

using System;

public class Example
{
   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
Module Example
   Public Sub Main()
      Dim flag As Boolean = true
      
      Dim byteValue As Byte   
      byteValue = Convert.ToByte(flag)
      Console.WriteLine("{0} -> {1} ({2})", flag, byteValue, 
                                            byteValue.GetType().Name)         
      byteValue = CByte(flag)
      Console.WriteLine("{0} -> {1} ({2})", flag, byteValue, 
                                            byteValue.GetType().Name)         
      
      Dim sbyteValue As SByte
      sbyteValue = Convert.ToSByte(flag)
      Console.WriteLine("{0} -> {1} ({2})", flag, sbyteValue, 
                                            sbyteValue.GetType().Name)         
      sbyteValue = CSByte(flag)
      Console.WriteLine("{0} -> {1} ({2})", flag, sbyteValue, 
                                            sbyteValue.GetType().Name)         

      Dim dblValue As Double
      dblValue = Convert.ToDouble(flag)
      Console.WriteLine("{0} -> {1} ({2})", flag, dblValue, 
                                            dblValue.GetType().Name)         
      dblValue = CDbl(flag)
      Console.WriteLine("{0} -> {1} ({2})", flag, dblValue, 
                                            dblValue.GetType().Name)         

      Dim intValue As Integer
      intValue = Convert.ToInt32(flag)
      Console.WriteLine("{0} -> {1} ({2})", flag, intValue, 
                                            intValue.GetType().Name)         
      intValue = CInt(flag)
      Console.WriteLine("{0} -> {1} ({2})", flag, intValue, 
                                            intValue.GetType().Name)         
   End Sub
End Module
' The example displays the following output:
'       True -> 1 (Byte)
'       True -> 255 (Byte)
'       True -> 1 (SByte)
'       True -> -1 (SByte)
'       True -> 1 (Double)
'       True -> -1 (Double)
'       True -> 1 (Int32)
'       True -> -1 (Int32)

Para obtener conversiones de Boolean a valores de cadena, vea la sección Aplicar formato a valores booleanos. Para las conversiones de cadenas a Boolean valores, vea la sección Análisis de valores booleanos.

Análisis de valores booleanos

La Boolean estructura incluye dos métodos de análisis estáticos, y , que Parse TryParse convierten una cadena en un valor booleano. La representación de cadena de un valor booleano se define mediante los equivalentes sin mayúsculas de minúsculas de los valores de los campos y , que son TrueString FalseString "True" y "False", respectivamente. En otras palabras, las únicas cadenas que se analizan correctamente son "True", "False", "true", "false" o algún equivalente de mayúsculas y minúsculas mixtas. No se pueden analizar correctamente cadenas numéricas como "0" o "1". Los caracteres de espacio en blanco iniciales o finales no se tienen en cuenta al realizar la comparación de cadenas.

En el ejemplo siguiente se usan Parse los TryParse métodos y para analizar varias cadenas. Tenga en cuenta que solo se pueden analizar correctamente los equivalentes que no tienen en cuenta mayúsculas de minúsculas de "True" y "False".

using System;

public class Example
{
   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'
Module Example
   Public Sub Main()
      Dim values() As String = { Nothing, String.Empty, "True", "False", 
                                 "true", "false", "    true    ", 
                                 "TrUe", "fAlSe", "fa lse", "0", 
                                 "1", "-1", "string" }
      ' Parse strings using the Boolean.Parse method.                    
      For Each value In values
         Try
            Dim flag As Boolean = Boolean.Parse(value)
            Console.WriteLine("'{0}' --> {1}", value, flag)
         Catch e As ArgumentException
            Console.WriteLine("Cannot parse a null string.")
         Catch e As FormatException
            Console.WriteLine("Cannot parse '{0}'.", value)
         End Try         
      Next  
      Console.WriteLine()
      ' Parse strings using the Boolean.TryParse method.                    
      For Each value In values
         Dim flag As Boolean = False
         If Boolean.TryParse(value, flag)
            Console.WriteLine("'{0}' --> {1}", value, flag)
         Else
            Console.WriteLine("Cannot parse '{0}'.", value)
         End If         
      Next  
   End Sub
End Module
' 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'

Si está programando en Visual Basic, puede usar la función para convertir la representación de cadena de CBool un número en un valor booleano. "0" se convierte en y la representación de cadena de cualquier valor distinto de cero false se convierte en true . Si no está programando en Visual Basic, debe convertir la cadena numérica en un número antes de convertirla en un valor booleano. En el ejemplo siguiente se muestra esto mediante la conversión de una matriz de enteros en valores booleanos.

using System;

public class Example
{
   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
Module Example
   Public Sub Main()
      Dim values() As String = { "09", "12.6", "0", "-13 " }
      For Each value In values
         Dim success, result As Boolean
         Dim number As Integer 
         success = Int32.TryParse(value, number)
         If success Then
            ' 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)
         End If         
      Next
   End Sub
End Module
' The example displays the following output:
'       Converted '09' to True
'       Unable to convert '12.6'
'       Converted '0' to False
'       Converted '-13 ' to True

Comparación de valores booleanos

Dado que los valores booleanos son o , hay poca razón para llamar explícitamente al método , lo que indica si una instancia es mayor, menor o igual que un true false valor CompareTo especificado. Normalmente, para comparar dos variables booleanas, se llama al Equals método o se usa el operador de igualdad del lenguaje.

Sin embargo, si desea comparar una variable booleana con el valor booleano literal o , no es necesario realizar una comparación explícita, ya que el resultado de evaluar un valor booleano es ese true false valor booleano. Por ejemplo, las expresiones

if (booleanValue == true) {
If booleanValue = True Then

y

if (booleanValue) {
If booleanValue Then

son equivalentes, pero el segundo es más compacto. Sin embargo, ambas técnicas ofrecen un rendimiento comparable.

Trabajar con valores booleanos como valores binarios

Un valor booleano ocupa un byte de memoria, como se muestra en el siguiente ejemplo de C#. El ejemplo se debe compilar con el /unsafe modificador .

using System;

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

public class Example
{
   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

El bit de orden bajo del byte se usa para representar su valor. Un valor de 1 representa true ; un valor de 0 representa false .

Sugerencia

Puede usar la estructura System.Collections.Specialized.BitVector32 para trabajar con conjuntos de valores booleanos.

Puede convertir un valor booleano en su representación binaria llamando al BitConverter.GetBytes(Boolean) método . El método devuelve una matriz de bytes con un solo elemento. Para restaurar un valor booleano a partir de su representación binaria, puede llamar al BitConverter.ToBoolean(Byte[], Int32) método .

En el ejemplo siguiente se llama al método para convertir un valor booleano en su representación binaria, se muestran los bits individuales del valor y, a continuación, se llama al método para restaurar el valor a partir de BitConverter.GetBytes BitConverter.ToBoolean su representación binaria.

using System;

public class Example
{
   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
Module Example
   Public Sub Main()
      Dim flags() As Boolean = { True, False }
      For Each flag In flags
         ' Get binary representation of flag.
         Dim value As Byte = 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.
         Dim newFlag As Boolean = BitConverter.ToBoolean( { value }, 0)
         Console.WriteLine("Restored value: {0}", flag)
         Console.WriteLine()
      Next
   End Sub
   
   Private Function GetBinaryString(value As Byte) As String
      Dim retVal As String = Convert.ToString(value, 2)
      Return New String("0"c, 8 - retVal.Length) + retVal
   End Function
End Module
' 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

Realizar operaciones con valores booleanos

En esta sección se muestra cómo se usan los valores booleanos en las aplicaciones. En la primera sección se describe su uso como marca. La segunda muestra su uso para operaciones aritméticas.

Valores booleanos como marcas

Las variables booleanas se usan normalmente como marcas para indicar la presencia o ausencia de alguna condición. Por ejemplo, en el método , el parámetro final, , es una marca que indica si la comparación de dos cadenas no distingue mayúsculas de minúsculas ( es ) o distingue mayúsculas de String.Compare(String, String, Boolean) ignoreCase minúsculas ignoreCase ( es true ignoreCase false ). A continuación, el valor de la marca se puede evaluar en una instrucción condicional.

En el ejemplo siguiente se usa una aplicación de consola sencilla para ilustrar el uso de variables booleanas como marcas. La aplicación acepta parámetros de línea de comandos que permiten redirigir la salida a un archivo especificado (el modificador ) y que permiten enviar la salida a un archivo especificado y a la consola /f (el /b modificador ). La aplicación define una marca denominada para indicar si la salida se va a enviar a un archivo y una marca denominada para indicar que la salida se debe enviar isRedirected a isBoth la consola.

using System;
using System.IO;
using System.Threading;

public class Example
{
   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");
   }
}
Imports System.IO
Imports System.Threading

Module Example
   Public Sub Main()
      ' Initialize flag variables.
      Dim isRedirected, isBoth As Boolean 
      Dim fileName As String = ""
      Dim sw As StreamWriter = Nothing
      
      ' Get any command line arguments.
      Dim args() As String = Environment.GetCommandLineArgs()
      ' Handle any arguments.
      If args.Length > 1 Then
         For ctr = 1 To args.Length - 1
            Dim arg As String = args(ctr)
            If arg.StartsWith("/") OrElse arg.StartsWith("-") Then
               Select Case arg.Substring(1).ToLower()
                  Case "f"
                     isRedirected = True
                     If args.Length < ctr + 2 Then
                        ShowSyntax("The /f switch must be followed by a filename.")
                        Exit Sub
                     End If
                     fileName = args(ctr + 1)
                     ctr += 1
                  Case "b"
                     isBoth = True
                  Case Else
                     ShowSyntax(String.Format("The {0} switch is not supported", 
                                              args(ctr)))
                     Exit Sub
               End Select
            End If   
         Next
      End If

      ' If isBoth is True, isRedirected must be True.
      If isBoth And Not isRedirected Then 
         ShowSyntax("The /f switch must be used if /b is used.")
         Exit Sub
      End If

      ' Handle output.
      If isRedirected Then
         sw = New StreamWriter(fileName) 
         If Not IsBoth Then
            Console.SetOut(sw) 
         End If
      End If     
      Dim msg As String = String.Format("Application began at {0}", Date.Now)
      Console.WriteLine(msg)
      If isBoth Then sw.WriteLine(msg)
      Thread.Sleep(5000)
      msg = String.Format("Application ended normally at {0}", Date.Now)
      Console.WriteLine(msg)
      If isBoth Then sw.WriteLine(msg)
      If isRedirected Then sw.Close()
   End Sub
   
   Private Sub ShowSyntax(errMsg As String)
      Console.WriteLine(errMsg)
      Console.WriteLine()
      Console.WriteLine("Syntax: Example [[/f <filename> [/b]]")
      Console.WriteLine()
   End Sub
End Module

Booleanos y operaciones aritméticas

A veces se usa un valor booleano para indicar la presencia de una condición que desencadena un cálculo matemático. Por ejemplo, una variable podría servir como marca para indicar si se deben agregar cargos hasShippingCharge de envío a un importe de factura.

Dado que una operación con un valor no tiene ningún efecto en el resultado de una operación, no es necesario convertir el valor booleano en un valor entero para usarlo en false la operación matemática. En su lugar, puede usar la lógica condicional.

En el ejemplo siguiente se calcula una cantidad que consta de un subtotal, un cargo de envío y un cargo de servicio opcional. La hasServiceCharge variable determina si se aplica el cargo de servicio. En lugar de convertir en un valor numérico y multiplicarlo por la cantidad del cargo de servicio, en el ejemplo se usa lógica condicional para agregar el importe del cargo del servicio si hasServiceCharge es aplicable.

using System;

public class Example
{
   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.
Module Example
   Public Sub Main()
      Dim hasServiceCharges() As Boolean = { True, False }
      Dim subtotal As Decimal = 120.62d
      Dim shippingCharge As Decimal = 2.50d
      Dim serviceCharge As Decimal = 5.00d
      
      For Each hasServiceCharge In hasServiceCharges
         Dim total As Decimal = subtotal + shippingCharge + 
                                If(hasServiceCharge, serviceCharge, 0)
         Console.WriteLine("hasServiceCharge = {1}: The total is {0:C2}.", 
                           total, hasServiceCharge)                       
      Next
   End Sub
End Module
' The example displays output like the following:
'       hasServiceCharge = True: The total is $128.12.
'       hasServiceCharge = False: The total is $123.12.

Valores booleanos e interoperabilidad

Aunque la serialización de tipos de datos base a COM suele ser sencilla, el Boolean tipo de datos es una excepción. Puede aplicar el atributo MarshalAsAttribute para serializar el Boolean tipo a cualquiera de las siguientes representaciones:

Tipo de enumeración Formato no administrado
UnmanagedType.Bool Valor entero de 4 bytes, donde cualquier valor distinto de cero representa true y 0 representa false . Este es el formato predeterminado de un campo Boolean en una estructura y de un parámetro en llamadas de Boolean invocación de plataforma.
UnmanagedType.U1 Valor entero de 1 byte, donde 1 representa true y 0 representa false .
UnmanagedType.VariantBool Valor entero de 2 bytes, donde -1 representa true y 0 representa false . Este es el formato predeterminado de un Boolean parámetro en llamadas de interoperabilidad COM.

Campos

FalseString

Representa el valor booleano false como una cadena. Este campo es de solo lectura.

TrueString

Representa el valor booleano true como una cadena. Este campo es de solo lectura.

Métodos

CompareTo(Boolean)

Compara esta instancia con un objeto Boolean especificado y devuelve un entero que indica la relación entre ambos.

CompareTo(Object)

Compara esta instancia con un objeto especificado y devuelve un entero que indica la relación entre ambos.

Equals(Boolean)

Devuelve un valor que indica si esta instancia equivale a un objeto Boolean especificado.

Equals(Object)

Devuelve un valor que indica si esta instancia equivale a un objeto especificado.

GetHashCode()

Devuelve el código hash de esta instancia.

GetTypeCode()

Devuelve el código de tipo para el tipo de valor Boolean.

Parse(ReadOnlySpan<Char>)

Convierte la representación del intervalo especificado de un valor lógico en su valor Boolean equivalente.

Parse(String)

Convierte la representación de cadena especificada de un valor lógico en su valor Boolean equivalente.

ToString()

Convierte el valor de esta instancia en la representación de cadena equivalente ("True" o "False").

ToString(IFormatProvider)

Convierte el valor de esta instancia en la representación de cadena equivalente ("True" o "False").

TryFormat(Span<Char>, Int32)

Intenta dar formato al valor de la instancia booleana actual en el intervalo de caracteres proporcionado.

TryParse(ReadOnlySpan<Char>, Boolean)

Intenta convertir la representación del intervalo especificado de un valor lógico en su valor Boolean equivalente.

TryParse(String, Boolean)

Intenta convertir la representación de cadena que se haya especificado para un valor lógico en su valor Boolean equivalente.

Implementaciones de interfaz explícitas

IComparable.CompareTo(Object)

Compara la instancia actual con otro objeto del mismo tipo y devuelve un entero que indica si la posición de la instancia actual es anterior, posterior o igual que la del otro objeto en el criterio de ordenación.

IConvertible.GetTypeCode()

Devuelve el TypeCode para esta instancia.

IConvertible.ToBoolean(IFormatProvider)

Para obtener una descripción de este miembro, vea ToBoolean(IFormatProvider).

IConvertible.ToByte(IFormatProvider)

Para obtener una descripción de este miembro, vea ToByte(IFormatProvider).

IConvertible.ToChar(IFormatProvider)

No se admite esta conversión. Cualquier intento de usar este método produce una excepción InvalidCastException.

IConvertible.ToDateTime(IFormatProvider)

No se admite esta conversión. Cualquier intento de usar este método produce una excepción InvalidCastException.

IConvertible.ToDecimal(IFormatProvider)

Para obtener una descripción de este miembro, vea ToDecimal(IFormatProvider).

IConvertible.ToDouble(IFormatProvider)

Para obtener una descripción de este miembro, vea ToDouble(IFormatProvider).

IConvertible.ToInt16(IFormatProvider)

Para obtener una descripción de este miembro, vea ToInt16(IFormatProvider).

IConvertible.ToInt32(IFormatProvider)

Para obtener una descripción de este miembro, vea ToInt32(IFormatProvider).

IConvertible.ToInt64(IFormatProvider)

Para obtener una descripción de este miembro, vea ToInt64(IFormatProvider).

IConvertible.ToSByte(IFormatProvider)

Para obtener una descripción de este miembro, vea ToSByte(IFormatProvider).

IConvertible.ToSingle(IFormatProvider)

Para obtener una descripción de este miembro, vea ToSingle(IFormatProvider).

IConvertible.ToString(IFormatProvider)

Convierte el valor de esta instancia en una cadena equivalente mediante el uso de la información de formato específica de la referencia cultural establecida.

IConvertible.ToType(Type, IFormatProvider)

Para obtener una descripción de este miembro, vea ToType(Type, IFormatProvider).

IConvertible.ToUInt16(IFormatProvider)

Para obtener una descripción de este miembro, vea ToUInt16(IFormatProvider).

IConvertible.ToUInt32(IFormatProvider)

Para obtener una descripción de este miembro, vea ToUInt32(IFormatProvider).

IConvertible.ToUInt64(IFormatProvider)

Para obtener una descripción de este miembro, vea ToUInt64(IFormatProvider).

Se aplica a

Seguridad para subprocesos

Todos los miembros de este tipo son seguros para subprocesos. Los miembros que parecen modificar el estado de instancia devuelven realmente una nueva instancia inicializada con el nuevo valor. Al igual que con cualquier otro tipo, la lectura y escritura en una variable compartida que contiene una instancia de este tipo debe protegerse mediante un bloqueo para garantizar la seguridad de los subprocesos.