CodeDomProvider.GetLanguageFromExtension Method (String)

 

Returns a language name associated with the specified file name extension, as configured in the CodeDomProvider compiler configuration section.

Namespace:   System.CodeDom.Compiler
Assembly:  System (in System.dll)

[<ComVisibleAttribute(false)>]
static member GetLanguageFromExtension : 
        extension:string -> string

Parameters

extension
Type: System.String

A file name extension.

Return Value

Type: System.String

A language name associated with the file name extension, as configured in the CodeDomProvider compiler configuration settings.

Exception Condition
ConfigurationException

The extension does not have a configured language provider on this computer.

ConfigurationErrorsException

The extension is null.

SecurityException

The caller does not have the required permission.

The <system.codedom> Element in the machine configuration file (Machine.config) contains the language provider and compiler configuration settings for each CodeDomProvider implementation on the computer. The GetLanguageFromExtension method searches each provider configuration element for the specified file name extension.

The IsDefinedExtension method checks whether at least one provider implementation supports a specific file name extension. You can validate a file name extension using IsDefinedExtension before passing it to GetLanguageFromExtension. This prevents GetLanguageFromExtension from throwing a System.Configuration.ConfigurationException for an unsupported file name extension.

If a provider implementation supports the input file name extension, and there are multiple supported languages configured for that provider, then GetLanguageFromExtension returns the first language name for that provider. If more than one provider implementation is configured for the input file name extension, GetLanguageFromExtension returns the language name from the last matching provider configuration element.

Language names and file name extensions are case-insensitive.

The following code example determines the CodeDomProvider implementation for an input file name extension and displays the configured settings for the language provider. This code example is part of a larger example provided for the CompilerInfo class.

No code example is currently available or this language may not be supported.

SecurityAction.LinkDemand

for full trust for the immediate caller. This member cannot be used by partially trusted code.

.NET Framework
Available since 2.0
Return to top
Show: