Freigeben über

DkmModule.Create Methode

  • Referenz

Definition

Namespace:
Microsoft.VisualStudio.Debugger.Symbols
Assembly:
Microsoft.VisualStudio.Debugger.Engine.dll
Paket:
Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Überlädt

Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmDataItem)

Erstellt ein neues DkmModule-Objekt, das die Symbole für ein oder mehrere geladene Module (Modulinstanzen) darstellt. Diese Objekte werden von Symbolanbietern erstellt. Nachdem das DkmModule-Objekt erstellt wurde, sollten Symbolanbieter DkmModuleInstance.SetModule aufrufen, um DkmModuleInstance und DkmModule miteinander zu verknüpfen.

Diese Methode sendet ein ModuleCreate-Ereignis.
Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmWorkerProcessConnection, String, DkmDataItem)

Erstellt ein neues DkmModule-Objekt, das die Symbole für ein oder mehrere geladene Module (Modulinstanzen) darstellt. Diese Objekte werden von Symbolanbietern erstellt. Nachdem das DkmModule-Objekt erstellt wurde, sollten Symbolanbieter DkmModuleInstance.SetModule aufrufen, um DkmModuleInstance und DkmModule miteinander zu verknüpfen.

Diese Methode sendet ein ModuleCreate-Ereignis.

Diese API wurde in Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) eingeführt.
Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmWorkerProcessConnection, String, DkmModuleSymbolFlags, DkmDataItem)

Erstellt ein neues DkmModule-Objekt, das die Symbole für ein oder mehrere geladene Module (Modulinstanzen) darstellt. Diese Objekte werden von Symbolanbietern erstellt. Nachdem das DkmModule-Objekt erstellt wurde, sollten Symbolanbieter DkmModuleInstance.SetModule aufrufen, um DkmModuleInstance und DkmModule miteinander zu verknüpfen.

Diese Methode sendet ein ModuleCreate-Ereignis.

Diese API wurde in Visual Studio 17 Update 2 (DkmApiVersion.VS17Update2) eingeführt.

Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmDataItem)

Erstellt ein neues DkmModule-Objekt, das die Symbole für ein oder mehrere geladene Module (Modulinstanzen) darstellt. Diese Objekte werden von Symbolanbietern erstellt. Nachdem das DkmModule-Objekt erstellt wurde, sollten Symbolanbieter DkmModuleInstance.SetModule aufrufen, um DkmModuleInstance und DkmModule miteinander zu verknüpfen.

Diese Methode sendet ein ModuleCreate-Ereignis.

public:
 static Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Create(Microsoft::VisualStudio::Debugger::Symbols::DkmModuleId Id, System::String ^ Name, Microsoft::VisualStudio::Debugger::Evaluation::DkmCompilerId CompilerId, Microsoft::VisualStudio::Debugger::DefaultPort::DkmTransportConnection ^ Connection, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Symbols.DkmModule Create (Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId Id, string Name, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.Symbols.DkmModule Create (Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId Id, string Name, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection? Connection, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId * string * Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId * Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Symbols.DkmModule
Public Shared Function Create (Id As DkmModuleId, Name As String, CompilerId As DkmCompilerId, Connection As DkmTransportConnection, DataItem As DkmDataItem) As DkmModule

Parameter

Id
DkmModuleId

[In] Guid-Paar, das verwendet wird, um eine bestimmte DkmModule-instance eindeutig zu identifizieren.

Name
String

[In] Name des Moduls.

CompilerId
DkmCompilerId

[In] LanguageId/VendorId für den Compiler, der den gesamten Code in diesem Modul erstellt hat. Dies ist Guid.Empty/Guid.Empty, wenn das Modul eine Mischung aus Sprachen enthalten kann. Dies ist fast immer Guid.Empty/Guid.Empty für PDB-basierte Module. Es wird in der Regel von dynamischen Sprachen verwendet, um Netzwerk-Roundtrips zu vermeiden, um die Sprache der einzelnen Symbole zu ermitteln.

Connection
DkmTransportConnection

[In,Optional] Bei Modulen, in denen Symbole remote geladen werden, wird die Verbindungseigenschaft verwendet, um zu bestimmen, woher die Verbindung stammt. Andernfalls ist dies NULL.

DataItem
DkmDataItem

[In,Optional] Datenobjekt, das dem neuen DkmModule-instance hinzugefügt werden soll. Übergeben Sie "NULL", falls der Aufrufer kein Datenelement hinzufügen muss.

Gibt zurück

DkmModule

[Out] Ergebnis dieses Methodenaufrufs.

Gilt für:

Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmWorkerProcessConnection, String, DkmDataItem)

Erstellt ein neues DkmModule-Objekt, das die Symbole für ein oder mehrere geladene Module (Modulinstanzen) darstellt. Diese Objekte werden von Symbolanbietern erstellt. Nachdem das DkmModule-Objekt erstellt wurde, sollten Symbolanbieter DkmModuleInstance.SetModule aufrufen, um DkmModuleInstance und DkmModule miteinander zu verknüpfen.

Diese Methode sendet ein ModuleCreate-Ereignis.

Diese API wurde in Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) eingeführt.

public:
 static Microsoft::VisualStudio::Debugger::Symbols::DkmModule ^ Create(Microsoft::VisualStudio::Debugger::Symbols::DkmModuleId Id, System::String ^ Name, Microsoft::VisualStudio::Debugger::Evaluation::DkmCompilerId CompilerId, Microsoft::VisualStudio::Debugger::DefaultPort::DkmTransportConnection ^ Connection, Microsoft::VisualStudio::Debugger::DefaultPort::DkmWorkerProcessConnection ^ SymbolsConnection, System::String ^ FilePath, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Symbols.DkmModule Create (Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId Id, string Name, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, Microsoft.VisualStudio.Debugger.DefaultPort.DkmWorkerProcessConnection SymbolsConnection, string FilePath, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
public static Microsoft.VisualStudio.Debugger.Symbols.DkmModule Create (Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId Id, string Name, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection? Connection, Microsoft.VisualStudio.Debugger.DefaultPort.DkmWorkerProcessConnection? SymbolsConnection, string? FilePath, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId * string * Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId * Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * Microsoft.VisualStudio.Debugger.DefaultPort.DkmWorkerProcessConnection * string * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Symbols.DkmModule
Public Shared Function Create (Id As DkmModuleId, Name As String, CompilerId As DkmCompilerId, Connection As DkmTransportConnection, SymbolsConnection As DkmWorkerProcessConnection, FilePath As String, DataItem As DkmDataItem) As DkmModule

Parameter

Id
DkmModuleId

[In] Guid-Paar, das verwendet wird, um eine bestimmte DkmModule-instance eindeutig zu identifizieren.

Name
String

[In] Name des Moduls.

CompilerId
DkmCompilerId

[In] LanguageId/VendorId für den Compiler, der den gesamten Code in diesem Modul erstellt hat. Dies ist Guid.Empty/Guid.Empty, wenn das Modul eine Mischung aus Sprachen enthalten kann. Dies ist fast immer Guid.Empty/Guid.Empty für PDB-basierte Module. Es wird in der Regel von dynamischen Sprachen verwendet, um Netzwerk-Roundtrips zu vermeiden, um die Sprache der einzelnen Symbole zu ermitteln.

Connection
DkmTransportConnection

[In,Optional] Bei Modulen, in denen Symbole remote geladen werden, wird die Verbindungseigenschaft verwendet, um zu bestimmen, woher die Verbindung stammt. Andernfalls ist dies NULL.

SymbolsConnection
DkmWorkerProcessConnection

[In,Optional] Wenn dieser Wert nicht NULL ist, gibt dies eine Verbindung mit einem Arbeitsprozess an, bei dem Symbole für dieses DkmModule verarbeitet werden. Dies ist NULL, wenn Symbole im IDE-Prozess geladen werden oder wenn sie im Remotedebugger geladen werden (DkmModule.Connection ist ungleich NULL).

FilePath
String

[In,Optional] Falls angegeben, enthält dies den vollständigen Pfad zur Symboldatei, die das DkmModule-Element unterstützt (z. B. c:\myproj\bin\Debug\myproj.pdb).

DataItem
DkmDataItem

[In,Optional] Datenobjekt, das dem neuen DkmModule-instance hinzugefügt werden soll. Übergeben Sie "NULL", falls der Aufrufer kein Datenelement hinzufügen muss.

Gibt zurück

DkmModule

[Out] Ergebnis dieses Methodenaufrufs.

Gilt für:

Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmWorkerProcessConnection, String, DkmModuleSymbolFlags, DkmDataItem)

Erstellt ein neues DkmModule-Objekt, das die Symbole für ein oder mehrere geladene Module (Modulinstanzen) darstellt. Diese Objekte werden von Symbolanbietern erstellt. Nachdem das DkmModule-Objekt erstellt wurde, sollten Symbolanbieter DkmModuleInstance.SetModule aufrufen, um DkmModuleInstance und DkmModule miteinander zu verknüpfen.

Diese Methode sendet ein ModuleCreate-Ereignis.

Diese API wurde in Visual Studio 17 Update 2 (DkmApiVersion.VS17Update2) eingeführt.

public static Microsoft.VisualStudio.Debugger.Symbols.DkmModule Create (Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId Id, string Name, Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId CompilerId, Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection? Connection, Microsoft.VisualStudio.Debugger.DefaultPort.DkmWorkerProcessConnection? SymbolsConnection, string? FilePath, Microsoft.VisualStudio.Debugger.Symbols.DkmModuleSymbolFlags Flags, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);
static member Create : Microsoft.VisualStudio.Debugger.Symbols.DkmModuleId * string * Microsoft.VisualStudio.Debugger.Evaluation.DkmCompilerId * Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * Microsoft.VisualStudio.Debugger.DefaultPort.DkmWorkerProcessConnection * string * Microsoft.VisualStudio.Debugger.Symbols.DkmModuleSymbolFlags * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Symbols.DkmModule
Public Shared Function Create (Id As DkmModuleId, Name As String, CompilerId As DkmCompilerId, Connection As DkmTransportConnection, SymbolsConnection As DkmWorkerProcessConnection, FilePath As String, Flags As DkmModuleSymbolFlags, DataItem As DkmDataItem) As DkmModule

Parameter

Id
DkmModuleId

[In] Guid-Paar, das verwendet wird, um eine bestimmte DkmModule-instance eindeutig zu identifizieren.

Name
String

[In] Name des Moduls.

CompilerId
DkmCompilerId

[In] LanguageId/VendorId für den Compiler, der den gesamten Code in diesem Modul erstellt hat. Dies ist Guid.Empty/Guid.Empty, wenn das Modul eine Mischung aus Sprachen enthalten kann. Dies ist fast immer Guid.Empty/Guid.Empty für PDB-basierte Module. Es wird in der Regel von dynamischen Sprachen verwendet, um Netzwerk-Roundtrips zu vermeiden, um die Sprache der einzelnen Symbole zu ermitteln.

Connection
DkmTransportConnection

[In,Optional] Bei Modulen, in denen Symbole remote geladen werden, wird die Verbindungseigenschaft verwendet, um zu bestimmen, woher die Verbindung stammt. Andernfalls ist dies NULL.

SymbolsConnection
DkmWorkerProcessConnection

[In,Optional] Wenn dieser Wert nicht NULL ist, gibt dies eine Verbindung mit einem Arbeitsprozess an, bei dem Symbole für dieses DkmModule verarbeitet werden. Dies ist NULL, wenn Symbole im IDE-Prozess geladen werden oder wenn sie im Remotedebugger geladen werden (DkmModule.Connection ist ungleich NULL).

FilePath
String

[In,Optional] Falls angegeben, enthält dies den vollständigen Pfad zur Symboldatei, die das DkmModule-Element unterstützt (z. B. c:\myproj\bin\Debug\myproj.pdb).

Flags
DkmModuleSymbolFlags

[In] Flags, die Merkmale dieses DkmModule-Objekts angeben.

DataItem
DkmDataItem

[In,Optional] Datenobjekt, das dem neuen DkmModule-instance hinzugefügt werden soll. Übergeben Sie "NULL", falls der Aufrufer kein Datenelement hinzufügen muss.

Gibt zurück

DkmModule

[Out] Ergebnis dieses Methodenaufrufs.

Gilt für: