Enum.TryParse Yöntem

Kaynak:

Enum.cs

Kaynak:

Enum.cs

Kaynak:

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

Parametreler

Döndürülenler

Dönüştürmenin başarılı olup olmadığını true; false.

Özel durumlar

Kaynak:

Enum.cs

Kaynak:

Enum.cs

Kaynak:

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

Parametreler

Döndürülenler

Dönüştürmenin başarılı olup olmadığını true; false.

Özel durumlar

Kaynak:

Enum.cs

Kaynak:

Enum.cs

Kaynak:

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

Parametreler

Döndürülenler

Dönüştürmenin başarılı olup olmadığını true; false.

Özel durumlar

Kaynak:

Enum.cs

Kaynak:

Enum.cs

Kaynak:

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

Parametreler

Döndürülenler

Dönüştürmenin başarılı olup olmadığını true; false.

Özel durumlar

Kaynak:

Enum.cs

Kaynak:

Enum.cs

Kaynak:

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

Tür Parametreleri

Parametreler

Döndürülenler

Dönüştürmenin başarılı olup olmadığını true; false.

Özel durumlar

Kaynak:

Enum.cs

Kaynak:

Enum.cs

Kaynak:

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

Tür Parametreleri

Parametreler

Döndürülenler

value parametresinin başarıyla dönüştürüldüğünü true; aksi takdirde, false.

Özel durumlar

Örnekler

Aşağıdaki örnek bir Colors sabit listesi tanımlar, dizeleri karşılık gelen numaralandırma değerlerine dönüştürmek için TryParse<TEnum>(String, TEnum) yöntemini çağırır ve belirli integral değerlerinin Colors numaralandırmasında temel alınan değerler olduğundan emin olmak için IsDefined yöntemini çağırır.

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.

Açıklamalar

TryParse<TEnum>(String, TEnum) Parse(Type, String) yöntemiyle aynıdır, ancak özel durum oluşturmak yerine dönüştürme başarısız olursa false döndürür. Bir sabit listesi değerinin dize gösterimi ayrıştırıldığında özel durum işleme gereksinimini ortadan kaldırır.

value parametresi, numaralandırma üyesinin temel alınan değerinin veya adlandırılmış sabitinin dize gösterimini ya da virgülle (,) sınırlandırılmış adlandırılmış sabitlerin veya temel alınan değerlerin listesini içerir. value birden çok adlandırılmış sabit veya değer içeriyorsa, valueiçindeki her değer, ad veya virgülden önce bir veya daha fazla boş alan olabilir veya izleyebilir. value bir listeyse, result belirtilen adların veya temel alınan değerlerin değerini bit düzeyinde OR işlemiyle birleştirir. value bir numaralandırma değerinin adının dize gösterimiyse, value numaralandırma adlarıyla karşılaştırması büyük/küçük harfe duyarlıdır.

value TEnumadlandırılmış sabitine karşılık olmayan bir adsa, yöntemi falsedöndürür. value, TEnum numaralandırmasının temel alınan değerini temsil etmeyen bir tamsayının dize gösterimiyse, yöntemi temel alınan değeri value tamsayı türüne dönüştürülmüş bir numaralandırma üyesi döndürür. Bu davranış istenmeyen bir davranışsa, bir tamsayının belirli bir dize gösteriminin aslında TEnumüyesi olduğundan emin olmak için IsDefined yöntemini çağırın.

Ayrıştırma işlemi başarısız olursa result parametresi, temel alınan TEnum numaralandırmasının üyesi olmayan varsayılan 0 değerini içerir. TEnumiçinde adlandırılmış sabitlere hiçbir değer atanmazsa, varsayılan değer TEnumilk üyesine eşittir. Aksi takdirde varsayılan değer, atanmış değeri 0 olan numaralandırmadaki üyeye eşittir.

Ayrıca bkz.

• Parse(Type, String)

Kaynak:

Enum.cs

Kaynak:

Enum.cs

Kaynak:

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

Tür Parametreleri

Parametreler

Döndürülenler

value parametresinin başarıyla dönüştürüldüğünü true; aksi takdirde, false.

Özel durumlar

Örnekler

Aşağıdaki örnek bir Colors sabit listesi tanımlar, dizeleri karşılık gelen numaralandırma değerlerine dönüştürmek için TryParse<TEnum>(String, Boolean, TEnum) yöntemini çağırır ve belirli integral değerlerinin Colors numaralandırmasında temel alınan değerler olduğundan emin olmak için IsDefined yöntemini çağırır. TryParse<TEnum>(String, Boolean, TEnum) yöntemi, adlandırılmış sabitlerin dize gösterimlerini eşdeğer numaralandırma değerlerine dönüştürmeye çalışırken büyük/küçük harfe duyarsız karşılaştırma kullanır.

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.

Açıklamalar

TryParse<TEnum>(String, Boolean, TEnum) Parse(Type, String, Boolean) yöntemiyle aynıdır, ancak özel durum oluşturmak yerine dönüştürme başarısız olursa false döndürür. Bir sabit listesi değerinin dize gösterimi ayrıştırıldığında özel durum işleme gereksinimini ortadan kaldırır.

value parametresi, numaralandırma üyesinin temel alınan değerinin veya adlandırılmış sabitinin dize gösterimini ya da virgülle (,) sınırlandırılmış adlandırılmış sabitlerin veya temel alınan değerlerin listesini içerir. value birden çok adlandırılmış sabit veya değer içeriyorsa, valueiçindeki her değer, ad veya virgülden önce bir veya daha fazla boş alan olabilir veya izleyebilir. value bir listeyse, result belirtilen adların veya temel alınan değerlerin değerini bit düzeyinde OR işlemiyle birleştirir. value bir numaralandırma değerinin adının dize gösterimiyse, value numaralandırma adlarıyla karşılaştırması ignoreCase parametresine bağlıdır. truekarşılaştırma büyük/küçük harfe duyarlı değildir; falseise büyük/küçük harfe duyarlıdır.

value TEnumadlandırılmış sabitine karşılık olmayan bir adsa, yöntemi falsedöndürür. value, TEnum numaralandırmasının temel alınan değerini temsil etmeyen bir tamsayının dize gösterimiyse, yöntemi temel alınan değeri value tamsayı türüne dönüştürülmüş bir numaralandırma üyesi döndürür. Bu davranış istenmeyen bir davranışsa, bir tamsayının belirli bir dize gösteriminin aslında TEnumüyesi olduğundan emin olmak için IsDefined yöntemini çağırın.

Ayrıştırma işlemi başarısız olursa result parametresi, temel alınan TEnum numaralandırmasının üyesi olmayan varsayılan 0 değerini içerir. TEnumiçinde adlandırılmış sabitlere hiçbir değer atanmazsa, varsayılan değer TEnumilk üyesine eşittir. Aksi takdirde varsayılan değer, atanmış değeri 0 olan numaralandırmadaki üyeye eşittir.

Ayrıca bkz.

• Parse(Type, String, Boolean)

Kaynak:

Enum.cs

Kaynak:

Enum.cs

Kaynak:

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

Tür Parametreleri

Parametreler

Döndürülenler

Dönüştürmenin başarılı olup olmadığını true; false.

Özel durumlar