SByte Struct

Definition

Important

This API is not CLS-compliant.

CLS-compliant alternative
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
[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.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
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
type sbyte = struct
    interface IFormattable
    interface IConvertible
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
Inheritance
Attributes
Implements

Remarks

Тип значения SByte представляет целые числа со значениями от отрицательного 128 до положительного 127.The SByte value type represents integers with values ranging from negative 128 to positive 127.

Important

Тип SByte несовместим с CLS.The SByte type is not CLS-compliant. Альтернативный тип, совместимый с CLS, — Int16.The CLS-compliant alternative type is Int16. Вместо этого можно использовать Byte, чтобы заменить положительное SByte значение в диапазоне от нуля до MaxValue.Byte can be used instead to replace a positive SByte value that ranges from zero to MaxValue. Дополнительные сведения о CLS-совместимости см. в разделе независимость от языка и независимые от языка компоненты.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.

Fields

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.

Methods

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

Возвращает TypeCode для типа значения SByte.Returns 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.

Explicit Interface Implementations

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

Возвращает TypeCode для этого экземпляра.Returns 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. Попытка его выполнения приводит к созданию исключения InvalidCastException.Attempting 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).

Applies to

Thread Safety

Все члены этого типа являются потокобезопасными.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.

See also