示例：ReportViewer 的网站日志分析器

Web 日志分析器示例是一个 Windows 窗体应用程序，用于分析 Web 服务器 [如 Microsoft Internet Information Server (IIS)] 创建的日志文件，包含显示有关页点击次数、服务器活动和其他网站推荐的统计信息的报表。

Web 日志分析器具有允许配置分析中包含文件的功能。您可以选择 Web 服务器生成的日志文件并筛选出特定的文件类型。

可以在 Visual Basic 中获得此示例。若要将所有示例文件复制到您的计算机，请单击页顶部的“磁盘”图标。若要查看单个文件，请选择文件名并单击“查看”图标。并非所有示例文件都可以直接从此页进行查看。位于文件夹中的示例文件不显示在列表中。

本主题解释如何运行和修改示例，还介绍用于修改报告中的表的可选指令。表由多个部分组成。每个部分都有自己的属性和操作（例如，若要添加列，则必须选择相邻的列）。若要了解有关表的详细信息，请参阅添加表数据区域。有关其他示例和开发人员演练的详细信息，请参阅示例和演练。

注意
在打开 MainForm.vb 之前，请确保先生成应用程序。

运行示例

在 Visual Studio 2005 中打开 WebLogAnalyzer.sln。
按 F5 键编译并运行示例。应用程序启动后，将分析项目中包含的示例日志文件，并以表和图表的形式显示结果。您可以使用计算机中的不同日志文件来查看实际数据。
在 Web 日志分析器中，从“文件”菜单中选择“打开日志文件”。默认情况下，Web 日志存储在 C:\Windows\system32\LogFiles\W3SVC1 目录下。
选择包含日志文件的文件夹，然后单击“确定”。应用程序将读取所选文件夹中的所有日志文件、分析数据并显示结果。
还可以筛选出不希望进行分析的文件类型（如图像文件和样式表）。若要执行此操作，请转到“查看”菜单并选择“忽略文件”。在该对话框中，键入要忽略的文件扩展名列表（用逗号分隔）。单击“确定”。若要刷新报表，请选择“文件”菜单中的“打开日志文件”，重新打开日志文件。

尝试 ReportViewer 工具栏上的选项以查看如何进行打印、搜索和页面导航。主报表包含用于导航到报表特定部分的文档结构图。可以通过 ReportViewer 工具栏打开文档结构图。

更改标题栏中显示的文本

在解决方案资源管理器中，右键单击 MainForm.vb，然后选择“视图设计器”。
在“属性”窗口中，确保从下拉列表中选择 MainForm，然后找到并更改 Text 属性的值。例如，将文本从“Web 日志分析器”更改为“[公司名称] Web 日志分析器”。
按 ENTER 键后，窗体的 Text 属性便更改了。请注意，窗体的标题栏将显示新文本。

向图表添加三维效果

在解决方案资源管理器中，双击 MainReport.rdlc 打开报表。
右键单击该图表，然后选择“属性”。
在“图表属性”对话框中，切换到“三维效果”选项卡。
选择“以三维效果显示图表”。
使用滑块来旋转三维图表。
单击“确定”关闭对话框。

更改图表中的条形的颜色

在解决方案资源管理器中，双击 MainReport.rdlc 打开报表。
右键单击该图表，然后选择“属性”。
切换到“数据”选项卡，然后单击“值”列表旁边的“编辑”按钮。
在“编辑图表值”对话框中，切换到“外观”选项卡。
单击“序列样式”按钮打开“样式属性”对话框。
切换到“填充”选项卡，然后选择新的颜色。

更改所显示的最常用页的数目

在解决方案资源管理器中，双击 MainReport.rdlc。
单击“最常用页”标题下的表。将显示该表的各种选择器。
右键单击详细信息行的行选择器，然后选择“编辑组”。
在“详细信息分组”对话框中，选择“筛选器”选项卡。在第一个筛选器的“值”列中，输入要显示的行数。请注意，值必须以等号 (=) 开始，以便将其解释为数字而不是文本字符串。

显示引用您的网站最频繁的外部站点

在解决方案资源管理器中，双击 LogFileEntry.vb。

Find the LogFileEntry class and add a Referrer property:

Public ReadOnly Property Referrer() As String
    Get
        Return m_referrer
    End Get
End Property

在“生成”菜单中，单击“生成 WebLogAnalyzer”以确保没有错误。
在解决方案资源管理器中，展开“报表”文件夹并双击 MainReport.rdlc。
滚动到报表底部，然后向上拖动表体的下边缘以为新表留出空间。
将表从工具箱中拖到报表中。
默认情况下，表有三列。您可以删除最后一列，因为该列不是必需的。右键单击最后一列的列标题，然后单击“删除”。
将列调整为适合数据的大小。可以通过拖动列边框来调整列的大小。缩短第二列的宽度，该列只需容纳一个数字。可以加宽第一列的宽度，以利用表的剩余空间。
从“数据”菜单中选择“显示数据源”。“数据源”窗口中将显示 LogFileEntry 类的公共属性。请注意，新添加的 Referrer 属性也会显示。
将 Referrer 属性从“数据源”窗口拖动到表中第一列的详细信息行（详细信息行为中间行）。请注意，页眉行将自动填充为默认列标题。
右键单击详细信息行的行选择器，然后选择“编辑组”。
在“详细信息分组”对话框中，单击表中“组”的第一行。从下拉列表中选择 =Fields!Referrer.Value。
在“详细信息分组”对话框中，切换到“筛选器”选项卡。在“表达式”列中，键入 =CountRows()。在“运算符”列中，选择“前 N 个”。在“值”列中，键入 =10，然后单击“确定”关闭对话框。
在表的第二列的页眉行中键入 Referrals，在详细信息行中键入 =CountRows()。
右键单击表选择器，然后选择“属性”。
在“表属性”对话框中，切换到“排序”选项卡。在“表达式”列中键入 =CountRows()，在“方向”列中选择“降序”。
也可以筛选出特定的外部站点，如您自己的站点。在“表属性”对话框中，切换到“筛选器”选项卡。在“表达式”列中，键入 =Fields!Referer.Value.StartsWith("http://mysite")。（将“http://mysite”替换为您的站点 URL。）在“运算符”列中，选择 =。在“值”列中，键入 =False。
也可以在“属性”窗口中指定页眉行、详细信息行和表的字体、颜色和边框。
生成应用程序以查看所做更改。

要求

Microsoft Visual Studio 2005 中必须具有 Visual Basic 编译器。

IIS 中的 Web 日志提供报表中使用的数据。示例中包含静态数据文件，以便可以运行该示例。若要从 Web 服务器使用日志文件，则必须具有对 IIS 实例的访问权限。

演示

源代码阐释了下列内容：

创建包含图表、表、文档结构图等的客户端报表定义 (.rdlc) 文件。
创建从 Windows 窗体中运行报表的 ReportViewer Web 服务器控件。
使用 ReportViewer 类的 ReportRefresh 和 Drillthrough 方法。
使用 ReportViewer 类的 LocalReport 和 DocumentMapCollapsed 属性。
使用 LocalReport 类的 DataSources。
使用 Report 类的 GetDocumentMap 方法。