Binder.BindToField(BindingFlags, FieldInfo[], Object, CultureInfo) Método

Definição

Namespace:

System.Reflection

Assembly:

System.Runtime.dll

Origem:

Binder.cs

Seleciona um campo do conjunto determinado de campos, com base nos critérios especificados.

public:
 abstract System::Reflection::FieldInfo ^ BindToField(System::Reflection::BindingFlags bindingAttr, cli::array <System::Reflection::FieldInfo ^> ^ match, System::Object ^ value, System::Globalization::CultureInfo ^ culture);

public abstract System.Reflection.FieldInfo BindToField (System.Reflection.BindingFlags bindingAttr, System.Reflection.FieldInfo[] match, object value, System.Globalization.CultureInfo? culture);

abstract member BindToField : System.Reflection.BindingFlags * System.Reflection.FieldInfo[] * obj * System.Globalization.CultureInfo -> System.Reflection.FieldInfo

Public MustOverride Function BindToField (bindingAttr As BindingFlags, match As FieldInfo(), value As Object, culture As CultureInfo) As FieldInfo

Parâmetros

bindingAttr

BindingFlags

Uma combinação bit a bit dos valores BindingFlags.

match

FieldInfo[]

O conjunto de campos que são candidatos para correspondência. Por exemplo, quando um objeto Binder é usado por InvokeMember, esse parâmetro especifica o conjunto de campos que a reflexão determinou serem possíveis correspondências, normalmente porque eles têm o nome do membro correto. A implementação padrão fornecida por DefaultBinder altera a ordem dessa matriz.

value

Object

O valor do campo usado para localizar um campo correspondente.

culture

CultureInfo

Uma instância de CultureInfo que é usada para controlar a coerção de tipos de dados, em implementações de associador que impõem tipos. Caso culture seja null, CultureInfo para o thread atual é usado.

Retornos

FieldInfo

O campo correspondente.

Exceções

AmbiguousMatchException

Para o associador padrão, bindingAttr inclui SetField e match contém vários campos que são correspondências igualmente boas para value. Por exemplo, value contém um MyClass objeto que implementa a IMyClass interface e match contém um campo do tipo MyClass e um campo do tipo IMyClass.

MissingFieldException

Para o associador de padrão bindingAttr inclui SetField e match não contém campos que possam aceitar value.

NullReferenceException

Para o associador padrão, bindingAttr inclui SetField e match é null ou uma matriz vazia.

- ou -

bindingAttr inclui SetField e value é null.

Comentários

Se bindingAttr não incluir BindingFlags.SetField, a implementação do associador padrão fornecida simplesmente Type.DefaultBinder retornará o primeiro elemento de match. Nenhuma seleção foi feita.

Esse método controla a associação fornecida por Type.InvokeMember.

Se uma implementação de associador permitir a coerção de valores de cadeia de caracteres para tipos numéricos, o culture parâmetro será necessário para converter uma cadeia de caracteres que representa 1000 em um Double valor, pois 1000 é representado de forma diferente por culturas diferentes. O associador padrão não executa coerções de cadeia de caracteres desse tipo.

Confira também

• FieldInfo