XamlParseException Classe

Definição

Representa a classe de exceção para exceções específicas do analisador de um analisador XAML do WPF. Essa exceção é usada em operações de analisador XAML ou API XAML do .NET Framework 3.0 e .NET Framework 3.5 ou para uso específico do analisador XAML do WPF chamando XamlReader API.

public ref class XamlParseException : SystemException
[System.Serializable]
public class XamlParseException : SystemException
public class XamlParseException : SystemException
[<System.Serializable>]
type XamlParseException = class
    inherit SystemException
type XamlParseException = class
    inherit SystemException
Public Class XamlParseException
Inherits SystemException
Herança
XamlParseException
Atributos

Comentários

XamlParseException é usado somente para o analisador XAML implementado pelo WPF que executa a análise e o carregamento XAML para aplicativos WPF. Especificamente, a exceção só é relevante quando um aplicativo tem como destino o .NET Framework 3.0 e o .NET Framework 3.5. A exceção também pode se originar do código do usuário em chamadas em tempo de execução para APIs que conectam o analisador XAML implementado pelo WPF para carregar XAML de dentro de um aplicativo WPF em execução (por exemplo, chamadas para XamlReader.Load).

Para o .NET Framework 4, a exceção XamlParseException que normalmente relata exceções de processamento XAML é definida em um namespace diferente (System.Xaml) e em um assembly diferente (System.Xaml).

A menos que você esteja escrevendo um equivalente ao analisador XAML do WPF ou trabalhando com o direcionamento do .NET Framework 3.0 e do .NET Framework 3.5, você geralmente não lançará XamlParseException do seu próprio código. No entanto, o tratamento para a exceção às vezes é necessário. Para cenários de aplicativo, em que talvez você queira suprimir erros de análise XAML, um manipulador de eventos DispatcherUnhandledException no nível do aplicativo é uma maneira de lidar com um XamlParseExceptionem tempo de execução. Se suprimir exceções ou permitir que elas sejam exibidas no código do usuário depende de como você projeta seu aplicativo para fins de carregamento de XAML e do nível de confiança que você atribui ao XAML que seu aplicativo carrega. Para obter mais informações, consulte seção de Considerações de Segurança XAML ou "Segurança XAML" de WPF (Visão Geral XAML).

Para páginas de um aplicativo, quando o XamlParseException é gerado, ele geralmente está no contexto da chamada InitializeComponent feita pela classe de página, que é o ponto de entrada para o uso do modelo de aplicativo WPF do analisador XAML do WPF no nível por página. Portanto, outra estratégia de tratamento possível é colocar blocos try/catch em InitializeComponent. No entanto, essa técnica não se integra bem a modelos, superfícies de design visual e outras fontes geradas que conectam InitializeComponent.

Construtores

XamlParseException()

Inicializa uma nova instância da classe XamlParseException.

XamlParseException(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe XamlParseException.

XamlParseException(String)

Inicializa uma nova instância da classe XamlParseException, usando a cadeia de caracteres de mensagem de exceção especificada.

XamlParseException(String, Exception)

Inicializa uma nova instância da classe XamlParseException, usando a cadeia de caracteres de mensagem de exceção especificada e a exceção interna.

XamlParseException(String, Int32, Int32)

Inicializa uma nova instância da classe XamlParseException, usando a cadeia de caracteres de mensagem de exceção especificada e o número de linha e a posição especificados na linha.

XamlParseException(String, Int32, Int32, Exception)

Inicializa uma nova instância da classe XamlParseException, usando a mensagem de exceção especificada, a exceção interna, o número de linha e a posição na linha.

Propriedades

BaseUri

Obtém informações de URI base quando a exceção é gerada.

Data

Obtém uma coleção de pares chave/valor que fornecem informações adicionais definidas pelo usuário sobre a exceção.

(Herdado de Exception)
HelpLink

Obtém ou define um link para o arquivo de ajuda associado a essa exceção.

(Herdado de Exception)
HResult

Obtém ou define HRESULT, um valor numérico codificado atribuído a uma exceção específica.

(Herdado de Exception)
InnerException

Obtém a instância de Exception que causou a exceção atual.

(Herdado de Exception)
KeyContext

Obtém ou define o valor da chave do item em um dicionário em que a exceção ocorreu.

LineNumber

Obtém o número de linha em que a exceção ocorreu.

LinePosition

Obtém a posição na linha em que a exceção ocorreu.

Message

Obtém uma mensagem que descreve a exceção atual.

(Herdado de Exception)
NameContext

Obtém ou define o nome XAML do objeto em que a exceção ocorreu.

Source

Obtém ou define o nome do aplicativo ou do objeto que causa o erro.

(Herdado de Exception)
StackTrace

Obtém uma representação de cadeia de caracteres dos quadros imediatos na pilha de chamadas.

(Herdado de Exception)
TargetSite

Obtém o método que gera a exceção atual.

(Herdado de Exception)
UidContext

Obtém ou define a diretiva x:Uid do objeto em que a exceção ocorreu.

Métodos

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetBaseException()

Quando substituído em uma classe derivada, retorna o Exception que é a causa raiz de uma ou mais exceções subsequentes.

(Herdado de Exception)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)

Obtém os dados necessários para serializar o objeto especificado preenchendo o objeto SerializationInfo especificado.

GetType()

Obtém o tipo de runtime da instância atual.

(Herdado de Exception)
MemberwiseClone()

Cria uma cópia superficial do Objectatual.

(Herdado de Object)
ToString()

Cria e retorna uma representação de cadeia de caracteres da exceção atual.

(Herdado de Exception)

Eventos

SerializeObjectState
Obsoleto.

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)

Aplica-se a

Confira também

  • dos Serviços XAML