c#代码注释

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了c#代码注释相关的知识,希望对你有一定的参考价值。

private void ValidateCode(string VNum)

Bitmap Img = null;
Graphics g = null;
MemoryStream ms = null;
int gheight = VNum.Length * 9;
Img = new Bitmap(gheight, 18);
g = Graphics.FromImage(Img);
//背景颜色
g.Clear(Color.WhiteSmoke);
//文字字体
Font f = new Font("Tahoma", 9);
//文字颜色
SolidBrush s = new SolidBrush(Color.Red);
g.DrawString(VNum, f, s, 3, 3);
ms = new MemoryStream();
Img.Save(ms, ImageFormat.Jpeg);
Response.ClearContent();
Response.ContentType = "image/Jpeg";
Response.BinaryWrite(ms.ToArray());
g.Dispose();
Img.Dispose();
Response.End();

private string RndNum(int VcodeNum)

string MaxNum = "";
string MinNum = "";
for (int i = 0; i < 5; i++)//这里的4是验证码的位数

MaxNum = MaxNum + "5";

MinNum = MaxNum.Remove(0, 1);
Random rd = new Random();
string VNum = Convert.ToString(rd.Next(Convert.ToInt32(MinNum), Convert.ToInt32(MaxNum)));
return VNum;
拜托各位帮忙加下注释

你好!

看了你的代码 你用的是GDI+

你是想 做随机验证码!

我给你源码:
<%@ Page Language="C#" ContentType="text/html" ResponseEncoding="utf-8" Debug="true" %>
<%@ import namespace="System"%>
<%@ import namespace="System.IO"%>
<%@ import namespace="System.Drawing"%>
<%@ import namespace="System.Drawing.Imaging"%>
<script runat="server">
private void Page_Load(object sender, System.EventArgs e)
ValidateCode( RndNum(6) );;//测试


private void ValidateCode(string VNum)
Bitmap Img = null;
Graphics g = null ;
MemoryStream ms = null ;

int gheight = VNum.Length*12;
Img = new Bitmap(gheight,20);
g = Graphics.FromImage(Img);
Font f = new Font( "新宋体",12 );
SolidBrush s = new SolidBrush( Color.Red );
g.DrawString(VNum,f,s,3,3);
ms=new MemoryStream();
Img.Save(ms,ImageFormat.Png);
Response.ClearContent() ;//更改http ContentType
Response.ContentType="image/Png";
Response.BinaryWrite(ms.ToArray());
//回收资源
g.Dispose();
Img.Dispose();
Response.End();

private string RndNum(int VcodeNum)
string Vchar = "0,1,2,3,4,5,6,7,8,9,A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,W,X,Y,Z" ;
string[] VcArray = Vchar.Split(',') ;
string VNum = "" ;//由于字符串很短,就不用StringBuilder了
int temp = -1 ;//记录上次随机数值,尽量避免生产几个一样的随机数

//采用一个简单的算法以保证生成随机数的不同
Random rand =new Random();
for ( int i = 1 ; i < VcodeNum+1 ; i++ )
if ( temp != -1)
rand =new Random(i*temp*unchecked((int)DateTime.Now.Ticks));

int t = rand.Next(35) ;
if (temp != -1 && temp == t)
return RndNum( VcodeNum );

temp = t ;
VNum += VcArray[t];


return VNum ;

</script>
参考技术A private void ValidateCode(string VNum)

Bitmap Img = null;
Graphics g = null;
MemoryStream ms = null;
int gheight = VNum.Length * 9;
Img = new Bitmap(gheight, 18);//创建一个位图对象,宽为gheight,高为18
g = Graphics.FromImage(Img);//准备画图
//背景颜色
g.Clear(Color.WhiteSmoke);
//文字字体
Font f = new Font("Tahoma", 9);
//文字颜色
SolidBrush s = new SolidBrush(Color.Red);
g.DrawString(VNum, f, s, 3, 3);//在指定位置写入文字
ms = new MemoryStream();
Img.Save(ms, ImageFormat.Jpeg);
Response.ClearContent();
Response.ContentType = "image/Jpeg";
Response.BinaryWrite(ms.ToArray());//向页面输出图片
g.Dispose();
Img.Dispose();
Response.End();

private string RndNum(int VcodeNum)

string MaxNum = "";
string MinNum = "";
for (int i = 0; i < 5; i++)//这里的4是验证码的位数

MaxNum = MaxNum + "5";

MinNum = MaxNum.Remove(0, 1);
Random rd = new Random();
string VNum = Convert.ToString(rd.Next(Convert.ToInt32(MinNum), Convert.ToInt32(MaxNum)));
return VNum;

链接到类、方法,尤其是 C# 注释中的特定代码行的一种方式

【中文标题】链接到类、方法,尤其是 C# 注释中的特定代码行的一种方式【英文标题】:A way to link to a class,a method, especially a specific code line in C# comment 【发布时间】:2012-09-28 00:58:06 【问题描述】:

我想使用指向目标的代码中的链接来构建某种文档。目标可以是ClassMethod 或特定代码行。 (指向特定的代码行是最重要的) 我想到了 VS2010 的扩展或特定的评论标签。 有没有办法制作这种链接?

【问题讨论】:

Javadoc 能够准确地完成这种事情。当微软发布 .Net 1.1 时,他们试图用“NDoc”来模仿 Javadoc。然后杀死 NDoc 支持“Sandcastle”:weblogs.asp.net/fmarguerie/archive/2006/02/16/…。坦率地说,他们目前的 XML 是一团糟……建议:考虑改用 [Doxygen] (stack.nl/~dimitri/doxygen)。 我刚刚尝试过,我认为它工作正常 - 只需注册加载项并阅读 Help.htm 以了解如何使用它。如果您有任何问题(因为它是为 VS 2005 和 2008 构建的),您可以重新构建解决方案(它是开源的),它应该可以正常工作。 @paulsm4 那条评论似乎有点啰嗦.. ... 据我所知,尤其是 NDoc 不是由 Microsoft 编写的。 除非您提交代码,否则无法链接特定的代码行,因为没有指向行的真正指针。如果有人在第 5 行中插入一个空行,第 80 行将变为第 81 行。特定的注释标签是一种非常合乎逻辑的方式来实现它对于不断变化的文档。如果您想引用源代码控制系统中的文件行。因为文件是固定的,所以要简单得多。 【参考方案1】:

Xml 注释 + 沙堡可能是你需要的。您可以使用引用指定的类或方法

<see cref=".."/>

和参考参数使用

<paramref name=".."/>

但是,没有直接的方法来引用某些代码行,但是您可以通过使用来引用某些#region

<code source="$sourcefile$" region="$regionname$"/>

请参考:XML Comments Guide第20页。

请注意,您引用的代码将直接显示在适当的位置,而不是链接。它并不完美,但我希望它有所帮助。

【讨论】:

以上是关于c#代码注释的主要内容,如果未能解决你的问题,请参考以下文章

自己总结的C#编码规范--4.注释篇

C#编码规范

编写高质量代码改善C#程序的157个建议——建议152:最少,甚至是不要注释

是否有用于注释 C# 代码的标准(如 phpdoc 或 python 的文档字符串)?

从 C# 类代码生成 xsd 注释和文档标签

VS.NET 2005(C#) 如何注释