XamlParseException Classe

Definição

Namespace:

System.Windows.Markup

Assembly:

PresentationFramework.dll

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

public ref class XamlParseException : SystemException

public class XamlParseException : SystemException

type XamlParseException = class
    inherit SystemException

Public Class XamlParseException
Inherits SystemException

Herança

Object

Exception

SystemException

XamlParseException

Comentários

XamlParseException é usado apenas 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 é direcionado .NET Framework 3.0 e .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 .NET Framework 4, a XamlParseException exceção 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 .NET Framework 3.0 e .NET Framework 3.5, você geralmente não lançará XamlParseException de 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 DispatcherUnhandledException manipulador de eventos no nível do aplicativo é uma maneira de lidar com um tempo de execução XamlParseException. Se suprimir exceções ou deixá-las aparecer 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 a seção Considerações de segurança XAML ou "Segurança XAML" do WPF (Visão Geral do XAML).

Para páginas de um aplicativo, quando o XamlParseException é gerado, ele geralmente está no contexto da InitializeComponent chamada 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 manipulação possível é colocar try/catch blocos 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 da mensagem de exceção especificada.
XamlParseException(String, Exception)	Inicializa uma nova instância da classe XamlParseException usando a exceção interna e a cadeia de caracteres da mensagem de exceção especificada.
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 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 do URI de base quando a exceção é gerada.
Data	Obtém uma coleção de pares de chave/valor que fornecem informações definidas pelo usuário adicionais 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 que é atribuído a uma exceção específica. (Herdado de Exception)
InnerException	Obtém a instância 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 ocorreu a exceção.
LineNumber	Obtém número de linha em que ocorreu a exceção.
LinePosition	Obtém a posição na linha em que ocorreu a exceção.
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 ocorreu a exceção.
Source	Obtém ou define o nome do aplicativo ou objeto que causa o erro. (Herdado de Exception)
StackTrace	Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas. (Herdado de Exception)
TargetSite	Obtém o método que gerou a exceção atual. (Herdado de Exception)
UidContext	Obtém ou define a x:Uid Directive 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 a 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 Object atual. (Herdado de Object)
ToString()	Cria e retorna uma representação de cadeia de caracteres da exceção atual. (Herdado de Exception)

Eventos

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)

Confira também

• Serviços XAML