SByte.TryParse Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Bir sayının dize gösterimini 8 bitlik işaretli tamsayı eşdeğerine dönüştürür. Dönüş kodu, 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, SByte)	UTF-8 karakterlik bir aralığı bir değere ayrıştırmaya çalışır.
TryParse(ReadOnlySpan<Char>, SByte)	Bir sayının span gösterimini eşdeğerine SByte dönüştürmeyi dener ve dönüştürmenin başarılı olup olmadığını belirten bir değer döndürür.
TryParse(String, SByte)	Bir sayının dize gösterimini eşdeğerine SByte dönüştürmeyi dener ve dönüştürmenin başarılı olup olmadığını belirten bir değer döndürür.
TryParse(ReadOnlySpan<Char>, IFormatProvider, SByte)	Bir karakter aralığını bir değere ayrıştırmaya çalışır.
TryParse(String, IFormatProvider, SByte)	Bir dizeyi bir değere ayrıştırmaya çalışır.
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, SByte)	UTF-8 karakterlik bir aralığı bir değere ayrıştırmaya çalışır.
TryParse(ReadOnlySpan<Byte>, SByte)	Bir sayının dize gösterimini içeren UTF-8 karakter aralığını 8 bit işaretli tamsayı eşdeğerine dönüştürmeye çalışır.
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, SByte)	Belirtilen stilde ve kültüre özgü biçimdeki bir sayının span gösterimini eşdeğerine SByte dönüştürmeyi dener ve dönüştürmenin başarılı olup olmadığını belirten bir değer döndürür.
TryParse(String, NumberStyles, IFormatProvider, SByte)	Belirtilen stilde ve kültüre özgü biçimdeki bir sayının dize gösterimini eşdeğerine SByte 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<Byte>, IFormatProvider, SByte)

Kaynak:

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

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

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

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

Parametreler

utf8Text

ReadOnlySpan<Byte>

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

provider

IFormatProvider

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

result

SByte

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

Boolean

true başarıyla ayrıştırıldıysa utf8Text ; değilse, false.

TryParse(ReadOnlySpan<Char>, SByte)

Kaynak:

SByte.cs

Önemli

Bu API, CLS uyumlu değildir.

Bir sayının span gösterimini eşdeğerine SByte 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> s, [Runtime::InteropServices::Out] System::SByte % result);

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

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

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

Parametreler

s

ReadOnlySpan<Char>

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

result

SByte

Bu yöntem döndürdüğünde, dönüştürme başarılı olursa içinde bulunan sayının eşdeğeri olan 8 bit imzalı s tamsayı değerini veya dönüştürme başarısız olursa sıfırı içerir. veya parametresi nullEmptydoğru biçimde değilse s veya SByte.MinValue değerinden küçük veya SByte.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

Boolean

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

TryParse(String, SByte)

Kaynak:

SByte.cs

Önemli

Bu API, CLS uyumlu değildir.

Bir sayının dize gösterimini eşdeğerine SByte 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 ^ s, [Runtime::InteropServices::Out] System::SByte % result);

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

static member TryParse : string * sbyte -> bool

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

Parametreler

s

String

Dönüştürülecek sayı içeren bir dize.

result

SByte

Bu yöntem döndürdüğünde, dönüştürme başarılı olursa içinde bulunan sayının eşdeğeri olan 8 bit imzalı s tamsayı değerini veya dönüştürme başarısız olursa sıfırı içerir. veya parametresi nullEmptydoğru biçimde değilse s veya SByte.MinValue değerinden küçük veya SByte.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

Boolean

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

Örnekler

Aşağıdaki örnek, yöntemini çağırarak bir dizideki dizeleri değerlere SByte dönüştürmeyi TryParse(String, SByte) dener.

string[] numericStrings = {"-3.6", "12.8", "+16.7", "    3   ", "(17)", 
                           "-17", "+12", "18-", "987", "1,024", "  127 "};
sbyte number;
foreach (string numericString in numericStrings)
{
   if (sbyte.TryParse(numericString, out number)) 
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number);
   else
      Console.WriteLine("Cannot convert '{0}' to an SByte.", numericString);
}
// The example displays the following output to the console:
//       Cannot convert '-3.6' to an SByte.
//       Cannot convert '12.8' to an SByte.
//       Cannot convert '+16.7' to an SByte.
//       Converted '    3   ' to 3.
//       Cannot convert '(17)' to an SByte.
//       Converted '-17' to -17.
//       Converted '+12' to 12.
//       Cannot convert '18-' to an SByte.
//       Cannot convert '987' to an SByte.
//       Cannot convert '1,024' to an SByte.
//       Converted '  127 ' to 127.

open System

let numericStrings = 
    [| "-3.6"; "12.8"; "+16.7"; "    3   "; "(17)" 
       "-17"; "+12"; "18-"; "987"; "1,024"; "  127 " |]

for numericString in numericStrings do
    match SByte.TryParse numericString with 
    | true, number ->
        printfn $"Converted '{numericString}' to {number}."
    | _ ->
        printfn $"Cannot convert '{numericString}' to an SByte."
// The example displays the following output to the console:
//       Cannot convert '-3.6' to an SByte.
//       Cannot convert '12.8' to an SByte.
//       Cannot convert '+16.7' to an SByte.
//       Converted '    3   ' to 3.
//       Cannot convert '(17)' to an SByte.
//       Converted '-17' to -17.
//       Converted '+12' to 12.
//       Cannot convert '18-' to an SByte.
//       Cannot convert '987' to an SByte.
//       Cannot convert '1,024' to an SByte.
//       Converted '  127 ' to 127.

Dim numericStrings() As String = {"-3.6", "12.8", "+16.7", "    3   ", _
                                  "(17)", "-17", "+12", "18-", "987", _
                                  "1,024", "  127 "}
Dim number As SByte
For Each numericString As String In numericStrings
   If SByte.TryParse(numericString, number) Then
      Console.WriteLine("Converted '{0}' to {1}.", numericString, number)
   Else
      Console.WriteLine("Cannot convert '{0}' to an SByte.", numericString)
   End If      
Next
' The example displays the following output to the console:
'       Cannot convert '-3.6' to an SByte.
'       Cannot convert '12.8' to an SByte.
'       Cannot convert '+16.7' to an SByte.
'       Converted '    3   ' to 3.
'       Cannot convert '(17)' to an SByte.
'       Converted '-17' to -17.
'       Converted '+12' to 12.
'       Cannot convert '18-' to an SByte.
'       Cannot convert '987' to an SByte.
'       Cannot convert '1,024' to an SByte.
'       Converted '  127 ' to 127.

Açıklamalar

SByte.TryParse(String, SByte) yöntemi yöntemine SByte.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, 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.

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.

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

s 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, SByte) .

Ayrıca bkz.

• Örnek: .NET Core WinForms Biçimlendirme Yardımcı Programı (C#)
• Örnek: .NET Core WinForms Biçimlendirme Yardımcı Programı (Visual Basic)

TryParse(ReadOnlySpan<Char>, IFormatProvider, SByte)

Kaynak:

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

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

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

Public Shared Function TryParse (s As ReadOnlySpan(Of Char), provider As IFormatProvider, ByRef result As SByte) 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

SByte

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

Boolean

true başarıyla ayrıştırıldıysa s ; değilse, false.

TryParse(String, IFormatProvider, SByte)

Kaynak:

SByte.cs

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

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

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

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

Public Shared Function TryParse (s As String, provider As IFormatProvider, ByRef result As SByte) 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

SByte

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

Boolean

true başarıyla ayrıştırıldıysa s ; değilse, false.

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

Kaynak:

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

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

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

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

Parametreler

utf8Text

ReadOnlySpan<Byte>

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

style

NumberStyles

içinde utf8Textbulunabilecek sayı stillerinin bit düzeyinde birleşimi.

provider

IFormatProvider

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

result

SByte

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

Boolean

true başarıyla ayrıştırıldıysa utf8Text ; değilse, false.

TryParse(ReadOnlySpan<Byte>, SByte)

Kaynak:

SByte.cs

Bir sayının dize gösterimini içeren UTF-8 karakter aralığını 8 bit işaretli tamsayı eşdeğerine dönüştürmeye çalışır.

public:
 static bool TryParse(ReadOnlySpan<System::Byte> utf8Text, [Runtime::InteropServices::Out] System::SByte % result);

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

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

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

SByte

Bu yöntem döndürdüğünde, dönüştürme başarılı olursa içinde bulunan utf8Text sayıya eşdeğer 8 bit imzalı 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

Boolean

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

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

Kaynak:

SByte.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen stilde ve kültüre özgü biçimdeki bir sayının span gösterimini eşdeğerine SByte 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> s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = System::Numerics::INumberBase<System::SByte>::TryParse;

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

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

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

Parametreler

s

ReadOnlySpan<Char>

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

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 skültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

result

SByte

Bu yöntem döndürdüğünde, içinde bulunan ssayıya eşdeğer 8 bit imzalı tamsayı değerini, dönüştürme başarılı olursa veya dönüştürme başarısız olursa sıfır içerir. parametre null veya Emptyile uyumlu stylebir biçimde değilse veya SByte.MinValue değerinden küçük veya SByte.MaxValue değerinden büyük bir sayıyı temsil ederse dönüştürme başarısız olur.s 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

Boolean

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

TryParse(String, NumberStyles, IFormatProvider, SByte)

Kaynak:

SByte.cs

Önemli

Bu API, CLS uyumlu değildir.

CLS uyumlu alternatif

System.Int16.TryParse(String, Int16)

Belirtilen stilde ve kültüre özgü biçimdeki bir sayının dize gösterimini eşdeğerine SByte 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 ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider, [Runtime::InteropServices::Out] System::SByte % result) = System::Numerics::INumberBase<System::SByte>::TryParse;

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

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

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

Parametreler

s

String

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

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 skültüre özgü biçimlendirme bilgileri sağlayan bir nesne.

result

SByte

Bu yöntem döndürdüğünde, içinde bulunan ssayıya eşdeğer 8 bit imzalı tamsayı değerini, dönüştürme başarılı olursa veya dönüştürme başarısız olursa sıfır içerir. parametre null veya Emptyile uyumlu stylebir biçimde değilse veya SByte.MinValue değerinden küçük veya SByte.MaxValue değerinden büyük bir sayıyı temsil ederse dönüştürme başarısız olur.s 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

Boolean

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

Özel durumlar

ArgumentException

style bir NumberStyles değer değildir.

-veya-

styleve 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, SByte).

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      string numericString;
      NumberStyles styles;
      
      numericString = "106";
      styles = NumberStyles.Integer;
      CallTryParse(numericString, styles);
      
      numericString = "-106";
      styles = NumberStyles.None;
      CallTryParse(numericString, styles);
      
      numericString = "103.00";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);
      
      numericString = "103.72";
      styles = NumberStyles.Integer | NumberStyles.AllowDecimalPoint;
      CallTryParse(numericString, styles);

      numericString = "10E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
      
      numericString = "12E-01";
      CallTryParse(numericString, styles);
          
      numericString = "12E01";
      CallTryParse(numericString, styles); 
      
      numericString = "C8";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x8C";
      CallTryParse(numericString, NumberStyles.HexNumber);
   }
   
   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      sbyte number;
      bool result = SByte.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 '106' to 106.
//       Attempted conversion of '-106' failed.
//       Converted '103.00' to 103.
//       Attempted conversion of '103.72' failed.
//       Converted '10E-01' to 1.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E01' to 120.
//       Converted 'C8' to -56.
//       Attempted conversion of '0x8C' failed.

open System
open System.Globalization

let callTryParse (stringToConvert: string) styles =
    match SByte.TryParse(stringToConvert, styles, CultureInfo.InvariantCulture) with
    | true, number ->
        printfn $"Converted '{stringToConvert}' to {number}."
    | _ ->
        printfn $"Attempted conversion of '{stringToConvert}' failed."

[<EntryPoint>]
let main _ =
    let numericString = "106"
    let styles = NumberStyles.Integer
    callTryParse numericString styles
    
    let numericString = "-106"
    let styles = NumberStyles.None
    callTryParse numericString styles
    
    let numericString = "103.00"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    callTryParse numericString styles
    
    let numericString = "103.72"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowDecimalPoint
    callTryParse numericString styles

    let numericString = "10E-01"
    let styles = NumberStyles.Integer ||| NumberStyles.AllowExponent
    callTryParse numericString styles 
    
    let numericString = "12E-01"
    callTryParse numericString styles
        
    let numericString = "12E01"
    callTryParse numericString styles 
    
    let numericString = "C8"
    callTryParse numericString NumberStyles.HexNumber
    
    let numericString = "0x8C"
    callTryParse numericString NumberStyles.HexNumber
    0

// The example displays the following output:
//       Converted '106' to 106.
//       Attempted conversion of '-106' failed.
//       Converted '103.00' to 103.
//       Attempted conversion of '103.72' failed.
//       Converted '10E-01' to 1.
//       Attempted conversion of '12E-01' failed.
//       Converted '12E01' to 120.
//       Converted 'C8' to -56.
//       Attempted conversion of '0x8C' failed.

Imports System.Globalization

Module StringParsing
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "106"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-106"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      numericString = "103.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "103.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "10E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
      
      numericString = "12E-01"
      CallTryParse(numericString, styles)
          
      numericString = "12E01"
      CallTryParse(numericString, styles) 
      
      numericString = "C8"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x8C"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As SByte
      Dim result As Boolean = SByte.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 '106' to 106.
'       Attempted conversion of '-106' failed.
'       Converted '103.00' to 103.
'       Attempted conversion of '103.72' failed.
'       Converted '10E-01' to 1.
'       Attempted conversion of '12E-01' failed.
'       Converted '12E01' to 120.
'       Converted 'C8' to -56.
'       Attempted conversion of '0x8C' failed.

Açıklamalar

TryParse(String, NumberStyles, IFormatProvider, SByte) 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.

NumberStyles.AllowHexSpecifier Bayrağı kullanılıyorsa, value onaltılık bir değer olmalıdır. Geçerli onaltılık basamaklar 0-9, a-f ve A-F'dir. 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.

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:

• 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 providernull, NumberFormatInfo geçerli kültürün nesnesi kullanılır.

Ayrıca bkz.

• Parse(String, NumberStyles, IFormatProvider)
• .NET'te Sayısal Dizeleri Ayrıştırma