用ASP.NET建立一个在线RSS新闻聚合器(3)

     显示特定聚合摘要的新闻项
  
  　　我们面临的下一个任务是创建 DisplayNewsItems.aspx 页面。这个页面会以链接的形式显示所选聚合摘要的新闻项标题，当点击标题时，新闻的内容就会显示在右下部分的框架中。要完成这一任务，我们会面临以下两个主要的挑战：
  
  　　·通过指定的 URL 访问 RSS 聚合摘要；
  
  　　·将接收到的 XML 数据转换为相应的 HTML；
  
  　　幸运的是，在.NET 框架中，要实现这两个任务都不是很难。对于第一个任务，只需要两行代码，我们就可以将远程的xml数据装载到一个XmlDocument对象中。而第二个任务呢， 借助 ASP.NET XML Web 控件在ASP.NET 页面中显示XML数据也比较容易。
  
  　　XML Web 控件被设计用于在 Web 页面中显示原始或者转换过的 XML 数据。使用 XML Web 控件的第一步是定义XML数据源，通过 定义一系列的属性，用许多方法都可以完成这一工作。使用 Document属性，你可以指定一个 XmlDocument 实例作为 XML Web 控件的 XML 数据源。如果XML数据存在于 Web 服务器文件系统的一个文件中，可以用 DocumentSource 属性，只要提供该 XML 文件的相对或者绝对路径就可以了。最后，如果你 的 XML数据是一个字符串，那么你可以将这个字符串的内容赋给控件的 DocumentContent 属性。这三种办法都可以将 XML 数据与 XML 控件联系起来。
  
  　　通常，在将 XML 数据显示到 Web 页面之前，我们会以某种方式转换 XML 数据。XML Web 控件允许我们指定一个 XSLT 样式表来做这个转换工作。与 XML 数据相似，XSLT 样式表可以通过 两个属性之一，以两种不同的方式中的一种来设置，一是 Transform 属性可被赋值给 XslTransform 实例，二是将本地 Web 服务器上 XSLT文件的 相对或绝对路径赋予 TransformSource 属性。
  
  　　现在我们来创建 DisplayNewsItems.aspx 页面。在添加 XML Web 控件以及编写后台代码类之前，我们需要在 HTML 部分加入一小段客户端 JavaScript 代码。准确地说，是在 html 部分的 ＜head＞ 标签里面 添加如下的＜script＞代码块：
  
  ＜script language="javascript"＞
  // display a blank page in the bottom frame when the news items loads
  parent.rbottom.location.href = "about:blank";
  ＜/script＞
  
  　　每当 DisplayNewsItems.aspx 页面装载的时候，这段客户端 JavaScript 代码会在右下角的框架中显示一个空白页。为了理解为什么要加入这段代码，我们来看看省略这段代码，我们会碰到什么情况：
  
  　　·用户在左边的框架中点击聚合摘要，浏览器会在右上部的框架中装载摘要新闻项；
  
  　　·用户在右上部框架中点击某个新闻项，浏览器会在右下部框架中装载这个新闻项 的详细内容；
  
  　　现在用户在左边的框架中点击其它的聚合摘要，浏览器会在右上部分的框架中装载新的摘要新闻项；
  
  　　前一个新闻项的详细内容还显示在右下部的框架中！通过上面的客户端 Javascript 代码，每次点击左面框架的摘要便可以清除右下部框架 的内容，以消除这一瑕疵。
  
  　　在我们处理了客户端代码的问题之后，让我们把注意力转到添加 XML Web 控件。一旦加入 XML Web 控件，将其 ID 属性设置为 xsltNewsItems，TransformSourc 属性设置为 NewsItems.xslt（我们将要创建的 XSLT 样式表文件的名称）。现在，在 Page_Load 事件处理函数中，我们需要 在某个 XmlDocument 实例中获取远程 RSS 聚合文件，然后将该 XML Web 控件的 Document 属性赋给该 XmlDocument 实例。
  
  　　在 Page_Load 事件处理函数中，与我们要实现的任务有密切关系的代码是最后三行代码。这三行代码创建一个新的 XmlDocument 对象， 加载远程 RSS 摘要内容，然后将这个 XmlDocument 对象赋给 XML Web 控件的 Document 属性。访问远程 XML 数据并 将它们显示在 ASP.NET 页面中就是这么简单，难道给你留下的印象不深吗？
  
  　　剩下我们要做的一件事就是创建 XSLT 样式表，NewsItems.aspx。下面是样式表的第一版的草稿：
  
  ＜?xml version="1.0" encoding="UTF-8" ?＞
  ＜xsl:stylesheet version="1.0"
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"＞
  ＜xsl:output method="html" omit-xml-declaration="yes" /＞
  
  ＜xsl:template match="/rss/channel"＞
  ＜b＞＜xsl:value-of select="title"
  disable-output-escaping="yes" /＞＜/b＞
  ＜xsl:for-each select="item"＞
  ＜li＞
  ＜a＞
  ＜xsl:attribute name="href"＞
  DisplayItem.aspx?ID=＜xsl:number value="position()" /＞
  ＜/xsl:attribute＞
  ＜xsl:attribute name="target"＞rbottom＜/xsl:attribute＞
  ＜xsl:value-of select="title"
  disable-output-escaping="yes" /＞
  ＜/a＞
  (＜xsl:value-of select="pubDate" /＞)
  ＜/li＞
  ＜/xsl:for-each＞
  ＜/xsl:template＞
  ＜/xsl:stylesheet＞
  
  　　这个XSLT样式表只有一个模版，用于匹配“/rss/channel”XPath表达式。这个模版先是以粗体显示＜title＞元素的内容。然后，循环获取每一个＜item＞元素，对于每一个元素，显示一个到 DisplayItem.aspx 页面的超链接，在查询字符串中传递＜item＞元素的位置属性。要留意超链接的 target 属性设置为 rbottom，右下部框架的名称。最后，显示每一个新闻项的标题和＜pubDate＞元素。
  
  　　该 XSLT 样式表中有两个项目，并不是每个人都熟悉。首先是 ＜xsl:value-of＞ 元素中的 disable-output-escaping="yes" 属性。从本质上讲，这个属性的设置通知 XSLT 引擎不要转义那些非法的 XML 字符，比如：&, ＜ , ＞, " 和 ’’。为了理解这个设置的意义，就要知道，如果不设置该属性（也就是设置为默认值"no"），那么如果标题包含一个转义的&字符&，那么输出的 html 文件中也会有一个&，而不单单是一个字符&。如果你再仔细想一想，你会发现这种情况会导致很多问题。例如，假设一个聚合文件的标题是“Matt’’s <i>Cool</i> Blog”，如果输出转义没有被禁止，那么输出就会保留 “Matt’’s <i>Cool</i> Blog”，在 Web 页面就会显示为 "Matt’’s ＜i＞Cool＜/i＞ Blog"。当用 disable-output-escaping="yes"设置禁止输出转义时，输出就不会被转义，上面的内容就会被当作“Matt’’s ＜i＞Cool＜/i＞ Blog”，显示在页面上就是我们想要的“Matt’’s Cool Blog”。
  
  　　另一个要注意的是元素＜a＞。这个奇怪的语法会生成下面的输出内容：
  
  ＜a href="DisplayItem.aspx?ID=position"＞news item title＜/a＞
  
  　　之所以要使用这种语法，是因为要给 XSLT 样式表中某个你要创建的元素添加一个属性，然后在该元素的标签里使用 ＜xsl:attribute＞ 语法 。有关该语法的一些例子可在 W3Schools 网站上找到：The ＜xsl:attribute＞ Element。
  
  　　最后要注意的是，超链接的ID查询字符串的值是来自于 ＜xsl:number＞ 元素，从 position() 函数中返回的值。＜xsl:number＞ 元素仅仅是输出一个数值。position()函数是一个 XPath 函数，用来返回 XML 文档中当前节点的顺序位置。这意味着对于第一个新闻项，position() 函数返回 1，第二个 新闻项，position函数返回 2，以此类推。我们需要记录这个值并将它通过查询字符串传递出去。这样当 DisplayItem.asp 页面被访问时，就可以知道显示 RSS 聚合摘要的什么项目了。
  
  　　聪明的读者可能已经注意到，我们的 XSLT 样式表没有全部完成，因为 FeedID 参数没有通过查询字符串传递到 DisplayItem.aspx 页面。要明白 这是为什么，我们回顾一下在 ID 查询串参数中所传递的是用户拟察看详细信息的＜item＞元素顺序号。也就是说，如果用户点击第四条新闻项，页面 DisplayItem.aspx?ID=4 就会被 加载到右下部分的框架中。问题在于 DisplayItem.aspx 页面无法确定用户希望查看哪一个摘要。有两个不同的方法可以解决这个问题，比如可以在右下部框架中用客户端 Javascript 代码读取右上部框架的 URL，然后确定FeedID 的值。在我看来，更简单的办法是和 ID 参数一起将 FeedID 的值通过查询字符串传递 。
  
  　　这样的话，有一个难题是 XSLT 样式表操纵的 RSS XML 数据中并没有 FeedID 值。但是 DisplayNewsItems.aspx 页面知道 FeedID 值，需要一种方法让 XSLT 样式表也知道这个值。通过使用 XSLT参数可以 实现完成。
  
  　　 XSLT 参数的使用是非常简单。在 XSLT 样式表中，你需要在 ＜xsl:template＞ 元素中加入一个＜xsl:param＞ 元素， 该元素提供参数的名称。下面的代码将这个参数命名为 FeedID：
  
  ＜xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"＞
  
  ＜xsl:template match="/rss/channel"＞
  ＜xsl:param name="FeedID" /＞
  
  ...
  ＜/xsl:template＞
  ＜/xsl:stylesheet＞
  
  　　现在，就可以用下面的语法在＜xsl:value-of＞元素中使用这个参数了：
  
  ＜xsl:value-of select="$parameterName" /＞
  
  　　最后，在我们的 XSLT 样式表中加入下面的代码，我们就可以把 FeedID 查询字符串参数加到超链接中了：
  
  ＜a＞
  ＜xsl:attribute name="href"＞DisplayItem.aspx?ID=＜xsl:number value="position()" /＞&FeedID=＜xsl:value-of select="$FeedID"
  /＞＜/xsl:attribute＞
  
  
  　　注意在ID查询字符串参数后面我们加了一个&字符（转义&）,这样我们就可以传递 FeedID 参数的值到查询字符串的 FeedID 参数中了。 这就是我们要在 XSLT 样式表中添加的内容。
  
  　　剩下的工作是在 DisplayNewsItems.aspx 页面的 Page_Load 事件处理函数中设置这个参数的值。通过使用 XsltArgumentList 类可以完成这一工作。这个类有一个 AddParameter() 方法。一旦我们创建了这个类的一个实例，加入了相应的参数，就可以将这个 实例赋给 XML Web 控件的 TransformArgumentList 参数了。下面的代码显示了更新后的 DisplayNewsItems.aspx 页面 Page_Load 事件处理函数：
  
  　　显示特定新闻项的详细内容
  
  　　还剩下最后一件需要做的事情是显示用户选择的特定新闻项的详细内容。这些详细内容将显示在右下部的框架中，而且将会显示新闻项的标题，描述和新闻项的链接等信息。和 DisplayNewsItem.aspx 页面 类似，DisplayItem.aspx 页面首先将根据传入的 FeedID 查询字符串参数获取远程的 RSS 聚合摘要，然后它会用 XML Web 控件显示这些详细内容。实际上，DisplayItem.aspx 页面的 Page_Load 事件处理函数和DisplayNewsItem.aspx 页面的 该函数几乎一样，只有以下两个小小的区别：
  
  　　·DisplayItem.aspx 页面需要读取ID查询字符串参数的值；
  
  　　·DisplayItem.aspx 页面使用一个 XSLT 参数，但是这个参数与 DisplayNewsItem.aspx 页面用的参数是不一样的；
  
  　　DisplayNewsItem.aspx 和 DisplayItem.aspx 页面一样都需要在参数中传递一个 XSLT 样式表。DisplayNewsItem.aspx 页面传递的是 参数 FeedID，而 DisplayItem.aspx 还需要传入 ID 参数，它表示 XSLT 样式表应该显示那个新闻项。这个细小的差别在以下代码中以粗体显示，以下 代码省略了与 DisplayNewsItems.aspx 页面相同的部分：
  
  　　以下是转换 XML 数据的 XSLT 样式表：
  
  ＜?xml version="1.0" encoding="UTF-8" ?＞
  ＜xsl:stylesheet version="1.0"
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"＞
  ＜xsl:output method="html" omit-xml-declaration="yes" /＞
  ＜xsl:param name="ID" /＞
  
  ＜xsl:template match="/rss/channel"＞
  ＜b＞＜xsl:value-of select="item[$ID]/title"
  disable-output-escaping="yes" /＞＜/b＞
  ＜p＞
  ＜xsl:value-of select="item[$ID]/description"
  disable-output-escaping="yes" /＞
  ＜/p＞
  ＜a＞
  ＜xsl:attribute name="href"＞＜xsl:value-of
  select="item[$ID]/link" /＞＜/xsl:attribute＞
  ＜xsl:attribute name="target"＞_blank＜/xsl:attribute＞
  Read More...
  ＜/a＞
  ＜/xsl:template＞
  ＜/xsl:stylesheet＞
  
  　　注意 ＜xsl:param＞ 元素被用于声明 ID XSLT 参数。然后，在几个不同的 ＜xsl:value-of＞ 元素中，ID 参数 被用来从 ＜item＞ 元素列表中抓取特定的 ＜item＞ 元素。在 XPath 的语法中，elementName[i]意思是根据相应元素名 存取第i个元素。例如，item[1]将只获取第一个＜item＞元素，item[2]则获取第二个元素。所以 item[$ID]是获取由 XSLT 参数 ID 定义的 特定 ＜item＞ 元素。
  
  　　最后，值得注意的还有在样式表靠近末尾部分的超链接 Read More…，它的target属性设为空，这样的话当用户点击 Read More… 链接的时候，浏览器会打开一个新的窗口。
  
  
  

原文转自：http://www.ltesting.net