Enum.TryParse Metod

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

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

Parametrar

Returer

true om konverteringen lyckades. false Annars.

Undantag

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

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

Parametrar

Returer

true om konverteringen lyckades. false Annars.

Undantag

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

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

Parametrar

Returer

true om konverteringen lyckades. false Annars.

Undantag

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

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

Parametrar

Returer

true om konverteringen lyckades. false Annars.

Undantag

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

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

Typparametrar

Parametrar

Returer

true om konverteringen lyckades. false Annars.

Undantag

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

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

Typparametrar

Parametrar

Returer

trueom parametern value har konverterats, annars . false

Undantag

Exempel

I följande exempel definieras en Colors uppräkning, metoden anropas TryParse<TEnum>(String, TEnum) för att konvertera strängar till motsvarande uppräkningsvärden och anropar IsDefined metoden för att säkerställa att vissa integralvärden är underliggande värden i Colors uppräkningen.

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.

Kommentarer

TryParse<TEnum>(String, TEnum) är identisk med Parse(Type, String) metoden, förutom att den i stället för att utlösa ett undantag returnerar false om konverteringen misslyckas. Det eliminerar behovet av undantagshantering vid parsning av strängrepresentationen av ett uppräkningsvärde.

Parametern value innehåller strängrepresentationen av en uppräkningsmedlems underliggande värde eller namngivna konstant, eller en lista med namngivna konstanter eller underliggande värden avgränsade med kommatecken (,). Om value innehåller flera namngivna konstanter eller värden kan ett eller flera tomma blanksteg föregå eller följa varje värde, namn eller kommatecken i value. Om value är en lista result visar värdet för de angivna namnen eller underliggande värden i kombination med en bitvis OR åtgärd. Om value är strängrepresentationen av namnet på ett uppräkningsvärde är jämförelsen av value med uppräkningsnamn skiftlägeskänslig.

Om value är ett namn som inte motsvarar en namngiven konstant av TEnumreturnerar falsemetoden . Om value är strängrepresentationen av ett heltal som inte representerar ett underliggande värde för TEnum uppräkningen, returnerar metoden en uppräkningsmedlem vars underliggande värde value konverteras till en integraltyp. Om det här beteendet är oönskat anropar IsDefined du metoden för att säkerställa att en viss strängrepresentation av ett heltal faktiskt är medlem i TEnum.

Om parsningsåtgärden misslyckas innehåller parametern result standardvärdet 0, som kanske inte är medlem i den underliggande TEnum uppräkningen. Om inga värden tilldelas till de namngivna konstanterna i TEnumär standardvärdet lika med den första medlemmen i TEnum. Annars är standardvärdet lika med medlemmen i uppräkningen med ett tilldelat värde på 0.

Se även

• Parse(Type, String)

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

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

Typparametrar

Parametrar

Returer

trueom parametern value har konverterats, annars . false

Undantag

Exempel

I följande exempel definieras en Colors uppräkning, metoden anropas TryParse<TEnum>(String, Boolean, TEnum) för att konvertera strängar till motsvarande uppräkningsvärden och anropar IsDefined metoden för att säkerställa att vissa integralvärden är underliggande värden i Colors uppräkningen. Metoden TryParse<TEnum>(String, Boolean, TEnum) använder skiftlägesokänslig jämförelse vid försök att konvertera strängrepresentationer av namngivna konstanter till motsvarande uppräkningsvärden.

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.

Kommentarer

TryParse<TEnum>(String, Boolean, TEnum) är identisk med Parse(Type, String, Boolean) metoden, förutom att den i stället för att utlösa ett undantag returnerar false om konverteringen misslyckas. Det eliminerar behovet av undantagshantering vid parsning av strängrepresentationen av ett uppräkningsvärde.

Parametern value innehåller strängrepresentationen av en uppräkningsmedlems underliggande värde eller namngivna konstant, eller en lista med namngivna konstanter eller underliggande värden avgränsade med kommatecken (,). Om value innehåller flera namngivna konstanter eller värden kan ett eller flera tomma blanksteg föregå eller följa varje värde, namn eller kommatecken i value. Om value är en lista result visar värdet för de angivna namnen eller underliggande värden i kombination med en bitvis OR åtgärd. Om value är strängrepresentationen av namnet på ett uppräkningsvärde beror jämförelsen av value med uppräkningsnamn på parametern ignoreCase . Om trueär jämförelsen skiftlägeskänslig. Om falseär den skiftlägeskänslig.

Om value är ett namn som inte motsvarar en namngiven konstant av TEnumreturnerar falsemetoden . Om value är strängrepresentationen av ett heltal som inte representerar ett underliggande värde för TEnum uppräkningen, returnerar metoden en uppräkningsmedlem vars underliggande värde value konverteras till en integraltyp. Om det här beteendet är oönskat anropar IsDefined du metoden för att säkerställa att en viss strängrepresentation av ett heltal faktiskt är medlem i TEnum.

Om parsningsåtgärden misslyckas innehåller parametern result standardvärdet 0, som kanske inte är medlem i den underliggande TEnum uppräkningen. Om inga värden tilldelas till de namngivna konstanterna i TEnumär standardvärdet lika med den första medlemmen i TEnum. Annars är standardvärdet lika med medlemmen i uppräkningen med ett tilldelat värde på 0.

Se även

• Parse(Type, String, Boolean)

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

Enum.cs

Källa:

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

Typparametrar

Parametrar

Returer

true om konverteringen lyckades. false Annars.

Undantag