Utf8Formatter.TryFormat Methode

Definition

Überlädt

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

Formatiert eine Boolean UTF8-Zeichenfolge.

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

Formatiert eine Byte UTF8-Zeichenfolge.

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

Formatiert eine DateTime UTF8-Zeichenfolge.

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

Formatiert eine DateTimeOffset UTF8-Zeichenfolge.

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

Formatiert eine Decimal UTF8-Zeichenfolge.

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

Formatiert eine Double UTF8-Zeichenfolge.

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

Formatiert eine Guid UTF8-Zeichenfolge.

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

Formatiert eine Int16 UTF8-Zeichenfolge.

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

Formatiert eine Int32 UTF8-Zeichenfolge.

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

Formatiert eine Int64 UTF8-Zeichenfolge.

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

Formatiert eine SByte UTF8-Zeichenfolge.

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

Formatiert eine Single UTF8-Zeichenfolge.

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

Formatiert eine TimeSpan UTF8-Zeichenfolge.

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

Formatiert eine UInt16 UTF8-Zeichenfolge.

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

Formatiert eine UInt32 UTF8-Zeichenfolge.

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

Formatiert eine UInt64 UTF8-Zeichenfolge.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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.

destination
Span<Byte>

Der Puffer, in den der UTF8-formatierte Wert geschrieben werden soll.

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: