Utf8Formatter.TryFormat 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
TryFormat(Boolean, Span<Byte>, Int32, StandardFormat)
將 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 -> boolPublic 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)
將 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 -> boolPublic 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)
將 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 -> boolPublic 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 | 2017年1月3日08：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)
將 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 -> boolPublic 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)
將 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 -> boolPublic 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)
將 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 -> boolPublic 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)
將 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 -> boolPublic 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 (預設) | nnnn-nnnn-nnnn-nnnn-nnnnnn |
| B | {nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnn} |
| P | (nnnnnn-nnnn-nnnn-nnnn-nnnn-nnnn) |
| N | nn |
如果方法失敗，請反覆增加緩衝區的大小，然後重試直到成功為止。
適用於
TryFormat(Int16, Span<Byte>, Int32, StandardFormat)
將 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 -> boolPublic 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)
將 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 -> boolPublic 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)
將 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 -> boolPublic 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)
重要
此 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 -> boolPublic 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)
將 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 -> boolPublic 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)
將 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 -> boolPublic 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)
重要
此 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 -> boolPublic 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)
重要
此 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 -> boolPublic 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)
重要
此 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 -> boolPublic 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 |
如果方法失敗，請反覆增加緩衝區的大小，然後重試直到成功為止。
