Enum.IsDefined Methode

Definition

Namespace:
System
Assemblys:
mscorlib.dll, System.Runtime.dll
Assemblys:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Überlädt

Name Beschreibung
IsDefined(Type, Object)

Gibt einen Wert vom Typ Boolean zurück, der angibt, ob ein bestimmter integraler Wert oder sein Name als Zeichenfolge in einer angegebenen Enumeration vorhanden ist.
IsDefined<TEnum>(TEnum)

Gibt einen booleschen Wert zurück, der angibt, ob ein bestimmter integraler Wert oder sein Name als Zeichenfolge in einer angegebenen Enumeration vorhanden ist.

IsDefined(Type, Object)

Quelle:
Enum.cs
Quelle:
Enum.cs
Quelle:
Enum.cs
Quelle:
Enum.cs
Quelle:
Enum.cs

Gibt einen Wert vom Typ Boolean zurück, der angibt, ob ein bestimmter integraler Wert oder sein Name als Zeichenfolge in einer angegebenen Enumeration vorhanden ist.

public:
 static bool IsDefined(Type ^ enumType, System::Object ^ value);
public static bool IsDefined(Type enumType, object value);
[System.Runtime.InteropServices.ComVisible(true)]
public static bool IsDefined(Type enumType, object value);
static member IsDefined : Type * obj -> bool
[<System.Runtime.InteropServices.ComVisible(true)>]
static member IsDefined : Type * obj -> bool
Public Shared Function IsDefined (enumType As Type, value As Object) As Boolean

Parameter

enumType
Type

Ein Enumerationstyp.

value
Object

Der Wert oder Name einer Konstante in enumType.

Gibt zurück

Boolean

true wenn eine Konstante einen enumType Wert aufweist, der valuegleich ist; andernfalls false.

Attribute
ComVisibleAttribute

Ausnahmen

ArgumentNullException

enumType oder value ist null.

ArgumentException

enumType ist kein Enum.

-oder-

Der Typ von value ist eine Aufzählung, es handelt sich jedoch nicht um eine Aufzählung vom Typ enumType.

-oder-

Der Typ von value ist kein zugrunde liegender Typ von enumType.

InvalidOperationException

valueist nicht Typ SByte, , Int16, Int32, Int64, Byte, UInt16, oder UInt32, oder UInt64String. .

Beispiele

Im folgenden Beispiel wird eine Aufzählung definiert PetType , die aus einzelnen Bitfeldern besteht. Anschließend wird die IsDefined Methode mit möglichen zugrunde liegenden Enumerationswerten, Zeichenfolgennamen und zusammengesetzten Werten aufgerufen, die sich aus dem Festlegen mehrerer Bitfelder ergeben.

using System;

[Flags] public enum PetType
{
   None = 0, Dog = 1, Cat = 2, Rodent = 4, Bird = 8, Reptile = 16, Other = 32
};

public class Example
{
   public static void Main()
   {
      object value;

      // Call IsDefined with underlying integral value of member.
      value = 1;
      Console.WriteLine("{0}: {1}", value, Enum.IsDefined(typeof(PetType), value));
      // Call IsDefined with invalid underlying integral value.
      value = 64;
      Console.WriteLine("{0}: {1}", value, Enum.IsDefined(typeof(PetType), value));
      // Call IsDefined with string containing member name.
      value = "Rodent";
      Console.WriteLine("{0}: {1}", value, Enum.IsDefined(typeof(PetType), value));
      // Call IsDefined with a variable of type PetType.
      value = PetType.Dog;
      Console.WriteLine("{0}: {1}", value, Enum.IsDefined(typeof(PetType), value));
      value = PetType.Dog | PetType.Cat;
      Console.WriteLine("{0}: {1}", value, Enum.IsDefined(typeof(PetType), value));
      // Call IsDefined with uppercase member name.
      value = "None";
      Console.WriteLine("{0}: {1}", value, Enum.IsDefined(typeof(PetType), value));
      value = "NONE";
      Console.WriteLine("{0}: {1}", value, Enum.IsDefined(typeof(PetType), value));
      // Call IsDefined with combined value
      value = PetType.Dog | PetType.Bird;
      Console.WriteLine("{0:D}: {1}", value, Enum.IsDefined(typeof(PetType), value));
      value = value.ToString();
      Console.WriteLine("{0:D}: {1}", value, Enum.IsDefined(typeof(PetType), value));
   }
}
// The example displays the following output:
//       1: True
//       64: False
//       Rodent: True
//       Dog: True
//       Dog, Cat: False
//       None: True
//       NONE: False
//       9: False
//       Dog, Bird: False

open System

[<Flags>]
type PetType =
    | None = 0
    | Dog = 1
    | Cat = 2
    | Rodent = 4
    | Bird = 8
    | Reptile = 16
    | Other = 32

[<EntryPoint>]
let main _ =
    // Call IsDefined with underlying integral value of member.
    let value = 1
    printfn $"{value}: {Enum.IsDefined(typeof<PetType>, value)}"
    // Call IsDefined with invalid underlying integral value.
    let value = 64
    printfn $"{value}: {Enum.IsDefined(typeof<PetType>, value)}"
    // Call IsDefined with string containing member name.
    let value = "Rodent"
    printfn $"{value}: {Enum.IsDefined(typeof<PetType>, value)}"
    // Call IsDefined with a variable of type PetType.
    let value = PetType.Dog
    printfn $"{value}: {Enum.IsDefined(typeof<PetType>, value)}"
    let value = PetType.Dog ||| PetType.Cat
    printfn $"{value}: {Enum.IsDefined(typeof<PetType>, value)}"
    // Call IsDefined with uppercase member name.
    let value = "None"
    printfn $"{value}: {Enum.IsDefined(typeof<PetType>, value)}"
    let value = "NONE"
    printfn $"{value}: {Enum.IsDefined(typeof<PetType>, value)}"
    // Call IsDefined with combined value
    let value = PetType.Dog ||| PetType.Bird
    printfn $"{value:D}: {Enum.IsDefined(typeof<PetType>, value)}"
    let value = value.ToString()
    printfn $"{value:D}: {Enum.IsDefined(typeof<PetType>, value)}"
    0
// The example displays the following output:
//       1: True
//       64: False
//       Rodent: True
//       Dog: True
//       Dog, Cat: False
//       None: True
//       NONE: False
//       9: False
//       Dog, Bird: False

<Flags> Public Enum PetType As Integer
   None = 0
   Dog = 1
   Cat = 2
   Rodent = 4
   Bird = 8
   Reptile = 16
   Other = 32
End Enum

Module Example
   Public Sub Main()
      Dim value As Object
      
      ' Call IsDefined with underlying integral value of member.
      value = 1
      Console.WriteLine("{0}: {1}", value, [Enum].IsDefined(GetType(PetType), value))
      ' Call IsDefined with invalid underlying integral value.
      value = 64
      Console.WriteLine("{0}: {1}", value, [Enum].IsDefined(GetType(PetType), value))
      ' Call IsDefined with string containing member name.
      value = "Rodent"
      Console.WriteLine("{0}: {1}", value, [Enum].IsDefined(GetType(PetType), value))
      ' Call IsDefined with a variable of type PetType.
      value = PetType.Dog
      Console.WriteLine("{0}: {1}", value, [Enum].IsDefined(GetType(PetType), value))
      value = PetType.Dog Or PetType.Cat
      Console.WriteLine("{0}: {1}", value, [Enum].IsDefined(GetType(PetType), value))
      ' Call IsDefined with uppercase member name.      
      value = "None"
      Console.WriteLine("{0}: {1}", value, [Enum].IsDefined(GetType(PetType), value))
      value = "NONE"
      Console.WriteLine("{0}: {1}", value, [Enum].IsDefined(GetType(PetType), value))
      ' Call IsDefined with combined value
      value = PetType.Dog Or PetType.Bird
      Console.WriteLine("{0:D}: {1}", value, [Enum].IsDefined(GetType(PetType), value))
      value = value.ToString()
      Console.WriteLine("{0:D}: {1}", value, [Enum].IsDefined(GetType(PetType), value))
   End Sub
End Module
' The example displays the following output:
'       1: True
'       64: False 
'       Rodent: True
'       Dog: True
'       Dog, Cat: False
'       None: True
'       NONE: False
'       9: False
'       Dog, Bird: False

Hinweise

Der value Parameter kann eine der folgenden Sein:

  • Ein beliebiges Element vom Typ enumType.

  • Eine Variable, deren Wert ein Enumerationselement vom Typ enumTypeist.

  • Die Zeichenfolgendarstellung des Namens eines Enumerationselements. Die Zeichen in der Zeichenfolge müssen den gleichen Groß-/Kleinschreibungsnamen wie der Enumerationsmememmname aufweisen.

  • Ein Wert des zugrunde liegenden Typs von enumType.

Wenn die Konstanten in enumType einer Gruppe von Bitfeldern definieren und value die Werte, Namen oder zugrunde liegenden Werte mehrerer Bitfelder enthalten, gibt die IsDefined Methode zurück false. Anders ausgedrückt: Bei Enumerationen, die eine Gruppe von Bitfeldern definieren, bestimmt die Methode nur, ob ein einzelnes Bitfeld zur Enumeration gehört. Um zu bestimmen, ob mehrere Bitfelder in einem Enumerationstyp festgelegt werden, der mit dem FlagsAttribute Attribut markiert ist, können Sie die HasFlag Methode aufrufen.

Hinweise für Aufrufer

Wenn enumType es sich um eine Aufzählung handelt, die mithilfe des FlagsAttribute Attributs definiert wird, gibt die Methode zurück false , wenn mehrere Bitfelder value festgelegt werden, aber value nicht einem zusammengesetzten Enumerationswert entsprechen, oder wenn value es sich um eine Zeichenfolgenverkettung der Namen mehrerer Bitkennzeichnungen handelt. Im folgenden Beispiel wird eine Pets Enumeration mit dem FlagsAttribute Attribut definiert. Die IsDefined(Type, Object) Methode gibt zurück false , wenn Sie ihn an einen Enumerationswert übergeben, der zwei Bitfelder (Pets.Dog und Pets.Cat) festgelegt hat, und wenn Sie sie übergeben, wird die Zeichenfolgendarstellung dieses Enumerationswerts ("Dog, Cat") übergeben.

using System;

[Flags] public enum Pets {
      None = 0, Dog = 1, Cat = 2, Bird = 4,
      Rodent = 8, Other = 16 };

public class Example
{
   public static void Main()
   {
      Pets value = Pets.Dog | Pets.Cat;
      Console.WriteLine("{0:D} Exists: {1}",
                        value, Pets.IsDefined(typeof(Pets), value));
      string name = value.ToString();
      Console.WriteLine("{0} Exists: {1}",
                        name, Pets.IsDefined(typeof(Pets), name));
   }
}
// The example displays the following output:
//       3 Exists: False
//       Dog, Cat Exists: False

open System

[<Flags>]
type Pets =
    | None = 0
    | Dog = 1
    | Cat = 2
    | Bird = 4
    | Rodent = 8
    | Other = 16

let value = Pets.Dog ||| Pets.Cat
printfn $"{value:D} Exists: {Pets.IsDefined(typeof<Pets>, value)}"
let name = string value
printfn $"{name} Exists: {Pets.IsDefined(typeof<Pets>, name)}"
// The example displays the following output:
//       3 Exists: False
//       Dog, Cat Exists: False

<Flags> Public Enum Pets As Integer
   None = 0
   Dog = 1
   Cat = 2
   Bird = 4
   Rodent = 8
   Other = 16
End Enum

Module Example
   Public Sub Main()
      Dim value As Pets = Pets.Dog Or Pets.Cat
      Console.WriteLine("{0:D} Exists: {1}", 
                        value, Pets.IsDefined(GetType(Pets), value))
      Dim name As String = value.ToString()
      Console.WriteLine("{0} Exists: {1}", 
                        name, Pets.IsDefined(GetType(Pets), name))
   End Sub
End Module
' The example displays the following output:
'       3 Exists: False
'       Dog, Cat Exists: False

Sie können ermitteln, ob mehrere Bitfelder festgelegt werden, indem Sie die HasFlag(Enum) Methode aufrufen.

Weitere Informationen

Gilt für:

IsDefined<TEnum>(TEnum)

Quelle:
Enum.cs
Quelle:
Enum.cs
Quelle:
Enum.cs
Quelle:
Enum.cs
Quelle:
Enum.cs

Gibt einen booleschen Wert zurück, der angibt, ob ein bestimmter integraler Wert oder sein Name als Zeichenfolge in einer angegebenen Enumeration vorhanden ist.

public:
generic <typename TEnum>
 where TEnum : value class static bool IsDefined(TEnum value);
public static bool IsDefined<TEnum>(TEnum value) where TEnum : struct;
static member IsDefined : 'Enum -> bool (requires 'Enum : struct)
Public Shared Function IsDefined(Of TEnum As Structure) (value As TEnum) As Boolean

Typparameter

TEnum

Der Typ der Aufzählung.

Parameter

value
TEnum

Der Wert oder Name einer Konstante in TEnum.

Gibt zurück

Boolean

true wenn ein bestimmter integraler Wert oder sein Name als Zeichenfolge in einer angegebenen Enumeration vorhanden ist; false Andernfalls.

Gilt für: