XamlParseException Classe

Definizione

Spazio dei nomi:

System.Windows.Markup

Assembly:

PresentationFramework.dll

Rappresenta la classe di eccezione per le eccezioni specifiche del parser da un parser XAML WPF. Questa eccezione viene usata in operazioni dell'API XAML o del parser XAML WPF da .NET Framework 3.0 e .NET Framework 3.5 oppure per l'uso specifico del parser XAML WPF chiamando l'API di XamlReader.

public ref class XamlParseException : SystemException

public class XamlParseException : SystemException

type XamlParseException = class
    inherit SystemException

Public Class XamlParseException
Inherits SystemException

Ereditarietà

Object

Exception

SystemException

XamlParseException

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ò derivare anche 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 le 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 in un assembly diverso (System.Xaml).

A meno che non si stia scrivendo un equivalente al parser XAML WPF o se si usa la destinazione .NET Framework 3.0 e .NET Framework 3.5, in genere non verrà generata XamlParseException dal codice personalizzato. Tuttavia, la gestione per l'eccezione è talvolta necessaria. Per gli scenari dell'applicazione, in cui è possibile eliminare gli errori di analisi XAML, un DispatcherUnhandledException gestore eventi a livello di applicazione è un modo per gestire un runtime XamlParseException. Se eliminare le eccezioni o lasciarle visualizzare nel codice utente dipende dalla modalità di progettazione dell'applicazione per il caricamento di XAML e dal livello di attendibilità assegnato al codice XAML caricato dall'applicazione. Per altre informazioni, vedere La sezione Considerazioni sulla sicurezza XAML o "Sicurezza XAML" di Panoramica di XAML (WPF).

Per le pagine di un'applicazione, quando XamlParseException viene generata, si trova in genere nel contesto della InitializeComponent chiamata 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. Un'altra possibile strategia di gestione consiste quindi nell'inserire try/catch blocchi in InitializeComponent. Tuttavia, questa tecnica non si integra bene con modelli, superfici di progettazione visiva e altre origini generate che 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 specificato.
XamlParseException(String, Exception)	Inizializza una nuova istanza della classe XamlParseException utilizzando la stringa del messaggio di eccezione e l'eccezione interna specificate.
XamlParseException(String, Int32, Int32)	Inizializza una nuova istanza della classe XamlParseException utilizzando la stringa del messaggio di errore, il numero della riga e la posizione nella riga specificati.
XamlParseException(String, Int32, Int32, Exception)	Inizializza una nuova istanza della classe XamlParseException utilizzando il messaggio di errore, l'eccezione interna, il numero della riga e la posizione nella riga specificati.

Proprietà

BaseUri	Ottiene informazioni sull'URI di base quando viene generata l'eccezione.
Data	Ottiene una raccolta di coppie chiave/valore che forniscono informazioni definite dall'utente aggiuntive sull'eccezione. (Ereditato da Exception)
HelpLink	Ottiene o imposta un collegamento al file della Guida associato all'eccezione. (Ereditato da Exception)
HResult	Ottiene o imposta HRESULT, un valore numerico codificato che viene 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 di chiave dell'elemento in un dizionario nel quale si è verificata l'eccezione.
LineNumber	Ottiene il numero della riga nella quale 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 nel quale si è verificata l'eccezione.
Source	Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore. (Ereditato da Exception)
StackTrace	Ottiene una rappresentazione di stringa dei frame immediati nello stack di chiamate. (Ereditato da Exception)
TargetSite	Ottiene il metodo che genera l'eccezione corrente. (Ereditato da Exception)
UidContext	Ottiene o imposta l'elemento x:Uid Directive dell'oggetto nel quale si è verificata l'eccezione.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetBaseException()	Quando ne viene eseguito l'override in una classe derivata, restituisce l'Exception che è 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 richiesti 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 dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Crea e restituisce una rappresentazione di stringa dell'eccezione corrente. (Ereditato da Exception)

Eventi

SerializeObjectState

Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione. (Ereditato da Exception)

Vedi anche

• Servizi XAML