MatchException Classe

Définition

Espace de noms:: Java.Lang

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Levée pour indiquer un échec inattendu dans la correspondance de modèle.

[Android.Runtime.Register("java/lang/MatchException", ApiSince=36, DoNotGenerateAcw=true)]
public sealed class MatchException : Java.Lang.RuntimeException

[<Android.Runtime.Register("java/lang/MatchException", ApiSince=36, DoNotGenerateAcw=true)>]
type MatchException = class
    inherit RuntimeException

Héritage: Exception

JavaException

Throwable

Exception

RuntimeException
MatchException

Attributs: RegisterAttribute

Remarques

Levée pour indiquer un échec inattendu dans la correspondance de modèle.

MatchException peut être levée lorsqu’une construction de langage de correspondance de modèle exhaustive (telle qu’une switch expression) rencontre une valeur qui ne correspond à aucun des modèles spécifiés au moment de l’exécution, même si la construction a été considérée comme exhaustive. Cela est intentionnel et peut provenir d’un certain nombre de cas :

<ul><li>Anomalies de compilation distinctes, où des parties de la hiérarchie de type que les références de modèles ont été modifiées, mais la construction de correspondance de modèle n’a pas été recompilée. Par exemple, si une interface scellée a un ensemble différent de sous-types autorisés au moment de l’exécution qu’il avait au moment de la compilation, ou si une classe d’énumération a un ensemble différent de constantes d’énumération au moment de l’exécution, ou si la hiérarchie de types a été modifiée d’une manière incompatible entre le temps de compilation et l’heure d’exécution.</li>

<valeurs li>null et modèles imbriqués impliquant des classes scellées. Si, par exemple, une interface I est sealed avec deux sous-classes autorisées A et B, et qu’une classe R d’enregistrement a un seul composant de type I, les deux modèles d’enregistrement et R(A a) ensemble sont considérés R(B b) comme exhaustifs pour le type R, mais aucun de ces modèles ne correspond au résultat de new R(null).</li>

<valeurs li>null et modèles d’enregistrement imbriqués. Étant donné une classe S d’enregistrement avec un seul composant de type T, où T est une autre classe d’enregistrement avec un seul composant de type String, le modèle R(S(var s)) d’enregistrement imbriqué est considéré comme exhaustif pour le type R , mais il ne correspond pas au résultat de new R(null) (alors qu’il correspond au résultat de new R(new S(null)) le faire).</li></ul>

MatchException peut également être levée par le processus de mise en correspondance d’une valeur par rapport à un modèle. Par exemple, la correspondance de modèle impliquant un modèle d’enregistrement peut exiger que les méthodes d’accesseur soient implicitement appelées pour extraire les valeurs du composant. Si l’une de ces méthodes d’accesseur lève une exception, la correspondance de modèle se termine brusquement et lève MatchException. L’exception d’origine est définie en tant que Throwable#getCause() causeMatchException. Aucune exception n’est Throwable#addSuppressed(java.lang.Throwable) suppressed enregistrée.

Ajouté dans 21.

Java documentation pour java.lang.MatchException.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

Constructeurs

Nom	Description
MatchException(String, Throwable)	Construit un `MatchException` message de détail et une cause spécifiés.

Champs

Nom	Description
is_generated	Indique si cette valeur levée a été générée par la liaison. (Hérité de Throwable)

Propriétés

Nom	Description
Cause	Retourne la cause de cette levée ou `null` si la cause est inexistante ou inconnue. (Hérité de Throwable)
Class	Obtient la classe runtime de cette valeur levée. (Hérité de Throwable)
Handle	Handle de l’instance Android sous-jacente. (Hérité de Throwable)
JavaStackTrace	Levée pour indiquer un échec inattendu dans la correspondance de modèle. (Hérité de JavaException)
JniIdentityHashCode	Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Throwable)
JniManagedPeerState	Levée pour indiquer un échec inattendu dans la correspondance de modèle. (Hérité de JavaException)
JniPeerMembers	Obtient les métadonnées JNI utilisées pour appeler les membres de cet homologue Java.
LocalizedMessage	Crée une description localisée de cette valeur levée. (Hérité de Throwable)
Message	Retourne la chaîne de message de détail de cette valeur levée. (Hérité de Throwable)
PeerReference	Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Throwable)
StackTrace	Obtient une représentation sous forme de chaîne de la trace de pile pour cette valeur levée. (Hérité de Throwable)
ThresholdClass	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de RuntimeException)
ThresholdType	Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. (Hérité de RuntimeException)

Méthodes

Nom	Description
AddSuppressed(Throwable)	Ajoute l’exception spécifiée aux exceptions qui ont été supprimées pour remettre cette exception. (Hérité de Throwable)
Construct(JniObjectReference, JniObjectReferenceOptions)	Levée pour indiquer un échec inattendu dans la correspondance de modèle. (Hérité de JavaException)
Dispose()	Libère les ressources détenues par cet homologue Java. (Hérité de Throwable)
Dispose(Boolean)	Libère les ressources détenues par cet homologue Java. (Hérité de Throwable)
DisposeUnlessReferenced()	Levée pour indiquer un échec inattendu dans la correspondance de modèle. (Hérité de JavaException)
Equals(Object)	Levée pour indiquer un échec inattendu dans la correspondance de modèle. (Hérité de JavaException)
FillInStackTrace()	Renseigne la trace de la pile d’exécution. (Hérité de Throwable)
GetHashCode()	Retourne une valeur de code de hachage pour l’objet. (Hérité de JavaException)
GetStackTrace()	Fournit un accès programmatique aux informations de trace de la pile imprimées par `#printStackTrace()`. (Hérité de Throwable)
GetSuppressed()	Retourne un tableau contenant toutes les exceptions qui ont été supprimées, généralement par l’instruction `try`-with-resources, afin de remettre cette exception. (Hérité de Throwable)
InitCause(Throwable)	Initialise la cause de cette levée à la valeur spécifiée. (Hérité de Throwable)
PrintStackTrace()	Imprime cette valeur levée et son backtrace dans le flux d’erreur standard. (Hérité de Throwable)
PrintStackTrace(PrintStream)	Imprime cette valeur levée et son backtrace dans le flux d’impression spécifié. (Hérité de Throwable)
PrintStackTrace(PrintWriter)	Imprime cette valeur levée et son backtrace à l’enregistreur d’impression spécifié. (Hérité de Throwable)
SetHandle(IntPtr, JniHandleOwnership)	Définit la propriété Handle. (Hérité de Throwable)
SetJavaStackTrace(JniObjectReference)	Levée pour indiquer un échec inattendu dans la correspondance de modèle. (Hérité de JavaException)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Levée pour indiquer un échec inattendu dans la correspondance de modèle. (Hérité de JavaException)
SetStackTrace(StackTraceElement[])	Définit les éléments de trace de pile qui seront retournés par `#getStackTrace()` et imprimés par et par `#printStackTrace()` des méthodes associées. (Hérité de Throwable)
ToString()	Convertit cette valeur en chaîne. (Hérité de Throwable)
UnregisterFromRuntime()	Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Throwable)

Implémentations d’interfaces explicites

Nom	Description
IJavaPeerable.Disposed()	Levée pour indiquer un échec inattendu dans la correspondance de modèle. (Hérité de JavaException)
IJavaPeerable.Finalized()	Levée pour indiquer un échec inattendu dans la correspondance de modèle. (Hérité de JavaException)
IJavaPeerable.JniObjectReferenceControlBlock	Levée pour indiquer un échec inattendu dans la correspondance de modèle. (Hérité de JavaException)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Levée pour indiquer un échec inattendu dans la correspondance de modèle. (Hérité de JavaException)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Levée pour indiquer un échec inattendu dans la correspondance de modèle. (Hérité de JavaException)
IJavaPeerable.SetPeerReference(JniObjectReference)	Levée pour indiquer un échec inattendu dans la correspondance de modèle. (Hérité de JavaException)

Méthodes d’extension

Nom	Description
GetJniTypeName(IJavaPeerable)	Obtient le nom JNI du type de l’instance `self`.
JavaAs<TResult>(IJavaPeerable)	Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.
JavaCast<TResult>(IJavaObject)	Effectue une conversion de type vérifiée par le runtime Android.
JavaCast<TResult>(IJavaObject)	Levée pour indiquer un échec inattendu dans la correspondance de modèle.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Essayez de forcer `self` le type`TResult`, en vérifiant que le forçage est valide côté Java.

S’applique à