Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen

Übersetzung

Original

Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

Single-Struktur

.NET Framework 4.5

Andere Versionen

Stellt eine Gleitkommazahl mit einfacher Genauigkeit dar.

Namespace: System
Assembly: mscorlib (in mscorlib.dll)

Syntax

C++

[SerializableAttribute]
[ComVisibleAttribute(true)]
public struct Single : IComparable, IFormattable, 
	IConvertible, IComparable<float>, IEquatable<float>

Der Single-Typ macht die folgenden Member verfügbar.

Methoden

	Name	Beschreibung
	CompareTo(Object)	Vergleicht diese Instanz mit einem angegebenen Objekt und gibt eine ganze Zahl zurück, die angibt, ob der Wert dieser Instanz kleiner oder größer als der Wert des angegebenen Objekts ist oder mit diesem übereinstimmt.
	CompareTo(Single)	Vergleicht diese Instanz mit einer angegebenen Gleitkommazahl mit einfacher Genauigkeit und gibt eine ganze Zahl zurück, die angibt, ob der Wert dieser Instanz kleiner oder größer als der Wert der angegebenen Gleitkommazahl mit einfacher Genauigkeit ist oder mit dieser übereinstimmt.
	Equals(Object)	Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Überschreibt ValueType.Equals(Object).)
	Equals(Single)	Gibt einen Wert zurück, der angibt, ob diese Instanz und ein angegebenes Single-Objekt den gleichen Wert darstellen.
	GetHashCode	Gibt den Hashcode für diese Instanz zurück. (Überschreibt ValueType.GetHashCode().)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	GetTypeCode	Gibt die TypeCode-Enumeration für den Werttyp Single zurück.
	IsInfinity	Gibt einen Wert zurück, der angibt, ob der Wert der angegebenen Zahl -unendlich oder +unendlich ist.
	IsNaN	Gibt einen Wert, der angibt, ob der angegebene Wert keine Zahl ist (NaN).
	IsNegativeInfinity	Gibt einen Wert zurück, der angibt, ob der Wert der angegebenen Zahl -unendlich ist.
	IsPositiveInfinity	Gibt einen Wert zurück, der angibt, ob der Wert der angegebenen Zahl +unendlich ist.
	Parse(String)	Konvertiert die Zeichenfolgenentsprechung einer Zahl in die entsprechende Gleitkommazahl mit einfacher Genauigkeit.
	Parse(String, NumberStyles)	Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil in die entsprechende Gleitkommazahl mit einfacher Genauigkeit.
	Parse(String, IFormatProvider)	Konvertiert die Zeichenfolgendarstellung einer Zahl in einem bestimmten kulturabhängigen Format in die entsprechende Gleitkommazahl mit einfacher Genauigkeit.
	Parse(String, NumberStyles, IFormatProvider)	Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturabhängigen Format in die entsprechende Gleitkommazahl mit einfacher Genauigkeit.
	ToString()	Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung. (Überschreibt ValueType.ToString().)
	ToString(IFormatProvider)	Konvertiert den numerischen Wert dieser Instanz unter Berücksichtigung der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
	ToString(String)	Konvertiert den numerischen Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung unter Berücksichtigung des angegebenen Formats.
	ToString(String, IFormatProvider)	Konvertiert den numerischen Wert dieser Instanz unter Verwendung des angegebenen Formats und der angegebenen kulturabhängigen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
	TryParse(String, Single)	Konvertiert die Zeichenfolgenentsprechung einer Zahl in die entsprechende Gleitkommazahl mit einfacher Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.
	TryParse(String, NumberStyles, IFormatProvider, Single)	Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturabhängigen Format in die entsprechende Gleitkommazahl mit einfacher Genauigkeit. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.

Zum Seitenanfang

Operatoren

	Name	Beschreibung
	Equality	Gibt einen Wert zurück, der angibt, ob zwei angegebene Single-Werte gleich sind.
	GreaterThan	Gibt einen Wert zurück, der angibt, ob ein angegebener Single-Wert größer als ein anderer angegebener Single-Wert ist.
	GreaterThanOrEqual	Gibt einen Wert zurück, der angibt, ob ein angegebener Single-Wert größer oder gleich einem anderen angegebenen Single-Wert ist.
	Inequality	Gibt einen Wert zurück, der angibt, ob zwei angegebene Single-Werte ungleich sind.
	LessThan	Gibt einen Wert zurück, der angibt, ob ein angegebener Single-Wert kleiner als ein anderer angegebener Single-Wert ist.
	LessThanOrEqual	Gibt einen Wert zurück, der angibt, ob ein angegebener Single-Wert kleiner oder gleich einem anderen angegebenen Single-Wert ist.

Zum Seitenanfang

Felder

	Name	Beschreibung
	Epsilon	Stellt den kleinsten positiven Single-Wert dar, der größer als 0 (null) ist. Dieses Feld ist konstant.
	MaxValue	Stellt den größtmöglichen Wert von Single dar. Dieses Feld ist konstant.
	MinValue	Stellt den kleinstmöglichen Wert von Single dar. Dieses Feld ist konstant.
	NaN	Stellt Not-a-Number (NaN) dar. Dieses Feld ist konstant.
	NegativeInfinity	Stellt minus unendlich dar. Dieses Feld ist konstant.
	PositiveInfinity	Stellt plus unendlich dar. Dieses Feld ist konstant.

Zum Seitenanfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	IComparable.CompareTo	Vergleicht die aktuelle Instanz mit einem anderen Objekt vom selben Typ und gibt eine ganze Zahl zurück, die angibt, ob die aktuelle Instanz in der Sortierreihenfolge vor oder nach dem anderen Objekt oder an derselben Position auftritt.
	IConvertible.ToBoolean	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToBoolean.
	IConvertible.ToByte	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToByte.
	IConvertible.ToChar	Infrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
	IConvertible.ToDateTime	Infrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
	IConvertible.ToDecimal	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToDecimal.
	IConvertible.ToDouble	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToDouble.
	IConvertible.ToInt16	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToInt16.
	IConvertible.ToInt32	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToInt32.
	IConvertible.ToInt64	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToInt64.
	IConvertible.ToSByte	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToSByte.
	IConvertible.ToSingle	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToSingle.
	IConvertible.ToType	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToType.
	IConvertible.ToUInt16	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToUInt16.
	IConvertible.ToUInt32	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToUInt32.
	IConvertible.ToUInt64	Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToUInt64.

Zum Seitenanfang

Hinweise

Der Single-Werttyp stellt eine 32-Bit-Gleitkommazahl einfacher Genauigkeit mit Werten von -3,402823e38 bis +3,402823e38 dar. Der Wertebereich umfasst zudem eine positive und eine negative 0 (null), PositiveInfinity, NegativeInfinity und NaN (Not-a-Number).

Single entspricht der Norm IEC 60559:1989 (IEEE 754) für binäre Gleitkomma-Arithmetik.

Single stellt Methoden zum Vergleichen von Instanzen dieses Typs, zum Konvertieren des Werts einer Instanz in die entsprechende Zeichenfolgendarstellung und zum Konvertieren der Zeichenfolgendarstellung einer Zahl in eine Instanz dieses Typs bereit. Informationen über die Steuerung der Zeichenfolgenentsprechung von Werttypen mit Codes für die Formatangabe finden Sie unter Formatierung von Typen, Standardmäßige Zahlenformatzeichenfolgen und Benutzerdefinierte Zahlenformatzeichenfolgen.

Verwenden von Gleitkommazahlen

Wenn bei einer binären Operation einer der Operanden einer der Gleitkommatypen Single oder Double ist, muss der andere Operand ein ganzzahliger Typ oder ein Gleitkommatyp sein. Die Operation wird wie folgt ausgewertet:

Wenn einer der Operanden einen ganzzahligen Typ hat, wird dieser Operand in den Gleitkommatyp des anderen Operanden konvertiert.
Wenn danach einer der Operanden den Typ Double hat, wird der andere Operand in Double konvertiert, und bei Ausführung der Operation wird mindestens der Wertebereich und die Genauigkeit von Double verwendet. Bei numerischen Operationen ist der Typ des Ergebnisses Double.
Andernfalls wird bei Ausführung der Operation mindestens der Wertebereich und die Genauigkeit des Typs Single verwendet, und der Typ des Ergebnisses ist Single.

Gleitkommaoperatoren einschließlich des Zuweisungsoperators lösen keine Ausnahmen aus. Stattdessen ist, wie unten beschrieben, das Ergebnis einer Gleitkommaoperation in Ausnahmefällen 0 (null), unendlich oder NaN:

Wenn der Betrag des Ergebnisses einer Gleitkommaoperation für das Zielformat zu klein ist, ist das Ergebnis der Operation 0 (null).
Wenn der Betrag des Ergebnisses einer Gleitkommaoperation zu groß für das Zielformat ist, ist das Ergebnis der Operation je nach Vorzeichen des Ergebnisses entweder PositiveInfinity oder NegativeInfinity.
Wenn eine Gleitkommaoperation ungültig ist, ist das Ergebnis der Operation NaN.
Wenn mindestens einer der Operanden einer Gleitkommaoperation NaN ist, ist das Ergebnis der Operation NaN.

Gleitkommawerte und Verlust an Genauigkeit

Beachten Sie, dass eine Gleitkommazahl nur ein Näherungswert einer Dezimalzahl ist und dass die Genauigkeit einer Gleitkommazahl bestimmt, wie genau die Zahl mit einer Dezimalzahl übereinstimmt. In der Standardeinstellung hat der Single-Wert nur eine Genauigkeit von 7 Ziffern, obwohl intern maximal 9 gültige Ziffern bestimmt werden. Die Genauigkeit einer Gleitkommazahl hat mehrere Auswirkungen:

Zwei Gleitkommazahlen, die bei einer bestimmten Genauigkeit als gleich gelten, können bei einer anderen Genauigkeit als ungleich gelten, da sich die letzten signifikanten Ziffern unterscheiden.
Eine mathematische oder Vergleichsoperation, bei der eine Gleitkommazahl verwendet wird, führt möglicherweise nicht zu demselben Ergebnis wie bei der Verwendung einer Dezimalzahl, da die Gleitkommazahl eventuell nur ein Näherungswert der Dezimalzahl ist.
Bei Verwendung einer Gleitkommazahl könnte ein Wert möglicherweise nicht wiederhergestellt werden. Ein Wert gilt als wiederhergestellt, wenn er in einer Operation in ein anderes Format und anschließend in einer Umkehroperation wieder zu einer Gleitkommazahl konvertiert wird, wobei die resultierende Gleitkommazahl mit der ursprünglichen Gleitkommazahl übereinstimmt. Die Wiederherstellung könnte fehlschlagen, wenn ein oder mehr niederstwertige Ziffern bei einer Konvertierung verloren gehen oder geändert werden.

Versionsinformationen

.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Portable Klassenbibliothek

Unterstützt in: Portable Klassenbibliothek

.NET für Windows Store-Apps

Unterstützt in: Windows 8

Plattformen

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Threadsicherheit

Alle Member dieses Typs sind threadsicher. Member, die scheinbar den Zustand einer Instanz ändern, geben in Wirklichkeit eine neue Instanz zurück, die mit dem neuen Wert initialisiert wurde. Wie bei allen anderen Typen müssen Lese- und Schreibzugriffe auf eine freigegebene Variable, die eine Instanz dieses Typs enthält, durch eine Sperre geschützt werden, um die Threadsicherheit zu gewährleisten.

Siehe auch

Referenz

System-Namespace

Decimal

Double

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN