GenericEnumConverter Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Konwertuje między ciągiem a typem wyliczenia.
public ref class GenericEnumConverter sealed : System::Configuration::ConfigurationConverterBasepublic sealed class GenericEnumConverter : System.Configuration.ConfigurationConverterBasetype GenericEnumConverter = class
inherit ConfigurationConverterBasePublic 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.
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
W poniższym przykładzie kodu pokazano, jak zdefiniować niestandardową właściwość modułu wyliczającego dostępną w poprzednim przykładzie. Zwróć uwagę, że nie ma potrzeby określania GenericEnumConverter typu ; jest ona niejawnie wywoływana przez 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 to fragment konfiguracji używany w poprzednim przykładzie.
<?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 znalezione w pliku konfiguracji na i z powiązanych silnie typiowanych właściwości.
W szczególności GenericEnumConverter obiekt konwertuje String wartość przypisaną do właściwości konfiguracji na Enum wartość i odwrotnie.
Konstruktory
| GenericEnumConverter(Type) |
Inicjuje nowe wystąpienie klasy GenericEnumConverter. |
Metody
| CanConvertFrom(ITypeDescriptorContext, Type) |
Określa, czy konwersja jest dozwolona. (Odziedziczone po ConfigurationConverterBase) |
| CanConvertFrom(Type) |
Zwraca, czy ten konwerter może przekonwertować obiekt danego typu na typ tego konwertera. (Odziedziczone po TypeConverter) |
| CanConvertTo(ITypeDescriptorContext, Type) |
Określa, czy konwersja jest dozwolona. (Odziedziczone po ConfigurationConverterBase) |
| CanConvertTo(Type) |
Zwraca, czy ten konwerter może przekonwertować obiekt na określony typ. (Odziedziczone po TypeConverter) |
| ConvertFrom(ITypeDescriptorContext, CultureInfo, Object) | |
| ConvertFrom(Object) |
Konwertuje daną wartość na typ tego konwertera. (Odziedziczone po TypeConverter) |
| ConvertFromInvariantString(ITypeDescriptorContext, String) |
Konwertuje dany ciąg na typ tego konwertera przy użyciu niezmiennej kultury i określonego kontekstu. (Odziedziczone po TypeConverter) |
| ConvertFromInvariantString(String) |
Konwertuje dany ciąg na typ tego konwertera przy użyciu niezmiennej kultury. (Odziedziczone po TypeConverter) |
| ConvertFromString(ITypeDescriptorContext, CultureInfo, String) |
Konwertuje dany tekst na obiekt przy użyciu określonego kontekstu i informacji o kulturze. (Odziedziczone po TypeConverter) |
| ConvertFromString(ITypeDescriptorContext, String) |
Konwertuje dany tekst na obiekt przy użyciu określonego kontekstu. (Odziedziczone po TypeConverter) |
| ConvertFromString(String) |
Konwertuje określony tekst na obiekt. (Odziedziczone po TypeConverter) |
| ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type) | |
| ConvertTo(Object, Type) |
Konwertuje dany obiekt wartości na określony typ przy użyciu argumentów. (Odziedziczone po TypeConverter) |
| ConvertToInvariantString(ITypeDescriptorContext, Object) |
Konwertuje określoną wartość na niezmienną reprezentację ciągu kultury przy użyciu określonego kontekstu. (Odziedziczone po TypeConverter) |
| ConvertToInvariantString(Object) |
Konwertuje określoną wartość na niezmienną reprezentację ciągu kultury. (Odziedziczone po TypeConverter) |
| ConvertToString(ITypeDescriptorContext, CultureInfo, Object) |
Konwertuje daną wartość na reprezentację ciągu przy użyciu określonego kontekstu i informacji o kulturze. (Odziedziczone po TypeConverter) |
| ConvertToString(ITypeDescriptorContext, Object) |
Konwertuje daną wartość na reprezentację ciągu przy użyciu danego kontekstu. (Odziedziczone po TypeConverter) |
| ConvertToString(Object) |
Konwertuje określoną wartość na reprezentację ciągu. (Odziedziczone po TypeConverter) |
| CreateInstance(IDictionary) |
Ponownie tworzy Object zestaw wartości właściwości dla obiektu. (Odziedziczone po TypeConverter) |
| CreateInstance(ITypeDescriptorContext, IDictionary) |
Tworzy wystąpienie typu skojarzonego TypeConverter z określonym kontekstem, biorąc pod uwagę zestaw wartości właściwości dla obiektu. (Odziedziczone po TypeConverter) |
| Equals(Object) |
Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object) |
| GetConvertFromException(Object) |
Zwraca wyjątek zgłaszany, gdy nie można wykonać konwersji. (Odziedziczone po TypeConverter) |
| GetConvertToException(Object, Type) |
Zwraca wyjątek zgłaszany, gdy nie można wykonać konwersji. (Odziedziczone po TypeConverter) |
| GetCreateInstanceSupported() |
Zwraca, czy zmiana wartości w tym obiekcie wymaga wywołania CreateInstance(IDictionary) metody w celu utworzenia nowej wartości. (Odziedziczone po TypeConverter) |
| GetCreateInstanceSupported(ITypeDescriptorContext) |
Zwraca, czy zmiana wartości w tym obiekcie wymaga wywołania w celu CreateInstance(IDictionary) utworzenia nowej wartości przy użyciu określonego kontekstu. (Odziedziczone po TypeConverter) |
| GetHashCode() |
Służy jako domyślna funkcja skrótu. (Odziedziczone po Object) |
| GetProperties(ITypeDescriptorContext, Object) |
Zwraca kolekcję właściwości dla typu tablicy określonej przez parametr value przy użyciu określonego kontekstu. (Odziedziczone po TypeConverter) |
| GetProperties(ITypeDescriptorContext, Object, Attribute[]) |
Zwraca kolekcję właściwości dla typu tablicy określonej przez parametr value przy użyciu określonego kontekstu i atrybutów. (Odziedziczone po TypeConverter) |
| GetProperties(Object) |
Zwraca kolekcję właściwości dla typu tablicy określonej przez parametr value. (Odziedziczone po TypeConverter) |
| GetPropertiesSupported() |
Zwraca informację, czy ten obiekt obsługuje właściwości. (Odziedziczone po TypeConverter) |
| GetPropertiesSupported(ITypeDescriptorContext) |
Zwraca, czy ten obiekt obsługuje właściwości przy użyciu określonego kontekstu. (Odziedziczone po TypeConverter) |
| GetStandardValues() |
Zwraca kolekcję wartości standardowych z domyślnego kontekstu dla typu danych, dla których ten konwerter typów jest przeznaczony. (Odziedziczone po TypeConverter) |
| GetStandardValues(ITypeDescriptorContext) |
Zwraca kolekcję wartości standardowych dla typu danych, dla których ten konwerter typów jest przeznaczony w przypadku, gdy jest dostarczany z kontekstem formatu. (Odziedziczone po TypeConverter) |
| GetStandardValuesExclusive() |
Zwraca, czy kolekcja wartości standardowych zwracanych z GetStandardValues() listy jest listą wyłączną. (Odziedziczone po TypeConverter) |
| GetStandardValuesExclusive(ITypeDescriptorContext) |
Zwraca, czy kolekcja wartości standardowych zwracanych z GetStandardValues() funkcji jest wyłączną listą możliwych wartości przy użyciu określonego kontekstu. (Odziedziczone po TypeConverter) |
| GetStandardValuesSupported() |
Zwraca informację, czy ten obiekt obsługuje standardowy zestaw wartości, które można wybrać z listy. (Odziedziczone po TypeConverter) |
| GetStandardValuesSupported(ITypeDescriptorContext) |
Zwraca informację, czy ten obiekt obsługuje standardowy zestaw wartości, które można wybrać z listy przy użyciu określonego kontekstu. (Odziedziczone po TypeConverter) |
| GetType() |
Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object) |
| IsValid(ITypeDescriptorContext, Object) |
Zwraca, czy dany obiekt wartości jest prawidłowy dla tego typu i dla określonego kontekstu. (Odziedziczone po TypeConverter) |
| IsValid(Object) |
Zwraca, czy dany obiekt wartości jest prawidłowy dla tego typu. (Odziedziczone po TypeConverter) |
| MemberwiseClone() |
Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object) |
| SortProperties(PropertyDescriptorCollection, String[]) |
Sortuje kolekcję właściwości. (Odziedziczone po TypeConverter) |
| ToString() |
Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object) |
