ExceptionRoutedEventArgs Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece dados de evento para exceções geradas como eventos por operações assíncronas, como ImageFailed.
public ref class ExceptionRoutedEventArgs : RoutedEventArgs/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ExceptionRoutedEventArgs : RoutedEventArgs[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ExceptionRoutedEventArgs : RoutedEventArgsPublic Class ExceptionRoutedEventArgs
Inherits RoutedEventArgs- Herança
- Derivado
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Exemplos
Este exemplo mostra o uso de ExceptionRoutedEventArgs em um manipulador para obter o HResult e a mensagem de erro.
private void videoMediaElement_MediaFailed(object sender, ExceptionRoutedEventArgs e)
{
// get HRESULT from event args
string hr = GetHresultFromErrorMessage(e);
// Handle media failed event appropriately
}
private string GetHresultFromErrorMessage(ExceptionRoutedEventArgs e)
{
String hr = String.Empty;
String token = "HRESULT - ";
const int hrLength = 10; // eg "0xFFFFFFFF"
int tokenPos = e.ErrorMessage.IndexOf(token, StringComparison.Ordinal);
if (tokenPos != -1)
{
hr = e.ErrorMessage.Substring(tokenPos + token.Length, hrLength);
}
return hr;
}
Comentários
Não exiba cadeias de caracteres ErrorMessage para os usuários finais. Em vez disso, use subcadeias de caracteres e códigos dentro da cadeia de caracteres para identificar positivamente a condição de erro e fazer com que seu aplicativo execute a ação apropriada ou exiba informações apropriadas ao usuário na interface do usuário do aplicativo.
ExceptionRoutedEventArgs são os dados de evento para vários eventos que usam o delegado ExceptionRoutedEventHandler . Estão incluídos:
- Image.ImageFailed
- ImageBrush.ImageFailed
- BitmapImage.ImageFailed
- MediaElement.MediaFailed; para esse evento, você pode converter os dados do evento para o resultado MediaFailedRoutedEventArgs mais específico.
Classes derivadas de ExceptionRoutedEventArgs
ExceptionRoutedEventArgs é a classe pai de MediaFailedRoutedEventArgs.
Propriedades
| ErrorMessage |
Obtém o componente de mensagem da exceção, como uma cadeia de caracteres. |
| OriginalSource |
Obtém uma referência ao objeto que gerou o evento. Isso geralmente é uma parte de modelo de um controle em vez de um elemento que foi declarado na interface do usuário do aplicativo. (Herdado de RoutedEventArgs) |