InfiniteTimeSpanConverter Classe

Definição

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacote:

System.Configuration.ConfigurationManager v8.0.0

Origem:

InfiniteTimeSpanConverter.cs

Converte entre uma cadeia de caracteres e o valor infinite padrão de TimeSpan.

public ref class InfiniteTimeSpanConverter sealed : System::Configuration::ConfigurationConverterBase

public sealed class InfiniteTimeSpanConverter : System.Configuration.ConfigurationConverterBase

type InfiniteTimeSpanConverter = class
    inherit ConfigurationConverterBase

Public NotInheritable Class InfiniteTimeSpanConverter
Inherits ConfigurationConverterBase

Herança

Object

TypeConverter

ConfigurationConverterBase

InfiniteTimeSpanConverter

Exemplos

O exemplo de código a seguir mostra como definir uma propriedade de seção personalizada que usa a InfiniteTimeSpanConverter classe .

Para obter o código de exemplo completo que implementa a seção personalizada, consulte a ConfigurationConverterBase classe .

[ConfigurationProperty("timeDelay", 
    DefaultValue = "infinite")]
[TypeConverter(typeof(InfiniteTimeSpanConverter))]
public TimeSpan TimeDelay
{
    get
    {
        return (TimeSpan)this["timeDelay"];
    }
    set
    {
        this["timeDelay"] = value;
    }
}

<ConfigurationProperty("timeDelay", _
DefaultValue:="infinite"), _
TypeConverter(GetType(InfiniteTimeSpanConverter))> _
Public Property TimeDelay() As TimeSpan
    Get
        Return CType(Me("timeDelay"), TimeSpan)
    End Get
    Set(ByVal value As TimeSpan)
        Me("timeDelay") = Value
    End Set
End Property

O código de exemplo a seguir mostra como acessar a propriedade de seção personalizada anterior.

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

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

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

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

                TimeSpan td = 
                    new TimeSpan();

                td =
                    TimeSpan.FromMinutes(
                    DateTime.Now.Minute);

                section.TimeDelay = td;

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

                Console.WriteLine("timeDelay: {0}",
                    section.TimeDelay.ToString());
            }
            catch (System.Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }
    }
}

Imports System.IO
Imports System.ComponentModel
Imports System.Configuration


NotInheritable Public Class UsingInfiniteTimeSpanConverter
    
    Public Shared Sub GetTimeDelay() 
        Try
            Dim section As CustomSection = _
            ConfigurationManager.GetSection( _
            "CustomSection")
            Console.WriteLine("timeDelay: {0}", _
            section.TimeDelay.ToString())
        Catch e As System.Exception
            Console.WriteLine(e.Message)
        End Try
    
    End Sub
    
    
    Public Shared Sub SetTimeDelay() 
        Try
            Dim config _
            As System.Configuration.Configuration = _
            ConfigurationManager.OpenExeConfiguration( _
            ConfigurationUserLevel.None)
            
            Dim section As CustomSection = _
            config.Sections.Get("CustomSection")
            
            Dim td As New TimeSpan()
            
            td = _
            TimeSpan.FromMinutes( _
            DateTime.Now.Minute)
            
            section.TimeDelay = td
            
            section.SectionInformation.ForceSave = True
            config.Save(ConfigurationSaveMode.Full)
            config.Save()
            
            Console.WriteLine("timeDelay: {0}", _
            section.TimeDelay.ToString())
        Catch e As System.Exception
            Console.WriteLine(e.Message)
        End Try
    
    End Sub
End Class

Veja a seguir um trecho de configuração, conforme usado pelo exemplo anterior.

<?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"/>  
</configuration>  

Comentários

Esse tipo, como todos os outros tipos de conversor de configuração, converte cadeias de caracteres encontradas no arquivo de configuração de e para as propriedades fortemente tipados relacionadas.

Em particular, o InfiniteTimeSpanConverter converte o String valor "infinito" atribuído a uma propriedade de configuração para o infinito TimeSpan padrão e vice-versa. O valor infinito TimeSpan é representado pelo valor de MaxValue enumeração.

Esse conversor é usado com TimeSpan propriedades. Um valor infinito é persistente como a cadeia de caracteres "infinita".

Construtores

InfiniteTimeSpanConverter()

Inicializa uma nova instância da classe InfiniteTimeSpanConverter.

Métodos

CanConvertFrom(ITypeDescriptorContext, Type)	Determina se a conversão é permitida. (Herdado de ConfigurationConverterBase)
CanConvertFrom(Type)	Retorna se este conversor pode converter um objeto do tipo indicado para o tipo deste conversor. (Herdado de TypeConverter)
CanConvertTo(ITypeDescriptorContext, Type)	Determina se a conversão é permitida. (Herdado de ConfigurationConverterBase)
CanConvertTo(Type)	Retorna se esse conversor pode converter o objeto para o tipo especificado. (Herdado de TypeConverter)
ConvertFrom(ITypeDescriptorContext, CultureInfo, Object)	Converte uma String em uma TimeSpan.
ConvertFrom(Object)	Converte o valor fornecido noo tipo deste conversor. (Herdado de TypeConverter)
ConvertFromInvariantString(ITypeDescriptorContext, String)	Converte a cadeia de caracteres fornecida para o tipo deste conversor usando a cultura invariável e o contexto especificado. (Herdado de TypeConverter)
ConvertFromInvariantString(String)	Converte a cadeia de caracteres fornecida para o tipo deste conversor usando a cultura invariável. (Herdado de TypeConverter)
ConvertFromString(ITypeDescriptorContext, CultureInfo, String)	Converte o texto fornecido em um objeto, usando o contexto e a informação de cultura especificados. (Herdado de TypeConverter)
ConvertFromString(ITypeDescriptorContext, String)	Converte o texto fornecido em um objeto, usando o contexto especificado. (Herdado de TypeConverter)
ConvertFromString(String)	Converte o texto especificado em um objeto. (Herdado de TypeConverter)
ConvertTo(ITypeDescriptorContext, CultureInfo, Object, Type)	Converte uma TimeSpan em uma String.
ConvertTo(Object, Type)	Converte o objeto de valor especificado para o tipo especificado, usando os argumentos. (Herdado de TypeConverter)
ConvertToInvariantString(ITypeDescriptorContext, Object)	Converte o valor especificado em uma representação de cadeia de caracteres que não varia de acordo com a cultura, usando o contexto especificado. (Herdado de TypeConverter)
ConvertToInvariantString(Object)	Converte o valor especificado em uma representação de cadeia de caracteres invariável da cultura. (Herdado de TypeConverter)
ConvertToString(ITypeDescriptorContext, CultureInfo, Object)	Converte o valor especificado em uma representação de cadeia de caracteres, usando as informações de contexto e cultura especificadas. (Herdado de TypeConverter)
ConvertToString(ITypeDescriptorContext, Object)	Converte o valor especificado em uma representação de cadeia de caracteres, usando o contexto fornecido. (Herdado de TypeConverter)
ConvertToString(Object)	Converte o valor especificado em uma representação de cadeia de caracteres. (Herdado de TypeConverter)
CreateInstance(IDictionary)	Recria um Object dado um conjunto de valores de propriedade do objeto. (Herdado de TypeConverter)
CreateInstance(ITypeDescriptorContext, IDictionary)	Cria uma instância do tipo ao qual esse TypeConverter está associado, usando o contexto especificado, dado um conjunto de valores de propriedade para o objeto. (Herdado de TypeConverter)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetConvertFromException(Object)	Retorna uma exceção a ser gerada quando uma conversão não puder ser executada. (Herdado de TypeConverter)
GetConvertToException(Object, Type)	Retorna uma exceção a ser gerada quando uma conversão não puder ser executada. (Herdado de TypeConverter)
GetCreateInstanceSupported()	Retorna se a alteração de um valor neste objeto requer uma chamada ao método CreateInstance(IDictionary) para criar um novo valor. (Herdado de TypeConverter)
GetCreateInstanceSupported(ITypeDescriptorContext)	Retorna se a alteração de um valor neste objeto requer uma chamada para CreateInstance(IDictionary) para criar um novo valor, usando o contexto especificado. (Herdado de TypeConverter)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetProperties(ITypeDescriptorContext, Object)	Retorna uma coleção de propriedades para o tipo de matriz especificado pelo parâmetro de valor, usando o contexto especificado. (Herdado de TypeConverter)
GetProperties(ITypeDescriptorContext, Object, Attribute[])	Retorna uma coleção de propriedades para o tipo de matriz especificado pelo parâmetro de valor, usando o contexto e os atributos especificados. (Herdado de TypeConverter)
GetProperties(Object)	Retorna uma coleção de propriedades para o tipo de matriz especificado pelo parâmetro de valor. (Herdado de TypeConverter)
GetPropertiesSupported()	Retorna se este objeto dá suporte a propriedades. (Herdado de TypeConverter)
GetPropertiesSupported(ITypeDescriptorContext)	Retorna se este objeto é compatível com as propriedades, usando o contexto especificado. (Herdado de TypeConverter)
GetStandardValues()	Retorna uma coleção de valores padrão do contexto padrão para o tipo de dados para o qual esse conversor de tipo foi criado. (Herdado de TypeConverter)
GetStandardValues(ITypeDescriptorContext)	Retorna uma coleção de valores padrão para o tipo de dados para o qual esse conversor de tipo foi criado quando fornecido com um contexto de formato. (Herdado de TypeConverter)
GetStandardValuesExclusive()	Retorna se a coleção de valores padrão retornada de GetStandardValues() é uma lista exclusiva. (Herdado de TypeConverter)
GetStandardValuesExclusive(ITypeDescriptorContext)	Retorna se a coleção de valores padrão retornada de GetStandardValues() é uma lista exclusiva de possíveis valores, usando o contexto especificado. (Herdado de TypeConverter)
GetStandardValuesSupported()	Retorna se este objeto dá suporte a um conjunto padrão de valores que podem ser escolhidos em uma lista. (Herdado de TypeConverter)
GetStandardValuesSupported(ITypeDescriptorContext)	Retorna se o objeto dá suporte a um conjunto de valores padrão que podem ser escolhidos de uma lista, usando o contexto especificado. (Herdado de TypeConverter)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsValid(ITypeDescriptorContext, Object)	Retorna se o objeto de valor fornecido é válido para esse tipo e para o contexto especificado. (Herdado de TypeConverter)
IsValid(Object)	Retorna se o objeto de valor especificado é válido para esse tipo. (Herdado de TypeConverter)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
SortProperties(PropertyDescriptorCollection, String[])	Classifica uma coleção de propriedades. (Herdado de TypeConverter)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• GenericEnumConverter
• InfiniteIntConverter
• TimeSpanMinutesConverter
• TimeSpanMinutesOrInfiniteConverter
• TimeSpanSecondsConverter
• TimeSpanSecondsOrInfiniteConverter
• TypeNameConverter
• WhiteSpaceTrimStringConverter