怎么在android的XML文件中添加注释

怎么在android的XML文件中添加注释,第1张

android的XML文件注释一般采用 <!--注释内容 -->的方式进行

在XML中,形如<Button /> 的表示方式,其中“/>”的含义表示这个XML中没有内文,他是一个最小组成单元,也就是说他的中间不能包含其他任何<>的代码,所以在<Button />中间注释会出现错误

注意看到,在注释的前面有一个“>”符号,这就是我们能够在他中间进行注释的原因,他的完整结构是

<RelativeLayout ></RelativeLayout>

这就不是最小组成单元的表示方式了

<? xml version = "1.0" encoding = "utf-8" ?>

<RelativeLayout android:id = "@+id/right"

xmlns:android = "http://schemas.android.com/apk/res/android"

android:layout_width = "fill_parent"

android:layout_height = "fill_parent" >

<!-- 在这里注释是没有问题的 -->

<TextView android:id = "@+id/right_view1"

android:background = "@drawable/yellow" android:layout_width = "fill_parent"

android:layout_height = "wrap_content" android:text = "第二组第一项" />

<!-- 在这里注释也是没有问题的 -->

<TextView android:id = "@+id/right_view2"

android:background = "@drawable/blue"

android:layout_width = "fill_parent"

android:layout_height = "wrap_content"

android:layout_below = "@id/right_view1" android:text = "第二组第二项" />

</ RelativeLayout >

即只能在组件布局代码后,或者在组件的前面添加注释。如下所示:

<RelativeLayout

android:id="@+id/item_layout"

android:layout_width="fill_parent"

android:layout_height="wrap_content"

android:orientation="vertical" >

<!-- -->

<LinearLayout

android:layout_width="fill_parent"

android:layout_height="wrap_content"

android:orientation="vertical" >

<!-- -->

</LinearLayout>

</RelativeLayout>

。C# 允许开发人员在源代码中插入VS XML注释,这在多人协作开发的时候显得特别有用。 C#分析器可以把代码文件中的这些XML标记提取出来,并作进一步的处理为外部文档。 这篇文章将展示如何 运用这些VS XML注释。作者演示了如何 生成工程,如何 把VS XML注释输出为有用文档,如何 把这些注释转变为帮助文件。 在项目开发中,很多人并不乐意写繁杂的文档。但是,开发组长希望代码注释尽可能细致;项目筹划人员希望代码设计文档尽可能详尽;测试、检查人员希望功能说明书尽可能细致等等。 假如这些文档都被要求写的话,保持它们同步比实行一个战役还痛苦。 为何不把这些信息保存在一个地点呢??最明显想到的地点就是代码的注释中;但是你很难通览程序,并且有些须要这些文档的人并不懂编码。这篇文章将展示如何 通过运用 VS XML注释来处理这些疑问。代码注释、用户手册、开发人员手册、测试计划等很多文档可以很方便的从VS XML注释中取得。我将先演示如何 插入XML注释、如何 把这些XML注释导出为另一个文档。然后再讨论每个XML标记的意思,以及运用 XML和XSL生成帮助文件。所有的XML注释都在三个向前的斜线之后(///)。两条斜线表示是一个注释,编译器将忽略后面的内容。三条斜线告诉编译器,后面是VS XML注释,须要适当地处理。当开发人员输入三个向前的斜线后,Microsoft Visual Studio .NET IDE 自动检查它能不能在类或者类成员的解释的前面。假如是的话,Visual Studio .NET IDE 将自动插入注释标记,开发人员只须要添加些额外的标记和值。下面就是在成员函数前添加三个斜线,自动添加的注释。


欢迎分享,转载请注明来源:内存溢出

原文地址: http://outofmemory.cn/bake/11410430.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2023-05-15
下一篇 2023-05-15

发表评论

登录后才能评论

评论列表(0条)

保存