SByte 結構

定義

重要

此 API 不符合 CLS 規範。

符合 CLS 規範替代方案
System.Int16

代表 8 位元帶正負號的整數。Represents an 8-bit signed integer.

public value class SByte : IComparable, IComparable<System::SByte>, IConvertible, IEquatable<System::SByte>, IFormattable
public value class SByte : IComparable, IConvertible, IFormattable
public value class SByte : IComparable, IComparable<System::SByte>, IEquatable<System::SByte>, IFormattable
public struct SByte : IComparable, IComparable<sbyte>, IConvertible, IEquatable<sbyte>, IFormattable
[System.CLSCompliant(false)]
public struct SByte : IComparable, IComparable<sbyte>, IConvertible, IEquatable<sbyte>, IFormattable
[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
type sbyte = struct
    interface IConvertible
    interface IFormattable
[<System.CLSCompliant(false)>]
type sbyte = struct
    interface IConvertible
    interface IFormattable
[<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, IConvertible, IFormattable
Public Structure SByte
Implements IComparable, IComparable(Of SByte), IEquatable(Of SByte), IFormattable
繼承
屬性
實作

備註

SByte數值型別代表值範圍從負128到正數127的整數。The SByte value type represents integers with values ranging from negative 128 to positive 127.

重要

SByte類型不符合 CLS 規範。The SByte type is not CLS-compliant. 符合 CLS 標準的替代類型為 Int16The CLS-compliant alternative type is Int16. Byte 可以用來取代 SByte 從零到的正值 MaxValueByte can be used instead to replace a positive SByte value that ranges from zero to MaxValue. 如需 CLS 合規性的詳細資訊,請參閱 語言獨立性和 Language-Independent 元件For more information about CLS compliance, see Language Independence and Language-Independent Components.

SByte 提供方法來比較這個型別的實例,將實例的值轉換成其字串表示,然後將數位的字串表示轉換成這個型別的實例。SByte provides methods to compare instances of this type, convert the value of an instance to its string representation, and convert the string representation of a number to an instance of this type.

如需格式規格代碼如何控制實值型別之字串表示的詳細資訊,請參閱 格式化類型For information about how format specification codes control the string representation of value types, see Formatting Types.

欄位

MaxValue

代表 SByte 最大的可能值。Represents the largest possible value of SByte. 這個欄位為常數。This field is constant.

MinValue

代表 SByte 最小的可能值。Represents the smallest possible value of SByte. 這個欄位為常數。This field is constant.

方法

CompareTo(Object)

將這個執行個體與指定的物件相比較,並傳回它們的相對值指示。Compares this instance to a specified object and returns an indication of their relative values.

CompareTo(SByte)

將這個執行個體與指定的 8 元帶正負號的整數相比較,並傳回它們的相對值指示。Compares this instance to a specified 8-bit signed integer and returns an indication of their relative values.

Equals(Object)

傳回值,該值表示這個執行個體是否和指定的物件相等。Returns a value indicating whether this instance is equal to a specified object.

Equals(SByte)

傳回值,表示這個執行個體是否等於指定的 SByte 值。Returns a value indicating whether this instance is equal to a specified SByte value.

GetHashCode()

傳回這個執行個體的雜湊碼。Returns the hash code for this instance.

GetTypeCode()

傳回實值類型 TypeCodeSByteReturns the TypeCode for value type SByte.

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

將數字的範圍表示 (使用指定樣式和特定文化特性格式) 轉換為其對等 8 位元帶正負號的整數。Converts the span representation of a number that is in a specified style and culture-specific format to its 8-bit signed equivalent.

Parse(String)

將數字的字串表示轉換成它的對等 8 位元帶正負號的整數。Converts the string representation of a number to its 8-bit signed integer equivalent.

Parse(String, IFormatProvider)

將指定特定文化特性格式之數字的字串表示轉換成它的對等 8 位元帶正負號的整數。Converts the string representation of a number in a specified culture-specific format to its 8-bit signed integer equivalent.

Parse(String, NumberStyles)

將指定樣式之數字的字串表示轉換成它的對等 8 位元帶正負號的整數。Converts the string representation of a number in a specified style to its 8-bit signed integer equivalent.

Parse(String, NumberStyles, IFormatProvider)

將數字的字串表示 (使用指定的樣式和特定文化特性的格式) 轉換成它的對等 8 位元帶正負號的整數。Converts the string representation of a number that is in a specified style and culture-specific format to its 8-bit signed equivalent.

ToString()

將這個執行個體的數值轉換為其相等字串表示。Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider)

使用指定的特定文化特性格式資訊,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String)

使用指定格式,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString(String, IFormatProvider)

使用指定的格式和特定文化特性格式資訊,將這個執行個體的數值轉換成它的相等字串表示。Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

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

嘗試將目前 8 位元帶正負號的整數執行個體值格式化為所提供的字元範圍。Tries to format the value of the current 8-bit signed integer instance into the provided span of characters.

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

嘗試將數字的範圍表示 (使用指定樣式和特定文化特性格式) 轉換為其對等的 SByte,並傳回值以指出轉換是否成功。Tries to convert the span representation of a number in a specified style and culture-specific format to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(ReadOnlySpan<Char>, SByte)

嘗試將數字的範圍表示轉換為其對等的 SByte,並傳回值以指出轉換是否成功。Tries to convert the span representation of a number to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(String, NumberStyles, IFormatProvider, SByte)

使用指定的文化特性特定格式資訊和格式樣式,將日期和時間的指定字串表示轉換為其對等的 SByte,並傳回值,這個值表示轉換是否成功。Tries to convert the string representation of a number in a specified style and culture-specific format to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

TryParse(String, SByte)

嘗試將數字的字串表示轉換成其相等的 SByte,並傳回一個值表示轉換是否成功。Tries to convert the string representation of a number to its SByte equivalent, and returns a value that indicates whether the conversion succeeded.

明確介面實作

IComparable.CompareTo(Object)

將目前的執行個體與相同類型的另一個物件相比較,並傳回整數,這個整數表示目前的執行個體在排序次序中,位於另一個物件之前、之後或相同位置。Compares the current instance with another object of the same type and returns an integer that indicates whether the current instance precedes, follows, or occurs in the same position in the sort order as the other object.

IConvertible.GetTypeCode()

傳回這個執行個體的 TypeCodeReturns the TypeCode for this instance.

IConvertible.ToBoolean(IFormatProvider)

如需這個成員的說明,請參閱 ToBoolean(IFormatProvider)For a description of this member, see ToBoolean(IFormatProvider).

IConvertible.ToByte(IFormatProvider)

如需這個成員的說明,請參閱 ToByte(IFormatProvider)For a description of this member, see ToByte(IFormatProvider).

IConvertible.ToChar(IFormatProvider)

如需這個成員的說明,請參閱 ToChar(IFormatProvider)For a description of this member, see ToChar(IFormatProvider).

IConvertible.ToDateTime(IFormatProvider)

不支援此轉換。This conversion is not supported. 嘗試這麼做會擲回 InvalidCastExceptionAttempting to do so throws an InvalidCastException.

IConvertible.ToDecimal(IFormatProvider)

如需這個成員的說明,請參閱 ToDecimal(IFormatProvider)For a description of this member, see ToDecimal(IFormatProvider).

IConvertible.ToDouble(IFormatProvider)

如需這個成員的說明,請參閱 ToDouble(IFormatProvider)For a description of this member, see ToDouble(IFormatProvider).

IConvertible.ToInt16(IFormatProvider)

如需這個成員的說明,請參閱 ToInt16(IFormatProvider)For a description of this member, see ToInt16(IFormatProvider).

IConvertible.ToInt32(IFormatProvider)

如需這個成員的說明,請參閱 ToInt32(IFormatProvider)For a description of this member, see ToInt32(IFormatProvider).

IConvertible.ToInt64(IFormatProvider)

如需這個成員的說明,請參閱 ToInt64(IFormatProvider)For a description of this member, see ToInt64(IFormatProvider).

IConvertible.ToSByte(IFormatProvider)

如需這個成員的說明,請參閱 ToSByte(IFormatProvider)For a description of this member, see ToSByte(IFormatProvider).

IConvertible.ToSingle(IFormatProvider)

如需這個成員的說明,請參閱 ToSingle(IFormatProvider)For a description of this member, see ToSingle(IFormatProvider).

IConvertible.ToType(Type, IFormatProvider)

如需這個成員的說明,請參閱 ToType(Type, IFormatProvider)For a description of this member, see ToType(Type, IFormatProvider).

IConvertible.ToUInt16(IFormatProvider)

如需這個成員的說明,請參閱 ToUInt16(IFormatProvider)For a description of this member, see ToUInt16(IFormatProvider).

IConvertible.ToUInt32(IFormatProvider)

如需這個成員的說明,請參閱 ToUInt32(IFormatProvider)For a description of this member, see ToUInt32(IFormatProvider).

IConvertible.ToUInt64(IFormatProvider)

如需這個成員的說明,請參閱 ToUInt64(IFormatProvider)For a description of this member, see ToUInt64(IFormatProvider).

適用於

執行緒安全性

此類型的所有成員都是安全線程。All members of this type are thread safe. 看似修改實例狀態的成員,實際上會傳回以新值初始化的新實例。Members that appear to modify instance state actually return a new instance initialized with the new value. 如同任何其他類型,讀取和寫入包含此類型之實例的共用變數,都必須受到鎖定的保護,以保證執行緒安全。As with any other type, reading and writing to a shared variable that contains an instance of this type must be protected by a lock to guarantee thread safety.

另請參閱