ImageBrush.ImageSource 屬性

定義

命名空間:

Microsoft.UI.Xaml.Media

取得或設定這個 ImageBrush 所顯示的影像來源。 在您使用 ImageSource 子類別實例設定此項目的程式代碼中，在 XAML 中，您會使用影像來源檔案的 URI 來設定此專案。

public:
 property ImageSource ^ ImageSource { ImageSource ^ get(); void set(ImageSource ^ value); };

ImageSource ImageSource();

void ImageSource(ImageSource value);

public ImageSource ImageSource { get; set; }

var imageSource = imageBrush.imageSource;
imageBrush.imageSource = imageSource;

Public Property ImageSource As ImageSource

<ImageBrush ImageSource="imageUri"/>

屬性值

ImageSource

物件，表示套用至內容時，要由這個 ImageBrush 顯示的圖像來源。

備註

從映像來源檔案或數據流設定映射來源原本就是異步動作。 將來源設定為統一資源標識碼 (URI) 無法解析為有效映射來源檔案的值，並不會擲回錯誤。 相反地，它會在 ImageBrush 上引發 ImageFailed 事件。 如果您想要確認影像來源檔案已正確載入，您可以處理 ImageOpened 以進行驗證，加上 ImageFailed 作為提供後援映射來源或重新編譯 UI 的方式。

在 XAML 中設定 ImageSource

您可以在 XAML 中設定此屬性，但在此情況下，您會將 ImageSource 屬性值設定為代表統一資源識別符的字串 (URI) 。 此行為依賴基礎類型轉換，以統一資源標識符 (URI) 處理字串，並呼叫 BitmapImage (Uri) 建構函式的內部對等專案。

如果 XAML 中的初始 ImageSource 屬性值未指定有效的來源，就會發生 ImageFailed 事件。 您可以使用相對路徑來參考與應用程式一起封裝的映像，或絕對統一資源標識碼 (URI) 來參考來自伺服器的影像。 如果您使用封裝為應用程式一部分的映射來源，通常會使用 ms-appx 或 ms-resource 配置。

在程式代碼中設定 ImageSource

如果您使用程式代碼定義 ImageBrush，ImageBrush.ImageSource 需要 BitmapImage (不是程式碼中的統一資源識別碼 (URI) ) 。 如果您的來源是資料流，請使用 SetSourceAsync 方法來初始化該值。 如果您的來源是統一資源標識碼 (URI) 參考檔案，其中包含應用程式中使用 ms-appx 或 ms-resource 配置的內容，請使用採用統一資源標識符的 BitmapImage 建構函式 (URI) 。 如果有任何與影像來源的抓取或解碼相關的時機問題，您也可以考慮處理 ImageOpened 事件，在這種情況下，您可能需要在影像來源可供使用前先顯示替代內容。 如需範例程式代碼，請參閱 XAML 影像範例 。

如果您需要撰寫與 UI 中另一個對象相關的 URI，以協助設定資源要求的範圍，您有時可以使用 UI 中另一個物件上呼叫的 FrameworkElement.BaseUri 屬性。 這會提供基底 URI，也就是 XAML 頁面來自應用程式項目結構的位置。

注意

您可以使用自動處理來存取具有目前縮放與文化特性限定符的未限定資源，也可以使用 ResourceManager 和 ResourceMap 搭配文化特性和縮放的限定符，直接取得資源。 如需詳細資訊，請參閱資源管理系統。

影像來源和縮放

您應該以數個建議的大小建立映射來源，以確保您的應用程式在調整 Windows 8 時看起來很棒。 指定 ImageBrush 的 ImageSource 時，您可以使用命名慣例，自動參考目前調整的正確資源。 如需命名慣例的細節及其他資訊，請參閱快速入門：使用檔案或影像資源。

如需如何設計調整的詳細資訊，請參閱版面配置 和調整的UX指導方針。

如需應用程式資源以及如何封裝應用程式中映射來源的詳細資訊，請參閱 定義應用程式資源。

另請參閱

• BitmapImage(Uri)
• Image
• Image 和 ImageBrush