SByte.Parse 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.

Aşırı Yüklemeler

Parse(String, NumberStyles, IFormatProvider)	Belirtilen stilde ve kültüre özgü biçimdeki bir sayının dize gösterimini 8 bit imzalı eşdeğerine dönüştürür.
Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)	Belirtilen stilde ve kültüre özgü biçimdeki bir sayının span gösterimini 8 bit imzalı eşdeğerine dönüştürür.
Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)	UTF-8 karakterlik bir aralığı bir değere ayrıştırıyor.
Parse(String, IFormatProvider)	Belirtilen kültüre özgü biçimdeki bir sayının dize gösterimini 8 bit işaretli tamsayı eşdeğerine dönüştürür.
Parse(String)	Bir sayının dize gösterimini 8 bitlik işaretli tamsayı eşdeğerine dönüştürür.
Parse(ReadOnlySpan<Char>, IFormatProvider)	Bir karakter aralığını bir değere ayrıştırıyor.
Parse(ReadOnlySpan<Byte>, IFormatProvider)	UTF-8 karakterlik bir aralığı bir değere ayrıştırıyor.
Parse(String, NumberStyles)	Belirtilen stildeki bir sayının dize gösterimini 8 bit işaretli tamsayı eşdeğerine dönüştürür.

Parse(String, NumberStyles, IFormatProvider)

Kaynak:

SByte.cs

Önemli

Bu API, CLS uyumlu değildir.

CLS uyumlu alternatif

System.Int16.Parse(String, NumberStyles, IFormatProvider)

Belirtilen stilde ve kültüre özgü biçimdeki bir sayının dize gösterimini 8 bit imzalı eşdeğerine dönüştürür.

public:
 static System::SByte Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider) = System::Numerics::INumberBase<System::SByte>::Parse;

public static sbyte Parse (string s, System.Globalization.NumberStyles style, IFormatProvider? provider);

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

Public Shared Function Parse (s As String, style As NumberStyles, provider As IFormatProvider) As SByte

Parametreler

s

String

Dönüştürülecek sayıyı içeren bir dize. Dize, tarafından stylebelirtilen stil kullanılarak yorumlanır.

style

NumberStyles

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

provider

IFormatProvider

hakkında skültüre özgü biçimlendirme bilgileri sağlayan bir nesne. ise providernull, iş parçacığı geçerli kültürü kullanılır.

Döndürülenler

SByte

Parametresinde s belirtilen sayıya eşdeğer 8 bit imzalı bayt değeri.

Uygulamalar

Parse(String, NumberStyles, IFormatProvider)

Özel durumlar

ArgumentException

style bir NumberStyles değer değildir.

-veya-

styleve HexNumberbirleşimi AllowHexSpecifier değildir.

ArgumentNullException

s, null değeridir.

FormatException

s ile styleuyumlu bir biçimde değil.

OverflowException

sSByte.MinValue değerinden küçük veya SByte.MaxValue değerinden büyük bir sayıyı temsil eder.

-veya-

s sıfır olmayan kesirli basamaklar içerir.

Örnekler

Aşağıdaki örnekte, sayıların Parse(String, NumberStyles, IFormatProvider) çeşitli dize gösterimlerini imzalı tamsayı değerlerine dönüştürmek için yönteminin kullanımı gösterilmektedir.

using System;
using System.Globalization;

public class SByteConversion
{
   NumberFormatInfo provider = NumberFormatInfo.CurrentInfo;

   public static void Main()
   {
      string stringValue;
      NumberStyles style;

      stringValue = "   123   ";
      style = NumberStyles.None;     
      CallParseOperation(stringValue, style);
      
      stringValue = "000,000,123";
      style = NumberStyles.Integer | NumberStyles.AllowThousands;
      CallParseOperation(stringValue, style);
      
      stringValue = "-100";
      style = NumberStyles.AllowLeadingSign;
      CallParseOperation(stringValue, style);
      
      stringValue = "100-";
      style = NumberStyles.AllowLeadingSign;
      CallParseOperation(stringValue, style);
      
      stringValue = "100-";
      style = NumberStyles.AllowTrailingSign;
      CallParseOperation(stringValue, style);
      
      stringValue = "$100";
      style = NumberStyles.AllowCurrencySymbol;
      CallParseOperation(stringValue, style);
      
      style = NumberStyles.Integer;
      CallParseOperation(stringValue, style);
      
      style = NumberStyles.AllowDecimalPoint;
      CallParseOperation("100.0", style);
      
      stringValue = "1e02";
      style = NumberStyles.AllowExponent;
      CallParseOperation(stringValue, style);
      
      stringValue = "(100)";
      style = NumberStyles.AllowParentheses;
      CallParseOperation(stringValue, style);
   }
   
   private static void CallParseOperation(string stringValue, 
                                          NumberStyles style)
   {                                          
      sbyte number;
      
      if (stringValue == null)
         Console.WriteLine("Cannot parse a null string...");
         
      try
      {
         number = sbyte.Parse(stringValue, style);
         Console.WriteLine("SByte.Parse('{0}', {1})) = {2}", 
                           stringValue, style, number);   
      }
      catch (FormatException)
      {
         Console.WriteLine("'{0}' and {1} throw a FormatException", 
                           stringValue, style);   
      }      
      catch (OverflowException)
      {
         Console.WriteLine("'{0}' is outside the range of a signed byte",
                           stringValue);
      }
   }
}
// The example displays the following information to the console:
//       '   123   ' and None throw a FormatException
//       SByte.Parse('000,000,123', Integer, AllowThousands)) = 123
//       SByte.Parse('-100', AllowLeadingSign)) = -100
//       '100-' and AllowLeadingSign throw a FormatException
//       SByte.Parse('100-', AllowTrailingSign)) = -100
//       SByte.Parse('$100', AllowCurrencySymbol)) = 100
//       '$100' and Integer throw a FormatException
//       SByte.Parse('100.0', AllowDecimalPoint)) = 100
//       SByte.Parse('1e02', AllowExponent)) = 100
//       SByte.Parse('(100)', AllowParentheses)) = -100

open System
open System.Globalization

let provider = NumberFormatInfo.CurrentInfo
   
let callParseOperation stringValue (style: NumberStyles) =
    if stringValue = null then
        printfn "Cannot parse a null string..."
    else
        try
            let number = SByte.Parse(stringValue, style)
            printfn $"SByte.Parse('{stringValue}', {style})) = {number}" 
        with
        | :? FormatException ->
            printfn $"'{stringValue}' and {style} throw a FormatException"
        | :? OverflowException ->
            printfn $"'{stringValue}' is outside the range of a signed byte"

[<EntryPoint>]
let main _ =
    let stringValue = "   123   "
    let style = NumberStyles.None     
    callParseOperation stringValue style
    
    let stringValue = "000,000,123"
    let style = NumberStyles.Integer ||| NumberStyles.AllowThousands
    callParseOperation stringValue style
    
    let stringValue = "-100"
    let style = NumberStyles.AllowLeadingSign
    callParseOperation stringValue style
    
    let stringValue = "100-"
    let style = NumberStyles.AllowLeadingSign
    callParseOperation stringValue style
    
    let stringValue = "100-"
    let style = NumberStyles.AllowTrailingSign
    callParseOperation stringValue style
    
    let stringValue = "$100"
    let style = NumberStyles.AllowCurrencySymbol
    callParseOperation stringValue style
    
    let style = NumberStyles.Integer
    callParseOperation stringValue style
    
    let style = NumberStyles.AllowDecimalPoint
    callParseOperation "100.0" style
    
    let stringValue = "1e02"
    let style = NumberStyles.AllowExponent
    callParseOperation stringValue style
    
    let stringValue = "(100)"
    let style = NumberStyles.AllowParentheses
    callParseOperation stringValue style
    0

// The example displays the following information to the console:
//       '   123   ' and None throw a FormatException
//       SByte.Parse('000,000,123', Integer, AllowThousands)) = 123
//       SByte.Parse('-100', AllowLeadingSign)) = -100
//       '100-' and AllowLeadingSign throw a FormatException
//       SByte.Parse('100-', AllowTrailingSign)) = -100
//       SByte.Parse('$100', AllowCurrencySymbol)) = 100
//       '$100' and Integer throw a FormatException
//       SByte.Parse('100.0', AllowDecimalPoint)) = 100
//       SByte.Parse('1e02', AllowExponent)) = 100
//       SByte.Parse('(100)', AllowParentheses)) = -100

Imports System.Globalization

Module modMain
   Public Sub Main()
      Dim byteString As String 
      
      byteString = " 123"
      ParseString(byteString, NumberStyles.None)
      ParseString(byteString, NumberStyles.Integer)
      
      byteString = "3A"
      ParseString(byteString, NumberStyles.AllowHexSpecifier) 
      
      byteString = "21"
      ParseString(byteString, NumberStyles.Integer)
      ParseString(byteString, NumberStyles.AllowHexSpecifier)
      
      byteString = "-22"
      ParseString(byteString, NumberStyles.Integer)
      ParseString(byteString, NumberStyles.AllowParentheses)
      
      byteString = "(45)"
      ParseString(byteString, NumberStyles.AllowParentheses)
     
      byteString = "000,000,056"
      ParseString(byteString, NumberStyles.Integer)
      ParseString(byteString, NumberStyles.Integer Or NumberStyles.AllowThousands)
   End Sub
   
   Private Sub ParseString(value As String, style As NumberStyles)
      Dim number As SByte
      
      If value Is Nothing Then Console.WriteLine("Cannot parse a null string...") 
      
      Try
         number = SByte.Parse(value, style, NumberFormatInfo.CurrentInfo)
         Console.WriteLine("SByte.Parse('{0}', {1}) = {2}", value, style, number)   
      Catch e As FormatException
         Console.WriteLine("'{0}' and {1} throw a FormatException", value, style)   
      Catch e As OverflowException
         Console.WriteLine("'{0}' is outside the range of a signed byte",
                           value)
      End Try     
   End Sub
End Module
' The example displays the following information to the console:
'       ' 123' and None throw a FormatException
'       SByte.Parse(" 123", Integer)) = 123
'       SByte.Parse("3A", AllowHexSpecifier)) = 58
'       SByte.Parse("21", Integer)) = 21
'       SByte.Parse("21", AllowHexSpecifier)) = 33
'       SByte.Parse("-22", Integer)) = -22
'       '-22' and AllowParentheses throw a FormatException
'       SByte.Parse("(45)", AllowParentheses)) = -45
'       '000,000,056' and Integer throw a FormatException
'       SByte.Parse("000,000,056", Integer, AllowThousands)) = 56

Açıklamalar

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 simgesi 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[.fractional_digits][E[sign]exponential_digits][ws]

içeriyorsa styleAllowHexSpecifiers, 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 boşluk ve sstyle bayrağı içeriyorsa sonunda sstyleNumberStyles.AllowTrailingWhite görüntülenebilir.NumberStyles.AllowLeadingWhite
$	Kültüre özgü para birimi simgesi. Dizedeki konumu geçerli kültürün NumberFormatInfo.CurrencyPositivePattern özelliği tarafından tanımlanır. Bayrağı içeriyorsa geçerli kültürün NumberStyles.AllowCurrencySymbol para birimi simgesi içinde sstyle görünebilir.
sign	İsteğe bağlı bir işaret. İşaret, bayrağını içeriyorsa öğesinin sstyleNumberStyles.AllowLeadingSign başında ve bayrağını içeriyorsa öğesinin sstyleNumberStyles.AllowTrailingSign sonunda görüntülenebilir. Parantezler, bayrağı içeriyorsa NumberStyles.AllowParentheses negatif bir değeri style belirtmek için içinde kullanılabilirs.
Basamak	0 İle 9 arasında bir basamak dizisi.
.	Bir kültüre özgü ondalık nokta sembolü. bayrağını style içeriyorsa geçerli kültürün NumberStyles.AllowDecimalPoint ondalık noktası simgesi içinde s görüntülenebilir.
fractional_digits	Bayrağı içeriyorsa NumberStyles.AllowExponent 0-9 style basamaklarının bir veya daha fazla tekrarı veya yoksa 0 rakamının bir veya daha fazla yinelenme sayısı. Kesirli basamaklar yalnızca style bayrağını NumberStyles.AllowDecimalPoint içeriyorsa içinde s görüntülenebilir.
E	Değerin üslü (bilimsel) gösterimle temsil edildiğini gösteren "e" veya "E" karakteri. parametresi, s bayrağını içeriyorsa üstel gösteriminde style bir sayıyı NumberStyles.AllowExponent temsil edebilir.
exponential_digits	0 İle 9 arasında bir basamak dizisi. parametresi, s bayrağını içeriyorsa üstel gösteriminde style bir sayıyı NumberStyles.AllowExponent temsil edebilir.
hexdigits	0 İle f veya 0 ile f arasında onaltılık basamak dizisi.

Not

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

Yalnızca ondalık basamağı olan bir dize (stile 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 izin verilen s öğeler
NumberStyles.None	Yalnızca ondalık basamaklar.
NumberStyles.AllowDecimalPoint	Ondalık ayırıcı (.) ve fractional_digits öğeleri. Ancak, stil bayrağı içermiyorsa NumberStyles.AllowExponent, fractional_digits yalnızca bir veya daha fazla 0 basamak içermelidir; aksi takdirde, bir OverflowException oluşturulur.
NumberStyles.AllowExponent	Exponential_digits ile birlikte üstel gösterimi gösteren "e" veya "E" karakteri.
NumberStyles.AllowLeadingWhite	başındaki sws öğesi.
NumberStyles.AllowTrailingWhite	sonundaki sws öğesi.
NumberStyles.AllowLeadingSign	Rakamlardan önce pozitif bir işaret.
NumberStyles.AllowTrailingSign	Basamakların ardından pozitif bir işaret.
NumberStyles.AllowParentheses	Negatif bir değeri göstermek için basamaklardan önce ve sonra ayraçlar.
NumberStyles.AllowThousands	Grup ayırıcı (,) öğesi. Grup ayırıcısı içinde sgörüntülenebilir, ancak önünde yalnızca bir veya daha fazla 0 basamak bulunmalıdır.
NumberStyles.AllowCurrencySymbol	Para birimi ($) öğesi.

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'dir. Bununla birleştirilebilen 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 sayı stili NumberStyles.HexNumberiçerir.)

Not

s Parametre onaltılık bir sayının dize gösterimiyse, önünde onaltılık sayı olarak ayırt eden herhangi bir süsleme (veya &hgibi0x) olamaz. Bu, ayrıştırma işleminin bir özel durum oluşturmasına neden olur.

Onaltılık bir sayıyı temsil ederse s , Parse(String, NumberStyles) yöntemi bayt'ın yüksek sıralı bitini bir işaret biti olarak yorumlar.

provider parametresi, yöntemi biçimi hakkında kültüre özgü bilgiler sağlayan bir nesnesi döndüren bir IFormatProviderNumberFormatInfo uygulamadır GetFormats. Ayrıştırma işlemine provider özel biçimlendirme bilgileri sağlamak için parametresini kullanmanın üç yolu vardır:

• Biçimlendirme bilgileri sağlayan gerçek NumberFormatInfo nesneyi geçirebilirsiniz. (Uygulaması GetFormat basitçe kendisini döndürür.)

• Biçimlendirmesi kullanılacak kültürü belirten bir CultureInfo nesne geçirebilirsiniz. Özelliği NumberFormat biçimlendirme bilgileri sağlar.

• Özel IFormatProvider bir uygulama geçirebilirsiniz. GetFormat Yöntemi, biçimlendirme bilgilerini sağlayan nesneyi örneklemeli ve döndürmelidirNumberFormatInfo.

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

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

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 8 bit imzalı eşdeğerine dönüştürür.

public static sbyte Parse (ReadOnlySpan<char> s, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider? provider = default);

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

Public Shared Function Parse (s As ReadOnlySpan(Of Char), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = Nothing) As SByte

Parametreler

s

ReadOnlySpan<Char>

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

style

NumberStyles

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

provider

IFormatProvider

hakkında skültüre özgü biçimlendirme bilgileri sağlayan bir nesne. ise providernull, iş parçacığı geçerli kültürü kullanılır.

Döndürülenler

SByte

Parametresinde s belirtilen sayıya eşdeğer 8 bit imzalı bayt değeri.

Uygulamalar

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

Kaynak:

SByte.cs

UTF-8 karakterlik bir aralığı bir değere ayrıştırıyor.

public static sbyte Parse (ReadOnlySpan<byte> utf8Text, System.Globalization.NumberStyles style = System.Globalization.NumberStyles.Integer, IFormatProvider? provider = default);

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

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte), Optional style As NumberStyles = System.Globalization.NumberStyles.Integer, Optional provider As IFormatProvider = Nothing) As SByte

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.

Döndürülenler

SByte

ayrıştırma utf8Textişleminin sonucu.

Uygulamalar

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

Parse(String, IFormatProvider)

Kaynak:

SByte.cs

Önemli

Bu API, CLS uyumlu değildir.

CLS uyumlu alternatif

System.Int16.Parse(String)

Belirtilen kültüre özgü biçimdeki bir sayının dize gösterimini 8 bit imzalı tamsayı eşdeğerine dönüştürür.

public:
 static System::SByte Parse(System::String ^ s, IFormatProvider ^ provider) = IParsable<System::SByte>::Parse;

public static sbyte Parse (string s, IFormatProvider? provider);

static member Parse : string * IFormatProvider -> sbyte

Public Shared Function Parse (s As String, provider As IFormatProvider) As SByte

Parametreler

s

String

Dönüştürülecek sayıyı temsil eden bir dize. Dize, stil kullanılarak Integer yorumlanır.

provider

IFormatProvider

hakkında skültüre özgü biçimlendirme bilgileri sağlayan bir nesne. ise providernull, iş parçacığı geçerli kültürü kullanılır.

Döndürülenler

SByte

içinde sbelirtilen sayıya eşdeğer 8 bit imzalı tamsayı.

Uygulamalar

Parse(String, IFormatProvider)

Özel durumlar

ArgumentNullException

s, null değeridir.

FormatException

s doğru biçimde değil.

OverflowException

sSByte.MinValue değerinden küçük veya SByte.MaxValue değerinden büyük bir sayıyı temsil eder.

Örnekler

Aşağıdaki örnek, tilde (~) negatif işareti olarak tanımlayan özel NumberFormatInfo bir nesne tanımlar. Ardından bu özel NumberFormatInfo nesneyi ve sabit kültürü temsil eden bir nesneyi kullanarak bir CultureInfo dizi sayısal dizeyi ayrıştırıyor.

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      NumberFormatInfo nf = new NumberFormatInfo();
      nf.NegativeSign = "~"; 
      
      string[] values = { "-103", "+12", "~16", "  1", "~255" };
      IFormatProvider[] providers = { nf, CultureInfo.InvariantCulture };
      
      foreach (IFormatProvider provider in providers)
      {
         Console.WriteLine("Conversions using {0}:", ((object) provider).GetType().Name);
         foreach (string value in values)
         {
            try {
               Console.WriteLine("   Converted '{0}' to {1}.", 
                                 value, SByte.Parse(value, provider));
            }                     
            catch (FormatException) {
               Console.WriteLine("   Unable to parse '{0}'.", value);   
            }
            catch (OverflowException) {
               Console.WriteLine("   '{0}' is out of range of the SByte type.", value);         
            }
         }
      }      
   }
}
// The example displays the following output:
//       Conversions using NumberFormatInfo:
//          Unable to parse '-103'.
//          Converted '+12' to 12.
//          Converted '~16' to -16.
//          Converted '  1' to 1.
//          '~255' is out of range of the SByte type.
//       Conversions using CultureInfo:
//          Converted '-103' to -103.
//          Converted '+12' to 12.
//          Unable to parse '~16'.
//          Converted '  1' to 1.
//          Unable to parse '~255'.

open System
open System.Globalization

let nf = NumberFormatInfo()
nf.NegativeSign <- "~" 

let values = [| "-103"; "+12"; "~16"; "  1"; "~255" |]
let providers: IFormatProvider[] = [| nf; CultureInfo.InvariantCulture |]

for provider in providers do
    printfn $"Conversions using {(box provider).GetType().Name}:"
    for value in values do
        try
            printfn $"   Converted '{value}' to {SByte.Parse(value, provider)}."
        with
        | :? FormatException ->
            printfn $"   Unable to parse '{value}'."
        | :? OverflowException ->
            printfn $"   '{value}' is out of range of the SByte type."

// The example displays the following output:
//       Conversions using NumberFormatInfo:
//          Unable to parse '-103'.
//          Converted '+12' to 12.
//          Converted '~16' to -16.
//          Converted '  1' to 1.
//          '~255' is out of range of the SByte type.
//       Conversions using CultureInfo:
//          Converted '-103' to -103.
//          Converted '+12' to 12.
//          Unable to parse '~16'.
//          Converted '  1' to 1.
//          Unable to parse '~255'.

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim nf As New NumberFormatInfo()
      nf.NegativeSign = "~" 
      
      Dim values() As String = { "-103", "+12", "~16", "  1", "~255" }
      Dim providers() As IFormatProvider = { nf, CultureInfo.InvariantCulture }
      
      For Each provider As IFormatProvider In providers
         Console.WriteLine("Conversions using {0}:", CObj(provider).GetType().Name)
         For Each value As String In values
            Try
               Console.WriteLine("   Converted '{0}' to {1}.", _
                                 value, SByte.Parse(value, provider))
            Catch e As FormatException
               Console.WriteLine("   Unable to parse '{0}'.", value)   
            Catch e As OverflowException
               Console.WriteLine("   '{0}' is out of range of the SByte type.", value)         
            End Try
         Next
      Next      
   End Sub
End Module
' The example displays '
'       Conversions using NumberFormatInfo:
'          Unable to parse '-103'.
'          Converted '+12' to 12.
'          Converted '~16' to -16.
'          Converted '  1' to 1.
'          '~255' is out of range of the SByte type.
'       Conversions using CultureInfo:
'          Converted '-103' to -103.
'          Converted '+12' to 12.
'          Unable to parse '~16'.
'          Converted '  1' to 1.
'          Unable to parse '~255'.

Açıklamalar

s parametresi formun bir sayısını içerir:

[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.
Basamak	0 İle 9 arasında değişen bir basamak dizisi.

s parametresi stil kullanılarak Integer yorumlanır. Bayt değerinin ondalık basamaklarına 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 kullanın Parse(String, NumberStyles, IFormatProvider) .

provider parametresi, yöntemi biçimi hakkında kültüre özgü bilgiler sağlayan bir nesnesi döndüren bir IFormatProviderNumberFormatInfo uygulamadır GetFormats. Ayrıştırma işlemine provider özel biçimlendirme bilgileri sağlamak için parametresini kullanmanın üç yolu vardır:

• Biçimlendirme bilgileri sağlayan gerçek NumberFormatInfo nesneyi geçirebilirsiniz. (Uygulaması GetFormat basitçe kendisini döndürür.)

• Biçimlendirmesi kullanılacak kültürü belirten bir CultureInfo nesne geçirebilirsiniz. Özelliği NumberFormat biçimlendirme bilgileri sağlar.

• Özel IFormatProvider bir uygulama geçirebilirsiniz. GetFormat Yöntemi, biçimlendirme bilgilerini sağlayan nesneyi örneklemeli ve döndürmelidirNumberFormatInfo.

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

Ayrıca bkz.

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

Parse(String)

Kaynak:

SByte.cs

Önemli

Bu API, CLS uyumlu değildir.

CLS uyumlu alternatif

System.Int16.Parse(String)

Bir sayının dize gösterimini 8 bitlik işaretli tamsayı eşdeğerine dönüştürür.

public:
 static System::SByte Parse(System::String ^ s);

public static sbyte Parse (string s);

static member Parse : string -> sbyte

Public Shared Function Parse (s As String) As SByte

Parametreler

s

String

Dönüştürülecek sayıyı temsil eden bir dize. Dize, stil kullanılarak Integer yorumlanır.

Döndürülenler

SByte

Parametresinde s yer alan sayıya eşdeğer 8 bit imzalı tamsayı.

Özel durumlar

ArgumentException

s, null değeridir.

FormatException

s isteğe bağlı bir işaretten ve ardından basamak dizilerinden (sıfırdan dokuza kadar) oluşmaz.

OverflowException

sSByte.MinValue değerinden küçük veya SByte.MaxValue değerinden büyük bir sayıyı temsil eder.

Örnekler

Aşağıdaki örnekte, yöntemini kullanarak bir dize değerinin imzalı bayt değerine nasıl dönüştürüldüğü gösterilmektedir Parse . Sonuçta elde edilen imzalı bayt değeri konsolda görüntülenir.

// Define an array of numeric strings.
string[] values = { "-16", "  -3", "+ 12", " +12 ", "  12  ",
                    "+120", "(103)", "192", "-160" };
                           
// Parse each string and display the result.
foreach (string value in values)
{
   try {
      Console.WriteLine("Converted '{0}' to the SByte value {1}.",
                        value, SByte.Parse(value));
   }
   catch (FormatException) {
      Console.WriteLine("'{0}' cannot be parsed successfully by SByte type.",
                        value);
   }                              
   catch (OverflowException) {
      Console.WriteLine("'{0}' is out of range of the SByte type.",
                        value);
   }                                                                        
}
// The example displays the following output:
//       Converted '-16' to the SByte value -16.
//       Converted '  -3' to the SByte value -3.
//       '+ 12' cannot be parsed successfully by SByte type.
//       Converted ' +12 ' to the SByte value 12.
//       Converted '  12  ' to the SByte value 12.
//       Converted '+120' to the SByte value 120.
//       '(103)' cannot be parsed successfully by SByte type.
//       '192' is out of range of the SByte type.
//       '-160' is out of range of the SByte type.

open System

// Define an array of numeric strings.
let values = 
    [| "-16"; "  -3"; "+ 12"; " +12 "; "  12  "
       "+120"; "(103)"; "192"; "-160" |]
                            
// Parse each string and display the result.
for value in values do
    try
        printfn $"Converted '{value}' to the SByte value {SByte.Parse value}."
    with
    | :? FormatException ->
        printfn $"'{value}' cannot be parsed successfully by SByte type."
    | :? OverflowException ->
        printfn $"'{value}' is out of range of the SByte type."
        
// The example displays the following output:
//       Converted '-16' to the SByte value -16.
//       Converted '  -3' to the SByte value -3.
//       '+ 12' cannot be parsed successfully by SByte type.
//       Converted ' +12 ' to the SByte value 12.
//       Converted '  12  ' to the SByte value 12.
//       Converted '+120' to the SByte value 120.
//       '(103)' cannot be parsed successfully by SByte type.
//       '192' is out of range of the SByte type.
//       '-160' is out of range of the SByte type.

' Define an array of numeric strings.
Dim values() As String = { "-16", "  -3", "+ 12", " +12 ", "  12  ", _
                           "+120", "(103)", "192", "-160" }
                           
' Parse each string and display the result.
For Each value As String In values
   Try
      Console.WriteLine("Converted '{0}' to the SByte value {1}.", _
                        value, SByte.Parse(value))
   Catch e As FormatException
      Console.WriteLine("'{0}' cannot be parsed successfully by SByte type.", _
                        value)
   Catch e As OverflowException
      Console.WriteLine("'{0}' is out of range of the SByte type.", _
                        value)
   End Try                                                                        
Next        
' The example displays the following output:
'       Converted '-16' to the SByte value -16.
'       Converted '  -3' to the SByte value -3.
'       '+ 12' cannot be parsed successfully by SByte type.
'       Converted ' +12 ' to the SByte value 12.
'       Converted '  12  ' to the SByte value 12.
'       Converted '+120' to the SByte value 120.
'       '(103)' cannot be parsed successfully by SByte type.
'       '192' is out of range of the SByte type.
'       '-160' is out of range of the SByte type.

Açıklamalar

s parametresi formun bir sayısını içerir:

[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.
Basamak	0 İle 9 arasında değişen bir basamak dizisi.

s parametresi stil kullanılarak NumberStyles.Integer yorumlanır. Bayt değerinin ondalık basamaklarına ek olarak, yalnızca başta pozitif veya negatif işareti olan baştaki ve sondaki boşluklara izin verilir. içinde sbulunabilecek stil öğelerini açıkça tanımlamak için veya Parse(String, NumberStyles, IFormatProvider) yöntemini kullanınParse(String, NumberStyles).

s parametresi, geçerli sistem kültürü için başlatılan bir NumberFormatInfo içindeki biçimlendirme bilgileri kullanılarak ayrıştırılır. Daha fazla bilgi için bkz. NumberFormatInfo.CurrentInfo. Başka bir kültürün biçimlendirme bilgilerini kullanarak bir dizeyi Parse(String, NumberStyles, IFormatProvider) ayrıştırmak için yöntemini kullanın.

Ayrıca bkz.

• .NET'te Sayısal Dizeleri Ayrıştırma
• .NET'te Biçimlendirme Türleri

Parse(ReadOnlySpan<Char>, IFormatProvider)

Kaynak:

SByte.cs

Bir karakter aralığını bir değere ayrıştırıyor.

public:
 static System::SByte Parse(ReadOnlySpan<char> s, IFormatProvider ^ provider) = ISpanParsable<System::SByte>::Parse;

public static sbyte Parse (ReadOnlySpan<char> s, IFormatProvider? provider);

static member Parse : ReadOnlySpan<char> * IFormatProvider -> sbyte

Public Shared Function Parse (s As ReadOnlySpan(Of Char), provider As IFormatProvider) As SByte

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.

Döndürülenler

SByte

ayrıştırma sişleminin sonucu.

Uygulamalar

Parse(ReadOnlySpan<Char>, IFormatProvider)

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Kaynak:

SByte.cs

UTF-8 karakterlik bir aralığı bir değere ayrıştırıyor.

public:
 static System::SByte Parse(ReadOnlySpan<System::Byte> utf8Text, IFormatProvider ^ provider) = IUtf8SpanParsable<System::SByte>::Parse;

public static sbyte Parse (ReadOnlySpan<byte> utf8Text, IFormatProvider? provider);

static member Parse : ReadOnlySpan<byte> * IFormatProvider -> sbyte

Public Shared Function Parse (utf8Text As ReadOnlySpan(Of Byte), provider As IFormatProvider) As SByte

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.

Döndürülenler

SByte

ayrıştırma utf8Textişleminin sonucu.

Uygulamalar

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Parse(String, NumberStyles)

Kaynak:

SByte.cs

Önemli

Bu API, CLS uyumlu değildir.

CLS uyumlu alternatif

System.Int16.Parse(String)

Belirtilen stildeki bir sayının dize gösterimini 8 bit işaretli tamsayı eşdeğerine dönüştürür.

public:
 static System::SByte Parse(System::String ^ s, System::Globalization::NumberStyles style);

public static sbyte Parse (string s, System.Globalization.NumberStyles style);

static member Parse : string * System.Globalization.NumberStyles -> sbyte

Public Shared Function Parse (s As String, style As NumberStyles) As SByte

Parametreler

s

String

Dönüştürülecek sayı içeren bir dize. Dize, tarafından stylebelirtilen stil kullanılarak yorumlanır.

style

NumberStyles

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

Döndürülenler

SByte

içinde sbelirtilen sayıya eşdeğer 8 bit işaretli bir tamsayı.

Özel durumlar

ArgumentNullException

s, null değeridir.

FormatException

s ile styleuyumlu bir biçimde değil.

OverflowException

sSByte.MinValue değerinden küçük veya SByte.MaxValue değerinden büyük bir sayıyı temsil eder.

-veya-

s sıfır olmayan kesirli basamaklar içerir.

ArgumentException

style bir NumberStyles değer değildir.

-veya-

styleve HexNumber değerlerinin AllowHexSpecifier birleşimi değildir.

Örnekler

Aşağıdaki örnek, değerlerin SByte dize gösterimlerini yöntemiyle Parse(String, NumberStyles) ayrıştırmaktadır. Örneğin geçerli kültürü: en-US

using System;
using System.Globalization;

public class Example
{
   public static void Main()
   {
      NumberStyles style;
      sbyte number;

      // Parse value with no styles allowed.
      string[] values1 = { " 121 ", "121", "-121" };
      style = NumberStyles.None;
      Console.WriteLine("Styles: {0}", style.ToString());
      foreach (string value in values1)
      {
         try {
            number = SByte.Parse(value, style);
            Console.WriteLine("   Converted '{0}' to {1}.", value, number);
         }   
         catch (FormatException) {
            Console.WriteLine("   Unable to parse '{0}'.", value);
         }
      }
      Console.WriteLine();
            
      // Parse value with trailing sign.
      style = NumberStyles.Integer | NumberStyles.AllowTrailingSign;
      string[] values2 = { " 103+", " 103 +", "+103", "(103)", "   +103  " };
      Console.WriteLine("Styles: {0}", style.ToString());
      foreach (string value in values2)
      {
         try {
            number = SByte.Parse(value, style);
            Console.WriteLine("   Converted '{0}' to {1}.", value, number);
         }   
         catch (FormatException) {
            Console.WriteLine("   Unable to parse '{0}'.", value);
         }      
         catch (OverflowException) {
            Console.WriteLine("   '{0}' is out of range of the SByte type.", value);         
         }
      }      
      Console.WriteLine();
   }
}
// The example displays the following output:
//       Styles: None
//          Unable to parse ' 121 '.
//          Converted '121' to 121.
//          Unable to parse '-121'.
//       
//       Styles: Integer, AllowTrailingSign
//          Converted ' 103+' to 103.
//          Converted ' 103 +' to 103.
//          Converted '+103' to 103.
//          Unable to parse '(103)'.
//          Converted '   +103  ' to 103.

open System
open System.Globalization

// Parse value with no styles allowed.
let values1 = [| " 121 "; "121"; "-121" |]
let style = NumberStyles.None
printfn $"Styles: {style}"
for value in values1 do
    try
        let number = SByte.Parse(value, style)
        printfn $"   Converted '{value}' to {number}."
    with :? FormatException ->
        printfn $"   Unable to parse '{value}'."
printfn ""
            
// Parse value with trailing sign.
let style2 = NumberStyles.Integer ||| NumberStyles.AllowTrailingSign
let values2 = [| " 103+"; " 103 +"; "+103"; "(103)"; "   +103  " |]
printfn $"Styles: {style2}"
for value in values2 do
    try
        let number = SByte.Parse(value, style2)
        printfn $"   Converted '{value}' to {number}."
    with 
    | :? FormatException ->
        printfn $"   Unable to parse '{value}'."
    | :? OverflowException ->
        printfn $"   '{value}' is out of range of the SByte type."         
printfn ""
// The example displays the following output:
//       Styles: None
//          Unable to parse ' 121 '.
//          Converted '121' to 121.
//          Unable to parse '-121'.
//       
//       Styles: Integer, AllowTrailingSign
//          Converted ' 103+' to 103.
//          Converted ' 103 +' to 103.
//          Converted '+103' to 103.
//          Unable to parse '(103)'.
//          Converted '   +103  ' to 103.

Imports System.Globalization

Module Example
   Public Sub Main()
      Dim style As NumberStyles
      Dim number As SByte

      ' Parse value with no styles allowed.
      Dim values1() As String = { " 121 ", "121", "-121" }
      style = NumberStyles.None
      Console.WriteLine("Styles: {0}", style.ToString())
      For Each value As String In values1
         Try
            number = SByte.Parse(value, style)
            Console.WriteLine("   Converted '{0}' to {1}.", value, number)
         Catch e As FormatException
            Console.WriteLine("   Unable to parse '{0}'.", value)   
         End Try
      Next
      Console.WriteLine()
            
      ' Parse value with trailing sign.
      style = NumberStyles.Integer Or NumberStyles.AllowTrailingSign
      Dim values2() As String = { " 103+", " 103 +", "+103", "(103)", "   +103  " }
      Console.WriteLine("Styles: {0}", style.ToString())
      For Each value As String In values2
         Try
            number = SByte.Parse(value, style)
            Console.WriteLine("   Converted '{0}' to {1}.", value, number)
         Catch e As FormatException
            Console.WriteLine("   Unable to parse '{0}'.", value)   
         Catch e As OverflowException
            Console.WriteLine("   '{0}' is out of range of the SByte type.", value)         
         End Try
      Next      
      Console.WriteLine()
   End Sub
End Module
' The example displays the following output:
'       Styles: None
'          Unable to parse ' 121 '.
'          Converted '121' to 121.
'          Unable to parse '-121'.
'       
'       Styles: Integer, AllowTrailingSign
'          Converted ' 103+' to 103.
'          Converted ' 103 +' to 103.
'          Converted '+103' to 103.
'          Unable to parse '(103)'.
'          Converted '   +103  ' to 103.

Açıklamalar

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 simgesi 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[.fractional_digits][E[sign]exponential_digits][ws]

içeriyorsa styleNumberStyles.AllowHexSpecifiers, 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 boşluk, sstyle stilin NumberStyles.AllowLeadingWhite bayrağını içermesi sNumberStyles.AllowTrailingWhite durumunda ise sonunda görüntülenebilir.
$	Kültüre özgü para birimi simgesi. Dizedeki konumu geçerli kültürün NumberFormatInfo.CurrencyPositivePattern özelliği tarafından tanımlanır. Bayrağı içeriyorsa geçerli kültürün NumberStyles.AllowCurrencySymbol para birimi simgesi içinde sstyle görünebilir.
sign	İsteğe bağlı bir işaret. İşaret, bayrağını içeriyorsa öğesinin sstyleNumberStyles.AllowLeadingSign başında ve bayrağını içeriyorsa NumberStyles.AllowTrailingSign sonunda sstyle görüntülenebilir. Parantezler, bayrağı içeriyorsa NumberStyles.AllowParentheses negatif bir değeri style belirtmek için içinde kullanılabilirs.
Basamak	0 İle 9 arasında bir basamak dizisi.
.	Bir kültüre özgü ondalık nokta sembolü. bayrağını style içeriyorsa geçerli kültürün NumberStyles.AllowDecimalPoint ondalık noktası simgesi içinde s görüntülenebilir.
fractional_digits	Bayrağı içeriyorsa NumberStyles.AllowExponent 0-9 style basamaklarının bir veya daha fazla tekrarı veya yoksa 0 rakamının bir veya daha fazla yinelenme sayısı. Kesirli basamaklar yalnızca style bayrağını NumberStyles.AllowDecimalPoint içeriyorsa içinde s görüntülenebilir.
E	Değerin üslü (bilimsel) gösterimle temsil edildiğini gösteren "e" veya "E" karakteri. parametresi, s bayrağını içeriyorsa üstel gösteriminde style bir sayıyı NumberStyles.AllowExponent temsil edebilir.
exponential_digits	0-9 basamaklarının bir veya daha fazla oluşumu. parametresi, s bayrağını içeriyorsa üstel gösteriminde style bir sayıyı NumberStyles.AllowExponent temsil edebilir.
hexdigits	0 İle f veya 0 ile f arasında onaltılık basamak dizisi.

Not

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

Yalnızca ondalık basamağı olan bir dize (stile NumberStyles.None karşılık gelir) her zaman başarıyla ayrıştırılıyor. Kalan NumberStyles üyelerin çoğu 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 olmayan NumberStyles değerleri	Basamaklara ek olarak s içinde izin verilen öğeler
NumberStyles.None	Yalnızca ondalık basamaklar.
NumberStyles.AllowDecimalPoint	Ondalık ayırıcı (.) ve fractional_digits öğeleri. Ancak, bayrağı içermiyorsa styleNumberStyles.AllowExponent, fractional_digits yalnızca bir veya daha fazla 0 basamak içermelidir; aksi takdirde, bir OverflowException oluşturulur.
NumberStyles.AllowExponent	Exponential_digits ile birlikte üstel gösterimi gösteren "e" veya "E" karakteri.
NumberStyles.AllowLeadingWhite	başındaki sws öğesi.
NumberStyles.AllowTrailingWhite	sonundaki sws öğesi.
NumberStyles.AllowLeadingSign	Rakamlardan önce pozitif bir işaret.
NumberStyles.AllowTrailingSign	Basamakların ardından pozitif bir işaret.
NumberStyles.AllowParentheses	Sayısal değeri kapsayan parantez biçimindeki işaret öğesi.
NumberStyles.AllowThousands	Grup ayırıcı (,) öğesi. Grup ayırıcısı içinde sgörüntülenebilir, ancak önünde yalnızca bir veya daha fazla 0 basamak bulunmalıdır.
NumberStyles.AllowCurrencySymbol	Para birimi ($) öğesi.

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'dir. "0x" gibi bir ön ek desteklenmez ve ayrıştırma işleminin başarısız olmasına neden olur. içinde birleştirilebilen 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 sayı stili NumberStyles.HexNumberiçerir.)

Not

s Parametre onaltılık bir sayının dize gösterimiyse, önünde onaltılık sayı olarak ayırt eden herhangi bir süsleme (veya &hgibi0x) olamaz. Bu, ayrıştırma işleminin bir özel durum oluşturmasına neden olur.

Onaltılık bir sayıyı temsil ederse s , Parse(String, NumberStyles) yöntemi bayt'ın yüksek sıralı bitini bir işaret biti olarak yorumlar.

s parametresi, geçerli sistem kültürü için başlatılan bir NumberFormatInfo nesnedeki biçimlendirme bilgileri kullanılarak ayrıştırılır. Başka bir kültürün biçimlendirme bilgilerini kullanmak için aşırı yüklemeyi çağırın Parse(String, NumberStyles, IFormatProvider) .

Ayrıca bkz.

• ToString()
• TryParse
• .NET'te Sayısal Dizeleri Ayrıştırma
• .NET'te Biçimlendirme Türleri