SByte Struktur

Definition

Wichtig

Diese API ist nicht CLS-kompatibel.

CLS-kompatible Alternative
System.Int16

Stellt eine ganze 8-Bit-Zahl mit Vorzeichen dar.

public value class System::SByte : IComparable, IComparable<System::SByte>, IConvertible, IEquatable<System::SByte>, IFormattable
public value class System::SByte : IComparable, IComparable<System::SByte>, IConvertible, IEquatable<System::SByte>, ISpanFormattable
public value class System::SByte : IComparable<System::SByte>, IConvertible, IEquatable<System::SByte>, IParsable<System::SByte>, ISpanParsable<System::SByte>, System::Numerics::IAdditionOperators<System::SByte, System::SByte, System::SByte>, System::Numerics::IAdditiveIdentity<System::SByte, System::SByte>, System::Numerics::IBinaryInteger<System::SByte>, System::Numerics::IBinaryNumber<System::SByte>, System::Numerics::IBitwiseOperators<System::SByte, System::SByte, System::SByte>, System::Numerics::IComparisonOperators<System::SByte, System::SByte>, System::Numerics::IDecrementOperators<System::SByte>, System::Numerics::IDivisionOperators<System::SByte, System::SByte, System::SByte>, System::Numerics::IEqualityOperators<System::SByte, System::SByte>, System::Numerics::IIncrementOperators<System::SByte>, System::Numerics::IMinMaxValue<System::SByte>, System::Numerics::IModulusOperators<System::SByte, System::SByte, System::SByte>, System::Numerics::IMultiplicativeIdentity<System::SByte, System::SByte>, System::Numerics::IMultiplyOperators<System::SByte, System::SByte, System::SByte>, System::Numerics::INumber<System::SByte>, System::Numerics::INumberBase<System::SByte>, System::Numerics::IShiftOperators<System::SByte, System::SByte>, System::Numerics::ISignedNumber<System::SByte>, System::Numerics::ISubtractionOperators<System::SByte, System::SByte, System::SByte>, System::Numerics::IUnaryNegationOperators<System::SByte, System::SByte>, System::Numerics::IUnaryPlusOperators<System::SByte, System::SByte>
public value class System::SByte : IComparable, IConvertible, IFormattable
public value class System::SByte : IComparable, IComparable<System::SByte>, IEquatable<System::SByte>, IFormattable
[System.CLSCompliant(false)]
public struct SByte : IComparable, IComparable<sbyte>, IConvertible, IEquatable<sbyte>, IFormattable
[System.CLSCompliant(false)]
public readonly struct SByte : IComparable, IComparable<sbyte>, IConvertible, IEquatable<sbyte>, IFormattable
[System.CLSCompliant(false)]
public readonly struct SByte : IComparable, IComparable<sbyte>, IConvertible, IEquatable<sbyte>, ISpanFormattable
[System.CLSCompliant(false)]
public readonly struct SByte : IComparable<sbyte>, IConvertible, IEquatable<sbyte>, IParsable<sbyte>, ISpanParsable<sbyte>, System.Numerics.IAdditionOperators<sbyte,sbyte,sbyte>, System.Numerics.IAdditiveIdentity<sbyte,sbyte>, System.Numerics.IBinaryInteger<sbyte>, System.Numerics.IBinaryNumber<sbyte>, System.Numerics.IBitwiseOperators<sbyte,sbyte,sbyte>, System.Numerics.IComparisonOperators<sbyte,sbyte>, System.Numerics.IDecrementOperators<sbyte>, System.Numerics.IDivisionOperators<sbyte,sbyte,sbyte>, System.Numerics.IEqualityOperators<sbyte,sbyte>, System.Numerics.IIncrementOperators<sbyte>, System.Numerics.IMinMaxValue<sbyte>, System.Numerics.IModulusOperators<sbyte,sbyte,sbyte>, System.Numerics.IMultiplicativeIdentity<sbyte,sbyte>, System.Numerics.IMultiplyOperators<sbyte,sbyte,sbyte>, System.Numerics.INumber<sbyte>, System.Numerics.INumberBase<sbyte>, System.Numerics.IShiftOperators<sbyte,sbyte>, System.Numerics.ISignedNumber<sbyte>, System.Numerics.ISubtractionOperators<sbyte,sbyte,sbyte>, System.Numerics.IUnaryNegationOperators<sbyte,sbyte>, System.Numerics.IUnaryPlusOperators<sbyte,sbyte>
[System.CLSCompliant(false)]
[System.Serializable]
public struct SByte : IComparable, IConvertible, IFormattable
[System.CLSCompliant(false)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public struct SByte : IComparable, IComparable<sbyte>, IConvertible, IEquatable<sbyte>, IFormattable
[System.CLSCompliant(false)]
public struct SByte : IComparable, IComparable<sbyte>, IEquatable<sbyte>, IFormattable
[<System.CLSCompliant(false)>]
type sbyte = struct
    interface IConvertible
    interface IFormattable
[<System.CLSCompliant(false)>]
type sbyte = struct
    interface IConvertible
    interface ISpanFormattable
    interface IFormattable
[<System.CLSCompliant(false)>]
type sbyte = struct
    interface IConvertible
    interface IFormattable
    interface IParsable<sbyte>
    interface ISpanFormattable
    interface ISpanParsable<sbyte>
    interface IAdditionOperators<sbyte, sbyte, sbyte>
    interface IAdditiveIdentity<sbyte, sbyte>
    interface IBinaryInteger<sbyte>
    interface IBinaryNumber<sbyte>
    interface IBitwiseOperators<sbyte, sbyte, sbyte>
    interface IComparisonOperators<sbyte, sbyte>
    interface IEqualityOperators<sbyte, sbyte>
    interface IDecrementOperators<sbyte>
    interface IDivisionOperators<sbyte, sbyte, sbyte>
    interface IIncrementOperators<sbyte>
    interface IModulusOperators<sbyte, sbyte, sbyte>
    interface IMultiplicativeIdentity<sbyte, sbyte>
    interface IMultiplyOperators<sbyte, sbyte, sbyte>
    interface INumber<sbyte>
    interface INumberBase<sbyte>
    interface ISubtractionOperators<sbyte, sbyte, sbyte>
    interface IUnaryNegationOperators<sbyte, sbyte>
    interface IUnaryPlusOperators<sbyte, sbyte>
    interface IShiftOperators<sbyte, sbyte>
    interface IMinMaxValue<sbyte>
    interface ISignedNumber<sbyte>
[<System.CLSCompliant(false)>]
[<System.Serializable>]
type sbyte = struct
    interface IFormattable
    interface IConvertible
[<System.CLSCompliant(false)>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type sbyte = struct
    interface IFormattable
    interface IConvertible
[<System.CLSCompliant(false)>]
type sbyte = struct
    interface IFormattable
Public Structure SByte
Implements IComparable, IComparable(Of SByte), IConvertible, IEquatable(Of SByte), IFormattable
Public Structure SByte
Implements IComparable, IComparable(Of SByte), IConvertible, IEquatable(Of SByte), ISpanFormattable
Public Structure SByte
Implements IAdditionOperators(Of SByte, SByte, SByte), IAdditiveIdentity(Of SByte, SByte), IBinaryInteger(Of SByte), IBinaryNumber(Of SByte), IBitwiseOperators(Of SByte, SByte, SByte), IComparable(Of SByte), IComparisonOperators(Of SByte, SByte), IConvertible, IDecrementOperators(Of SByte), IDivisionOperators(Of SByte, SByte, SByte), IEqualityOperators(Of SByte, SByte), IEquatable(Of SByte), IIncrementOperators(Of SByte), IMinMaxValue(Of SByte), IModulusOperators(Of SByte, SByte, SByte), IMultiplicativeIdentity(Of SByte, SByte), IMultiplyOperators(Of SByte, SByte, SByte), INumber(Of SByte), INumberBase(Of SByte), IParsable(Of SByte), IShiftOperators(Of SByte, SByte), ISignedNumber(Of SByte), ISpanParsable(Of SByte), ISubtractionOperators(Of SByte, SByte, SByte), IUnaryNegationOperators(Of SByte, SByte), IUnaryPlusOperators(Of SByte, SByte)
Public Structure SByte
Implements IComparable, IConvertible, IFormattable
Public Structure SByte
Implements IComparable, IComparable(Of SByte), IEquatable(Of SByte), IFormattable
Vererbung
Attribute
Implementiert

Hinweise

Der SByte Werttyp stellt ganze Zahlen mit Werten dar, die zwischen negativen 128 und positiven 127 reichen.

Wichtig

Der SByte Typ ist nicht CLS-konform. Der CLS-kompatible alternative Typ ist Int16. Byte kann stattdessen verwendet werden, um einen positiven SByte Wert zu ersetzen, der von Null auf MaxValue. Weitere Informationen zur CLS-Compliance finden Sie unter Sprachunabhängigkeit und Language-Independent Komponenten.

SByte stellt Methoden bereit, um Instanzen dieses Typs zu vergleichen, den Wert einer Instanz in seine Zeichenfolgendarstellung zu konvertieren und die Zeichenfolgendarstellung einer Zahl in eine Instanz dieses Typs zu konvertieren.

Informationen dazu, wie Formatspezifikationscodes die Zeichenfolgendarstellung von Werttypen steuern, finden Sie unter Formatierungstypen.

Felder

MaxValue

Stellt den größtmöglichen Wert von SByte dar. Dieses Feld ist konstant.

MinValue

Stellt den kleinstmöglichen Wert von SByte dar. Dieses Feld ist konstant.

Methoden

Abs(SByte)

Berechnet das Absolute eines Werts.

Clamp(SByte, SByte, SByte)

Klammert einen Wert auf einen inklusiven Mindest- und Maximalwert.

CompareTo(Object)

Vergleicht diese Instanz mit einem angegebenen Objekt und gibt eine Angabe über das Verhältnis der entsprechenden Werte zurück.

CompareTo(SByte)

Vergleicht diese Instanz mit einer angegebenen 8-Bit-Ganzzahl mit Vorzeichen und gibt eine Angabe über das Verhältnis der entsprechenden Werte zurück.

CopySign(SByte, SByte)

Kopiert das Zeichen eines Werts in das Zeichen eines anderen Werts..

CreateChecked<TOther>(TOther)

Erstellt eine Instanz des aktuellen Typs aus einem Wert, indem eine Überlaufausnahme für alle Werte ausgelöst wird, die außerhalb des repräsentativen Bereichs des aktuellen Typs liegen.

CreateSaturating<TOther>(TOther)

Erstellt eine Instanz des aktuellen Typs aus einem Wert, Sättigung aller Werte, die außerhalb des repräsentativen Bereichs des aktuellen Typs liegen.

CreateTruncating<TOther>(TOther)

Erstellt eine Instanz des aktuellen Typs aus einem Wert, die alle Werte abschneiden, die außerhalb des repräsentativen Bereichs des aktuellen Typs liegen.

DivRem(SByte, SByte)

Berechnet den Quotienten und Rest von zwei Werten.

Equals(Object)

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist.

Equals(SByte)

Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen SByte-Wert ist.

GetHashCode()

Gibt den Hashcode für diese Instanz zurück.

GetTypeCode()

Gibt den TypeCode für den Werttyp SByte zurück.

IsNegative(SByte)

Bestimmt, ob ein Wert negativ ist.

IsPow2(SByte)

Bestimmt, ob ein Wert eine Leistung von zwei ist.

LeadingZeroCount(SByte)

Berechnet die Anzahl der führenden Nullen in einem Wert.

Log2(SByte)

Berechnet das Protokoll2 eines Werts.

Max(SByte, SByte)

Vergleicht zwei Werte, um zu berechnen, was größer ist.

MaxMagnitude(SByte, SByte)

Vergleicht zwei Werte, um zu berechnen, was größer ist.

Min(SByte, SByte)

Vergleicht zwei Werte mit der Berechnung, die kleiner ist.

MinMagnitude(SByte, SByte)

Vergleicht zwei Werte mit der Berechnung, die kleiner ist.

Parse(ReadOnlySpan<Char>, IFormatProvider)

Analysiert einen Bereich von Zeichen in einen Wert.

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Konvertiert die Spannendarstellung einer Zahl in einem angegebenen Stil und einem kulturabhängigen Format in die entsprechende 8-Bit-Zahl mit Vorzeichen.

Parse(String)

Konvertiert die Zeichenfolgendarstellung einer Zahl in die entsprechende 8-Bit-Ganzzahl mit Vorzeichen.

Parse(String, IFormatProvider)

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen kulturspezifischen Format in die entsprechende 8-Bit-Ganzzahl mit Vorzeichen.

Parse(String, NumberStyles)

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil in die entsprechende 8-Bit-Ganzzahl mit Vorzeichen.

Parse(String, NumberStyles, IFormatProvider)

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturabhängigen Format in die entsprechende ganze 8-Bit-Zahl mit Vorzeichen.

PopCount(SByte)

Berechnet die Anzahl der Bits, die in einem Wert festgelegt werden.

RotateLeft(SByte, Int32)

Dreht einen Wert nach links um einen bestimmten Betrag.

RotateRight(SByte, Int32)

Dreht einen Wert nach rechts um einen bestimmten Betrag.

Sign(SByte)

Berechnet das Zeichen eines Werts.

ToString()

Konvertiert den Wert dieser Instanz in die entsprechende Zeichenfolgendarstellung.

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.

TrailingZeroCount(SByte)

Berechnet die Anzahl der nachgestellten Nullen in einem Wert.

TryCreate<TOther>(TOther, SByte)

Versucht, eine Instanz des aktuellen Typs aus einem Wert zu erstellen.

TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)

Versucht, den Wert der aktuellen Instanz einer 8-Bit-Ganzzahl mit Vorzeichen in die angegebene Zeichenspanne zu formatieren.

TryParse(ReadOnlySpan<Char>, IFormatProvider, SByte)

Versucht, einen Bereich von Zeichen in einen Wert zu analysieren.

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, SByte)

Konvertiert die Spannendarstellung einer Zahl in einem angegebenen Stil und kulturspezifischen Format in das entsprechende SByte und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich abgeschlossen wurde.

TryParse(ReadOnlySpan<Char>, SByte)

Versucht, die Spannendarstellung einer Zahl in deren SByte-Entsprechung zu konvertieren, und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich durchgeführt wurde.

TryParse(String, IFormatProvider, SByte)
TryParse(String, NumberStyles, IFormatProvider, SByte)

Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und kulturspezifischen Format in das entsprechende SByte und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich abgeschlossen wurde.

TryParse(String, SByte)

Versucht, die Zeichenfolgendarstellung einer Zahl in deren SByte-Entsprechung zu konvertieren, und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich durchgeführt wurde.

Explizite Schnittstellenimplementierungen

IBinaryInteger<SByte>.GetByteCount()

Ruft die Anzahl der Bytes ab, die als Teil von TryWriteLittleEndian(Span<Byte>, Int32).

IBinaryInteger<SByte>.GetShortestBitLength()

Ruft die Länge in Bits der kürzesten Ergänzungsdarstellung des aktuellen Werts ab.

IBinaryInteger<SByte>.TryWriteLittleEndian(Span<Byte>, Int32)

Versucht, den aktuellen Wert in einem kleinen endischen Format in einen bestimmten Bereich zu schreiben.

IComparable.CompareTo(Object)

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.GetTypeCode()

Gibt den TypeCode für diese Instanz zurück.

IConvertible.ToBoolean(IFormatProvider)

Eine Beschreibung dieses Elements finden Sie unter ToBoolean(IFormatProvider).

IConvertible.ToByte(IFormatProvider)

Eine Beschreibung dieses Elements finden Sie unter ToByte(IFormatProvider).

IConvertible.ToChar(IFormatProvider)

Eine Beschreibung dieses Elements finden Sie unter ToChar(IFormatProvider).

IConvertible.ToDateTime(IFormatProvider)

Diese Konvertierung wird nicht unterstützt. Bei einem entsprechenden Versuch wird eine InvalidCastException ausgelöst.

IConvertible.ToDecimal(IFormatProvider)

Eine Beschreibung dieses Elements finden Sie unter ToDecimal(IFormatProvider).

IConvertible.ToDouble(IFormatProvider)

Eine Beschreibung dieses Elements finden Sie unter ToDouble(IFormatProvider).

IConvertible.ToInt16(IFormatProvider)

Eine Beschreibung dieses Elements finden Sie unter ToInt16(IFormatProvider).

IConvertible.ToInt32(IFormatProvider)

Eine Beschreibung dieses Elements finden Sie unter ToInt32(IFormatProvider).

IConvertible.ToInt64(IFormatProvider)

Eine Beschreibung dieses Elements finden Sie unter ToInt64(IFormatProvider).

IConvertible.ToSByte(IFormatProvider)

Eine Beschreibung dieses Elements finden Sie unter ToSByte(IFormatProvider).

IConvertible.ToSingle(IFormatProvider)

Eine Beschreibung dieses Elements finden Sie unter ToSingle(IFormatProvider).

IConvertible.ToType(Type, IFormatProvider)

Eine Beschreibung dieses Elements finden Sie unter ToType(Type, IFormatProvider).

IConvertible.ToUInt16(IFormatProvider)

Eine Beschreibung dieses Elements finden Sie unter ToUInt16(IFormatProvider).

IConvertible.ToUInt32(IFormatProvider)

Eine Beschreibung dieses Elements finden Sie unter ToUInt32(IFormatProvider).

IConvertible.ToUInt64(IFormatProvider)

Eine Beschreibung dieses Elements finden Sie unter ToUInt64(IFormatProvider).

Gilt für:

Threadsicherheit

Alle Elemente dieses Typs sind threadsicher. Elemente, die den Instanzstatus ändern möchten, geben tatsächlich eine neue Instanz zurück, die mit dem neuen Wert initialisiert wurde. Wie bei jedem anderen Typ muss das Lesen und Schreiben an eine freigegebene Variable, die eine Instanz dieses Typs enthält, durch eine Sperrung geschützt werden, um die Threadsicherheit zu gewährleisten.

Siehe auch