Pack URI 配置可供開放式封裝慣例 (OPC) 規格使用，以描述用來組織及識別內容的模型。 這個模型的主要項目包括封裝 (Package) 和組件 (Part)，其中「封裝」(Package) 是一個或多個「組件」(Part) 的邏輯容器 (Container)。 下圖說明這個概念。

為了識別組件，OPC 規格利用 RFC 2396 (Uniform Resource Identifiers (URI): Generic Syntax) 來定義 Pack URI 配置。

URI 指定的配置是由其前置字元所定義；http、ftp 和 file 都是已知的範例。 Pack URI 配置使用 "Pack" 做為其配置，其中包含兩個元件：授權和路徑。 Pack URI 的格式如下：

pack://authority/path

authority (授權) 指定包含組件之封裝的類型，而 path (路徑) 則指定組件在封裝內的位置。

下圖說明這個概念：

封裝和組件類似於應用程式和檔案，而其中應用程式 (封裝) 可以包含一個或多個檔案 (組件)，包括：

• 編譯成本機組件 (Assembly) 的資源檔。

• 編譯成受參考組件 (Referenced Assembly) 的資源檔。

• 編譯成參考組件 (Referencing Assembly) 的資源檔。

• 內容檔。

• 來源網站檔。

為了存取這些檔案類型，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 檔案編譯成組件的方式與資源檔相同。 因此，MSBuild Page 項目可以使用資源檔的 Pack URI 來識別。

通常設定成 MSBuild Page 項目的 XAML 檔案具有下列其中一個根項目 (Root Element)：

• 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 來設定適當的屬性 (Attribute)。

例如，以本機組件中資源檔的下列絕對 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 包含參考 Root\SubFolder\Page2.xaml 的 URI，則此參考可以使用下列相對 Pack URI。

Page2.xaml

如果 Page1.xaml 包含參考 Root\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 屬性的組件中繼資料 (Metadata)。

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>

概念