Auf Englisch lesen

Freigeben über


Convert.ToBoolean Methode

Definition

Konvertiert einen angegebenen Wert in einen entsprechenden booleschen Wert.

Überlädt

ToBoolean(SByte)

Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl mit Vorzeichen in einen entsprechenden booleschen Wert.

ToBoolean(String, IFormatProvider)

Konvertiert die angegebene Zeichenfolgendarstellung eines logischen Werts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in seine boolesche Entsprechung.

ToBoolean(Object, IFormatProvider)

Konvertiert den Wert des angegebenen Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in einen entsprechenden booleschen Wert.

ToBoolean(UInt64)

Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl ohne Vorzeichen in einen entsprechenden booleschen Wert.

ToBoolean(UInt32)

Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl ohne Vorzeichen in einen entsprechenden booleschen Wert.

ToBoolean(UInt16)

Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl ohne Vorzeichen in einen entsprechenden booleschen Wert.

ToBoolean(String)

Konvertiert die angegebene Zeichenfolgendarstellung eines logischen Werts in seine boolesche Entsprechung.

ToBoolean(Single)

Konvertiert den Wert der angegebenen Gleitkommazahl mit einfacher Genauigkeit in einen entsprechenden booleschen Wert.

ToBoolean(Object)

Konvertiert den Wert eines angegebenen Objekts in einen entsprechenden booleschen Wert.

ToBoolean(DateTime)

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.

ToBoolean(Int32)

Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl mit Vorzeichen in einen entsprechenden booleschen Wert.

ToBoolean(Int16)

Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl mit Vorzeichen in einen entsprechenden booleschen Wert.

ToBoolean(Double)

Konvertiert den Wert der angegebenen Gleitkommazahl mit doppelter Genauigkeit in einen entsprechenden booleschen Wert.

ToBoolean(Decimal)

Konvertiert den Wert der angegebenen Dezimalzahl in einen entsprechenden booleschen Wert.

ToBoolean(Char)

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.

ToBoolean(Byte)

Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl ohne Vorzeichen in einen entsprechenden booleschen Wert.

ToBoolean(Boolean)

Gibt den angegebenen booleschen Wert zurück. Es wird keine wirkliche Konvertierung durchgeführt.

ToBoolean(Int64)

Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl mit Vorzeichen in einen entsprechenden booleschen Wert.

ToBoolean(SByte)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl mit Vorzeichen in einen entsprechenden booleschen Wert.

[System.CLSCompliant(false)]
public static bool ToBoolean (sbyte value);

Parameter

value
SByte

Die zu konvertierende 8-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

true, wenn value nicht 0 (null) ist, andernfalls false.

Attribute

Beispiele

Im folgenden Beispiel wird ein Array von SByte Werten in Boolean Werte konvertiert.

sbyte[] numbers = { SByte.MinValue, -1, 0, 10, 100, SByte.MaxValue };
bool result;

foreach (sbyte number in numbers)
{
   result = Convert.ToBoolean(number);
   Console.WriteLine("{0,-5}  -->  {1}", number, result);
}
// The example displays the following output:
//       -128   -->  True
//       -1     -->  True
//       0      -->  False
//       10     -->  True
//       100    -->  True
//       127    -->  True

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBoolean(String, IFormatProvider)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Konvertiert die angegebene Zeichenfolgendarstellung eines logischen Werts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in seine boolesche Entsprechung.

public static bool ToBoolean (string value, IFormatProvider provider);
public static bool ToBoolean (string? value, IFormatProvider? provider);

Parameter

value
String

Eine Zeichenfolge, die den Wert TrueString oder FalseString enthält.

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt. Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende 32-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

true, wenn value gleich TrueString ist, oder false, wenn value gleich FalseString oder null ist.

Ausnahmen

value ist ungleich TrueString oder FalseString.

Hinweise

Wenn Sie keine Ausnahme behandeln möchten, wenn die Konvertierung fehlschlägt, können Sie stattdessen die Boolean.TryParse -Methode aufrufen. Er gibt einen Boolean Wert zurück, der angibt, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBoolean(Object, IFormatProvider)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Konvertiert den Wert des angegebenen Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in einen entsprechenden booleschen Wert.

public static bool ToBoolean (object value, IFormatProvider provider);
public static bool ToBoolean (object? value, IFormatProvider? provider);

Parameter

value
Object

Ein Objekt, das die IConvertible-Schnittstelle implementiert, oder null.

provider
IFormatProvider

Ein Objekt, das kulturspezifische Formatierungsinformationen bereitstellt.

Gibt zurück

true oder false. Damit wird der Wert wiedergegeben, der beim Aufrufen der ToBoolean(IFormatProvider)-Methode für den zugrunde liegenden Typ von value zurückgegeben wird. Wenn value gleich null ist, gibt die Methode false zurück.

Ausnahmen

value ist eine Zeichenfolge, die nicht gleich TrueString oder FalseString ist.

Die IConvertible-Schnittstelle wird von value nicht implementiert.

- oder -

Die Konvertierung von value in Boolean wird nicht unterstützt.

Beispiele

Im folgenden Beispiel werden eine Klasse definiert, die implementiert IConvertible , und eine Klasse, die implementiert IFormatProvider. Objekte der -Klasse, die implementiert IConvertible , enthalten ein Array von Double Werten. Ein Objekt jeder Klasse wird an die ToBoolean(Object, IFormatProvider) -Methode übergeben. Diese Methode gibt zurück true , wenn einer der nicht verworfenen Arraywerte ungleich 0 (null) ist. Das IFormatProvider -Objekt bestimmt, wie Elemente für diese Berechnung verworfen werden.

using System;
using System.Collections;

// Define the types of averaging available in the class
// implementing IConvertible.
public enum AverageType : short
{
    None = 0,
    GeometricMean = 1,
    ArithmeticMean = 2,
    Median = 3
};

// Pass an instance of this class to methods that require an
// IFormatProvider. The class instance determines the type of
// average to calculate.
public class AverageInfo : IFormatProvider
{
    protected AverageType AvgType;

    // Specify the type of averaging in the constructor.
    public AverageInfo( AverageType avgType )
    {
        this.AvgType = avgType;
    }

    // This method returns a reference to the containing object
    // if an object of AverageInfo type is requested.
    public object GetFormat( Type argType )
    {
        if ( argType == typeof( AverageInfo ) )
            return this;
        else
            return null;
    }

    // Use this property to set or get the type of averaging.
    public AverageType TypeOfAverage
    {
        get { return this.AvgType; }
        set { this.AvgType = value; }
    }
}

// This class encapsulates an array of double values and implements
// the IConvertible interface. Most of the IConvertible methods
// return an average of the array elements in one of three types:
// arithmetic mean, geometric mean, or median.
public class DataSet : IConvertible
{
    protected ArrayList     data;
    protected AverageInfo   defaultProvider;

    // Construct the object and add an initial list of values.
    // Create a default format provider.
    public DataSet( params double[ ] values )
    {
        data = new ArrayList( values );
        defaultProvider =
            new AverageInfo( AverageType.ArithmeticMean );
    }

    // Add additional values with this method.
    public int Add( double value )
    {
        data.Add( value );
        return data.Count;
    }

    // Get, set, and add values with this indexer property.
    public double this[ int index ]
    {
        get
        {
            if( index >= 0 && index < data.Count )
                return (double)data[ index ];
            else
                throw new InvalidOperationException(
                    "[DataSet.get] Index out of range." );
        }
        set
        {
            if( index >= 0 && index < data.Count )
                data[ index ] = value;

            else if( index == data.Count )
                data.Add( value );
            else
                throw new InvalidOperationException(
                    "[DataSet.set] Index out of range." );
        }
    }

    // This property returns the number of elements in the object.
    public int Count
    {
        get { return data.Count; }
    }

    // This method calculates the average of the object's elements.
    protected double Average( AverageType avgType )
    {
        double  SumProd;

        if( data.Count == 0 )
            return 0.0;

        switch( avgType )
        {
            case AverageType.GeometricMean:

                SumProd = 1.0;
                for( int Index = 0; Index < data.Count; Index++ )
                    SumProd *= (double)data[ Index ];

                // This calculation will not fail with negative
                // elements.
                return Math.Sign( SumProd ) * Math.Pow(
                    Math.Abs( SumProd ), 1.0 / data.Count );

            case AverageType.ArithmeticMean:

                SumProd = 0.0;
                for( int Index = 0; Index < data.Count; Index++ )
                    SumProd += (double)data[ Index ];

                return SumProd / data.Count;

            case AverageType.Median:

                if( data.Count % 2 == 0 )
                    return ( (double)data[ data.Count / 2 ] +
                        (double)data[ data.Count / 2 - 1 ] ) / 2.0;
                else
                    return (double)data[ data.Count / 2 ];

            default:
                return 0.0;
        }
    }

    // Get the AverageInfo object from the caller's format provider,
    // or use the local default.
    protected AverageInfo GetAverageInfo( IFormatProvider provider )
    {
        AverageInfo avgInfo = null;

        if( provider != null )
            avgInfo = (AverageInfo)provider.GetFormat(
                typeof( AverageInfo ) );

        if ( avgInfo == null )
            return defaultProvider;
        else
            return avgInfo;
    }

    // Calculate the average and limit the range.
    protected double CalcNLimitAverage( double min, double max,
        IFormatProvider provider )
    {
        // Get the format provider and calculate the average.
        AverageInfo avgInfo = GetAverageInfo( provider );
        double avg = Average( avgInfo.TypeOfAverage );

        // Limit the range, based on the minimum and maximum values
        // for the type.
        return avg > max ? max : avg < min ? min : avg;
    }

    // The following elements are required by IConvertible.

    // None of these conversion functions throw exceptions. When
    // the data is out of range for the type, the appropriate
    // MinValue or MaxValue is used.
    public TypeCode GetTypeCode( )
    {
        return TypeCode.Object;
    }

    public bool ToBoolean( IFormatProvider provider )
    {
        // ToBoolean is false if the dataset is empty.
        if( data.Count <= 0 )
        {
            return false;
        }

        // For median averaging, ToBoolean is true if any
        // non-discarded elements are nonzero.
        else if( AverageType.Median ==
            GetAverageInfo( provider ).TypeOfAverage )
        {
            if (data.Count % 2 == 0 )
                return ( (double)data[ data.Count / 2 ] != 0.0 ||
                    (double)data[ data.Count / 2 - 1 ] != 0.0 );
            else
                return (double)data[ data.Count / 2 ] != 0.0;
        }

        // For arithmetic or geometric mean averaging, ToBoolean is
        // true if any element of the dataset is nonzero.
        else
        {
            for( int Index = 0; Index < data.Count; Index++ )
                if( (double)data[ Index ] != 0.0 )
                    return true;
            return false;
        }
    }

    public byte ToByte( IFormatProvider provider )
    {
        return Convert.ToByte( CalcNLimitAverage(
            Byte.MinValue, Byte.MaxValue, provider ) );
    }

    public char ToChar( IFormatProvider provider )
    {
        return Convert.ToChar( Convert.ToUInt16( CalcNLimitAverage(
            Char.MinValue, Char.MaxValue, provider ) ) );
    }

    // Convert to DateTime by adding the calculated average as
    // seconds to the current date and time. A valid DateTime is
    // always returned.
    public DateTime ToDateTime( IFormatProvider provider )
    {
        double seconds =
            Average( GetAverageInfo( provider ).TypeOfAverage );
        try
        {
            return DateTime.Now.AddSeconds( seconds );
        }
        catch( ArgumentOutOfRangeException )
        {
            return seconds < 0.0 ? DateTime.MinValue : DateTime.MaxValue;
        }
    }

    public decimal ToDecimal( IFormatProvider provider )
    {
        // The Double conversion rounds Decimal.MinValue and
        // Decimal.MaxValue to invalid Decimal values, so the
        // following limits must be used.
        return Convert.ToDecimal( CalcNLimitAverage(
            -79228162514264330000000000000.0,
            79228162514264330000000000000.0, provider ) );
    }

    public double ToDouble( IFormatProvider provider )
    {
        return Average( GetAverageInfo(provider).TypeOfAverage );
    }

    public short ToInt16( IFormatProvider provider )
    {
        return Convert.ToInt16( CalcNLimitAverage(
            Int16.MinValue, Int16.MaxValue, provider ) );
    }

    public int ToInt32( IFormatProvider provider )
    {
        return Convert.ToInt32( CalcNLimitAverage(
            Int32.MinValue, Int32.MaxValue, provider ) );
    }

    public long ToInt64( IFormatProvider provider )
    {
        // The Double conversion rounds Int64.MinValue and
        // Int64.MaxValue to invalid Int64 values, so the following
        // limits must be used.
        return Convert.ToInt64( CalcNLimitAverage(
            -9223372036854775000, 9223372036854775000, provider ) );
    }

    public SByte ToSByte( IFormatProvider provider )
    {
        return Convert.ToSByte( CalcNLimitAverage(
            SByte.MinValue, SByte.MaxValue, provider ) );
    }

    public float ToSingle( IFormatProvider provider )
    {
        return Convert.ToSingle( CalcNLimitAverage(
            Single.MinValue, Single.MaxValue, provider ) );
    }

    public UInt16 ToUInt16( IFormatProvider provider )
    {
        return Convert.ToUInt16( CalcNLimitAverage(
            UInt16.MinValue, UInt16.MaxValue, provider ) );
    }

    public UInt32 ToUInt32( IFormatProvider provider )
    {
        return Convert.ToUInt32( CalcNLimitAverage(
            UInt32.MinValue, UInt32.MaxValue, provider ) );
    }

    public UInt64 ToUInt64( IFormatProvider provider )
    {
        // The Double conversion rounds UInt64.MaxValue to an invalid
        // UInt64 value, so the following limit must be used.
        return Convert.ToUInt64( CalcNLimitAverage(
            0, 18446744073709550000.0, provider ) );
    }

    public object ToType( Type conversionType,
        IFormatProvider provider )
    {
        return Convert.ChangeType( Average(
            GetAverageInfo( provider ).TypeOfAverage ),
            conversionType );
    }

    public string ToString( IFormatProvider provider )
    {
        AverageType avgType = GetAverageInfo( provider ).TypeOfAverage;
        return String.Format( "( {0}: {1:G10} )", avgType,
            Average( avgType ) );
    }
}

class IConvertibleProviderDemo
{
    // Display a DataSet with three different format providers.
    public static void DisplayDataSet( DataSet ds )
    {
        string      fmt    = "{0,-12}{1,20}{2,20}{3,20}";
        AverageInfo median = new AverageInfo( AverageType.Median );
        AverageInfo geMean =
            new AverageInfo( AverageType.GeometricMean );

         // Display the dataset elements.
        if( ds.Count > 0 )
        {
            Console.Write( "\nDataSet: [{0}", ds[ 0 ] );
            for( int iX = 1; iX < ds.Count; iX++ )
                Console.Write( ", {0}", ds[ iX ] );
            Console.WriteLine( "]\n" );
        }

        Console.WriteLine( fmt, "Convert.", "Default",
            "Geometric Mean", "Median");
        Console.WriteLine( fmt, "--------", "-------",
            "--------------", "------");
        Console.WriteLine( fmt, "ToBoolean",
            Convert.ToBoolean( ds, null ),
            Convert.ToBoolean( ds, geMean ),
            Convert.ToBoolean( ds, median ) );
        Console.WriteLine( fmt, "ToByte",
            Convert.ToByte( ds, null ),
            Convert.ToByte( ds, geMean ),
            Convert.ToByte( ds, median ) );
        Console.WriteLine( fmt, "ToChar",
            Convert.ToChar( ds, null ),
            Convert.ToChar( ds, geMean ),
            Convert.ToChar( ds, median ) );
        Console.WriteLine( "{0,-12}{1,20:yyyy-MM-dd HH:mm:ss}" +
            "{2,20:yyyy-MM-dd HH:mm:ss}{3,20:yyyy-MM-dd HH:mm:ss}",
            "ToDateTime", Convert.ToDateTime( ds, null ),
            Convert.ToDateTime( ds, geMean ),
            Convert.ToDateTime( ds, median ) );
        Console.WriteLine( fmt, "ToDecimal",
            Convert.ToDecimal( ds, null ),
            Convert.ToDecimal( ds, geMean ),
            Convert.ToDecimal( ds, median ) );
        Console.WriteLine( fmt, "ToDouble",
            Convert.ToDouble( ds, null ),
            Convert.ToDouble( ds, geMean ),
            Convert.ToDouble( ds, median ) );
        Console.WriteLine( fmt, "ToInt16",
            Convert.ToInt16( ds, null ),
            Convert.ToInt16( ds, geMean ),
            Convert.ToInt16( ds, median ) );
        Console.WriteLine( fmt, "ToInt32",
            Convert.ToInt32( ds, null ),
            Convert.ToInt32( ds, geMean ),
            Convert.ToInt32( ds, median ) );
        Console.WriteLine( fmt, "ToInt64",
            Convert.ToInt64( ds, null ),
            Convert.ToInt64( ds, geMean ),
            Convert.ToInt64( ds, median ) );
        Console.WriteLine( fmt, "ToSByte",
            Convert.ToSByte( ds, null ),
            Convert.ToSByte( ds, geMean ),
            Convert.ToSByte( ds, median ) );
        Console.WriteLine( fmt, "ToSingle",
            Convert.ToSingle( ds, null ),
            Convert.ToSingle( ds, geMean ),
            Convert.ToSingle( ds, median ) );
        Console.WriteLine( fmt, "ToUInt16",
            Convert.ToUInt16( ds, null ),
            Convert.ToUInt16( ds, geMean ),
            Convert.ToUInt16( ds, median ) );
        Console.WriteLine( fmt, "ToUInt32",
            Convert.ToUInt32( ds, null ),
            Convert.ToUInt32( ds, geMean ),
            Convert.ToUInt32( ds, median ) );
        Console.WriteLine( fmt, "ToUInt64",
            Convert.ToUInt64( ds, null ),
            Convert.ToUInt64( ds, geMean ),
            Convert.ToUInt64( ds, median ) );
    }

    public static void Main( )
    {
        Console.WriteLine( "This example of " +
            "the Convert.To<Type>( object, IFormatProvider ) methods " +
            "\ngenerates the following output. The example " +
            "displays the values \nreturned by the methods, " +
            "using several IFormatProvider objects.\n" );

        DataSet ds1 = new DataSet(
            10.5, 22.2, 45.9, 88.7, 156.05, 297.6 );
        DisplayDataSet( ds1 );

        DataSet ds2 = new DataSet(
            359999.95, 425000, 499999.5, 775000, 1695000 );
        DisplayDataSet( ds2 );
    }
}

/*
This example of the Convert.To<Type>( object, IFormatProvider ) methods
generates the following output. The example displays the values
returned by the methods, using several IFormatProvider objects.

DataSet: [10.5, 22.2, 45.9, 88.7, 156.05, 297.6]

Convert.                 Default      Geometric Mean              Median
--------                 -------      --------------              ------
ToBoolean                   True                True                True
ToByte                       103                  59                  67
ToChar                         g                   ;                   C
ToDateTime   2003-05-13 15:04:12 2003-05-13 15:03:28 2003-05-13 15:03:35
ToDecimal       103.491666666667    59.4332135445164                67.3
ToDouble        103.491666666667    59.4332135445164                67.3
ToInt16                      103                  59                  67
ToInt32                      103                  59                  67
ToInt64                      103                  59                  67
ToSByte                      103                  59                  67
ToSingle                103.4917            59.43321                67.3
ToUInt16                     103                  59                  67
ToUInt32                     103                  59                  67
ToUInt64                     103                  59                  67

DataSet: [359999.95, 425000, 499999.5, 775000, 1695000]

Convert.                 Default      Geometric Mean              Median
--------                 -------      --------------              ------
ToBoolean                   True                True                True
ToByte                       255                 255                 255
ToChar                         ?                   ?                   ?
ToDateTime   2003-05-22 07:39:08 2003-05-20 22:28:45 2003-05-19 09:55:48
ToDecimal              750999.89    631577.237188435            499999.5
ToDouble               750999.89    631577.237188435            499999.5
ToInt16                    32767               32767               32767
ToInt32                   751000              631577              500000
ToInt64                   751000              631577              500000
ToSByte                      127                 127                 127
ToSingle                750999.9            631577.3            499999.5
ToUInt16                   65535               65535               65535
ToUInt32                  751000              631577              500000
ToUInt64                  751000              631577              500000
*/

Hinweise

provider ermöglicht es dem Benutzer, kulturspezifische Konvertierungsinformationen zum Inhalt von valueanzugeben. Die Basistypen ignorieren den provider Parameter. Der Parameter kann jedoch verwendet werden, wenn value es sich um einen benutzerdefinierten Typ handelt, der die IConvertible Schnittstelle implementiert.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBoolean(UInt64)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl ohne Vorzeichen in einen entsprechenden booleschen Wert.

[System.CLSCompliant(false)]
public static bool ToBoolean (ulong value);

Parameter

value
UInt64

Die zu konvertierende 64-Bit-Ganzzahl ohne Vorzeichen.

Gibt zurück

true, wenn value nicht 0 (null) ist, andernfalls false.

Attribute

Beispiele

Im folgenden Beispiel wird ein Array von UInt64 Werten in Boolean Werte konvertiert.

ulong[] numbers = { UInt64.MinValue, 6121, 403890774, UInt64.MaxValue };
bool result;

foreach (ulong number in numbers)
{
   result = Convert.ToBoolean(number);
   Console.WriteLine("{0,-26:N0}  -->  {1}", number, result);
}
// The example displays the following output:
//       0                           -->  False
//       6,121                       -->  True
//       403,890,774                 -->  True
//       18,446,744,073,709,551,615  -->  True

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBoolean(UInt32)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl ohne Vorzeichen in einen entsprechenden booleschen Wert.

[System.CLSCompliant(false)]
public static bool ToBoolean (uint value);

Parameter

value
UInt32

Die zu konvertierende 32-Bit-Ganzzahl ohne Vorzeichen.

Gibt zurück

true, wenn value nicht 0 (null) ist, andernfalls false.

Attribute

Beispiele

Im folgenden Beispiel wird ein Array von Int32 Werten in Boolean Werte konvertiert.

uint[] numbers = { UInt32.MinValue, 612, 4038907, Int32.MaxValue };
bool result;

foreach (uint number in numbers)
{
   result = Convert.ToBoolean(number);
   Console.WriteLine("{0,-15:N0}  -->  {1}", number, result);
}
// The example displays the following output:
//       0                -->  False
//       612              -->  True
//       4,038,907        -->  True
//       2,147,483,647    -->  True

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBoolean(UInt16)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl ohne Vorzeichen in einen entsprechenden booleschen Wert.

[System.CLSCompliant(false)]
public static bool ToBoolean (ushort value);

Parameter

value
UInt16

Die zu konvertierende 16-Bit-Ganzzahl ohne Vorzeichen.

Gibt zurück

true, wenn value nicht 0 (null) ist, andernfalls false.

Attribute

Beispiele

Im folgenden Beispiel wird ein Array von UInt16 Werten in Boolean Werte konvertiert.

ushort[] numbers = { UInt16.MinValue, 216, 21453, UInt16.MaxValue };
bool result;

foreach (ushort number in numbers)
{
   result = Convert.ToBoolean(number);
   Console.WriteLine("{0,-7:N0}  -->  {1}", number, result);
}
// The example displays the following output:
//       0        -->  False
//       216      -->  True
//       21,453   -->  True
//       65,535   -->  True

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBoolean(String)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Konvertiert die angegebene Zeichenfolgendarstellung eines logischen Werts in seine boolesche Entsprechung.

public static bool ToBoolean (string value);
public static bool ToBoolean (string? value);

Parameter

value
String

Eine Zeichenfolge, die den Wert TrueString oder FalseString enthält.

Gibt zurück

true, wenn value gleich TrueString ist, oder false, wenn value gleich FalseString oder null ist.

Ausnahmen

value ist ungleich TrueString oder FalseString.

Beispiele

Im folgenden Beispiel wird die Convert.ToBoolean(String) -Methode verwendet, um verschiedene Zeichenfolgen in boolesche Werte zu konvertieren.

using System;

public class BooleanConversion
{
   public static void Main()
   {
      String[] values = { null, String.Empty, "true", "TrueString",
                          "False", "    false    ", "-1", "0" };
      foreach (var value in values) {
         try
         {
            Console.WriteLine("Converted '{0}' to {1}.", value,
                              Convert.ToBoolean(value));
         }
         catch (FormatException)
         {
            Console.WriteLine("Unable to convert '{0}' to a Boolean.", value);
         }
      }
   }
}
// The example displays the following output:
//       Converted '' to False.
//       Unable to convert '' to a Boolean.
//       Converted 'true' to True.
//       Unable to convert 'TrueString' to a Boolean.
//       Converted 'False' to False.
//       Converted '    false    ' to False.
//       Unable to convert '-1' to a Boolean.
//       Unable to convert '0' to a Boolean.

Hinweise

Damit eine erfolgreiche Konvertierung erfolgen kann, muss der value Parameter entweder Boolean.TrueStringgleich , einer Konstante mit dem Wert True, Boolean.FalseString, einer Konstante, deren Wert ist False, oder nullgleich sein. Im Vergleich mit valueBoolean.TrueString und Boolean.FalseStringignoriert die Methode die Groß- und Kleinschreibung sowie führende und nachfolgende Leerzeichen.

Wenn Sie keine Ausnahme behandeln möchten, wenn die Konvertierung fehlschlägt, können Sie stattdessen die Boolean.TryParse -Methode aufrufen. Er gibt einen Boolean Wert zurück, der angibt, ob die Konvertierung erfolgreich war oder fehlgeschlagen ist.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBoolean(Single)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Konvertiert den Wert der angegebenen Gleitkommazahl mit einfacher Genauigkeit in einen entsprechenden booleschen Wert.

public static bool ToBoolean (float value);

Parameter

value
Single

Die zu konvertierende Gleitkommazahl mit einfacher Genauigkeit.

Gibt zurück

true, wenn value nicht 0 (null) ist, andernfalls false.

Beispiele

Im folgenden Beispiel wird ein Array von Single Werten in Boolean Werte konvertiert.

float[] numbers = { Single.MinValue, -193.0012f, 20e-15f, 0f,
                    10551e-10f, 100.3398f, Single.MaxValue };
bool result;

foreach (float number in numbers)
{
   result = Convert.ToBoolean(number);
   Console.WriteLine("{0,-15}  -->  {1}", number, result);
}
// The example displays the following output:
//       -3.402823E+38    -->  True
//       -193.0012        -->  True
//       2E-14            -->  True
//       0                -->  False
//       1.0551E-06       -->  True
//       100.3398         -->  True
//       3.402823E+38     -->  True

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBoolean(Object)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Konvertiert den Wert eines angegebenen Objekts in einen entsprechenden booleschen Wert.

public static bool ToBoolean (object value);
public static bool ToBoolean (object? value);

Parameter

value
Object

Ein Objekt, das die IConvertible-Schnittstelle implementiert, oder null.

Gibt zurück

true oder false. Damit wird der Wert wiedergegeben, der beim Aufrufen der ToBoolean(IFormatProvider)-Methode für den zugrunde liegenden Typ von value zurückgegeben wird. Wenn value gleich null ist, gibt die Methode false zurück.

Ausnahmen

value ist eine Zeichenfolge, die nicht gleich TrueString oder FalseString ist.

Die IConvertible-Schnittstelle wird von value nicht implementiert.

- oder -

Die Konvertierung von value in Boolean wird nicht unterstützt.

Beispiele

Im folgenden Beispiel wird ein Array von Objektwerten in Boolean Werte konvertiert.

object[] objects = { 16.33, -24, 0, "12", "12.7", String.Empty,
                     "1String", "True", "false", null,
                     new System.Collections.ArrayList() };

foreach (object obj in objects)
{
   Console.Write("{0,-40}  -->  ",
                 obj != null ?
                 String.Format("{0} ({1})", obj, obj.GetType().Name) :
                 "null");
   try {
      Console.WriteLine("{0}", Convert.ToBoolean(obj));
   }
   catch (FormatException) {
      Console.WriteLine("Bad Format");
   }
   catch (InvalidCastException) {
      Console.WriteLine("No Conversion");
   }
}
// The example displays the following output:
//       16.33 (Double)                            -->  True
//       -24 (Int32)                               -->  True
//       0 (Int32)                                 -->  False
//       12 (String)                               -->  Bad Format
//       12.7 (String)                             -->  Bad Format
//        (String)                                 -->  Bad Format
//       1String (String)                          -->  Bad Format
//       True (String)                             -->  True
//       false (String)                            -->  False
//       null                                      -->  False
//       System.Collections.ArrayList (ArrayList)  -->  No Conversion

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBoolean(DateTime)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.

public static bool ToBoolean (DateTime value);

Parameter

value
DateTime

Der Datums- und Uhrzeitwert, der konvertiert werden soll.

Gibt zurück

Diese Konvertierung wird nicht unterstützt. Es wird kein Wert zurückgegeben.

Ausnahmen

Diese Konvertierung wird nicht unterstützt.

Beispiele

Das folgende Beispiel zeigt, dass ein Versuch, einen Wert in einen DateTime booleschen Typ zu konvertieren, ausgelöst wird InvalidCastException.

public void ConvertBoolean() {
    const int year			= 1979;
    const int month			= 7;
    const int day			= 28;
    const int hour			= 13;
    const int minute		= 26;
    const int second		= 15;
    const int millisecond	= 53;

    DateTime dateTime = new DateTime(year, month, day, hour,
                                minute, second, millisecond);
    
    bool boolVal;

    // System.InvalidCastException is always thrown.
    try {
        boolVal = System.Convert.ToBoolean(dateTime);
    }
    catch (System.InvalidCastException) {
        System.Console.WriteLine("Conversion from DateTime to " +
            "Boolean is not supported by the .NET Framework.");
    }
}

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

ToBoolean(Int32)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Konvertiert den Wert der angegebenen 32-Bit-Ganzzahl mit Vorzeichen in einen entsprechenden booleschen Wert.

public static bool ToBoolean (int value);

Parameter

value
Int32

Die zu konvertierende 32-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

true, wenn value nicht 0 (null) ist, andernfalls false.

Beispiele

Im folgenden Beispiel wird ein Array von Int32 Werten in Boolean Werte konvertiert.

int[] numbers = { Int32.MinValue, -201649, -68, 0, 612, 4038907,
                  Int32.MaxValue };
bool result;

foreach (int number in numbers)
{
   result = Convert.ToBoolean(number);
   Console.WriteLine("{0,-15:N0}  -->  {1}", number, result);
}
// The example displays the following output:
//       -2,147,483,648   -->  True
//       -201,649         -->  True
//       -68              -->  True
//       0                -->  False
//       612              -->  True
//       4,038,907        -->  True
//       2,147,483,647    -->  True

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBoolean(Int16)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Konvertiert den Wert der angegebenen 16-Bit-Ganzzahl mit Vorzeichen in einen entsprechenden booleschen Wert.

public static bool ToBoolean (short value);

Parameter

value
Int16

Die zu konvertierende 16-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

true, wenn value nicht 0 (null) ist, andernfalls false.

Beispiele

Im folgenden Beispiel wird ein Array von Int16 Werten in Boolean Werte konvertiert.

short[] numbers = { Int16.MinValue, -10000, -154, 0, 216, 21453,
                    Int16.MaxValue };
bool result;

foreach (short number in numbers)
{
   result = Convert.ToBoolean(number);
   Console.WriteLine("{0,-7:N0}  -->  {1}", number, result);
}
// The example displays the following output:
//       -32,768  -->  True
//       -10,000  -->  True
//       -154     -->  True
//       0        -->  False
//       216      -->  True
//       21,453   -->  True
//       32,767   -->  True

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBoolean(Double)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Konvertiert den Wert der angegebenen Gleitkommazahl mit doppelter Genauigkeit in einen entsprechenden booleschen Wert.

public static bool ToBoolean (double value);

Parameter

value
Double

Die zu konvertierende Gleitkommazahl mit doppelter Genauigkeit.

Gibt zurück

true, wenn value nicht 0 (null) ist, andernfalls false.

Beispiele

Im folgenden Beispiel werden ein boolescher Wert in einen Double und ein Double in einen booleschen Wert konvertiert.

public void ConvertDoubleBool(double doubleVal) {
    bool	boolVal;
    // Double to bool conversion cannot overflow.
    boolVal = System.Convert.ToBoolean(doubleVal);
    System.Console.WriteLine("{0} as a Boolean is: {1}.",
        doubleVal, boolVal);

    // bool to double conversion cannot overflow.
    doubleVal = System.Convert.ToDouble(boolVal);
    System.Console.WriteLine("{0} as a double is: {1}.",
        boolVal, doubleVal);
}

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBoolean(Decimal)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Konvertiert den Wert der angegebenen Dezimalzahl in einen entsprechenden booleschen Wert.

public static bool ToBoolean (decimal value);

Parameter

value
Decimal

Die zu konvertierende Zahl.

Gibt zurück

true, wenn value nicht 0 (null) ist, andernfalls false.

Beispiele

Im folgenden Beispiel wird ein Array von Decimal Werten in Boolean Werte konvertiert.

decimal[] numbers = { Decimal.MinValue, -12034.87m, -100m, 0m,
                             300m, 6790823.45m, Decimal.MaxValue };
bool result;

foreach (decimal number in numbers)
{
   result = Convert.ToBoolean(number);
   Console.WriteLine("{0,-30}  -->  {1}", number, result);
}
// The example displays the following output:
//       -79228162514264337593543950335  -->  True
//       -12034.87                       -->  True
//       -100                            -->  True
//       0                               -->  False
//       300                             -->  True
//       6790823.45                      -->  True
//       79228162514264337593543950335   -->  True

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBoolean(Char)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Beim Aufrufen dieser Methode wird immer eine InvalidCastException ausgelöst.

public static bool ToBoolean (char value);

Parameter

value
Char

Das zu konvertierende Unicode-Zeichen.

Gibt zurück

Diese Konvertierung wird nicht unterstützt. Es wird kein Wert zurückgegeben.

Ausnahmen

Diese Konvertierung wird nicht unterstützt.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

ToBoolean(Byte)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Konvertiert den Wert der angegebenen 8-Bit-Ganzzahl ohne Vorzeichen in einen entsprechenden booleschen Wert.

public static bool ToBoolean (byte value);

Parameter

value
Byte

Die zu konvertierende 8-Bit-Ganzzahl ohne Vorzeichen.

Gibt zurück

true, wenn value nicht 0 (null) ist, andernfalls false.

Beispiele

Im folgenden Beispiel wird ein Array von Byte Werten in Boolean Werte konvertiert.

byte[] bytes = { Byte.MinValue, 100, 200, Byte.MaxValue };
bool result;

foreach (byte byteValue in bytes)
{
   result = Convert.ToBoolean(byteValue);
   Console.WriteLine("{0,-5}  -->  {1}", byteValue, result);
}
// The example displays the following output:
//       0      -->  False
//       100    -->  True
//       200    -->  True
//       255    -->  True

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBoolean(Boolean)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Gibt den angegebenen booleschen Wert zurück. Es wird keine wirkliche Konvertierung durchgeführt.

public static bool ToBoolean (bool value);

Parameter

value
Boolean

Der zurückzugebende boolesche Wert.

Gibt zurück

value wird unverändert zurückgegeben.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

ToBoolean(Int64)

Quelle:
Convert.cs
Quelle:
Convert.cs
Quelle:
Convert.cs

Konvertiert den Wert der angegebenen 64-Bit-Ganzzahl mit Vorzeichen in einen entsprechenden booleschen Wert.

public static bool ToBoolean (long value);

Parameter

value
Int64

Die zu konvertierende 64-Bit-Ganzzahl mit Vorzeichen.

Gibt zurück

true, wenn value nicht 0 (null) ist, andernfalls false.

Beispiele

Im folgenden Beispiel wird ein Array von Int64 Werten in Boolean Werte konvertiert.

long[] numbers = { Int64.MinValue, -2016493, -689, 0, 6121,
                   403890774, Int64.MaxValue };
bool result;

foreach (long number in numbers)
{
   result = Convert.ToBoolean(number);
   Console.WriteLine("{0,-26:N0}  -->  {1}", number, result);
}
// The example displays the following output:
//       -9,223,372,036,854,775,808  -->  True
//       -2,016,493                  -->  True
//       -689                        -->  True
//       0                           -->  False
//       6,121                       -->  True
//       403,890,774                 -->  True
//       9,223,372,036,854,775,807   -->  True

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0