Enum.TryParse Metodo

Origine:

Enum.cs

Origine:

Enum.cs

Origine:

Enum.cs

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

Restituisce

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

Eccezioni

Origine:

Enum.cs

Origine:

Enum.cs

Origine:

Enum.cs

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);

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

Restituisce

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

Eccezioni

Origine:

Enum.cs

Origine:

Enum.cs

Origine:

Enum.cs

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

Restituisce

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

Eccezioni

Origine:

Enum.cs

Origine:

Enum.cs

Origine:

Enum.cs

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);

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

Restituisce

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

Eccezioni

Origine:

Enum.cs

Origine:

Enum.cs

Origine:

Enum.cs

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

Parametri

Restituisce

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

Eccezioni

Origine:

Enum.cs

Origine:

Enum.cs

Origine:

Enum.cs

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;

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

Parametri

Restituisce

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

Eccezioni

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)

Origine:

Enum.cs

Origine:

Enum.cs

Origine:

Enum.cs

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;

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

Parametri

Restituisce

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

Eccezioni

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)

Origine:

Enum.cs

Origine:

Enum.cs

Origine:

Enum.cs

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

Parametri

Restituisce

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

Eccezioni