Enum.TryParse Metodo

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Converte la rappresentazione di stringa del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente. Il valore restituito indica se la conversione è riuscita.

Overload

TryParse(Type, ReadOnlySpan<Char>, Object)	Converte l'intervallo di caratteri di rappresentazione del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente.
TryParse(Type, String, Object)	Converte la rappresentazione di stringa del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente.
TryParse(Type, ReadOnlySpan<Char>, Boolean, Object)	Converte l'intervallo di caratteri di rappresentazione del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente. Un parametro specifica se l'operazione non fa distinzione tra maiuscole e minuscole.
TryParse(Type, String, Boolean, Object)	Converte la rappresentazione di stringa del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente.
TryParse<TEnum>(ReadOnlySpan<Char>, TEnum)	Converte la rappresentazione di stringa del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente.
TryParse<TEnum>(String, TEnum)	Converte la rappresentazione di stringa del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente. Il valore restituito indica se la conversione è riuscita.
TryParse<TEnum>(String, Boolean, TEnum)	Converte la rappresentazione di stringa del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente. Un parametro specifica se l'operazione fa distinzione tra maiuscole e minuscole. Il valore restituito indica se la conversione è riuscita.
TryParse<TEnum>(ReadOnlySpan<Char>, Boolean, TEnum)	Converte la rappresentazione di stringa del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente. Un parametro specifica se l'operazione fa distinzione tra maiuscole e minuscole. Il valore restituito indica se la conversione è riuscita.

TryParse(Type, ReadOnlySpan<Char>, Object)

Origine:

Enum.cs

Converte l'intervallo di caratteri di rappresentazione del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente.

public:
 static bool TryParse(Type ^ enumType, ReadOnlySpan<char> value, [Runtime::InteropServices::Out] System::Object ^ % result);

public static bool TryParse (Type enumType, ReadOnlySpan<char> value, out object? result);

static member TryParse : Type * ReadOnlySpan<char> * obj -> bool

Public Shared Function TryParse (enumType As Type, value As ReadOnlySpan(Of Char), ByRef result As Object) As Boolean

Parametri

enumType

Type

Tipo di enumerazione da utilizzare per l'analisi.

value

ReadOnlySpan<Char>

Rappresentazione dell'intervallo del nome o del valore numerico di una o più costanti enumerate.

result

Object

Quando questo metodo restituisce true, contiene una costante di enumerazione che rappresenta il valore analizzato.

Restituisce

Boolean

true se la conversione ha avuto esito positivo; false in caso contrario.

Eccezioni

InvalidOperationException

.NET 8 e versioni successive: enumType è un tipo di enumerazione booleano.

TryParse(Type, String, Object)

Origine:

Enum.cs

Converte la rappresentazione di stringa del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente.

public:
 static bool TryParse(Type ^ enumType, System::String ^ value, [Runtime::InteropServices::Out] System::Object ^ % result);

public static bool TryParse (Type enumType, string? value, out object? result);

static member TryParse : Type * string * obj -> bool

Public Shared Function TryParse (enumType As Type, value As String, ByRef result As Object) As Boolean

Parametri

enumType

Type

Tipo di enumerazione da utilizzare per l'analisi.

value

String

Rappresentazione di stringa del nome o del valore numerico di una o più costanti enumerate.

result

Object

Quando questo metodo restituisce true, contiene una costante di enumerazione che rappresenta il valore analizzato.

Restituisce

Boolean

true se la conversione ha avuto esito positivo; false in caso contrario.

Eccezioni

InvalidOperationException

.NET 8 e versioni successive: enumType è un tipo di enumerazione booleano.

TryParse(Type, ReadOnlySpan<Char>, Boolean, Object)

Origine:

Enum.cs

Converte l'intervallo di caratteri di rappresentazione del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente. Un parametro specifica se l'operazione non fa distinzione tra maiuscole e minuscole.

public:
 static bool TryParse(Type ^ enumType, ReadOnlySpan<char> value, bool ignoreCase, [Runtime::InteropServices::Out] System::Object ^ % result);

public static bool TryParse (Type enumType, ReadOnlySpan<char> value, bool ignoreCase, out object? result);

static member TryParse : Type * ReadOnlySpan<char> * bool * obj -> bool

Public Shared Function TryParse (enumType As Type, value As ReadOnlySpan(Of Char), ignoreCase As Boolean, ByRef result As Object) As Boolean

Parametri

enumType

Type

Tipo di enumerazione da utilizzare per l'analisi.

value

ReadOnlySpan<Char>

Rappresentazione dell'intervallo del nome o del valore numerico di una o più costanti enumerate.

ignoreCase

Boolean

true leggere enumType in modalità senza distinzione tra maiuscole e minuscole; false leggere enumType in modalità con distinzione tra maiuscole e minuscole.

result

Object

Quando questo metodo restituisce true, contiene una costante di enumerazione che rappresenta il valore analizzato.

Restituisce

Boolean

true se la conversione ha avuto esito positivo; false in caso contrario.

Eccezioni

InvalidOperationException

.NET 8 e versioni successive: enumType è un tipo di enumerazione booleano.

TryParse(Type, String, Boolean, Object)

Origine:

Enum.cs

Converte la rappresentazione di stringa del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente.

public:
 static bool TryParse(Type ^ enumType, System::String ^ value, bool ignoreCase, [Runtime::InteropServices::Out] System::Object ^ % result);

public static bool TryParse (Type enumType, string? value, bool ignoreCase, out object? result);

static member TryParse : Type * string * bool * obj -> bool

Public Shared Function TryParse (enumType As Type, value As String, ignoreCase As Boolean, ByRef result As Object) As Boolean

Parametri

enumType

Type

Tipo di enumerazione da utilizzare per l'analisi.

value

String

Rappresentazione di stringa del nome o del valore numerico di una o più costanti enumerate.

ignoreCase

Boolean

true leggere value in modalità senza distinzione tra maiuscole e minuscole; false leggere value in modalità con distinzione tra maiuscole e minuscole.

result

Object

Quando questo metodo restituisce true, contiene una costante di enumerazione che rappresenta il valore analizzato.

Restituisce

Boolean

true se la conversione ha avuto esito positivo; false in caso contrario.

Eccezioni

InvalidOperationException

.NET 8 e versioni successive: enumType è un tipo di enumerazione booleano.

TryParse<TEnum>(ReadOnlySpan<Char>, TEnum)

Origine:

Enum.cs

Converte la rappresentazione di stringa del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente.

public:
generic <typename TEnum>
 where TEnum : value class static bool TryParse(ReadOnlySpan<char> value, [Runtime::InteropServices::Out] TEnum % result);

public static bool TryParse<TEnum> (ReadOnlySpan<char> value, out TEnum result) where TEnum : struct;

static member TryParse : ReadOnlySpan<char> * 'Enum -> bool (requires 'Enum : struct)

Public Shared Function TryParse(Of TEnum As Structure) (value As ReadOnlySpan(Of Char), ByRef result As TEnum) As Boolean

Parametri di tipo

TEnum

Tipo dell'oggetto result.

Parametri

value

ReadOnlySpan<Char>

Rappresentazione dell'intervallo del nome o del valore numerico di una o più costanti enumerate.

result

TEnum

Quando questo metodo restituisce true, contiene una costante di enumerazione che rappresenta il valore analizzato.

Restituisce

Boolean

true se la conversione ha avuto esito positivo; false in caso contrario.

Eccezioni

ArgumentException

TEnum non è un tipo di enumerazione.

InvalidOperationException

.NET 8 e versioni successive: TEnum è un tipo di enumerazione booleano.

TryParse<TEnum>(String, TEnum)

Origine:

Enum.cs

Converte la rappresentazione di stringa del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente. Il valore restituito indica se la conversione è riuscita.

public:
generic <typename TEnum>
 where TEnum : value class static bool TryParse(System::String ^ value, [Runtime::InteropServices::Out] TEnum % result);

public static bool TryParse<TEnum> (string? value, out TEnum result) where TEnum : struct;

static member TryParse : string * 'Enum -> bool (requires 'Enum : struct)

Public Shared Function TryParse(Of TEnum As Structure) (value As String, ByRef result As TEnum) As Boolean

Parametri di tipo

TEnum

Tipo di enumerazione in cui convertire value.

Parametri

value

String

Rappresentazione di stringa con distinzione tra maiuscole e minuscole del nome dell'enumerazione o del valore sottostante da convertire.

result

TEnum

Quando termina, questo metodo contiene un oggetto di tipo TEnum il cui valore è rappresentato da value se l'operazione di analisi ha esito positivo. Se l'operazione di analisi ha esito negativo, contiene il valore predefinito del tipo sottostante di TEnum. Questo parametro viene passato non inizializzato.

Restituisce

Boolean

true se il parametro value è stato convertito correttamente; in caso contrario, false.

Eccezioni

ArgumentException

TEnum non è un tipo di enumerazione.

InvalidOperationException

.NET 8 e versioni successive: TEnum è un tipo di enumerazione booleano.

Esempio

Nell'esempio seguente viene definita un'enumerazione Colors, viene chiamato il metodo TryParse<TEnum>(String, TEnum) per convertire le stringhe nei valori di enumerazione corrispondenti e viene chiamato il metodo IsDefined per assicurarsi che determinati valori integrali siano valori sottostanti nell'enumerazione Colors.

using System;

[Flags] enum Colors { None=0, Red = 1, Green = 2, Blue = 4 };

public class Example
{
   public static void Main()
   {
      string[] colorStrings = { "0", "2", "8", "blue", "Blue", "Yellow", "Red, Green" };
      foreach (string colorString in colorStrings)
      {
         Colors colorValue;
         if (Enum.TryParse(colorString, out colorValue))
            if (Enum.IsDefined(typeof(Colors), colorValue) | colorValue.ToString().Contains(","))
               Console.WriteLine("Converted '{0}' to {1}.", colorString, colorValue.ToString());
            else
               Console.WriteLine("{0} is not an underlying value of the Colors enumeration.", colorString);
         else
            Console.WriteLine("{0} is not a member of the Colors enumeration.", colorString);
      }
   }
}
// The example displays the following output:
//       Converted '0' to None.
//       Converted '2' to Green.
//       8 is not an underlying value of the Colors enumeration.
//       blue is not a member of the Colors enumeration.
//       Converted 'Blue' to Blue.
//       Yellow is not a member of the Colors enumeration.
//       Converted 'Red, Green' to Red, Green.

open System

[<Flags>]
type Colors =
    | None = 0
    | Red = 1
    | Green = 2
    | Blue = 4

let colorStrings = 
    [ "0"; "2"; "8"; "blue"; "Blue"; "Yellow"; "Red, Green" ]
for colorString in colorStrings do
    match Enum.TryParse colorString with
    | true, colorValue ->
        if Enum.IsDefined(typeof<Colors>, colorValue) || (string colorValue).Contains "," then
            printfn $"Converted '{colorString}' to {colorValue}."
        else
            printfn $"{colorString} is not an underlying value of the Colors enumeration."
    | _ ->
        printfn $"{colorString} is not a member of the Colors enumeration."
// The example displays the following output:
//       Converted '0' to None.
//       Converted '2' to Green.
//       8 is not an underlying value of the Colors enumeration.
//       blue is not a member of the Colors enumeration.
//       Converted 'Blue' to Blue.
//       Yellow is not a member of the Colors enumeration.
//       Converted 'Red, Green' to Red, Green.

<Flags> Enum Colors As Integer
   None = 0
   Red = 1
   Green = 2
   Blue = 4
End Enum

Module Example
   Public Sub Main()
      Dim colorStrings() As String = {"0", "2", "8", "blue", "Blue", "Yellow", "Red, Green"}
      For Each colorString As String In colorStrings
         Dim colorValue As Colors
         If [Enum].TryParse(colorString, colorValue) Then        
            If [Enum].IsDefined(GetType(Colors), colorValue) Or colorValue.ToString().Contains(",") Then 
               Console.WriteLine("Converted '{0}' to {1}.", colorString, colorValue.ToString())
            Else
               Console.WriteLine("{0} is not an underlying value of the Colors enumeration.", colorString)            
            End If                    
         Else
            Console.WriteLine("{0} is not a member of the Colors enumeration.", colorString)
         End If
      Next
   End Sub
End Module
' The example displays the following output:
'    Converted '0' to None.
'    Converted '2' to Green.
'    8 is not an underlying value of the Colors enumeration.
'    blue is not a member of the Colors enumeration.
'    Converted 'Blue' to Blue.
'    Yellow is not a member of the Colors enumeration.
'    Converted 'Red, Green' to Red, Green.

Commenti

TryParse<TEnum>(String, TEnum) è identico al metodo Parse(Type, String), ad eccezione del fatto che invece di generare un'eccezione, restituisce false se la conversione non riesce. Elimina la necessità di gestire le eccezioni durante l'analisi della rappresentazione di stringa di un valore di enumerazione.

Il parametro value contiene la rappresentazione di stringa del valore sottostante o della costante denominata di un membro di enumerazione oppure un elenco di costanti denominate o valori sottostanti delimitati da virgole (,). Se value include più costanti o valori denominati, uno o più spazi vuoti possono precedere o seguire ogni valore, nome o virgola in value. Se value è un elenco, result riflette il valore dei nomi specificati o dei valori sottostanti combinati con un'operazione di OR bit per bit. Se value è la rappresentazione di stringa del nome di un valore di enumerazione, il confronto di value con nomi di enumerazione fa distinzione tra maiuscole e minuscole.

Se value è un nome che non corrisponde a una costante denominata di TEnum, il metodo restituisce false. Se value è la rappresentazione di stringa di un numero intero che non rappresenta un valore sottostante dell'enumerazione TEnum, il metodo restituisce un membro di enumerazione il cui valore sottostante è value convertito in un tipo integrale. Se questo comportamento è indesiderato, chiamare il metodo IsDefined per assicurarsi che una determinata rappresentazione di stringa di un numero intero sia effettivamente un membro di TEnum.

Se l'operazione di analisi non riesce, il parametro result contiene il valore predefinito 0, che potrebbe non essere membro dell'enumerazione TEnum sottostante. Se non vengono assegnati valori alle costanti denominate in TEnum, il valore predefinito è uguale al primo membro del TEnum. In caso contrario, il valore predefinito è uguale al membro nell'enumerazione con un valore assegnato pari a 0.

Vedi anche

• Parse(Type, String)

TryParse<TEnum>(String, Boolean, TEnum)

Origine:

Enum.cs

Converte la rappresentazione di stringa del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente. Un parametro specifica se l'operazione fa distinzione tra maiuscole e minuscole. Il valore restituito indica se la conversione è riuscita.

public:
generic <typename TEnum>
 where TEnum : value class static bool TryParse(System::String ^ value, bool ignoreCase, [Runtime::InteropServices::Out] TEnum % result);

public static bool TryParse<TEnum> (string? value, bool ignoreCase, out TEnum result) where TEnum : struct;

static member TryParse : string * bool * 'Enum -> bool (requires 'Enum : struct)

Public Shared Function TryParse(Of TEnum As Structure) (value As String, ignoreCase As Boolean, ByRef result As TEnum) As Boolean

Parametri di tipo

TEnum

Tipo di enumerazione in cui convertire value.

Parametri

value

String

Rappresentazione di stringa del nome dell'enumerazione o del valore sottostante da convertire.

ignoreCase

Boolean

true ignorare la distinzione tra maiuscole e minuscole; false prendere in considerazione il caso.

result

TEnum

Quando termina, questo metodo contiene un oggetto di tipo TEnum il cui valore è rappresentato da value se l'operazione di analisi ha esito positivo. Se l'operazione di analisi ha esito negativo, contiene il valore predefinito del tipo sottostante di TEnum. Questo parametro viene passato non inizializzato.

Restituisce

Boolean

true se il parametro value è stato convertito correttamente; in caso contrario, false.

Eccezioni

ArgumentException

TEnum non è un tipo di enumerazione.

InvalidOperationException

.NET 8 e versioni successive: TEnum è un tipo di enumerazione booleano.

Esempio

Nell'esempio seguente viene definita un'enumerazione Colors, viene chiamato il metodo TryParse<TEnum>(String, Boolean, TEnum) per convertire le stringhe nei valori di enumerazione corrispondenti e viene chiamato il metodo IsDefined per assicurarsi che determinati valori integrali siano valori sottostanti nell'enumerazione Colors. Il metodo TryParse<TEnum>(String, Boolean, TEnum) usa un confronto senza distinzione tra maiuscole e minuscole quando si tenta di convertire le rappresentazioni di stringa delle costanti denominate nei valori di enumerazione equivalenti.

using System;

[Flags] enum Colors { None=0, Red = 1, Green = 2, Blue = 4 };

public class Example
{
   public static void Main()
   {
      string[] colorStrings = { "0", "2", "8", "blue", "Blue", "Yellow", "Red, Green" };
      foreach (string colorString in colorStrings)
      {
         Colors colorValue;
         if (Enum.TryParse(colorString, true, out colorValue))
            if (Enum.IsDefined(typeof(Colors), colorValue) | colorValue.ToString().Contains(","))
               Console.WriteLine("Converted '{0}' to {1}.", colorString, colorValue.ToString());
            else
               Console.WriteLine("{0} is not an underlying value of the Colors enumeration.", colorString);
         else
            Console.WriteLine("{0} is not a member of the Colors enumeration.", colorString);
      }
   }
}
// The example displays the following output:
//       Converted '0' to None.
//       Converted '2' to Green.
//       8 is not an underlying value of the Colors enumeration.
//       Converted 'blue' to Blue.
//       Converted 'Blue' to Blue.
//       Yellow is not a member of the Colors enumeration.
//       Converted 'Red, Green' to Red, Green.

open System

[<Flags>]
type Colors =
    | None = 0
    | Red = 1
    | Green = 2
    | Blue = 4

let colorStrings = 
    [ "0"; "2"; "8"; "blue"; "Blue"; "Yellow"; "Red, Green" ]
for colorString in colorStrings do
    match Enum.TryParse(colorString, true) with
    | true, colorValue ->
        if Enum.IsDefined(typeof<Colors>, colorValue) || (string colorValue).Contains "," then
            printfn $"Converted '{colorString}' to {colorValue}."
        else
            printfn $"{colorString} is not an underlying value of the Colors enumeration."
    | _ ->
        printfn $"{colorString} is not a member of the Colors enumeration."
// The example displays the following output:
//       Converted '0' to None.
//       Converted '2' to Green.
//       8 is not an underlying value of the Colors enumeration.
//       Converted 'blue' to Blue.
//       Converted 'Blue' to Blue.
//       Yellow is not a member of the Colors enumeration.
//       Converted 'Red, Green' to Red, Green.

<Flags> Enum Colors As Integer
   None = 0
   Red = 1
   Green = 2
   Blue = 4
End Enum

Module Example
   Public Sub Main()
      Dim colorStrings() As String = {"0", "2", "8", "blue", "Blue", "Yellow", "Red, Green"}
      For Each colorString As String In colorStrings
         Dim colorValue As Colors
         If [Enum].TryParse(colorString, True, colorValue) Then        
            If [Enum].IsDefined(GetType(Colors), colorValue) Or colorValue.ToString().Contains(",") Then 
               Console.WriteLine("Converted '{0}' to {1}.", colorString, colorValue.ToString())
            Else
               Console.WriteLine("{0} is not an underlying value of the Colors enumeration.", colorString)            
            End If                    
         Else
            Console.WriteLine("{0} is not a member of the Colors enumeration.", colorString)
         End If
      Next
   End Sub
End Module
' The example displays the following output:
'       Converted '0' to None.
'       Converted '2' to Green.
'       8 is not an underlying value of the Colors enumeration.
'       Converted 'blue' to Blue.
'       Converted 'Blue' to Blue.
'       Yellow is not a member of the Colors enumeration.
'       Converted 'Red, Green' to Red, Green.

Commenti

TryParse<TEnum>(String, Boolean, TEnum) è identico al metodo Parse(Type, String, Boolean), ad eccezione del fatto che invece di generare un'eccezione, restituisce false se la conversione non riesce. Elimina la necessità di gestire le eccezioni durante l'analisi della rappresentazione di stringa di un valore di enumerazione.

Il parametro value contiene la rappresentazione di stringa del valore sottostante o della costante denominata di un membro di enumerazione oppure un elenco di costanti denominate o valori sottostanti delimitati da virgole (,). Se value include più costanti o valori denominati, uno o più spazi vuoti possono precedere o seguire ogni valore, nome o virgola in value. Se value è un elenco, result riflette il valore dei nomi specificati o dei valori sottostanti combinati con un'operazione di OR bit per bit. Se value è la rappresentazione di stringa del nome di un valore di enumerazione, il confronto di value con nomi di enumerazione dipende dal parametro ignoreCase. Se true, il confronto non fa distinzione tra maiuscole e minuscole; se false, fa distinzione tra maiuscole e minuscole.

Se value è un nome che non corrisponde a una costante denominata di TEnum, il metodo restituisce false. Se value è la rappresentazione di stringa di un numero intero che non rappresenta un valore sottostante dell'enumerazione TEnum, il metodo restituisce un membro di enumerazione il cui valore sottostante è value convertito in un tipo integrale. Se questo comportamento è indesiderato, chiamare il metodo IsDefined per assicurarsi che una determinata rappresentazione di stringa di un numero intero sia effettivamente un membro di TEnum.

Se l'operazione di analisi non riesce, il parametro result contiene il valore predefinito 0, che potrebbe non essere membro dell'enumerazione TEnum sottostante. Se non vengono assegnati valori alle costanti denominate in TEnum, il valore predefinito è uguale al primo membro del TEnum. In caso contrario, il valore predefinito è uguale al membro nell'enumerazione con un valore assegnato pari a 0.

Vedi anche

• Parse(Type, String, Boolean)

TryParse<TEnum>(ReadOnlySpan<Char>, Boolean, TEnum)

Origine:

Enum.cs

Converte la rappresentazione di stringa del nome o del valore numerico di una o più costanti enumerate in un oggetto enumerato equivalente. Un parametro specifica se l'operazione fa distinzione tra maiuscole e minuscole. Il valore restituito indica se la conversione è riuscita.

public:
generic <typename TEnum>
 where TEnum : value class static bool TryParse(ReadOnlySpan<char> value, bool ignoreCase, [Runtime::InteropServices::Out] TEnum % result);

public static bool TryParse<TEnum> (ReadOnlySpan<char> value, bool ignoreCase, out TEnum result) where TEnum : struct;

static member TryParse : ReadOnlySpan<char> * bool * 'Enum -> bool (requires 'Enum : struct)

Public Shared Function TryParse(Of TEnum As Structure) (value As ReadOnlySpan(Of Char), ignoreCase As Boolean, ByRef result As TEnum) As Boolean

Parametri di tipo

TEnum

Tipo dell'oggetto result.

Parametri

value

ReadOnlySpan<Char>

Rappresentazione dell'intervallo del nome o del valore numerico di una o più costanti enumerate.

ignoreCase

Boolean

true ignorare la distinzione tra maiuscole e minuscole; false prendere in considerazione il caso.

result

TEnum

Quando questo metodo restituisce true, contiene una costante di enumerazione che rappresenta il valore analizzato.

Restituisce

Boolean

true se la conversione ha avuto esito positivo; false in caso contrario.

Eccezioni

ArgumentException

TEnum non è un tipo di enumerazione.

InvalidOperationException

.NET 8 e versioni successive: TEnum è un tipo di enumerazione booleano.