Enum.GetValues Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Overload
| GetValues(Type) |
Mengambil array nilai konstanta dalam enumerasi tertentu. |
| GetValues<TEnum>() |
Mengambil array nilai konstanta dalam jenis enumerasi tertentu. |
GetValues(Type)
- Sumber:
- Enum.cs
- Sumber:
- Enum.cs
- Sumber:
- Enum.cs
Mengambil array nilai konstanta dalam enumerasi tertentu.
public:
static Array ^ GetValues(Type ^ enumType);public static Array GetValues (Type enumType);[System.Runtime.InteropServices.ComVisible(true)]
public static Array GetValues (Type enumType);static member GetValues : Type -> Array[<System.Runtime.InteropServices.ComVisible(true)>]
static member GetValues : Type -> ArrayPublic Shared Function GetValues (enumType As Type) As ArrayParameter
- enumType
- Type
Jenis enumerasi.
Mengembalikan
Array yang berisi nilai konstanta di enumType.
- Atribut
Pengecualian
enumTypeadalah null.
enumTypebukan .Enum
Metode ini dipanggil oleh refleksi dalam konteks khusus refleksi,
-atau-
enumType adalah jenis dari rakitan yang dimuat dalam konteks khusus refleksi.
.NET 8 dan versi yang lebih baru: enumType adalah jenis enumerasi yang didukung Boolean.
Contoh
Contoh berikut mengilustrasikan penggunaan GetValues.
using namespace System;
enum class Colors
{
Red, Green, Blue, Yellow
};
enum class Styles
{
Plaid = 0,
Striped = 23,
Tartan = 65,
Corduroy = 78
};
int main()
{
Console::WriteLine( "The values of the Colors Enum are:" );
Array^ a = Enum::GetValues( Colors::typeid );
for ( Int32 i = 0; i < a->Length; i++ )
{
Object^ o = a->GetValue( i );
Console::WriteLine( "{0}", Enum::Format( Colors::typeid, o, "D" ) );
}
Console::WriteLine();
Console::WriteLine( "The values of the Styles Enum are:" );
Array^ b = Enum::GetValues( Styles::typeid );
for ( Int32 i = 0; i < b->Length; i++ )
{
Object^ o = b->GetValue( i );
Console::WriteLine( "{0}", Enum::Format( Styles::typeid, o, "D" ) );
}
}
// The example produces the following output:
// The values of the Colors Enum are:
// 0
// 1
// 2
// 3
//
// The values of the Styles Enum are:
// 0
// 23
// 65
// 78
using System;
public class GetValuesTest {
enum Colors { Red, Green, Blue, Yellow };
enum Styles { Plaid = 0, Striped = 23, Tartan = 65, Corduroy = 78 };
public static void Main() {
Console.WriteLine("The values of the Colors Enum are:");
foreach(int i in Enum.GetValues(typeof(Colors)))
Console.WriteLine(i);
Console.WriteLine();
Console.WriteLine("The values of the Styles Enum are:");
foreach(int i in Enum.GetValues(typeof(Styles)))
Console.WriteLine(i);
}
}
// The example produces the following output:
// The values of the Colors Enum are:
// 0
// 1
// 2
// 3
//
// The values of the Styles Enum are:
// 0
// 23
// 65
// 78
open System
type Colors =
| Red = 0
| Green = 1
| Blue = 2
| Yellow = 3
type Styles =
| Plaid = 0
| Striped = 23
| Tartan = 65
| Corduroy = 78
printfn $"The values of the Colors Enum are:"
for i in Enum.GetValues typeof<Colors> do
printfn $"{i}"
printfn "\nThe values of the Styles Enum are:"
for i in Enum.GetValues typeof<Styles> do
printfn $"{i}"
// The example produces the following output:
// The values of the Colors Enum are:
// 0
// 1
// 2
// 3
//
// The values of the Styles Enum are:
// 0
// 23
// 65
// 78
Public Class GetValuesTest
Enum Colors
Red
Green
Blue
Yellow
End Enum 'Colors
Enum Styles
Plaid = 0
Striped = 23
Tartan = 65
Corduroy = 78
End Enum 'Styles
Public Shared Sub Main()
Console.WriteLine("The values of the Colors Enum are:")
Dim i As Integer
For Each i In [Enum].GetValues(GetType(Colors))
Console.WriteLine(i)
Next
Console.WriteLine()
Console.WriteLine("The values of the Styles Enum are:")
For Each i In [Enum].GetValues(GetType(Styles))
Console.WriteLine(i)
Next
End Sub
End Class
' The example produces the following output:
' The values of the Colors Enum are:
' 0
' 1
' 2
' 3
'
' The values of the Styles Enum are:
' 0
' 23
' 65
' 78
Keterangan
Elemen array diurutkan berdasarkan nilai biner dari konstanta enumerasi (yaitu, berdasarkan besarannya yang tidak ditandatangani). Contoh berikut menampilkan informasi tentang array yang dikembalikan oleh GetValues metode untuk enumerasi yang menyertakan nilai negatif, nol, dan nilai positif.
using System;
enum SignMagnitude { Negative = -1, Zero = 0, Positive = 1 };
public class Example
{
public static void Main()
{
foreach (var value in Enum.GetValues(typeof(SignMagnitude))) {
Console.WriteLine("{0,3} 0x{0:X8} {1}",
(int) value, ((SignMagnitude) value));
} }
}
// The example displays the following output:
// 0 0x00000000 Zero
// 1 0x00000001 Positive
// -1 0xFFFFFFFF Negative
open System
type SignMagnitude =
| Negative = -1
| Zero = 0
| Positive = 1
for value in Enum.GetValues typeof<SignMagnitude> do
printfn $"{value :?> int,3} 0x{value :?> int:X8} {value :?> SignMagnitude}"
// The example displays the following output:
// 0 0x00000000 Zero
// 1 0x00000001 Positive
// -1 0xFFFFFFFF Negative
Public Enum SignMagnitude As Integer
Negative = -1
Zero = 0
Positive = 1
End Enum
Module Example
Public Sub Main()
Dim values() As Integer = CType([Enum].GetValues(GetType(SignMagnitude)), Integer())
For Each value In values
Console.WriteLine("{0,3} 0x{0:X8} {1}",
value, CType(value, SignMagnitude).ToString())
Next
End Sub
End Module
' The example displays the following output:
' 0 0x00000000 Zero
' 1 0x00000001 Positive
' -1 0xFFFFFFFF Negative
Metode GetValues mengembalikan array yang berisi nilai untuk setiap anggota enumType enumerasi. Jika beberapa anggota memiliki nilai yang sama, array yang dikembalikan menyertakan nilai duplikat. Dalam hal ini, memanggil GetName metode dengan setiap nilai dalam array yang dikembalikan tidak memulihkan nama unik yang ditetapkan kepada anggota yang memiliki nilai duplikat. Untuk mengambil semua nama anggota enumerasi dengan sukses, panggil GetNames metode .
Metode GetValues tidak dapat dipanggil dengan menggunakan pantulan dalam konteks khusus refleksi. Sebagai gantinya, Anda dapat mengambil nilai semua anggota enumerasi dengan menggunakan Type.GetFields metode untuk mendapatkan array FieldInfo objek yang mewakili anggota enumerasi lalu memanggil FieldInfo.GetRawConstantValue metode pada setiap elemen array. Contoh berikut menggambarkan teknik ini. Ini mengharuskan Anda menentukan enumerasi berikut dalam rakitan bernama Enumerations.dll:
[Flags] enum Pets { None=0, Dog=1, Cat=2, Rodent=4, Bird=8,
Fish=16, Reptile=32, Other=64 };
[<Flags>]
type Pets =
| None = 0
| Dog = 1
| Cat = 2
| Rodent = 4
| Bird = 8
| Fish = 16
| Reptile = 32
| Other = 64
<Flags> Public Enum Pets As Integer
None = 0
Dog = 1
Cat = 2
Rodent = 4
Bird = 8
Fish = 16
Reptile = 32
Other = 64
End Enum
Rakitan dimuat dalam konteks khusus refleksi, Type objek yang mewakili Pets enumerasi dibuat, array FieldInfo objek diambil, dan nilai bidang ditampilkan ke konsol.
using System;
using System.Reflection;
public class Example
{
public static void Main()
{
Assembly assem = Assembly.ReflectionOnlyLoadFrom(@".\Enumerations.dll");
Type typ = assem.GetType("Pets");
FieldInfo[] fields = typ.GetFields();
foreach (var field in fields) {
if (field.Name.Equals("value__")) continue;
Console.WriteLine("{0,-9} {1}", field.Name + ":",
field.GetRawConstantValue());
}
}
}
// The example displays the following output:
// None: 0
// Dog: 1
// Cat: 2
// Rodent: 4
// Bird: 8
// Fish: 16
// Reptile: 32
// Other: 64
open System
open System.Reflection
let assem = Assembly.ReflectionOnlyLoadFrom @".\Enumerations.dll"
let typ = assem.GetType "Pets"
let fields = typ.GetFields()
for field in fields do
if not (field.Name.Equals "value__") then
printfn $"""{field.Name + ":",-9} {field.GetRawConstantValue()}"""
// The example displays the following output:
// None: 0
// Dog: 1
// Cat: 2
// Rodent: 4
// Bird: 8
// Fish: 16
// Reptile: 32
// Other: 64
Imports System.Reflection
Module Example
Public Sub Main()
Dim assem As Assembly = Assembly.ReflectionOnlyLoadFrom(".\Enumerations.dll")
Dim typ As Type = assem.GetType("Pets")
Dim fields As FieldInfo() = typ.GetFields
For Each field In fields
If field.Name.Equals("value__") Then Continue For
Console.WriteLine("{0,-9} {1}", field.Name + ":",
field.GetRawConstantValue())
Next
End Sub
End Module
' The example displays the following output:
' None: 0
' Dog: 1
' Cat: 2
' Rodent: 4
' Bird: 8
' Fish: 16
' Reptile: 32
' Other: 64
Berlaku untuk
GetValues<TEnum>()
- Sumber:
- Enum.cs
- Sumber:
- Enum.cs
- Sumber:
- Enum.cs
Mengambil array nilai konstanta dalam jenis enumerasi tertentu.
public:
generic <typename TEnum>
where TEnum : value class static cli::array <TEnum> ^ GetValues();public static TEnum[] GetValues<TEnum> () where TEnum : struct;static member GetValues : unit -> 'Enum[] (requires 'Enum : struct)Public Shared Function GetValues(Of TEnum As Structure) () As TEnum()Jenis parameter
- TEnum
Jenis enumerasi.
Mengembalikan
Array yang berisi nilai konstanta di TEnum.
Pengecualian
.NET 8 dan versi yang lebih baru: TEnum adalah jenis enumerasi yang didukung Boolean.
Berlaku untuk
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk