CodeRegionDirective Classe
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Spécifie le nom et le mode d'une zone de code.
public ref class CodeRegionDirective : System::CodeDom::CodeDirective
public class CodeRegionDirective : System.CodeDom.CodeDirective
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class CodeRegionDirective : System.CodeDom.CodeDirective
type CodeRegionDirective = class
inherit CodeDirective
[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type CodeRegionDirective = class
inherit CodeDirective
Public Class CodeRegionDirective
Inherits CodeDirective
- Héritage
- Attributs
L’exemple de code suivant montre l’utilisation de dans CodeRegionDirective la création d’un graphique qui est utilisé pour produire du code qui est également compilé.
using System.CodeDom;
using System.CodeDom.Compiler;
using System.Collections;
using System.Collections.Specialized;
using System.IO;
using System.Reflection;
using System.Text.RegularExpressions;
using System.Globalization;
namespace System.CodeDom
{
class CodeDirectiveDemo
{
static void Main()
{
try
{
DemonstrateCodeDirectives("cs", "ChecksumPragma.cs", "ChecksumPragmaCS.exe");
}
catch (Exception e)
{
Console.WriteLine("Unexpected Exception:" + e.ToString());
}
}
// Create and compile code containing code directives.
static void DemonstrateCodeDirectives(string providerName, string sourceFileName, string assemblyName)
{
CodeDomProvider provider = CodeDomProvider.CreateProvider(providerName);
Console.WriteLine("Building the CodeDOM graph...");
CodeCompileUnit cu = new CodeCompileUnit();
CreateGraph(cu);
StringWriter sw = new StringWriter();
Console.WriteLine("Generating code...");
provider.GenerateCodeFromCompileUnit(cu, sw, null);
string output = sw.ToString();
output = Regex.Replace(output, "Runtime Version:[^\r\n]*",
"Runtime Version omitted for demo");
Console.WriteLine("Dumping source code...");
Console.WriteLine(output);
Console.WriteLine("Writing source code to file...");
Stream s = File.Open(sourceFileName, FileMode.Create);
StreamWriter t = new StreamWriter(s);
t.Write(output);
t.Close();
s.Close();
CompilerParameters opt = new CompilerParameters(new string[]{
"System.dll",
"System.Xml.dll",
"System.Windows.Forms.dll",
"System.Data.dll",
"System.Drawing.dll"});
opt.GenerateExecutable = false;
opt.TreatWarningsAsErrors = true;
opt.IncludeDebugInformation = true;
opt.GenerateInMemory = true;
CompilerResults results;
Console.WriteLine("Compiling with " + providerName);
results = provider.CompileAssemblyFromFile(opt, sourceFileName);
OutputResults(results);
if (results.NativeCompilerReturnValue != 0)
{
Console.WriteLine("");
Console.WriteLine("Compilation failed.");
}
else
{
Console.WriteLine("");
Console.WriteLine("Demo complete.");
}
File.Delete(sourceFileName);
}
// This example uses the SHA1 and MD5 algorithms.
// Due to collision problems with SHA1 and MD5, Microsoft recommends SHA256 or better.
private static Guid HashMD5 = new Guid(0x406ea660, 0x64cf, 0x4c82, 0xb6, 0xf0, 0x42, 0xd4, 0x81, 0x72, 0xa7, 0x99);
private static Guid HashSHA1 = new Guid(0xff1816ec, 0xaa5e, 0x4d10, 0x87, 0xf7, 0x6f, 0x49, 0x63, 0x83, 0x34, 0x60);
// Create a CodeDOM graph.
static void CreateGraph( CodeCompileUnit cu)
{
cu.StartDirectives.Add(new CodeRegionDirective(CodeRegionMode.Start,
"Compile Unit Region"));
cu.EndDirectives.Add(new CodeRegionDirective(CodeRegionMode.End,
string.Empty));
CodeChecksumPragma pragma1 = new CodeChecksumPragma();
pragma1.FileName = "c:\\temp\\test\\OuterLinePragma.txt";
pragma1.ChecksumAlgorithmId = HashMD5;
pragma1.ChecksumData = new byte[] { 0xAA, 0xAA };
cu.StartDirectives.Add(pragma1);
CodeChecksumPragma pragma2 = new CodeChecksumPragma("test.txt", HashSHA1, new byte[] { 0xBB, 0xBB, 0xBB });
cu.StartDirectives.Add(pragma2);
CodeNamespace ns = new CodeNamespace("Namespace1");
ns.Imports.Add(new CodeNamespaceImport("System"));
ns.Imports.Add(new CodeNamespaceImport("System.IO"));
cu.Namespaces.Add(ns);
ns.Comments.Add(new CodeCommentStatement("Namespace Comment"));
CodeTypeDeclaration cd = new CodeTypeDeclaration("Class1");
ns.Types.Add(cd);
cd.Comments.Add(new CodeCommentStatement("Outer Type Comment"));
cd.LinePragma = new CodeLinePragma("c:\\temp\\test\\OuterLinePragma.txt", 300);
CodeMemberMethod method1 = new CodeMemberMethod();
method1.Name = "Method1";
method1.Attributes = (method1.Attributes & ~MemberAttributes.AccessMask) | MemberAttributes.Public;
CodeMemberMethod method2 = new CodeMemberMethod();
method2.Name = "Method2";
method2.Attributes = (method2.Attributes & ~MemberAttributes.AccessMask) | MemberAttributes.Public;
method2.Comments.Add(new CodeCommentStatement("Method 2 Comment"));
cd.Members.Add(method1);
cd.Members.Add(method2);
cd.StartDirectives.Add(new CodeRegionDirective(CodeRegionMode.Start,
"Outer Type Region"));
cd.EndDirectives.Add(new CodeRegionDirective(CodeRegionMode.End,
string.Empty));
CodeMemberField field1 = new CodeMemberField(typeof(String), "field1");
cd.Members.Add(field1);
field1.Comments.Add(new CodeCommentStatement("Field 1 Comment"));
CodeRegionDirective codeRegionDirective1 = new CodeRegionDirective(CodeRegionMode.Start,
"Field Region");
field1.StartDirectives.Add(codeRegionDirective1);
CodeRegionDirective codeRegionDirective2 = new CodeRegionDirective(CodeRegionMode.End,
"");
codeRegionDirective2.RegionMode = CodeRegionMode.End;
codeRegionDirective2.RegionText = string.Empty;
field1.EndDirectives.Add(codeRegionDirective2);
CodeSnippetStatement snippet1 = new CodeSnippetStatement();
snippet1.Value = " Console.WriteLine(field1);";
CodeRegionDirective regionStart = new CodeRegionDirective(CodeRegionMode.End, "");
regionStart.RegionText = "Snippet Region";
regionStart.RegionMode = CodeRegionMode.Start;
snippet1.StartDirectives.Add(regionStart);
snippet1.EndDirectives.Add(new CodeRegionDirective(CodeRegionMode.End, string.Empty));
// CodeStatement example
CodeConstructor constructor1 = new CodeConstructor();
constructor1.Attributes = (constructor1.Attributes & ~MemberAttributes.AccessMask) | MemberAttributes.Public;
CodeStatement codeAssignStatement1 = new CodeAssignStatement(
new CodeFieldReferenceExpression(
new CodeThisReferenceExpression(),
"field1"),
new CodePrimitiveExpression("value1"));
codeAssignStatement1.StartDirectives.Add(new CodeRegionDirective(CodeRegionMode.Start, "Statements Region"));
cd.Members.Add(constructor1);
codeAssignStatement1.EndDirectives.Add(new CodeRegionDirective(CodeRegionMode.End, string.Empty));
method2.Statements.Add(codeAssignStatement1);
method2.Statements.Add(snippet1);
}
static void OutputResults(CompilerResults results)
{
Console.WriteLine("NativeCompilerReturnValue=" +
results.NativeCompilerReturnValue.ToString());
foreach (string s in results.Output)
{
Console.WriteLine(s);
}
}
}
}
Imports System.CodeDom
Imports System.CodeDom.Compiler
Imports System.Collections
Imports System.Collections.Specialized
Imports System.IO
Imports System.Reflection
Imports System.Text.RegularExpressions
Imports System.Globalization
Class CodeDirectiveDemo
Shared Sub Main()
Try
DemonstrateCodeDirectives("vb", "ChecksumPragma.vb", "ChecksumPragmaVB.exe")
Catch e As Exception
Console.WriteLine(("Unexpected exception:" + e.ToString()))
End Try
End Sub
' Create and compile code containing code directives.
Shared Sub DemonstrateCodeDirectives(ByVal providerName As String, ByVal sourceFileName As String, ByVal assemblyName As String)
Dim provider As CodeDomProvider = CodeDomProvider.CreateProvider(providerName)
Console.WriteLine("Building the CodeDOM graph...")
Dim cu As New CodeCompileUnit()
CreateGraph(cu)
Dim sw As New StringWriter()
Console.WriteLine("Generating code...")
provider.GenerateCodeFromCompileUnit(cu, sw, Nothing)
Dim output As String = sw.ToString()
output = Regex.Replace(output, "Runtime version:[^" + vbCr + vbLf + "]*", "Runtime version omitted for this demo")
Console.WriteLine("Dumping source code...")
Console.WriteLine(output)
Console.WriteLine("Writing source code to file...")
Dim s As Stream = File.Open(sourceFileName, FileMode.Create)
Dim t As New StreamWriter(s)
t.Write(output)
t.Close()
s.Close()
Dim opt As New CompilerParameters(New String() {"System.dll", "System.Xml.dll", "System.Windows.Forms.dll", "System.Data.dll", "System.Drawing.dll"})
opt.GenerateExecutable = False
opt.TreatWarningsAsErrors = True
opt.IncludeDebugInformation = True
opt.GenerateInMemory = True
Dim results As CompilerResults
Console.WriteLine(("Compiling with " + providerName))
results = provider.CompileAssemblyFromFile(opt, sourceFileName)
OutputResults(results)
If results.NativeCompilerReturnValue <> 0 Then
Console.WriteLine("")
Console.WriteLine("Compilation failed.")
Else
Console.WriteLine("")
Console.WriteLine("Demo completed successfully.")
End If
File.Delete(sourceFileName)
End Sub
' This example uses the SHA1 and MD5 algorithms.
' Due to collision problems with SHA1 and MD5, Microsoft recommends SHA256 or better.
Private Shared HashMD5 As New Guid(&H406EA660, &H64CF, &H4C82, &HB6, &HF0, &H42, &HD4, &H81, &H72, &HA7, &H99)
Private Shared HashSHA1 As New Guid(&HFF1816EC, &H65FF, &H4D10, &H87, &HF7, &H6F, &H49, &H63, &H83, &H34, &H60)
' Create a CodeDOM graph.
Shared Sub CreateGraph(ByVal cu As CodeCompileUnit) 'ICodeGenerator generator,
cu.StartDirectives.Add(New CodeRegionDirective(CodeRegionMode.Start, "Compile Unit Region"))
cu.EndDirectives.Add(New CodeRegionDirective(CodeRegionMode.End, String.Empty))
Dim pragma1 As New CodeChecksumPragma()
pragma1.FileName = "c:\temp\test\OuterLinePragma.txt"
pragma1.ChecksumAlgorithmId = HashMD5
pragma1.ChecksumData = New Byte() {&HAA, &HAA}
cu.StartDirectives.Add(pragma1)
Dim pragma2 As New CodeChecksumPragma("test.txt", HashSHA1, New Byte() {&HBB, &HBB, &HBB})
cu.StartDirectives.Add(pragma2)
Dim ns As New CodeNamespace("Namespace1")
ns.Imports.Add(New CodeNamespaceImport("System"))
ns.Imports.Add(New CodeNamespaceImport("System.IO"))
cu.Namespaces.Add(ns)
ns.Comments.Add(New CodeCommentStatement("Namespace Comment"))
Dim cd As New CodeTypeDeclaration("Class1")
ns.Types.Add(cd)
cd.Comments.Add(New CodeCommentStatement("Outer Type Comment"))
cd.LinePragma = New CodeLinePragma("c:\temp\test\OuterLinePragma.txt", 300)
Dim method1 As New CodeMemberMethod()
method1.Name = "Method1"
method1.Attributes = method1.Attributes And Not MemberAttributes.AccessMask Or MemberAttributes.Public
Dim method2 As New CodeMemberMethod()
method2.Name = "Method2"
method2.Attributes = method2.Attributes And Not MemberAttributes.AccessMask Or MemberAttributes.Public
method2.Comments.Add(New CodeCommentStatement("Method2 Comment"))
cd.Members.Add(method1)
cd.Members.Add(method2)
cd.StartDirectives.Add(New CodeRegionDirective(CodeRegionMode.Start, "Outer Type Region"))
cd.EndDirectives.Add(New CodeRegionDirective(CodeRegionMode.End, String.Empty))
Dim field1 As New CodeMemberField(GetType(String), "field1")
cd.Members.Add(field1)
field1.Comments.Add(New CodeCommentStatement("Field1 Comment"))
Dim codeRegionDirective1 As New CodeRegionDirective(CodeRegionMode.Start, "Field Region")
field1.StartDirectives.Add(codeRegionDirective1)
Dim codeRegionDirective2 As New CodeRegionDirective(CodeRegionMode.End, "")
codeRegionDirective2.RegionMode = CodeRegionMode.End
codeRegionDirective2.RegionText = String.Empty
field1.EndDirectives.Add(codeRegionDirective2)
Dim snippet1 As New CodeSnippetStatement()
snippet1.Value = " Console.WriteLine(field1)"
Dim regionStart As New CodeRegionDirective(CodeRegionMode.End, "")
regionStart.RegionText = "Snippet Region"
regionStart.RegionMode = CodeRegionMode.Start
snippet1.StartDirectives.Add(regionStart)
snippet1.EndDirectives.Add(New CodeRegionDirective(CodeRegionMode.End, String.Empty))
' CodeStatement example
Dim constructor1 As New CodeConstructor()
constructor1.Attributes = constructor1.Attributes And Not MemberAttributes.AccessMask _
Or MemberAttributes.Public
Dim codeAssignStatement1 As New CodeAssignStatement( _
New CodeFieldReferenceExpression( _
New CodeThisReferenceExpression(), "field1"), _
New CodePrimitiveExpression("value1"))
codeAssignStatement1.StartDirectives.Add(New CodeRegionDirective(CodeRegionMode.Start, "Statements Region"))
cd.Members.Add(constructor1)
codeAssignStatement1.EndDirectives.Add(New CodeRegionDirective(CodeRegionMode.End, String.Empty))
method2.Statements.Add(codeAssignStatement1)
method2.Statements.Add(snippet1)
End Sub
Shared Sub OutputResults(ByVal results As CompilerResults)
Console.WriteLine(("NativeCompilerReturnValue=" + results.NativeCompilerReturnValue.ToString()))
Dim s As String
For Each s In results.Output
Console.WriteLine(s)
Next s
End Sub
End Class
La RegionMode propriété spécifie si une instance représente le début ou la fin de la région.
Notes
Tous les compilateurs ne prennent pas en charge les directives de région de code. Pour éviter les erreurs du compilateur, les fournisseurs de code n’incluent généralement pas de directives de région de code dans la sortie du fournisseur pour les compilateurs qui ne les prennent pas en charge.
Code |
Initialise une nouvelle instance de la classe CodeRegionDirective avec les valeurs par défaut. |
Code |
Initialise une nouvelle instance de la classe CodeRegionDirective, en spécifiant son mode et son nom. |
Region |
Obtient ou définit le mode de la directive de zone. |
Region |
Obtient ou définit le nom de la zone. |
User |
Obtient les données définissables par l'utilisateur pour l'objet en cours. (Hérité de CodeObject) |
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
Get |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
Get |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
Memberwise |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
To |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :