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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
注釈
サポートされている形式:
| 文字列の書式設定 | 結果文字列の例 |
|---|---|
| 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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
注釈
サポートされている形式:
| 文字列の書式設定 | 結果文字列の例 |
|---|---|
| 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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
注釈
サポートされている形式:
| 文字列の書式設定 | 結果文字列の例 | コメント |
|---|---|---|
| G (既定値) | 05/25/2017 10:30:15 | |
| R | 2017 年 1 月 3 日 (火) 08:08:05 GMT | (RFC 1123) |
| l | 火, 03 jan 2017 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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
適用対象
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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
注釈
サポートされている形式:
| 文字列の書式設定 | 結果文字列の例 | コメント |
|---|---|---|
| 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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
注釈
サポートされている形式:
| 文字列の書式設定 | 結果文字列の例 | コメント |
|---|---|---|
| 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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
注釈
サポートされている形式:
| 文字列の書式設定 | 結果文字列 |
|---|---|
| D (既定値) | nnnnnnnn-nnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnnnn |
| B | {nnnnnnnn-nnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnnnn} |
| P | (nnnnnnnn-nnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnnnn) |
| N | nnnnnnnnnnnnnnnnnnnnnnnnnnnn |
メソッドが失敗した場合は、バッファーのサイズを繰り返し増やし、成功するまで再試行します。
適用対象
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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
注釈
サポートされている形式:
| 文字列の書式設定 | 結果文字列の例 |
|---|---|
| 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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
注釈
サポートされている形式:
| 文字列の書式設定 | 結果文字列の例 |
|---|---|
| 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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
注釈
サポートされている形式:
| 文字列の書式設定 | 結果文字列の例 |
|---|---|
| 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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
- 属性
注釈
サポートされている形式:
| 文字列の書式設定 | 結果文字列の例 |
|---|---|
| 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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
注釈
サポートされている形式:
| 文字列の書式設定 | 結果文字列の例 | コメント |
|---|---|---|
| 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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
注釈
サポートされている形式:
| 文字列の書式設定 | 結果文字列 | コメント |
|---|---|---|
| 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]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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
- 属性
注釈
サポートされている形式:
| 文字列の書式設定 | 結果文字列の例 |
|---|---|
| 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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
- 属性
注釈
サポートされている形式:
| 文字列の書式設定 | 結果文字列の例 |
|---|---|
| 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書式設定操作が成功した場合。falseが小さすぎる場合はdestinationします。
- 属性
注釈
サポートされている形式:
| 文字列の書式設定 | 結果文字列の例 |
|---|---|
| G/g (既定値) | |
| D/d | 32767 |
| N/n | 32,767 |
| X/x | 7fff |
メソッドが失敗した場合は、バッファーのサイズを繰り返し増やし、成功するまで再試行します。
