Utf8Formatter.TryFormat 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
TryFormat(Boolean, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.Boolean.cs
- Source:
- Utf8Formatter.Boolean.cs
- Source:
- Utf8Formatter.Boolean.cs
将 Boolean 的格式设置为 UTF8 字符串。
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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
注解
支持的格式:
格式字符串 | 示例结果字符串 |
---|---|
G (默认) | True/False |
l | true/false |
如果方法失败,则以迭代方式增加缓冲区的大小,然后重试,直到成功。
适用于
TryFormat(Byte, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
将 Byte 的格式设置为 UTF8 字符串。
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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
注解
支持的格式:
格式字符串 | 示例结果字符串 |
---|---|
G/g (默认) | |
D/d | 122 |
N/n | 122 |
X/x | 7a |
如果方法失败,则以迭代方式增加缓冲区的大小,然后重试,直到成功。
适用于
TryFormat(DateTime, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.Date.cs
- Source:
- Utf8Formatter.Date.cs
- Source:
- Utf8Formatter.Date.cs
将 DateTime 的格式设置为 UTF8 字符串。
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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
注解
支持的格式:
格式字符串 | 示例结果字符串 | 注释 |
---|---|---|
G (默认) | 05/25/2017 10:30:15 | |
R | 星期二, 03 一月 2017 08:08:05 GMT | (RFC 1123) |
l | 星期二, 2017 年 1 月 3 日 08:08:05 gmt | (小写 RFC 1123) |
O | 2017-06-12T05:30:45.7680000-07:00 | (往返) |
如果方法失败,则以迭代方式增加缓冲区的大小,然后重试,直到成功。
适用于
TryFormat(DateTimeOffset, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.Date.cs
- Source:
- Utf8Formatter.Date.cs
- Source:
- Utf8Formatter.Date.cs
将 DateTimeOffset 的格式设置为 UTF8 字符串。
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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
适用于
TryFormat(Decimal, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.Decimal.cs
- Source:
- Utf8Formatter.Decimal.cs
- Source:
- Utf8Formatter.Decimal.cs
将 Decimal 的格式设置为 UTF8 字符串。
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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
注解
支持的格式:
格式字符串 | 示例结果字符串 | 注释 |
---|---|---|
G/g (默认) | ||
F/f | 12.45 | 固定点 |
E/e | 1.245000e1 | 指数 |
如果方法失败,则以迭代方式增加缓冲区的大小,然后重试,直到成功。
适用于
TryFormat(Double, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.Float.cs
- Source:
- Utf8Formatter.Float.cs
- Source:
- Utf8Formatter.Float.cs
将 Double 的格式设置为 UTF8 字符串。
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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
注解
支持的格式:
格式字符串 | 示例结果字符串 | 注释 |
---|---|---|
G/g (默认) | ||
F/f | 12.45 | 固定点 |
E/e | 1.245000e1 | 指数 |
如果方法失败,则以迭代方式增加缓冲区的大小,然后重试,直到成功。
适用于
TryFormat(Guid, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.Guid.cs
- Source:
- Utf8Formatter.Guid.cs
- Source:
- Utf8Formatter.Guid.cs
将 Guid 的格式设置为 UTF8 字符串。
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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
注解
支持的格式:
格式字符串 | 结果字符串 |
---|---|
D (默认) | nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnn |
B | {nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnn} |
P | (nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn) |
N | nnnnnnnnnnnnnnnnnnnnnnnnnn |
如果方法失败,则以迭代方式增加缓冲区的大小,然后重试,直到成功。
适用于
TryFormat(Int16, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
将 Int16 的格式设置为 UTF8 字符串。
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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
注解
支持的格式:
格式字符串 | 示例结果字符串 |
---|---|
G/g (默认) | |
D/d | 32767 |
N/n | 32,767 |
X/x | 7fff |
如果方法失败,则以迭代方式增加缓冲区的大小,然后重试,直到成功。
适用于
TryFormat(Int32, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
将 Int32 的格式设置为 UTF8 字符串。
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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
注解
支持的格式:
格式字符串 | 示例结果字符串 |
---|---|
G/g (默认) | |
D/d | 32767 |
N/n | 32,767 |
X/x | 7fff |
如果方法失败,则以迭代方式增加缓冲区的大小,然后重试,直到成功。
适用于
TryFormat(Int64, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
将 Int64 的格式设置为 UTF8 字符串。
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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
注解
支持的格式:
格式字符串 | 示例结果字符串 |
---|---|
G/g (默认) | |
D/d | 32767 |
N/n | 32,767 |
X/x | 7fff |
如果方法失败,则以迭代方式增加缓冲区的大小,然后重试,直到成功。
适用于
TryFormat(SByte, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
重要
此 API 不符合 CLS。
将 SByte 的格式设置为 UTF8 字符串。
[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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
- 属性
注解
支持的格式:
格式字符串 | 示例结果字符串 |
---|---|
G/g (默认) | |
D/d | 122 |
N/n | 122 |
X/x | 7a |
如果方法失败,则以迭代方式增加缓冲区的大小,然后重试,直到成功。
适用于
TryFormat(Single, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.Float.cs
- Source:
- Utf8Formatter.Float.cs
- Source:
- Utf8Formatter.Float.cs
将 Single 的格式设置为 UTF8 字符串。
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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
注解
支持的格式:
格式字符串 | 示例结果字符串 | 注释 |
---|---|---|
G/g (默认) | ||
F/f | 12.45 | 固定点 |
E/e | 1.245000e1 | 指数 |
如果方法失败,则以迭代方式增加缓冲区的大小,然后重试,直到成功。
适用于
TryFormat(TimeSpan, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.TimeSpan.cs
- Source:
- Utf8Formatter.TimeSpan.cs
- Source:
- Utf8Formatter.TimeSpan.cs
将 TimeSpan 的格式设置为 UTF8 字符串。
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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
注解
支持的格式:
格式字符串 | 结果字符串 | 注释 | |
---|---|---|---|
c/t/T (默认) | [-][d.]hh:mm:ss[.fffffff] | (常量格式) | |
G | [-]d:hh:mm:ss.fffffff | (常规长) | |
g | [-][d:][h]h:mm:ss[.f[f[f[f[f[f[f]]]]]] | (常规短) |
如果方法失败,则以迭代方式增加缓冲区的大小,然后重试,直到成功。
适用于
TryFormat(UInt16, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
重要
此 API 不符合 CLS。
将 UInt16 的格式设置为 UTF8 字符串。
[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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
- 属性
注解
支持的格式:
格式字符串 | 示例结果字符串 |
---|---|
G/g (默认) | |
D/d | 32767 |
N/n | 32,767 |
X/x | 7fff |
如果方法失败,则以迭代方式增加缓冲区的大小,然后重试,直到成功。
适用于
TryFormat(UInt32, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
重要
此 API 不符合 CLS。
将 UInt32 的格式设置为 UTF8 字符串。
[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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
- 属性
注解
支持的格式:
格式字符串 | 示例结果字符串 |
---|---|
G/g (默认) | |
D/d | 32767 |
N/n | 32,767 |
X/x | 7fff |
如果方法失败,则以迭代方式增加缓冲区的大小,然后重试,直到成功。
适用于
TryFormat(UInt64, Span<Byte>, Int32, StandardFormat)
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
- Source:
- Utf8Formatter.Integer.cs
重要
此 API 不符合 CLS。
将 UInt64 的格式设置为 UTF8 字符串。
[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
要格式化的值。
- bytesWritten
- Int32
方法返回时,包含格式化文本的长度(以字节为单位)。
- format
- StandardFormat
要使用的标准格式。
返回
如果格式设置操作成功,则为 true
;如果 destination
太小,则为 false
。
- 属性
注解
支持的格式:
格式字符串 | 示例结果字符串 |
---|---|
G/g (默认) | |
D/d | 32767 |
N/n | 32,767 |
X/x | 7fff |
如果方法失败,则以迭代方式增加缓冲区的大小,然后重试,直到成功。