Nota: este método es nuevo en la versión 2.0 de .NET Framework.
Deserializa un valor binario de 64 bits y vuelve a crear un objeto
DateTime serializado original.
Espacio de nombres: System
Ensamblado: mscorlib (en mscorlib.dll)
Sintaxis
Visual Basic (Declaración)
Public Shared Function FromBinary ( _
dateData As Long _
) As DateTime
Dim dateData As Long
Dim returnValue As DateTime
returnValue = DateTime.FromBinary(dateData)
public static DateTime FromBinary (
long dateData
)
public:
static DateTime FromBinary (
long long dateData
)
public static DateTime FromBinary (
long dateData
)
public static function FromBinary (
dateData : long
) : DateTime
Parámetros
- dateData
Entero con signo de 64 bits que codifica la propiedad Kind en un campo de 2 bits y la propiedad Ticks en un campo de 62 bits.
Valor devuelto
Objeto
DateTime que es equivalente al objeto
DateTime que se serializó con el método
ToBinary.
Excepciones
Comentarios
Utilice el método ToBinary para convertir el valor del objeto DateTime actual en un valor binario. Después, utilice el valor binario y el método FromBinary para volver a crear el objeto DateTime original.
Ajuste de la hora local
Una hora local, que es una hora universal coordinada ajustada a la zona horaria local, se representa mediante una estructura DateTime cuya propiedad Kind tiene el valor de Local. Si se serializa un objeto DateTime local en una zona horaria mediante el método ToBinary y después se deserializa en una zona horaria distinta mediante el método FromBinary, la hora local representada por el objeto DateTime resultante se ajusta automáticamente a la segunda zona horaria.
Por ejemplo, consideremos un objeto DateTime que representa las 15:00 horas en horario local. Una aplicación que se ejecuta en una zona horaria más occidental utiliza el método ToBinary para convertir ese objeto DateTime en un valor binario y, después, otra aplicación que se ejecuta en una zona horaria situada a tres horas hacia el este de la original utiliza el método FromBinary para convertir el valor binario en un nuevo objeto DateTime. El valor del nuevo objeto DateTime serán las 18:00 horas, lo que representa el mismo punto horario que el valor original de 15:00 horas, pero ajustado a la hora local de la zona horaria más oriental.
Consideraciones de versión
A partir de la versión 2.0 de .NET Framework, una estructura DateTime está formada por un campo Kind privado, que indica si la hora especificada es una hora local, una hora universal coordinada (UTC), o ninguna de ellas, concatenado a un campo Ticks, que contiene el número de pasos de 100 nanosegundos que especifican la fecha y la hora. Se puede obtener acceso al número de pasos mediante la propiedad Ticks y al campo Kind mediante la propiedad Kind.
Con anterioridad a la versión 2.0 de .NET Framework, cuando se serializaba manualmente un objeto DateTime, en lugar de utilizar una interfaz de serialización como System.Runtime.Serialization.ISerializable, sólo era necesario serializar los datos del campo Ticks del objeto DateTime. A partir de la versión 2.0 de .NET Framework, también se deben serializar los datos del campo Kind.
Plataformas
Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition
.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.
Información de versión
.NET Framework
Compatible con: 2.0
Vea también