Utf8Formatter.TryFormat Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
TryFormat(Boolean, Span<Byte>, Int32, StandardFormat)
Formatiert eine Boolean UTF8-Zeichenfolge.
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
Parameter
- value
- Boolean
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
Hinweise
Unterstützte Formate:
| Format-String | Beispielergebniszeichenfolge |
|---|---|
| G (Standard) | Wahr/falsch |
| l | wahr/falsch |
Wenn die Methode fehlschlägt, vergrößern Sie die Größe des Puffers, und wiederholen Sie den Vorgang, bis sie erfolgreich ist.
Gilt für:
TryFormat(Byte, Span<Byte>, Int32, StandardFormat)
Formatiert eine Byte UTF8-Zeichenfolge.
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
Parameter
- value
- Byte
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
Hinweise
Unterstützte Formate:
| Format-String | Beispielergebniszeichenfolge |
|---|---|
| G/g (Standard) | |
| D/d | 122 |
| N/n | 122 |
| X/x | 7a |
Wenn die Methode fehlschlägt, vergrößern Sie die Größe des Puffers, und wiederholen Sie den Vorgang, bis sie erfolgreich ist.
Gilt für:
TryFormat(DateTime, Span<Byte>, Int32, StandardFormat)
Formatiert eine DateTime UTF8-Zeichenfolge.
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
Parameter
- value
- DateTime
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
Hinweise
Unterstützte Formate:
| Format-String | Beispielergebniszeichenfolge | Kommentare |
|---|---|---|
| G (Standard) | 05/25/2017 10:30:15 | |
| R | Di, 03 Jan 2017 08:08:05 GMT | (RFC 1123) |
| l | Di, 03 Jan 2017 08:08:05 gmt | (RFC 1123 in Kleinbuchstaben) |
| O | 2017-06-12T05:30:45.7680000-07:00 | (Roundtrippable) |
Wenn die Methode fehlschlägt, vergrößern Sie die Größe des Puffers, und wiederholen Sie den Vorgang, bis sie erfolgreich ist.
Gilt für:
TryFormat(DateTimeOffset, Span<Byte>, Int32, StandardFormat)
Formatiert eine DateTimeOffset UTF8-Zeichenfolge.
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
Parameter
- value
- DateTimeOffset
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
Gilt für:
TryFormat(Decimal, Span<Byte>, Int32, StandardFormat)
Formatiert eine Decimal UTF8-Zeichenfolge.
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
Parameter
- value
- Decimal
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
Hinweise
Unterstützte Formate:
| Format-String | Beispielergebniszeichenfolge | Kommentare |
|---|---|---|
| G/g (Standard) | ||
| F/f | 12.45 | Fixpunkt |
| E/e | 1.245000e1 | Exponentiell |
Wenn die Methode fehlschlägt, vergrößern Sie die Größe des Puffers, und wiederholen Sie den Vorgang, bis sie erfolgreich ist.
Gilt für:
TryFormat(Double, Span<Byte>, Int32, StandardFormat)
Formatiert eine Double UTF8-Zeichenfolge.
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
Parameter
- value
- Double
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
Hinweise
Unterstützte Formate:
| Format-String | Beispielergebniszeichenfolge | Kommentare |
|---|---|---|
| G/g (Standard) | ||
| F/f | 12.45 | Fixpunkt |
| E/e | 1.245000e1 | Exponentiell |
Wenn die Methode fehlschlägt, vergrößern Sie die Größe des Puffers, und wiederholen Sie den Vorgang, bis sie erfolgreich ist.
Gilt für:
TryFormat(Guid, Span<Byte>, Int32, StandardFormat)
Formatiert eine Guid UTF8-Zeichenfolge.
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
Parameter
- value
- Guid
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
Hinweise
Unterstützte Formate:
| Format-String | Ergebnisstring |
|---|---|
| D (Standard) | nnnn-n-n-n-n |
| B | {nnn-nnnn-n-n-n-n} |
| P | (nnn-n-n-n-n-n) |
| N | nnnn |
Wenn die Methode fehlschlägt, vergrößern Sie die Größe des Puffers, und wiederholen Sie den Vorgang, bis sie erfolgreich ist.
Gilt für:
TryFormat(Int16, Span<Byte>, Int32, StandardFormat)
Formatiert eine Int16 UTF8-Zeichenfolge.
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
Parameter
- value
- Int16
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
Hinweise
Unterstützte Formate:
| Format-String | Beispielergebniszeichenfolge |
|---|---|
| G/g (Standard) | |
| D/d | 32767 |
| N/n | 32.767 |
| X/x | 7fff |
Wenn die Methode fehlschlägt, vergrößern Sie die Größe des Puffers, und wiederholen Sie den Vorgang, bis sie erfolgreich ist.
Gilt für:
TryFormat(Int32, Span<Byte>, Int32, StandardFormat)
Formatiert eine Int32 UTF8-Zeichenfolge.
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
Parameter
- value
- Int32
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
Hinweise
Unterstützte Formate:
| Format-String | Beispielergebniszeichenfolge |
|---|---|
| G/g (Standard) | |
| D/d | 32767 |
| N/n | 32.767 |
| X/x | 7fff |
Wenn die Methode fehlschlägt, vergrößern Sie die Größe des Puffers, und wiederholen Sie den Vorgang, bis sie erfolgreich ist.
Gilt für:
TryFormat(Int64, Span<Byte>, Int32, StandardFormat)
Formatiert eine Int64 UTF8-Zeichenfolge.
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
Parameter
- value
- Int64
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
Hinweise
Unterstützte Formate:
| Format-String | Beispielergebniszeichenfolge |
|---|---|
| G/g (Standard) | |
| D/d | 32767 |
| N/n | 32.767 |
| X/x | 7fff |
Wenn die Methode fehlschlägt, vergrößern Sie die Größe des Puffers, und wiederholen Sie den Vorgang, bis sie erfolgreich ist.
Gilt für:
TryFormat(SByte, Span<Byte>, Int32, StandardFormat)
Wichtig
Diese API ist nicht CLS-kompatibel.
Formatiert eine SByte UTF8-Zeichenfolge.
[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
Parameter
- value
- SByte
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
- Attribute
Hinweise
Unterstützte Formate:
| Format-String | Beispielergebniszeichenfolge |
|---|---|
| G/g (Standard) | |
| D/d | 122 |
| N/n | 122 |
| X/x | 7a |
Wenn die Methode fehlschlägt, vergrößern Sie die Größe des Puffers, und wiederholen Sie den Vorgang, bis sie erfolgreich ist.
Gilt für:
TryFormat(Single, Span<Byte>, Int32, StandardFormat)
Formatiert eine Single UTF8-Zeichenfolge.
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
Parameter
- value
- Single
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
Hinweise
Unterstützte Formate:
| Format-String | Beispielergebniszeichenfolge | Kommentare |
|---|---|---|
| G/g (Standard) | ||
| F/f | 12.45 | Fixpunkt |
| E/e | 1.245000e1 | Exponentiell |
Wenn die Methode fehlschlägt, vergrößern Sie die Größe des Puffers, und wiederholen Sie den Vorgang, bis sie erfolgreich ist.
Gilt für:
TryFormat(TimeSpan, Span<Byte>, Int32, StandardFormat)
Formatiert eine TimeSpan UTF8-Zeichenfolge.
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
Parameter
- value
- TimeSpan
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
Hinweise
Unterstützte Formate:
| Format-String | Ergebnisstring | Kommentare |
|---|---|---|
| c/t/T (Standard) | [-][d.]hh:mm:ss[.fffffff] | (Konstantenformat) |
| G | %d:hh:mm:ss.fffffff | (allgemein lang) |
| g | [-][d:][h]h:mm:ss[.f[f[f[f[f[f[f[f]]]]]] | (allgemein kurz) |
Wenn die Methode fehlschlägt, vergrößern Sie die Größe des Puffers, und wiederholen Sie den Vorgang, bis sie erfolgreich ist.
Gilt für:
TryFormat(UInt16, Span<Byte>, Int32, StandardFormat)
Wichtig
Diese API ist nicht CLS-kompatibel.
Formatiert eine UInt16 UTF8-Zeichenfolge.
[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
Parameter
- value
- UInt16
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
- Attribute
Hinweise
Unterstützte Formate:
| Format-String | Beispielergebniszeichenfolge |
|---|---|
| G/g (Standard) | |
| D/d | 32767 |
| N/n | 32.767 |
| X/x | 7fff |
Wenn die Methode fehlschlägt, vergrößern Sie die Größe des Puffers, und wiederholen Sie den Vorgang, bis sie erfolgreich ist.
Gilt für:
TryFormat(UInt32, Span<Byte>, Int32, StandardFormat)
Wichtig
Diese API ist nicht CLS-kompatibel.
Formatiert eine UInt32 UTF8-Zeichenfolge.
[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
Parameter
- value
- UInt32
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
- Attribute
Hinweise
Unterstützte Formate:
| Format-String | Beispielergebniszeichenfolge |
|---|---|
| G/g (Standard) | |
| D/d | 32767 |
| N/n | 32.767 |
| X/x | 7fff |
Wenn die Methode fehlschlägt, vergrößern Sie die Größe des Puffers, und wiederholen Sie den Vorgang, bis sie erfolgreich ist.
Gilt für:
TryFormat(UInt64, Span<Byte>, Int32, StandardFormat)
Wichtig
Diese API ist nicht CLS-kompatibel.
Formatiert eine UInt64 UTF8-Zeichenfolge.
[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
Parameter
- value
- UInt64
Der zu formatierende Wert.
- bytesWritten
- Int32
Wenn die Methode zurückgegeben wird, enthält sie die Länge des formatierten Texts in Byte.
- format
- StandardFormat
Das zu verwendende Standardformat.
Gibt zurück
true wenn der Formatierungsvorgang erfolgreich ist; false ist destination zu klein.
- Attribute
Hinweise
Unterstützte Formate:
| Format-String | Beispielergebniszeichenfolge |
|---|---|
| G/g (Standard) | |
| D/d | 32767 |
| N/n | 32.767 |
| X/x | 7fff |
Wenn die Methode fehlschlägt, vergrößern Sie die Größe des Puffers, und wiederholen Sie den Vorgang, bis sie erfolgreich ist.