Boolean 構造体

定義

ブール値 (true または false) を表します。Represents a Boolean (true or false) value.

public value class Boolean : IComparable, IComparable<bool>, IConvertible, IEquatable<bool>
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public struct Boolean : IComparable, IComparable<bool>, IConvertible, IEquatable<bool>
type bool = struct
    interface IConvertible
Public Structure Boolean
Implements IComparable, IComparable(Of Boolean), IConvertible, IEquatable(Of Boolean)
継承
Boolean
属性
実装

注釈

Boolean インスタンスは、trueまたは falseの2つの値のいずれかを持つことができます。A Boolean instance can have either of two values: true, or false.

Boolean 構造体には、次のタスクをサポートするメソッドが用意されています。The Boolean structure provides methods that support the following tasks:

以下のセクションでは、これらのタスクとその他の使用方法の詳細について説明します。The following sections explain these tasks and other usage details:

ブール値の書式設定 Formatting Boolean values
ブール値との間での変換 Converting to and from Boolean values
ブール値の解析 Parsing Boolean values
ブール値の比較 Comparing Boolean values
ブール値をバイナリ値として使用する Working with Booleans as binary values
ブール値を使用した操作の実行 Performing operations with Boolean values
ブール値と相互運用Booleans and Interop

ブール値の書式設定Formatting Boolean values

Boolean の文字列形式は、true 値の場合は "True"、false 値の場合は "False" です。The string representation of a Boolean is either "True" for a true value or "False" for a false value. Boolean 値の文字列形式は、読み取り専用の TrueString および FalseString フィールドによって定義されます。The string representation of a Boolean value is defined by the read-only TrueString and FalseString fields.

ToString メソッドを使用して、ブール値を文字列に変換します。You use the ToString method to convert Boolean values to strings. ブール構造体には、パラメーターなしの ToString() メソッドと ToString(IFormatProvider) メソッドの2つの ToString オーバーロードが含まれます。これには、書式設定を制御するパラメーターが含まれます。The Boolean structure includes two ToString overloads: the parameterless ToString() method and the ToString(IFormatProvider) method, which includes a parameter that controls formatting. ただし、このパラメーターは無視されるため、2つのオーバーロードは同じ文字列を生成します。However, because this parameter is ignored, the two overloads produce identical strings. ToString(IFormatProvider) メソッドは、カルチャに依存した書式設定をサポートしていません。The ToString(IFormatProvider) method does not support culture-sensitive formatting.

次の例は、ToString メソッドを使用した書式設定を示しています。The following example illustrates formatting with the ToString method. この例では複合書式指定機能を使用しているため、ToString メソッドが暗黙的に呼び出されることに注意してください。Note that the example uses the composite formatting feature, so the ToString method is called implicitly.

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

Boolean 構造体は2つの値しか持つことができないため、カスタム書式設定を簡単に追加できます。Because the Boolean structure can have only two values, it is easy to add custom formatting. 他の文字列リテラルが "True" と "False" に置き換えられる単純なカスタム書式設定の場合C#は、の条件演算子や Visual Basic のIf 演算子など、使用している言語でサポートされている任意の条件付き評価機能を使用できます。For simple custom formatting in which other string literals are substituted for "True" and "False", you can use any conditional evaluation feature supported by your language, such as the conditional operator in C# or the If operator in Visual Basic. 次の例では、この方法を使用して、Boolean 値を "True" または "False" ではなく "No" として書式設定します。The following example uses this technique to format Boolean values as "Yes" and "No" rather than "True" and "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

カルチャに依存した書式設定など、より複雑なカスタム書式設定操作の場合は、String.Format(IFormatProvider, String, Object[]) メソッドを呼び出し、ICustomFormatter の実装を提供できます。For more complex custom formatting operations, including culture-sensitive formatting, you can call the String.Format(IFormatProvider, String, Object[]) method and provide an ICustomFormatter implementation. 次の例では、ICustomFormatter および IFormatProvider インターフェイスを実装して、英語 (米国)、フランス語 (フランス)、およびロシア語 (ロシア) のカルチャに対してカルチャに依存するブール型文字列を提供しています。The following example implements the ICustomFormatter and IFormatProvider interfaces to provide culture-sensitive Boolean strings for the English (United States), French (France), and Russian (Russia) cultures.

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': верно

必要に応じて、リソースファイルを使用して、カルチャ固有のブール型文字列を定義できます。Optionally, you can use resource files to define culture-specific Boolean strings.

ブール値との間の変換Converting to and from Boolean values

Boolean 構造体は、IConvertible インターフェイスを実装します。The Boolean structure implements the IConvertible interface. その結果、Convert クラスを使用して、.NET で Boolean 値とその他のプリミティブ型の間の変換を実行したり、Boolean 構造体の明示的な実装を呼び出したりすることができます。As a result, you can use the Convert class to perform conversions between a Boolean value and any other primitive type in .NET, or you can call the Boolean structure's explicit implementations. ただし、Boolean と次の型の間の変換はサポートされていないため、対応する変換メソッドは InvalidCastException 例外をスローします。However, conversions between a Boolean and the following types are not supported, so the corresponding conversion methods throw an InvalidCastException exception:

整数または浮動小数点数からブール値への変換はすべて、0以外の値を true に、0は falseに変換します。All conversions from integral or floating-point numbers to Boolean values convert non-zero values to true and zero values to false. 次の例は、Convert.ToBoolean クラスの選択されたオーバーロードを呼び出すことによってこれを示しています。The following example illustrates this by calling selected overloads of the Convert.ToBoolean class.

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

浮動小数点値からブール値に変換する場合、変換メソッドはゼロと正確な比較を実行します。When converting from floating-point values to Boolean values, the conversion methods perform an exact comparison with zero. 浮動小数点値の精度が失われた場合、予期しない結果になることがあります。If the floating-point value has lost precision, the result can be unexpected. これを次の例に示します。この例では、値を0に設定する Double 変数は、ブール値に変換されます。This is illustrated in the following example, in which a Double variable whose value should be zero is converted to a Boolean value. この例に示すように、0.2 が繰り返し追加されると有効桁数が失われるため、結果は true になります。As the example shows, the result is true because repeated additions of 0.2 have resulted in a loss of precision.

ブール値から数値に変換する場合、Convert クラスの変換メソッドは、true を1に変換し false 0 に変換します。When converting from Boolean to numeric values, the conversion methods of the Convert class convert true to 1 and false to 0. ただし、Visual Basic 変換関数は、true を 255 (Byte 値への変換の場合) または-1 (その他すべての数値変換の場合) に変換します。However, Visual Basic conversion functions convert true to either 255 (for conversions to Byte values) or -1 (for all other numeric conversions). 次の例では、Convert メソッドを使用して true を数値に変換します。 Visual Basic 例の場合は、Visual Basic 言語の独自の変換演算子を使用します。The following example converts true to numeric values by using a Convert method, and, in the case of the Visual Basic example, by using the Visual Basic language's own conversion operator.

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)

Boolean から文字列値への変換については、「ブール値の書式設定」を参照してください。For conversions from Boolean to string values, see the Formatting Boolean Values section. 文字列から Boolean 値への変換については、「ブール値の解析」セクションを参照してください。For conversions from strings to Boolean values, see the Parsing Boolean Values section.

ブール値の解析Parsing Boolean values

Boolean 構造体には、文字列をブール値に変換する2つの静的解析メソッド ParseTryParseが含まれています。The Boolean structure includes two static parsing methods, Parse and TryParse, that convert a string to a Boolean value. ブール値の文字列形式は、TrueStringFalseString のフィールドの値 (それぞれ "True" と "False") の値の大文字と小文字を区別しないで定義されます。The string representation of a Boolean value is defined by the case-insensitive equivalents of the values of the TrueString and FalseString fields, which are "True" and "False", respectively. つまり、正常に解析される文字列は、"True"、"False"、"True"、"False"、または大文字と小文字が混在する文字列のみです。In other words, the only strings that parse successfully are "True", "False", "true", "false", or some mixed-case equivalent. "0" や "1" などの数値文字列を正常に解析することはできません。You cannot successfully parse numeric strings such as "0" or "1". 文字列比較の実行時に、先頭または末尾の空白文字は考慮されません。Leading or trailing white-space characters are not considered when performing the string comparison.

次の例では、Parse メソッドと TryParse メソッドを使用して、いくつかの文字列を解析します。The following example uses the Parse and TryParse methods to parse a number of strings. "True" と "False" に相当する、大文字と小文字を区別しないものだけを正常に解析できることに注意してください。Note that only the case-insensitive equivalents of "True" and "False" can be successfully parsed.

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'

Visual Basic でプログラミングしている場合は、CBool 関数を使用して、数値の文字列形式をブール値に変換できます。If you are programming in Visual Basic, you can use the CBool function to convert the string representation of a number to a Boolean value. "0" は falseに変換され、0以外の値の文字列形式は trueに変換されます。"0" is converted to false, and the string representation of any non-zero value is converted to true. Visual Basic でプログラミングしていない場合は、数値文字列を数値に変換してから、ブール値に変換する必要があります。If you are not programming in Visual Basic, you must convert your numeric string to a number before converting it to a Boolean. 次の例は、整数の配列をブール値に変換することによってこれを示しています。The following example illustrates this by converting an array of integers to Boolean values.

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

ブール値の比較Comparing Boolean values

ブール値は true または falseのいずれかであるため、CompareTo メソッドを明示的に呼び出す理由はほとんどありません。これは、インスタンスが指定した値より大きいか、小さいか、または等しいかを示します。Because Boolean values are either true or false, there is little reason to explicitly call the CompareTo method, which indicates whether an instance is greater than, less than, or equal to a specified value. 通常、2つのブール変数を比較するには、Equals メソッドを呼び出すか、または言語の等値演算子を使用します。Typically, to compare two Boolean variables, you call the Equals method or use your language's equality operator.

ただし、ブール値変数とリテラルブール値 true または falseを比較する場合は、ブール値を評価した結果がそのブール値であるため、明示的な比較を行う必要はありません。However, when you want to compare a Boolean variable with the literal Boolean value true or false, it is not necessary to do an explicit comparison, because the result of evaluating a Boolean value is that Boolean value. 式の例を次に示します。For example, the expressions

if (booleanValue) {
If booleanValue Then

andand

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.

は同等ですが、2番目のはよりコンパクトです。are equivalent, but the second is more compact. ただし、どちらの方法でも、同等のパフォーマンスを実現できます。However, both techniques offer comparable performance.

ブール値をバイナリ値として使用するWorking with Booleans as binary values

ブール値として次の C# の例は 1 バイトのメモリを占有します。A Boolean value occupies one byte of memory, as the following C# example shows. 例をコンパイルする必要があります、/unsafeスイッチします。The example must be compiled with the /unsafe switch.

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

バイトの下位ビットは、その値を表すために使用されます。The byte's low-order bit is used to represent its value. 値1は trueを表します。値0は falseを表します。A value of 1 represents true; a value of 0 represents false.

警告

System.Collections.Specialized.BitVector32 構造体を使用して、ブール値のセットを操作できます。You can use the System.Collections.Specialized.BitVector32 structure to work with sets of Boolean values.

BitConverter.GetBytes(Boolean) メソッドを呼び出すことにより、ブール値をバイナリ表現に変換できます。You can convert a Boolean value to its binary representation by calling the BitConverter.GetBytes(Boolean) method. メソッドは、1つの要素を含むバイト配列を返します。The method returns a byte array with a single element. バイナリ表現からブール値を復元するには、BitConverter.ToBoolean(Byte[], Int32) メソッドを呼び出すことができます。To restore a Boolean value from its binary representation, you can call the BitConverter.ToBoolean(Byte[], Int32) method.

次の例では、BitConverter.GetBytes メソッドを呼び出して、ブール値をバイナリ表現に変換し、値の個々のビットを表示した後、BitConverter.ToBoolean メソッドを呼び出して、そのバイナリ表現から値を復元しています。The following example calls the BitConverter.GetBytes method to convert a Boolean value to its binary representation and displays the individual bits of the value, and then calls the BitConverter.ToBoolean method to restore the value from its binary representation.

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

ブール値を使用した操作の実行Performing operations with Boolean values

ここでは、アプリでブール値を使用する方法について説明します。This section illustrates how Boolean values are used in apps. 最初のセクションでは、フラグとしての使用方法について説明します。The first section discusses its use as a flag. 2番目の例では、算術演算の使用方法を示しています。The second illustrates its use for arithmetic operations.

フラグとしてのブール値Boolean values as flags

ブール変数は、何らかの条件が存在するかどうかを通知するフラグとして最もよく使用されます。Boolean variables are most commonly used as flags, to signal the presence or absence of some condition. たとえば、String.Compare(String, String, Boolean) メソッドでは、最後のパラメーター ignoreCaseは、2つの文字列の比較で大文字と小文字を区別しないか (ignoreCasetrue)、大文字と小文字を区別するか (ignoreCasefalse) を示すフラグです。For example, in the String.Compare(String, String, Boolean) method, the final parameter, ignoreCase, is a flag that indicates whether the comparison of two strings is case-insensitive (ignoreCase is true) or case-sensitive (ignoreCase is false). フラグの値は、条件付きステートメントで評価できます。The value of the flag can then be evaluated in a conditional statement.

次の例では、単純なコンソールアプリを使用して、ブール型変数をフラグとして使用する方法を示しています。The following example uses a simple console app to illustrate the use of Boolean variables as flags. このアプリは、指定されたファイル (/f スイッチ) への出力のリダイレクトを有効にするコマンドラインパラメーターを受け取り、指定されたファイルとコンソール (/b スイッチ) の両方に出力を送信できるようにします。The app accepts command-line parameters that enable output to be redirected to a specified file (the /f switch), and that enable output to be sent both to a specified file and to the console (the /b switch). このアプリでは、出力をファイルに送信するかどうかを示す isRedirected という名前のフラグと、出力をコンソールに送信することを示す isBoth という名前のフラグを定義します。The app defines a flag named isRedirected to indicate whether output is to be sent to a file, and a flag named isBoth to indicate that output should be sent to the console.

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

ブール値と算術演算Booleans and arithmetic operations

ブール値は、数値計算をトリガーする条件の存在を示すために使用されることがあります。A Boolean value is sometimes used to indicate the presence of a condition that triggers a mathematical calculation. たとえば、hasShippingCharge 変数は、請求金額に発送料金を追加するかどうかを示すフラグとして機能します。For example, a hasShippingCharge variable might serve as a flag to indicate whether to add shipping charges to an invoice amount.

false 値を持つ操作は演算の結果に影響を与えないため、このブール値を算術演算で使用する整数値に変換する必要はありません。Because an operation with a false value has no effect on the result of an operation, it is not necessary to convert the Boolean to an integral value to use in the mathematical operation. 代わりに、条件付きロジックを使用できます。Instead, you can use conditional logic.

次の例では、小計、出荷料金、およびオプションのサービス料金で構成される金額を計算します。The following example computes an amount that consists of a subtotal, a shipping charge, and an optional service charge. hasServiceCharge 変数は、サービスの料金が適用されるかどうかを決定します。The hasServiceCharge variable determines whether the service charge is applied. この例では、hasServiceCharge を数値に変換してサービス料金の量で乗算する代わりに、条件付きロジックを使用して、該当する場合にサービスの料金を追加します。Instead of converting hasServiceCharge to a numeric value and multiplying it by the amount of the service charge, the example uses conditional logic to add the service charge amount if it is applicable.

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.

ブール値と相互運用Booleans and interop

基本的なデータ型を COM にマーシャリングするのは一般に単純ですが、Boolean のデータ型は例外です。While marshaling base data types to COM is generally straightforward, the Boolean data type is an exception. MarshalAsAttribute 属性を適用して、Boolean 型を次のいずれかの表現にマーシャリングできます。You can apply the MarshalAsAttribute attribute to marshal the Boolean type to any of the following representations:

列挙型Enumeration type アンマネージ形式Unmanaged format
UnmanagedType.Bool 4バイトの整数値。0以外の値は true を表し、0は falseを表します。A 4-byte integer value, where any nonzero value represents true and 0 represents false. これは、構造体の Boolean フィールドの既定の形式であり、プラットフォーム呼び出しの Boolean パラメーターの既定の形式です。This is the default format of a Boolean field in a structure and of a Boolean parameter in platform invoke calls.
UnmanagedType.U1 1バイトの整数値。1は true を表し、0は falseを表します。A 1-byte integer value, where the 1 represents true and 0 represents false.
UnmanagedType.VariantBool 2バイトの整数値。-1 は true を表し、0は falseを表します。A 2-byte integer value, where -1 represents true and 0 represents false. これは、COM 相互運用呼び出しの Boolean パラメーターの既定の形式です。This is the default format of a Boolean parameter in COM interop calls.

フィールド

FalseString

ブール値の false を文字列として表します。Represents the Boolean value false as a string. このフィールドは読み取り専用です。This field is read-only.

TrueString

ブール値の true を文字列として表します。Represents the Boolean value true as a string. このフィールドは読み取り専用です。This field is read-only.

メソッド

CompareTo(Boolean)

このインスタンスと指定した Boolean オブジェクトを比較し、互いの関係を示す整数を返します。Compares this instance to a specified Boolean object and returns an integer that indicates their relationship to one another.

CompareTo(Object)

指定したオブジェクトとこのインスタンスを比較し、互いの関係を示す整数を返します。Compares this instance to a specified object and returns an integer that indicates their relationship to one another.

Equals(Boolean)

対象のインスタンスが、指定した Boolean オブジェクトに等しいかどうかを示す値を返します。Returns a value indicating whether this instance is equal to a specified Boolean object.

Equals(Object)

このインスタンスが指定したオブジェクトと同一であるかどうかを示す値を返します。Returns a value indicating whether this instance is equal to a specified object.

GetHashCode()

このインスタンスのハッシュ コードを返します。Returns the hash code for this instance.

GetTypeCode()

Boolean 値の型の型コードを返します。Returns the type code for the Boolean value type.

Parse(ReadOnlySpan<Char>)

論理値の指定したスパン表現を、等価の Boolean 表現に変換します。Converts the specified span representation of a logical value to its Boolean equivalent.

Parse(String)

論理値の指定した文字列形式を、それと等価な Boolean に変換します。Converts the specified string representation of a logical value to its Boolean equivalent.

ToString()

このインスタンスの値をそれと等価な文字列形式に変換します ("True" または "False")。Converts the value of this instance to its equivalent string representation (either "True" or "False").

ToString(IFormatProvider)

このインスタンスの値をそれと等価な文字列形式に変換します ("True" または "False")。Converts the value of this instance to its equivalent string representation (either "True" or "False").

TryFormat(Span<Char>, Int32)

現在のブール型インスタンスの値を、指定した文字スパンに書式設定しようとします。Tries to format the value of the current boolean instance into the provided span of characters.

TryParse(ReadOnlySpan<Char>, Boolean)

論理値の指定したスパン表現を、等価の Boolean に変換します。Tries to convert the specified span representation of a logical value to its Boolean equivalent.

TryParse(String, Boolean)

論理値の指定した文字列形式を等価の Boolean に変換します。Tries to convert the specified string representation of a logical value to its Boolean equivalent.

明示的なインターフェイスの実装

IComparable.CompareTo(Object)
IConvertible.GetTypeCode()
IConvertible.ToBoolean(IFormatProvider)

このメンバーの詳細については、「ToBoolean(IFormatProvider)」をご覧ください。For a description of this member, see ToBoolean(IFormatProvider).

IConvertible.ToByte(IFormatProvider)

このメンバーの詳細については、「ToByte(IFormatProvider)」をご覧ください。For a description of this member, see ToByte(IFormatProvider).

IConvertible.ToChar(IFormatProvider)

この変換はサポートされていません。This conversion is not supported. このメソッドを使用しようとすると、InvalidCastException がスローされます。Attempting to use this method throws an InvalidCastException.

IConvertible.ToDateTime(IFormatProvider)

この変換はサポートされていません。This conversion is not supported. このメソッドを使用しようとすると、InvalidCastException がスローされます。Attempting to use this method throws an InvalidCastException.

IConvertible.ToDecimal(IFormatProvider)

このメンバーの詳細については、「ToDecimal(IFormatProvider)」をご覧ください。For a description of this member, see ToDecimal(IFormatProvider).

IConvertible.ToDouble(IFormatProvider)

このメンバーの詳細については、「ToDouble(IFormatProvider)」をご覧ください。For a description of this member, see ToDouble(IFormatProvider).

IConvertible.ToInt16(IFormatProvider)

このメンバーの詳細については、「ToInt16(IFormatProvider)」をご覧ください。For a description of this member, see ToInt16(IFormatProvider).

IConvertible.ToInt32(IFormatProvider)

このメンバーの詳細については、「ToInt32(IFormatProvider)」をご覧ください。For a description of this member, see ToInt32(IFormatProvider).

IConvertible.ToInt64(IFormatProvider)

このメンバーの詳細については、「ToInt64(IFormatProvider)」をご覧ください。For a description of this member, see ToInt64(IFormatProvider).

IConvertible.ToSByte(IFormatProvider)

このメンバーの詳細については、「ToSByte(IFormatProvider)」をご覧ください。For a description of this member, see ToSByte(IFormatProvider).

IConvertible.ToSingle(IFormatProvider)

このメンバーの詳細については、「ToSingle(IFormatProvider)」をご覧ください。For a description of this member, see ToSingle(IFormatProvider).

IConvertible.ToString(IFormatProvider)
IConvertible.ToType(Type, IFormatProvider)

このメンバーの詳細については、「ToType(Type, IFormatProvider)」をご覧ください。For a description of this member, see ToType(Type, IFormatProvider).

IConvertible.ToUInt16(IFormatProvider)

このメンバーの詳細については、「ToUInt16(IFormatProvider)」をご覧ください。For a description of this member, see ToUInt16(IFormatProvider).

IConvertible.ToUInt32(IFormatProvider)

このメンバーの詳細については、「ToUInt32(IFormatProvider)」をご覧ください。For a description of this member, see ToUInt32(IFormatProvider).

IConvertible.ToUInt64(IFormatProvider)

このメンバーの詳細については、「ToUInt64(IFormatProvider)」をご覧ください。For a description of this member, see ToUInt64(IFormatProvider).

適用対象

スレッド セーフ

この型のすべてのメンバーは、スレッドセーフです。All members of this type are thread safe. インスタンスの状態を変更するように見えるメンバーは、実際には新しい値で初期化された新しいインスタンスを返します。Members that appear to modify instance state actually return a new instance initialized with the new value. 他の型と同様に、この型のインスタンスを含む共有変数の読み取りと書き込みは、スレッドセーフを保証するためにロックによって保護される必要があります。As with any other type, reading and writing to a shared variable that contains an instance of this type must be protected by a lock to guarantee thread safety.