FieldAttributes Enumeração
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Especifica flags que descrevem os atributos de um campo.
Esta enumeração suporta uma combinação bit-a-bit dos respetivos valores membro.
public enum class FieldAttributes
[System.Flags]
public enum FieldAttributes
[System.Flags]
[System.Serializable]
public enum FieldAttributes
[System.Flags]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum FieldAttributes
[<System.Flags>]
type FieldAttributes =
[<System.Flags>]
[<System.Serializable>]
type FieldAttributes =
[<System.Flags>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type FieldAttributes =
Public Enum FieldAttributes
- Herança
- Atributos
Campos
| Name | Valor | Description |
|---|---|---|
| PrivateScope | 0 | Especifica que o campo não pode ser referenciado. |
| Private | 1 | Especifica que o campo é acessível apenas pelo tipo pai. |
| FamANDAssem | 2 | Especifica que o campo é acessível apenas por subtipos neste conjunto. |
| Assembly | 3 | Especifica que o campo está acessível em toda a montagem. |
| Family | 4 | Especifica que o campo é acessível apenas pelo tipo e subtipos. |
| FamORAssem | 5 | Especifica que o campo é acessível por subtipos em qualquer lugar, bem como ao longo deste conjunto. |
| Public | 6 | Especifica que o campo é acessível a qualquer membro para quem este âmbito seja visível. |
| FieldAccessMask | 7 | Especifica o nível de acesso de um dado campo. |
| Static | 16 | Especifica que o campo representa o tipo definido, caso contrário é por instância. |
| InitOnly | 32 | Especifica que o campo é inicializado apenas e pode ser definido apenas no corpo de um construtor. |
| Literal | 64 | Especifica que o valor do campo é uma constante em tempo de compilação (estática ou limite inicial). Qualquer tentativa de o definir gera um FieldAccessException. |
| NotSerialized | 128 | Especifica que o campo não tem de ser serializado quando o tipo é remoto. |
| HasFieldRVA | 256 | Especifica que o campo tem um endereço virtual relativo (RVA). A RVA é a localização do corpo do método na imagem atual, como um endereço relativo ao início do ficheiro de imagem em que se encontra. |
| SpecialName | 512 | Especifica um método especial, com o nome que descreve como o método é especial. |
| RTSpecialName | 1024 | Especifica que o tempo de execução da linguagem comum (APIs internas de metadados) deve verificar a codificação do nome. |
| HasFieldMarshal | 4096 | Especifica que o campo tem informação de marshaling. |
| PinvokeImpl | 8192 | Reservado para uso futuro. |
| HasDefault | 32768 | Especifica que o campo tem um valor predefinido. |
| ReservedMask | 38144 | Reservado. |
Exemplos
Neste exemplo, são construídos três campos e os FieldAttributes valores são apresentados. Um valor pode conter mais do que um atributo, por exemplo, tanto Public como Literal, como mostrado FieldAttributes no terceiro campo.
using System;
using System.Reflection;
public class Demo
{
// Make three fields:
// The first field is private.
private string m_field = "String A";
// The second field is public.
public string Field = "String B";
// The third field is public const (hence also literal and static),
// with a default value.
public const string FieldC = "String C";
}
public class Myfieldattributes
{
public static void Main()
{
Console.WriteLine ("\nReflection.FieldAttributes");
Demo d = new Demo();
// Get a Type object for Demo, and a FieldInfo for each of
// the three fields. Use the FieldInfo to display field
// name, value for the Demo object in d, and attributes.
//
Type myType = typeof(Demo);
FieldInfo fiPrivate = myType.GetField("m_field",
BindingFlags.NonPublic | BindingFlags.Instance);
DisplayField(d, fiPrivate);
FieldInfo fiPublic = myType.GetField("Field",
BindingFlags.Public | BindingFlags.Instance);
DisplayField(d, fiPublic);
FieldInfo fiConstant = myType.GetField("FieldC",
BindingFlags.Public | BindingFlags.Static);
DisplayField(d, fiConstant);
}
static void DisplayField(Object obj, FieldInfo f)
{
// Display the field name, value, and attributes.
//
Console.WriteLine("{0} = \"{1}\"; attributes: {2}",
f.Name, f.GetValue(obj), f.Attributes);
}
}
/* This code example produces the following output:
Reflection.FieldAttributes
m_field = "String A"; attributes: Private
Field = "String B"; attributes: Public
FieldC = "String C"; attributes: Public, Static, Literal, HasDefault
*/
Imports System.Reflection
Public Class Demo
' Declare three fields.
' The first field is private.
Private m_field As String = "String A"
'The second field is public.
Public Field As String = "String B"
' The third field is public and const, hence also static
' and literal with a default value.
Public Const FieldC As String = "String C"
End Class
Module Module1
Sub Main()
' Create an instance of the Demo class.
Dim d As New Demo()
Console.WriteLine(vbCrLf & "Reflection.FieldAttributes")
' Get a Type object for Demo, and a FieldInfo for each of
' the three fields. Use the FieldInfo to display field
' name, value for the Demo object in d, and attributes.
'
Dim myType As Type = GetType(Demo)
Dim fiPrivate As FieldInfo = myType.GetField("m_field", _
BindingFlags.NonPublic Or BindingFlags.Instance)
DisplayField(d, fiPrivate)
Dim fiPublic As FieldInfo = myType.GetField("Field", _
BindingFlags.Public Or BindingFlags.Instance)
DisplayField(d, fiPublic)
Dim fiConstant As FieldInfo = myType.GetField("FieldC", _
BindingFlags.Public Or BindingFlags.Static)
DisplayField(d, fiConstant)
End Sub
Sub DisplayField(ByVal obj As Object, ByVal f As FieldInfo)
' Display the field name, value, and attributes.
'
Console.WriteLine("{0} = ""{1}""; attributes: {2}", _
f.Name, f.GetValue(obj), f.Attributes)
End Sub
End Module
' This code example produces the following output:
'
'm_field = "String A"; attributes: Private
'Field = "String B"; attributes: Public
'FieldC = "String C"; attributes: Public, Static, Literal, HasDefault
Observações
FieldAttributes usa o valor de FieldAccessMask para mascarar apenas as partes do valor do atributo que dizem respeito à acessibilidade. Por exemplo, o código seguinte determina se Attributes tem o bit público definido.
FieldInfo fi = obj.GetType().GetField("field1");
if ((fi.Attributes & FieldAttributes.FieldAccessMask) ==
FieldAttributes.Public)
{
Console.WriteLine("{0:s} is public. Value: {1:d}", fi.Name, fi.GetValue(obj));
}
Dim fi As FieldInfo = obj.GetType().GetField("field1")
If (fi.Attributes And FieldAttributes.FieldAccessMask) = _
FieldAttributes.Public Then
Console.WriteLine("{0:s} is public. Value: {1:d}", fi.Name, fi.GetValue(obj))
End If
Para obter o FieldAttributes, primeiro obtenha a classe Type. A partir do Type, obtenha o FieldInfo. A partir do FieldInfo, obtenha o Attributes.
O valor enumerado é um número que representa o OR bit a bit dos atributos implementados no campo.