UInt64.TryParse Yöntem

Başvuru

Tanım

Ad Alanı:: System

Bütünleştirilmiş Kod:: System.Runtime.dll

Bütünleştirilmiş Kod:: netstandard.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Ö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 64 bit işaretsiz tamsayı eşdeğerine dönüştürmeye çalışır. Dönüş değeri, dönüştürmenin başarılı mı yoksa başarısız mı olduğunu gösterir.

Aşırı Yüklemeler

TryParse(ReadOnlySpan<Byte>, IFormatProvider, UInt64)	UTF-8 karakterlik bir aralığı bir değere ayrıştırmaya çalışır.
TryParse(ReadOnlySpan<Char>, UInt64)	Bir sayının span gösterimini 64 bit işaretsiz tamsayı eşdeğerine dönüştürmeye çalışır. Dönüş değeri, dönüştürmenin başarılı mı yoksa başarısız mı olduğunu gösterir.
TryParse(String, UInt64)	Bir sayının dize gösterimini 64 bit işaretsiz tamsayı eşdeğerine dönüştürmeye çalışır. Dönüş değeri, dönüştürmenin başarılı mı yoksa başarısız mı olduğunu gösterir.
TryParse(ReadOnlySpan<Char>, IFormatProvider, UInt64)	Bir karakter aralığını bir değere ayrıştırmaya çalışır.
TryParse(String, IFormatProvider, UInt64)	Bir dizeyi bir değere ayrıştırmaya çalışır.
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, UInt64)	UTF-8 karakterlik bir aralığı bir değere ayrıştırmaya çalışır.
TryParse(ReadOnlySpan<Byte>, UInt64)	Bir sayının dize gösterimini içeren UTF-8 karakter aralığını 64 bit işaretsiz tamsayı eşdeğerine dönüştürmeye çalışır.
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt64)	Belirtilen stilde ve kültüre özgü biçimdeki bir sayının span gösterimini 64 bit işaretsiz tamsayı eşdeğerine dönüştürmeye çalışır. Dönüş değeri, dönüştürmenin başarılı mı yoksa başarısız mı olduğunu gösterir.
TryParse(String, NumberStyles, IFormatProvider, UInt64)	Belirtilen stilde ve kültüre özgü biçimdeki bir sayının dize gösterimini 64 bit işaretsiz tamsayı eşdeğerine dönüştürmeye çalışır. Dönüş değeri, dönüştürmenin başarılı mı yoksa başarısız mı olduğunu gösterir.

TryParse(ReadOnlySpan<Byte>, IFormatProvider, UInt64)

Kaynak:: UInt64.cs

Kaynak:: UInt64.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::UInt64 % result) = IUtf8SpanParsable<System::UInt64>::TryParse;

public static bool TryParse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider, out ulong result);

static member TryParse : ReadOnlySpan<byte> * IFormatProvider * uint64 -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider, ByRef result As ULong) As Boolean

Parametreler

utf8Text: ReadOnlySpan<Byte>

Ayrıştırılacak UTF-8 karakter aralığı.

provider: IFormatProvider

utf8Texthakkında kültüre özgü biçimlendirme bilgileri sağlayan nesne.

result: UInt64

Sonuç olarak, utf8Text başarıyla ayrıştırma veya hatada tanımlanmamış bir değerin sonucunu içerir.

Döndürülenler

Boolean

utf8Text başarıyla ayrıştırılıp ayrıştırılamadığını true; aksi takdirde, false.

Şunlara uygulanır

TryParse(ReadOnlySpan<Char>, UInt64)

Kaynak:: UInt64.cs

Kaynak:: UInt64.cs

Kaynak:: UInt64.cs

Önemli

Bu API, CLS uyumlu değildir.

Bir sayının span gösterimini 64 bit işaretsiz tamsayı eşdeğerine dönüştürmeye çalışır. Dönüş değeri, dönüştürmenin başarılı mı yoksa başarısız mı olduğunu gösterir.

public:
 static bool TryParse(ReadOnlySpan<char> s, [Runtime::InteropServices::Out] System::UInt64 % result);

public static bool TryParse (ReadOnlySpan<char> s, out ulong result);

[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, out ulong result);

static member TryParse : ReadOnlySpan<char> * uint64 -> bool

[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * uint64 -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), ByRef result As ULong) As Boolean

Parametreler

s: ReadOnlySpan<Char>

Dönüştürülecek sayıyı temsil eden karakterleri içeren bir yayılma alanı.

result: UInt64

Bu yöntem döndürdüğünde, siçinde bulunan sayıya eşdeğer olan 64 bit işaretsiz tamsayı değerini, dönüştürme başarılı olursa sıfırı veya dönüştürme başarısız olursa sıfır değerini içerir. parametresi veya ise, dönüştürme işlemi doğru biçimde değilse veya UInt64.MinValue veya UInt64.MaxValue'den büyük bir sayıyı temsil ederse başarısız olur. Bu parametre başlatılmamış olarak geçirilir; başlangıçta result sağlanan tüm değerlerin üzerine yazılır.

Döndürülenler

Boolean

s başarıyla dönüştürüldüyse true; aksi takdirde, false.

Öznitelikler: CLSCompliantAttribute

Şunlara uygulanır

TryParse(String, UInt64)

Kaynak:: UInt64.cs

Kaynak:: UInt64.cs

Kaynak:: UInt64.cs

Önemli

Bu API, CLS uyumlu değildir.

CLS uyumlu alternatif: System.Decimal.Parse(String)

Bir sayının dize gösterimini 64 bit işaretsiz tamsayı eşdeğerine dönüştürmeye çalışır. Dönüş değeri, dönüştürmenin başarılı mı yoksa başarısız mı olduğunu gösterir.

public:
 static bool TryParse(System::String ^ s, [Runtime::InteropServices::Out] System::UInt64 % result);

[System.CLSCompliant(false)]
public static bool TryParse (string s, out ulong result);

public static bool TryParse (string? s, out ulong result);

[System.CLSCompliant(false)]
public static bool TryParse (string? s, out ulong result);

[<System.CLSCompliant(false)>]
static member TryParse : string * uint64 -> bool

static member TryParse : string * uint64 -> bool

Public Shared Function TryParse (s As String, ByRef result As ULong) As Boolean

Parametreler

s: String

Dönüştürülecek sayıyı temsil eden dize.

result: UInt64

Döndürülenler

Boolean

s başarıyla dönüştürüldüyse true; aksi takdirde, false.

Öznitelikler: CLSCompliantAttribute

Örnekler

Aşağıdaki örnek, bir dize dizisindeki her öğe için bir kez TryParse(String, UInt64) yöntemini çağırır.

string[] numericStrings = { "1293.8", "+1671.7", "28347.", 
                            "   33113684  ", "(0)", "-0", "+1293617", 
                            "18-", "119870", "31,024", "  3127094 ",  
                            "00700000" };
ulong number;
foreach (string numericString in numericStrings)
{
   if (UInt64.TryParse(numericString, out number)) 
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
   else
      Console.WriteLine("Cannot convert '{0}' to a UInt64.", numericString);
}
// The example displays the following output:
//       Cannot convert '1293.8' to a UInt64.
//       Cannot convert '+1671.7' to a UInt64.
//       Cannot convert '28347.' to a UInt64.
//       Converted '   33113684  ' to 33113684.
//       Cannot convert '(0)' to a UInt64.
//       Converted '-0' to 0.
//       Converted '+1293617' to 1293617.
//       Cannot convert '18-' to a UInt64.
//       Converted '119870' to 119870.
//       Cannot convert '31,024' to a UInt64.
//       Converted '  3127094 ' to 3127094.
//       Converted '0070000' to 70000.

open System

let numericStrings = 
    [| "1293.8"; "+1671.7"; "28347."
       "   33113684  "; "(0)"; "-0"; "+1293617" 
       "18-"; "119870"; "31,024"; "  3127094 "  
       "00700000" |]
for numericString in numericStrings do
    match UInt64.TryParse numericString with
    | true, number ->
        printfn $"Converted '{numericString}' to {number}."
    | _ ->
        printfn $"Cannot convert '{numericString}' to a UInt64."
// The example displays the following output:
//       Cannot convert '1293.8' to a UInt64.
//       Cannot convert '+1671.7' to a UInt64.
//       Cannot convert '28347.' to a UInt64.
//       Converted '   33113684  ' to 33113684.
//       Cannot convert '(0)' to a UInt64.
//       Converted '-0' to 0.
//       Converted '+1293617' to 1293617.
//       Cannot convert '18-' to a UInt64.
//       Converted '119870' to 119870.
//       Cannot convert '31,024' to a UInt64.
//       Converted '  3127094 ' to 3127094.
//       Converted '0070000' to 70000.

Dim numericStrings() As String = {"1293.8", "+1671.7", "28347.", _
                                  "   33113684  ", "(0)", "-0", "+1293617", _
                                  "18-", "119870", "31,024", "  3127094 ", _ 
                                  "0070000" }
Dim number As ULong
For Each numericString As String In numericStrings
   If UInt64.TryParse(numericString, number) Then
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number)
   Else
      Console.WriteLine("Cannot convert '{0}' to a UInt64.", numericString)
   End If      
Next
' The example displays the following output:
'       Cannot convert '1293.8' to a UInt64.
'       Cannot convert '+1671.7' to a UInt64.
'       Cannot convert '28347.' to a UInt64.
'       Converted '   33113684  ' to 33113684.
'       Cannot convert '(0)' to a UInt64.
'       Converted '-0' to 0.
'       Converted '+1293617' to 1293617.
'       Cannot convert '18-' to a UInt64.
'       Converted '119870' to 119870.
'       Cannot convert '31,024' to a UInt64.
'       Converted '  3127094 ' to 3127094.
'       Converted '0070000' to 70000.

Açıklamalar

TryParse(String, UInt64) yöntemi, dönüştürme başarısız olursa özel durum oluşturmaması dışında Parse(String) yöntemine benzer. Bu yöntem, s geçersizse ve başarıyla ayrıştırılamıyorsa FormatException test etmek için özel durum işleme kullanma gereksinimini ortadan kaldırır.

s parametresi, aşağıdaki biçimdeki ondalık sayının dize gösterimi olmalıdır:

[ws] [sign]rakamlar[ws]

Köşeli ayraç ([ ve ]) içindeki öğeler isteğe bağlıdır. Aşağıdaki tabloda her öğe açıklanmaktadır.

Öğe	Açıklama
ws	İsteğe bağlı boşluk.
imzalama	İ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 ile 9 arasında bir ondalık basamak dizisi.

s parametresi NumberStyles.Integer stili kullanılarak yorumlanır. Ondalık basamaklara ek olarak, yalnızca baştaki ve sondaki boşluklara ve önünde işareti olan boşluklara izin verilir. stil öğelerini siçinde bulunabilecek kültüre özgü biçimlendirme bilgileriyle açıkça tanımlamak için TryParse(String, NumberStyles, IFormatProvider, UInt64) yöntemini çağırın.

Not

s parametresi tarafından belirtilen dize hiçbir grup ayırıcısı veya ondalık ayırıcı içeremez ve kesirli bir bölümü olamaz.

s parametresi, geçerli sistem kültürü için başlatılan bir NumberFormatInfo nesnesindeki biçimlendirme bilgileri kullanılarak ayrıştırılır. Daha fazla bilgi için bkz. NumberFormatInfo.CurrentInfo.

Bu aşırı yükleme, s parametresindeki 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 TryParse(String, NumberStyles, IFormatProvider, UInt64) aşırı yüklemesini çağırın.

Ayrıca bkz.

Parse
ToString
.NET'da Sayısal Dizeleri Ayrıştırma
Örneği: .NET Core WinForms Biçimlendirme Yardımcı Programı (C#)
Örneği: .NET Core WinForms Biçimlendirme Yardımcı Programı (Visual Basic)

Şunlara uygulanır

TryParse(ReadOnlySpan<Char>, IFormatProvider, UInt64)

Kaynak:: UInt64.cs

Kaynak:: UInt64.cs

Kaynak:: UInt64.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::UInt64 % result) = ISpanParsable<System::UInt64>::TryParse;

public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out ulong result);

static member TryParse : ReadOnlySpan<char> * IFormatProvider * uint64 -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As ULong) As Boolean

Parametreler

s: ReadOnlySpan<Char>

Ayrıştırılacak karakterlerin yayılma alanı.

provider: IFormatProvider

shakkında kültüre özgü biçimlendirme bilgileri sağlayan nesne.

result: UInt64

Bu yöntem döndürdüğünde, sbaşarıyla ayrıştırma işleminin sonucunu veya hatada tanımlanmamış bir değeri içerir.

Döndürülenler

Boolean

s başarıyla ayrıştırılıp ayrıştırılamadığını true; aksi takdirde, false.

Şunlara uygulanır

TryParse(String, IFormatProvider, UInt64)

Kaynak:: UInt64.cs

Kaynak:: UInt64.cs

Kaynak:: UInt64.cs

Bir dizeyi bir değere ayrıştırmaya çalışır.

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result) = IParsable<System::UInt64>::TryParse;

public static bool TryParse (string? s, IFormatProvider? provider, out ulong result);

static member TryParse : string * IFormatProvider * uint64 -> bool

Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As ULong) As Boolean

Parametreler

s: String

Ayrıştırmak için dize.

provider: IFormatProvider

shakkında kültüre özgü biçimlendirme bilgileri sağlayan nesne.

result: UInt64

Bu yöntem döndürdüğünde, s başarıyla ayrıştırma veya hatada tanımlanmamış bir değerin sonucunu içerir.

Döndürülenler

Boolean

s başarıyla ayrıştırılıp ayrıştırılamadığını true; aksi takdirde, false.

Şunlara uygulanır

TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, UInt64)

Kaynak:: UInt64.cs

Kaynak:: UInt64.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::UInt64 % result) = System::Numerics::INumberBase<System::UInt64>::TryParse;

public static bool TryParse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style, IFormatProvider? provider, out ulong result);

static member TryParse : ReadOnlySpan<byte> * System.Globalization.NumberStyles * IFormatProvider * uint64 -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As ULong) As Boolean

Parametreler

utf8Text: ReadOnlySpan<Byte>

Ayrıştırılacak UTF-8 karakter aralığı.

style: NumberStyles

utf8Textiçinde bulunabilecek sayı stillerinin bit düzeyinde birleşimi.

provider: IFormatProvider

utf8Texthakkında kültüre özgü biçimlendirme bilgileri sağlayan nesne.

result: UInt64

Sonuç olarak, utf8Text başarıyla ayrıştırma veya hatada tanımlanmamış bir değerin sonucunu içerir.

Döndürülenler

Boolean

utf8Text başarıyla ayrıştırılıp ayrıştırılamadığını true; aksi takdirde, false.

Şunlara uygulanır

TryParse(ReadOnlySpan<Byte>, UInt64)

Kaynak:: UInt64.cs

Kaynak:: UInt64.cs

Bir sayının dize gösterimini içeren UTF-8 karakter aralığını 64 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::UInt64 % result);

public static bool TryParse (ReadOnlySpan<byte> utf8Text, out ulong result);

static member TryParse : ReadOnlySpan<byte> * uint64 -> bool

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), ByRef result As ULong) 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: UInt64

Bu yöntem döndürdüğünde, dönüştürme başarılı olursa utf8Text içinde bulunan sayının eşdeğeri 64 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ılmamış olarak geçirilir; başlangıçta sonuçta sağlanan tüm değerlerin üzerine yazılır.

Döndürülenler

Boolean

utf8Text başarıyla dönüştürüldüyse true; aksi takdirde, false.

Şunlara uygulanır

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt64)

Kaynak:: UInt64.cs

Kaynak:: UInt64.cs

Kaynak:: UInt64.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen stilde ve kültüre özgü biçimdeki bir sayının span gösterimini 64 bit işaretsiz tamsayı eşdeğerine dönüştürmeye çalışır. Dönüş değeri, dönüştürmenin başarılı mı yoksa başarısız mı olduğunu gösterir.

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result);

public:
 static bool TryParse(ReadOnlySpan<char> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result) = System::Numerics::INumberBase<System::UInt64>::TryParse;

public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ulong result);

[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider provider, out ulong result);

[System.CLSCompliant(false)]
public static bool TryParse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ulong result);

static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * uint64 -> bool

[<System.CLSCompliant(false)>]
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * uint64 -> bool

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As ULong) As Boolean

Parametreler

s: ReadOnlySpan<Char>

Dönüştürülecek sayıyı temsil eden karakterleri içeren bir yayılma alanı. Span, style parametresi tarafından belirtilen stil kullanılarak yorumlanır.

style: NumberStyles

sizin verilen biçimini gösteren sabit listesi değerlerinin bit düzeyinde birleşimi. Belirtilmesi gereken tipik bir değer Integer.

provider: IFormatProvider

shakkında kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

result: UInt64

Bu yöntem döndürdüğünde, siçinde yer alan sayıya eşdeğer 64 bit işaretsiz tamsayı değerini, dönüştürme başarılı olursa sıfır veya dönüştürme başarısız olursa sıfır değerini içerir. parametresi veya ise, uyumlu bir biçimde değilse veya UInt64.MinValue veya UInt64.MaxValue'den büyük bir sayıyı temsil ederse dönüştürme başarısız olur. Bu parametre başlatılmamış olarak geçirilir; başlangıçta result sağlanan tüm değerlerin üzerine yazılır.

Döndürülenler

Boolean

s başarıyla dönüştürüldüyse true; aksi takdirde, false.

Öznitelikler: CLSCompliantAttribute

Şunlara uygulanır

TryParse(String, NumberStyles, IFormatProvider, UInt64)

Kaynak:: UInt64.cs

Kaynak:: UInt64.cs

Kaynak:: UInt64.cs

Önemli

Bu API, CLS uyumlu değildir.

CLS uyumlu alternatif: System.Decimal.Parse(String)

Belirtilen stilde ve kültüre özgü biçimdeki bir sayının dize gösterimini 64 bit işaretsiz tamsayı eşdeğerine dönüştürmeye çalışır. Dönüş değeri, dönüştürmenin başarılı mı yoksa başarısız mı olduğunu gösterir.

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result);

public:
 static bool TryParse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::UInt64 % result) = System::Numerics::INumberBase<System::UInt64>::TryParse;

[System.CLSCompliant(false)]
public static bool TryParse (string s, System.Globalization.NumberStyles style, IFormatProvider provider, out ulong result);

public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ulong result);

[System.CLSCompliant(false)]
public static bool TryParse (string? s, System.Globalization.NumberStyles style, IFormatProvider? provider, out ulong result);

[<System.CLSCompliant(false)>]
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint64 -> bool

static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * uint64 -> bool

Public Shared Function TryParse (s As String, style As NumberStyles, provider As IFormatProvider, ByRef result As ULong) As Boolean

Parametreler

s: String

Dönüştürülecek sayıyı temsil eden dize. Dize, style parametresi tarafından belirtilen stil kullanılarak yorumlanır.

style: NumberStyles

sizin verilen biçimini gösteren sabit listesi değerlerinin bit düzeyinde birleşimi. Belirtilmesi gereken tipik bir değer Integer.

provider: IFormatProvider

shakkında kültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

result: UInt64

Döndürülenler

Boolean

s başarıyla dönüştürüldüyse true; aksi takdirde, false.

Öznitelikler: CLSCompliantAttribute

Özel durumlar

ArgumentException

style NumberStyles bir değer değildir.

-veya-

style, AllowHexSpecifier ve HexNumber değerlerinin birleşimi değildir.

Örnekler

Aşağıdaki örnek, bir dizi farklı dize ve NumberStyles değeriyle TryParse(String, NumberStyles, IFormatProvider, UInt64) yöntemini çağırır.

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)
   {
      ulong number;
      bool result = UInt64.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 UInt64.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 ULong
      Dim result As Boolean = UInt64.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, UInt64) yöntemi, dönüştürme başarısız olursa özel durum oluşturmaması dışında Parse(String, NumberStyles, IFormatProvider) yöntemine benzer. Bu yöntem, s geçersizse ve başarıyla ayrıştırılamıyorsa FormatException test etmek için özel durum işleme kullanma gereksinimini ortadan kaldırır.

style parametresi, ayrıştırma işleminin başarılı olması için s parametresinde izin verilen stil öğelerini (boşluk veya pozitif veya negatif işareti gibi) tanımlar. NumberStyles numaralandırmasından bit bayraklarının birleşimi olmalıdır. styledeğerine bağlı olarak, s parametresi aşağıdaki öğeleri içerebilir:

[ws] [$] [sign] [basamak,]basamak[.fractional_digits][E[sign]exponential_digits][ws]

Köşeli ayraç ([ ve ]) içindeki öğeler isteğe bağlıdır. style parametresi NumberStyles.AllowHexSpecifieriçeriyorsa, s parametresi aşağıdaki öğeleri içerebilir:

[ws]hexdigits[ws]

Aşağıdaki tabloda her öğe açıklanmaktadır.

Öğe	Açıklama
ws	İsteğe bağlı boşluk. `style` NumberStyles.AllowLeadingWhite bayrağı içeriyorsa `s` başında veya `style`NumberStyles.AllowTrailingWhite bayrağı içeriyorsa `s` sonunda boşluk görüntülenebilir.
$	Kültüre özgü para birimi simgesi. Dizedeki konumu, `provider` parametresinin GetFormat yöntemi tarafından döndürülen NumberFormatInfo nesnesinin CurrencyPositivePattern özelliği tarafından tanımlanır. para birimi simgesi, `style`NumberStyles.AllowCurrencySymbol bayrağı içeriyorsa `s` görünebilir.
imzalama	İsteğe bağlı bir işaret. İşaret, `style`NumberStyles.AllowLeadingSign bayrağı içeriyorsa `s` başında ve `style`NumberStyles.AllowTrailingSign bayrağı içeriyorsa `s` sonunda görüntülenebilir. `style` NumberStyles.AllowParentheses bayrağı içeriyorsa, negatif bir değeri belirtmek için `s`'de parantezler kullanılabilir. Ancak, negatif işareti varsa, `s` yalnızca ayrıştırma işleminin başarılı olması için sıfır değerini temsil edebilir.
basamak	0 ile 9 arasında bir basamak dizisi.
,	Kültüre özgü grup ayırıcısı. `style` NumberStyles.AllowThousands bayrağı içeriyorsa, `provider` tarafından belirtilen kültürün grup ayırıcısı `s` görünebilir.
.	Kültüre özgü ondalık nokta simgesi. `style` NumberStyles.AllowDecimalPoint bayrağı içeriyorsa, `provider` tarafından belirtilen kültürün ondalık noktası simgesi `s`'de görüntülenebilir.
fractional_digits	0 rakamının bir veya daha fazla tekrarı. Kesirli basamaklar `s` yalnızca `style`NumberStyles.AllowDecimalPoint bayrağı içeriyorsa görüntülenebilir.
E	Değerin üstel (bilimsel) gösterimde temsil olduğunu gösteren "e" veya "E" karakteri. `s` parametresi, `style`NumberStyles.AllowExponent bayrağı içeriyorsa, bir sayıyı üstel gösterimde temsil edebilir.
exponential_digits	0 ile 9 arasında bir basamak dizisi. `s` parametresi, `style`NumberStyles.AllowExponent bayrağı içeriyorsa, bir sayıyı üstel gösterimde temsil edebilir.
hexdigits	0'dan f'ye veya 0'dan F'ye kadar onaltılık basamak dizisi.

Not

s sonlandırıcı NUL (U+0000) karakterleri, style bağımsız değişkeninin değerinden bağımsız olarak ayrıştırma işlemi tarafından yoksayılır.

Yalnızca ondalık basamağı olan bir dize (NumberStyles.None bayrağına karşılık gelir) her zaman başarıyla ayrıştırılıyor. Kalan NumberStyles üyelerinin çoğu, bu giriş dizesinde mevcut olabilecek ancak mevcut olması gerekmeyen öğeleri denetler. Aşağıdaki tablo, tek tek NumberStyles üyelerinin s'de mevcut olabilecek öğeleri nasıl etkilediğini gösterir.

Bileşik olmayan `NumberStyles` değerleri	Basamaklara ek olarak değerde izin verilen öğeler
None	Yalnızca ondalık basamaklar.
AllowDecimalPoint	Ondalık nokta (.) ve fractional_digits öğeleri. Ancak, fractional_digits yalnızca bir veya daha fazla 0 basamak içermelidir veya yöntemi `false`döndürür.
AllowExponent	exponential_digitsile birlikte üstel gösterimi gösteren "e" veya "E" karakteri. `s` üstel gösterimdeki bir sayıyı temsil ederse, sıfır olmayan kesirli bir bileşeni olamaz.
AllowLeadingWhite	`s`başındaki ws öğesi.
AllowTrailingWhite	`s`sonundaki ws öğesi.
AllowLeadingSign	basamakönce sign öğesi.
AllowTrailingSign	basamakların ardından işareti öğesi.
AllowParentheses	işareti, sıfır sayısal değer kapsayan parantez biçiminde öğesidir.
AllowThousands	Grup ayırıcısı (,) öğesi.
AllowCurrencySymbol	Para birimi ($) öğesi.
Currency	Tüm öğeler. Ancak, `s` onaltılık bir sayıyı veya üstel gösterimdeki bir sayıyı temsil edemez.
Float	başında veya sonundaki ws öğesi, başında ve ondalık ayırıcı (.) simgesi . `s` parametresi üstel gösterimi de kullanabilir.
Number	ws, işareti, 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ırsa, s onaltılık bir değer olmalıdır. Geçerli onaltılık karakterler 0-9, A-F ve a-f şeklindedir. "0x" gibi bir ön ek desteklenmez ve ayrıştırma işleminin başarısız olmasına neden olur. style'de bulunabilecek diğer bayraklar NumberStyles.AllowLeadingWhite ve NumberStyles.AllowTrailingWhite. (NumberStyles numaralandırması, her iki boşluk bayrağını da içeren HexNumberbileşik bir stile sahiptir.)

Not

s, onaltılık bir sayının dize gösterimiyse, önünde onaltılık sayı olarak ayırt eden herhangi bir süsleme (0x veya &hgibi) bulunamaz. Bu, dönüştürmenin başarısız olmasına neden olur.

provider parametresi IFormatProvider bir uygulamadır. GetFormat yöntemi, sbiçimi hakkında kültüre özgü bilgiler sağlayan bir NumberFormatInfo nesnesi döndürür. provider parametresi aşağıdakilerden biri olabilir:

Biçimlendirme bilgileri sağlayan kültürü temsil eden bir CultureInfo nesnesi. GetFormat yöntemi, bu kültür için sayısal biçimlendirme bilgileri sağlayan NumberFormatInfo nesnesini döndürür.
Sayısal biçimlendirme bilgileri sağlayan NumberFormatInfo nesnesi. (GetFormat uygulaması yalnızca kendini döndürür.)
IFormatProvideruygulayan özel bir nesne. GetFormat yöntemi, biçimlendirme bilgileri sağlayan NumberFormatInfo nesnesini oluşturur ve döndürür.

provider nullise, geçerli kültür için NumberFormatInfo nesnesi kullanılır.

Ayrıca bkz.

Parse(String)
Parse
ToString
.NET'da Sayısal Dizeleri Ayrıştırma

Şunlara uygulanır

Aracılığıyla paylaş

UInt64.TryParse Yöntem

Tanım

Aşırı Yüklemeler

TryParse(ReadOnlySpan<Byte>, IFormatProvider, UInt64)

Parametreler

Döndürülenler

Şunlara uygulanır

TryParse(ReadOnlySpan<Char>, UInt64)

Parametreler

Döndürülenler

Şunlara uygulanır

TryParse(String, UInt64)

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

TryParse(ReadOnlySpan<Char>, IFormatProvider, UInt64)

Parametreler

Döndürülenler

Şunlara uygulanır

TryParse(String, IFormatProvider, UInt64)

Parametreler

Döndürülenler

Şunlara uygulanır

TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, UInt64)

Parametreler

Döndürülenler

Şunlara uygulanır

TryParse(ReadOnlySpan<Byte>, UInt64)

Parametreler

Döndürülenler

Şunlara uygulanır

TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt64)

Parametreler

Döndürülenler

Şunlara uygulanır

TryParse(String, NumberStyles, IFormatProvider, UInt64)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Ek kaynaklar