GenericEnumConverter Třída

Definice

Obor názvů:

System.Configuration

Sestavení:

System.Configuration.ConfigurationManager.dll

Balíček:

System.Configuration.ConfigurationManager v8.0.0

Zdroj:

GenericEnumConverter.cs

Převede mezi řetězcem a typem výčtu.

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

Dědičnost

Object

TypeConverter

ConfigurationConverterBase

GenericEnumConverter

Příklady

Následující příklad kódu ukazuje, jak získat přístup k vlastnosti vlastního oddílu GenericEnumConverter , která používá typ.

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

Následující příklad kódu ukazuje, jak definovat vlastní vlastnost enumerátoru, ke které se přistupuje v předchozím příkladu. Všimněte si, že není nutné zadávat GenericEnumConverter typ, protože je implicitně vyvolán systémem.

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

Následující příklad je výňatek z konfigurace použitý v předchozím příkladu.

<?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>  

Poznámky

Tento typ, stejně jako všechny ostatní typy převaděčů konfigurace, převede řetězce nalezené v konfiguračním souboru na a z souvisejících vlastností silného typu.

Objekt konkrétně GenericEnumConverter převede hodnotu přiřazenou String ke konfigurační vlastnosti na Enum hodnotu a naopak.

Konstruktory

GenericEnumConverter(Type)

Inicializuje novou instanci GenericEnumConverter třídy.

Metody

CanConvertFrom(ITypeDescriptorContext, Type)	Určuje, zda je povolen převod. (Zděděno od ConfigurationConverterBase)
CanConvertFrom(Type)	Vrátí, zda tento převaděč může převést objekt daného typu na typ tohoto převaděče. (Zděděno od TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Určuje, zda je povolen převod. (Zděděno od ConfigurationConverterBase)
CanConvertTo(Type)	Vrátí, zda tento převaděč může převést objekt na zadaný typ. (Zděděno od TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Převede objekt na StringEnum typ.
ConvertFrom(Object)	Převede danou hodnotu na typ tohoto převaděče. (Zděděno od TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Převede daný řetězec na typ tohoto převaděče pomocí invariantní jazykové verze a zadaného kontextu. (Zděděno od TypeConverter)
ConvertFromInvariantString(String)	Převede daný řetězec na typ tohoto převaděče pomocí invariantní jazykové verze. (Zděděno od TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Převede daný text na objekt pomocí zadaného kontextu a informací o jazykové verzi. (Zděděno od TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Převede daný text na objekt pomocí zadaného kontextu. (Zděděno od TypeConverter)
ConvertFromString(String)	Převede zadaný text na objekt. (Zděděno od TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Převede Enum typ na String hodnotu.
ConvertTo(Object, Type)	Převede daný objekt hodnoty na zadaný typ pomocí argumentů. (Zděděno od TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Převede zadanou hodnotu na reprezentaci řetězce invariantní jazykové verze pomocí zadaného kontextu. (Zděděno od TypeConverter)
ConvertToInvariantString(Object)	Převede zadanou hodnotu na reprezentaci řetězce invariantní jazykové verze. (Zděděno od TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Převede danou hodnotu na řetězcovou reprezentaci pomocí zadaného kontextu a informací o jazykové verzi. (Zděděno od TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Převede danou hodnotu na řetězcovou reprezentaci pomocí daného kontextu. (Zděděno od TypeConverter)
ConvertToString(Object)	Převede zadanou hodnotu na řetězcovou reprezentaci. (Zděděno od TypeConverter)
CreateInstance(IDictionary)	Znovu vytvoří Object danou sadu hodnot vlastností pro objekt. (Zděděno od TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Vytvoří instanci typu, ke kterému TypeConverter je přidružena, pomocí zadaného kontextu, vzhledem k sadě hodnot vlastností objektu. (Zděděno od TypeConverter)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetConvertFromException(Object)	Vrátí výjimku, která se má vyvolat, když nelze provést převod. (Zděděno od TypeConverter)
GetConvertToException(Object, Type)	Vrátí výjimku, která se má vyvolat, když nelze provést převod. (Zděděno od TypeConverter)
GetCreateInstanceSupported()	Vrátí, zda změna hodnoty v tomto objektu vyžaduje volání CreateInstance(IDictionary) metody k vytvoření nové hodnoty. (Zděděno od TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Vrátí, zda změna hodnoty v tomto objektu vyžaduje volání CreateInstance(IDictionary) k vytvoření nové hodnoty pomocí zadaného kontextu. (Zděděno od TypeConverter)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetProperties(ITypeDescriptorContext, Object)	Vrátí kolekci vlastností pro typ pole určený parametrem value pomocí zadaného kontextu. (Zděděno od TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Vrátí kolekci vlastností pro typ pole určený parametrem hodnoty pomocí zadaného kontextu a atributů. (Zděděno od TypeConverter)
GetProperties(Object)	Vrátí kolekci vlastností pro typ pole určený parametrem value. (Zděděno od TypeConverter)
GetPropertiesSupported()	Vrátí, zda tento objekt podporuje vlastnosti. (Zděděno od TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Vrátí, zda tento objekt podporuje vlastnosti pomocí zadaného kontextu. (Zděděno od TypeConverter)
GetStandardValues()	Vrátí kolekci standardních hodnot z výchozího kontextu pro datový typ, pro který je tento převaděč typů určen. (Zděděno od TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Vrátí kolekci standardních hodnot pro datový typ, pro který je tento převaděč typů určen, pokud je k dispozici s kontextem formátu. (Zděděno od TypeConverter)
GetStandardValuesExclusive()	Vrátí, zda je kolekce standardních hodnot vrácená z GetStandardValues() výhradního seznamu. (Zděděno od TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Vrátí, zda kolekce standardních hodnot vrácených z GetStandardValues() je výhradním seznamem možných hodnot pomocí zadaného kontextu. (Zděděno od TypeConverter)
GetStandardValuesSupported()	Vrátí, zda tento objekt podporuje standardní sadu hodnot, které lze vybrat ze seznamu. (Zděděno od TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Vrátí, zda tento objekt podporuje standardní sadu hodnot, které lze vybrat ze seznamu pomocí zadaného kontextu. (Zděděno od TypeConverter)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
IsValid(ITypeDescriptorContext, Object)	Vrátí, zda je daný objekt hodnoty platný pro tento typ a pro zadaný kontext. (Zděděno od TypeConverter)
IsValid(Object)	Vrátí, zda je daný objekt hodnoty platný pro tento typ. (Zděděno od TypeConverter)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
SortProperties(PropertyDescriptorCollection, String[])	Seřadí kolekci vlastností. (Zděděno od TypeConverter)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• InfiniteIntConverter
• InfiniteTimeSpanConverter
• TimeSpanMinutesOrInfiniteConverter
• TimeSpanSecondsConverter
• TimeSpanSecondsOrInfiniteConverter
• TypeNameConverter
• WhiteSpaceTrimStringConverter