XamlParseException Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa a classe de exceção para exceções específicas do parser de um parser XAML WPF. Esta exceção é usada na API XAML ou WPF operações de parser XAML do .NET Framework 3.0 e .NET Framework 3.5, ou para uso específico do parser XAML WPF chamando XamlReader API.
public ref class XamlParseException : SystemException
[System.Serializable]
public class XamlParseException : SystemException
[<System.Serializable>]
type XamlParseException = class
inherit SystemException
Public Class XamlParseException
Inherits SystemException
- Herança
- Atributos
Observações
XamlParseException é usado apenas para o parser XAML implementado WPF que realiza a análise e carregamento XAML para WPF aplicações. Especificamente, a exceção só é relevante quando uma aplicação visa o .NET Framework 3.0 e o .NET Framework 3.5. A exceção também pode originar-se a partir de código de utilizador em chamadas em tempo de execução para APIs que ligam o parser XAML implementado WPF para carregar XAML a partir de uma aplicação de WPF em execução (por exemplo, chamadas para XamlReader.Load).
Para .NET Framework 4, a exceção XamlParseException que normalmente reporta exceções de processamento XAML é definida num namespace diferente (System.Xaml) e numa assembly diferente (System.Xaml).
A menos que estejas a escrever um equivalente ao parser XAML WPF ou a trabalhar com .NET Framework 3.0 e .NET Framework 3.5, geralmente não vais lançar XamlParseException do teu próprio código. No entanto, o tratamento da exceção é por vezes necessário. Para cenários de aplicação, onde pode querer suprimir erros de análise XAML, um DispatcherUnhandledException gestor de eventos ao nível da aplicação é uma forma de gerir um processo em tempo XamlParseExceptionde execução. Se deve suprimir exceções ou deixá-las aparecer no código do utilizador depende de como desenha a sua aplicação para efeitos de carregamento do XAML, e do nível de confiança que atribui ao XAML que a sua aplicação carrega. Para mais informações, consulte
Para páginas de uma aplicação, quando o XamlParseException é lançado, é geralmente no contexto da chamada InitializeComponent feita pela sua classe de página, que é o ponto de entrada para a utilização do parser XAML WPF pelo modelo de aplicação WPF ao nível de página. Portanto, outra estratégia possível de tratamento é colocar try/catch blocos em InitializeComponent. No entanto, esta técnica não se integra bem com templates, superfícies de design visual e outras fontes geradas que ligam InitializeComponent.
Construtores
| Name | Description |
|---|---|
| XamlParseException() |
Inicializa uma nova instância da XamlParseException classe. |
| XamlParseException(SerializationInfo, StreamingContext) |
Inicializa uma nova instância da XamlParseException classe. |
| XamlParseException(String, Exception) |
Inicializa uma nova instância da XamlParseException classe, usando a cadeia de mensagens de exceção especificada e a exceção interna. |
| XamlParseException(String, Int32, Int32, Exception) |
Inicializa uma nova instância da XamlParseException classe, usando a mensagem de exceção especificada, exceção interna, número de linha e posição na linha. |
| XamlParseException(String, Int32, Int32) |
Inicializa uma nova instância da XamlParseException classe, usando a cadeia de mensagens de exceção especificada, e o número e posição da linha especificados na linha. |
| XamlParseException(String) |
Inicializa uma nova instância da XamlParseException classe, usando a cadeia de mensagens de exceção especificada. |
Propriedades
| Name | Description |
|---|---|
| BaseUri |
Obtém a informação base do URI quando a exceção é lançada. |
| Data |
Obtém uma coleção de pares chave/valor que fornecem informação adicional definida pelo utilizador sobre a exceção. (Herdado de Exception) |
| HelpLink |
Obtém ou define um link para o ficheiro de ajuda associado a esta exceção. (Herdado de Exception) |
| HResult |
Recebe ou define HRESULT, um valor numérico codificado atribuído a uma exceção específica. (Herdado de Exception) |
| InnerException |
Obtém a Exception instância que causou a exceção atual. (Herdado de Exception) |
| KeyContext |
Obtém ou define o valor-chave do item num dicionário onde ocorreu a exceção. |
| LineNumber |
Recebe o número da linha onde ocorreu a exceção. |
| LinePosition |
Obtém a posição na linha onde ocorreu a exceção. |
| Message |
Recebe uma mensagem que descreve a exceção atual. (Herdado de Exception) |
| NameContext |
Obtém ou define o nome XAML do objeto onde ocorreu a exceção. |
| Source |
Obtém ou define o nome do aplicativo ou o objeto que causa o erro. (Herdado de Exception) |
| StackTrace |
Obtém uma representação string dos frames imediatos na stack de chamadas. (Herdado de Exception) |
| TargetSite |
Obtém o método que lança a exceção atual. (Herdado de Exception) |
| UidContext |
Obtém ou define a Diretiva x:Uid do objeto onde ocorreu a exceção. |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetBaseException() |
Quando sobrescrito numa classe derivada, devolve o Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Obtém os dados necessários para serializar o objeto especificado preenchendo o objeto especificado SerializationInfo . |
| GetType() |
Obtém o tipo de execução da instância atual. (Herdado de Exception) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Cria e devolve uma representação string da exceção atual. (Herdado de Exception) |
evento
| Name | Description |
|---|---|
| SerializeObjectState |
Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção. (Herdado de Exception) |