MatchException Classe

Definizione

[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

Ereditarietà

Exception

Throwable

Exception

RuntimeException

MatchException

Attributi

RegisterAttribute

Commenti

Generata per indicare un errore imprevisto nei criteri di ricerca.

MatchException può essere generata quando un costrutto di linguaggio di ricerca completo (ad esempio un'espressione switch ) rileva un valore che non corrisponde ad alcuno dei modelli specificati in fase di esecuzione, anche se il costrutto è stato considerato esaustivo. Questo è intenzionale e può sorgere da diversi casi:

<ul><li>Anomalie di compilazione separate, in cui le parti della gerarchia dei tipi a cui si fa riferimento sono state modificate, ma il costrutto di ricerca dei criteri non è stato ricompilato. Ad esempio, se un'interfaccia sealed ha un set diverso di sottotipi consentiti in fase di esecuzione rispetto a quello in fase di compilazione o se una classe enum ha un set diverso di costanti enumerazioni in fase di esecuzione rispetto a quelle in fase di compilazione o se la gerarchia dei tipi è stata modificata in qualche modo incompatibile tra la fase di compilazione e l'ora di esecuzione.</li>

<valori li>null e modelli annidati che coinvolgono classi sealed. Se, ad esempio, un'interfaccia I è con due sottoclassi consentite A e Be una classe R record ha un singolo componente di tipo I, i due modelli R(A a) di record e R(B b) insieme vengono considerati esaustivi per il tipo R, ma nessuno di questi criteri corrisponderà al risultato di new R(null).<sealed/li>

<valori li>null e modelli di record annidati. Data una classe S di record con un singolo componente di tipo T, dove T è un'altra classe di record con un singolo componente di tipo String, il modello R(S(var s)) di record annidato viene considerato esaustivo per il tipo R , ma non corrisponde al risultato di new R(null) ,mentre corrisponde al risultato di new R(new S(null)) .</li></ul>

MatchException può anche essere generata dal processo di ricerca che corrisponde a un valore rispetto a un criterio. Ad esempio, i criteri di ricerca che coinvolgono un modello di record possono richiedere che i metodi della funzione di accesso vengano richiamati in modo implicito per estrarre i valori dei componenti. Se uno di questi metodi della funzione di accesso genera un'eccezione, la corrispondenza dei criteri viene completata bruscamente e genera MatchException. L'eccezione originale verrà impostata come di Throwable#getCause() causeMatchException. Non Throwable#addSuppressed(java.lang.Throwable) suppressed verranno registrate eccezioni.

Aggiunta in 21.

per java.lang.MatchException.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.