(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

Byte-Struktur

Stellt eine 8-Bit-Ganzzahl ohne Vorzeichen dar.

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

[<Sealed>]
[<SerializableAttribute>]
[<ComVisibleAttribute(true)>]
type Byte =  
    struct
        interface IComparable
        interface IFormattable
        interface IConvertible
        interface IComparable<byte>
        interface IEquatable<byte>
    end

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

  NameBeschreibung
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsCompareTo(Byte)Vergleicht diese Instanz mit einer angegebenen 8-Bit-Ganzzahl ohne Vorzeichen, und gibt eine Angabe über das Verhältnis der entsprechenden Werte zurück.
Öffentliche MethodeUnterstützt von XNA FrameworkCompareTo(Object)Vergleicht diese Instanz mit einem angegebenen Objekt und gibt eine Angabe über das Verhältnis der entsprechenden Werte zurück.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsEquals(Byte)Gibt einen Wert zurück, der angibt, ob diese Instanz und ein angegebenes Byte-Objekt den gleichen Wert darstellen.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsEquals(Object)Gibt einen Wert zurück, der angibt, ob diese Instanz gleich einem angegebenen Objekt ist. (Überschreibt ValueType.Equals(Object).)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGetHashCodeGibt den Hashcode für diese Instanz zurück. (Überschreibt ValueType.GetHashCode().)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeUnterstützt von XNA FrameworkGetTypeCodeGibt die TypeCode-Enumeration für den Werttyp Byte zurück.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsParse(String)Wandelt die angegebene Zeichenfolgendarstellung einer Zahl in ihre Byte-Entsprechung um.
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsParse(String, NumberStyles)Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil in die Byte-Entsprechung.
Öffentliche MethodeStatischer MemberUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsParse(String, IFormatProvider)Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen kulturspezifischen Format in die Byte-Entsprechung
Öffentliche MethodeStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsParse(String, NumberStyles, IFormatProvider)Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen kulturabhängigen Format in das entsprechende Byte.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToString()Konvertiert den Wert des aktuellen Byte-Objekts in die entsprechende Zeichenfolgendarstellung. (Überschreibt ValueType.ToString().)
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToString(IFormatProvider)Konvertiert den numerischen Wert des aktuellen Byte-Objekts unter Verwendung der angegebenen kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToString(String)Konvertiert den Wert des aktuellen Byte-Objekts unter Verwendung des angegebenen Formats in die entsprechende Zeichenfolgendarstellung.
Öffentliche MethodeUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsToString(String, IFormatProvider)Konvertiert den Wert des aktuellen Byte-Objekts unter Verwendung des angegebenen Formats sowie der kulturspezifischen Formatierungsinformationen in die entsprechende Zeichenfolgendarstellung.
Öffentliche MethodeStatischer MemberUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsTryParse(String, Byte)Versucht, die Zeichenfolgendarstellung einer Zahl in deren Byte-Entsprechung zu konvertieren, und gibt einen Wert zurück, der angibt, ob die Konvertierung erfolgreich durchgeführt wurde.
Öffentliche MethodeStatischer MemberUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsTryParse(String, NumberStyles, IFormatProvider, Byte)Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen kulturabhängigen Format in das entsprechende Byte. Ein Rückgabewert gibt an, ob die Konvertierung erfolgreich war oder nicht.
Zum Seitenanfang

  NameBeschreibung
Öffentliches FeldStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsMaxValueStellt den größtmöglichen Wert von Byte dar. Dieses Feld ist konstant.
Öffentliches FeldStatischer MemberUnterstützt von XNA FrameworkUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsMinValueStellt den kleinstmöglichen Wert von Byte dar. Dieses Feld ist konstant.
Zum Seitenanfang

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von Portable KlassenbibliothekUnterstützt in .NET für Windows Store-AppsIComparable.CompareToVergleicht 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.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToBooleanInfrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToBoolean.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToByteInfrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToByte.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToCharInfrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToChar.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToDateTimeInfrastruktur. Diese Konvertierung wird nicht unterstützt. Bei dem Versuch der Verwendung dieser Methode wird eine InvalidCastException ausgelöst.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToDecimalInfrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToDecimal.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToDoubleInfrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToDouble.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToInt16Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToInt16.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToInt32Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToInt32.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToInt64Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToInt64.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToSByteInfrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToSByte.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToSingleInfrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToSingle.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToTypeInfrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToType.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToUInt16Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToUInt16.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToUInt32Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToUInt32.
Explizite SchnittstellenimplementierungPrivate MethodeUnterstützt von XNA FrameworkIConvertible.ToUInt64Infrastruktur. Eine Beschreibung dieses Members finden Sie unter IConvertible.ToUInt64.
Zum Seitenanfang

Byte ist ein unveränderlicher Werttyp, der ganze Zahlen ohne Vorzeichen mit Werten darstellt, die von 0 (durch die Byte.MinValue-Konstante dargestellt) und 255 (durch die Byte.MaxValue-Konstante dargestellt) reichen. .NET Framework schließt auch einen 8-Bit-Ganzzahlwert-Typ mit Vorzeichen ein, SByte, der Werte darstellt, die zwischen -128 und 127 liegen.

Instanziieren eines Byte-Werts

Sie können auf mehrere Weisen einen Byte-Wert instanziieren:

  • Sie können eine Byte-Variable deklarieren und dieser einen ganzzahligen Literalwert zuweisen, der innerhalb des Bereichs des Byte-Datentyps ist. Im folgenden Beispiel werden zwei Byte-Variablen deklariert und ihnen auf diese Weise Werte zugewiesen.

    Derzeit ist kein Code Beispiel verfügbar, oder die Sprache wird nicht unterstützt.
  • Sie können einem Byte einen numerischen Nicht-Byte-Wert zuweisen. Dies ist eine Eingrenzungskonvertierung, für die ein Umwandlungsoperator in C# und eine Konvertierungsmethode in Visual Basic erforderlich ist, wenn OptionStrict aktiviert ist. Wenn der Nicht-Byte-Wert ein Single-, Double- oder Decimal-Wert ist, der eine Nachkommastelle einschließt, wird hängt die Behandlung seines Bruchteils vom Compiler ab, der die Konvertierung ausführt. Im folgenden Beispiel werden mehrere numerische Werte Byte-Variablen zugewiesen.

    Derzeit ist kein Code Beispiel verfügbar, oder die Sprache wird nicht unterstützt.
  • Sie können eine Methode der Convert-Klasse aufrufen, um einen beliebigen unterstützten Typ in einen Byte-Wert zu konvertieren. Dies ist möglich, da Byte die IConvertible-Schnittstelle unterstützt. Im folgenden Beispiel wird das Konvertieren eines Arrays von Int32-Werten in Byte-Werte veranschaulicht.

    Derzeit ist kein Code Beispiel verfügbar, oder die Sprache wird nicht unterstützt.
  • Sie können die Parse-Methode oder TryParse-Methode aufrufen, um die Zeichenfolgendarstellung eines Byte-Werts in ein Byte zu konvertieren. Die Zeichenfolge kann entweder Dezimal- oder Hexadezimalziffern enthalten. Im folgenden Beispiel wird der Analysevorgang mit einer dezimalen und einer Hexadezimalzeichenfolge veranschaulicht.

    Derzeit ist kein Code Beispiel verfügbar, oder die Sprache wird nicht unterstützt.

Ausführen von Operationen mit Byte-Werten

Der Byte-Typ unterstützt mathematische Standardoperationen, wie z. B. Addition, Subtraktion, Division, Multiplikation, Negation und unäre Negation. Wie die anderen ganzzahligen Typen unterstützt der Byte-Typ ebenfalls die bitweisen Operatoren AND, OR, XOR, Schieben nach links und Schieben nach rechts.

Sie können zwei Byte-Werte mithilfe der numerischen Standardoperatoren vergleichen, oder Sie können die CompareTo-Methode oder die Equals-Methode aufrufen.

Sie können die Member der Math-Klasse aufrufen, um eine hohe Anzahl numerischer Vorgängen, einschließlich das Abrufen des absoluten Wert einer Zahl, das Ableiten des Quotienten und den übrigen Teilen der ganzzahligen Division, Bestimmung des maximal oder des minimalen Wert von zwei ganze Zahlen, das Abrufen des Zeichens einer Zahl und das Runden eine Zahl auszuführen.

Stellt einen Byte-Wert als String dar

Der Byte-Typ bietet vollständige Unterstützung für Standard und benutzerdefinierte numerische Formatzeichenfolgen. (Weitere Informationen finden Sie unter Formatierung von Typen, Standardmäßige Zahlenformatzeichenfolgen und Benutzerdefinierte Zahlenformatzeichenfolgen.) Bytewerte werden jedoch am häufigsten als ein- bis dreistellige Werte ohne jede zusätzliche Formatierung dargestellt, oder als zweistellige Hexadezimalwerte.

Um einen Byte-Wert als ganzzahlige Zeichenfolge ohne führende Nullen zu formatieren, können Sie die parameterlose ToString()-Methode aufrufen. Mit dem Formatbezeichner "D" können Sie auch eine angegebene Anzahl von führenden Nullen in die Zeichenfolgendarstellung einschließen. Mit dem Formatspezifizierer "X" können Sie einen Byte-Wert als hexadezimale Zeichenfolge darstellen. Im folgenden Beispiel werden die Elemente in einem Array von Byte-Werten auf diese drei Arten formatiert.

Derzeit ist kein Code Beispiel verfügbar, oder die Sprache wird nicht unterstützt.

Sie können auch einen Byte-Wert als binäre, oktale, dezimale oder hexadezimale Zeichenfolge formatieren, indem Sie die ToString(Byte, Int32)-Methode aufrufen und die Basis als zweiten Parameter der Methode angeben. Im folgenden Beispiel wird diese Methode aufgerufen, um die binäre, oktale und hexadezimale Darstellung eines Arrays von Bytewerten anzuzeigen.

Derzeit ist kein Code Beispiel verfügbar, oder die Sprache wird nicht unterstützt.

Arbeiten mit nicht dezimalen Byte-Werten

Zusätzlich zum Arbeiten mit einzelnen Bytes als Dezimalwerte können Sie bitweise Operationen mit Bytewerten ausführen oder mit Bytearrays oder den binären oder hexadezimalen Darstellungen von Bytewerten arbeiten. Überladungen der BitConverter.GetBytes-Methode können z. B. jeden der primitiven Datentypen in ein Bytearray konvertieren, und die BigInteger.ToByteArray-Methode konvertiert einen BigInteger-Wert in ein Bytearray.

Byte -Werte werden nur durch ihre Größe, ohne Vorzeichenbit, in 8 Bits dargestellt. Dies muss beachtet werden, wenn Sie bitweise Operationen mit Byte-Werten ausführen, oder wenn Sie mit einzelnen Bits arbeiten. Um eine numerische, boolesche oder Vergleichsoperation für beliebige zwei Nicht-Dezimalwerte auszuführen, müssen beide Werte die gleiche Darstellung verwenden.

Wenn ein Vorgang für zwei Byte-Werte ausgeführt wird, werden die Werte gleich dargestellt, deshalb ist das Ergebnis genau. Dies wird im folgenden Beispiel veranschaulicht, in dem das niedrigstwertige Bit eines Byte-Werts maskiert wird, um sicherzustellen, dass dieser gerade ist.

Derzeit ist kein Code Beispiel verfügbar, oder die Sprache wird nicht unterstützt.

Wenn Sie andererseits mit Bits mit und auch ohne Vorzeichen arbeiten, werden bitweise Vorgänge vom Fakt kompliziert, dass die SByte-Werte die Vorzeichen-Wert-Darstellung für positive Werte und Zweierkomplementdarstellung für negative Werte verwenden. Um eine sinnvolle bitweise Operation auszuführen, müssen die Werte in zwei entsprechende Darstellungen konvertiert werden, und Informationen zum Vorzeichenbit müssen beibehalten werden. Im folgenden Beispiel wird dies ausgeführt, um Bits 2 und 4 in einem Array von 8-Bit-Ganzzahlen mit und ohne Vorzeichen zu maskieren.

Derzeit ist kein Code Beispiel verfügbar, oder die Sprache wird nicht unterstützt.

.NET Framework

Unterstützt in: 4.5.2, 4.5.1, 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

.NET für Windows Phone-Apps

Unterstützt in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, 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.

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.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft