Enum.TryParse Methode

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

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

Parameters

Retouren

true indien de conversie is geslaagd; false Anders.

Uitzonderingen

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

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

Parameters

Retouren

true indien de conversie is geslaagd; false Anders.

Uitzonderingen

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

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

Parameters

Retouren

true indien de conversie is geslaagd; false Anders.

Uitzonderingen

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

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

Parameters

Retouren

true indien de conversie is geslaagd; false Anders.

Uitzonderingen

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

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

Type parameters

Parameters

Retouren

true indien de conversie is geslaagd; false Anders.

Uitzonderingen

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

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

Type parameters

Parameters

Retouren

trueals de value parameter is geconverteerd; anders. false

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt een Colors opsomming gedefinieerd, wordt de TryParse<TEnum>(String, TEnum) methode aangeroepen om tekenreeksen te converteren naar de bijbehorende opsommingswaarden en wordt de IsDefined methode aangeroepen om ervoor te zorgen dat bepaalde integrale waarden onderliggende waarden zijn in de Colors opsomming.

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.

Opmerkingen

TryParse<TEnum>(String, TEnum) is identiek aan de Parse(Type, String) methode, behalve dat in plaats van een uitzondering te genereren, deze retourneert false als de conversie mislukt. Het elimineert de noodzaak voor het verwerken van uitzonderingen bij het parseren van de tekenreeksweergave van een opsommingswaarde.

De value parameter bevat de tekenreeksweergave van de onderliggende waarde van een opsommingslid of benoemde constante, of een lijst met benoemde constanten of onderliggende waarden gescheiden door komma's (,). Als value er meerdere benoemde constanten of waarden zijn opgenomen, kunnen een of meer lege spaties voorafgaan aan of volgen op elke waarde, naam of komma in value. Als value dit een lijst is, result geeft u de waarde weer van de opgegeven namen of onderliggende waarden in combinatie met een bitsgewijze OR bewerking. Als value dit de tekenreeksweergave is van de naam van een opsommingswaarde, is de vergelijking met value opsommingsnamen hoofdlettergevoelig.

Als value dit een naam is die niet overeenkomt met een benoemde constante, TEnumretourneert falsede methode . Als value dit de tekenreeksweergave is van een geheel getal dat geen onderliggende waarde van de TEnum opsomming vertegenwoordigt, retourneert de methode een opsommingslid waarvan de onderliggende waarde wordt value geconverteerd naar een integraal type. Als dit gedrag ongewenst is, roept u de IsDefined methode aan om ervoor te zorgen dat een bepaalde tekenreeksweergave van een geheel getal daadwerkelijk lid is van TEnum.

Als de parseringsbewerking mislukt, bevat de result parameter de standaardwaarde 0, die mogelijk geen lid is van de onderliggende TEnum opsomming. Als er geen waarden worden toegewezen aan de benoemde constanten in TEnum, is de standaardwaarde gelijk aan het eerste lid van de TEnum. Anders is de standaardwaarde gelijk aan het lid in de opsomming met een toegewezen waarde van 0.

Zie ook

• Parse(Type, String)

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

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

Type parameters

Parameters

Retouren

trueals de value parameter is geconverteerd; anders. false

Uitzonderingen

Voorbeelden

In het volgende voorbeeld wordt een Colors opsomming gedefinieerd, wordt de TryParse<TEnum>(String, Boolean, TEnum) methode aangeroepen om tekenreeksen te converteren naar de bijbehorende opsommingswaarden en wordt de IsDefined methode aangeroepen om ervoor te zorgen dat bepaalde integrale waarden onderliggende waarden zijn in de Colors opsomming. De TryParse<TEnum>(String, Boolean, TEnum) methode maakt gebruik van niet-hoofdlettergevoelige vergelijking bij het converteren van de tekenreeksweergaven van benoemde constanten naar hun equivalente opsommingswaarden.

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.

Opmerkingen

TryParse<TEnum>(String, Boolean, TEnum) is identiek aan de Parse(Type, String, Boolean) methode, behalve dat in plaats van een uitzondering te genereren, deze retourneert false als de conversie mislukt. Het elimineert de noodzaak voor het verwerken van uitzonderingen bij het parseren van de tekenreeksweergave van een opsommingswaarde.

De value parameter bevat de tekenreeksweergave van de onderliggende waarde van een opsommingslid of benoemde constante, of een lijst met benoemde constanten of onderliggende waarden gescheiden door komma's (,). Als value er meerdere benoemde constanten of waarden zijn opgenomen, kunnen een of meer lege spaties voorafgaan aan of volgen op elke waarde, naam of komma in value. Als value dit een lijst is, result geeft u de waarde weer van de opgegeven namen of onderliggende waarden in combinatie met een bitsgewijze OR bewerking. Als value dit de tekenreeksweergave is van de naam van een opsommingswaarde, is de vergelijking met opsommingsnamen afhankelijk van value de ignoreCase parameter. Als true, de vergelijking hoofdlettergevoelig is; als false, is het hoofdlettergevoelig.

Als value dit een naam is die niet overeenkomt met een benoemde constante, TEnumretourneert falsede methode . Als value dit de tekenreeksweergave is van een geheel getal dat geen onderliggende waarde van de TEnum opsomming vertegenwoordigt, retourneert de methode een opsommingslid waarvan de onderliggende waarde wordt value geconverteerd naar een integraal type. Als dit gedrag ongewenst is, roept u de IsDefined methode aan om ervoor te zorgen dat een bepaalde tekenreeksweergave van een geheel getal daadwerkelijk lid is van TEnum.

Als de parseringsbewerking mislukt, bevat de result parameter de standaardwaarde 0, die mogelijk geen lid is van de onderliggende TEnum opsomming. Als er geen waarden worden toegewezen aan de benoemde constanten in TEnum, is de standaardwaarde gelijk aan het eerste lid van de TEnum. Anders is de standaardwaarde gelijk aan het lid in de opsomming met een toegewezen waarde van 0.

Zie ook

• Parse(Type, String, Boolean)

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

Enum.cs

Bron:

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

Type parameters

Parameters

Retouren

true indien de conversie is geslaagd; false Anders.

Uitzonderingen