• Gravatar ASP.NET 用户控件 (翻译)

    日期：2009.09.30 | 分类：ASP.net | 标签： ,

    Gravatar ASP.NET 用户控件

    原文地址：http://www.freshclickmedia.com/blog/2008/02/gravatar-aspnet-control/
    我在我自己的网站freshclickmedia.com 使用了Gravatar。Gravatar是一种根据您的电子邮件地址来显示头像的服务，不少博客用它来装饰博客评论。注册是非常简单的——所有你需要做的是提供一个电子邮件地址，一幅图片，然后设置图片的等级。

    Gravatar头像标签指包括了用MD5加密电子邮件地址的程序。最高等级的限制会阻止不受欢迎的内容。

    有很大数量的博客使用gravatar头像插件，因此我决定写一个ASP.NET用户控件去完成这项工作。下面是这个控件和它的特点。

     

    使用控件

    控件需要一个电子邮件地址来提供服务。

    <fcm:Gravatar ID='Gravatar1' runat='server' Email='username@domain.com' />

    对于我的电邮地址，我获得了这样的结果：

    ga_img01

    如果我们来看看上述网页的源代码的话：

    <a href="http://www.gravatar.com" title="Get your avatar"><img width="80" height="80" src="http://www.gravatar.com/avatar.php?gravatar_id=ccf3b8c638f15d005e5d070aeb1a3923&rating=G&size=80" alt="Gravatar" /></a>

    一般情况下会提供一个title为“Get your avatar”的标签。头像图片使用了MD5加密了电子邮件地址。这里是G等级的头像，80像素的大小。

     

    定制控件

    这个用户控件提供一些属性来定制它的输出。

    • size

                 控件的size(大小)属性可以设置在1到80的范围内。如果超出了这个范围，会使用默认值80。

    •  MaxAllowedRating

               提供“最高”级别的输出。
               G 级别：G级别代表适合任何网站面向任何人。
               PG级别：代表包含粗鲁的姿势，惹火的穿着，少量的咒骂，轻微的暴力。
               R级别：代表包含例如严重的侮辱，强烈的暴力，裸露，和瘾君子等等。
               X级别：代表包含不堪入目的性爱图像或者非常令人不安的暴力。

    •  OutputGravatarSiteLink

              默认是true，这个属性决定头像上的超级链接是否指向gravatar网站。

    •  LinkTitle

              默认值是Get your avatar，此属性允许定制头像上链接的title属性。（显然，如果OutputGravatarSiteLink的值被设置为false，这个属性就不会起作用了）

    • DefaultImage

              必须为一个正常图片的URL，当用户提供的电子邮件地址不在gravatar之中时，或者当用户头像的级别过低时，将会使用这个图片。

     

     下面的一点代码展示了相关属性的使用：

    <fcm:Gravatar runat="server" Email="username@domain.com" DefaultImage=http://www.site.com/default.jpg OutputGravatarSiteLink="true" Size="40" />
     

    下载与使用

    你可以点击这里下载Gravatar用户控件。当你解压缩zip文件后，把它添加到Visual Studio的工具箱中（toolbox）。点击菜单上的“浏览”，选择Freshclickmedia.Web.dll然后点击“确定”。

     ga_img02