XamlParseException Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta la classe di eccezione per le eccezioni specifiche del parser da un parser XAML WPF. Questa eccezione viene usata nelle operazioni dell'API XAML o del parser XAML WPF da .NET Framework 3.0 e .NET Framework 3.5 o per un uso specifico del parser XAML WPF chiamando 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
- Ereditarietà
- Attributi
Commenti
XamlParseException viene usato solo per il parser XAML implementato da WPF che esegue l'analisi e il caricamento XAML per le applicazioni WPF. In particolare, l'eccezione è rilevante solo quando un'applicazione è destinata a .NET Framework 3.0 e .NET Framework 3.5. L'eccezione può anche provenire dal codice utente nelle chiamate in fase di esecuzione alle API che associano il parser XAML implementato da WPF per caricare XAML dall'interno di un'applicazione WPF in esecuzione (ad esempio, chiamate a XamlReader.Load).
Per .NET Framework 4, l'eccezione XamlParseException che in genere segnala eccezioni di elaborazione XAML è definita in uno spazio dei nomi diverso (System.Xaml) e un assembly diverso (System.Xaml).
A meno che non si stia scrivendo un equivalente al parser XAML WPF o che si stia usando .NET Framework 3.0 e la destinazione .NET Framework 3.5, in genere non si genererà XamlParseException dal proprio codice. Tuttavia, la gestione per l'eccezione è talvolta necessaria. Per gli scenari dell'applicazione, in cui è possibile eliminare gli errori di analisi XAML, un gestore eventi DispatcherUnhandledException a livello di applicazione è un modo per gestire un XamlParseExceptiondi runtime. Se eliminare le eccezioni o lasciarle visualizzare nel codice utente dipende dalla modalità di progettazione dell'applicazione ai fini del caricamento di XAML e dal livello di attendibilità assegnato al codice XAML caricato dall'applicazione. Per altre informazioni, vedere sezione considerazioni sulla sicurezza XAML o "Sicurezza XAML" di cenni preliminari su XAML (WPF).
Per le pagine di un'applicazione, quando viene generata la XamlParseException, si trova in genere nel contesto della chiamata InitializeComponent
effettuata dalla classe di pagina, ovvero il punto di ingresso per l'utilizzo del modello di applicazione WPF del parser XAML WPF a livello di pagina. Pertanto, un'altra possibile strategia di gestione consiste nell'inserire blocchi try/catch
in InitializeComponent
. Tuttavia, questa tecnica non si integra bene con modelli, superfici di progettazione visiva e altre origini generate che si associano InitializeComponent
.
Costruttori
XamlParseException() |
Inizializza una nuova istanza della classe XamlParseException. |
XamlParseException(SerializationInfo, StreamingContext) |
Inizializza una nuova istanza della classe XamlParseException. |
XamlParseException(String) |
Inizializza una nuova istanza della classe XamlParseException utilizzando la stringa del messaggio di eccezione specificata. |
XamlParseException(String, Exception) |
Inizializza una nuova istanza della classe XamlParseException utilizzando la stringa del messaggio di eccezione specificata e l'eccezione interna. |
XamlParseException(String, Int32, Int32) |
Inizializza una nuova istanza della classe XamlParseException utilizzando la stringa del messaggio di eccezione specificata e il numero di riga e la posizione specificati nella riga. |
XamlParseException(String, Int32, Int32, Exception) |
Inizializza una nuova istanza della classe XamlParseException utilizzando il messaggio di eccezione, l'eccezione interna, il numero di riga e la posizione specificati nella riga. |
Proprietà
BaseUri |
Ottiene informazioni sull'URI di base quando viene generata l'eccezione. |
Data |
Ottiene una raccolta di coppie chiave/valore che forniscono informazioni aggiuntive definite dall'utente sull'eccezione. (Ereditato da Exception) |
HelpLink |
Ottiene o imposta un collegamento al file della Guida associato a questa eccezione. (Ereditato da Exception) |
HResult |
Ottiene o imposta HRESULT, valore numerico codificato assegnato a un'eccezione specifica. (Ereditato da Exception) |
InnerException |
Ottiene l'istanza di Exception che ha causato l'eccezione corrente. (Ereditato da Exception) |
KeyContext |
Ottiene o imposta il valore della chiave dell'elemento in un dizionario in cui si è verificata l'eccezione. |
LineNumber |
Ottiene il numero di riga in cui si è verificata l'eccezione. |
LinePosition |
Ottiene la posizione nella riga in cui si è verificata l'eccezione. |
Message |
Ottiene un messaggio che descrive l'eccezione corrente. (Ereditato da Exception) |
NameContext |
Ottiene o imposta il nome XAML dell'oggetto in cui si è verificata l'eccezione. |
Source |
Ottiene o imposta il nome dell'applicazione o dell'oggetto che causa l'errore. (Ereditato da Exception) |
StackTrace |
Ottiene una rappresentazione di stringa dei fotogrammi immediati nello stack di chiamate. (Ereditato da Exception) |
TargetSite |
Ottiene il metodo che genera l'eccezione corrente. (Ereditato da Exception) |
UidContext |
Ottiene o imposta la direttiva x:Uid dell'oggetto in cui si è verificata l'eccezione. |
Metodi
Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
GetBaseException() |
Quando sottoposto a override in una classe derivata, restituisce il Exception che rappresenta la causa radice di una o più eccezioni successive. (Ereditato da Exception) |
GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
GetObjectData(SerializationInfo, StreamingContext) |
Ottiene i dati necessari per serializzare l'oggetto specificato popolando l'oggetto SerializationInfo specificato. |
GetType() |
Ottiene il tipo di runtime dell'istanza corrente. (Ereditato da Exception) |
MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
ToString() |
Crea e restituisce una rappresentazione di stringa dell'eccezione corrente. (Ereditato da Exception) |
Eventi
SerializeObjectState |
Obsoleti.
Si verifica quando viene serializzata un'eccezione per creare un oggetto stato dell'eccezione contenente dati serializzati sull'eccezione. (Ereditato da Exception) |