Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

TypeConverter (Clase)

Proporciona un modo unificado para convertir los tipos de valores en otros tipos, así como para obtener acceso a valores estándar y a subpropiedades.

System.Object
  System.ComponentModel.TypeConverter
    Más...

Espacio de nombres:  System.ComponentModel
Ensamblado:  System (en System.dll)

[ComVisibleAttribute(true)]
[HostProtectionAttribute(SecurityAction.LinkDemand, SharedState = true)]
public class TypeConverter

El tipo TypeConverter expone los siguientes miembros.

  NombreDescripción
Método públicoCompatible con XNA FrameworkTypeConverterInicializa una nueva instancia de la clase TypeConverter.
Arriba

  NombreDescripción
Método públicoCanConvertFrom(Type)Devuelve si este convertidor puede convertir un objeto del tipo dado al tipo de este convertidor.
Método públicoCanConvertFrom(ITypeDescriptorContext, Type)Devuelve si este convertidor puede convertir un objeto del tipo dado al tipo de este convertidor, utilizando el contexto especificado.
Método públicoCanConvertTo(Type)Devuelve si este convertidor puede convertir el objeto al tipo especificado.
Método públicoCanConvertTo(ITypeDescriptorContext, Type)Devuelve si este convertidor puede convertir el objeto al tipo especificado, utilizando el contexto especificado.
Método públicoConvertFrom(Object)Convierte el valor especificado en el tipo de este convertidor.
Método públicoConvertFrom(ITypeDescriptorContext, CultureInfo, Object)Convierte el objeto dado al tipo de este convertidor, utilizando el contexto especificado y la información de referencia cultural.
Método públicoConvertFromInvariantString(String)Convierte la cadena dada al tipo de este convertidor, utilizando la referencia cultural invariable.
Método públicoConvertFromInvariantString(ITypeDescriptorContext, String)Convierte la cadena dada en el tipo de este convertidor, utilizando el contexto especificado y la referencia cultural invariable.
Método públicoConvertFromString(String)Convierte el texto especificado a un objeto.
Método públicoConvertFromString(ITypeDescriptorContext, String)Convierte el texto dado a un objeto, utilizando el contexto especificado.
Método públicoConvertFromString(ITypeDescriptorContext, CultureInfo, String)Convierte el texto dado a un objeto, utilizando el contexto especificado y la información de referencia cultural.
Método públicoConvertTo(Object, Type)Convierte el objeto de valor dado al tipo especificado, utilizando los argumentos.
Método públicoConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)Convierte el objeto de valor dado al tipo especificado usando el contexto especificado y la información de referencia cultural.
Método públicoConvertToInvariantString(Object)Convierte el valor especificado a una representación de cadena invariable de la referencia cultural.
Método públicoConvertToInvariantString(ITypeDescriptorContext, Object)Convierte el valor especificado a una representación de cadena invariable de la referencia cultural, utilizando el contexto especificado.
Método públicoConvertToString(Object)Convierte el valor especificado a una representación de cadena.
Método públicoConvertToString(ITypeDescriptorContext, Object)Convierte el valor dado a una representación de cadena, utilizando el contexto especificado.
Método públicoConvertToString(ITypeDescriptorContext, CultureInfo, Object)Convierte el valor dado a una representación de cadena, utilizando el contexto especificado y la información de referencia cultural.
Método públicoCreateInstance(IDictionary)Vuelve a crear un Object dado un conjunto de valores de propiedad del objeto.
Método públicoCreateInstance(ITypeDescriptorContext, IDictionary)Crea una instancia del tipo al que está asociado esta clase TypeConverter, utilizando el contexto especificado, dado un conjunto de valores de propiedad para el objeto.
Método públicoCompatible con XNA FrameworkEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoCompatible con XNA FrameworkFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método protegidoGetConvertFromExceptionDevuelve una excepción que se va a producir cuando no puede realizarse una conversión.
Método protegidoGetConvertToExceptionDevuelve una excepción que se va a producir cuando no puede realizarse una conversión.
Método públicoGetCreateInstanceSupported()Devuelve un valor que indica si, al cambiar un valor en este objeto, es necesario llamar al método CreateInstance para crear un nuevo valor.
Método públicoGetCreateInstanceSupported(ITypeDescriptorContext)Devuelve un valor que indica si, al cambiar un valor en este objeto, es necesario llamar al método CreateInstance para crear un nuevo valor mediante el contexto especificado.
Método públicoCompatible con XNA FrameworkGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoGetProperties(Object)Devuelve una colección de propiedades para el tipo de matriz especificado por el valor del parámetro.
Método públicoGetProperties(ITypeDescriptorContext, Object)Devuelve una colección de propiedades para el tipo de matriz especificado por valor del parámetro, utilizando el contexto especificado.
Método públicoGetProperties(ITypeDescriptorContext, Object, Attribute[])Devuelve una colección de propiedades para el tipo de matriz especificado por el valor del parámetro, utilizando el contexto y los atributos especificados.
Método públicoGetPropertiesSupported()Devuelve si este objeto admite propiedades.
Método públicoGetPropertiesSupported(ITypeDescriptorContext)Obtiene si este objeto admite propiedades, utilizando el contexto especificado.
Método públicoGetStandardValues()Devuelve una colección de valores estándar del contexto predeterminado para el tipo de datos para el que está diseñado este convertidor de tipos.
Método públicoGetStandardValues(ITypeDescriptorContext)Devuelve una colección de valores estándar para el tipo de datos para el que está diseñado este convertidor de tipos cuando se proporciona un contexto de formato.
Método públicoGetStandardValuesExclusive()Devuelve si la colección de valores estándar devueltos por GetStandardValues es una lista exclusiva.
Método públicoGetStandardValuesExclusive(ITypeDescriptorContext)Devuelve si la colección de valores estándar devueltos por GetStandardValues es una lista exclusiva de posibles valores, utilizando el contexto especificado.
Método públicoGetStandardValuesSupported()Devuelve un valor que indica si este objeto admite un conjunto estándar de valores que se pueden seleccionar de una lista.
Método públicoGetStandardValuesSupported(ITypeDescriptorContext)Devuelve si este objeto admite un conjunto estándar de valores que se pueden seleccionar de una lista, utilizando el contexto especificado.
Método públicoCompatible con XNA FrameworkGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoIsValid(Object)Devuelve si el valor de objeto dado es válido para este tipo.
Método públicoIsValid(ITypeDescriptorContext, Object)Devuelve si el valor de objeto dado es válido para este tipo y para el contexto especificado.
Método protegidoCompatible con XNA FrameworkMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método protegidoSortPropertiesOrdena una colección de propiedades.
Método públicoCompatible con XNA FrameworkToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

El tipo de convertidor más común es el que convierte a y desde una representación de texto. El convertidor de tipos de una clase está enlazado a la clase con TypeConverterAttribute. A menos que se reemplace este atributo, todas las clases que heredan de esta clase utilizan el mismo convertidor de tipos que la clase base.

NotaNota

Para los propósitos del sistema de tipos generales, no tenga acceso directamente a un convertidor de tipos. En lugar de ello, obtenga acceso al convertidor apropiado utilizando TypeDescriptor. Para obtener más información, vea los ejemplos de código proporcionados.

Nota Para los propósitos de XAML, un procesador de XAML busca TypeConverterAttribute en lugar de la ir a través de TypeDescriptor. Para los casos donde desea una instancia de TypeDescriptor del código, o donde crea una instancia compartida en recursos de WPF, es aceptable construirlo directamente sin hacer referencia a TypeDescriptor u otra reflexión y compatibilidad del sistema de tipos.

Se hace referencia a las clases derivadas de TypeConverter a menudo como parte de cómo un procesador de XAML convierte un atributo o valor de texto de inicialización de marcado (qué es inherentemente una cadena) y genera un objeto para una representación en tiempo de ejecución. Los autores de tipo personalizados que intentan admitir un comportamiento de la conversión de tipos para XAML normalmente implementan una clase TypeConverter que admite su comportamiento único ConvertFrom de una cadena. Este comportamiento habilita la conversión de tipos de la cadena proporcionada como un valor de atributo de XAML y proporciona un procesador de XAML con la compatibilidad necesaria para crear un objeto a partir de la cadena, para que el objeto se pueda generar en un gráfico de objetos analizado. Los tipos o miembros personalizados de tipos personalizados se indican aplicando TypeConverterAttribute a las definiciones, con el atributo que hace referencia a la implementación TypeConverter personalizada. Para obtener más información, vea Información general sobre los convertidores de tipos para XAML.

NotaNota

El atributo HostProtectionAttribute aplicado a este tipo o miembro tiene el valor de propiedad Resources siguiente: SharedState. El atributo HostProtectionAttribute no afecta a las aplicaciones de escritorio (que normalmente se inician haciendo doble clic en un icono, escribiendo un comando o introduciendo una dirección URL en el explorador). Para obtener más información, vea la clase HostProtectionAttribute o Programación en SQL Server y atributos de protección de host.

Notas para los herederos

Herede de TypeConverter para implementar sus propios requisitos de conversión. Cuando herede de esta clase, podrá reemplazar los siguientes métodos:

NotaNota

Aunque el tipo derivado esté marcado como internal o private, se puede crear una instancia del mismo con la clase TypeDescriptor. No escriba código inseguro pensando que el llamador es de confianza. Por el contrario, suponga que los llamadores pueden crear instancias de su tipo si la confianza es parcial.

Para obtener más información sobre los convertidores de tipos para fines generales (distintos de XAML), vea Cómo: Implementar un convertidor de tipos o Conversión de tipos generalizada.

En el ejemplo de código siguiente se muestra cómo se crea una instancia de un convertidor de tipos y se enlaza a una clase. La clase que implementa el convertidor, MyClassConverter, debe heredarse de la clase TypeConverter.


[TypeConverter(typeof(MyClassConverter))]
 public class MyClass {
    // Insert code here.
}


Cuando hay una propiedad que tiene una enumeración, compruebe si es válido un valor de enumeración antes de establecer la propiedad. En el ejemplo de código siguiente es necesario que se haya declarado una enumeración denominada MyPropertyEnum.


public MyPropertyEnum MyProperty {
    set {
       // Checks to see if the value passed is valid.
       if (!TypeDescriptor.GetConverter(typeof(MyPropertyEnum)).IsValid(value)) {
          throw new ArgumentException();
       }
       // The value is valid. Insert code to set the property.
    }
 }


El convertidor de tipos suele utilizarse también para convertir un objeto a una cadena. En el ejemplo de código siguiente se imprime el nombre de la estructura Color almacenada en la variable c.


Color c = Color.Red;
    Console.WriteLine(TypeDescriptor.GetConverter(c).ConvertToString(c));


Se puede utilizar asimismo un convertidor de tipos para convertir un valor desde su nombre, tal como se muestra en el siguiente ejemplo de código.


Color c = (Color)TypeDescriptor.GetConverter(typeof(Color)).ConvertFromString("Red");


En el ejemplo de código siguiente puede utilizar un convertidor de tipos para imprimir el conjunto de valores estándar compatibles con el objeto.


foreach(Color c in TypeDescriptor.GetConverter(typeof(Color)).GetStandardValues()) {
    Console.WriteLine(TypeDescriptor.GetConverter(c).ConvertToString(c));
 }


.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros públicos static (Shared en Visual Basic) de este tipo son seguros para subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

System.Object
  System.ComponentModel.TypeConverter
    Microsoft.VisualBasic.Activities.XamlIntegration.VisualBasicSettingsConverter
    Microsoft.VisualBasic.ApplicationServices.BuiltInRoleConverter
    System.Activities.XamlIntegration.AssemblyReferenceConverter
    System.Activities.XamlIntegration.DynamicUpdateMapConverter
    System.Activities.XamlIntegration.DynamicUpdateMapItemConverter
    System.Activities.XamlIntegration.ImplementationVersionConverter
    System.Activities.XamlIntegration.TypeConverterBase
    System.Activities.XamlIntegration.WorkflowIdentityConverter
    System.ComponentModel.BaseNumberConverter
    System.ComponentModel.BooleanConverter
    System.ComponentModel.CharConverter
    System.ComponentModel.CollectionConverter
    System.ComponentModel.CultureInfoConverter
    System.ComponentModel.DateTimeConverter
    System.ComponentModel.DateTimeOffsetConverter
    System.ComponentModel.EnumConverter
    System.ComponentModel.ExpandableObjectConverter
    System.ComponentModel.GuidConverter
    System.ComponentModel.MultilineStringConverter
    System.ComponentModel.NullableConverter
    System.ComponentModel.ReferenceConverter
    System.ComponentModel.StringConverter
    System.ComponentModel.TimeSpanConverter
    System.ComponentModel.TypeListConverter
    System.Configuration.ConfigurationConverterBase
    System.Diagnostics.Design.LogConverter
    System.Drawing.ColorConverter
    System.Drawing.FontConverter
    System.Drawing.FontConverter.FontNameConverter
    System.Drawing.ImageConverter
    System.Drawing.ImageFormatConverter
    System.Drawing.PointConverter
    System.Drawing.RectangleConverter
    System.Drawing.SizeConverter
    System.Drawing.SizeFConverter
    System.Resources.ResXFileRef.Converter
    System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicyTypeConverter
    System.ServiceModel.Discovery.Configuration.DiscoveryVersionConverter
    System.ServiceModel.XamlIntegration.EndpointIdentityConverter
    System.ServiceModel.XamlIntegration.ServiceXNameTypeConverter
    System.ServiceModel.XamlIntegration.XPathMessageContextTypeConverter
    System.UriTypeConverter
    System.Web.Configuration.LowerCaseStringConverter
    System.Web.UI.Design.DataBindingCollectionConverter
    System.Web.UI.Design.DataColumnSelectionConverter
    System.Web.UI.Design.DataFieldConverter
    System.Web.UI.Design.DataMemberConverter
    System.Web.UI.Design.DataSourceConverter
    System.Web.UI.Design.DataSourceViewSchemaConverter
    System.Web.UI.Design.ExpressionsCollectionConverter
    System.Web.UI.Design.MobileControls.Converters.DataFieldConverter
    System.Web.UI.Design.MobileControls.Converters.DataMemberConverter
    System.Web.UI.Design.SkinIDTypeConverter
    System.Web.UI.Design.WebControls.DataSourceIDConverter
    System.Web.UI.WebControls.FontNamesConverter
    System.Web.UI.WebControls.FontUnitConverter
    System.Web.UI.WebControls.StringArrayConverter
    System.Web.UI.WebControls.UnitConverter
    System.Windows.Controls.DataGridLengthConverter
    System.Windows.Controls.Ribbon.RibbonControlLengthConverter
    System.Windows.Controls.Ribbon.StringCollectionConverter
    System.Windows.Controls.VirtualizationCacheLengthConverter
    System.Windows.CornerRadiusConverter
    System.Windows.CultureInfoIetfLanguageTagConverter
    System.Windows.DeferrableContentConverter
    System.Windows.DialogResultConverter
    System.Windows.DurationConverter
    System.Windows.DynamicResourceExtensionConverter
    System.Windows.ExpressionConverter
    System.Windows.FigureLengthConverter
    System.Windows.FontSizeConverter
    System.Windows.FontStretchConverter
    System.Windows.FontStyleConverter
    System.Windows.FontWeightConverter
    System.Windows.Forms.AxHost.StateConverter
    System.Windows.Forms.CursorConverter
    System.Windows.Forms.DataGridPreferredColumnWidthTypeConverter
    System.Windows.Forms.DataGridViewCellStyleConverter
    System.Windows.Forms.KeysConverter
    System.Windows.Forms.Layout.TableLayoutSettingsTypeConverter
    System.Windows.Forms.LinkArea.LinkAreaConverter
    System.Windows.Forms.LinkConverter
    System.Windows.Forms.ListBindingConverter
    System.Windows.Forms.OpacityConverter
    System.Windows.Forms.PaddingConverter
    System.Windows.Forms.ScrollableControl.DockPaddingEdgesConverter
    System.Windows.Forms.SelectionRangeConverter
    System.Windows.Forms.TreeNodeConverter
    System.Windows.GridLengthConverter
    System.Windows.Input.CommandConverter
    System.Windows.Input.CursorConverter
    System.Windows.Input.InputScopeConverter
    System.Windows.Input.InputScopeNameConverter
    System.Windows.Input.KeyConverter
    System.Windows.Input.KeyGestureConverter
    System.Windows.Input.ModifierKeysConverter
    System.Windows.Input.MouseActionConverter
    System.Windows.Input.MouseGestureConverter
    System.Windows.Int32RectConverter
    System.Windows.KeySplineConverter
    System.Windows.KeyTimeConverter
    System.Windows.LengthConverter
    System.Windows.Markup.DependencyPropertyConverter
    System.Windows.Markup.EventSetterHandlerConverter
    System.Windows.Markup.NameReferenceConverter
    System.Windows.Markup.RoutedEventConverter
    System.Windows.Markup.SetterTriggerConditionValueConverter
    System.Windows.Markup.TemplateKeyConverter
    System.Windows.Markup.XmlLanguageConverter
    System.Windows.Media.Animation.RepeatBehaviorConverter
    System.Windows.Media.BrushConverter
    System.Windows.Media.CacheModeConverter
    System.Windows.Media.ColorConverter
    System.Windows.Media.Converters.BaseIListConverter
    System.Windows.Media.DoubleCollectionConverter
    System.Windows.Media.FontFamilyConverter
    System.Windows.Media.GeometryConverter
    System.Windows.Media.ImageSourceConverter
    System.Windows.Media.Int32CollectionConverter
    System.Windows.Media.MatrixConverter
    System.Windows.Media.Media3D.Matrix3DConverter
    System.Windows.Media.Media3D.Point3DCollectionConverter
    System.Windows.Media.Media3D.Point3DConverter
    System.Windows.Media.Media3D.Point4DConverter
    System.Windows.Media.Media3D.QuaternionConverter
    System.Windows.Media.Media3D.Rect3DConverter
    System.Windows.Media.Media3D.Size3DConverter
    System.Windows.Media.Media3D.Vector3DCollectionConverter
    System.Windows.Media.Media3D.Vector3DConverter
    System.Windows.Media.PathFigureCollectionConverter
    System.Windows.Media.PixelFormatConverter
    System.Windows.Media.PointCollectionConverter
    System.Windows.Media.RequestCachePolicyConverter
    System.Windows.Media.TransformConverter
    System.Windows.Media.VectorCollectionConverter
    System.Windows.PointConverter
    System.Windows.PropertyPathConverter
    System.Windows.RectConverter
    System.Windows.SizeConverter
    System.Windows.StrokeCollectionConverter
    System.Windows.TemplateBindingExpressionConverter
    System.Windows.TemplateBindingExtensionConverter
    System.Windows.TextDecorationCollectionConverter
    System.Windows.ThicknessConverter
    System.Windows.VectorConverter
    System.Workflow.ComponentModel.Design.ActivityBindTypeConverter
    System.Xaml.Schema.XamlTypeTypeConverter

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft