ImageBrush.ImageFailed 事件

定义

命名空间:

Windows.UI.Xaml.Media

当存在与图像检索或格式关联的错误时发生。

public:
 virtual event ExceptionRoutedEventHandler ^ ImageFailed;

// Register
event_token ImageFailed(ExceptionRoutedEventHandler const& handler) const;

// Revoke with event_token
void ImageFailed(event_token const* cookie) const;

// Revoke with event_revoker
ImageBrush::ImageFailed_revoker ImageFailed(auto_revoke_t, ExceptionRoutedEventHandler const& handler) const;

public event ExceptionRoutedEventHandler ImageFailed;

function onImageFailed(eventArgs) { /* Your code */ }
imageBrush.addEventListener("imagefailed", onImageFailed);
imageBrush.removeEventListener("imagefailed", onImageFailed);
- or -
imageBrush.onimagefailed = onImageFailed;

Public Custom Event ImageFailed As ExceptionRoutedEventHandler 

<ImageBrush ImageFailed="eventhandler"/>

事件类型

ExceptionRoutedEventHandler

注解

如果此事件触发，则表示 ImageSource 值已异步确定为不可用，或者不适合使用。 发生此事件的条件包括：

• 找不到文件
• 无效 (无法识别或不受支持的) 文件格式
• 在这种情况下，上传 ImageBrush 后出现未知的文件格式解码错误不会显示任何内容。 应用图像没有默认的“缺失图像”占位符图像，因为浏览器可能无法解析图像 URI。 如果需要此类行为，则必须实现它。

ImageFailed 和 ImageOpened 是互斥的。 每当 ImageBrush 设置或重置 ImageSource 值时，将始终提交一个事件或另一个事件。