GenericEnumConverter Klasa

Definicja

Konwertuje między ciągiem a typem wyliczenia.Converts between a string and an enumeration type.

public ref class GenericEnumConverter sealed : System::Configuration::ConfigurationConverterBase
public sealed class GenericEnumConverter : System.Configuration.ConfigurationConverterBase
type GenericEnumConverter = class
    inherit ConfigurationConverterBase
Public NotInheritable Class GenericEnumConverter
Inherits ConfigurationConverterBase
Dziedziczenie

Przykłady

Poniższy przykład kodu pokazuje, jak uzyskać dostęp do niestandardowej właściwości sekcji, która używa GenericEnumConverter typu.The following code example shows how to access a custom section property that uses the GenericEnumConverter type.

using System;
using System.IO;
using System.ComponentModel;
using System.Configuration;

namespace Samples.AspNet
{
  
    public sealed class UsingGenericEnumConverter
    {
        public static void GetPermission()
        {
            try
            {
                CustomSection section =
                    ConfigurationManager.GetSection("CustomSection")
                    as CustomSection;
                
                Console.WriteLine("Default Permission: {0}", 
                    section.Permission.ToString());
            }
            catch (System.Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }

        public static void SetPermission()
        {
            try
            {
                System.Configuration.Configuration config =
                  ConfigurationManager.OpenExeConfiguration(
                  ConfigurationUserLevel.None);

                CustomSection section =
                    config.Sections.Get("CustomSection")
                    as CustomSection;

                section.Permission = 
                    CustomSection.Permissions.FullControl;

                section.SectionInformation.ForceSave = true;
                config.Save(ConfigurationSaveMode.Full); 
                config.Save();

                Console.WriteLine("Current Protection: {0}",
                    section.Permission.ToString());
            }
            catch (System.Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }
    }
}
Imports System.IO
Imports System.ComponentModel
Imports System.Configuration




NotInheritable Public Class UsingGenericEnumConverter
    
    Public Shared Sub GetPermission() 
        Try
            Dim section As CustomSection = _
            ConfigurationManager.GetSection("CustomSection")
            Console.WriteLine("Default Permission: {0}", _
            section.Permission.ToString())
        Catch e As System.Exception
            Console.WriteLine(e.Message)
        End Try
    
    End Sub
    
    
    Public Shared Sub SetPermission() 
        Try
            Dim config _
            As System.Configuration.Configuration = _
            ConfigurationManager.OpenExeConfiguration( _
            ConfigurationUserLevel.None)
            
            Dim section As CustomSection = _
            config.Sections.Get("CustomSection")
            
            section.Permission = _
            CustomSection.Permissions.FullControl
            
            section.SectionInformation.ForceSave = True
            config.Save(ConfigurationSaveMode.Full)
            config.Save()
            
            Console.WriteLine( _
            "Current Protection: {0}", _
            section.Permission.ToString())
        Catch e As System.Exception
            Console.WriteLine(e.Message)
        End Try
    
    End Sub
End Class

Poniższy przykład kodu pokazuje, jak zdefiniować niestandardową Właściwość modułu wyliczającego dostępną w poprzednim przykładzie.The following code example shows how to define a custom enumerator property accessed in the previous example. Należy zauważyć, że nie ma potrzeby określania GenericEnumConverter typu; jest on niejawnie wywoływany przez system.Notice that there is no need to specify the GenericEnumConverter type; it is implicitly invoked by the system.


public enum Permissions
{
    FullControl         = 0,
    Modify              = 1,
    ReadExecute         = 2,
    Read                = 3,
    Write               = 4,
    SpecialPermissions  = 5
}

[ConfigurationProperty("permission", DefaultValue = Permissions.Read)]
public Permissions Permission
{
    get
    {
        return (Permissions)this["permission"];
    }

    set
    {
        this["permission"] = value;
    }
}

Public Enum Permissions
    FullControl = 0
    Modify = 1
    ReadExecute = 2
    Read = 3
    Write = 4
    SpecialPermissions = 5
End Enum 'Permissions


<ConfigurationProperty("permission", _
DefaultValue:=Permissions.Read)> _
Public Property Permission() As Permissions
    Get
        Return CType(Me("permission"), Permissions)
    End Get

    Set(ByVal value As Permissions)
        Me("permission") = Value
    End Set
End Property

Poniższy przykład jest fragmentem konfiguracji używanym w poprzednim przykładzie.The following example is a configuration excerpt used by the previous example.

<?xml version="1.0" encoding="utf-8"?>  
<configuration>  

  <configSections>  
    <section name="CustomSection"   
      type="Samples.AspNet.CustomSection,   
      ConfigurationConverters,   
      Version=1.0.0.0, Culture=neutral,   
      PublicKeyToken=null"   
      allowDefinition="Everywhere"   
      allowExeDefinition="MachineToApplication"   
      restartOnExternalChanges="true" />  
  </configSections>  

  <CustomSection fileName="default.txt" maxIdleTime="90" timeDelay="infinite" cdStr="str0, str1" permission="Read" maxUsers="Infinite"/>  

</configuration>  

Uwagi

Ten typ, podobnie jak wszystkie inne typy konwerterów konfiguracji, konwertuje ciągi znajdujące się w pliku konfiguracji na i z pokrewnych właściwości silnie określonego typu.This type, like all the other configuration converter types, converts strings found in the configuration file to and from the related strongly typed properties.

W szczególności GenericEnumConverter obiekt konwertuje String wartość przypisaną do właściwości konfiguracji na Enum wartość i odwrotnie.In particular, the GenericEnumConverter object converts a String value, assigned to a configuration property, to an Enum value and vice versa.

Konstruktory

GenericEnumConverter(Type)

Inicjuje nowe wystąpienie klasy GenericEnumConverter.Initializes a new instance of the GenericEnumConverter class.

Metody

CanConvertFrom(ITypeDescriptorContext, Type)

Określa, czy konwersja jest dozwolona.Determines whether the conversion is allowed.

(Odziedziczone po ConfigurationConverterBase)
CanConvertFrom(Type)

Zwraca czy ten konwerter może skonwertować obiekt danego typu na typ tego konwertera.Returns whether this converter can convert an object of the given type to the type of this converter.

(Odziedziczone po TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)

Określa, czy konwersja jest dozwolona.Determines whether the conversion is allowed.

(Odziedziczone po ConfigurationConverterBase)
CanConvertTo(Type)

Zwraca czy ten konwerter może przekonwertować obiekt na określony typ.Returns whether this converter can convert the object to the specified type.

(Odziedziczone po TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)

Konwertuje String do Enum typu.Converts a String to an Enum type.

ConvertFrom(Object)

Konwertuje daną wartość na typ tego konwertera.Converts the given value to the type of this converter.

(Odziedziczone po TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)

Konwertuje dany ciąg na typ tego konwertera przy użyciu niezmiennej kultury i określonego kontekstu.Converts the given string to the type of this converter, using the invariant culture and the specified context.

(Odziedziczone po TypeConverter)
ConvertFromInvariantString(String)

Konwertuje dany ciąg na typ tego konwertera przy użyciu niezmiennej kultury.Converts the given string to the type of this converter, using the invariant culture.

(Odziedziczone po TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)

Konwertuje dany tekst do obiektu, przy użyciu określonych informacji o kontekście i kulturze.Converts the given text to an object, using the specified context and culture information.

(Odziedziczone po TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)

Konwertuje dany tekst do obiektu, przy użyciu określonego kontekstu.Converts the given text to an object, using the specified context.

(Odziedziczone po TypeConverter)
ConvertFromString(String)

Konwertuje określony tekst na obiekt.Converts the specified text to an object.

(Odziedziczone po TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)

Konwertuje Enum Typ na String wartość.Converts an Enum type to a String value.

ConvertTo(Object, Type)

Konwertuje dany obiekt wartości na określony typ, używając argumentów.Converts the given value object to the specified type, using the arguments.

(Odziedziczone po TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)

Konwertuje określoną wartość na reprezentację w postaci ciągu niezmiennej, przy użyciu określonego kontekstu.Converts the specified value to a culture-invariant string representation, using the specified context.

(Odziedziczone po TypeConverter)
ConvertToInvariantString(Object)

Konwertuje określoną wartość na reprezentację niezmienną typu Culture.Converts the specified value to a culture-invariant string representation.

(Odziedziczone po TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)

Konwertuje daną wartość na reprezentację ciągu, przy użyciu określonych informacji o kontekście i kulturze.Converts the given value to a string representation, using the specified context and culture information.

(Odziedziczone po TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)

Konwertuje daną wartość na reprezentację ciągu przy użyciu danego kontekstu.Converts the given value to a string representation, using the given context.

(Odziedziczone po TypeConverter)
ConvertToString(Object)

Konwertuje określoną wartość na reprezentację ciągu.Converts the specified value to a string representation.

(Odziedziczone po TypeConverter)
CreateInstance(IDictionary)

Powoduje ponowne utworzenie Object podanego zestawu wartości właściwości dla obiektu.Re-creates an Object given a set of property values for the object.

(Odziedziczone po TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)

Tworzy wystąpienie typu, TypeConverter z którym jest skojarzone, przy użyciu określonego kontekstu, z uwzględnieniem zestawu wartości właściwości dla tego obiektu.Creates an instance of the type that this TypeConverter is associated with, using the specified context, given a set of property values for the object.

(Odziedziczone po TypeConverter)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetConvertFromException(Object)

Zwraca wyjątek, który ma zostać zgłoszony, gdy nie można wykonać konwersji.Returns an exception to throw when a conversion cannot be performed.

(Odziedziczone po TypeConverter)
GetConvertToException(Object, Type)

Zwraca wyjątek, który ma zostać zgłoszony, gdy nie można wykonać konwersji.Returns an exception to throw when a conversion cannot be performed.

(Odziedziczone po TypeConverter)
GetCreateInstanceSupported()

Zwraca czy zmiana wartości w tym obiekcie wymaga wywołania CreateInstance(IDictionary) metody w celu utworzenia nowej wartości.Returns whether changing a value on this object requires a call to the CreateInstance(IDictionary) method to create a new value.

(Odziedziczone po TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)

Zwraca czy zmiana wartości w tym obiekcie wymaga wywołania do CreateInstance(IDictionary) utworzenia nowej wartości przy użyciu określonego kontekstu.Returns whether changing a value on this object requires a call to CreateInstance(IDictionary) to create a new value, using the specified context.

(Odziedziczone po TypeConverter)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetProperties(ITypeDescriptorContext, Object)

Zwraca kolekcję właściwości typu tablicy określonej przez parametr value przy użyciu określonego kontekstu.Returns a collection of properties for the type of array specified by the value parameter, using the specified context.

(Odziedziczone po TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])

Zwraca kolekcję właściwości typu tablicy określonej przez parametr value, przy użyciu określonego kontekstu i atrybutów.Returns a collection of properties for the type of array specified by the value parameter, using the specified context and attributes.

(Odziedziczone po TypeConverter)
GetProperties(Object)

Zwraca kolekcję właściwości typu tablicy określonej przez parametr value.Returns a collection of properties for the type of array specified by the value parameter.

(Odziedziczone po TypeConverter)
GetPropertiesSupported()

Zwraca czy ten obiekt obsługuje właściwości.Returns whether this object supports properties.

(Odziedziczone po TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)

Zwraca czy ten obiekt obsługuje właściwości, używając określonego kontekstu.Returns whether this object supports properties, using the specified context.

(Odziedziczone po TypeConverter)
GetStandardValues()

Zwraca kolekcję wartości standardowych z domyślnego kontekstu dla typu danych, dla którego zaprojektowano ten konwerter typów.Returns a collection of standard values from the default context for the data type this type converter is designed for.

(Odziedziczone po TypeConverter)
GetStandardValues(ITypeDescriptorContext)

Zwraca kolekcję wartości standardowych dla typu danych, który jest przeznaczony dla tego konwertera typów w przypadku podanego kontekstu formatu.Returns a collection of standard values for the data type this type converter is designed for when provided with a format context.

(Odziedziczone po TypeConverter)
GetStandardValuesExclusive()

Zwraca czy kolekcja wartości standardowych zwracana z GetStandardValues() jest listą wyłączną.Returns whether the collection of standard values returned from GetStandardValues() is an exclusive list.

(Odziedziczone po TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)

Zwraca czy kolekcja wartości standardowych zwracana z GetStandardValues() jest listą wykluczającą możliwych wartości przy użyciu określonego kontekstu.Returns whether the collection of standard values returned from GetStandardValues() is an exclusive list of possible values, using the specified context.

(Odziedziczone po TypeConverter)
GetStandardValuesSupported()

Zwraca czy ten obiekt obsługuje standardowy zestaw wartości, które można pobrać z listy.Returns whether this object supports a standard set of values that can be picked from a list.

(Odziedziczone po TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)

Zwraca czy ten obiekt obsługuje standardowy zestaw wartości, które można pobrać z listy przy użyciu określonego kontekstu.Returns whether this object supports a standard set of values that can be picked from a list, using the specified context.

(Odziedziczone po TypeConverter)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
IsValid(ITypeDescriptorContext, Object)

Zwraca czy dany obiekt wartości jest prawidłowy dla tego typu i dla określonego kontekstu.Returns whether the given value object is valid for this type and for the specified context.

(Odziedziczone po TypeConverter)
IsValid(Object)

Zwraca czy dany obiekt wartości jest prawidłowy dla tego typu.Returns whether the given value object is valid for this type.

(Odziedziczone po TypeConverter)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
SortProperties(PropertyDescriptorCollection, String[])

Sortuje kolekcję właściwości.Sorts a collection of properties.

(Odziedziczone po TypeConverter)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy

Zobacz też