XamlParseException Klasa

Definicja

Reprezentuje klasę wyjątku dla wyjątków specyficznych dla analizatora z parsera XAML WPF.Represents the exception class for parser-specific exceptions from a WPF XAML parser. Ten wyjątek jest używany w operacjach interfejsu API XAML lub analizatora XAML WPF z .NET Framework 3,0 i .NET Framework 3,5 lub do określonego użycia analizatora XAML WPF przez XamlReader wywoływanie interfejsu API.This exception is used in XAML API or WPF XAML parser operations from .NET Framework 3.0 and .NET Framework 3.5, or for specific use of the WPF XAML parser by calling XamlReader API.

public ref class XamlParseException : SystemException
[System.Serializable]
public class XamlParseException : SystemException
type XamlParseException = class
    inherit SystemException
Public Class XamlParseException
Inherits SystemException
Dziedziczenie
XamlParseException
Atrybuty

Uwagi

XamlParseExceptionjest używany tylko dla analizatora XAML zaimplementowanego przez WPF, który wykonuje Analizowanie kodu XAML i ładowanie dla aplikacji WPF.XamlParseException is used only for the WPF-implemented XAML parser that performs the XAML parsing and loading for WPF applications. Szczególnie, wyjątek ma zastosowanie tylko wtedy, gdy aplikacja jest .NET Framework 3.0.NET Framework 3.0 celem Program .NET Framework 3,5.NET Framework 3.5i.Specifically, the exception is only relevant when an application targets .NET Framework 3.0.NET Framework 3.0 and Program .NET Framework 3,5.NET Framework 3.5. Wyjątek może również pochodzić z kodu użytkownika w wywołaniach interfejsu API, które podłączają parser języka XAML zaimplementowany przez WPF do ładowania XAML z działającej aplikacji WPF (na przykład wywołania do XamlReader.Load).The exception can also originate from user code in run-time calls to APIs that hook up the WPF-implemented XAML parser to load XAML from within a running WPF application (for example, calls to XamlReader.Load).

Dla Program .NET Framework 4.NET Framework 4programu XamlParseException wyjątek, który zwykle raportuje wyjątki przetwarzania XAML jest zdefiniowany w innej przestrzeni nazwSystem.Xaml() i innym zestawie (System. XAML).For Program .NET Framework 4.NET Framework 4, the XamlParseException exception that typically reports XAML processing exceptions is defined in a different namespace (System.Xaml) and a different assembly (System.Xaml).

Chyba że piszesz odpowiednik analizatora XAML WPF lub pracujesz z elementem .NET Framework 3.0.NET Framework 3.0 Program .NET Framework 3,5.NET Framework 3.5 docelowym, zazwyczaj nie XamlParseException będziesz zgłaszać z własnego kodu.Unless you are writing an equivalent to the WPF XAML parser or working with .NET Framework 3.0.NET Framework 3.0 and Program .NET Framework 3,5.NET Framework 3.5 targeting, you generally will not throw XamlParseException from your own code. Jednak obsługa dla wyjątku jest czasami konieczna.However, handling for the exception is sometimes necessary. W przypadku scenariuszy aplikacji, w których może być konieczne pominięcie błędów analizy XAML, Dispatcher UnhandledException program obsługi zdarzeń na poziomie aplikacji jest jednym ze sposobów na obsługę czasu XamlParseExceptionwykonywania.For application scenarios, where you may want to suppress XAML parse errors, a Dispatcher UnhandledException event handler at the application level is one way to handle a run-time XamlParseException. Określa, czy pomijać wyjątki, czy też podawać im dane do kodu użytkownika, zależy od tego, jak projektujesz aplikację w celach ładowania XAML, oraz poziom zaufania przypisany do XAML, który jest ładowany przez aplikację.Whether to suppress exceptions or let them surface to user code depends on how you design your application for purposes of loading XAML, and the trust level that you assign to the XAML your application loads. Aby uzyskać więcej informacji, zobacz sekcję zagadnienia dotyczące zabezpieczeń języka XAML lub "zabezpieczenia XAML" omówienia XAML (WPF).For more information, see XAML Security Considerations or "XAML Security" section of XAML Overview (WPF).

W przypadku stron aplikacji, gdy XamlParseException jest zgłaszany, zazwyczaj jest to w kontekście InitializeComponent wywołania wykonanego przez klasę strony, który jest punktem wejścia dla użycia dla modelu aplikacji WPF analizatora języka XAML WPF na poziomie strony.For pages of an application, when the XamlParseException is thrown, it is usually in the context of the InitializeComponent call made by your page class, which is the entry point for the WPF application model's usage of the WPF XAML parser at the per-page level. W związku z tym kolejną możliwą strategią obsługi InitializeComponentjest umieszczenie try/catch bloków w.Therefore another possible handling strategy is to place try/catch blocks in InitializeComponent. Jednak ta technika nie jest dobrze zintegrowana z szablonami, powierzchniami projektu wizualnego i innymi wygenerowanymi źródłami, które są podłączane InitializeComponent.However, this technique does not integrate well with templates, visual design surfaces and other generated sources that hook up InitializeComponent.

Konstruktory

XamlParseException()

Inicjuje nowe wystąpienie klasy XamlParseException klasy.Initializes a new instance of the XamlParseException class.

XamlParseException(SerializationInfo, StreamingContext)

Inicjuje nowe wystąpienie klasy XamlParseException klasy.Initializes a new instance of the XamlParseException class.

XamlParseException(String)

Inicjuje nowe wystąpienie XamlParseException klasy przy użyciu określonego ciągu komunikatu o wyjątku.Initializes a new instance of the XamlParseException class, using the specified exception message string.

XamlParseException(String, Exception)

Inicjuje nowe wystąpienie XamlParseException klasy, używając określonego ciągu komunikatu wyjątku i wewnętrznego wyjątku.Initializes a new instance of the XamlParseException class, using the specified exception message string and inner exception.

XamlParseException(String, Int32, Int32)

Inicjuje nowe wystąpienie XamlParseException klasy, używając określonego ciągu komunikatu o wyjątku oraz numeru wiersza i pozycji w wierszu.Initializes a new instance of the XamlParseException class, using the specified exception message string, and the specified line number and position in the line.

XamlParseException(String, Int32, Int32, Exception)

Inicjuje nowe wystąpienie XamlParseException klasy, używając określonego komunikatu wyjątku, wewnętrznego wyjątku, numeru wiersza i pozycji w wierszu.Initializes a new instance of the XamlParseException class, using the specified exception message, inner exception, line number, and position in the line.

Właściwości

BaseUri

Pobiera podstawowe informacje o identyfikatorze URI, gdy zostanie zgłoszony wyjątek.Gets base URI information when the exception is thrown.

Data

Pobiera kolekcję par klucz/wartość, które zawierają dodatkowe informacje zdefiniowane przez użytkownika dotyczące wyjątku.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Odziedziczone po Exception)
HelpLink

Pobiera lub ustawia link do pliku pomocy skojarzonego z tym wyjątkiem.Gets or sets a link to the help file associated with this exception.

(Odziedziczone po Exception)
HResult

Pobiera lub ustawia wartość HRESULT, kodowane wartości liczbowe przypisane do określonego wyjątku.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Odziedziczone po Exception)
InnerException

Pobiera wystąpienie Exception, które spowodowało wyjątek bieżący.Gets the Exception instance that caused the current exception.

(Odziedziczone po Exception)
KeyContext

Pobiera lub ustawia wartość klucza elementu w słowniku, w którym wystąpił wyjątek.Gets or sets the key value of the item in a dictionary where the exception occurred.

LineNumber

Pobiera numer wiersza, w którym wystąpił wyjątek.Gets the line number where the exception occurred.

LinePosition

Pobiera pozycję w wierszu, w którym wystąpił wyjątek.Gets the position in the line where the exception occurred.

Message

Pobiera komunikat, który opisuje bieżący wyjątek.Gets a message that describes the current exception.

(Odziedziczone po Exception)
NameContext

Pobiera lub ustawia nazwę XAML obiektu, w którym wystąpił wyjątek.Gets or sets the XAML name of the object where the exception occurred.

Source

Pobiera lub ustawia nazwę aplikacji lub obiekt, który powoduje błąd.Gets or sets the name of the application or the object that causes the error.

(Odziedziczone po Exception)
StackTrace

Pobiera ciąg reprezentujący bezpośrednie ramki w stosie wywołań.Gets a string representation of the immediate frames on the call stack.

(Odziedziczone po Exception)
TargetSite

Pobiera metodę, która zgłasza bieżący wyjątek.Gets the method that throws the current exception.

(Odziedziczone po Exception)
UidContext

Pobiera lub ustawia dyrektywę x:UID — obiektu, w którym wystąpił wyjątek.Gets or sets the x:Uid Directive of the object where the exception occurred.

Metody

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetBaseException()

Gdy jest zastępowany w klasie pochodnej, zwraca Exception, który jest główną przyczyną jednego lub kilku kolejnych wyjątków.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Odziedziczone po Exception)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)

Pobiera dane, które są wymagane do serializacji określonego obiektu przez wypełnienie określonego SerializationInfo obiektu.Gets the data that is required to serialize the specified object by populating the specified SerializationInfo object.

GetType()

Pobiera typ środowiska uruchomieniowego bieżącego wystąpienia.Gets the runtime type of the current instance.

(Odziedziczone po Exception)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Tworzy i zwraca reprezentację ciągu bieżącego wyjątku.Creates and returns a string representation of the current exception.

(Odziedziczone po Exception)

Zdarzenia

SerializeObjectState

Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku, który zawiera serializowane dane dotyczące wyjątku.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Odziedziczone po Exception)

Dotyczy

Zobacz też