CodeEvent.Comment 属性
获取或设置与代码事件元素关联的标头注释。
命名空间: EnvDTE80
程序集: EnvDTE80(在 EnvDTE80.dll 中)
语法
声明
Property Comment As String
string Comment { get; set; }
property String^ Comment {
String^ get ();
void set (String^ value);
}
abstract Comment : string with get, set
function get Comment () : String
function set Comment (value : String)
属性值
类型:String
一个包含标头注释的字符串,或空字符串(如果未提供注释)。
备注
检索的文本不包含任何注释语法。 此文本是基于语言的注释样式从源文件派生的。 例如,在 C# 中,注释分隔符为 //,但在 Visual Basic 中,注释分隔符可以是撇号 (') 或 Rem(“remark”的简写)。
设置时,Comment 属性尝试使用面向行的语法和分隔语法来保持任何现有注释的样式。 在此过程中,它通过确定注释是与代码元素相接触还是用空白行分隔,在命令行语法之前保持任何一段缩进。
备注
在进行某些类型的编辑之后,代码模型元素(如类、结构、函数、特性、委托等)的值可能是非确定性的,这意味着不能指望它们的值总是保持不变。有关更多信息,请参见 使用代码模型查找代码 (Visual Basic) 中的“代码模型元素的值可能会更改”一节。
示例
下面的示例演示如何使用 Comment 属性。
测试此属性:
打开目标项目并通过将光标放在事件对象上来选择代码事件元素。
运行外接程序。
public static void Comment(EnvDTE80.DTE2 dte)
{
TextSelection objTextSel;
EnvDTE80.CodeEvent codeEvent;
objTextSel = (TextSelection)dte.ActiveDocument.Selection;
codeEvent = (EnvDTE80.CodeEvent)objTextSel.ActivePoint.get_CodeElement(vsCMElement.vsCMElementEvent);
MessageBox.Show("\nComment property: " +
codeEvent.Comment, "Testing CodeEvent");
}
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关详细信息,请参阅通过部分受信任的代码使用库。