XamlParseException 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.
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
[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
- Atributos
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 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 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 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 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 |
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
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários