CompilerInfo Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje nastavení konfigurace poskytovatele jazyka. Tuto třídu nelze zdědit.
public ref class CompilerInfo sealedpublic sealed class CompilerInfotype CompilerInfo = classPublic NotInheritable Class CompilerInfo- Dědičnost
-
CompilerInfo
Příklady
Následující příklad kódu zobrazí nastavení konfigurace zprostředkovatele jazyka. Argumenty příkazového řádku slouží k určení jazyka, přípony názvu souboru nebo typu zprostředkovatele. Pro daný vstup příklad určuje odpovídajícího zprostředkovatele jazyka a zobrazí nastavení nakonfigurovaného kompilátoru jazyka.
// Command-line argument examples:
// - Displays Visual Basic, C#, and JScript compiler settings.
// <exe_name> Language CSharp
// - Displays the compiler settings for C#.
// <exe_name> All
// - Displays settings for all configured compilers.
// <exe_name> Config Pascal
// - Displays settings for configured Pascal language provider,
// if one exists.
// <exe_name> Extension .vb
// - Displays settings for the compiler associated with the .vb
// file extension.
using System;
using System.Globalization;
using System.CodeDom;
using System.CodeDom.Compiler;
using Microsoft.CSharp;
using Microsoft.VisualBasic;
namespace CodeDomCompilerInfoSample
{
class CompilerInfoSample
{
[STAThread]
static void Main(string[] args)
{
String queryCommand = "";
String queryArg = "";
int iNumArguments = args.Length;
// Get input command-line arguments.
if (iNumArguments > 0)
{
queryCommand = args[0].ToUpper(CultureInfo.InvariantCulture);
if (iNumArguments > 1)
{
queryArg = args[1];
}
}
// Determine which method to call.
Console.WriteLine();
switch(queryCommand)
{
case ("LANGUAGE"):
// Display compiler information for input language.
DisplayCompilerInfoForLanguage(queryArg);
break;
case ("EXTENSION"):
// Display compiler information for input file extension.
DisplayCompilerInfoUsingExtension(queryArg);
break;
case ("CONFIG"):
// Display settings for the configured language provider.
DisplayCompilerInfoForConfigLanguage(queryArg);
break;
case ("ALL"):
// Display compiler information for all configured
// language providers.
DisplayAllCompilerInfo();
break;
default:
// There was no command-line argument, or the
// command-line argument was not recognized.
// Display the C#, Visual Basic and JScript
// compiler information.
DisplayCSharpCompilerInfo();
DisplayVBCompilerInfo();
DisplayJScriptCompilerInfo();
break;
}
}
static void DisplayCSharpCompilerInfo()
{
// Get the provider for Microsoft.CSharp
CodeDomProvider provider = CodeDomProvider.CreateProvider("CSharp");
// Display the C# language provider information.
Console.WriteLine("CSharp provider is {0}",
provider.ToString());
Console.WriteLine(" Provider hash code: {0}",
provider.GetHashCode().ToString());
Console.WriteLine(" Default file extension: {0}",
provider.FileExtension);
Console.WriteLine();
}
static void DisplayVBCompilerInfo()
{
// Get the provider for Microsoft.VisualBasic
CodeDomProvider provider = CodeDomProvider.CreateProvider("VisualBasic");
// Display the Visual Basic language provider information.
Console.WriteLine("Visual Basic provider is {0}",
provider.ToString());
Console.WriteLine(" Provider hash code: {0}",
provider.GetHashCode().ToString());
Console.WriteLine(" Default file extension: {0}",
provider.FileExtension);
Console.WriteLine();
}
static void DisplayJScriptCompilerInfo()
{
// Get the provider for JScript.
CodeDomProvider provider;
try
{
provider = CodeDomProvider.CreateProvider("js");
// Display the JScript language provider information.
Console.WriteLine("JScript language provider is {0}",
provider.ToString());
Console.WriteLine(" Provider hash code: {0}",
provider.GetHashCode().ToString());
Console.WriteLine(" Default file extension: {0}",
provider.FileExtension);
Console.WriteLine();
}
catch (System.Configuration.ConfigurationException)
{
// The JScript language provider was not found.
Console.WriteLine("There is no configured JScript language provider.");
}
}
static void DisplayCompilerInfoUsingExtension(string 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);
}
}
static void DisplayCompilerInfoForLanguage(string language)
{
CodeDomProvider provider;
// Check for a provider corresponding to the input language.
if (CodeDomProvider.IsDefinedLanguage(language))
{
provider = CodeDomProvider.CreateProvider(language);
// Display information about this language provider.
Console.WriteLine("Language provider: {0}",
provider.ToString());
Console.WriteLine();
Console.WriteLine(" Default file extension: {0}",
provider.FileExtension);
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 provider configured for input language \"{0}\".",
language);
}
}
static void DisplayCompilerInfoForConfigLanguage(string configLanguage)
{
CompilerInfo info = CodeDomProvider.GetCompilerInfo(configLanguage);
// Check whether there is a provider configured for this language.
if (info.IsCodeDomProviderTypeValid)
{
// Get a provider instance using the configured type information.
CodeDomProvider provider;
provider = (CodeDomProvider)Activator.CreateInstance(info.CodeDomProviderType);
// Display information about this language provider.
Console.WriteLine("Language provider: {0}",
provider.ToString());
Console.WriteLine();
Console.WriteLine(" Default file extension: {0}",
provider.FileExtension);
Console.WriteLine();
// Get the compiler settings for this language.
CompilerParameters langCompilerConfig = info.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 provider configured for input language \"{0}\".",
configLanguage);
}
}
static void DisplayAllCompilerInfo()
{
CompilerInfo [] allCompilerInfo = CodeDomProvider.GetAllCompilerInfo();
foreach (CompilerInfo info in allCompilerInfo)
{
String defaultLanguage;
String defaultExtension;
CodeDomProvider provider = info.CreateProvider();
// Display information about this configured provider.
Console.WriteLine("Language provider: {0}",
provider.ToString());
Console.WriteLine();
Console.WriteLine(" Supported file extension(s):");
foreach(String extension in info.GetExtensions())
{
Console.WriteLine(" {0}", extension);
}
defaultExtension = provider.FileExtension;
if (defaultExtension[0] != '.')
{
defaultExtension = "." + defaultExtension;
}
Console.WriteLine(" Default file extension: {0}",
defaultExtension);
Console.WriteLine();
Console.WriteLine(" Supported language(s):");
foreach(String language in info.GetLanguages())
{
Console.WriteLine(" {0}", language);
}
defaultLanguage = CodeDomProvider.GetLanguageFromExtension(defaultExtension);
Console.WriteLine(" Default language: {0}",
defaultLanguage);
Console.WriteLine();
// Get the compiler settings for this provider.
CompilerParameters langCompilerConfig = info.CreateDefaultCompilerParameters();
Console.WriteLine(" Compiler options: {0}",
langCompilerConfig.CompilerOptions);
Console.WriteLine(" Compiler warning level: {0}",
langCompilerConfig.WarningLevel);
Console.WriteLine();
}
}
}
}
' Command-line argument examples:
' - Displays Visual Basic, C#, and JScript compiler settings.
' <exe_name> Language CSharp
' - Displays the compiler settings for C#.
' <exe_name> All
' - Displays settings for all configured compilers.
' <exe_name> Config Pascal
' - Displays settings for configured Pascal language provider,
' if one exists.
' <exe_name> Extension .vb
' - Displays settings for the compiler associated with the .vb
' file extension.
Imports System.IO
Imports System.Globalization
Imports System.CodeDom
Imports System.CodeDom.Compiler
Imports Microsoft.CSharp
Imports System.ComponentModel
Namespace CodeDomCompilerInfoSample
Class CompilerInfoSample
<STAThread()> _
Public Shared Sub Main(ByVal args() As String)
Dim queryCommand As String = ""
Dim queryArg As String = ""
Dim iNumArguments As Integer = args.Length
' Get input command-line arguments.
If iNumArguments > 0 Then
queryCommand = args(0).ToUpper(CultureInfo.InvariantCulture)
If iNumArguments > 1 Then
queryArg = args(1)
End If
End If
' Determine which method to call.
Console.WriteLine()
Select Case queryCommand
Case "LANGUAGE"
' Display compiler information for input language.
DisplayCompilerInfoForLanguage(queryArg)
Case "EXTENSION"
' Display compiler information for input file extension.
DisplayCompilerInfoUsingExtension(queryArg)
Case "CONFIG"
' Display settings for the configured language provider.
DisplayCompilerInfoForConfigLanguage(queryArg)
Case "ALL"
' Display compiler information for all configured
' language providers.
DisplayAllCompilerInfo()
Case Else
' There was no command-line argument, or the
' command-line argument was not recognized.
' Display the C#, Visual Basic and JScript
' compiler information.
DisplayCSharpCompilerInfo()
DisplayVBCompilerInfo()
DisplayJScriptCompilerInfo()
End Select
End Sub
Shared Sub DisplayCSharpCompilerInfo()
' Get the provider for Microsoft.CSharp
Dim provider = CodeDomProvider.CreateProvider("CSharp")
' Display the C# language provider information.
Console.WriteLine("CSharp provider is {0}", _
provider.ToString())
Console.WriteLine(" Provider hash code: {0}", _
provider.GetHashCode().ToString())
Console.WriteLine(" Default file extension: {0}", _
provider.FileExtension)
Console.WriteLine()
End Sub
Shared Sub DisplayVBCompilerInfo()
' Get the provider for Microsoft.VisualBasic
Dim provider = CodeDomProvider.CreateProvider("VisualBasic")
' Display the Visual Basic language provider information.
Console.WriteLine("Visual Basic provider is {0}", _
provider.ToString())
Console.WriteLine(" Provider hash code: {0}", _
provider.GetHashCode().ToString())
Console.WriteLine(" Default file extension: {0}", _
provider.FileExtension)
Console.WriteLine()
End Sub
Shared Sub DisplayJScriptCompilerInfo()
' Get the provider for JScript.
Dim provider As CodeDomProvider
Try
provider = CodeDomProvider.CreateProvider("js")
' Display the JScript language provider information.
Console.WriteLine("JScript language provider is {0}", _
provider.ToString())
Console.WriteLine(" Provider hash code: {0}", _
provider.GetHashCode().ToString())
Console.WriteLine(" Default file extension: {0}", _
provider.FileExtension)
Console.WriteLine()
Catch e As System.Configuration.ConfigurationException
' The JScript language provider was not found.
Console.WriteLine("There is no configured JScript language provider.")
End Try
End Sub
Shared Sub DisplayCompilerInfoUsingExtension(fileExtension As String)
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
End Sub
Shared Sub DisplayCompilerInfoForLanguage(language As String)
Dim provider As CodeDomProvider
' Check for a provider corresponding to the input language.
If CodeDomProvider.IsDefinedLanguage(language) Then
provider = CodeDomProvider.CreateProvider(language)
' Display information about this language provider.
Console.WriteLine("Language provider: {0}", _
provider.ToString())
Console.WriteLine()
Console.WriteLine(" Default file extension: {0}", _
provider.FileExtension)
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)
Else
' Tell the user that the language provider was not found.
Console.WriteLine("There is no provider configured for input language ""{0}"".", _
language)
End If
End Sub
Shared Sub DisplayCompilerInfoForConfigLanguage(configLanguage As String)
Dim info As CompilerInfo = CodeDomProvider.GetCompilerInfo(configLanguage)
' Check whether there is a provider configured for this language.
If info.IsCodeDomProviderTypeValid Then
' Get a provider instance using the configured type information.
Dim provider As CodeDomProvider
provider = CType(Activator.CreateInstance(info.CodeDomProviderType), CodeDomProvider)
' Display information about this language provider.
Console.WriteLine("Language provider: {0}", _
provider.ToString())
Console.WriteLine()
Console.WriteLine(" Default file extension: {0}", _
provider.FileExtension)
Console.WriteLine()
' Get the compiler settings for this language.
Dim langCompilerConfig As CompilerParameters = info.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 provider configured for input language ""{0}"".", configLanguage)
End If
End Sub
Shared Sub DisplayAllCompilerInfo()
Dim allCompilerInfo As CompilerInfo() = CodeDomProvider.GetAllCompilerInfo()
Dim info As CompilerInfo
For Each info In allCompilerInfo
Dim defaultLanguage As String
Dim defaultExtension As String
Dim provider As CodeDomProvider = info.CreateProvider()
' Display information about this configured provider.
Console.WriteLine("Language provider: {0}", _
provider.ToString())
Console.WriteLine()
Console.WriteLine(" Supported file extension(s):")
Dim extension As String
For Each extension In info.GetExtensions()
Console.WriteLine(" {0}", extension)
Next extension
defaultExtension = provider.FileExtension
If Not defaultExtension.StartsWith(".") Then
defaultExtension = "." + defaultExtension
End If
Console.WriteLine(" Default file extension: {0}", _
defaultExtension)
Console.WriteLine()
Console.WriteLine(" Supported language(s):")
Dim language As String
For Each language In info.GetLanguages()
Console.WriteLine(" {0}", language)
Next language
defaultLanguage = CodeDomProvider.GetLanguageFromExtension(defaultExtension)
Console.WriteLine(" Default language: {0}", _
defaultLanguage)
Console.WriteLine()
' Get the compiler settings for this provider.
Dim langCompilerConfig As CompilerParameters = info.CreateDefaultCompilerParameters()
Console.WriteLine(" Compiler options: {0}", _
langCompilerConfig.CompilerOptions)
Console.WriteLine(" Compiler warning level: {0}", _
langCompilerConfig.WarningLevel)
Console.WriteLine()
Next info
End Sub
End Class
End Namespace 'CodeDomCompilerInfoSample
Poznámky
CompilerInfo Pomocí třídy můžete určit, zda CodeDomProvider je v počítači nakonfigurována implementace, nebo prozkoumat nastavení konfigurace a kompilátoru pro konkrétního zprostředkovatele jazyka.
Element< system.codedom> v konfiguračním souboru počítače obsahuje zprostředkovatele jazyka a nastavení konfigurace kompilátoru. Každý nakonfigurovaný zprostředkovatel jazyka má odpovídající element konfigurace kompilátoru. Každý prvek definuje CodeDomProvider typ implementace, podporované názvy jazyků, podporované přípony názvů souborů a parametry kompilátoru.
Rozhraní .NET definuje počáteční nastavení kompilátoru v konfiguračním souboru počítače. Vývojáři a dodavatelé kompilátoru můžou přidat nastavení konfigurace pro novou CodeDomProvider implementaci.
Třída CompilerInfo poskytuje přístup jen pro čtení k těmto nastavením v konfiguračním souboru počítače. Pomocí elementu GetLanguages, GetExtensionsa CodeDomProviderType členů prozkoumejte odpovídající atributy konfigurace pro zprostředkovatele jazyka. CreateDefaultCompilerParameters Pomocí metody získejte možnosti kompilátoru a hodnoty atributů na úrovni upozornění pro zprostředkovatele jazyka.
Další podrobnosti o nastavení zprostředkovatele jazyka v konfiguračním souboru naleznete v tématu Kompilátor a schéma nastavení zprostředkovatele jazyka.
Note
Tato třída obsahuje požadavek na propojení na úrovni třídy, která se vztahuje na všechny členy. Vyvolá SecurityException se, když bezprostřední volající nemá oprávnění k úplnému důvěryhodnosti.
Vlastnosti
| Name | Description |
|---|---|
| CodeDomProviderType |
Získá typ nakonfigurované CodeDomProvider implementace. |
| IsCodeDomProviderTypeValid |
Vrátí hodnotu určující, zda je v počítači nakonfigurována implementace zprostředkovatele jazyka. |
Metody
| Name | Description |
|---|---|
| CreateDefaultCompilerParameters() |
Získá nakonfigurované nastavení kompilátoru pro implementaci zprostředkovatele jazyka. |
| CreateProvider() |
CodeDomProvider Vrátí instanci pro aktuální nastavení zprostředkovatele jazyka. |
| CreateProvider(IDictionary<String,String>) |
CodeDomProvider Vrátí instanci pro aktuální nastavení zprostředkovatele jazyka a zadané možnosti. |
| Equals(Object) |
Určuje, zda zadaný objekt představuje stejného zprostředkovatele jazyka a nastavení kompilátoru jako aktuální CompilerInfo. |
| GetExtensions() |
Vrátí přípony názvů souborů podporované poskytovatelem jazyka. |
| GetHashCode() |
Vrátí kód hash pro aktuální instanci. |
| GetLanguages() |
Získá názvy jazyků podporované poskytovatelem jazyka. |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
