XamlParseException Classe

Definição

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
XamlParseException
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 XAML ou a secção "Segurança XAML" do XAML Overview (WPF).

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)

Aplica-se a

Ver também