HOWTO · Csharp
Converti Int in Enum in C#
Scopri come convertire un intero in un enum C# con un cast o con il parsing, e come verificare se il risultato è un membro dichiarato.
In questa pagina
Per convertire un intero in un’enumerazione in C#, esegui il cast al tipo dell’enumerazione: MyEnum value = (MyEnum)number;. Un’enumerazione è un tipo valore con costanti denominate e un tipo integrale sottostante. Il cast converte il valore sottostante, ma non verifica che corrisponda a una costante dichiarata. Usa Enum.IsDefined quando sono accettabili solo i membri dichiarati; usa Enum.Parse o Enum.TryParse quando l’input è testo.
Convertire un intero in un’enumerazione con un cast diretto
Il cast diretto è la scelta più semplice quando l’intero è già disponibile e ne controlli il valore. Questo esempio completo definisce un’enumerazione con il tipo sottostante predefinito int, esegue il cast del valore 2 e stampa il nome del membro corrispondente.
using System;
public class Program
{
public enum MyEnum { Zero = 0, One = 1, Two = 2 }
public static void Main()
{
int number = 2;
MyEnum value = (MyEnum)number;
Console.WriteLine($"Converted Enum Value: {value}");
}
}
Il cast non convalida il risultato. Per esempio, eseguire il cast di 7 produce un valore di enumerazione con valore sottostante 7, anche se MyEnum non dichiara alcun membro con quel valore. Se l’applicazione deve accettare solo membri dichiarati, verifica il valore con Enum.IsDefined prima di eseguire il cast.
Analizzare una stringa contenente un intero con Enum.Parse
Enum.Parse accetta una stringa. Quando un intero viene fornito come testo, passa la stringa al metodo ed esegui il cast dell’object restituito al tipo di enumerazione desiderato. L’esempio analizza la stringa numerica "1".
using System;
public class Program
{
public enum MyEnum { Zero = 0, One = 1, Two = 2 }
public static void Main()
{
string input = "1";
MyEnum value = (MyEnum)Enum.Parse(typeof(MyEnum), input);
Console.WriteLine($"Parsed Enum Value: {value}");
}
}
L’analisi di una stringa numerica può produrre un valore di enumerazione il cui numero sottostante non corrisponde ad alcun membro dichiarato. Inoltre, Enum.Parse segnala gli input non validi generando un’eccezione; usa quindi Enum.TryParse quando vuoi gestire i normali errori di conversione senza ricorrere alle eccezioni per il controllo del flusso. Il solo esito positivo dell’analisi non verifica l’appartenenza a un membro dichiarato.
Verificare che un valore sia definito con Enum.IsDefined
Usa Enum.IsDefined per determinare se un valore corrisponde a una costante di enumerazione dichiarata. Questo esempio verifica sia un valore intero dichiarato sia uno non dichiarato prima di eseguire il cast. Poiché MyEnum usa il tipo sottostante predefinito int, gli argomenti int sottoposti a boxing corrispondono al tipo sottostante dell’enumerazione.
using System;
public class Program
{
public enum MyEnum { Zero = 0, One = 1, Two = 2 }
public static void Main()
{
int[] candidates = { 2, 7 };
foreach (int number in candidates)
{
if (Enum.IsDefined(typeof(MyEnum), number))
{
MyEnum value = (MyEnum)number;
Console.WriteLine($"{number}: defined as {value}");
}
else
{
Console.WriteLine($"{number}: not defined");
}
}
}
}
Enum.IsDefined verifica la corrispondenza esatta con il valore di una costante dichiarata. È adatto a una semplice enumerazione con valori dichiarati singolarmente; per un’enumerazione [Flags], una combinazione valida di flag potrebbe non essere stata dichiarata come costante. Di conseguenza, questo controllo può rifiutare combinazioni che l’applicazione dovrebbe invece consentire.
Analizzare una stringa contenente un intero con Enum.TryParse
Enum.TryParse restituisce un valore booleano che indica se il testo è stato convertito nel tipo di enumerazione e scrive il valore analizzato nel parametro out. Se l’input disponibile è un intero, convertillo prima in testo. L’esempio verifica anche separatamente l’appartenenza a un membro dichiarato, perché il successo dell’analisi numerica non dimostra che il numero sia stato dichiarato nell’enumerazione.
using System;
public class Program
{
public enum MyEnum { Zero = 0, One = 1, Two = 2 }
public static void Main()
{
int number = 1;
string input = number.ToString();
if (Enum.TryParse<MyEnum>(input, out MyEnum value))
{
Console.WriteLine($"Parsed: {value}");
Console.WriteLine($"Declared: {Enum.IsDefined(typeof(MyEnum), value)}");
}
else
{
Console.WriteLine("Could not parse the input.");
}
}
}
Per il testo che contiene un nome, Enum.TryParse accetta anche il nome di un membro dichiarato, per esempio "Two". Il testo numerico può essere analizzato ottenendo un valore sottostante non dichiarato: mantieni quindi il controllo con Enum.IsDefined quando l’applicazione richiede una corrispondenza esatta con un membro dichiarato. Usa l’overload ignoreCase solo quando è appropriato ignorare le maiuscole e le minuscole nei nomi.
Scegliere il metodo di conversione più adatto
Scegli in base alla forma dell’input e al tipo di convalida necessario:
- Usa un cast diretto per un intero di cui ti fidi, quando è accettabile ottenere un valore di enumerazione non dichiarato.
- Usa
Enum.Parseper il testo quando vuoi gestire un’analisi non riuscita tramite un’eccezione. - Usa
Enum.TryParseper il testo quando vuoi un risultato booleano che indichi se la conversione è riuscita. - Usa
Enum.IsDefinedprima o dopo la conversione quando sono accettabili solo costanti di enumerazione dichiarate.
Nessuno dei due metodi di analisi garantisce che un valore numerico corrisponda a una costante dichiarata. Per input non attendibili o dinamici, prova a eseguire l’analisi e poi controlla con Enum.IsDefined se l’applicazione accetta solo membri dichiarati. Per le enumerazioni [Flags], definisci e applica regole di convalida specifiche per le combinazioni consentite, invece di affidarti soltanto a Enum.IsDefined.