BigInteger.TryParse Yöntem

Tanım

Bir sayının dize gösterimini eşdeğerine BigInteger dönüştürmeyi dener ve dönüştürmenin başarılı olup olmadığını belirten bir değer döndürür.

Aşırı Yüklemeler

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

Bir sayının dize gösterimini eşdeğerine BigInteger dönüştürmeyi dener ve dönüştürmenin başarılı olup olmadığını gösteren bir değer döndürür.

TryParse(String, IFormatProvider, BigInteger)

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

TryParse(ReadOnlySpan<Char>, IFormatProvider, BigInteger)

Bir karakter aralığını bir değere ayrıştırmaya çalışır.

TryParse(String, BigInteger)

Bir sayının dize gösterimini eşdeğerine BigInteger dönüştürmeyi dener ve dönüştürmenin başarılı olup olmadığını gösteren bir değer döndürür.

TryParse(ReadOnlySpan<Char>, BigInteger)

Belirtilen salt okunur karakter aralığında bulunan bir sayının gösterimini eşdeğerine BigInteger dönüştürmeye çalışır ve dönüştürmenin başarılı olup olmadığını gösteren bir değer döndürür.

TryParse(String, NumberStyles, IFormatProvider, BigInteger)

Belirtilen stilde ve kültüre özgü biçimdeki bir sayının dize gösterimini eşdeğerine BigInteger dönüştürmeye çalışır ve dönüştürmenin başarılı olup olmadığını gösteren bir değer döndürür.

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

Kaynak:
BigInteger.cs
Kaynak:
BigInteger.cs
Kaynak:
BigInteger.cs

Bir sayının dize gösterimini eşdeğerine BigInteger dönüştürmeyi dener ve dönüştürmenin başarılı olup olmadığını belirten bir değer döndürür.

public:
 static bool TryParse(ReadOnlySpan<char> value, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::Numerics::BigInteger % result);
public:
 static bool TryParse(ReadOnlySpan<char> value, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::Numerics::BigInteger % result) = System::Numerics::INumberBase<System::Numerics::BigInteger>::TryParse;
public static bool TryParse (ReadOnlySpan<char> value, System.Globalization.NumberStyles style, IFormatProvider? provider, out System.Numerics.BigInteger result);
public static bool TryParse (ReadOnlySpan<char> value, System.Globalization.NumberStyles style, IFormatProvider provider, out System.Numerics.BigInteger result);
static member TryParse : ReadOnlySpan<char> * System.Globalization.NumberStyles * IFormatProvider * BigInteger -> bool
Public Shared Function TryParse (value As ReadOnlySpan(Of Char), style As NumberStyles, provider As IFormatProvider, ByRef result As BigInteger) As Boolean

Parametreler

value
ReadOnlySpan<Char>

Bir sayının salt okunur karakter aralığı olarak gösterimi.

style
NumberStyles

içinde bulunabilecek valuestil öğelerini gösteren sabit listesi değerlerinin bit düzeyinde birleşimi. Belirtilmesi gereken tipik bir değerdir Integer.

provider
IFormatProvider

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

result
BigInteger

Bu yöntem döndürdüğündeBigInteger, içinde bulunan valueZero sayının eşdeğerini veya dönüştürmenin başarısız olup olmadığını içerir. Parametre boş bir karakter aralığıysa value veya ile styleuyumlu bir biçimde değilse dönüştürme başarısız olur. Bu parametre, başlatmadan iletilir.

Döndürülenler

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

Özel durumlar

style bir NumberStyles değer değildir.

-veya-

style veya bayrağını AllowHexSpecifierHexNumber başka bir değerle birlikte içerir.

Açıklamalar

Bu aşırı yükleme yöntemine Parse(ReadOnlySpan<Char>, 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ı value 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 value 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 stylevalue bağlı olarak parametresi aşağıdaki öğeleri içerebilir:

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

parametresi içeriyorsa styleAllowHexSpecifiervalue, parametresi aşağıdaki öğeleri içerebilir:

[ws] hexdigits[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. Bayrağı içeriyorsa başında veya bayrağı içeriyorsa sonunda valuestyleNumberStyles.AllowTrailingWhite boşluk görüntülenebilir stylevalue.NumberStyles.AllowLeadingWhite
$ Kültüre özgü para birimi simgesi. içindeki value konumu, parametresinin yöntemi provider tarafından döndürülen nesnenin GetFormat özelliği NumberFormatInfo tarafından tanımlanırCurrencyPositivePattern. Bayrağı içeriyorsa NumberStyles.AllowCurrencySymbol para birimi simgesi içinde valuestyle görünebilir.
sign İsteğe bağlı bir işaret. İşaret, bayrağı içeriyorsa başında valuestyle ve bayrağını içeriyorsa NumberStyles.AllowLeadingSignNumberStyles.AllowTrailingSign sonunda valuestyle görüntülenebilir. Parantezler, bayrağı içeriyorsa NumberStyles.AllowParentheses negatif bir değeri style belirtmek için içinde kullanılabilirvalue.
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 stylevalue 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 valuestyle 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 value görüntülenebilir.
E Değerin üslü (bilimsel) gösterimle temsil edildiğini gösteren "e" veya "E" karakteri. parametresi, value 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, value 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.

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. value Üstel gösterimindeki bir sayıyı temsil ederse, sıfır olmayan, kesirli bir bileşene sahip olamaz.
AllowLeadingWhite başındaki valuews öğesi.
AllowTrailingWhite sonundaki valuews öğesi.
AllowLeadingSign Rakamlardan önceki sign öğesi.
AllowTrailingSign Basamakların ardından gelen sign öğesi.
AllowParentheses Sayısal değeri kapsayan parantez biçimindeki işaret öğesi.
AllowThousands Grup ayırıcı (,) öğesi.
AllowCurrencySymbol Para birimi ($) öğesi.
Currency Tüm öğeler. Ancak, value onaltılık bir sayıyı veya üstel gösterimindeki bir sayıyı temsil edemez.
Float öğesinin başında veya sonundaki valuews öğesi, başlangıcını valueve ondalık ayırıcı (.) simgesini imzalar. parametresi üstel value gösterimi de kullanabilir.
Number ws, sign, grup ayırıcısı (,) ve ondalık ayırıcı (.) öğeleri.
Any Tüm öğeler. Ancak, value onaltılık bir sayıyı temsil edemez.

NumberStyles.AllowHexSpecifier Bayrağı kullanılıyorsa, value 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.)

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

ise providernull, NumberFormatInfo geçerli kültürün nesnesi kullanılır.

Ayrıca bkz.

Şunlara uygulanır

TryParse(String, IFormatProvider, BigInteger)

Kaynak:
BigInteger.cs
Kaynak:
BigInteger.cs
Kaynak:
BigInteger.cs

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

public:
 static bool TryParse(System::String ^ s, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::Numerics::BigInteger % result) = IParsable<System::Numerics::BigInteger>::TryParse;
public static bool TryParse (string? s, IFormatProvider? provider, out System.Numerics.BigInteger result);
static member TryParse : string * IFormatProvider * BigInteger -> bool
Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As BigInteger) As Boolean

Parametreler

s
String

Ayrıştıracak dize.

provider
IFormatProvider

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

result
BigInteger

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<Char>, IFormatProvider, BigInteger)

Kaynak:
BigInteger.cs
Kaynak:
BigInteger.cs
Kaynak:
BigInteger.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::Numerics::BigInteger % result) = ISpanParsable<System::Numerics::BigInteger>::TryParse;
public static bool TryParse (ReadOnlySpan<char> s, IFormatProvider? provider, out System.Numerics.BigInteger result);
static member TryParse : ReadOnlySpan<char> * IFormatProvider * BigInteger -> bool
Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As BigInteger) As Boolean

Parametreler

s
ReadOnlySpan<Char>

Ayrıştırılacak karakterlerin yayılması.

provider
IFormatProvider

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

result
BigInteger

Bu yöntem döndürdüğünde, başarıyla ayrıştırma siş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, BigInteger)

Kaynak:
BigInteger.cs
Kaynak:
BigInteger.cs
Kaynak:
BigInteger.cs

Bir sayının dize gösterimini eşdeğerine BigInteger dönüştürmeyi dener ve dönüştürmenin başarılı olup olmadığını belirten bir değer döndürür.

public:
 static bool TryParse(System::String ^ value, [Runtime::InteropServices::Out] System::Numerics::BigInteger % result);
public static bool TryParse (string value, out System.Numerics.BigInteger result);
public static bool TryParse (string? value, out System.Numerics.BigInteger result);
static member TryParse : string * BigInteger -> bool
Public Shared Function TryParse (value As String, ByRef result As BigInteger) As Boolean

Parametreler

value
String

Bir sayının dize gösterimi.

result
BigInteger

Bu yöntem döndürdüğünde BigInteger , içinde bulunan valuesayının eşdeğerini veya dönüştürme başarısız olursa sıfırı (0) içerir. Parametre null doğru biçimdeyse value veya değilse dönüştürme başarısız olur. Bu parametre, başlatmadan iletilir.

Döndürülenler

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

Özel durumlar

value, null değeridir.

Örnekler

Aşağıdaki örnek, iki BigInteger nesnenin TryParse(String, BigInteger) örneğini oluştururken yöntemini kullanır. Dönüştürmeler başarılı olursa, her nesneyi başka bir numarayla çarpar ve ardından iki nesne arasındaki ilişkiyi belirlemek için yöntemini çağırır Compare .

BigInteger number1, number2;
bool succeeded1 = BigInteger.TryParse("-12347534159895123", out number1);
bool succeeded2 = BigInteger.TryParse("987654321357159852", out number2);
if (succeeded1 && succeeded2)
{
   number1 *= 3;
   number2 *= 2;
   switch (BigInteger.Compare(number1, number2))
   {
      case -1:
         Console.WriteLine("{0} is greater than {1}.", number2, number1);
         break;
      case 0:
         Console.WriteLine("{0} is equal to {1}.", number1, number2);
         break;
      case 1:
         Console.WriteLine("{0} is greater than {1}.", number1, number2);
         break;
   }
}
else
{
   if (! succeeded1)
      Console.WriteLine("Unable to initialize the first BigInteger value.");

   if (! succeeded2)
      Console.WriteLine("Unable to initialize the second BigInteger value.");
}
// The example displays the following output:
//      1975308642714319704 is greater than -37042602479685369.
    let mutable number1 = BigInteger.Zero
    let mutable number2 = BigInteger.Zero

    let succeeded1 = BigInteger.TryParse("-12347534159895123", &number1)
    let succeeded2 = BigInteger.TryParse("987654321357159852", &number2)

    if succeeded1 && succeeded2 then
        number1 <- number1 * 3I
        number2 <- number2 * 2I

        match BigInteger.Compare(number1, number2) with
        | -1 -> printfn $"{number2} is greater than {number2}."
        | 0 -> printfn $"{number1} is equal to {number2}."
        | 1
        | _ -> printfn $"{number1} is greater than {number2}."
    else
        if not succeeded1 then
            printfn "Unable to initialize the first BigInteger value."

        if not succeeded2 then
            printfn "Unable to initialize the second BigInteger value."

// The example displays the following output:
//      1975308642714319704 is greater than -37042602479685369.
Dim number1 As BigInteger = BigInteger.Zero
Dim number2 As BigInteger = BigInteger.Zero
Dim succeeded1 As Boolean = BigInteger.TryParse("-12347534159895123", number1)
Dim succeeded2 As Boolean = BigInteger.TryParse("987654321357159852", number2)
If succeeded1 AndAlso succeeded2
   number1 *= 3
   number2 *= 2
   Select Case BigInteger.Compare(number1, number2)
      Case -1
         Console.WriteLine("{0} is greater than {1}.", number2, number1)
      Case 0
         Console.WriteLine("{0} is equal to {1}.", number1, number2)
      Case 1
         Console.WriteLine("{0} is greater than {1}.", number1, number2)
   End Select      
Else
   If Not succeeded1 Then 
      Console.WriteLine("Unable to initialize the first BigInteger value.")
   End If
   If Not succeeded2 Then
      Console.WriteLine("Unable to initialize the second BigInteger value.")
   
   End If
End If
' The example displays the following output:
'      1975308642714319704 is greater than -37042602479685369.

Açıklamalar

TryParse(String, BigInteger) yöntemi yöntemine Parse(String) benzer, ancak dönüştürme başarısız olursa bir özel durum oluşturmaz. Bu yöntem, geçersiz olup olmadığını value test etmek için FormatException özel durum işleme kullanma gereksinimini ortadan kaldırır ve başarıyla ayrıştırılamaz.

parametresi, value 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.

Not

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

value 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 valuekültüre özgü biçimlendirme bilgileriyle açıkça tanımlamak için yöntemini çağırın TryParse(String, NumberStyles, IFormatProvider, BigInteger) .

value parametresi, geçerli 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 value 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, BigInteger) .

Ayrıca bkz.

Şunlara uygulanır

TryParse(ReadOnlySpan<Char>, BigInteger)

Kaynak:
BigInteger.cs
Kaynak:
BigInteger.cs
Kaynak:
BigInteger.cs

Belirtilen salt okunur karakter aralığında bulunan bir sayının gösterimini eşdeğerine BigInteger dönüştürmeye çalışır ve dönüştürmenin başarılı olup olmadığını belirten bir değer döndürür.

public:
 static bool TryParse(ReadOnlySpan<char> value, [Runtime::InteropServices::Out] System::Numerics::BigInteger % result);
public static bool TryParse (ReadOnlySpan<char> value, out System.Numerics.BigInteger result);
static member TryParse : ReadOnlySpan<char> * BigInteger -> bool
Public Shared Function TryParse (value As ReadOnlySpan(Of Char), ByRef result As BigInteger) As Boolean

Parametreler

value
ReadOnlySpan<Char>

Bir sayının karakterlerin salt okunur bir yayılma alanı olarak gösterimi.

result
BigInteger

Bu yöntem döndürdüğünde BigInteger , içinde bulunan valuesayının eşdeğerini veya dönüştürme başarısız olursa sıfırı (0) içerir. Parametre boş bir karakter aralığıysa value veya doğru biçimde değilse dönüştürme başarısız olur. Bu parametre, başlatmadan iletilir.

Döndürülenler

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

Ayrıca bkz.

Şunlara uygulanır

TryParse(String, NumberStyles, IFormatProvider, BigInteger)

Kaynak:
BigInteger.cs
Kaynak:
BigInteger.cs
Kaynak:
BigInteger.cs

Belirtilen stilde ve kültüre özgü biçimdeki bir sayının dize gösterimini eşdeğerine BigInteger dönüştürmeye çalışır ve dönüştürmenin başarılı olup olmadığını gösteren bir değer döndürür.

public:
 static bool TryParse(System::String ^ value, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::Numerics::BigInteger % result);
public:
 static bool TryParse(System::String ^ value, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::Numerics::BigInteger % result) = System::Numerics::INumberBase<System::Numerics::BigInteger>::TryParse;
public static bool TryParse (string value, System.Globalization.NumberStyles style, IFormatProvider provider, out System.Numerics.BigInteger result);
public static bool TryParse (string? value, System.Globalization.NumberStyles style, IFormatProvider? provider, out System.Numerics.BigInteger result);
static member TryParse : string * System.Globalization.NumberStyles * IFormatProvider * BigInteger -> bool
Public Shared Function TryParse (value As String, style As NumberStyles, provider As IFormatProvider, ByRef result As BigInteger) As Boolean

Parametreler

value
String

Bir sayının dize gösterimi. Dize, tarafından stylebelirtilen stil kullanılarak yorumlanır.

style
NumberStyles

içinde bulunabilecek valuestil öğelerini gösteren sabit listesi değerlerinin bit düzeyinde birleşimi. Belirtilmesi gereken tipik bir değerdir Integer.

provider
IFormatProvider

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

result
BigInteger

Bu yöntem döndürdüğündeBigInteger, içinde bulunan valueZero sayının eşdeğerini veya dönüştürmenin başarısız olup olmadığını içerir. parametresi null ile styleuyumlu bir biçimdeyse value veya değilse dönüştürme başarısız olur. Bu parametre, başlatmadan iletilir.

Döndürülenler

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

Özel durumlar

style bir NumberStyles değer değildir.

-veya-

style veya bayrağını AllowHexSpecifierHexNumber başka bir değerle birlikte içerir.

Örnekler

Aşağıdaki örnek, ve provider parametreleri için TryParse(String, NumberStyles, IFormatProvider, BigInteger) çeşitli değer bileşimlerini kullanarak yöntemine style bazı çağrılar yapar.

string numericString;
BigInteger number = BigInteger.Zero;

// Call TryParse with default values of style and provider.
numericString = "  -300   ";
if (BigInteger.TryParse(numericString, NumberStyles.Integer,
                       null, out number))
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number);
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString);

// Call TryParse with the default value of style and
// a provider supporting the tilde as negative sign.
numericString = "  -300   ";
if (BigInteger.TryParse(numericString, NumberStyles.Integer,
                       new BigIntegerFormatProvider(), out number))
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number);
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString);

// Call TryParse with only AllowLeadingWhite and AllowTrailingWhite.
// Method returns false because of presence of negative sign.
numericString = "  -500   ";
if (BigInteger.TryParse(numericString,
                        NumberStyles.AllowLeadingWhite | NumberStyles.AllowTrailingWhite,
                        new BigIntegerFormatProvider(), out number))
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number);
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString);

// Call TryParse with AllowHexSpecifier and a hex value.
numericString = "F14237FFAAC086455192";
if (BigInteger.TryParse(numericString,
                        NumberStyles.AllowHexSpecifier,
                        null, out number))
   Console.WriteLine("'{0}' was converted to {1} (0x{1:x}).",
                     numericString, number);
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString);

// Call TryParse with AllowHexSpecifier and a negative hex value.
// Conversion fails because of presence of negative sign.
numericString = "-3af";
if (BigInteger.TryParse(numericString, NumberStyles.AllowHexSpecifier,
                       new BigIntegerFormatProvider(), out number))
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number);
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString);

// Call TryParse with only NumberStyles.None.
// Conversion fails because of presence of white space and sign.
numericString = " -300 ";
if (BigInteger.TryParse(numericString, NumberStyles.None,
                       new BigIntegerFormatProvider(), out number))
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number);
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString);

// Call TryParse with NumberStyles.Any and a provider for the fr-FR culture.
// Conversion fails because the string is formatted for the en-US culture.
numericString = "9,031,425,666,123,546.00";
if (BigInteger.TryParse(numericString, NumberStyles.Any,
                       new CultureInfo("fr-FR"), out number))
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number);
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString);

// Call TryParse with NumberStyles.Any and a provider for the fr-FR culture.
// Conversion succeeds because the string is properly formatted
// For the fr-FR culture.
numericString = "9 031 425 666 123 546,00";
if (BigInteger.TryParse(numericString, NumberStyles.Any,
                       new CultureInfo("fr-FR"), out number))
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number);
else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString);
// The example displays the following output:
//    '  -300   ' was converted to -300.
//    Conversion of '  -300   ' to a BigInteger failed.
//    Conversion of '  -500   ' to a BigInteger failed.
//    'F14237FFAAC086455192' was converted to -69613977002644837412462 (0xf14237ffaac086455192).
//    Conversion of '-3af' to a BigInteger failed.
//    Conversion of ' -300 ' to a BigInteger failed.
//    Conversion of '9,031,425,666,123,546.00' to a BigInteger failed.
//    '9 031 425 666 123 546,00' was converted to 9031425666123546.
    // Call TryParse with default values of style and provider.
    let numericString = "  -300   "

    match BigInteger.TryParse(numericString, NumberStyles.Integer, null) with
    | true, number -> printfn $"The string '{numericString}' parses to {number}"
    | _ -> printfn $"Conversion of {numericString} to a BigInteger failed."

    // Call TryParse with the default value of style and
    // a provider supporting the tilde as negative sign.
    let numericString = "  -300   "

    match BigInteger.TryParse(numericString, NumberStyles.Integer, new BigIntegerFormatProvider()) with
    | true, number -> printfn $"The string '{numericString}' parses to {number}"
    | _ -> printfn $"Conversion of {numericString} to a BigInteger failed."

    // Call TryParse with only AllowLeadingWhite and AllowTrailingWhite.
    // Method returns false because of presence of negative sign.
    let numericString = "  -500   "

    match
        BigInteger.TryParse(
            numericString,
            NumberStyles.AllowLeadingWhite ||| NumberStyles.AllowTrailingWhite,
            new BigIntegerFormatProvider()
        )
    with
    | true, number -> printfn $"The string '{numericString}' parses to {number}"
    | _ -> printfn $"Conversion of {numericString} to a BigInteger failed."

    // Call TryParse with AllowHexSpecifier and a hex value.
    let numericString = "F14237FFAAC086455192"

    match BigInteger.TryParse(numericString, NumberStyles.AllowHexSpecifier, null) with
    | true, number -> printfn $"The string '{numericString}' parses to {number}, or 0x{number:x}."
    | _ -> printfn $"Conversion of {numericString} to a BigInteger failed."

    // Call TryParse with AllowHexSpecifier and a negative hex value.
    // Conversion fails because of presence of negative sign.
    let numericString = "-3af"

    match BigInteger.TryParse(numericString, NumberStyles.AllowHexSpecifier, null) with
    | true, number -> printfn $"The string '{numericString}' parses to {number}, or 0x{number:x}."
    | _ -> printfn $"Conversion of {numericString} to a BigInteger failed."

    // Call TryParse with only NumberStyles.None.
    // Conversion fails because of presence of white space and sign.
    let numericString = " -300 "

    match BigInteger.TryParse(numericString, NumberStyles.None, new BigIntegerFormatProvider()) with
    | true, number -> printfn $"The string '{numericString}' parses to {number}"
    | _ -> printfn $"Conversion of {numericString} to a BigInteger failed."

    // Call TryParse with NumberStyles.Any and a provider for the fr-FR culture.
    // Conversion fails because the string is formatted for the en-US culture.
    let numericString = "9,031,425,666,123,546.00"

    match BigInteger.TryParse(numericString, NumberStyles.Any, new CultureInfo("fr-FR")) with
    | true, number -> printfn $"The string '{numericString}' parses to {number}"
    | _ -> printfn $"Conversion of {numericString} to a BigInteger failed."

    // Call TryParse with NumberStyles.Any and a provider for the fr-FR culture.
    // Conversion succeeds because the string is properly formatted
    // For the fr-FR culture.
    let numericString = "9 031 425 666 123 546,00"

    match BigInteger.TryParse(numericString, NumberStyles.Any, new CultureInfo("fr-FR")) with
    | true, number -> printfn $"The string '{numericString}' parses to {number}"
    | _ -> printfn $"Conversion of {numericString} to a BigInteger failed."

// The example displays the following output:
//    '  -300   ' was converted to -300.
//    Conversion of '  -300   ' to a BigInteger failed.
//    Conversion of '  -500   ' to a BigInteger failed.
//    'F14237FFAAC086455192' was converted to -69613977002644837412462 (0xf14237ffaac086455192).
//    Conversion of '-3af' to a BigInteger failed.
//    Conversion of ' -300 ' to a BigInteger failed.
//    Conversion of '9,031,425,666,123,546.00' to a BigInteger failed.
//    '9 031 425 666 123 546,00' was converted to 9031425666123546.
Dim numericString As String
Dim number As BigInteger = BigInteger.Zero

' Call TryParse with default values of style and provider.
numericString = "  -300   "
If BigInteger.TryParse(numericString, NumberStyles.Integer,
                       Nothing, number) Then
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If                                             

' Call TryParse with the default value of style and 
' a provider supporting the tilde as negative sign.
numericString = "  -300   "
If BigInteger.TryParse(numericString, NumberStyles.Integer,
                       New BigIntegerFormatProvider(), number) Then
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If                                             

' Call TryParse with only AllowLeadingWhite and AllowTrailingWhite.
' Method returns false because of presence of negative sign.
numericString = "  -500   "
If BigInteger.TryParse(numericString,
                    NumberStyles.AllowLeadingWhite Or NumberStyles.AllowTrailingWhite,
                    New BigIntegerFormatProvider(), number) Then
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If                                             

' Call TryParse with AllowHexSpecifier and a hex value.
numericString = "F14237FFAAC086455192"
If BigInteger.TryParse(numericString,
                    NumberStyles.AllowHexSpecifier,
                    Nothing, number) Then
   Console.WriteLine("'{0}' was converted to {1} (0x{1:x}).",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If                                             

' Call TryParse with AllowHexSpecifier and a negative hex value.
' Conversion fails because of presence of negative sign.
numericString = "-3af"
If BigInteger.TryParse(numericString, NumberStyles.AllowHexSpecifier,
                       New BigIntegerFormatProvider(), number) Then
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If                                             

' Call TryParse with only NumberStyles.None.
' Conversion fails because of presence of white space and sign.
numericString = " -300 "
If BigInteger.TryParse(numericString, NumberStyles.None,
                       New BigIntegerFormatProvider(), number) Then
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If 
                                            
' Call TryParse with NumberStyles.Any and a provider for the fr-FR culture.
' Conversion fails because the string is formatted for the en-US culture.
numericString = "9,031,425,666,123,546.00"
If BigInteger.TryParse(numericString, NumberStyles.Any,
                       New CultureInfo("fr-FR"), number) Then
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If

' Call TryParse with NumberStyles.Any and a provider for the fr-FR culture.
' Conversion succeeds because the string is properly formatted 
' For the fr-FR culture.
numericString = "9 031 425 666 123 546,00"
If BigInteger.TryParse(numericString, NumberStyles.Any,
                       New CultureInfo("fr-FR"), number) Then
   Console.WriteLine("'{0}' was converted to {1}.",
                     numericString, number)                             
Else
   Console.WriteLine("Conversion of '{0}' to a BigInteger failed.",
                     numericString)
End If
' The example displays the following output:
'    '  -300   ' was converted to -300.
'    Conversion of '  -300   ' to a BigInteger failed.
'    Conversion of '  -500   ' to a BigInteger failed.
'    'F14237FFAAC086455192' was converted to -69613977002644837412462 (0xf14237ffaac086455192).
'    Conversion of '-3af' to a BigInteger failed.
'    Conversion of ' -300 ' to a BigInteger failed.
'    Conversion of '9,031,425,666,123,546.00' to a BigInteger failed.
'    '9 031 425 666 123 546,00' was converted to 9031425666123546.

Yöntemine TryParse(String, NumberStyles, IFormatProvider, BigInteger) yapılan tek tek çağrıların bir sayısı, negatif işareti olarak bir tilde (~) tanımlayan aşağıdaki BigIntegerFormatProvider sınıfın bir örneğini geçirir.

public class BigIntegerFormatProvider : IFormatProvider
{
   public object GetFormat(Type formatType)
   {
      if (formatType == typeof(NumberFormatInfo))
      {
         NumberFormatInfo numberFormat = new NumberFormatInfo();
         numberFormat.NegativeSign = "~";
         return numberFormat;
      }
      else
      {
         return null;
      }
   }
}
type BigIntegerFormatProvider() =
    interface IFormatProvider with
        member _.GetFormat(formatType: Type) =
            if formatType = typeof<NumberFormatInfo> then
                let numberFormat = new NumberFormatInfo()
                numberFormat.NegativeSign <- "~"
                numberFormat
            else
                null
Public Class BigIntegerFormatProvider : Implements IFormatProvider
   Public Function GetFormat(formatType As Type) As Object _
                            Implements IFormatProvider.GetFormat
      If formatType Is GetType(NumberFormatInfo) Then
         Dim numberFormat As New NumberFormatInfo
         numberFormat.NegativeSign = "~"
         Return numberFormat
      Else
         Return Nothing
      End If      
   End Function
End Class

Açıklamalar

TryParse(String, NumberStyles, IFormatProvider, BigInteger) 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ı value 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 value izin verilen stil öğelerini (boşluk veya pozitif veya negatif işareti gibi) tanımlar. Sabit listesindeki bit bayraklarının NumberStyles bir bileşimi olmalıdır. değerine stylevalue bağlı olarak parametresi aşağıdaki öğeleri içerebilir:

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

parametresi içeriyorsa styleAllowHexSpecifiervalue, parametresi aşağıdaki öğeleri içerebilir:

[ws] hexdigits[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. Bayrağı içeriyorsa başında valuestyle veya bayrağı içeriyorsa NumberStyles.AllowLeadingWhite sonunda valuestyleNumberStyles.AllowTrailingWhite boşluk görüntülenebilir.
$ 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 valuestyle görünebilir.
sign İsteğe bağlı bir işaret. İşaret, bayrağı içeriyorsa başında value ve bayrağı içeriyorsa sonunda NumberStyles.AllowTrailingSignvaluestyle görüntülenebilir.styleNumberStyles.AllowLeadingSign Parantezler, bayrağı içeriyorsa NumberStyles.AllowParentheses negatif bir değeri style belirtmek için içinde kullanılabilirvalue.
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 stylevalue görünebilir.
. Bir kültüre özgü ondalık nokta sembolü. bayrağını içeriyorsaNumberStyles.AllowDecimalPoint, tarafından provider belirtilen kültürün ondalık nokta simgesi içinde valuestyle görünebilir.
fractional_digits 0 basamağının bir veya daha çok tekrarlanması. Kesirli basamaklar yalnızca style bayrağı içeriyorsa NumberStyles.AllowDecimalPoint içinde görüntülenebilirvalue.
E Değerin üslü (bilimsel) gösterimle temsil edildiğini gösteren "e" veya "E" karakteri. parametresi, value bayrağını içeriyorsa bir sayıyı üstel gösteriminde styleNumberStyles.AllowExponent gösterebilir.
exponential_digits 0 İle 9 arasında bir basamak dizisi. parametresi, value bayrağını içeriyorsa bir sayıyı üstel gösteriminde styleNumberStyles.AllowExponent gösterebilir.
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 tabloda, tek tek NumberStyles üyelerin içinde valuebulunabilecek öğeleri nasıl etkilediği gösterilir.

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. Bir sayıyı üstel gösteriminde gösteriyorsa value sıfır olmayan kesirli bir bileşeni olamaz.
AllowLeadingWhite başındaki valuews öğesi.
AllowTrailingWhite sonundaki valuews öğesi.
AllowLeadingSign Rakamlardan önceki sign öğesi.
AllowTrailingSign Basamakların ardından gelen sign öğesi.
AllowParentheses Sayısal değeri kapsayan parantez biçimindeki sign öğesi.
AllowThousands Grup ayırıcısı (,) öğesi.
AllowCurrencySymbol Para birimi ($) öğesi.
Currency Tüm öğeler. Ancak, value onaltılık bir sayıyı veya üstel gösterimindeki bir sayıyı temsil edemez.
Float öğesinin başında veya sonundaki valuews öğesi, başında valueve ondalık ayırıcı (.) simgesiyle imzalar. parametresi üstel value gösterimi de kullanabilir.
Number ws, sign, group separator (,) ve ondalık ayırıcı (.) öğeleri.
Any Tüm öğeler. Ancak, value onaltılık bir sayıyı temsil edemez.

Önemli

yöntemi tarafından ToString çıktısı alınan bir BigInteger değerin dize gösterimini gidiş dönüş yapmak için yöntemini kullanırsanızTryParse, değerin BigInteger.ToString(String) dize gösterimini BigInteger oluşturmak için "R" biçim tanımlayıcısı ile yöntemini kullanmanız gerekir. Aksi takdirde, dize gösterimi özgün değerin BigInteger yalnızca en önemli 50 basamağını korur ve değeri geri yüklemek BigInteger için yöntemini kullandığınızda TryParse veriler kaybolabilir.

NumberStyles.AllowHexSpecifier Bayrağı kullanılıyorsa, value 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, NumberStylesHexNumberher iki boşluk bayrağını da içeren bileşik bir stile sahiptir.)

Not

Onaltılık bir sayının dize gösterimi isevalue, bundan önce onu onaltılık sayı olarak ayıran herhangi bir dekorasyon (veya &hgibi0x) olamaz. Bu dönüştürmenin başarısız olmasına neden olur.

Onaltılık bir dizeysevalue, yöntemi ilk TryParse(String, NumberStyles, IFormatProvider, BigInteger) iki onaltılık basamak değerinden büyük veya değerine eşitse0x80, ikinin tamamlayıcı gösterimini kullanarak depolanmış negatif bir sayı olarak yorumlarvalue. Başka bir deyişle yöntemi, içindeki ilk baytın value en yüksek sıralı bitini işaret biti olarak yorumlar. Onaltılık dizenin pozitif sayı olarak doğru yorumlandığından emin olmak için içindeki ilk basamak value sıfır değerine sahip olmalıdır. Örneğin, yöntemi negatif bir değer olarak yorumlar 0x80 , ancak ya da 0x0800x0080 pozitif bir değer olarak yorumlar. Aşağıdaki örnekte, negatif ve pozitif değerleri temsil eden onaltılık dizeler arasındaki fark gösterilmektedir.

using System;
using System.Globalization;
using System.Numerics;

public class Example
{
   public static void Main()
   {
      string[] hexStrings = { "80", "E293", "F9A2FF", "FFFFFFFF",
                              "080", "0E293", "0F9A2FF", "0FFFFFFFF",
                              "0080", "00E293", "00F9A2FF", "00FFFFFFFF" };
      BigInteger number = BigInteger.Zero;

      foreach (string hexString in hexStrings)
      {
         if (BigInteger.TryParse(hexString, NumberStyles.AllowHexSpecifier,
                                 null, out number))
            Console.WriteLine("Converted 0x{0} to {1}.", hexString, number);
         else
            Console.WriteLine("Cannot convert '{0}' to a BigInteger.", hexString);
      }
   }
}
// The example displays the following output:
//       Converted 0x80 to -128.
//       Converted 0xE293 to -7533.
//       Converted 0xF9A2FF to -417025.
//       Converted 0xFFFFFFFF to -1.
//       Converted 0x080 to 128.
//       Converted 0x0E293 to 58003.
//       Converted 0x0F9A2FF to 16360191.
//       Converted 0x0FFFFFFFF to 4294967295.
//       Converted 0x0080 to 128.
//       Converted 0x00E293 to 58003.
//       Converted 0x00F9A2FF to 16360191.
//       Converted 0x00FFFFFFFF to 4294967295.
open System.Globalization
open System.Numerics

let hexStrings =
    [| "80"
       "E293"
       "F9A2FF"
       "FFFFFFFF"
       "080"
       "0E293"
       "0F9A2FF"
       "0FFFFFFFF"
       "0080"
       "00E293"
       "00F9A2FF"
       "00FFFFFFFF" |]

for hexString in hexStrings do
    match BigInteger.TryParse(hexString, NumberStyles.AllowHexSpecifier, null) with
    | true, number -> printfn $"Converted 0x{hexString} to {number}."
    | _ -> printfn $"Cannot convert '{hexString}' to a BigInteger."

// The example displays the following output:
//       Converted 0x80 to -128.
//       Converted 0xE293 to -7533.
//       Converted 0xF9A2FF to -417025.
//       Converted 0xFFFFFFFF to -1.
//       Converted 0x080 to 128.
//       Converted 0x0E293 to 58003.
//       Converted 0x0F9A2FF to 16360191.
//       Converted 0x0FFFFFFFF to 4294967295.
//       Converted 0x0080 to 128.
//       Converted 0x00E293 to 58003.
//       Converted 0x00F9A2FF to 16360191.
//       Converted 0x00FFFFFFFF to 4294967295.
Imports System.Globalization
Imports System.Numerics

Module Example
   Public Sub Main()
      Dim hexStrings() As String = { "80", "E293", "F9A2FF", "FFFFFFFF", 
                                     "080", "0E293", "0F9A2FF", "0FFFFFFFF",  
                                     "0080", "00E293", "00F9A2FF", "00FFFFFFFF" }
      Dim number As BigInteger = BigInteger.Zero
      
      For Each hexString As String In hexStrings
         If BigInteger.TryParse(hexString, NumberStyles.AllowHexSpecifier, 
                                Nothing, number) Then
            Console.WriteLine("Converted 0x{0} to {1}.", hexString, number)
         Else
            Console.WriteLine("Cannot convert '{0}' to a BigInteger.", hexString)
         End If
      Next         
   End Sub
End Module
' The example displays the following output:
'       Converted 0x80 to -128.
'       Converted 0xE293 to -7533.
'       Converted 0xF9A2FF to -417025.
'       Converted 0xFFFFFFFF to -1.
'       Converted 0x080 to 128.
'       Converted 0x0E293 to 58003.
'       Converted 0x0F9A2FF to 16360191.
'       Converted 0x0FFFFFFFF to 4294967295.
'       Converted 0x0080 to 128.
'       Converted 0x00E293 to 58003.
'       Converted 0x00F9A2FF to 16360191.
'       Converted 0x00FFFFFFFF to 4294967295.

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

ise providernull, NumberFormatInfo geçerli kültürün nesnesi kullanılır.

Ayrıca bkz.

Şunlara uygulanır