在WebMatrix中或是NuGet库中可以获得很多的Web Helper,下面我们来看看如何利用ASP.NET框架来进行这些Helper的开发。Helper在NuGet库中都是以被编译好的DLL文件的形式发布的,这些Web Helper存在的目的是把大量的常用、复杂的函数压缩进一个简单的文件中,在需要时,可以通过一个行简单的代码进行调用。一经执行,这些简单的代码会在你的页面中写出HTML代码来。

使用微软翻译部件

1、要得到微软翻译部件,请进入http://www.microsofttranslator.com/widget/

14-1

2、在此你可以为你的页面进行一些细节上的设置。输入你的站点地址和默认的站点语言。还有三个翻译选项:

  • Manual 在页面上生成一个小部件,让用户自主选择需要翻译转换的语言。
  • Notify 侦测浏览器的语言和站点的语言是否相同,如果不同,询问用户是否自行翻译。这种情况下,页面上看不到部件的存在。
  • Auto 侦测浏览器的语言和站点的语言是否相同,如果不同,将自动执行翻译。部件也不会在页面上显示。

3、将页面滚动到底端,会看到一个复选框来表示同意微软的条款,然后Generate Code(生成代码):

14-2

4、复制这些HTML代码。在WebMatrix中从模板创建面包店程序,打开About.cshtml页面。

5、在代码底部的</p>之前,粘贴刚才的内容。

14-3

6、运行About页面:

14-4

现在我们可以来选择要进行翻译的目标语言了,来转到法语试试:

14-5

首先,Fourth Coffee是图片,这个翻译引擎不会将其进行翻译,如果希望也能进行转换,那么你需要在网站设计时对这点进行考虑。还有一点值得高兴的是,这个小部件支持对Twitter的翻译,因为一般的Twitter列表是以HTML和JavaScript形式被输出的。这也是应用Razor和Web Helper的好处。当然,如果你的Twitter是以编译为Flash的形式进行表现的,那么它将不能被翻译。

为这个部件创建一个Helper

使用CSHTML来创建Helper是非常容易的,支持C#和VB的Razor语法。必须要注意,只能在App_Code文件夹中来创建它们。

1、在文件工作区的项目名称上右键-新建文件夹,命名App_Code。

2、在App_Code文件夹上右键-新建文件。创建一个CSHTML文件,命名为Translator.cshtml。

14-6

3、进入这个文件,去掉所有的代码,然后键入以下内容:

@helper GetWidget(){
   
}

4、在大括号内粘入刚才微软翻译部件页面上获得的生成代码:

@helper GetWidget(){
<div id="MicrosoftTranslatorWidget" style="width: 200px; min-height: 83px; border-color: #3A5770; background-color: #78ADD0;"><noscript><a href="http://www.microsofttranslator.com/bv.aspx?a=http%3a%2f%2flocalhost%3a46021%2f">翻译此页</a><br />提供商 <a href="http://www.microsofttranslator.com">Microsoft® Translator</a></noscript></div> <script type="text/javascript"> /* <![CDATA[ */ setTimeout(function() { var s = document.createElement("script"); s.type = "text/javascript"; s.charset = "UTF-8"; s.src = ((location && location.href && location.href.indexOf('https') == 0) ? "https://ssl.microsofttranslator.com" : "http://www.microsofttranslator.com" ) + "/ajax/v2/widget.aspx?mode=manual&from=zh-CHS&layout=ts"; var p = document.getElementsByTagName('head')[0] || document.documentElement; p.insertBefore(s, p.firstChild); }, 0); /* ]]> */ </script>
}

5、回到About.cshtml页面,将里面HTML代码替换如下:

@Translator.GetWidget()

6、重新查看页面,这个页面和之前的结果是完全一样的!

至此,我们完成了我们的第一个Helper!

使用Translator API来建立Helper

除了以上的方式,微软还提供了一套API来使用。

获得API秘钥

我们先去从Bing上获得一个秘钥。

1、使用Windows Live ID登录http://www.bing.com/developers/appids.aspx

14-7

2、来添加一个秘钥,需要填写如下内容:

14-8

在填好所有内容后,会看到如下一个记录被生成了:

14-9

现在你拥有了一个Bing API秘钥。将这个号码记录好,一会儿使用它。

使用翻译API

http://www.microsofttranslator.com/dev/上有API的所有使用方式。

14-10

这里有很多非常不错的文档和示例,包括了很多不同的接口方式:AJAX、SOAP、HTTP等。

1、我们将使用HTTP方式,选到这项,我们跳转到了MSDN上:

14-11

2、点击Translate Method链接,右边的页面会看到具体的介绍,而且页面下方还有一个C#的示例。

14-12

需要注意一定要将对应的地方填写自己的那个秘钥。

创建Helper

之前创建的Helper使用的是@helper语法格式,为了采用更为标准的编程方式,我们将采用@functions语法格式。

1、在Translator.cshtml文件中写下如下代码:

@functions{
    public static string GetTranslation(string texttotrans,
                                        string langfrom,
                                        string langto)
    {
       
    }
}

熟悉C#语言的会知道这是返回一个string的函数,附带3个参数。

2、我们来放置一些初始化代码:

string appId = "------写你自己刚刚生成的秘钥-------";
string translatedText = "";
string uri = "http://api.microsofttranslator.com/v2/Http.svc/Translate?appId=" + appId + "&text=" + texttotrans + "&from=" + langfrom + "&to=" + langto;

3、接下来向翻译服务发出请求:

HttpWebRequest request = (HttpWebRequest)WebRequest.Create(uri);
WebResponse response = request.GetResponse();
4、现在你已经得到响应,余下的操作就是读取内容了。服务返回的是XML,所以下面的代码能够去除XML的标记:

using (Stream stream = response.GetResponseStream())
{
    System.Runtime.Serialization.DataContractSerializer dcs = new System.Runtime.Serialization.DataContractSerializer(texttotrans.GetType());
    translatedText = (string)dcs.ReadObject(stream);
}
5、现在已经有了翻译后的文本了,可以提交返回了:

添加好return translatedText;

文件中的整体代码如下:

@helper GetWidget(){
    <div id="MicrosoftTranslatorWidget" style="width: 200px; min-height: 83px; border-color: #3A5770; background-color: #78ADD0;"><noscript><a href="http://www.microsofttranslator.com/bv.aspx?a=http%3a%2f%2flocalhost%2f">翻译此页</a><br />提供商 <a href="http://www.microsofttranslator.com">Microsoft® Translator</a></noscript></div> <script type="text/javascript"> /* <![CDATA[ */ setTimeout(function() { var s = document.createElement("script"); s.type = "text/javascript"; s.charset = "UTF-8"; s.src = ((location && location.href && location.href.indexOf('https') == 0) ? "https://ssl.microsofttranslator.com" : "http://www.microsofttranslator.com" ) + "/ajax/v2/widget.aspx?mode=manual&from=zh-CHS&layout=ts"; var p = document.getElementsByTagName('head')[0] || document.documentElement; p.insertBefore(s, p.firstChild); }, 0); /* ]]> */ </script>
}
@functions{
    public static string GetTranslation(string texttotrans,
                                        string langfrom,
                                        string langto)
    {
        string appId = "--------你自己的秘钥-----------";
        string translatedText = "";
        string uri = "http://api.microsofttranslator.com/v2/Http.svc/Translate?appId=" + appId + "&text=" + texttotrans + "&from=" + langfrom + "&to=" + langto;
        HttpWebRequest request = (HttpWebRequest)WebRequest.Create(uri);
        WebResponse response = request.GetResponse();
        using (Stream stream = response.GetResponseStream())
        {
            System.Runtime.Serialization.DataContractSerializer dcs = new System.Runtime.Serialization.DataContractSerializer(texttotrans.GetType());
            translatedText = (string)dcs.ReadObject(stream);
        }
    return translatedText;
    }
}

使用Helper

调用的方式是@HelperName.FunctionName(参数表)。HelperName就是文件的名字(Translator),FunctionName就是GetTranslation。调用代码大致如下:

@Translator.GetTranslation("Hello, I am Scott", "en", "zh-cn")

在About页面中加入如下代码:

<p>@Translator.GetTranslation("Hello, I am Scott", "en", "zh-cn")</p>

然后我们会发现这个页面的变化:

14-13

现在我们使用纯C#代码来实现了翻译功能!

我们也展示了在WebMatrix使用C#语言和Razor的@helper和@function标签来进行包封。

接下来的步骤就是在Microsoft Visual Studio来创建这个Helper的DLL文件,可以把它打包并发布到NuGet里。

本文标签: WEbMatrix,NuGet,Helper
posted on 2012-01-11 21:38  雪美·考拉  阅读(848)  评论(2编辑  收藏  举报