MathF.Round Methode

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: System.Runtime.Extensions.dll

Assembly:: netstandard.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.

Überlädt

Round(Single, Int32, MidpointRounding)	Rundet einen einzelgenauen Gleitkommawert auf eine angegebene Anzahl von Bruchstellen mit der angegebenen Rundungskonvention ab.
Round(Single, MidpointRounding)	Rundet einen einzelgenauen Gleitkommawert auf eine ganze Zahl mit der angegebenen Rundungskonvention ab.
Round(Single)	Rundet einen Gleitkommawert mit einfacher Genauigkeit auf den nächstgelegenen ganzzahligen Wert und Mittelpunktwerte auf die nächstgelegene gerade Zahl.
Round(Single, Int32)	Rundet einen Gleitkommawert mit einfacher Genauigkeit auf eine angegebene Anzahl Dezimalstellen und Mittelpunktwerte auf die nächstgelegene gerade Zahl.

Round(Single, Int32, MidpointRounding)

Rundet einen einzelgenauen Gleitkommawert auf eine angegebene Anzahl von Bruchstellen mit der angegebenen Rundungskonvention ab.

public:
 static float Round(float x, int digits, MidpointRounding mode);

public static float Round (float x, int digits, MidpointRounding mode);

static member Round : single * int * MidpointRounding -> single

Public Shared Function Round (x As Single, digits As Integer, mode As MidpointRounding) As Single

Parameter

x: Single

Eine zu rundende Gleitkommazahl mit einfacher Genauigkeit.

digits: Int32

Die Anzahl von Dezimalstellen im Rückgabewert.

mode: MidpointRounding

Eine der Enumerationswerte, die angibt, welche Rundungsstrategie verwendet werden soll.

Gibt zurück

Single

Die Zahl, die x gerundet ist, hat digits Bruchstellen. Wenn x weniger Dezimalstellen als digits hat, wird x unverändert zurückgegeben.

Ausnahmen

ArgumentOutOfRangeException

digits ist kleiner als 0 (null) oder größer als 6.

ArgumentException

mode ist kein gültiger Wert von MidpointRounding.

Hinweise

Der Wert des digits Arguments kann zwischen 0 und 6 liegen. Die maximale Anzahl von integralen und Bruchstellen, die Single vom Typ unterstützt werden, ist 6.

Wichtig

Bei der Rundung von Mittelwerten führt der Rundungsalgorithmus einen Gleichheitstest durch. Aufgrund von Problemen bei der binären Darstellung und der Genauigkeit im Gleitkommaformat kann der von der Methode zurückgegebene Wert unerwartet sein. Weitere Informationen finden Sie unter Rundung und Genauigkeit.

Wenn der Wert des x Arguments lautet Single.NaN, gibt die Methode zurück Single.NaN. Wenn x ist Single.PositiveInfinity oder Single.NegativeInfinity, gibt die Methode zurück Single.PositiveInfinity oder Single.NegativeInfinitybzw.

Siehe auch

Gilt für:

Round(Single, MidpointRounding)

Rundet einen einzelgenauen Gleitkommawert auf eine ganze Zahl mit der angegebenen Rundungskonvention ab.

public:
 static float Round(float x, MidpointRounding mode);

public static float Round (float x, MidpointRounding mode);

static member Round : single * MidpointRounding -> single

Public Shared Function Round (x As Single, mode As MidpointRounding) As Single

Parameter

x: Single

Eine zu rundende Gleitkommazahl mit einfacher Genauigkeit.

mode: MidpointRounding

Eine der Enumerationswerte, die angibt, welche Rundungsstrategie verwendet werden soll.

Gibt zurück

Single

Die ganze Zahl, die x mit der mode Rundungskonvention abgerundet wird. Diese Methode gibt einen Single integralen Typ zurück.

Ausnahmen

ArgumentException

mode ist kein gültiger Wert von MidpointRounding.

Hinweise

Wichtig

Siehe auch

Gilt für:

Round(Single)

Rundet einen Gleitkommawert mit einfacher Genauigkeit auf den nächstgelegenen ganzzahligen Wert und Mittelpunktwerte auf die nächstgelegene gerade Zahl.

public:
 static float Round(float x);

public static float Round (float x);

static member Round : single -> single

Public Shared Function Round (x As Single) As Single

Parameter

x: Single

Eine zu rundende Gleitkommazahl mit einfacher Genauigkeit.

Gibt zurück

Single

Die zu x nächste Ganzzahl. Wenn der Nachkommawert von x genau in der Mitte zwischen zwei Ganzzahlen liegt, von denen eine gerade und die andere ungerade ist, wird die gerade Zahl zurückgegeben. Beachten Sie, dass diese Methode einen Single anstelle eines ganzzahligen Typs zurückgibt.

Hinweise

Diese Methode verwendet die Standardrundenkonvention von MidpointRounding.ToEven.

Wichtig

Hinweise für Aufrufer

Aufgrund des Verlusts der Genauigkeit, die aus der Darstellung von Dezimalwerten als Gleitkommazahlen oder zum Ausführen von arithmetischen Vorgängen auf Gleitkommawerten führen kann, werden in einigen Fällen die Round(Single) Methode möglicherweise nicht zum Runden der Mittleren Werte auf die nächste ganze Zahl erscheinen.

Siehe auch

Gilt für:

Round(Single, Int32)

Rundet einen Gleitkommawert mit einfacher Genauigkeit auf eine angegebene Anzahl Dezimalstellen und Mittelpunktwerte auf die nächstgelegene gerade Zahl.

public:
 static float Round(float x, int digits);

public static float Round (float x, int digits);

static member Round : single * int -> single

Public Shared Function Round (x As Single, digits As Integer) As Single

Parameter

x: Single

Eine zu rundende Gleitkommazahl mit einfacher Genauigkeit.

digits: Int32

Die Anzahl von Dezimalstellen im Rückgabewert.

Gibt zurück

Single

Die Zahl, die x am nächsten liegt und deren Anzahl von Nachkommastellen gleich digits ist.

Ausnahmen

ArgumentOutOfRangeException

digits ist kleiner als 0 (null) oder größer als 6.

Hinweise

Der Wert des digits Arguments kann zwischen 0 und 6 liegen. Beachten Sie, dass 6 die maximale Anzahl von integralen und Bruchstellen ist, die vom Single Typ unterstützt werden.

Diese Methode verwendet die Standardrundenkonvention von MidpointRounding.ToEven.

Wichtig

Siehe auch

Gilt für: