Utf8Formatter.TryFormat Метод

Определение

Пространство имен:

System.Buffers.Text

Сборка:

System.Memory.dll

Перегрузки

TryFormat(Boolean, Span<Byte>, Int32, StandardFormat)	Форматирует значение Boolean как строку UTF-8.
TryFormat(Byte, Span<Byte>, Int32, StandardFormat)	Форматирует значение Byte как строку UTF-8.
TryFormat(DateTime, Span<Byte>, Int32, StandardFormat)	Форматирует значение DateTime как строку UTF-8.
TryFormat(DateTimeOffset, Span<Byte>, Int32, StandardFormat)	Форматирует значение DateTimeOffset как строку UTF-8.
TryFormat(Decimal, Span<Byte>, Int32, StandardFormat)	Форматирует значение Decimal как строку UTF-8.
TryFormat(Double, Span<Byte>, Int32, StandardFormat)	Форматирует значение Double как строку UTF-8.
TryFormat(Guid, Span<Byte>, Int32, StandardFormat)	Форматирует значение Guid как строку UTF-8.
TryFormat(Int16, Span<Byte>, Int32, StandardFormat)	Форматирует значение Int16 как строку UTF-8.
TryFormat(Int32, Span<Byte>, Int32, StandardFormat)	Форматирует значение Int32 как строку UTF-8.
TryFormat(Int64, Span<Byte>, Int32, StandardFormat)	Форматирует значение Int64 как строку UTF-8.
TryFormat(SByte, Span<Byte>, Int32, StandardFormat)	Форматирует значение SByte как строку UTF-8.
TryFormat(Single, Span<Byte>, Int32, StandardFormat)	Форматирует значение Single как строку UTF-8.
TryFormat(TimeSpan, Span<Byte>, Int32, StandardFormat)	Форматирует значение TimeSpan как строку UTF-8.
TryFormat(UInt16, Span<Byte>, Int32, StandardFormat)	Форматирует значение UInt16 как строку UTF-8.
TryFormat(UInt32, Span<Byte>, Int32, StandardFormat)	Форматирует значение UInt32 как строку UTF-8.
TryFormat(UInt64, Span<Byte>, Int32, StandardFormat)	Форматирует значение UInt64 как строку UTF-8.

TryFormat(Boolean, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.Boolean.cs

Форматирует значение Boolean как строку UTF-8.

public static bool TryFormat (bool value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

static member TryFormat : bool * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As Boolean, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

Boolean

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

Комментарии

Поддерживаемые форматы:

Строка форматирования	Пример строки результата
G (по умолчанию)	Истина/ложь
l	true/false

Если метод завершается сбоем, итеративно увеличьте размер буфера и повторите попытку, пока не будет выполнено успешное выполнение.

TryFormat(Byte, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.Integer.cs

Форматирует значение Byte как строку UTF-8.

public static bool TryFormat (byte value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

static member TryFormat : byte * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As Byte, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

Byte

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

Комментарии

Поддерживаемые форматы:

Строка форматирования	Пример строки результата
G/g (по умолчанию)
D/d	122
N/n	122
X/x	7а

Если метод завершается сбоем, итеративно увеличьте размер буфера и повторите попытку, пока не будет выполнено успешное выполнение.

TryFormat(DateTime, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.Date.cs

Форматирует значение DateTime как строку UTF-8.

public static bool TryFormat (DateTime value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

static member TryFormat : DateTime * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As DateTime, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

DateTime

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

Комментарии

Поддерживаемые форматы:

Строка форматирования	Пример строки результата	Комментарии
G (по умолчанию)	05/25/2017 10:30:15
R	Вт, 03 Января 2017 08:08:05 GMT	(RFC 1123)
l	вт, 03 января 2017 08:08:05 gmt	(Строчная версия RFC 1123)
O	2017-06-12T12:30:45.768+00:00	(с возможностью кругового пути)

Если метод завершается сбоем, итеративно увеличьте размер буфера и повторите попытку, пока не будет выполнено успешное выполнение.

TryFormat(DateTimeOffset, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.Date.cs

Форматирует значение DateTimeOffset как строку UTF-8.

public static bool TryFormat (DateTimeOffset value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

static member TryFormat : DateTimeOffset * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As DateTimeOffset, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

DateTimeOffset

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

TryFormat(Decimal, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.Decimal.cs

Форматирует значение Decimal как строку UTF-8.

public static bool TryFormat (decimal value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

static member TryFormat : decimal * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As Decimal, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

Decimal

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

Комментарии

Поддерживаемые форматы:

Строка форматирования	Пример строки результата	Комментарии
G/g (по умолчанию)
F/f	12.45	Фиксированная точка
E/e	1.245000e1	Экспоненциально

Если метод завершается сбоем, итеративно увеличьте размер буфера и повторите попытку, пока не будет выполнено успешное выполнение.

TryFormat(Double, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.Float.cs

Форматирует значение Double как строку UTF-8.

public static bool TryFormat (double value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

static member TryFormat : double * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As Double, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

Double

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

Комментарии

Поддерживаемые форматы:

Строка форматирования	Пример строки результата	Комментарии
G/g (по умолчанию)
F/f	12.45	Фиксированная точка
E/e	1.245000e1	Экспоненциально

Если метод завершается сбоем, итеративно увеличьте размер буфера и повторите попытку, пока не будет выполнено успешное выполнение.

TryFormat(Guid, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.Guid.cs

Форматирует значение Guid как строку UTF-8.

public static bool TryFormat (Guid value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

static member TryFormat : Guid * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As Guid, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

Guid

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

Комментарии

Поддерживаемые форматы:

Строка форматирования	Результирующая строка
D (по умолчанию)	nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnnnnnn
B	{nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnnnn}
P	(nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnn)
N	nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn

Если метод завершается сбоем, итеративно увеличьте размер буфера и повторите попытку, пока не будет выполнено успешное выполнение.

TryFormat(Int16, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.Integer.cs

Форматирует значение Int16 как строку UTF-8.

public static bool TryFormat (short value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

static member TryFormat : int16 * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As Short, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

Int16

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

Комментарии

Поддерживаемые форматы:

Строка форматирования	Пример строки результата
G/g (по умолчанию)
Д/д	32767
N/n	32 767
X/x	7fff

Если метод завершается сбоем, итеративно увеличьте размер буфера и повторите попытку, пока не будет выполнено успешное выполнение.

TryFormat(Int32, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.Integer.cs

Форматирует значение Int32 как строку UTF-8.

public static bool TryFormat (int value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

static member TryFormat : int * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As Integer, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

Int32

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

Комментарии

Поддерживаемые форматы:

Строка форматирования	Пример строки результата
G/g (по умолчанию)
Д/д	32767
N/n	32 767
X/x	7fff

Если метод завершается сбоем, итеративно увеличьте размер буфера и повторите попытку, пока не будет выполнено успешное выполнение.

TryFormat(Int64, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.Integer.cs

Форматирует значение Int64 как строку UTF-8.

public static bool TryFormat (long value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

static member TryFormat : int64 * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As Long, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

Int64

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

Комментарии

Поддерживаемые форматы:

Строка форматирования	Пример строки результата
G/g (по умолчанию)
Д/д	32767
N/n	32 767
X/x	7fff

Если метод завершается сбоем, итеративно увеличьте размер буфера и повторите попытку, пока не будет выполнено успешное выполнение.

TryFormat(SByte, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.Integer.cs

Важно!

Этот API несовместим с CLS.

Форматирует значение SByte как строку UTF-8.

[System.CLSCompliant(false)]
public static bool TryFormat (sbyte value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

[<System.CLSCompliant(false)>]
static member TryFormat : sbyte * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As SByte, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

SByte

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

Атрибуты

CLSCompliantAttribute

Комментарии

Поддерживаемые форматы:

Строка форматирования	Пример строки результата
G/g (по умолчанию)
Д/д	122
N/n	122
X/x	7а

Если метод завершается сбоем, итеративно увеличьте размер буфера и повторите попытку, пока не будет выполнено успешное выполнение.

TryFormat(Single, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.Float.cs

Форматирует значение Single как строку UTF-8.

public static bool TryFormat (float value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

static member TryFormat : single * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As Single, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

Single

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

Комментарии

Поддерживаемые форматы:

Строка форматирования	Пример строки результата	Комментарии
G/g (по умолчанию)
F/f	12.45	Фиксированная точка
E/e	1.245000e1	Экспоненциально

Если метод завершается сбоем, итеративно увеличьте размер буфера и повторите попытку, пока не будет выполнено успешное выполнение.

TryFormat(TimeSpan, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.TimeSpan.cs

Форматирует значение TimeSpan как строку UTF-8.

public static bool TryFormat (TimeSpan value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

static member TryFormat : TimeSpan * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As TimeSpan, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

TimeSpan

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

Комментарии

Поддерживаемые форматы:

Строка форматирования	Результирующая строка	Комментарии
c/t/T (по умолчанию)	[-][d.]hh:mm:ss[.fffffff]	(формат константы)
G	[-]d:hh:mm:ss.fffffff		(общий длинный)
н	[-] [d:] [h]h:mm:ss[.f[f[f[f[f[f[f[f[f]]]]]]	(общий короткий)

Если метод завершается сбоем, итеративно увеличьте размер буфера и повторите попытку, пока не будет выполнено успешное выполнение.

TryFormat(UInt16, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.Integer.cs

Важно!

Этот API несовместим с CLS.

Форматирует значение UInt16 как строку UTF-8.

[System.CLSCompliant(false)]
public static bool TryFormat (ushort value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

[<System.CLSCompliant(false)>]
static member TryFormat : uint16 * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As UShort, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

UInt16

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

Атрибуты

CLSCompliantAttribute

Комментарии

Поддерживаемые форматы:

Строка форматирования	Пример строки результата
G/g (по умолчанию)
Д/д	32767
N/n	32 767
X/x	7fff

Если метод завершается сбоем, итеративно увеличьте размер буфера и повторите попытку, пока не будет выполнено успешное выполнение.

TryFormat(UInt32, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.Integer.cs

Важно!

Этот API несовместим с CLS.

Форматирует значение UInt32 как строку UTF-8.

[System.CLSCompliant(false)]
public static bool TryFormat (uint value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

[<System.CLSCompliant(false)>]
static member TryFormat : uint32 * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As UInteger, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

UInt32

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

Атрибуты

CLSCompliantAttribute

Комментарии

Поддерживаемые форматы:

Строка форматирования	Пример строки результата
G/g (по умолчанию)
Д/д	32767
N/n	32 767
X/x	7fff

Если метод завершается сбоем, итеративно увеличьте размер буфера и повторите попытку, пока не будет выполнено успешное выполнение.

TryFormat(UInt64, Span<Byte>, Int32, StandardFormat)

Исходный код:

Utf8Formatter.Integer.cs

Важно!

Этот API несовместим с CLS.

Форматирует значение UInt64 как строку UTF-8.

[System.CLSCompliant(false)]
public static bool TryFormat (ulong value, Span<byte> destination, out int bytesWritten, System.Buffers.StandardFormat format = default);

[<System.CLSCompliant(false)>]
static member TryFormat : uint64 * Span<byte> * int * System.Buffers.StandardFormat -> bool

Public Shared Function TryFormat (value As ULong, destination As Span(Of Byte), ByRef bytesWritten As Integer, Optional format As StandardFormat = Nothing) As Boolean

Параметры

value

UInt64

Форматируемое значение.

destination

Span<Byte>

Буфер, в который записывается форматированное значение UTF-8.

bytesWritten

Int32

Когда метод возвращает управление, содержит длину форматированного текста в байтах.

format

StandardFormat

Стандартный формат, который необходимо использовать.

Возвращаемое значение

Boolean

Значение true, если операция форматирования завершается успешно; значение false, если буфер destination слишком мал.

Атрибуты

CLSCompliantAttribute

Комментарии

Поддерживаемые форматы:

Строка форматирования	Пример строки результата
G/g (по умолчанию)
Д/д	32767
N/n	32 767
X/x	7fff

Если метод завершается сбоем, итеративно увеличьте размер буфера и повторите попытку, пока не будет выполнено успешное выполнение.