CompilerInfo Osztály
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
A nyelvi szolgáltató konfigurációs beállításait jelöli. Ez az osztály nem örökölhető.
public ref class CompilerInfo sealedpublic sealed class CompilerInfotype CompilerInfo = classPublic NotInheritable Class CompilerInfo- Öröklődés
-
CompilerInfo
Példák
Az alábbi példakód a nyelvszolgáltató konfigurációs beállításait mutatja be. A parancssori argumentumok nyelv, fájlnévkiterjesztés vagy szolgáltatótípus megadására szolgálnak. A megadott bemenet esetében a példa meghatározza a megfelelő nyelvszolgáltatót, és megjeleníti a konfigurált nyelvfordító beállításait.
// 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
Megjegyzések
CompilerInfo Az osztály segítségével meghatározhatja, hogy egy CodeDomProvider implementáció konfigurálva van-e a számítógépen, vagy megvizsgálhatja egy adott nyelvi szolgáltató konfigurációs és fordítóbeállításait.
A <gép konfigurációs fájljának system.codedom> eleme tartalmazza a nyelvi szolgáltató és a fordító konfigurációs beállításait. Minden konfigurált nyelvszolgáltató rendelkezik egy megfelelő fordítókonfigurációs elemmel. Minden elem meghatározza a megvalósítás típusát, a CodeDomProvider támogatott nyelvneveket, a támogatott fájlnévkiterjesztéseket és a fordítóparamétereket.
A .NET-keretrendszer határozza meg a kezdeti fordítóbeállításokat a gép konfigurációs fájljában. A fejlesztők és a fordítógyártók konfigurációs beállításokat adhatnak hozzá egy új CodeDomProvider implementációhoz.
Az CompilerInfo osztály írásvédett hozzáférést biztosít ezekhez a beállításokhoz a gép konfigurációs fájljában. A , GetLanguagesés GetExtensions a CodeDomProviderTypetagok használatával vizsgálja meg a nyelvi szolgáltató megfelelő konfigurációs attribútumait. A metódussal CreateDefaultCompilerParameters lekérjük a fordító beállításait és a figyelmeztetési szint attribútumértékét egy nyelvszolgáltatóhoz.
A konfigurációs fájl nyelvszolgáltatói beállításairól további információt a Fordító és a Nyelvszolgáltató beállításai séma című témakörben talál.
Note
Ez az osztály az összes tagra vonatkozó hivatkozási igényt tartalmaz az osztály szintjén. Az A SecurityException akkor jön létre, ha az azonnali hívó nem rendelkezik teljes megbízhatósági engedéllyel. A hivatkozási igényekről további információt a Hivatkozási igények című témakörben talál.
Tulajdonságok
| Name | Description |
|---|---|
| CodeDomProviderType |
Lekéri a konfigurált CodeDomProvider implementáció típusát. |
| IsCodeDomProviderTypeValid |
Egy értéket ad vissza, amely jelzi, hogy a nyelvi szolgáltató implementációja konfigurálva van-e a számítógépen. |
Metódusok
| Name | Description |
|---|---|
| CreateDefaultCompilerParameters() |
Lekéri a nyelvi szolgáltató implementálásához konfigurált fordítóbeállításokat. |
| CreateProvider() |
Egy példányt CodeDomProvider ad vissza az aktuális nyelvszolgáltatói beállításokhoz. |
| CreateProvider(IDictionary<String,String>) |
Egy példányt CodeDomProvider ad vissza az aktuális nyelvszolgáltatói beállításokhoz és a megadott beállításokhoz. |
| Equals(Object) |
Meghatározza, hogy a megadott objektum ugyanazt a nyelvi szolgáltatót és fordítóbeállításokat jelöli-e, mint az aktuális CompilerInfo. |
| GetExtensions() |
A nyelvi szolgáltató által támogatott fájlnévkiterjesztéseket adja vissza. |
| GetHashCode() |
Az aktuális példány kivonatkódját adja vissza. |
| GetLanguages() |
Lekéri a nyelvszolgáltató által támogatott nyelvneveket. |
| GetType() |
Lekéri az Type aktuális példányt. (Öröklődés forrása Object) |
| MemberwiseClone() |
Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object) |
| ToString() |
Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object) |
