DynamicObject.TryConvert(ConvertBinder, Object) Método
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona la implementación de las operaciones de conversión de tipos. Las clases derivadas de la clase DynamicObject pueden invalidar este método para especificar el comportamiento dinámico de las operaciones que convierten un objeto de un tipo a otro.
public:
virtual bool TryConvert(System::Dynamic::ConvertBinder ^ binder, [Runtime::InteropServices::Out] System::Object ^ % result);
public virtual bool TryConvert (System.Dynamic.ConvertBinder binder, out object result);
public virtual bool TryConvert (System.Dynamic.ConvertBinder binder, out object? result);
abstract member TryConvert : System.Dynamic.ConvertBinder * obj -> bool
override this.TryConvert : System.Dynamic.ConvertBinder * obj -> bool
Public Overridable Function TryConvert (binder As ConvertBinder, ByRef result As Object) As Boolean
- binder
- ConvertBinder
Proporciona información sobre la operación de conversión. La binder.Type
propiedad proporciona el tipo al que se debe convertir el objeto. Por ejemplo, para la instrucción (String)sampleObject
en C# (CType(sampleObject, Type)
en Visual Basic), donde sampleObject
es una instancia de la clase derivada de la DynamicObject clase , binder.Type
devuelve el String tipo . La binder.Explicit
propiedad proporciona información sobre el tipo de conversión que se produce. Devuelve true
para la conversión explícita y false
para la conversión implícita.
- result
- Object
Resultado de la operación de conversión de tipos.
true
si la operación es correcta; de lo contrario, false
. Si este método devuelve false
, el enlazador del lenguaje en tiempo de ejecución determina el comportamiento. (En la mayoría de los casos, se inicia una excepción específica del lenguaje en tiempo de ejecución).
Supongamos que necesita una estructura de datos para almacenar representaciones textuales y numéricas de números, y desea definir conversiones de esta estructura de datos en cadenas e enteros.
En el ejemplo de código siguiente se muestra la DynamicNumber
clase , que se deriva de la DynamicObject clase . DynamicNumber
invalida el método para habilitar la TryConvert conversión de tipos. También invalida los TrySetMember métodos y TryGetMember para permitir el acceso a los elementos de datos.
En este ejemplo, solo se admite la conversión a cadenas e enteros. Si intenta convertir un objeto en cualquier otro tipo, se produce una excepción en tiempo de ejecución.
// The class derived from DynamicObject.
public class DynamicNumber : DynamicObject
{
// The inner dictionary.
Dictionary<string, object> dictionary
= new Dictionary<string, object>();
// Getting a property.
public override bool TryGetMember(
GetMemberBinder binder, out object result)
{
return dictionary.TryGetValue(binder.Name, out result);
}
// Setting a property.
public override bool TrySetMember(
SetMemberBinder binder, object value)
{
dictionary[binder.Name] = value;
return true;
}
// Converting an object to a specified type.
public override bool TryConvert(
ConvertBinder binder, out object result)
{
// Converting to string.
if (binder.Type == typeof(String))
{
result = dictionary["Textual"];
return true;
}
// Converting to integer.
if (binder.Type == typeof(int))
{
result = dictionary["Numeric"];
return true;
}
// In case of any other type, the binder
// attempts to perform the conversion itself.
// In most cases, a run-time exception is thrown.
return base.TryConvert(binder, out result);
}
}
class Program
{
static void Test(string[] args)
{
// Creating the first dynamic number.
dynamic number = new DynamicNumber();
// Creating properties and setting their values
// for the dynamic number.
// The TrySetMember method is called.
number.Textual = "One";
number.Numeric = 1;
// Implicit conversion to integer.
int testImplicit = number;
// Explicit conversion to string.
string testExplicit = (String)number;
Console.WriteLine(testImplicit);
Console.WriteLine(testExplicit);
// The following statement produces a run-time exception
// because the conversion to double is not implemented.
// double test = number;
}
}
// This example has the following output:
// 1
// One
' Add Imports System.Linq.Expressions
' to the beginning of the file.
' The class derived from DynamicObject.
Public Class DynamicNumber
Inherits DynamicObject
' The inner dictionary to store field names and values.
Dim dictionary As New Dictionary(Of String, Object)
' Get the property value.
Public Overrides Function TryGetMember(
ByVal binder As System.Dynamic.GetMemberBinder,
ByRef result As Object) As Boolean
Return dictionary.TryGetValue(binder.Name, result)
End Function
' Set the property value.
Public Overrides Function TrySetMember(
ByVal binder As System.Dynamic.SetMemberBinder,
ByVal value As Object) As Boolean
dictionary(binder.Name) = value
Return True
End Function
Public Overrides Function TryConvert(ByVal binder As System.Dynamic.ConvertBinder, ByRef result As Object) As Boolean
' Converting to string.
If binder.Type = GetType(String) Then
result = dictionary("Textual")
Return True
End If
' Converting to integer.
If binder.Type = GetType(Integer) Then
result = dictionary("Numeric")
Return True
End If
' In case of any other type, the binder
' attempts to perform the conversion itself.
' In most cases, a run-time exception is thrown.
Return MyBase.TryConvert(binder, result)
End Function
End Class
Sub Main()
' Creating the first dynamic number.
Dim number As Object = New DynamicNumber()
' Creating properties and setting their values
' for the dynamic number.
' The TrySetMember method is called.
number.Textual = "One"
number.Numeric = 1
' Explicit conversion to string.
Dim testString = CTypeDynamic(Of String)(number)
Console.WriteLine(testString)
' Explicit conversion to integer.
Dim testInteger = CTypeDynamic(number, GetType(Integer))
Console.WriteLine(testInteger)
' The following statement produces a run-time exception
' because the conversion to double is not implemented.
' Dim testDouble = CTypeDynamic(Of Double)(number)
End Sub
' This example has the following output:
' One
' 1
Las clases derivadas de la DynamicObject clase pueden invalidar este método para especificar cómo se debe realizar una conversión de tipos para un objeto dinámico. Cuando el método no se invalida, el enlazador en tiempo de ejecución del lenguaje determina el comportamiento. (En la mayoría de los casos, se inicia una excepción específica del lenguaje en tiempo de ejecución).
En C#, si se invalida este método, se invoca automáticamente cuando se tiene una conversión explícita o implícita, como se muestra en el ejemplo de código siguiente.
En Visual Basic, solo se admite la conversión explícita. Si invalida este método, lo llama mediante las CTypeDynamic funciones o CTypeDynamic .
// Explicit conversion.
String sampleExplicit = (String)sampleObject;
// Implicit conversion.
String sampleImplicit = sampleObject;
// Explicit conversion - first variant.
Dim testExplicit1 = CTypeDynamic(Of String)(sampleObject)
// Explicit conversion - second variant.
Dim testExplicit2 = CTypeDynamic(sampleObject, GetType(String))
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
UWP | 10.0 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: