Metodo XmlStore.BeginEditingScope
Avvia una nuova operazione di modifica su uno o più modelli in questo XmlStore.
Spazio dei nomi Microsoft.VisualStudio.XmlEditor
Assembly: Microsoft.VisualStudio.XmlEditor (in Microsoft.VisualStudio.XmlEditor.dll)
Sintassi
'Dichiarazione
Public MustOverride Function BeginEditingScope ( _
name As String, _
state As Object _
) As XmlEditingScope
'Utilizzo
Dim instance As XmlStore
Dim name As String
Dim state As Object
Dim returnValue As XmlEditingScope
returnValue = instance.BeginEditingScope(name, _
state)
public abstract XmlEditingScope BeginEditingScope(
string name,
Object state
)
public:
virtual XmlEditingScope^ BeginEditingScope(
String^ name,
Object^ state
) abstract
abstract BeginEditingScope :
name:string *
state:Object -> XmlEditingScope
public abstract function BeginEditingScope(
name : String,
state : Object
) : XmlEditingScope
Parametri
- name
Tipo: System.String
Nome dell'oggetto BeginEditingScope().
- state
Tipo: System.Object
Oggetto definito dall'utente che si desidera associare a questo ambito di modifica.Questo oggetto si rivela utile per individuare di nuovo il contesto durante un'operazione di annullamento.
Valore restituito
Tipo: Microsoft.VisualStudio.XmlEditor.XmlEditingScope
Nuovo XmlEditingScope.
Osservazioni
È inoltre possibile utilizzare questo BeginEditingScope() per bloccare un albero di analisi in modo da ottenere uno snapshot coerente in uno scenario di sola lettura.L'Editor XML non modificherà gli alberi in XmlStore nel thread di analisi di background mentre questo XmlEditingScope è attivo.Richiamare il metodo Complete al termine dell'operazione.Se viene generata un'eccezione, le modifiche apportate all'albero mentre questo XmlEditingScope era attivo verranno annullate automaticamente.
È possibile richiamare questo metodo più volte da differenti posizioni nel codice per creare oggetti XmlEditingScope annidati.L'evento EditingScopeCompleted non verrà generato finché l'oggetto XmlEditingScope di livello più alto non è stato completato e tutti gli oggetti XmlEditingScope annidati non sono stati recuperati in un'unità di annullamento.