UInt16.TryParse Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Bir sayının dize gösterimini 16 bit işaretsiz tamsayı eşdeğerine dönüştürü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

Name	Description
TryParse(ReadOnlySpan<Byte>, IFormatProvider, UInt16)	UTF-8 karakterlik bir aralığı bir değere ayrıştırmaya çalışır.
TryParse(ReadOnlySpan<Char>, UInt16)	Bir sayının span gösterimini 16 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, UInt16)	Bir sayının dize gösterimini 16 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, UInt16)	Bir karakter aralığını bir değere ayrıştırmaya çalışır.
TryParse(String, IFormatProvider, UInt16)	Bir dizeyi bir değere ayrıştırmaya çalışır.
TryParse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider, UInt16)	UTF-8 karakterlik bir aralığı bir değere ayrıştırmaya çalışır.
TryParse(ReadOnlySpan<Byte>, UInt16)	Bir sayının dize gösterimini içeren UTF-8 karakter aralığını 16 bit işaretsiz tamsayı eşdeğerine dönüştürmeye çalışır.
TryParse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider, UInt16)	Belirtilen stilde ve kültüre özgü biçimdeki bir sayının span gösterimini 16 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, UInt16)	Belirtilen stilde ve kültüre özgü biçimdeki bir sayının dize gösterimini 16 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, UInt16)

Kaynak:

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

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

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

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

UInt16

Sonuç olarak, başarıyla ayrıştırma utf8Text 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 utf8Text ; değilse, false.

TryParse(ReadOnlySpan<Char>, UInt16)

Kaynak:

UInt16.cs

Önemli

Bu API, CLS uyumlu değildir.

Bir sayının span gösterimini 16 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::UInt16 % result);

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

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

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

Parametreler

s

ReadOnlySpan<Char>

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

result

UInt16

Bu yöntem döndürdüğünde, içinde yer alan sayıya seşdeğer olan 16 bit işaretsiz tamsayı değerini, dönüştürme başarılı olursa değerini veya dönüştürme başarısız olursa sıfırı içerir. parametre null veya Emptydoğru biçimde değilse s dönüştürme başarısız olur. veya UInt16.MinValue değerinden küçük veya UInt16.MaxValue değerinden büyük bir sayıyı temsil eder. Bu parametre başlatılmamış olarak geçirilir; başlangıçta verilen 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, UInt16)

Kaynak:

UInt16.cs

Önemli

Bu API, CLS uyumlu değildir.

CLS uyumlu alternatif

System.Int32.TryParse(String, Int32)

Bir sayının dize gösterimini 16 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::UInt16 % result);

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

static member TryParse : string * uint16 -> bool

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

Parametreler

s

String

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

result

UInt16

Bu yöntem döndürdüğünde, içinde yer alan sayıya seşdeğer olan 16 bit işaretsiz tamsayı değerini, dönüştürme başarılı olursa değerini veya dönüştürme başarısız olursa sıfırı içerir. parametre null veya Emptyise, doğru biçimde değilse veya UInt16.MinValue değerinden küçük veya UInt16.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ılmamış olarak geçirilir; başlangıçta verilen 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, bir dize dizisindeki TryParse(String, UInt16) her öğe için yöntemini bir kez çağırır.

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

let numericStrings = 
    [| "1293.8"; "+1671.7"; "28347."
       "   33113684  "; "(0)"; "-0"; "-1" 
       "+1293617"; "18-"; "119870"; "31,024" 
       "  3127094 "; "00700000" |]

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

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

Açıklamalar

yöntemi TryParse(String, UInt16) 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ı FormatException test etmek için s özel durum işleme kullanma gereksinimini ortadan kaldırır ve başarıyla ayrıştırılamaz.

parametresi, s 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.
imza	İ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.

Not

parametresi tarafından s 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, yalnızca baştaki ve sondaki boşluklara ve önünde işareti olan boşluklara izin verilir. stil öğelerini içinde bulunabilecek skültüre özgü biçimlendirme bilgileriyle açıkça tanımlamak için yöntemini çağırın TryParse(String, NumberStyles, IFormatProvider, UInt16) .

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

Bu aşırı yükleme, parametredeki s tüm basamakları ondalık basamaklar olarak yorumlar. Onaltılık bir sayının dize gösterimini ayrıştırmak için bunun yerine aşırı yüklemeyi çağırın TryParse(String, NumberStyles, IFormatProvider, UInt16) .

Ayrıca bkz.

• Parse(String)
• ToString()
• .NET'te Sayısal Dizeleri Ayrıştırma
• Örnek: .NET Core WinForms Biçimlendirme Yardımcı Programı (C#)
• Örnek: .NET Core WinForms Biçimlendirme Yardımcı Programı (Visual Basic)

TryParse(ReadOnlySpan<Char>, IFormatProvider, UInt16)

Kaynak:

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

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

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

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

Parametreler

s

ReadOnlySpan<Char>

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

provider

IFormatProvider

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

result

UInt16

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, UInt16)

Kaynak:

UInt16.cs

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

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

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

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

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

Parametreler

s

String

Ayrıştırmak için dize.

provider

IFormatProvider

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

result

UInt16

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, UInt16)

Kaynak:

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

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

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

Public Shared Function TryParse (utf8Text As ReadOnlySpan(Of Byte), style As NumberStyles, provider As IFormatProvider, ByRef result As UShort) 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

UInt16

Sonuç olarak, başarıyla ayrıştırma utf8Text 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 utf8Text ; değilse, false.

TryParse(ReadOnlySpan<Byte>, UInt16)

Kaynak:

UInt16.cs

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

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

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

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

UInt16

Bu yöntem döndürdüğünde, dönüştürme başarılı olursa içindeki sayıya utf8Text eşdeğer 16 bit işaretsiz tamsayı değerini veya dönüştürme başarısız olursa sıfır değerini 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

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

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

Kaynak:

UInt16.cs

Önemli

Bu API, CLS uyumlu değildir.

Belirtilen stilde ve kültüre özgü biçimdeki bir sayının span gösterimini 16 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::UInt16 % result) = System::Numerics::INumberBase<System::UInt16>::TryParse;

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

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

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

Parametreler

s

ReadOnlySpan<Char>

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

style

NumberStyles

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

provider

IFormatProvider

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

result

UInt16

Bu yöntem döndürdüğünde, içinde bulunan ssayının eşdeğeri olan 16 bit işaretsiz tamsayı değerini, dönüştürme başarılı olursa değerini veya dönüştürme başarısız olursa sıfırı içerir. parametresi null veya Emptyile uyumlu stylebir biçimde değilse veya UInt16.MinValue değerinden küçük veya UInt16.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ılmamış olarak geçirilir; başlangıçta verilen 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, UInt16)

Kaynak:

UInt16.cs

Önemli

Bu API, CLS uyumlu değildir.

CLS uyumlu alternatif

System.Int32.TryParse(String, Int32)

Belirtilen stilde ve kültüre özgü biçimdeki bir sayının dize gösterimini 16 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::UInt16 % result) = System::Numerics::INumberBase<System::UInt16>::TryParse;

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

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

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

Parametreler

s

String

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

style

NumberStyles

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

provider

IFormatProvider

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

result

UInt16

Bu yöntem döndürdüğünde, içinde bulunan ssayının eşdeğeri olan 16 bit işaretsiz tamsayı değerini, dönüştürme başarılı olursa değerini veya dönüştürme başarısız olursa sıfırı içerir. parametresi null veya Emptyile uyumlu stylebir biçimde değilse veya UInt16.MinValue değerinden küçük veya UInt16.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ılmamış olarak geçirilir; başlangıçta verilen 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, UInt16).

using System;
using System.Globalization;

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

      numericString = "2210E-01";
      styles = NumberStyles.Integer | NumberStyles.AllowExponent;
      CallTryParse(numericString, styles); 
      
      numericString = "9112E-01";
      CallTryParse(numericString, styles);
          
      numericString = "312E01";
      CallTryParse(numericString, styles); 
      
      numericString = "FFC8";
      CallTryParse(numericString, NumberStyles.HexNumber);
      
      numericString = "0x8F8C";
      CallTryParse(numericString, NumberStyles.HexNumber);
   }
   
   private static void CallTryParse(string stringToConvert, NumberStyles styles)
   {
      ushort number;
      bool result = UInt16.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 '10603' to 10603.
//       Attempted conversion of '-10603' failed.
//       Converted '29103.00' to 29103.
//       Attempted conversion of '10345.72' failed.
//       Converted '2210E-01' to 221.
//       Attempted conversion of '9112E-01' failed.
//       Converted '312E01' to 3120.
//       Converted 'FFC8' to 65480.
//       Attempted conversion of '0x8F8C' failed.

open System
open System.Globalization

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

do
    let numericString = "10603"
    let styles = NumberStyles.Integer
    callTryParse numericString styles
    
    let numericString = "-10603"
    let styles = NumberStyles.None
    callTryParse numericString styles
    
    let numericString = "29103.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 = "2210E-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 = "FFC8"
    callTryParse numericString NumberStyles.HexNumber
    
    let numericString = "0x8F8C"
    callTryParse numericString NumberStyles.HexNumber
// The example displays the following output:
//       Converted '10603' to 10603.
//       Attempted conversion of '-10603' failed.
//       Converted '29103.00' to 29103.
//       Attempted conversion of '10345.72' failed.
//       Converted '2210E-01' to 221.
//       Attempted conversion of '9112E-01' failed.
//       Converted '312E01' to 3120.
//       Converted 'FFC8' to 65480.
//       Attempted conversion of '0x8F8C' failed.

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim numericString As String
      Dim styles As NumberStyles
      
      numericString = "10603"
      styles = NumberStyles.Integer
      CallTryParse(numericString, styles)
      
      numericString = "-10603"
      styles = NumberStyles.None
      CallTryParse(numericString, styles)
      
      numericString = "29103.00"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)
      
      numericString = "10345.72"
      styles = NumberStyles.Integer Or NumberStyles.AllowDecimalPoint
      CallTryParse(numericString, styles)

      numericString = "2210E-01"
      styles = NumberStyles.Integer Or NumberStyles.AllowExponent
      CallTryParse(numericString, styles) 
      
      numericString = "9112E-01"
      CallTryParse(numericString, styles)
          
      numericString = "312E01"
      CallTryParse(numericString, styles) 
      
      numericString = "FFC8"
      CallTryParse(numericString, NumberStyles.HexNumber)
      
      numericString = "0x8F8C"
      CallTryParse(numericString, NumberStyles.HexNumber)
   End Sub
   
   Private Sub CallTryParse(stringToConvert As String, styles AS NumberStyles)
      Dim number As UShort
      Dim result As Boolean = UInt16.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 '10603' to 10603.
'       Attempted conversion of '-10603' failed.
'       Converted '29103.00' to 29103.
'       Attempted conversion of '10345.72' failed.
'       Converted '2210E-01' to 221.
'       Attempted conversion of '9112E-01' failed.
'       Converted '312E01' to 3120.
'       Converted 'FFC8' to 65480.
'       Attempted conversion of '0x8F8C' failed.

Açıklamalar

yöntemi TryParse(String, NumberStyles, IFormatProvider, UInt16) 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ı FormatException test etmek için s ö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 parametrede s izin verilen stil öğelerini (boşluk veya pozitif veya negatif işareti gibi) tanımlar. Numaralandırmadaki NumberStyles bit bayraklarının bir bileşimi olmalıdır. değerine styles bağlı olarak parametresi aşağıdaki öğeleri içerebilir:

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

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

[ws]hexdigits[ws]

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

Ws İsteğe bağlı boşluk. Bayrağı içeriyorsa başında veya bayrağı içeriyorsa sonunda sstyleNumberStyles.AllowLeadingWhite boşluk görüntülenebilir sstyle.NumberStyles.AllowTrailingWhite

$ Kültüre özgü para birimi simgesi. Dizedeki konumu, parametresinin yöntemi CurrencyPositivePattern tarafından döndürülen nesnenin özelliğiyle NumberFormatInfoGetFormat tanımlanırprovider. Bayrağı içeriyorsa s para birimi simgesi içinde styleNumberStyles.AllowCurrencySymbol görüntülenebilir.

Işareti İsteğe bağlı bir işaret. bayrağını içeriyorsas, işaretinin styleNumberStyles.AllowLeadingSign başında ve bayrağın dahil s olup olmadığının styleNumberStyles.AllowTrailingSign sonunda görüntülenebilir. Parantezler, bayrağı içeriyorsa s negatif bir değeri style belirtmek için içinde kullanılabilirNumberStyles.AllowParentheses. Ancak negatif işareti varsa, s ayrıştırma işleminin başarılı olması için yalnızca sıfır değerini temsil edebilir.

Basamak 0 ile 9 arasında bir basamak dizisi.

, Kültüre özgü grup ayırıcısı. bayrağını içeriyorsa, tarafından provider belirtilen kültürün grup ayırıcısı s içinde styleNumberStyles.AllowThousands görüntülenebilir.

. Kültüre özgü ondalık nokta simgesi. bayrağını içeriyorsaprovider, tarafından s belirtilen kültürün ondalık nokta simgesi içinde styleNumberStyles.AllowDecimalPoint görüntülenebilir.

fractional_digits 0 rakamının bir veya daha fazla tekrarı. Kesirli basamaklar yalnızca s bayrağı içeriyorsa style içinde görüntülenebilirNumberStyles.AllowDecimalPoint.

E Değerin üstel (bilimsel) gösterimde temsil olduğunu gösteren "e" veya "E" karakteri. parametresi, s bayrağını içeriyorsa üstel gösterimde style bir sayıyı NumberStyles.AllowExponent temsil edebilir.

exponential_digits 0 ile 9 arasında bir basamak dizisi. parametresi, s bayrağını içeriyorsa üstel gösterimde style bir sayıyı NumberStyles.AllowExponent temsil edebilir.

hexdigits 0'dan f'ye veya 0'dan F'ye kadar onaltılık basamak dizisi.

Not

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

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

Bileşik NumberStyles olmayan değerler	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 döndürür false.
AllowExponent	Exponential_digits ile 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	başındaki s öğesi.
AllowTrailingWhite	sonundaki s öğesi.
AllowLeadingSign	Rakamlardan önceki sign öğesi.
AllowTrailingSign	Basamakların ardından gelen sign öğesi.
AllowParentheses	Sıfır sayısal değer kapsayan parantez biçimindeki sign öğesi.
AllowThousands	Grup ayırıcı (,) öğesi.
AllowCurrencySymbol	Para birimi ($) öğesi.
Currency	Tüm öğeler. Ancak, s üstel gösterimde onaltılık bir sayıyı veya sayıyı temsil edemez.
Float	başında veya sonundaki s öğesi, öğesinin başında ve ondalık nokta (s) simgesiyle işaret eder. parametresi üstel s gösterim de kullanabilir.
Number	ws, sign, group ayırıcı (,) ve ondalık ayırıcı (.) öğeleri.
Any	Tüm öğeler. Ancak, s onaltılık bir sayıyı temsil edemez.

NumberStyles.AllowHexSpecifier Bayrağı kullanılıyorsa, s onaltılık bir değer olmalıdır. Geçerli onaltılık basamaklar 0- 9, a - f ve A - F arasındadır. "0x" gibi bir ön ek desteklenmez ve ayrıştırma işleminin başarısız olmasına neden olur. içinde style bulunabilecek diğer bayraklar yalnızca ve NumberStyles.AllowLeadingWhite'tirNumberStyles.AllowTrailingWhite. (Numaralandırma, NumberStyles her iki boşluk bayrağını da içeren bileşik bir stile HexNumbersahiptir.)

Not

Onaltılık bir sayının dize gösterimi ises, bundan önce onu onaltılık sayı olarak ayıran herhangi bir süsleme (veya 0xgibi&h) 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 NumberFormatInfohakkında kültüre özgü bilgiler sağlayan bir s nesnesi döndürür. provider parametresi aşağıdakilerden herhangi biri olabilir:

• CultureInfo Biçimlendirme bilgileri sağlayan kültürü temsil eden nesne. yöntemi GetFormat , bu kültür için sayısal biçimlendirme bilgileri sağlayan nesneyi döndürür NumberFormatInfo .

• 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 bilgileri sağlayan nesnesinin örneğini NumberFormatInfo oluşturur ve döndürür.

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

Ayrıca bkz.

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