CodeDomProvider.GetLanguageFromExtension(String) Метод

Определение

Пространство имен:

System.CodeDom.Compiler

Сборка:

System.CodeDom.dll

Пакет:

System.CodeDom v8.0.0

Исходный код:

CodeDomProvider.cs

Возвращает имя языка, связанное с определенным расширением имени файла, как настроено в разделе конфигурации компилятора CodeDomProvider.

public:
 static System::String ^ GetLanguageFromExtension(System::String ^ extension);

public static string GetLanguageFromExtension (string extension);

static member GetLanguageFromExtension : string -> string

Public Shared Function GetLanguageFromExtension (extension As String) As String

Параметры

extension

String

Расширение имени файла.

Возвращаемое значение

String

Имя языка, связанное с определенным расширением имени файла, как настроено в параметрах конфигурации компилятора CodeDomProvider.

Исключения

ConfigurationException

Для языка, заданного в параметре extension, на данном компьютере не настроен поставщик языка.

ConfigurationErrorsException

Значение параметра extension — null.

SecurityException

У вызывающего объекта отсутствует необходимое разрешение.

Примеры

В следующем примере кода определяется CodeDomProvider реализация для входного расширения имени файла и отображаются настроенные параметры для поставщика языка. Этот пример входит в состав более крупного примера использования класса CompilerInfo.

if (  !fileExtension->StartsWith(  "." ) )
   fileExtension = String::Concat( ".", fileExtension );

// Get the language associated with the file extension.
CodeDomProvider^ provider = nullptr;
if ( CodeDomProvider::IsDefinedExtension( fileExtension ) )
{
   String^ language = CodeDomProvider::GetLanguageFromExtension( fileExtension );
   if ( language )
      Console::WriteLine( "The language \"{0}\" is associated with file extension \"{1}\"\n",
                           language, fileExtension );

   // Check for a corresponding language provider.
   if ( language && CodeDomProvider::IsDefinedLanguage( language ) )
   {
      provider = CodeDomProvider::CreateProvider( language );
      if ( provider )
      {
         // Display information about this language provider.
         Console::WriteLine( "Language provider:  {0}\n", provider->ToString() );
         
         // Get the compiler settings for this language.
         CompilerInfo^ langCompilerInfo = CodeDomProvider::GetCompilerInfo( language );
         if ( langCompilerInfo )
         {
            CompilerParameters^ langCompilerConfig = langCompilerInfo->CreateDefaultCompilerParameters();
            if ( langCompilerConfig )
            {
               Console::WriteLine( "  Compiler options:        {0}", langCompilerConfig->CompilerOptions );
               Console::WriteLine( "  Compiler warning level:  {0}", langCompilerConfig->WarningLevel.ToString() );
            }
         }
      }
   }
}

if ( provider == nullptr )  // Tell the user that the language provider was not found.
   Console::WriteLine( "There is no language provider associated with input file extension \"{0}\".", fileExtension );

if (fileExtension[0] != '.')
{
    fileExtension = "." + fileExtension;
}

// Get the language associated with the file extension.
if (CodeDomProvider.IsDefinedExtension(fileExtension))
{
    CodeDomProvider provider;
    String language = CodeDomProvider.GetLanguageFromExtension(fileExtension);

    Console.WriteLine("The language \"{0}\" is associated with file extension \"{1}\"",
        language, fileExtension);
    Console.WriteLine();

    // Next, check for a corresponding language provider.

    if (CodeDomProvider.IsDefinedLanguage(language))
    {
        provider = CodeDomProvider.CreateProvider(language);

        // Display information about this language provider.

        Console.WriteLine("Language provider:  {0}",
            provider.ToString());
        Console.WriteLine();

        // Get the compiler settings for this language.

        CompilerInfo langCompilerInfo = CodeDomProvider.GetCompilerInfo(language);
        CompilerParameters langCompilerConfig = langCompilerInfo.CreateDefaultCompilerParameters();

        Console.WriteLine("  Compiler options:        {0}",
            langCompilerConfig.CompilerOptions);
        Console.WriteLine("  Compiler warning level:  {0}",
            langCompilerConfig.WarningLevel);
    }
}
else
{
    // Tell the user that the language provider was not found.
    Console.WriteLine("There is no language provider associated with input file extension \"{0}\".",
        fileExtension);
}

If Not fileExtension.StartsWith(".") Then
   fileExtension = "." + fileExtension
End If

' Get the language associated with the file extension.
If CodeDomProvider.IsDefinedExtension(fileExtension) Then
   Dim provider As CodeDomProvider
   Dim language As String = CodeDomProvider.GetLanguageFromExtension(fileExtension)
   
   Console.WriteLine("The language ""{0}"" is associated with file extension ""{1}""", _
       language, fileExtension)
   Console.WriteLine()
   
   ' Check for a corresponding language provider.
   If CodeDomProvider.IsDefinedLanguage(language) Then
      provider = CodeDomProvider.CreateProvider(language)
      
      ' Display information about this language provider.
      Console.WriteLine("Language provider:  {0}", _
         provider.ToString())
      Console.WriteLine()
      
      ' Get the compiler settings for this language.
      Dim langCompilerInfo As CompilerInfo = CodeDomProvider.GetCompilerInfo(language)
      Dim langCompilerConfig As CompilerParameters = langCompilerInfo.CreateDefaultCompilerParameters()
      
      Console.WriteLine("  Compiler options:        {0}", _
          langCompilerConfig.CompilerOptions)
      Console.WriteLine("  Compiler warning level:  {0}", _
          langCompilerConfig.WarningLevel)
   End If
Else
   ' Tell the user that the language provider was not found.
   Console.WriteLine("There is no language provider associated with input file extension ""{0}"".", fileExtension)
End If

Комментарии

Элемент< system.codedom> в файле конфигурации компьютера (Machine.config) содержит параметры конфигурации поставщика языка и компилятора для каждой CodeDomProvider реализации на компьютере. Метод GetLanguageFromExtension выполняет поиск указанного расширения имени файла в каждом элементе конфигурации поставщика.

Метод IsDefinedExtension проверяет, поддерживает ли хотя бы одна реализация поставщика определенное расширение имени файла. Вы можете проверить расширение имени файла с помощью IsDefinedExtension перед его передачей в GetLanguageFromExtension. Это предотвращает GetLanguageFromExtension исключение System.Configuration.ConfigurationException для неподдерживаемого расширения имени файла.

Если реализация поставщика поддерживает расширение имени входного файла и для этого поставщика настроено несколько поддерживаемых языков, возвращает GetLanguageFromExtension имя первого языка для этого поставщика. Если для расширения имени входного файла настроено несколько реализаций поставщика, GetLanguageFromExtension возвращает имя языка из последнего соответствующего элемента конфигурации поставщика.

В именах языков и расширениях имен файлов регистр не учитывается.

См. также раздел

• IsDefinedExtension(String)
• CreateProvider(String)
• Схема параметров компилятора и поставщика языка