DkmScriptDocument Klasse

Definition

Stellt ein Dokument dar, das in einer Skript Laufzeitumgebung ausgeführt wird. Beispielsweise die Microsoft JavaScript-Engine.

public ref class DkmScriptDocument : Microsoft::VisualStudio::Debugger::Script::DkmScriptDocumentTreeNode
[System.Runtime.InteropServices.Guid("5df7092d-153e-3a9e-6a9c-01d70ae57148")]
public class DkmScriptDocument : Microsoft.VisualStudio.Debugger.Script.DkmScriptDocumentTreeNode
[<System.Runtime.InteropServices.Guid("5df7092d-153e-3a9e-6a9c-01d70ae57148")>]
type DkmScriptDocument = class
    inherit DkmScriptDocumentTreeNode
Public Class DkmScriptDocument
Inherits DkmScriptDocumentTreeNode
Vererbung
Attribute

Eigenschaften

ContentType

Gibt den Inhaltstyp des zugrunde liegenden Skript Dokuments an.

         Diese API wurde in Visual Studio 12 RTM (dkmapiversion. VS12RTM) eingeführt.
EmbeddedDocumentKind

Gibt die Art des eingebetteten Dokuments an (oder None, wenn kein eingebettetes Dokument ist). Der Typ kann ein Exitcode, ein Funktionscode oder ein Skriptblock sein.

Diese API wurde in Visual Studio 12 RTM (dkmapiversion. VS12RTM) eingeführt.

FilePath

Optionale Dateipfad (Beispiel: c:\myfolder\file.js) des Skript Dokuments. Dieser Wert ist NULL, wenn das Dokument keine URL enthält oder eine nicht-' file://'-URL aufweist.

Flags

Markieren Sie die Eigenschaften eines Skript Dokuments.

IsUnloaded

Gibt "true" zurück, wenn ein "entladen"-Ereignis für dieses Objekt ausgelöst wurde (Beispiel: dkmthread:: entladen wird aufgerufen) oder wenn das Objekt geschlossen wurde. Beachten Sie, dass bei der Überprüfung dieses Status, ohne Synchronisierung, der Status "zurückgegeben" möglicherweise nicht mehr genau der Anweisung entspricht, nachdem er gelesen wurde.

(Geerbt von DkmDataContainer)
JmcState

Der nur-Code-Status des Dokuments. Um den Wert dieser Variablen zu aktualisieren, wenden Sie dkmscriptdocument. setjmcstate an.

Diese API wurde in Visual Studio 12 RTM (dkmapiversion. VS12RTM) eingeführt.

Module

Der Symbol Container, der das Dokument besitzt.

Parent

Optionale Übergeordnetes Element in der Skript Dokumentstruktur. Dieser Wert wird für den Stamm Anwendungs Container NULL sein.

(Geerbt von DkmScriptDocumentTreeNode)
Process

Dkmprocess stellt einen Ziel Prozess dar, der debuggt wird. Der Debugger debuggt die Prozesse, sodass dies die grundlegende debugeinheit ist. Ein dkmprocess kann einen System Prozess oder einen virtuellen Prozess, z. b. Minidumps, darstellen.

(Geerbt von DkmScriptDocumentTreeNode)
RuntimeInstance

Die Laufzeit, die diesen Container erzeugt hat.

(Geerbt von DkmScriptDocumentTreeNode)
SourceProjectItem

Optionale Das Projekt Element, das diesem Dokument entspricht.

Title

Der Titel des Knotens.

(Geerbt von DkmScriptDocumentTreeNode)
UniqueId

GUID, die dieses Skript Dokument-Ordner Objekt eindeutig identifiziert.

Url

Optionale Die URL des Skript Dokuments. Dieser Wert kann NULL sein, wenn das Dokument keine URL enthält.

Methoden

Create(DkmRuntimeInstance, DkmScriptDocumentTreeNode, String, DkmModule, String, String, DkmScriptDocumentFlags, DkmScriptDocumentContentType, DkmScriptEmbeddedDocumentKind, DkmScriptSourceProjectItem, DkmScriptDocumentJmcState, DkmDataItem)

Erstellen Sie eine neue dkmscriptdocument-Objektinstanz.

Diese Methode sendet ein scriptdocumenttreenodecreate-Ereignis.

Location-Einschränkung: die API muss von einer Monitor Komponente (Komponentenebene < 100.000) aufgerufen werden.

Diese API wurde in Visual Studio 12 RTM (dkmapiversion. VS12RTM) eingeführt.

Create(DkmRuntimeInstance, DkmScriptDocumentTreeNode, String, DkmModule, String, String, DkmScriptDocumentFlags, DkmScriptSourceProjectItem, DkmDataItem)

Erstellen Sie eine neue dkmscriptdocument-Objektinstanz.

Diese Methode sendet ein scriptdocumenttreenodecreate-Ereignis.

Location-Einschränkung: die API muss von einer Monitor Komponente (Komponentenebene < 100.000) aufgerufen werden.

GetContent(Boolean, UInt32[])

Stellt den aktuellen Inhalt des angegebenen Dokument Objekts bereit.

GetDataItem<T>()

Ruft die Instanz von 't ' ab, die dieser Container Instanz hinzugefügt wurde. Wenn dieser Container kein 't-Zeichen enthält, gibt diese Funktion NULL zurück.

(Geerbt von DkmDataContainer)
GetProjectItemScriptBlocks()

Fragt den Sprachdienst (ivslanguagedebuginfoscript) ab, um Skriptblock Informationen aus dem zugeordneten Projekt Element des angegebenen Skript Dokuments zu erhalten.

Location-Einschränkung: die API muss von einer IDE-Komponente (Komponentenebene > 100.000) aufgerufen werden.

OnContentInsert(DkmTextSpan, String)

Löst ein scriptdocumentcontentinsert-Ereignis aus. Der Skript Dokument Anbieter gibt dieses Ereignis nur aus, wenn Ereignisse für dieses Dokument aktiviert wurden.

Diese Methode kann nur von der Komponente aufgerufen werden, die das Objekt erstellt hat.

OnContentRemove(DkmTextSpan, Int32)

Löst ein scriptdocumentcontentremove-Ereignis aus. Der Skript Dokument Anbieter gibt dieses Ereignis nur aus, wenn Ereignisse für dieses Dokument aktiviert wurden.

Diese Methode kann nur von der Komponente aufgerufen werden, die das Objekt erstellt hat.

RemoveDataItem<T>()

Entfernen Sie die Instanz von 't "aus diesem Container. Es ist in der Regel nicht erforderlich, diese Methode aufzurufen, da ein Datencontainer automatisch geleert wird, wenn das Objekt geschlossen wird.

(Geerbt von DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)

Fügen Sie ein neues Element in den Datencontainer ein.

(Geerbt von DkmDataContainer)
SetJmcState(DkmScriptDocumentJmcState)

Legt den JMC-Status für das Skript Dokument fest. Wenn der Wert "unsicher" ist, kann der Skript-Debug-Monitor seine eigene Bestimmung des JMC-Zustands machen oder ein Projekt System für den JMC-Status anfordern.

Diese API wurde in Visual Studio 12 RTM (dkmapiversion. VS12RTM) eingeführt.

SetRaiseContentEvents(Boolean)

Aktiviert oder deaktiviert das anwecken von Ereignissen, wenn der Inhalt des Dokuments geändert wird. Standardmäßig generieren Dokumente keine Inhalts Ereignisse. Diese Methode sollte also von jeder Komponente aufgerufen werden, die Inhalts Ereignisse empfangen möchte. Der Skript Dokument-Manager verwaltet die Anzahl der Aufrufe zum Aktivieren von Inhalts Ereignissen und gibt Ereignisse aus, wenn diese Anzahl größer als 0 (null) ist. Aufrufer sollten darauf achten, sicherzustellen, dass "tartraisecontentevents (false)" nur nach einem erfolgreichen Aufruf von "" für "* Inhalts Ereignisse werden automatisch deaktiviert, wenn das Dokument entladen wird.

SetRaiseSymbolEvents(Boolean)

Aktiviert oder deaktiviert das Auflösen von scriptsymbolsupveralteten, wenn Symbole im Dokument geändert werden. Standardmäßig generieren Dokumente keine Symbol Ereignisse. Diese Methode sollte also von jeder Komponente aufgerufen werden, die Symbol Ereignisse empfangen möchte. Der Skript Dokument-Manager verwaltet die Anzahl der Aufrufe zum Aktivieren von Symbol Ereignissen und gibt Ereignisse aus, wenn diese Anzahl größer als 0 (null) ist. Aufrufer sollten darauf achten, dass setraisesymbolevents (false) nur nach einem erfolgreichen Aufruf von setraisesymbolevents (true) aufgerufen wird. Symbol Ereignisse werden automatisch deaktiviert, wenn das Dokument entladen wird.

SetRaiseSymbolEvents(DkmWorkList, Boolean, DkmCompletionRoutine<DkmSetRaiseSymbolEventsAsyncResult>)

Aktiviert oder deaktiviert das Auflösen von scriptsymbolsupveralteten, wenn Symbole im Dokument geändert werden. Standardmäßig generieren Dokumente keine Symbol Ereignisse. Diese Methode sollte also von jeder Komponente aufgerufen werden, die Symbol Ereignisse empfangen möchte. Der Skript Dokument-Manager verwaltet die Anzahl der Aufrufe zum Aktivieren von Symbol Ereignissen und gibt Ereignisse aus, wenn diese Anzahl größer als 0 (null) ist. Aufrufer sollten darauf achten, dass setraisesymbolevents (false) nur nach einem erfolgreichen Aufruf von setraisesymbolevents (true) aufgerufen wird. Symbol Ereignisse werden automatisch deaktiviert, wenn das Dokument entladen wird.

Diese Methode fügt ein neues Arbeits Element an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeits Element angefügt wurde. Die tatsächliche Verarbeitung der Arbeitsaufgabe erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Abschluss Routine abgeschlossen wurde.

TryResolve(DkmSourceFileId)

Diese Methode wird aufgerufen, wenn ein Skript Dokument erstellt wird oder wenn der Projekt Element Pfad festgelegt ist, um Breakpoints für das angegebene Skript Dokument zu binden.

Location-Einschränkung: die API muss von einer IDE-Komponente (Komponentenebene > 100.000) aufgerufen werden.

Unload()

Wird von einem Skript Dokument aufgerufen, um ein scriptdocumenttreenodeentladen-Ereignis auszulösen.

Diese Methode kann nur von der Komponente aufgerufen werden, die das Objekt erstellt hat.

(Geerbt von DkmScriptDocumentTreeNode)

Gilt für