This documentation is archived and is not being maintained.

TypeNameConverter Class

Converts between type and string values. This class cannot be inherited.

Namespace: System.Configuration
Assembly: System.Configuration (in system.configuration.dll)

public sealed class TypeNameConverter : ConfigurationConverterBase
public final class TypeNameConverter extends ConfigurationConverterBase
public final class TypeNameConverter extends ConfigurationConverterBase
Not applicable.

This type, like all the other configuration converter types, converts strings found in the configuration file to and from the related strongly typed properties.

In particular, the TypeNameConverter class converts a String value, assigned to a configuration type, to a Type value and vice versa. The type referred to is the class responsible for processing the configuration it is associated with.

The following example shows how to obtain a type associated with a custom section. For the implementation of the custom section, refer to the code example in the ConfigurationConverterBase class reference.

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

namespace Samples.AspNet
{
  
    public sealed class UsingTypeNameConverter
    {
        public static void GetTypeName()
        {
            try
            {
           
                CustomSection section =
                    ConfigurationManager.GetSection("CustomSection")
                    as CustomSection;

                Console.WriteLine("CustomSection type: {0}",
                    section);
            }
            catch (System.Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }

    }
}

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>

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0
Show: