Byte.Parse Yöntem

Tanım

Ad Alanı:: System

Bütünleştirilmiş Kodlar:: mscorlib.dll, System.Runtime.dll

Bütünleştirilmiş Kodlar:: netstandard.dll, System.Runtime.dll

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

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

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

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Bir sayının dize gösterimini eşdeğerine Byte dönüştürür.

Aşırı Yüklemeler

Name	Description
Parse(String, NumberStyles, IFormatProvider)	Belirtilen stilde ve kültüre özgü biçimdeki bir sayının dize gösterimini eşdeğerine Byte dönüştürür.
Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)	Belirli bir stilde ve kültüre özgü biçimdeki bir sayının span gösterimini eşdeğerine Byte 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)	Belirli bir kültüre özgü biçimdeki bir sayının dize gösterimini eşdeğerine Byte dönüştürür.
Parse(String, NumberStyles)	Belirtilen stildeki bir sayının dize gösterimini eşdeğerine Byte 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)	Bir sayının dize gösterimini eşdeğerine Byte dönüştürür.

Parse(String, NumberStyles, IFormatProvider)

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

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

public:
 static System::Byte Parse(System::String ^ s, System::Globalization::NumberStyles style, IFormatProvider ^ provider);

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

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

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

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

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

Parametreler

s: String

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

style: NumberStyles

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

provider: IFormatProvider

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

Döndürülenler

Byte

içinde bulunan ssayıya eşdeğer bir bayt değeri.

Uygulamalar

Parse(String, NumberStyles, IFormatProvider)

Özel durumlar

ArgumentNullException

s, null'e eşittir.

FormatException

s doğru biçimde değil.

OverflowException

s Byte.MinValue değerinden küçük veya Byte.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 kod örneği, yöntemin bu aşırı yüklemesiyle değerlerin Byte dize gösterimlerini ayrıştırmaktadır Byte.Parse(String, NumberStyles, IFormatProvider) .

NumberStyles style;
CultureInfo culture;
string value;
byte number;

// Parse number with decimals.
// NumberStyles.Float includes NumberStyles.AllowDecimalPoint.
style = NumberStyles.Float;
culture = CultureInfo.CreateSpecificCulture("fr-FR");
value = "12,000";

number = Byte.Parse(value, style, culture);
Console.WriteLine("Converted '{0}' to {1}.", value, number);

culture = CultureInfo.CreateSpecificCulture("en-GB");
try
{
   number = Byte.Parse(value, style, culture);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", value); }

value = "12.000";
number = Byte.Parse(value, style, culture);
Console.WriteLine("Converted '{0}' to {1}.", value, number);
// The example displays the following output to the console:
//       Converted '12,000' to 12.
//       Unable to parse '12,000'.
//       Converted '12.000' to 12.

// Parse number with decimals.
// NumberStyles.Float includes NumberStyles.AllowDecimalPoint.
let style = NumberStyles.Float
let culture = CultureInfo.CreateSpecificCulture "fr-FR"
let value = "12,000"

let number = Byte.Parse(value, style, culture)
printfn $"Converted '{value}' to {number}."

let culture = CultureInfo.CreateSpecificCulture "en-GB"
try
    let number = Byte.Parse(value, style, culture)
    printfn $"Converted '{value}' to {number}."
with :? FormatException ->
    printfn $"Unable to parse '{value}'."

let value = "12.000"
let number = Byte.Parse(value, style, culture)
printfn $"Converted '{value}' to {number}."

// The example displays the following output to the console:
//       Converted '12,000' to 12.
//       Unable to parse '12,000'.
//       Converted '12.000' to 12.

Dim style As NumberStyles
Dim culture As CultureInfo
Dim value As String
Dim number As Byte

' Parse number with decimals.
' NumberStyles.Float includes NumberStyles.AllowDecimalPoint.
style = NumberStyles.Float       
culture = CultureInfo.CreateSpecificCulture("fr-FR")
value = "12,000"

number = Byte.Parse(value, style, culture)
Console.WriteLine("Converted '{0}' to {1}.", value, number)

culture = CultureInfo.CreateSpecificCulture("en-GB")
Try
   number = Byte.Parse(value, style, culture)
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)   
End Try      

value = "12.000"
number = Byte.Parse(value, style, culture)
Console.WriteLine("Converted '{0}' to {1}.", value, number)
' The example displays the following output to the console:
'       Converted '12,000' to 12.
'       Unable to parse '12,000'.
'       Converted '12.000' to 12.

Açıklamalar

parametresi, style ayrıştırma işleminin başarılı olması için parametresinde s izin verilen stil öğelerini (boşluk veya pozitif işaret 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]digits][ws]

Veya parametresi şunu style içeriyorsa AllowHexSpecifier:

[ws]hexdigits[ws]

Köşeli ayraç ([ 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ı boşluk. Boşluk, bayrağı içeriyorsa başında `s` veya bayrağı içeriyorsa sonunda NumberStyles.AllowTrailingWhite`sstyle` görüntülenebilir.`style`NumberStyles.AllowLeadingWhite
$	Kültüre özgü para birimi simgesi. Dizedeki konumu, parametresinin yöntemi NumberFormatInfo.CurrencyPositivePattern tarafından döndürülen nesnenin özelliğiyle NumberFormatInfo GetFormat tanımlanır`provider`. Bayrağı içeriyorsa `s` para birimi simgesi içinde `style`NumberStyles.AllowCurrencySymbol görüntülenebilir.
imza	İsteğe bağlı pozitif bir işaret. (yöntemi içinde negatif bir işaret `s`varsa bir OverflowException oluşturur.) İşaret, bayrağın eklenip eklenmediğinin başında veya bayrağın dahil olup olmadığının `s`NumberStyles.AllowTrailingSign`style` sonunda görünebilir.`sstyle`NumberStyles.AllowLeadingSign
Basamak	0 ile 9 arasında bir basamak dizisi.
.	Kültüre özgü ondalık nokta simgesi. bayrağını içeriyorsa`provider`, tarafından `s` belirtilen kültürün ondalık nokta simgesi içinde `style`NumberStyles.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 gösterimde temsil olduğunu gösteren e veya E karakteri. s parametresi, bayrağı 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.

Uyarı

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 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	. ve fractional_digits öğeleri. Ancak , fractional_digits yalnızca bir veya daha fazla 0 basamak içermelidir veya bir OverflowException oluşturulur.
NumberStyles.AllowExponent	parametresi üstel `s` gösterim de kullanabilir.
NumberStyles.AllowLeadingWhite	başındaki `s`ws öğesi.
NumberStyles.AllowTrailingWhite	sonundaki `s` öğesi.
NumberStyles.AllowLeadingSign	Basamakların önüne pozitif bir işaret gelebilir.
NumberStyles.AllowTrailingSign	Basamakların ardından pozitif bir işaret görünebilir.
NumberStyles.AllowParentheses	Bu bayrak destekleniyor olsa da, parantezlerin `s` içinde kullanılması ile OverflowExceptionsonuçlanır.
NumberStyles.AllowThousands	Içinde grup ayırıcı simgesi görünse de `s`, önünde yalnızca bir veya daha fazla 0 basamak olabilir.
NumberStyles.AllowCurrencySymbol	$ öğesi.

NumberStyles.AllowHexSpecifier Bayrağı kullanılıyorsa, s ön ek olmadan onaltılık bir değer olmalıdır. Örneğin, "F3" başarıyla ayrıştırıyor, ancak "0xF3" ayrıştırmıyor. 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 sayı stiline NumberStyles.HexNumbersahiptir.)

provider parametresi, veya CultureInfo nesnesi gibi bir IFormatProvider NumberFormatInfo uygulamadır. parametresi, provider ayrıştırmada kullanılan kültüre özgü bilgiler sağlar. ise providernull, iş parçacığı geçerli kültürü kullanılır.

Ayrıca bkz.

Şunlara uygulanır

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Belirli bir stilde ve kültüre özgü biçimdeki bir sayının span gösterimini eşdeğerine Byte dönüştürür.

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

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

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

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

Parametreler

s: ReadOnlySpan<Char>

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

style: NumberStyles

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

provider: IFormatProvider

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

Döndürülenler

Byte

içinde bulunan ssayıya eşdeğer bir bayt değeri.

Uygulamalar

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Şunlara uygulanır

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

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

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

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

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

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

Byte

ayrıştırma utf8Textişleminin sonucu.

Uygulamalar

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

Şunlara uygulanır

Parse(String, IFormatProvider)

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Belirli bir kültüre özgü biçimdeki bir sayının dize gösterimini eşdeğerine Byte dönüştürür.

public:
 static System::Byte Parse(System::String ^ s, IFormatProvider ^ provider);

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

public static byte Parse(string s, IFormatProvider provider);

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

static member Parse : string * IFormatProvider -> byte

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

Parametreler

s: String

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

provider: IFormatProvider

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

Döndürülenler

Byte

içinde bulunan ssayıya eşdeğer bir bayt değeri.

Uygulamalar

Parse(String, IFormatProvider)

Özel durumlar

ArgumentNullException

s, null'e eşittir.

FormatException

s doğru biçimde değil.

OverflowException

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

Örnekler

Aşağıdaki örnek, değerlerin Byte dize gösterimlerini yöntemiyle Parse ayrıştırmaktadır.

string stringToConvert;
byte byteValue;

stringToConvert = " 214 ";
try {
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException) {
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue); }

stringToConvert = " + 214 ";
try {
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException) {
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue); }

stringToConvert = " +214 ";
try {
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert); }
catch (OverflowException) {
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue); }
// The example displays the following output to the console:
//       Converted ' 214 ' to 214.
//       Unable to parse ' + 214 '.
//       Converted ' +214 ' to 214.

let stringToConvert = " 214 "
try
    let byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
    printfn $"Converted '{stringToConvert}' to {byteValue}." 
with
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is greater than {Byte.MaxValue} or less than {Byte.MinValue}." 

let stringToConvert = " + 214 "
try
    let byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
    printfn $"Converted '{stringToConvert}' to {byteValue}." 
with
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is greater than {Byte.MaxValue} or less than {Byte.MinValue}." 

let stringToConvert = " +214 "
try
    let byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
    printfn $"Converted '{stringToConvert}' to {byteValue}." 
with
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is greater than {Byte.MaxValue} or less than {Byte.MinValue}." 

// The example displays the following output to the console:
//       Converted ' 214 ' to 214.
//       Unable to parse ' + 214 '.
//       Converted ' +214 ' to 214.

Dim stringToConvert As String 
Dim byteValue As Byte

stringToConvert = " 214 "
Try
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try  

stringToConvert = " + 214 "
Try
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try  

stringToConvert = " +214 "
Try
   byteValue = Byte.Parse(stringToConvert, CultureInfo.InvariantCulture)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try
' The example displays the following output to the console:
'       Converted ' 214 ' to 214.
'       Unable to parse ' + 214 '.
'       Converted ' +214 ' to 214.

Açıklamalar

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

[ws][sign]digits[ws]

Köşeli ayraç ([ 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ı boşluk.
imza	İsteğe bağlı pozitif bir işaret.
Basamak	0 ile 9 arasında 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, baştaki işaretle birlikte izin verilir. (İşaret varsa, pozitif bir işaret olmalıdır veya yöntem bir OverflowExceptionoluşturur.) stil öğelerini içinde bulunabilecek skültüre özgü biçimlendirme bilgileriyle birlikte açıkça tanımlamak için yöntemini kullanın Byte.Parse(String, NumberStyles, IFormatProvider) .

s parametresi, tarafından providersağlanan nesnedeki NumberFormatInfo biçimlendirme bilgileri kullanılarak ayrıştırılır. provider parametresi veya CultureInfo nesnesi gibi bir IFormatProvider NumberFormatInfo uygulamadır. parametresi, provider ayrıştırmada kullanılan kültüre özgü bilgiler sağlar. ise providernull, iş parçacığı geçerli kültürü kullanılır.

Ayrıca bkz.

Şunlara uygulanır

Parse(String, NumberStyles)

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Belirtilen stildeki bir sayının dize gösterimini eşdeğerine Byte dönüştürür.

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

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

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

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

Parametreler

s: String

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

style: NumberStyles

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

Döndürülenler

Byte

içinde bulunan ssayıya eşdeğer bir bayt değeri.

Özel durumlar

ArgumentNullException

s, null'e eşittir.

FormatException

s doğru biçimde değil.

OverflowException

s Byte.MinValue değerinden küçük veya Byte.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 Byte dize gösterimlerini yöntemiyle Byte.Parse(String, NumberStyles) ayrıştırmaktadır. Örneğin geçerli kültürü en-US.

string value;
NumberStyles style;
byte number;

// Parse value with no styles allowed.
style = NumberStyles.None;
value = " 241 ";
try
{
   number = Byte.Parse(value, style);
   Console.WriteLine("Converted '{0}' to {1}.", value, number);
}
catch (FormatException) {
   Console.WriteLine("Unable to parse '{0}'.", value); }

// Parse value with trailing sign.
style = NumberStyles.Integer | NumberStyles.AllowTrailingSign;
value = " 163+";
number = Byte.Parse(value, style);
Console.WriteLine("Converted '{0}' to {1}.", value, number);

// Parse value with leading sign.
value = "   +253  ";
number = Byte.Parse(value, style);
Console.WriteLine("Converted '{0}' to {1}.", value, number);
// This example displays the following output to the console:
//       Unable to parse ' 241 '.
//       Converted ' 163+' to 163.
//       Converted '   +253  ' to 253.

// Parse value with no styles allowed.
let style = NumberStyles.None
let value = " 241 "
try
    let number = Byte.Parse(value, style);
    printfn $"Converted '{value}' to {number}."
with :? FormatException ->
    printfn $"Unable to parse '{value}'."

// Parse value with trailing sign.
let style = NumberStyles.Integer ||| NumberStyles.AllowTrailingSign
let value = " 163+"
let number = Byte.Parse(value, style)
printfn $"Converted '{value}' to {number}."

// Parse value with leading sign.
let value = "   +253  "
let number = Byte.Parse(value, style)
printfn $"Converted '{value}' to {number}."

// This example displays the following output to the console:
//       Unable to parse ' 241 '.
//       Converted ' 163+' to 163.
//       Converted '   +253  ' to 253.

Dim value As String
Dim style As NumberStyles
Dim number As Byte

' Parse value with no styles allowed.
style = NumberStyles.None
value = " 241 "
Try
   number = Byte.Parse(value, style)
   Console.WriteLine("Converted '{0}' to {1}.", value, number)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", value)   
End Try
  
' Parse value with trailing sign.
style = NumberStyles.Integer Or NumberStyles.AllowTrailingSign
value = " 163+"
number = Byte.Parse(value, style)
Console.WriteLine("Converted '{0}' to {1}.", value, number)

' Parse value with leading sign.
value = "   +253  "
number = Byte.Parse(value, style)
Console.WriteLine("Converted '{0}' to {1}.", value, number)
' This example displays the following output to the console:
'       Unable to parse ' 241 '.
'       Converted ' 163+' to 163.
'       Converted '   +253  ' to 253.

Açıklamalar

[ws][$][sign]digits[.fractional_digits][e[sign]digits][ws]

Veya şunu style içeriyorsa AllowHexSpecifier:

[ws]hexdigits[ws]

Köşeli ayraç ([ 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ı boşluk. Boşluk, bayrağı içeriyorsa başında veya stili bayrağı içeriyorsa NumberStyles.AllowTrailingWhite s'nin sonunda görüntülenebilir `sstyle`.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 `s` para birimi simgesi içinde `style`NumberStyles.AllowCurrencySymbol görüntülenebilir.
imza	İsteğe bağlı pozitif bir işaret. (yöntemi içinde negatif bir işaret `s`varsa bir OverflowException oluşturur.) İşaret, bayrağın eklenip eklenmediğinin başında veya bayrağın dahil olup olmadığının `s`NumberStyles.AllowTrailingSign`style` sonunda görünebilir.`sstyle`NumberStyles.AllowLeadingSign
Basamak	0 ile 9 arasında bir basamak dizisi.
.	Kültüre özgü ondalık nokta simgesi. Bayrağı içeriyorsa geçerli kültürün `s` ondalık noktası simgesi içinde `style`NumberStyles.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 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.
hexdigits	0'dan f'ye veya 0'dan F'ye kadar onaltılık basamak dizisi.

Uyarı

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

Bileşik olmayan NumberStyles değerleri	Basamaklara ek olarak s içinde izin verilen öğeler
NumberStyles.None	Yalnızca ondalık basamaklar.
NumberStyles.AllowDecimalPoint	. ve fractional_digits öğeleri. Ancak , fractional_digits yalnızca bir veya daha fazla 0 basamak içermelidir veya bir OverflowException oluşturulur.
NumberStyles.AllowExponent	parametresi üstel `s` gösterim de kullanabilir.
NumberStyles.AllowLeadingWhite	başındaki `s`ws öğesi.
NumberStyles.AllowTrailingWhite	sonundaki `s` öğesi.
NumberStyles.AllowLeadingSign	Basamakların önüne pozitif bir işaret gelebilir.
NumberStyles.AllowTrailingSign	Basamakların ardından pozitif bir işaret görünebilir.
NumberStyles.AllowParentheses	Bu bayrak destekleniyor olsa da, parantezlerin `s` içinde kullanılması ile OverflowExceptionsonuçlanır.
NumberStyles.AllowThousands	Içinde grup ayırıcı simgesi görünse de `s`, önünde yalnızca bir veya daha fazla 0 basamak olabilir.
NumberStyles.AllowCurrencySymbol	$ öğesi.

NumberStyles.AllowHexSpecifier Bayrağı kullanılıyorsa, s ön ek olmadan onaltılık bir değer olmalıdır. Örneğin, "F3" başarıyla ayrıştırıyor, ancak "0xF3" ayrıştırmıyor. Bununla birleştirilebilen diğer bayraklar yalnızca ve NumberStyles.AllowTrailingWhite'tirNumberStyles.AllowLeadingWhite. (Numaralandırma, NumberStyles NumberStyles.HexNumberher iki boşluk bayrağını da içeren bileşik bir sayı stili içerir.)

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 Byte.Parse(String, NumberStyles, IFormatProvider) .

Ayrıca bkz.

Şunlara uygulanır

Parse(ReadOnlySpan<Char>, IFormatProvider)

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

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

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

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

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

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

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.

Döndürülenler

Byte

ayrıştırma sişleminin sonucu.

Uygulamalar

Parse(ReadOnlySpan<Char>, IFormatProvider)

Şunlara uygulanır

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

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

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

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

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

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

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

Byte

ayrıştırma utf8Textişleminin sonucu.

Uygulamalar

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Şunlara uygulanır

Parse(String)

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Kaynak:: Byte.cs

Bir sayının dize gösterimini eşdeğerine Byte dönüştürür.

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

public static byte Parse(string s);

static member Parse : string -> byte

Public Shared Function Parse (s As String) As Byte

Parametreler

s: String

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

Döndürülenler

Byte

içinde bulunan ssayıya eşdeğer bir bayt değeri.

Özel durumlar

ArgumentNullException

s, null'e eşittir.

FormatException

s doğru biçimde değil.

OverflowException

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

Örnekler

Aşağıdaki örnekte, yöntemini kullanarak bir dize değerini bayt değerine dönüştürme gösterilmektedir Byte.Parse(String) . Sonuçta elde edilen bayt değeri konsolda görüntülenir.

string stringToConvert = " 162";
byte byteValue;
try
{
   byteValue = Byte.Parse(stringToConvert);
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue);
}
catch (FormatException)
{
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert);
}
catch (OverflowException)
{
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.",
                     stringToConvert, Byte.MaxValue, Byte.MinValue);
}
// The example displays the following output to the console:
//       Converted ' 162' to 162.

let stringToConvert = " 162"
try
    let byteValue = Byte.Parse stringToConvert
    printfn $"Converted '{stringToConvert}' to {byteValue}."
with
| :? FormatException ->
    printfn $"Unable to parse '{stringToConvert}'."
| :? OverflowException ->
    printfn $"'{stringToConvert}' is greater than {Byte.MaxValue} or less than {Byte.MinValue}."

// The example displays the following output to the console:
//       Converted ' 162' to 162.

Dim stringToConvert As String = " 162"
Dim byteValue As Byte
Try
   byteValue = Byte.Parse(stringToConvert)
   Console.WriteLine("Converted '{0}' to {1}.", stringToConvert, byteValue)
Catch e As FormatException
   Console.WriteLine("Unable to parse '{0}'.", stringToConvert)
Catch e As OverflowException
   Console.WriteLine("'{0}' is greater than {1} or less than {2}.", _
                     stringToConvert, Byte.MaxValue, Byte.MinValue)
End Try  
' The example displays the following output to the console:
'       Converted ' 162' to 162.

Açıklamalar

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

[ws][sign]digits[ws]

Köşeli ayraç ([ 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ı boşluk.
imza	İsteğe bağlı pozitif veya negatif işareti.
Basamak	0 ile 9 arasında bir basamak dizisi.

s parametresi stil kullanılarak NumberStyles.Integer yorumlanır. Bayt değerinin ondalık basamaklarına ek olarak, yalnızca baştaki ve sondaki boşluklara, baştaki işaretle birlikte izin verilir. (İşaret varsa, pozitif bir işaret olmalıdır veya yöntem bir OverflowExceptionoluşturur.) içinde sbulunabilecek stil öğelerini açıkça tanımlamak için veya Byte.Parse(String, NumberStyles, IFormatProvider) yöntemini kullanınByte.Parse(String, NumberStyles).

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. Daha fazla bilgi için bkz. CurrentInfo. Başka bir kültürün biçimlendirme bilgilerini kullanarak bir dizeyi Byte.Parse(String, NumberStyles, IFormatProvider) ayrıştırmak için yöntemini kullanın.

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Aracılığıyla paylaş

Byte.Parse Yöntem

Tanım

Aşırı Yüklemeler

Parse(String, NumberStyles, IFormatProvider)

Parametreler

Döndürülenler

Uygulamalar

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Parse(ReadOnlySpan<Char>, NumberStyles, IFormatProvider)

Parametreler

Döndürülenler

Uygulamalar

Şunlara uygulanır

Parse(ReadOnlySpan<Byte>, NumberStyles, IFormatProvider)

Parametreler

Döndürülenler

Uygulamalar

Şunlara uygulanır

Parse(String, IFormatProvider)

Parametreler

Döndürülenler

Uygulamalar

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Parse(String, NumberStyles)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Parse(ReadOnlySpan<Char>, IFormatProvider)

Parametreler

Döndürülenler

Uygulamalar

Şunlara uygulanır

Parse(ReadOnlySpan<Byte>, IFormatProvider)

Parametreler

Döndürülenler

Uygulamalar

Şunlara uygulanır

Parse(String)

Parametreler

Döndürülenler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Geri Bildirim