English
Instant Developer Foundation Documentazione
  • Reference Librerie
  • Libreria Database
  • Libreria Standard
  • Funzioni Client

Clear Errors

procedura copia link

Scopo

Svuota le variabili che contengono lo stato dell'ultimo errore ottenuto durante l'esecuzione di una operazione sul database. Normalmente questa procedura viene utilizzata prima di eseguire operazioni che potrebbero generare errori. Le uniche operazione per le quali è possibile ottenere informazioni riguardanti l'errore sono:

  • L'apertura di una nuova connessione tramite la procedura OpenConnection.
  • La chiamata di una StoredProcedure sul database.
Dopo l'esecuzione dell'operazione è possibile leggere le proprietà ErrorMessage, ErrorNumber e OffendingCommand per avere informazioni riguardo l'errore.

Sintassi

Database.ClearErrors()

Argomenti

Questa procedura non ha parametri.

Esempio di codice

// ******************************
// Esegue una query errata sul db
// ******************************

public void ErroriDB.EseguiQuery()
{
  // Svuoto i campi a video
  Dati.TestoErrore := Null String
  Dati.NumeroErrore := Null Number
  Dati.OffendingCommand := Null String
  // 
  // Svuoto gli errori del database

  NorthwindDB.ClearErrors()
  // 
  // Apro una nuova connessione... il DB non si trova in E: quindi l'operazione
  // dà errore

  NorthwindDB.OpenConnection(Empty String, Empty String, Provider=Micros-
    oft.Jet.OLEDB.4.0;Data Source=E:\\nwind.mdb;Persist Security Info=False)
  // 
  // La Open Connection non genera eccezioni. Qualora ci sia un errore viene
  // valorizzata la variabile Error Message.
  // In questo caso leggo l'errore e lo mostro a video

  if NorthwindDB.ErrorMessage <> Empty String
  {
    Dati.TestoErrore := NorthwindDB.ErrorMessage
    Dati.NumeroErrore := NorthwindDB.ErrorNumber
    Dati.OffendingCommand := NorthwindDB.OffendingCommand
  }
}
  • La procedura ClearErrors viene sempre chiamata dal sistema al momento dell'apertura di una connessione al database. Quindi non è possibile ottenere informazioni riguardo gli errori ottenuti in richieste HTTP precedenti a quella attualmente servita dato che il sistema chiude sempre tutte le connessioni dopo aver inviato l'HTML al browser.

Ultima modifica: 23/03/2021 / Validità: da 7.1.3300

Vedi Anche

  • Error Number (proprietà)
  • Error Message (proprietà)
  • Offending Command (proprietà)
  • Open Connection (procedura)

Hai trovato utile l'articolo?

Grazie per il feedback!

Ti serve altro aiuto?

Consulta il Forum