Metodo ILinkedUndoContext.BeginTransaction

Articolo
05/17/2013

Raggruppare una serie di modifiche al modello.Se una qualsiasi modifica avrà esito negativo, è possibile arrestare il gruppo intera, lasciando il modello invariato.Chiamata Commit() per il completamento della transazione.Se undo di chiamate dell'utente, il gruppo di tutto verrà ripristinata.

Spazio dei nomi: Microsoft.VisualStudio.Modeling.ExtensionEnablement
Assembly: Microsoft.VisualStudio.Modeling.Sdk.11.0 (in Microsoft.VisualStudio.Modeling.Sdk.11.0.dll)

Sintassi

'Dichiarazione
Function BeginTransaction ( _
    description As String _
) As ILinkedUndoTransaction

ILinkedUndoTransaction BeginTransaction(
    string description
)

Parametri

description
Tipo: System.String
qualsiasi stringa che identifica la transazione.

Valore restituito

Tipo: Microsoft.VisualStudio.Modeling.ExtensionEnablement.ILinkedUndoTransaction
la nuova transazione.Una volta completate le modifiche, il commit o interruzione ed eliminare questa transazione.

Note

Eseguire questa operazione nell'inizializzatore di un oggetto using clausola, assicurarsi che la transazione viene eliminata dopo avere completato le modifiche.

Un'eccezione che non viene intercettata in using il blocco consente tutte le modifiche del modello UML a essere ripristinato.Si noti che questo si applica solo alle modifiche nel modello UML e non alle modifiche apportate ad altre variabili, i database esterni, file, e così via.

le transazioni possono essere annidate.

Per ulteriori informazioni, vedere Procedura: collegare aggiornamenti di modelli tramite transazioni.

Esempi

try
{
  using (ILinkedUndoTransaction transaction =
              LinkedUndoContext.BeginTransaction("Swap names"))
  { 
    Operation1(); 
    Operation2();
    // Any exception in the preceding statements
    // will undo all of the changes in the model.
    transaction.Commit(); // Always remember Commit()!
  }
}
catch ()
{
    // If control reaches here,
    // Operation1 and Operation2 have
    // made no change to the model.
}

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

ILinkedUndoContext Interfaccia

Spazio dei nomi Microsoft.VisualStudio.Modeling.ExtensionEnablement

Condividi tramite