Pack URI 方案由 Open Packaging Conventions（开放式打包约定，OPC）规范使用，该规范描述用于组织和标识内容的模型。 此模型的关键元素是程序包和部件，其中，“程序包”是一个或多个逻辑“部件”的逻辑容器。 下图阐释了此概念。

为了标识部件，OPC 规范利用 RFC 2396（统一资源标识符 (URI)：一般语法）的扩展性来定义 pack URI 方案。

URI 所指定的方案由其前缀定义；http、ftp 和 file 是众所周知的示例。 Pack URI 方案使用“pack”作为它的方案，并且包含两个组件：授权和路径。 以下是 pack URI 的格式。

pack://授权/路径

授权 指定包含部件的程序包的类型，而路径 则指定部件在程序包中的位置。

下图阐释了此概念：

程序包和部件之间的关系类似于应用程序和文件之间的关系，其中，应用程序（程序包）可以包含一个或多个文件（部件），包括：

• 编译到本地程序集中的资源文件。

• 编译到所引用的程序集中的资源文件。

• 编译到进行引用的程序集中的资源文件。

• 内容文件。

• 源站点文件。

为了访问这些类型的文件，WPF 支持两种授权：application:/// 和 siteoforigin:///。 Application:/// 授权标识在编译时已知的应用程序数据文件，包括资源文件和内容文件。 Siteoforigin:/// 授权标识源站点文件。下图显示了每种授权的范围。

说明
Pack URI 的授权组件是一个嵌入式 URI，它指向程序包并且必须符合 RFC 2396。 另外，必须用字符“,”替换字符“/”，并且必须对保留字符（如“%”和“?”）进行转义。 有关详细信息，请参见 OPC。

以下各节解释如何将这两种授权与用于标识资源、内容和源站点文件的相应路径结合起来，以便构造 pack URI。

将资源文件配置为 MSBuild Resource 项并将其编译到程序集中。 WPF 支持构造可用于标识资源文件的 Pack URI，这些资源文件要么编译到本地程序集中，要么编译到从本地程序集引用的程序集中。

本地程序集资源文件

所引用的程序集资源文件

内容文件的 pack URI 使用以下授权和路径：

• 授权：application:///。

• 路径：内容文件的名称，包括其相对于应用程序的主可执行程序集的文件系统位置的路径。

下面的示例演示一个 XAML 内容文件的 pack URI，该内容文件与可执行程序集位于同一个文件夹中。

pack://application:,,,/ContentFile.xaml

下面的示例演示一个 XAML 内容文件的 pack URI，该内容文件位于一个相对于应用程序的可执行程序集的子文件夹中。

pack://application:,,,/Subfolder/ContentFile.xaml

说明
无法导航到 HTML 内容文件。 URI 方案仅支持导航到位于源站点的 HTML 文件。

源站点文件的 pack URI 使用以下授权和路径：

• 授权：siteoforigin:///。

• 路径：源站点文件的名称，包括其相对于启动可执行程序集的位置的路径。

下面的示例演示一个 XAML 源站点文件的 pack URI，该源站点文件存储在启动可执行程序集的位置。

pack://siteoforigin:,,,/SiteOfOriginFile.xaml

下面的示例演示一个 XAML 源站点文件的 pack URI，该源站点文件存储在相对于启动应用程序的可执行程序集的位置的子文件夹中。

pack://siteoforigin:,,,/Subfolder/SiteOfOriginFile.xaml

被配置为 MSBuild Page 项的 XAML 文件按照与资源文件相同的方式编译到程序集中。 因此，可以使用资源文件的 pack URI 来标识 MSBuild Page 项。

通常被配置为 MSBuild Page 项的 XAML 文件类型将下列元素之一作为它们的根元素：

• System.Windows.Window

• System.Windows.Controls.Page

• System.Windows.Navigation.PageFunction<T>

• System.Windows.ResourceDictionary

• System.Windows.Documents.FlowDocument

• System.Windows.Controls.UserControl

完全限定 pack URI 包括方案、授权和路径，它被视为绝对 pack URI。 作为一种针对开发人员的简化形式，XAML 元素通常允许您使用只包含路径的相对 pack URI 来设置相应的特性。

例如，假设本地程序集中的某个资源文件具有以下绝对 pack URI。

pack://application:,,,/ResourceFile.xaml

引用此资源文件的相对 pack URI 如下所示。

/ResourceFile.xaml

说明
因为源站点文件不与程序集相关联，所以只能使用绝对 pack URI 引用源站点文件。

默认情况下，将相对 pack URI 视为相对于包含引用的标记或代码的位置。 但是，如果使用前导反斜杠，则将相对 pack URI 引用视为相对于应用程序的根目录。 例如，假设有以下项目结构。

App.xaml

Page2.xaml

\SubFolder

+ Page1.xaml

+ Page2.xaml

如果 Page1.xaml 包含引用“根目录\子文件夹\Page2.xaml”的 URI，则该引用可以使用下面的相对 pack URI。

Page2.xaml

如果 Page1.xaml 包含引用“根目录\Page2.xaml”的 URI，则该引用可以使用下面的相对 pack URI。

/Page2.xaml

Pack URI 的格式使得有可能让不同类型的文件的 pack URI 看起来相同。 例如，假设有以下绝对 pack URI。

pack://application:,,,/ResourceOrContentFile.xaml

此绝对 pack URI 可以引用本地程序集中的资源文件，也可以引用内容文件。 对于下面的相对 URI 来讲也是如此。

/ResourceOrContentFile.xaml

为了确定 pack URI 引用的文件的类型，WPF 使用下面的试探法来解析本地程序集中的资源文件以及内容文件的 URI：

1. 探测与 pack URI 匹配的 AssemblyAssociatedContentFileAttribute 特性的程序集元数据。

2. 如果找到 AssemblyAssociatedContentFileAttribute 特性，则 pack URI 的路径引用内容文件。

3. 如果未找到 AssemblyAssociatedContentFileAttribute 特性，则探测编译到本地程序集中的资源文件集。

4. 如果找到与 pack URI 的路径匹配的资源文件，则 pack URI 的路径引用资源文件。

5. 如果未找到合适的资源，则内部创建的 Uri 无效。

URI 解析不适用于引用以下文件的 URI：

• 所引用的程序集中的内容文件：WPF 不支持这些文件类型。

• 所引用的程序集中的嵌入式文件：标识这些文件的 URI 是唯一的，因为它们既包含所引用的程序集的名称，又包含 ;component 后缀。

• 源站点文件：标识这些文件的 URI 是唯一的，因为只有这些文件才能用包含 siteoforigin:/// 授权的 pack URI 进行标识。

Pack URI 解析所允许使用的一种简化形式是让代码在一定程度上独立于资源和内容文件的位置。 例如，如果本地程序集中有一个被重新配置为内容文件的资源文件，则该资源的 pack URI 会保留原样，而使用该 pack URI 的代码也是如此。

许多 WPF 类都实现了可以用 pack URI 设置的属性，包括：

• Application.StartupUri

• Frame.Source

• NavigationWindow.Source

• Hyperlink.NavigateUri

• Window.Icon

• Image.Source

可以从标记和代码中设置这些属性。 本节演示这两种设置方式的基本构造，然后演示通用方案示例。

在标记中使用 Pack URI

在代码中使用 Pack URI

Uri uri = new Uri("pack://application:,,,/File.xaml");

Uri uri = new Uri("/File.xaml");

// Absolute URI (default)

Uri absoluteUri = new Uri("pack://application:,,,/File.xaml", UriKind.Absolute);

// Relative URI

Uri relativeUri = new Uri("/File.xaml", UriKind.Relative);

// Relative or Absolute URI provided by user via a text box

TextBox userProvidedUriTextBox = new TextBox();

Uri uri = new Uri(userProvidedUriTextBox.Text, UriKind.RelativeOrAbsolute);

常见 Pack URI 方案

<Application

    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

    StartupUri="MainWindow.xaml" />

<Application

    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

    StartupUri="HomePage.xaml" />

<Page

  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

  WindowTitle="Page With Hyperlink"

  WindowWidth="250"

  WindowHeight="250">

...

<Hyperlink NavigateUri="UriOfPageToNavigateTo.xaml">

  Navigate to Another Page

</Hyperlink>

...

</Page>

<Window

  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

  x:Class="SDKSample.MainWindow"

	Icon="WPFIcon1.ico">

</Window>

<MediaElement Stretch="Fill" LoadedBehavior="Play" Source="pack://siteoforigin:,,,/Media/bee.wmv" />

<MediaElement Stretch="Fill" LoadedBehavior="Play" Source="pack://siteoforigin:,,,/Media/ringin.wav" />

<Image Source="Images/Watermark.png" />

<Application

    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

    StartupUri="HomePage.xaml">

  <Application.Resources>

    <ResourceDictionary Source="pack://siteoforigin:,,,/PageTheme.xaml" />

  </Application.Resources>

</Application>

概念