|
33 | 33 | <Docs>
|
34 | 34 | <summary>Represents a set of options used by a code generator.</summary>
|
35 | 35 | <remarks>
|
36 |
| - <format type="text/markdown"><![CDATA[ |
37 |
| - |
38 |
| -## Remarks |
39 |
| - <xref:System.CodeDom.Compiler.CodeGeneratorOptions> is passed to the code generation methods of an <xref:System.CodeDom.Compiler.ICodeGenerator> implementation to specify options used during code generation. |
40 |
| - |
41 |
| - The <xref:System.CodeDom.Compiler.CodeGeneratorOptions.IndentString%2A> property specifies the string to use for each spacing indentation. The <xref:System.CodeDom.Compiler.CodeGeneratorOptions.BracingStyle%2A> property specifies the placement style for braces indicating the boundaries of code blocks. The <xref:System.CodeDom.Compiler.CodeGeneratorOptions.ElseOnClosing%2A> property specifies whether to append an `else`, `catch`, or `finally` block, including brackets, at the closing line of each `if` or `try` block. The <xref:System.CodeDom.Compiler.CodeGeneratorOptions.BlankLinesBetweenMembers%2A> property specifies whether to insert blank lines between members. |
42 |
| - |
43 |
| - An <xref:System.CodeDom.Compiler.ICodeGenerator> implementation can provide custom code generation options which you can set or pass data to using the <xref:System.CodeDom.Compiler.CodeGeneratorOptions.Item%2A> dictionary indexer, which a code generator can search through to locate additional code generation options. |
44 |
| - |
| 36 | + <format type="text/markdown"><![CDATA[ |
| 37 | +
|
| 38 | +## Remarks |
| 39 | + <xref:System.CodeDom.Compiler.CodeGeneratorOptions> is passed to the code generation methods of an <xref:System.CodeDom.Compiler.ICodeGenerator> implementation to specify options used during code generation. |
| 40 | +
|
| 41 | + The <xref:System.CodeDom.Compiler.CodeGeneratorOptions.IndentString%2A> property specifies the string to use for each spacing indentation. The <xref:System.CodeDom.Compiler.CodeGeneratorOptions.BracingStyle%2A> property specifies the placement style for braces indicating the boundaries of code blocks. The <xref:System.CodeDom.Compiler.CodeGeneratorOptions.ElseOnClosing%2A> property specifies whether to append an `else`, `catch`, or `finally` block, including brackets, at the closing line of each `if` or `try` block. The <xref:System.CodeDom.Compiler.CodeGeneratorOptions.BlankLinesBetweenMembers%2A> property specifies whether to insert blank lines between members. |
| 42 | +
|
| 43 | + An <xref:System.CodeDom.Compiler.ICodeGenerator> implementation can provide custom code generation options which you can set or pass data to using the <xref:System.CodeDom.Compiler.CodeGeneratorOptions.Item%2A> dictionary indexer, which a code generator can search through to locate additional code generation options. |
| 44 | +
|
45 | 45 | > [!NOTE]
|
46 |
| -> This class contains a link demand and an inheritance demand at the class level that applies to all members. A <xref:System.Security.SecurityException> is thrown when either the immediate caller or the derived class does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands) and [Inheritance Demands](https://learn.microsoft.com/previous-versions/dotnet/netframework-4.0/x4yx82e6(v=vs.100)). |
47 |
| - |
48 |
| - |
49 |
| - |
50 |
| -## Examples |
51 |
| - :::code language="cpp" source="~/snippets/cpp/VS_Snippets_CLR/CodeGeneratorOptionsExample/CPP/class1.cpp" id="Snippet1"::: |
| 46 | +> This class contains a link demand and an inheritance demand at the class level that applies to all members. A <xref:System.Security.SecurityException> is thrown when either the immediate caller or the derived class does not have full-trust permission. For details about security demands, see [Link Demands](/dotnet/framework/misc/link-demands) and [Inheritance Demands](https://learn.microsoft.com/previous-versions/dotnet/netframework-4.0/x4yx82e6(v=vs.100)). |
| 47 | +
|
| 48 | +
|
| 49 | +
|
| 50 | +## Examples |
52 | 51 | :::code language="csharp" source="~/snippets/csharp/System.CodeDom.Compiler/CodeGeneratorOptions/Overview/class1.cs" id="Snippet1":::
|
53 |
| - :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/CodeGeneratorOptionsExample/VB/class1.vb" id="Snippet1"::: |
54 |
| - |
| 52 | + :::code language="vb" source="~/snippets/visualbasic/VS_Snippets_CLR/CodeGeneratorOptionsExample/VB/class1.vb" id="Snippet1"::: |
| 53 | +
|
55 | 54 | ]]></format>
|
56 | 55 | </remarks>
|
57 | 56 | </Docs>
|
|
153 | 152 | <summary>Gets or sets the style to use for bracing.</summary>
|
154 | 153 | <value>A string containing the bracing style to use.</value>
|
155 | 154 | <remarks>
|
156 |
| - <format type="text/markdown"><![CDATA[ |
157 |
| - |
158 |
| -## Remarks |
159 |
| - The default value of this property is `Block`, which indicates that code should be generated so that braces start on the same line as the statement or declaration that they are associated with. A property value of `C` indicates that braces start on the line following the statement or declaration that they are associated with. |
160 |
| - |
| 155 | + <format type="text/markdown"><![CDATA[ |
| 156 | +
|
| 157 | +## Remarks |
| 158 | + The default value of this property is `Block`, which indicates that code should be generated so that braces start on the same line as the statement or declaration that they are associated with. A property value of `C` indicates that braces start on the line following the statement or declaration that they are associated with. |
| 159 | +
|
161 | 160 | ]]></format>
|
162 | 161 | </remarks>
|
163 | 162 | </Docs>
|
|
229 | 228 | <summary>Gets or sets the string to use for indentations.</summary>
|
230 | 229 | <value>A string containing the characters to use for indentations.</value>
|
231 | 230 | <remarks>
|
232 |
| - <format type="text/markdown"><![CDATA[ |
233 |
| - |
234 |
| -## Remarks |
235 |
| - The default value of this property is "/----/" (four spaces). |
236 |
| - |
| 231 | + <format type="text/markdown"><![CDATA[ |
| 232 | +
|
| 233 | +## Remarks |
| 234 | + The default value of this property is "/----/" (four spaces). |
| 235 | +
|
237 | 236 | ]]></format>
|
238 | 237 | </remarks>
|
239 | 238 | </Docs>
|
|
274 | 273 | <summary>Gets or sets the object at the specified index.</summary>
|
275 | 274 | <value>The object associated with the specified name. If no object associated with the specified name exists in the collection, <see langword="null" />.</value>
|
276 | 275 | <remarks>
|
277 |
| - <format type="text/markdown"><![CDATA[ |
278 |
| - |
279 |
| -## Remarks |
280 |
| - This dictionary provides an extensibility mechanism for developers to provide data for custom features of a code generator. A code generator must implement such features and support checking the dictionary for this to be useful. |
281 |
| - |
| 276 | + <format type="text/markdown"><![CDATA[ |
| 277 | +
|
| 278 | +## Remarks |
| 279 | + This dictionary provides an extensibility mechanism for developers to provide data for custom features of a code generator. A code generator must implement such features and support checking the dictionary for this to be useful. |
| 280 | +
|
282 | 281 | ]]></format>
|
283 | 282 | </remarks>
|
284 | 283 | </Docs>
|
|
321 | 320 | <value>
|
322 | 321 | <see langword="true" /> to generate the members in the order in which they occur in the member collection; otherwise, <see langword="false" />. The default value of this property is <see langword="false" />.</value>
|
323 | 322 | <remarks>
|
324 |
| - <format type="text/markdown"><![CDATA[ |
325 |
| - |
326 |
| -## Remarks |
327 |
| - The default generates members by their type, for example; field, member, constructor, or property. A code generator can use the <xref:System.CodeDom.Compiler.CodeGeneratorOptions.VerbatimOrder%2A> property to inject #region blocks into code, thus changing the order. |
328 |
| - |
| 323 | + <format type="text/markdown"><![CDATA[ |
| 324 | +
|
| 325 | +## Remarks |
| 326 | + The default generates members by their type, for example; field, member, constructor, or property. A code generator can use the <xref:System.CodeDom.Compiler.CodeGeneratorOptions.VerbatimOrder%2A> property to inject #region blocks into code, thus changing the order. |
| 327 | +
|
329 | 328 | ]]></format>
|
330 | 329 | </remarks>
|
331 | 330 | </Docs>
|
|
0 commit comments