Classe QSUpdate
|
Implementa le funzionalità di UPDATE se il record esiste altrimenti effettua un INSERT.
Nei Fileds inserire tutti i campi da aggiornare o inserire.
Gerarchia di ereditarietà
Namespace: QSAdoNet
Assembly: QSAdoNet (in QSAdoNet.dll) Versione: 27.1.0
SintassiIl tipo QSUpdateInsertCommand espone i seguenti membri.
Costruttori| Nome | Descrizione | |
|---|---|---|
 | QSUpdateInsertCommand | Crea l'oggetto inizializzando il riferimento alla connessione ed il nome della table. |
Proprietà| Nome | Descrizione | |
|---|---|---|
 | Alias |
Restituisce o imposta l'alias della tabella.
(Ereditato da QSCommandBase) |
| Command |
Restituisce il comando utilizzato internamente.
(Ereditato da QSCommandBase) |
| Connection |
Restituisce l'oggetto connessione al quale questo comando appartiene.
(Ereditato da QSCommandBase) |
| FieldValueDictionary | Restituisce il dizionario con le coppie nome-valore da utilizzare nell'INSERT. Tipicamente "NomeCampo" = "@NomeCampo". |
| Item | Imposta o restituisce il valore di un campo della clausola UPDATE/INSERT. |
| Parameters |
Restituisce la collezione contenente tutti i parametri presenti.
(Ereditato da QSCommandBase) |
| RowLock | |
| SqlStatement |
Restituisce l'istruzione UPDATE completa in base alle informazioni presenti nell'oggetto.
(Sovrascrive QSCommandBaseSqlStatement) |
| SqlText | Restituisce o imposta il testo che verrà utilizzato nella query SQL. Se questo valore non viene impostato verrà utilizzato il risultato di GetStatement() che calcola la query in base ai campi ed alle proprietà dell'oggetto, altrimenti verrà usata direttamente questa stringa nell'istruzione SQL senza effettuare alcun controllo. |
| TableName |
Restituisce o imposta il nome della tabella sulla quale effettuare il comando.
Accetta anche la stringa vuota "" ma non il valore null.
(Ereditato da QSCommandBase) |
| WhereList |
Restituisce la lista delle istruzioni Where.
(Ereditato da QSCommandBase) |
Metodi| Nome | Descrizione | |
|---|---|---|
 | AddField(String, Object) | Aggiunge un campo all'istruzione UPDATE/INSERT creando in automatico un parametro omonimo. Se il campo esiste già ne sovrascrive il valore |
| AddField(String, String, Object) | Aggiunge un campo all'istruzione UPDATE/INSERT creando anche il parametro abbinato. Se il campo esiste già ne sovrascrive il valore |
| AddField(String, String, Object, DbType) | Aggiunge un campo all'istruzione UPDATE/INSERT creando anche il parametro abbinato specificandone il DbType. Se il campo esiste già ne sovrascrive il valore |
| AddWhereBetween(String, Object, Object) |
Aggiunge alla clausola where un elemento BETWEEN creando contemporaneamente i parametri ed anteponendo un AND logico.
Crea i parametri con stesso nome di fieldName aggiungendo il suffisso MIN e MAX.
(Ereditato da QSCommandBase) |
| AddWhereBetween(SqlBinaryOperatorEnum, String, Object, Object) |
Aggiunge alla clausola where un elemento BETWEEN creando contemporaneamente i parametri.
Crea i parametri con stesso nome di fieldName aggiungendo il suffisso MIN e MAX.
(Ereditato da QSCommandBase) |
| AddWhereBetween(String, String, Object, String, Object) |
Aggiunge alla clausola where un elemento BETWEEN creando contemporaneamente i parametri ed anteponendo un AND logico.
(Ereditato da QSCommandBase) |
| AddWhereBetween(SqlBinaryOperatorEnum, String, String, Object, String, Object) |
Aggiunge alla clausola where un elemento BETWEEN creando contemporaneamente i parametri.
(Ereditato da QSCommandBase) |
| AddWhereElement(ISqlStatement) |
Aggiunge alla clausola where l'elemento specificato anteponendo un AND logico.
Se esiste un'altra espressione la lega con l'operatore specificato abbassandola di livello.
Es: Clausola presente: (A=@A AND B=@B) ---> Diventa: ((A=@A AND B=@B) (Operatore) (WhereElementInserito))
Se l'elemento passato è un QSCommandBase o una classe derivata, copia tutti i parametri presenti
all'interno di questo comando.
Se l'elemento passato è un QSCommandBase o una classe derivata, copia tutti i parametri presenti
all'interno di questo comando e ne legge solo la clausola where.
(Ereditato da QSCommandBase) |
| AddWhereElement(SqlBinaryOperatorEnum, ISqlStatement) |
Aggiunge alla clausola where l'elemento specificato. Se esiste un'altra espressione la lega con l'operatore
specificato abbassandola di livello.
Es: Clausola presente: (A=@A AND B=@B) ---> Diventa: ((A=@A AND B=@B) (Operatore) (WhereElementInserito))
Se l'elemento passato è un QSCommandBase o una classe derivata, copia tutti i parametri presenti
all'interno di questo comando e ne legge solo la clausola where.
(Ereditato da QSCommandBase) |
| AddWhereImpossible |
Aggiunge alla clausola where la condizione 1 = 0 ovvero la condizione impossibile.
Se esistono altre clausole where viene messa in AND logico con queste.
(Ereditato da QSCommandBase) |
| AddWhereInList(String, ListString) |
Aggiunge alla clausola where una condizione di esistenza del campo in una lista di elementi.
(Ereditato da QSCommandBase) |
| AddWhereInList(SqlBinaryOperatorEnum, String, ListString) |
Aggiunge alla clausola where una condizione di esistenza del campo in una lista di elementi.
(Ereditato da QSCommandBase) |
| AddWhereItem(ISqlStatement) |
Aggiunge alla clausola where un elemento accodandolo sullo stesso livello delle clausole precedenti anteponendo un AND logico.
Se l'elemento passato è un QSCommandBase o una classe derivata, copia tutti i parametri presenti
all'interno di questo comando.
Se l'elemento passato è un QSCommandBase o una classe derivata, copia tutti i parametri presenti
all'interno di questo comando e ne legge solo la clausola where.
(Ereditato da QSCommandBase) |
| AddWhereItem(SqlBinaryOperatorEnum, ISqlStatement) |
Aggiunge alla clausola where un elemento accodandolo sullo stesso livello delle clausole precedenti.
Se l'elemento passato è un QSCommandBase o una classe derivata, copia tutti i parametri presenti
all'interno di questo comando e ne legge solo la clausola where.
(Ereditato da QSCommandBase) |
| AddWhereItem(String, Object) |
Aggiunge alla clausola where un elemento ed un parametro con comparatore Uguale anteponendo un AND logico.
Crea il parametro con stesso nome di fieldName.
(Ereditato da QSCommandBase) |
| AddWhereItem(SqlBinaryOperatorEnum, String, Object) |
Aggiunge alla clausola where un elemento ed un parametro con comparatore Uguale.
Crea il parametro con stesso nome di fieldName.
(Ereditato da QSCommandBase) |
| AddWhereItem(String, SqlBinaryOperatorEnum, Object) |
Aggiunge alla clausola where un elemento ed un parametro contemporaneamente anteponendo un AND logico.
Crea il parametro con stesso nome di fieldName.
(Ereditato da QSCommandBase) |
| AddWhereItem(SqlBinaryOperatorEnum, String, SqlBinaryOperatorEnum, Object) |
Aggiunge alla clausola where un elemento ed un parametro contemporaneamente.
Crea il parametro con stesso nome di fieldName.
(Ereditato da QSCommandBase) |
| AddWhereItem(String, SqlBinaryOperatorEnum, String, Object) |
Aggiunge alla clausola where un elemento ed un parametro contemporaneamente anteponendo un AND logico.
(Ereditato da QSCommandBase) |
| AddWhereItem(SqlBinaryOperatorEnum, String, SqlBinaryOperatorEnum, String, Object) |
Aggiunge alla clausola where un elemento ed un parametro contemporaneamente.
(Ereditato da QSCommandBase) |
| AddWhereLike(String, SqlLikeOperatorEnum, String) |
Aggiunge alla clausola where un operatore LIKE che verifica una stringa anteponendo un AND logico.
Crea il parametro con stesso nome di fieldName.
Quota sempre i caratteri speciali come '%' e '_'.
(Ereditato da QSCommandBase) |
| AddWhereLike(SqlBinaryOperatorEnum, String, SqlLikeOperatorEnum, String) |
Aggiunge alla clausola where un operatore LIKE che verifica una stringa.
Crea il parametro con stesso nome di fieldName.
Quota sempre i caratteri speciali come '%' e '_'.
(Ereditato da QSCommandBase) |
| AddWhereLike(String, SqlLikeOperatorEnum, String, Boolean) |
Aggiunge alla clausola where un operatore LIKE che verifica una stringa anteponendo un AND logico.
Crea il parametro con stesso nome di fieldName.
(Ereditato da QSCommandBase) |
| AddWhereLike(SqlBinaryOperatorEnum, String, SqlLikeOperatorEnum, String, Boolean) |
Aggiunge alla clausola where un operatore LIKE che verifica una stringa.
Crea il parametro con stesso nome di fieldName.
(Ereditato da QSCommandBase) |
| AddWhereLike(String, SqlLikeOperatorEnum, String, String, Boolean) |
Aggiunge alla clausola where un operatore LIKE che verifica una stringa anteponendo un AND logico.
(Ereditato da QSCommandBase) |
| AddWhereLike(SqlBinaryOperatorEnum, String, SqlLikeOperatorEnum, String, String, Boolean) |
Aggiunge alla clausola where un operatore LIKE che verifica una stringa.
(Ereditato da QSCommandBase) |
| AddWhereNotBetween(String, Object, Object) |
Aggiunge alla clausola where un elemento NOT BETWEEN creando contemporaneamente i parametri ed anteponendo un AND logico.
Crea i parametri con stesso nome di fieldName aggiungendo il suffisso MIN e MAX.
(Ereditato da QSCommandBase) |
| AddWhereNotBetween(SqlBinaryOperatorEnum, String, Object, Object) |
Aggiunge alla clausola where un elemento NOT BETWEEN creando contemporaneamente i parametri.
Crea i parametri con stesso nome di fieldName aggiungendo il suffisso MIN e MAX.
(Ereditato da QSCommandBase) |
| AddWhereNotBetween(String, String, Object, String, Object) |
Aggiunge alla clausola where un elemento NOT BETWEEN creando contemporaneamente i parametri ed anteponendo un AND logico.
(Ereditato da QSCommandBase) |
| AddWhereNotBetween(SqlBinaryOperatorEnum, String, String, Object, String, Object) |
Aggiunge alla clausola where un elemento NOT BETWEEN creando contemporaneamente i parametri.
(Ereditato da QSCommandBase) |
| AddWhereNotInList(String, ListString) |
Aggiunge alla clausola where una condizione di non esistenza del campo in una lista di elementi.
(Ereditato da QSCommandBase) |
| AddWhereNotInList(SqlBinaryOperatorEnum, String, ListString) |
Aggiunge alla clausola where una condizione di non esistenza del campo in una lista di elementi.
(Ereditato da QSCommandBase) |
| AddWhereNotLike(String, SqlLikeOperatorEnum, String) |
Aggiunge alla clausola where un operatore NOT LIKE che verifica una stringa anteponendo un AND logico.
Crea il parametro con stesso nome di fieldName.
Quota sempre i caratteri speciali come '%' e '_'.
(Ereditato da QSCommandBase) |
| AddWhereNotLike(SqlBinaryOperatorEnum, String, SqlLikeOperatorEnum, String) |
Aggiunge alla clausola where un operatore NOT LIKE che verifica una stringa.
Crea il parametro con stesso nome di fieldName.
Quota sempre i caratteri speciali come '%' e '_'.
(Ereditato da QSCommandBase) |
| AddWhereNotLike(String, SqlLikeOperatorEnum, String, Boolean) |
Aggiunge alla clausola where un operatore NOT LIKE che verifica una stringa anteponendo un AND logico.
Crea il parametro con stesso nome di fieldName.
(Ereditato da QSCommandBase) |
| AddWhereNotLike(SqlBinaryOperatorEnum, String, SqlLikeOperatorEnum, String, Boolean) |
Aggiunge alla clausola where un operatore NOT LIKE che verifica una stringa.
Crea il parametro con stesso nome di fieldName.
(Ereditato da QSCommandBase) |
| AddWhereNotLike(String, SqlLikeOperatorEnum, String, String, Boolean) |
Aggiunge alla clausola where un operatore NOT LIKE che verifica una stringa anteponendo un AND logico.
(Ereditato da QSCommandBase) |
| AddWhereNotLike(SqlBinaryOperatorEnum, String, SqlLikeOperatorEnum, String, String, Boolean) |
Aggiunge alla clausola where un operatore NOT LIKE che verifica una stringa.
(Ereditato da QSCommandBase) |
| AddWhereNull(String, Boolean) |
Aggiunge alla clausola where la verifica di un campo NULL oppure NOT NULL anteponendo un AND logico.
(Ereditato da QSCommandBase) |
| AddWhereNull(SqlBinaryOperatorEnum, String, Boolean) |
Aggiunge alla clausola where la verifica di un campo NULL oppure NOT NULL.
(Ereditato da QSCommandBase) |
| AddWhereNullOrEmpty(String, Boolean) |
Aggiunge alla clausola where la verifica di un campo di tipo stringa che sia vuoto o nullo oppure
non vuoto e non nullo, anteponendo un AND logico.
(Ereditato da QSCommandBase) |
| AddWhereNullOrEmpty(SqlBinaryOperatorEnum, String, Boolean) |
Aggiunge alla clausola where la verifica di un campo di tipo stringa che sia vuoto o nullo oppure non vuoto e non nullo.
(Ereditato da QSCommandBase) |
| AddWhereSubquery(String, Boolean, QSSelectCommand) |
Aggiunge alla clausola where una sottoquery anteponendo un AND logico.
(Ereditato da QSCommandBase) |
| AddWhereSubquery(SqlBinaryOperatorEnum, String, Boolean, QSSelectCommand) |
Aggiunge alla clausola where una sottoquery.
(Ereditato da QSCommandBase) |
| ContainsField | Verifica se un campo esiste già. |
| ContainsParameter |
Verifica l'esistenza di un parametro.
(Ereditato da QSCommandBase) |
| ContainsWhereParameter |
Verifica l'esistenza di un parametro dedicato alla clausola where.
(Ereditato da QSCommandBase) |
| CopyParametersFrom |
Copia i parametri dal comando passato a questo oggetto
(Ereditato da QSCommandBase) |
| CopyParametersTo |
Copia i parametri da questo oggetto al comando passato.
(Ereditato da QSCommandBase) |
| GetField | Restituisce il valore abbinato al campo specificato. |
| GetParameterValue |
Restituisce il valore di un parametro.
Se il parametro richiesto non è presente restituisce null.
(Ereditato da QSCommandBase) |
| GetWhereParameterValue |
Restituisce il valore di un parametro dedicato alla clausola where.
Se il parametro richiesto non è presente restituisce null.
(Ereditato da QSCommandBase) |
| IsEqualTo |
Confronta un comando con questa istanza.
(Ereditato da QSCommandBase) |
| ResetSqlText | Azzera la proprietà SqlText in modo che venga utilizzato il risultato di GetStatement() per effettuare la query. |
| Run | Esegue l'istruzione di UPDATE/INSERT. Eventuali errori sono registrati nella proprietà LastError dell'oggetto QSConnection dal quale questo comando è stato creato. |
| SetParameterValue(String, Object) |
Imposta il valore di un parametro. Se il parametro esiste già sovrascrive il valore.
I parametri sono di default con direzione input e dello stesso tipo dati passato (riconoscimento
automatico del DbType).
(Ereditato da QSCommandBase) |
| SetParameterValue(String, Object, DbType) |
Imposta il valore di un parametro. Se il parametro esiste già sovrascrive il valore.
Forza il DbType del Database.
(Ereditato da QSCommandBase) |
| SetWhereParameterValue(String, Object) |
Imposta il valore di un parametro dedicato alla clausola where. Se il parametro esiste già sovrascrive il valore.
I parametri sono di default con direzione input e dello stesso tipo dati passato (riconoscimento
automatico del DbType).
(Ereditato da QSCommandBase) |
| SetWhereParameterValue(String, Object, DbType) |
Imposta il valore di un parametro dedicato alla clausola where. Se il parametro esiste già sovrascrive il valore.
Forza il DbType del Database.
(Ereditato da QSCommandBase) |
Vedi anche