UInt32.TryParse Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Bir sayının dize gösterimini 32 bit işaretsiz tamsayı eşdeğerine dönüştürmeyi dener. Dönüştürmenin başarılı veya başarısız olduğunu gösteren dönüş değeri.
Aşırı Yüklemeler
TryParse(ReadOnlySpan<Byte>, IFormatProvider, UInt32) |
UTF-8 karakterlik bir aralığı bir değere ayrıştırmaya çalışır. |
TryParse(ReadOnlySpan<Char>, UInt32) |
Bir sayının span gösterimini 32 bit işaretsiz tamsayı eşdeğerine dönüştürmeyi dener. Dönüştürmenin başarılı veya başarısız olduğunu gösteren dönüş değeri. |
TryParse(String, UInt32) |
Bir sayının dize gösterimini 32 bit işaretsiz tamsayı eşdeğerine dönüştürmeyi dener. Dönüştürmenin başarılı veya başarısız olduğunu gösteren dönüş değeri. |
TryParse(ReadOnlySpan<Char>, IFormatProvider, UInt32) |
Bir karakter aralığını bir değere ayrıştırmaya çalışır. |
TryParse(String, IFormatProvider, UInt32) |
Bir dizeyi bir değere ayrıştırmaya çalışır. |
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, UInt32) |
UTF-8 karakterlik bir aralığı bir değere ayrıştırmaya çalışır. |
TryParse(ReadOnlySpan<Byte>, UInt32) |
Bir sayının dize gösterimini içeren UTF-8 karakter aralığını 32 bit işaretsiz tamsayı eşdeğerine dönüştürmeye çalışır. |
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt32) |
Bir sayının belirtilen stil ve kültüre özgü biçimdeki span gösterimini 32 bit işaretsiz tamsayı eşdeğerine dönüştürmeyi dener. Dönüştürmenin başarılı veya başarısız olduğunu gösteren dönüş değeri. |
TryParse(String, NumberStyles, IFormatProvider, UInt32) |
Belirtilen stilde ve kültüre özgü biçimdeki bir sayının dize gösterimini 32 bit işaretsiz tamsayı eşdeğerine dönüştürmeyi dener. Dönüştürmenin başarılı veya başarısız olduğunu gösteren dönüş değeri. |
TryParse(ReadOnlySpan<Byte>, IFormatProvider, UInt32)
- Kaynak:
- UInt32.cs
- Kaynak:
- UInt32.cs
UTF-8 karakterlik bir aralığı bir değere ayrıştırmaya çalışır.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt32 % result) = IUtf8SpanParsable<System::UInt32>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out uint result);
static member TryParse : ReadOnlySpan<byte> * IFormatProvider * uint32 -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As UInteger) As Boolean
Parametreler
- utf8Text
- ReadOnlySpan<Byte>
Ayrıştırılacak UTF-8 karakter aralığı.
- provider
- IFormatProvider
hakkında utf8Text
kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.
- result
- UInt32
Sonuç olarak, başarıyla ayrıştırma utf8Text
işleminin sonucunu veya hata durumunda tanımlanmamış bir değeri içerir.
Döndürülenler
true
başarıyla ayrıştırıldıysa utf8Text
; değilse, false
.
Şunlara uygulanır
TryParse(ReadOnlySpan<Char>, UInt32)
- Kaynak:
- UInt32.cs
- Kaynak:
- UInt32.cs
- Kaynak:
- UInt32.cs
Önemli
Bu API, CLS uyumlu değildir.
Bir sayının span gösterimini 32 bit işaretsiz tamsayı eşdeğerine dönüştürmeyi dener. Dönüştürmenin başarılı veya başarısız olduğunu gösteren dönüş değeri.
public:
static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::UInt32 % result);
public static bool TryParse (ReadOnlySpan<char> s, out uint result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, out uint result);
static member TryParse : ReadOnlySpan<char> * uint32 -> bool
[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * uint32 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As UInteger) As Boolean
Parametreler
- s
- ReadOnlySpan<Char>
Dönüştürülecek sayıyı temsil eden karakterleri içeren bir yayılma alanı.
- result
- UInt32
Bu yöntem döndürdüğünde, içinde bulunan s
sayının eşdeğeri olan 32 bit işaretsiz tamsayı değerini, dönüştürme başarılı olursa değerini veya dönüştürme başarısız olursa sıfırı içerir. veya parametresi null
Emptydoğru biçimde değilse s
veya UInt32.MinValue değerinden küçük veya UInt32.MaxValue değerinden büyük bir sayıyı temsil ederse dönüştürme başarısız olur. Bu parametre başlatılmadan geçirilir; başlangıçta sağlanan result
tüm değerlerin üzerine yazılır.
Döndürülenler
true
başarıyla dönüştürüldüyse s
; aksi takdirde , false
.
- Öznitelikler
Şunlara uygulanır
TryParse(String, UInt32)
- Kaynak:
- UInt32.cs
- Kaynak:
- UInt32.cs
- Kaynak:
- UInt32.cs
Bir sayının dize gösterimini 32 bit işaretsiz tamsayı eşdeğerine dönüştürmeyi dener. Dönüştürmenin başarılı veya başarısız olduğunu gösteren dönüş değeri.
public:
static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] System::UInt32 % result);
[System.CLSCompliant(false)]
public static bool TryParse (string s, out uint result);
public static bool TryParse (string? s, out uint result);
[System.CLSCompliant(false)]
public static bool TryParse (string? s, out uint result);
[<System.CLSCompliant(false)>]
static member TryParse : string * uint32 -> bool
static member TryParse : string * uint32 -> bool
Public Shared Function TryParse (s As String, ByRef result As UInteger) As Boolean
Parametreler
- s
- String
Dönüştürülecek sayıyı temsil eden bir dize.
- result
- UInt32
Bu yöntem döndürdüğünde, içinde bulunan s
sayının eşdeğeri olan 32 bit işaretsiz tamsayı değerini, dönüştürme başarılı olursa değerini veya dönüştürme başarısız olursa sıfırı içerir. veya parametresi null
Emptydoğru biçimde değilse s
veya UInt32.MinValue değerinden küçük veya UInt32.MaxValue değerinden büyük bir sayıyı temsil ederse dönüştürme başarısız olur. Bu parametre başlatılmadan geçirilir; başlangıçta sağlanan result
tüm değerlerin üzerine yazılır.
Döndürülenler
true
başarıyla dönüştürüldüyse s
; aksi takdirde , false
.
- Öznitelikler
Örnekler
Aşağıdaki örnek, bir dize dizisindeki TryParse(String, UInt32) her öğe için yöntemini bir kez çağırır.
string[] numericStrings = { "1293.8", "+1671.7", "28347.",
" 33113684 ", "(0)", "-0", "-1",
"+1293617", "18-", "119870", "31,024",
" 3127094 ", "00700000" };
uint number;
foreach (string numericString in numericStrings)
{
if (UInt32.TryParse(numericString, out number))
Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
else
Console.WriteLine("Cannot convert '{0}' to a UInt32.", numericString);
}
// The example displays the following output:
// Cannot convert '1293.8' to a UInt32.
// Cannot convert '+1671.7' to a UInt32.
// Cannot convert '28347.' to a UInt32.
// Converted ' 33113684 ' to 33113684.
// Cannot convert '(0)' to a UInt32.
// Converted '-0' to 0.
// Cannot convert '-1' to a UInt32.
// Converted '+1293617' to 1293617.
// Cannot convert '18-' to a UInt32.
// Converted '119870' to 119870.
// Cannot convert '31,024' to a UInt32.
// Converted ' 3127094 ' to 3127094.
// Converted '0070000' to 70000.
let numericStrings =
[| "1293.8"; "+1671.7"; "28347."
" 33113684 "; "(0)"; "-0"; "-1"
"+1293617"; "18-"; "119870"; "31,024"
" 3127094 "; "00700000" |]
for numericString in numericStrings do
match UInt32.TryParse numericString with
| true, number ->
printfn $"Converted '{numericString}' to {number}."
| _ ->
printfn $"Cannot convert '{numericString}' to a UInt32."
// The example displays the following output:
// Cannot convert '1293.8' to a UInt32.
// Cannot convert '+1671.7' to a UInt32.
// Cannot convert '28347.' to a UInt32.
// Converted ' 33113684 ' to 33113684.
// Cannot convert '(0)' to a UInt32.
// Converted '-0' to 0.
// Cannot convert '-1' to a UInt32.
// Converted '+1293617' to 1293617.
// Cannot convert '18-' to a UInt32.
// Converted '119870' to 119870.
// Cannot convert '31,024' to a UInt32.
// Converted ' 3127094 ' to 3127094.
// Converted '0070000' to 70000.
Dim numericStrings() As String = {"1293.8", "+1671.7", "28347.",
" 33113684 ", "(0)", "-0", "-1",
"+1293617", "18-", "119870",
"31,024", " 3127094 ", "0070000" }
Dim number As UInteger
For Each numericString As String In numericStrings
If UInt32.TryParse(numericString, number) Then
Console.WriteLine("Converted '{0}' to {1}.", numericString, number)
Else
Console.WriteLine("Cannot convert '{0}' to a UInt32.", numericString)
End If
Next
' The example displays the following output:
' Cannot convert '1293.8' to a UInt32.
' Cannot convert '+1671.7' to a UInt32.
' Cannot convert '28347.' to a UInt32.
' Converted ' 33113684 ' to 33113684.
' Cannot convert '(0)' to a UInt32.
' Converted '-0' to 0.
' Cannot convert '-1' to a UInt32.
' Converted '+1293617' to 1293617.
' Cannot convert '18-' to a UInt32.
' Converted '119870' to 119870.
' Cannot convert '31,024' to a UInt32.
' Converted ' 3127094 ' to 3127094.
' Converted '0070000' to 70000.
Açıklamalar
TryParse yöntemi yöntemine Parse benzer, ancak dönüştürme başarısız olursa bir özel durum oluşturmaz. Bu yöntem, geçersiz olup olmadığını s
test etmek için FormatException özel durum işleme kullanma gereksinimini ortadan kaldırır ve başarıyla ayrıştırılamaz.
parametresi, s
aşağıdaki biçimde bir ondalık sayının dize gösterimi olmalıdır:
[ws] [sign] rakamlar[ws]
Köşeli ayraçlar ([ve]) içindeki öğeler isteğe bağlıdır. Aşağıdaki tablo her öğeyi açıklar.
Öğe | Açıklama |
---|---|
Ws | İsteğe bağlı beyaz boşluk. |
sign | İsteğe bağlı bir işaret. Geçerli işaret karakterleri geçerli kültürün NumberFormatInfo.NegativeSign ve NumberFormatInfo.PositiveSign özellikleri tarafından belirlenir. |
Basamak | 0 İle 9 arasında ondalık basamak dizisi. |
s
parametresi stil kullanılarak NumberStyles.Integer yorumlanır. Ondalık basamaklara ek olarak, baştaki ve sondaki boşluklara yalnızca önde gelen bir işaretle birlikte izin verilir. stil öğelerini içinde bulunabilecek s
kültüre özgü biçimlendirme bilgileriyle açıkça tanımlamak için yöntemini çağırın TryParse(String, NumberStyles, IFormatProvider, UInt32) .
Not
parametresi tarafından s
belirtilen dize herhangi bir grup ayırıcısı veya ondalık ayırıcı içeremez ve kesirli bir bölümüne sahip olamaz.
s
parametresi, geçerli sistem kültürü için bir NumberFormatInfo nesnedeki biçimlendirme bilgileri kullanılarak ayrıştırılır. Daha fazla bilgi için bkz. NumberFormatInfo.CurrentInfo.
Bu aşırı yükleme, parametredeki s
tüm basamakları ondalık basamaklar olarak yorumlar. Onaltılık bir sayının dize gösterimini ayrıştırmak için bunun yerine aşırı yüklemeyi çağırın TryParse(String, NumberStyles, IFormatProvider, UInt32) .
Ayrıca bkz.
- Parse(String)
- ToString()
- .NET'te Sayısal Dizeleri Ayrıştırma
- Örnek: .NET Core WinForms Biçimlendirme Yardımcı Programı (C#)
- Örnek: .NET Core WinForms Biçimlendirme Yardımcı Programı (Visual Basic)
Şunlara uygulanır
TryParse(ReadOnlySpan<Char>, IFormatProvider, UInt32)
- Kaynak:
- UInt32.cs
- Kaynak:
- UInt32.cs
- Kaynak:
- UInt32.cs
Bir karakter aralığını bir değere ayrıştırmaya çalışır.
public:
static bool TryParse(ReadOnlySpan<char> s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt32 % result) = ISpanParsable<System::UInt32>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out uint result);
static member TryParse : ReadOnlySpan<char> * IFormatProvider * uint32 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As UInteger) As Boolean
Parametreler
- s
- ReadOnlySpan<Char>
Ayrıştırılacak karakterlerin yayılması.
- provider
- IFormatProvider
hakkında s
kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.
- result
- UInt32
Bu yöntem döndürdüğünde, başarıyla ayrıştırma s
işleminin sonucunu veya hatada tanımlanmamış bir değeri içerir.
Döndürülenler
true
başarıyla ayrıştırıldıysa s
; değilse, false
.
Şunlara uygulanır
TryParse(String, IFormatProvider, UInt32)
- Kaynak:
- UInt32.cs
- Kaynak:
- UInt32.cs
- Kaynak:
- UInt32.cs
Bir dizeyi bir değere ayrıştırmaya çalışır.
public:
static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt32 % result) = IParsable<System::UInt32>::TryParse;
public static bool TryParse (string? s, IFormatProvider? provider, out uint result);
static member TryParse : string * IFormatProvider * uint32 -> bool
Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As UInteger) As Boolean
Parametreler
- s
- String
Ayrıştıracak dize.
- provider
- IFormatProvider
hakkında s
kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.
- result
- UInt32
Bu yöntem döndürdüğünde, başarıyla ayrıştırma s
işleminin sonucunu veya hatada tanımlanmamış bir değeri içerir.
Döndürülenler
true
başarıyla ayrıştırıldıysa s
; değilse, false
.
Şunlara uygulanır
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, UInt32)
- Kaynak:
- UInt32.cs
- Kaynak:
- UInt32.cs
UTF-8 karakterlik bir aralığı bir değere ayrıştırmaya çalışır.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt32 % result) = System::Numerics::INumberBase<System::UInt32>::TryParse;
public static bool TryParse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out uint result);
static member TryParse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider * uint32 -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As UInteger) As Boolean
Parametreler
- utf8Text
- ReadOnlySpan<Byte>
Ayrıştırılacak UTF-8 karakter aralığı.
- style
- NumberStyles
içinde utf8Text
bulunabilecek sayı stillerinin bit düzeyinde birleşimi.
- provider
- IFormatProvider
hakkında utf8Text
kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.
- result
- UInt32
Sonuç olarak, başarıyla ayrıştırma utf8Text
işleminin sonucunu veya hata durumunda tanımlanmamış bir değeri içerir.
Döndürülenler
true
başarıyla ayrıştırıldıysa utf8Text
; değilse, false
.
Şunlara uygulanır
TryParse(ReadOnlySpan<Byte>, UInt32)
- Kaynak:
- UInt32.cs
- Kaynak:
- UInt32.cs
Bir sayının dize gösterimini içeren UTF-8 karakter aralığını 32 bit işaretsiz tamsayı eşdeğerine dönüştürmeye çalışır.
public:
static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] System::UInt32 % result);
public static bool TryParse (ReadOnlySpan<byte> utf8Text, out uint result);
static member TryParse : ReadOnlySpan<byte> * uint32 -> bool
Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As UInteger) As Boolean
Parametreler
- utf8Text
- ReadOnlySpan<Byte>
Dönüştürülecek sayıyı temsil eden UTF-8 karakterlerini içeren bir yayılma alanı.
- result
- UInt32
Bu yöntem döndürdüğünde, dönüştürme başarılı olursa içinde bulunan utf8Text
sayıya eşdeğer 32 bit işaretsiz tamsayı değerini veya dönüştürme başarısız olursa sıfırı içerir. Bu parametre başlatılmadan geçirilir; başlangıçta sonuçta sağlanan tüm değerlerin üzerine yazılır.
Döndürülenler
true
başarıyla dönüştürüldüyse utf8Text
; aksi takdirde , false
.
Şunlara uygulanır
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt32)
- Kaynak:
- UInt32.cs
- Kaynak:
- UInt32.cs
- Kaynak:
- UInt32.cs
Önemli
Bu API, CLS uyumlu değildir.
Bir sayının belirtilen stildeki ve kültüre özgü biçimdeki span gösterimini 32 bit işaretsiz tamsayı eşdeğerine dönüştürmeye çalışır. Dönüştürmenin başarılı veya başarısız olduğunu gösteren dönüş değeri.
public:
static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt32 % result);
public:
static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt32 % result) = System::Numerics::INumberBase<System::UInt32>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out uint result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out uint result);
[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out uint result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * uint32 -> bool
[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * uint32 -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As UInteger) As Boolean
Parametreler
- s
- ReadOnlySpan<Char>
Dönüştürülecek sayıyı temsil eden karakterleri içeren bir yayılma alanı. Span, parametresi tarafından style
belirtilen stil kullanılarak yorumlanır.
- style
- NumberStyles
İzin verilen biçimini gösteren sabit listesi değerlerinin bit düzeyinde birleşimi s
. Belirtilmesi gereken tipik bir değerdir Integer.
- provider
- IFormatProvider
hakkında s
kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.
- result
- UInt32
Bu yöntem döndürdüğünde, içinde yer s
alan sayıya eşdeğer 32 bit işaretsiz tamsayı değerini, dönüştürme başarılı olursa değerini veya dönüştürme başarısız olursa sıfırı içerir. parametresi null
veya Emptyile uyumlu style
bir biçimde değilse s
veya UInt32.MinValue değerinden küçük veya UInt32.MaxValue değerinden büyük bir sayıyı temsil ederse dönüştürme başarısız olur. Bu parametre başlatılmadan geçirilir; başlangıçta verilen result
tüm değerlerin üzerine yazılır.
Döndürülenler
true
başarıyla dönüştürüldüyse s
; aksi takdirde , false
.
- Öznitelikler
Şunlara uygulanır
TryParse(String, NumberStyles, IFormatProvider, UInt32)
- Kaynak:
- UInt32.cs
- Kaynak:
- UInt32.cs
- Kaynak:
- UInt32.cs
Belirtilen stilde ve kültüre özgü biçimdeki bir sayının dize gösterimini 32 bit işaretsiz tamsayı eşdeğerine dönüştürmeyi dener. Dönüştürmenin başarılı veya başarısız olduğunu gösteren dönüş değeri.
public:
static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt32 % result);
public:
static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt32 % result) = System::Numerics::INumberBase<System::UInt32>::TryParse;
[System.CLSCompliant(false)]
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out uint result);
public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out uint result);
[System.CLSCompliant(false)]
public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out uint result);
[<System.CLSCompliant(false)>]
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint32 -> bool
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint32 -> bool
Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As UInteger) As Boolean
Parametreler
- s
- String
Dönüştürülecek sayıyı temsil eden bir dize. Dize, parametresi tarafından style
belirtilen stil kullanılarak yorumlanır.
- style
- NumberStyles
İzin verilen biçimini gösteren sabit listesi değerlerinin bit düzeyinde birleşimi s
. Belirtilmesi gereken tipik bir değerdir Integer.
- provider
- IFormatProvider
hakkında s
kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.
- result
- UInt32
Bu yöntem döndürdüğünde, içinde yer s
alan sayıya eşdeğer 32 bit işaretsiz tamsayı değerini, dönüştürme başarılı olursa değerini veya dönüştürme başarısız olursa sıfırı içerir. parametresi null
veya Emptyile uyumlu style
bir biçimde değilse s
veya UInt32.MinValue değerinden küçük veya UInt32.MaxValue değerinden büyük bir sayıyı temsil ederse dönüştürme başarısız olur. Bu parametre başlatılmadan geçirilir; başlangıçta verilen result
tüm değerlerin üzerine yazılır.
Döndürülenler
true
başarıyla dönüştürüldüyse s
; aksi takdirde , false
.
- Öznitelikler
Özel durumlar
style
bir NumberStyles değer değildir.
-veya-
style
ve HexNumber değerlerinin AllowHexSpecifier birleşimi değildir.
Örnekler
Aşağıdaki örnek, yöntemini bir dizi farklı dize ve NumberStyles değerle çağırırTryParse(String, NumberStyles, IFormatProvider, UInt32).
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
string numericString;
NumberStyles styles;
numericString = "2106034";
styles = NumberStyles.Integer;
CallTryParse(numericString, styles);
numericString = "-10603";
styles = NumberStyles.None;
CallTryParse(numericString, styles);
numericString = "29103674.00";
styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
CallTryParse(numericString, styles);
numericString = "10345.72";
styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
CallTryParse(numericString, styles);
numericString = "41792210E-01";
styles = NumberStyles.Integer | NumberStyles.AllowExponent;
CallTryParse(numericString, styles);
numericString = "9112E-01";
CallTryParse(numericString, styles);
numericString = "312E01";
CallTryParse(numericString, styles);
numericString = "FFC86DA1";
CallTryParse(numericString, NumberStyles.HexNumber);
numericString = "0x8F8C";
CallTryParse(numericString, NumberStyles.HexNumber);
}
private static void CallTryParse(string stringToConvert, NumberStyles styles)
{
uint number;
bool result = UInt32.TryParse(stringToConvert, styles,
CultureInfo.InvariantCulture, out number);
if (result)
Console.WriteLine($"Converted '{stringToConvert}' to {number}.");
else
Console.WriteLine($"Attempted conversion of '{stringToConvert}' failed.");
}
}
// The example displays the following output:
// Converted '2106034' to 2106034.
// Attempted conversion of '-10603' failed.
// Converted '29103674.00' to 29103674.
// Attempted conversion of '10345.72' failed.
// Converted '41792210E-01' to 4179221.
// Attempted conversion of '9112E-01' failed.
// Converted '312E01' to 3120.
// Converted 'FFC86DA1' to 4291325345.
// Attempted conversion of '0x8F8C' failed.
open System
open System.Globalization
let callTryParse (stringToConvert: string) (styles: NumberStyles) =
match UInt32.TryParse(stringToConvert, styles, CultureInfo.InvariantCulture) with
| true, number ->
printfn $"Converted '{stringToConvert}' to {number}."
printfn $"Attempted conversion of '{stringToConvert}' failed."
| _ -> ()
do
let numericString = "2106034"
let styles = NumberStyles.Integer
callTryParse numericString styles
let numericString = "-10603"
let styles = NumberStyles.None
callTryParse numericString styles
let numericString = "29103674.00"
let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
callTryParse numericString styles
let numericString = "10345.72"
let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
callTryParse numericString styles
let numericString = "41792210E-01"
let styles = NumberStyles.Integer ||| NumberStyles.AllowExponent
callTryParse numericString styles
let numericString = "9112E-01"
callTryParse numericString styles
let numericString = "312E01"
callTryParse numericString styles
let numericString = "FFC86DA1"
callTryParse numericString NumberStyles.HexNumber
let numericString = "0x8F8C"
callTryParse numericString NumberStyles.HexNumber
// The example displays the following output:
// Converted '2106034' to 2106034.
// Attempted conversion of '-10603' failed.
// Converted '29103674.00' to 29103674.
// Attempted conversion of '10345.72' failed.
// Converted '41792210E-01' to 4179221.
// Attempted conversion of '9112E-01' failed.
// Converted '312E01' to 3120.
// Converted 'FFC86DA1' to 4291325345.
// Attempted conversion of '0x8F8C' failed.
Imports System.Globalization
Module Example
Public Sub Main()
Dim numericString As String
Dim styles As NumberStyles
numericString = "2106034"
styles = NumberStyles.Integer
CallTryParse(numericString, styles)
numericString = "-10603"
styles = NumberStyles.None
CallTryParse(numericString, styles)
numericString = "29103674.00"
styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
CallTryParse(numericString, styles)
numericString = "10345.72"
styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
CallTryParse(numericString, styles)
numericString = "41792210E-01"
styles = NumberStyles.Integer Or NumberStyles.AllowExponent
CallTryParse(numericString, styles)
numericString = "9112E-01"
CallTryParse(numericString, styles)
numericString = "312E01"
CallTryParse(numericString, styles)
numericString = "FFC86DA1"
CallTryParse(numericString, NumberStyles.HexNumber)
numericString = "0x8F8C"
CallTryParse(numericString, NumberStyles.HexNumber)
End Sub
Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
Dim number As UInteger
Dim result As Boolean = UInt32.TryParse(stringToConvert, styles, _
CultureInfo.InvariantCulture, number)
If result Then
Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, number)
Else
Console.WriteLine("Attempted conversion of '{0}' failed.", _
Convert.ToString(stringToConvert))
End If
End Sub
End Module
' The example displays the following output to the console:
' Converted '2106034' to 2106034.
' Attempted conversion of '-10603' failed.
' Converted '29103674.00' to 29103674.
' Attempted conversion of '10345.72' failed.
' Converted '41792210E-01' to 4179221.
' Attempted conversion of '9112E-01' failed.
' Converted '312E01' to 3120.
' Converted 'FFC86DA1' to 4291325345.
' Attempted conversion of '0x8F8C' failed.
Açıklamalar
TryParse(String, NumberStyles, IFormatProvider, UInt32) yöntemi yöntemine Parse(String, NumberStyles, IFormatProvider) benzer, ancak dönüştürme başarısız olursa bir özel durum oluşturmaz. Bu yöntem, geçersiz olup olmadığını s
test etmek için FormatException özel durum işleme kullanma gereksinimini ortadan kaldırır ve başarıyla ayrıştırılamaz.
parametresi, style
ayrıştırma işleminin başarılı olması için parametresinde s
izin verilen stil öğelerini (boşluk veya pozitif veya negatif işareti gibi) tanımlar. Numaralandırmadaki NumberStyles bit bayraklarının bir bileşimi olmalıdır. değerine style
s
bağlı olarak parametresi aşağıdaki öğeleri içerebilir:
[ws] [$][sign][rakamlar,]rakamlar[.fractional_digits][E[sign]exponential_digits][ws]
Köşeli ayraçlar ([ve]) içindeki öğeler isteğe bağlıdır. Veya parametresi içeriyorsa style
NumberStyles.AllowHexSpecifiers
, parametresi aşağıdaki öğeleri içerebilir:
[ws] hexdigits[ws]
Aşağıdaki tablo her öğeyi açıklar.
Öğe | Açıklama |
---|---|
Ws | İsteğe bağlı beyaz boşluk. Bayrağı içeriyorsa başında veya bayrağı içeriyorsa sonunda s style NumberStyles.AllowTrailingWhite boşluk görüntülenebilir style s .NumberStyles.AllowLeadingWhite |
$ | Kültüre özgü para birimi simgesi. Dizedeki konumu, parametresinin yöntemi provider tarafından CurrencyPositivePattern döndürülen nesnenin NumberFormatInfo özelliği tarafından GetFormat tanımlanır. Bayrağı içeriyorsa NumberStyles.AllowCurrencySymbol para birimi simgesi içinde s style görünebilir. |
sign | İsteğe bağlı bir işaret. İşaret, bayrağı içeriyorsa başında s style ve bayrağını içeriyorsa NumberStyles.AllowLeadingSignNumberStyles.AllowTrailingSign sonunda s style görüntülenebilir. Parantezler, bayrağı içeriyorsa NumberStyles.AllowParentheses negatif bir değeri style belirtmek için içinde kullanılabilirs . Ancak, negatif işareti varsa, s ayrıştırma işleminin başarılı olması için yalnızca sıfır değerini temsil edebilir. |
Basamak | 0 İle 9 arasında bir basamak dizisi. |
, | Bir kültüre özgü grup ayırıcı. bayrağını içeriyorsa, tarafından provider belirtilen kültürün grup ayırıcısı NumberStyles.AllowThousands içinde style s görüntülenebilir. |
. | Bir kültüre özgü ondalık nokta sembolü. bayrağını içeriyorsaNumberStyles.AllowDecimalPoint, tarafından provider belirtilen kültürün ondalık noktası simgesi içinde s style görüntülenebilir. |
fractional_digits | 0 basamağının bir veya daha çok tekrarlanması. Kesirli basamaklar yalnızca style bayrağını NumberStyles.AllowDecimalPoint içeriyorsa içinde s görüntülenebilir. |
E | Değerin üslü (bilimsel) gösterimle temsil edildiğini gösteren "e" veya "E" karakteri. parametresi, s bayrağını içeriyorsa üstel gösteriminde style bir sayıyı NumberStyles.AllowExponent temsil edebilir. |
exponential_digits | 0 İle 9 arasında bir basamak dizisi. parametresi, s bayrağını içeriyorsa üstel gösteriminde style bir sayıyı NumberStyles.AllowExponent temsil edebilir. |
hexdigits | 0 İle f veya 0 ile f arasında onaltılık basamak dizisi. |
Not
içindeki s
sonlandırıcı NUL (U+0000) karakterleri, bağımsız değişkenin değerinden style
bağımsız olarak ayrıştırma işlemi tarafından yoksayılır.
Yalnızca ondalık basamağı olan bir dize (bayrağına NumberStyles.None karşılık gelir) her zaman başarıyla ayrıştırılıyor. Kalan NumberStyles üyelerin çoğu, bu giriş dizesinde mevcut olabilecek ancak mevcut olması gerekmeyen öğeleri denetler. Aşağıdaki tablo, tek tek NumberStyles üyelerin içinde s
bulunabilecek öğeleri nasıl etkilediğini gösterir.
Bileşik NumberStyles olmayan değerler |
Basamakların yanı sıra değerde izin verilen öğeler |
---|---|
None | Yalnızca ondalık basamaklar. |
AllowDecimalPoint | Ondalık ayırıcı (.) ve fractional_digits öğeleri. Ancak , fractional_digits yalnızca bir veya daha fazla 0 basamak içermelidir veya yöntemi döndürür false . |
AllowExponent | Exponential_digits ile birlikte üstel gösterimi gösteren "e" veya "E" karakteri.
s Üstel gösterimindeki bir sayıyı temsil ederse, sıfır olmayan, kesirli bir bileşene sahip olamaz. |
AllowLeadingWhite | başındaki s ws öğesi. |
AllowTrailingWhite | sonundaki s ws öğesi. |
AllowLeadingSign | Rakamlardan önceki sign öğesi. |
AllowTrailingSign | Basamakların ardından gelen sign öğesi. |
AllowParentheses | Sıfır sayısal değer kapsayan parantez biçimindeki işaret öğesi. |
AllowThousands | Grup ayırıcı (,) öğesi. |
AllowCurrencySymbol | Para birimi ($) öğesi. |
Currency | Tüm öğeler. Ancak, s onaltılık bir sayıyı veya üstel gösterimindeki bir sayıyı temsil edemez. |
Float | öğesinin başında veya sonundaki s ws öğesi, başlangıcını s ve ondalık ayırıcı (.) simgesini imzalar. parametresi üstel s gösterimi de kullanabilir. |
Number | ws, sign, grup ayırıcısı (,) ve ondalık ayırıcı (.) öğeleri. |
Any | Tüm öğeler. Ancak, s onaltılık bir sayıyı temsil edemez. |
NumberStyles.AllowHexSpecifier Bayrağı kullanılıyorsa, s
onaltılık bir değer olmalıdır. içinde bulunabilecek style
diğer bayraklar yalnızca ve NumberStyles.AllowTrailingWhite'tirNumberStyles.AllowLeadingWhite. (Numaralandırma, NumberStyles her iki boşluk bayrağını da içeren bileşik bir stile HexNumbersahiptir.)
Not
Onaltılık bir sayının dize gösterimi ises
, bunun önünde onaltılık sayı olarak ayırt eden herhangi bir dekorasyon (veya &h
gibi0x
) olamaz. Bu dönüştürmenin başarısız olmasına neden olur.
provider
parametresi bir IFormatProvider uygulamadır.
GetFormat yöntemi, biçimi s
hakkında kültüre özgü bilgiler sağlayan bir NumberFormatInfo nesnesi döndürür.
provider
parametresi aşağıdakilerden biri olabilir:
CultureInfo Biçimlendirme bilgileri sağlayan kültürü temsil eden bir nesne. GetFormat yöntemi, NumberFormatInfo bu kültür için sayısal biçimlendirme bilgileri sağlayan nesneyi döndürür.
NumberFormatInfo Sayısal biçimlendirme bilgileri sağlayan bir nesne. (Uygulaması GetFormat yalnızca kendisini döndürür.)
uygulayan IFormatProviderözel bir nesne. Yöntemi GetFormat , biçimlendirme bilgilerini sağlayan nesneyi oluşturur ve döndürür NumberFormatInfo .
ise provider
null
, NumberFormatInfo geçerli kültürün nesnesi kullanılır.
Ayrıca bkz.
Şunlara uygulanır
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin