CodeGeneratorOptions Classe

Definição

Namespace:

System.CodeDom.Compiler

Assembly:

System.CodeDom.dll

Pacote:

System.CodeDom v9.0.0-rc.2.24473.5

Origem:

CodeGeneratorOptions.cs

Representa um conjunto de opções usadas por um gerador de código.

public ref class CodeGeneratorOptions

public class CodeGeneratorOptions

type CodeGeneratorOptions = class

Public Class CodeGeneratorOptions

Herança

Object

CodeGeneratorOptions

Exemplos

// Creates a new CodeGeneratorOptions.
CodeGeneratorOptions^ genOptions = gcnew CodeGeneratorOptions;

// Sets a value indicating that the code generator should insert blank lines between type members.
genOptions->BlankLinesBetweenMembers = true;

// Sets the style of bracing format to use: either S"Block" to start a
// bracing block on the same line as the declaration of its container, or
// S"C" to start the bracing for the block on the following line.
genOptions->BracingStyle = "C";

// Sets a value indicating that the code generator should not append an else,
// catch or finally block, including brackets, at the closing line of a preceeding if or try block.
genOptions->ElseOnClosing = false;

// Sets the String* to indent each line with.
genOptions->IndentString = "    ";

// Uses the CodeGeneratorOptions indexer property to set an
// example Object* to the type's String*-keyed ListDictionary.
// Custom ICodeGenerator* implementations can use objects
// in this dictionary to customize process behavior.
genOptions[ "CustomGeneratorOptionStringExampleID" ] = "BuildFlags: /A /B /C /D /E";

// Creates a new CodeGeneratorOptions.
CodeGeneratorOptions genOptions = new CodeGeneratorOptions();

// Sets a value indicating that the code generator should insert blank lines between type members.
genOptions.BlankLinesBetweenMembers = true;

// Sets the style of bracing format to use: either "Block" to start a
// bracing block on the same line as the declaration of its container, or
// "C" to start the bracing for the block on the following line.
genOptions.BracingStyle = "C";

// Sets a value indicating that the code generator should not append an else,
// catch or finally block, including brackets, at the closing line of a preceeding if or try block.
genOptions.ElseOnClosing = false;

// Sets the string to indent each line with.
genOptions.IndentString = "    ";

// Uses the CodeGeneratorOptions indexer property to set an
// example object to the type's string-keyed ListDictionary.
// Custom ICodeGenerator implementations can use objects
// in this dictionary to customize process behavior.
genOptions["CustomGeneratorOptionStringExampleID"] = "BuildFlags: /A /B /C /D /E";

' Creates a new CodeGeneratorOptions.
Dim genOptions As New CodeGeneratorOptions()

' Sets a value indicating that the code generator should insert blank lines between type members.
genOptions.BlankLinesBetweenMembers = True

' Sets the style of bracing format to use: either "Block" to start a
' bracing block on the same line as the declaration of its container, or 
' "C" to start the bracing for the block on the following line.
genOptions.BracingStyle = "C"

' Sets a value indicating that the code generator should not append an else, 
' catch or finally block, including brackets, at the closing line of a preceeding if or try block.
genOptions.ElseOnClosing = False

' Sets the string to indent each line with.
genOptions.IndentString = "    "

' Uses the CodeGeneratorOptions indexer property to set an
' example object to the type's string-keyed ListDictionary.
' Custom ICodeGenerator implementations can use objects 
' in this dictionary to customize process behavior.
genOptions("CustomGeneratorOptionStringExampleID") = "BuildFlags: /A /B /C /D /E"

Comentários

CodeGeneratorOptions é passado para os métodos de geração de código de uma ICodeGenerator implementação para especificar as opções usadas durante a geração de código.

A IndentString propriedade especifica a cadeia de caracteres a ser usada para cada recuo de espaçamento. A BracingStyle propriedade especifica o estilo de posicionamento para chaves que indicam os limites dos blocos de código. A ElseOnClosing propriedade especifica se um elsebloco , catchou finally deve ser acrescentado, incluindo colchetes, na linha de fechamento de cada if bloco ou try . A BlankLinesBetweenMembers propriedade especifica se as linhas em branco devem ser inseridas entre membros.

Uma ICodeGenerator implementação pode fornecer opções de geração de código personalizadas para as quais você pode definir ou passar dados usando o Item[] indexador de dicionário, que um gerador de código pode pesquisar para localizar opções adicionais de geração de código.

Observação

Esta classe contém uma demanda de link e uma demanda de herança no nível de classe que se aplica a todos os membros. Um SecurityException é lançado quando o chamador imediato ou a classe derivada não tem permissão de confiança total. Para obter detalhes sobre as demandas de segurança, consulte Vincular demandas e demandas de herança.

Construtores

CodeGeneratorOptions()

Inicializa uma nova instância da classe CodeGeneratorOptions.

Propriedades

BlankLinesBetweenMembers	Obtém ou define um valor que indica se linhas em branco são ou não inseridas entre membros.
BracingStyle	Obtém ou define o estilo de chaves a ser usado.
ElseOnClosing	Obtém ou define um valor que indica se um bloco else, catch ou finally, incluindo os colchetes, deve ou não ser acrescentado na linha de fechamento de cada bloco if ou try anterior.
IndentString	Obtém ou define a cadeia de caracteres a ser usada para recuos.
Item[String]	Obtém ou define o objeto no índice especificado.
VerbatimOrder	Obtém ou define um valor que indica se os membros devem ou não ser gerados na ordem em que ocorrem em coleções de membros.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)