Enum.IsDefined Methode

Definitie

Naamruimte:
System
Assembly's:
mscorlib.dll, System.Runtime.dll
Assembly's:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Overloads

Name Description
IsDefined(Type, Object)

Retourneert een Booleaanse waarde die aangeeft of een bepaalde integrale waarde, of de naam ervan als een tekenreeks, bestaat in een opgegeven opsomming.
IsDefined<TEnum>(TEnum)

Retourneert een Booleaanse waarde die aangeeft of een bepaalde integrale waarde, of de naam ervan als een tekenreeks, bestaat in een opgegeven opsomming.

IsDefined(Type, Object)

Bron:
Enum.cs
Bron:
Enum.cs
Bron:
Enum.cs
Bron:
Enum.cs
Bron:
Enum.cs

Retourneert een Booleaanse waarde die aangeeft of een bepaalde integrale waarde, of de naam ervan als een tekenreeks, bestaat in een opgegeven opsomming.

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

Parameters

enumType
Type

Een opsommingstype.

value
Object

De waarde of naam van een constante in enumType.

Retouren

Boolean

trueals een constante enumType een waarde heeft die gelijk is aan value; anders . false

Kenmerken
ComVisibleAttribute

Uitzonderingen

ArgumentNullException

enumType of value is null.

ArgumentException

enumType is geen Enum.

– of –

Het type value is een opsomming, maar het is geen opsomming van het type enumType.

– of –

Het type value is geen onderliggend type enumType.

InvalidOperationException

value is niet type SByte, Int16, , Int32, Int64, Byte, UInt16, , UInt32of UInt64, of String.

Voorbeelden

In het volgende voorbeeld wordt een opsomming gedefinieerd die PetType bestaat uit afzonderlijke bitvelden. Vervolgens wordt de IsDefined methode aangeroepen met mogelijke onderliggende opsommingswaarden, tekenreeksnamen en samengestelde waarden die het gevolg zijn van het instellen van meerdere bitvelden.

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

Opmerkingen

De value parameter kan een van de volgende zijn:

  • Elk lid van het type enumType.

  • Een variabele waarvan de waarde een opsommingslid van het type enumTypeis.

  • De tekenreeksweergave van de naam van een opsommingslid. De tekens in de tekenreeks moeten hetzelfde hoofdlettergebruik hebben als de naam van het opsommingslid.

  • Een waarde van het onderliggende type .enumType

Als de constanten in enumType een set bitvelden definiëren en value de waarden, namen of onderliggende waarden van meerdere bitvelden bevatten, retourneert IsDefinedde false methode . Met andere woorden, voor opsommingen die een set bitvelden definiëren, bepaalt de methode alleen of één bitveld deel uitmaakt van de opsomming. Als u wilt bepalen of meerdere bitvelden zijn ingesteld in een opsommingstype dat is gelabeld met het FlagsAttribute kenmerk, kunt u de HasFlag methode aanroepen.

Notities voor bellers

Als enumType dit een opsomming is die is gedefinieerd met behulp van het FlagsAttribute kenmerk, retourneert false de methode als er meerdere bitvelden value zijn ingesteld, maar value niet overeenkomt met een samengestelde opsommingswaarde of als value het een tekenreekssamenvoeging is van de namen van meerdere bitvlagken. In het volgende voorbeeld wordt een Pets opsomming gedefinieerd met het FlagsAttribute kenmerk. De IsDefined(Type, Object) methode retourneert false wanneer u deze doorgeeft aan een opsommingswaarde met twee bitsvelden (Pets.Dog en Pets.Cat) en wanneer u deze doorgeeft, wordt de tekenreeksweergave van die opsommingswaarde ('Hond, Kat') doorgegeven.

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

U kunt bepalen of velden met meerdere bits zijn ingesteld door de methode aan te HasFlag(Enum) roepen.

Zie ook

Van toepassing op

IsDefined<TEnum>(TEnum)

Bron:
Enum.cs
Bron:
Enum.cs
Bron:
Enum.cs
Bron:
Enum.cs
Bron:
Enum.cs

Retourneert een Booleaanse waarde die aangeeft of een bepaalde integrale waarde, of de naam ervan als een tekenreeks, bestaat in een opgegeven opsomming.

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

Type parameters

TEnum

Het type opsomming.

Parameters

value
TEnum

De waarde of naam van een constante in TEnum.

Retouren

Boolean

true indien een bepaalde integrale waarde of de naam ervan als een tekenreeks bestaat in een opgegeven opsomming; false Anders.

Van toepassing op