Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C#

Int32.Parse — zamiana tekstu na int

Int32.Parse zamienia tekst liczby na int. Poznaj domyślne reguły formatu, wpływ kultury oraz wyjątki zgłaszane dla nieprawidłowych danych.

Wersja: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Składnia

Int32.Parse(string s)
Int32.Parse(string s, System.Globalization.NumberStyles style, IFormatProvider? provider)

Int32.Parse to metoda statyczna zwracająca int, czyli System.Int32. Zapis int.Parse oznacza tę samą metodę. Zakres wyniku wynosi od -2147483648 do 2147483647. Opisane przeciążenia są dostępne w .NET 10; nie wymagają funkcji języka preview.

Int32.Parse(string s) używa bieżącej kultury i NumberStyles.Integer: dopuszcza cyfry dziesiętne, początkowy znak oraz białe znaki na początku i końcu. Domyślnie nie dopuszcza separatorów grup ani separatora dziesiętnego. Parametr style określa dozwolony format, a provider — konwencje kulturowe; null oznacza bieżącą kulturę. Do przewidywalnego odczytu danych niezależnych od ustawień użytkownika podaj CultureInfo.InvariantCulture.

Dla przeciążeń tekstowych null powoduje ArgumentNullException, niepoprawny format — FormatException, a przekroczenie zakresu — OverflowException. Nieprawidłowe flagi style powodują ArgumentException. Przy spodziewanych błędach danych wejściowych wybierz Int32.TryParse, które sygnalizuje nieudaną konwersję przez false.

Przykład odczytuje " +42 ", a następnie przechwytuje przekroczenie zakresu dla "2147483648". Jawna kultura zapewnia przewidywalny odczyt i zapis wyniku.

Przykłady

using System;
using System.Globalization;

int value = Int32.Parse(" +42 ", NumberStyles.Integer, CultureInfo.InvariantCulture);
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));

try
{
    Int32.Parse("2147483648", NumberStyles.Integer, CultureInfo.InvariantCulture);
}
catch (OverflowException)
{
    Console.WriteLine("OverflowException");
}

Wynik

42
OverflowException

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła