Decimal.Ceiling(Decimal) Methode

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt den kleinsten ganzzahligen Wert zurück, der größer oder gleich der angegebenen Dezimalzahl ist.

public:
 static System::Decimal Ceiling(System::Decimal d);

public static decimal Ceiling (decimal d);

static member Ceiling : decimal -> decimal

Public Shared Function Ceiling (d As Decimal) As Decimal

Parameter

d: Decimal

Eine Decimal-Zahl.

Gibt zurück

Decimal

Der kleinste ganzzahlige Wert, der größer oder gleich dem d-Parameter ist. Beachten Sie, dass diese Methode einen Decimal anstelle eines ganzzahligen Typs zurückgibt.

Beispiele

Im folgenden Beispiel wird die -Methode veranschaulicht Ceiling und mit der -Methode gegenübergesetzt. Floor

using System;

public class Example
{
   public static void Main()
   {
      decimal[] values = {12.6m, 12.1m, 9.5m, 8.16m, .1m, -.1m,  -1.1m,
                          -1.9m, -3.9m};
      Console.WriteLine("{0,-8} {1,10} {2,10}\n",
                        "Value", "Ceiling", "Floor");
      foreach (decimal value in values)
      Console.WriteLine("{0,-8} {1,10} {2,10}", value,
                        Decimal.Ceiling(value), Decimal.Floor(value));
   }
}
// The example displays the following output:
//       Value       Ceiling      Floor
//
//       12.6             13         12
//       12.1             13         12
//       9.5              10          9
//       8.16              9          8
//       0.1               1          0
//       -0.1              0         -1
//       -1.1             -1         -2
//       -1.9             -1         -2
//       -3.9             -3         -4

Module Example
   Public Sub Main()
      Dim values() As Decimal = {12.6d, 12.1d, 9.5d, 8.16d, .1d, -.1d,  
                                 -1.1d, -1.9d, -3.9d}
      Console.WriteLine("{0,-8} {1,10} {2,10}", 
                        "Value", "Ceiling", "Floor")
      Console.WriteLine()
      For Each value As Decimal In values
      Console.WriteLine("{0,-8} {1,10} {2,10}", value,
                        Decimal.Ceiling(value), Decimal.Floor(value))
      Next                                     
   End Sub
End Module
' The example displays the following output:
'       Value       Ceiling      Floor
'       
'       12.6             13         12
'       12.1             13         12
'       9.5              10          9
'       8.16              9          8
'       0.1               1          0
'       -0.1              0         -1
'       -1.1             -1         -2
'       -1.9             -1         -2
'       -3.9             -3         -4

Hinweise

Das Verhalten dieser Methode folgt dem IEEE-Standard 754, Abschnitt 4. Diese Art der Rundung wird manchmal als Runden in Richtung positiver Unendlichkeit bezeichnet. Anders ausgedrückt: Wenn d positiv ist, führt das Vorhandensein einer Bruchkomponente d dazu, dass auf die nächstwerteste ganze Zahl gerundet wird. Wenn d negativ ist, bewirkt der Rundungsvorgang, dass jede Bruchteilkomponente von d verworfen wird. Der Vorgang dieser Methode unterscheidet sich von der Floor -Methode, die das Runden in Richtung negative Unendlichkeit unterstützt.

Gilt für