GeneratorSupport Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Definiert Bezeichner, die verwendet werden, um zu bestimmen, ob ein Codegenerator bestimmte Arten von Codeelementen unterstützt.
Diese Enumeration unterstützt eine bitweise Kombination ihrer Memberwerte.
public enum class GeneratorSupport
[System.Flags]
[System.Serializable]
public enum GeneratorSupport
[<System.Flags>]
[<System.Serializable>]
type GeneratorSupport =
Public Enum GeneratorSupport
- Vererbung
- Attribute
Felder
| Name | Wert | Beschreibung |
|---|---|---|
| ArraysOfArrays | 1 | Gibt an, dass der Generator Arrays unterstützt. |
| EntryPointMethod | 2 | Gibt an, dass der Generator eine Programmeinstiegspunkt-Methodenbezeichnung unterstützt. Dies wird beim Erstellen von ausführbaren Dateien verwendet. |
| GotoStatements | 4 | Gibt an, dass der Generator Goto-Anweisungen unterstützt. |
| MultidimensionalArrays | 8 | Gibt an, dass der Generator das Verweisen auf multidimensionale Arrays unterstützt. Derzeit kann codeDom nicht verwendet werden, um mehrdimensionale Arrays zu instanziieren. |
| StaticConstructors | 16 | Gibt an, dass der Generator statische Konstruktoren unterstützt. |
| TryCatchStatements | 32 | Gibt an, dass der Generator Anweisungen unterstützt |
| ReturnTypeAttributes | 64 | Gibt an, dass der Generator Rückgabetyp-Attributdeklarationen unterstützt. |
| DeclareValueTypes | 128 | Gibt an, dass der Generator Werttypdeklarationen unterstützt. |
| DeclareEnums | 256 | Gibt an, dass der Generator Enumerationsdeklarationen unterstützt. |
| DeclareDelegates | 512 | Gibt an, dass der Generator Stellvertretungsdeklarationen unterstützt. |
| DeclareInterfaces | 1024 | Gibt an, dass der Generator Schnittstellendeklarationen unterstützt. |
| DeclareEvents | 2048 | Gibt an, dass der Generator Ereignisdeklarationen unterstützt. |
| AssemblyAttributes | 4096 | Gibt an, dass der Generator Assemblyattribute unterstützt. |
| ParameterAttributes | 8192 | Gibt an, dass der Generator Parameterattribute unterstützt. |
| ReferenceParameters | 16384 | Gibt an, dass der Generator Referenz- und Ausgabeparameter unterstützt. |
| ChainedConstructorArguments | 32768 | Gibt an, dass der Generator verkettete Konstruktorargumente unterstützt. |
| NestedTypes | 65536 | Gibt an, dass der Generator die Deklaration geschachtelter Typen unterstützt. |
| MultipleInterfaceMembers | 131072 | Gibt an, dass der Generator die Deklaration von Membern unterstützt, die mehrere Schnittstellen implementieren. |
| PublicStaticMembers | 262144 | Gibt an, dass der Generator öffentliche statische Member unterstützt. |
| ComplexExpressions | 524288 | Gibt an, dass der Generator komplexe Ausdrücke unterstützt. |
| Win32Resources | 1048576 | Gibt an, dass der Generator die Kompilierung mit Win32-Ressourcen unterstützt. |
| Resources | 2097152 | Gibt an, dass der Generator die Kompilierung mit .NET Ressourcen unterstützt. Dies können Standardressourcen sein, die direkt in einer Assembly kompiliert werden, oder Ressourcen, auf die in einer Satellitenassembly verwiesen wird. |
| PartialTypes | 4194304 | Gibt an, dass der Generator partielle Typdeklarationen unterstützt. |
| GenericTypeReference | 8388608 | Gibt an, dass der Generator generische Typverweise unterstützt. |
| GenericTypeDeclaration | 16777216 | Gibt an, dass der Generator generische Typdeklarationen unterstützt. |
| DeclareIndexerProperties | 33554432 | Gibt an, dass der Generator die Deklaration von Indexereigenschaften unterstützt. |
Beispiele
Das folgende Beispiel veranschaulicht die Verwendung CompilerParameters verschiedener Compilereinstellungen und -optionen.
public static bool CompileCode(CodeDomProvider provider,
String sourceFile,
String exeFile)
{
CompilerParameters cp = new CompilerParameters();
// Generate an executable instead of
// a class library.
cp.GenerateExecutable = true;
// Set the assembly file name to generate.
cp.OutputAssembly = exeFile;
// Generate debug information.
cp.IncludeDebugInformation = true;
// Add an assembly reference.
cp.ReferencedAssemblies.Add( "System.dll" );
// Save the assembly as a physical file.
cp.GenerateInMemory = false;
// Set the level at which the compiler
// should start displaying warnings.
cp.WarningLevel = 3;
// Set whether to treat all warnings as errors.
cp.TreatWarningsAsErrors = false;
// Set compiler argument to optimize output.
cp.CompilerOptions = "/optimize";
// Set a temporary files collection.
// The TempFileCollection stores the temporary files
// generated during a build in the current directory,
// and does not delete them after compilation.
cp.TempFiles = new TempFileCollection(".", true);
if (provider.Supports(GeneratorSupport.EntryPointMethod))
{
// Specify the class that contains
// the main method of the executable.
cp.MainClass = "Samples.Class1";
}
if (Directory.Exists("Resources"))
{
if (provider.Supports(GeneratorSupport.Resources))
{
// Set the embedded resource file of the assembly.
// This is useful for culture-neutral resources,
// or default (fallback) resources.
cp.EmbeddedResources.Add("Resources\\Default.resources");
// Set the linked resource reference files of the assembly.
// These resources are included in separate assembly files,
// typically localized for a specific language and culture.
cp.LinkedResources.Add("Resources\\nb-no.resources");
}
}
// Invoke compilation.
CompilerResults cr = provider.CompileAssemblyFromFile(cp, sourceFile);
if(cr.Errors.Count > 0)
{
// Display compilation errors.
Console.WriteLine("Errors building {0} into {1}",
sourceFile, cr.PathToAssembly);
foreach(CompilerError ce in cr.Errors)
{
Console.WriteLine(" {0}", ce.ToString());
Console.WriteLine();
}
}
else
{
Console.WriteLine("Source {0} built into {1} successfully.",
sourceFile, cr.PathToAssembly);
Console.WriteLine("{0} temporary files created during the compilation.",
cp.TempFiles.Count.ToString());
}
// Return the results of compilation.
if (cr.Errors.Count > 0)
{
return false;
}
else
{
return true;
}
}
Public Shared Function CompileCode(ByVal provider As CodeDomProvider, _
ByVal sourceFile As String, ByVal exeFile As String) As Boolean
Dim cp As New CompilerParameters()
' Generate an executable instead of
' a class library.
cp.GenerateExecutable = True
' Set the assembly file name to generate.
cp.OutputAssembly = exeFile
' Generate debug information.
cp.IncludeDebugInformation = True
' Add an assembly reference.
cp.ReferencedAssemblies.Add("System.dll")
' Save the assembly as a physical file.
cp.GenerateInMemory = False
' Set the level at which the compiler
' should start displaying warnings.
cp.WarningLevel = 3
' Set whether to treat all warnings as errors.
cp.TreatWarningsAsErrors = False
' Set compiler argument to optimize output.
cp.CompilerOptions = "/optimize"
' Set a temporary files collection.
' The TempFileCollection stores the temporary files
' generated during a build in the current directory,
' and does not delete them after compilation.
cp.TempFiles = New TempFileCollection(".", True)
If provider.Supports(GeneratorSupport.EntryPointMethod) Then
' Specify the class that contains
' the main method of the executable.
cp.MainClass = "Samples.Class1"
End If
If Directory.Exists("Resources") Then
If provider.Supports(GeneratorSupport.Resources) Then
' Set the embedded resource file of the assembly.
' This is useful for culture-neutral resources,
' or default (fallback) resources.
cp.EmbeddedResources.Add("Resources\Default.resources")
' Set the linked resource reference files of the assembly.
' These resources are included in separate assembly files,
' typically localized for a specific language and culture.
cp.LinkedResources.Add("Resources\nb-no.resources")
End If
End If
' Invoke compilation.
Dim cr As CompilerResults = _
provider.CompileAssemblyFromFile(cp, sourceFile)
If cr.Errors.Count > 0 Then
' Display compilation errors.
Console.WriteLine("Errors building {0} into {1}", _
sourceFile, cr.PathToAssembly)
Dim ce As CompilerError
For Each ce In cr.Errors
Console.WriteLine(" {0}", ce.ToString())
Console.WriteLine()
Next ce
Else
Console.WriteLine("Source {0} built into {1} successfully.", _
sourceFile, cr.PathToAssembly)
Console.WriteLine("{0} temporary files created during the compilation.", _
cp.TempFiles.Count.ToString())
End If
' Return the results of compilation.
If cr.Errors.Count > 0 Then
Return False
Else
Return True
End If
End Function 'CompileCode
Hinweise
Diese Bezeichner werden beim Aufrufen der Supports Methode eines Codegenerators verwendet, um zu bestimmen, ob der Codegenerator das Generieren bestimmter Codetypen unterstützt.