DkmModule.Create 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmDataItem) |
建立新的 DkmModule 物件，代表一或多個載入模組的符號， (模組實例) 。 這些物件是由符號提供者所建立。 建立 DkmModule 物件之後，符號提供者應該呼叫 DkmModuleInstance.SetModule，以將 DkmModuleInstance 和 DkmModule 建立關聯。 這個方法會傳送 ModuleCreate 事件。 |
| Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmWorkerProcessConnection, String, DkmDataItem) |
建立新的 DkmModule 物件，代表一或多個載入模組的符號， (模組實例) 。 這些物件是由符號提供者所建立。 建立 DkmModule 物件之後，符號提供者應該呼叫 DkmModuleInstance.SetModule，以將 DkmModuleInstance 和 DkmModule 建立關聯。 這個方法會傳送 ModuleCreate 事件。 此 API 是在 Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) 中引進。 |
| Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmWorkerProcessConnection, String, DkmModuleSymbolFlags, DkmDataItem) |
建立新的 DkmModule 物件，代表一或多個載入模組的符號， (模組實例) 。 這些物件是由符號提供者所建立。 建立 DkmModule 物件之後，符號提供者應該呼叫 DkmModuleInstance.SetModule，以將 DkmModuleInstance 和 DkmModule 建立關聯。 這個方法會傳送 ModuleCreate 事件。 此 API 是在 Visual Studio 17 Update 2 (DkmApiVersion.VS17Update2) 引進。 |
Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmDataItem)
建立新的 DkmModule 物件，代表一或多個載入模組的符號， (模組實例) 。 這些物件是由符號提供者所建立。 建立 DkmModule 物件之後，符號提供者應該呼叫 DkmModuleInstance.SetModule，以將 DkmModuleInstance 和 DkmModule 建立關聯。
這個方法會傳送 ModuleCreate 事件。
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.DkmModulePublic Shared Function Create (Id As DkmModuleId, Name As String, CompilerId As DkmCompilerId, Connection As DkmTransportConnection, DataItem As DkmDataItem) As DkmModule參數
- Id
- DkmModuleId
[In]用來唯一識別特定 DkmModule 實例的 Guid 配對。
- Name
- String
[In]模組的名稱。
- CompilerId
- DkmCompilerId
[In]產生本課程模組中所有程式代碼之編譯程式的 LanguageId/VendorId。 如果模組可能包含混合的語言，這是 Guid.Empty/Guid.Empty。 這幾乎一律為 PDB 型模組的 Guid.Empty/Guid.Empty。 動態語言通常用來避免網路來回行程，以探索每個符號的語言。
- Connection
- DkmTransportConnection
[In，Optional]對於從遠端載入符號的模組，會使用連接屬性來判斷 Connection 的來源。 否則，這會是 NULL。
- DataItem
- DkmDataItem
[In，Optional]要加入至新 DkmModule 實例的數據物件。 在呼叫端不需要加入數據項的情況下，傳遞 'null'。
傳回
[Out]這個方法呼叫的結果。
適用於
Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmWorkerProcessConnection, String, DkmDataItem)
建立新的 DkmModule 物件，代表一或多個載入模組的符號， (模組實例) 。 這些物件是由符號提供者所建立。 建立 DkmModule 物件之後，符號提供者應該呼叫 DkmModuleInstance.SetModule，以將 DkmModuleInstance 和 DkmModule 建立關聯。
這個方法會傳送 ModuleCreate 事件。
此 API 是在 Visual Studio 16 RTM (DkmApiVersion.VS16RTMPreview) 中引進。
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.DkmModulePublic 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參數
- Id
- DkmModuleId
[In]用來唯一識別特定 DkmModule 實例的 Guid 配對。
- Name
- String
[In]模組的名稱。
- CompilerId
- DkmCompilerId
[In]產生本課程模組中所有程式代碼之編譯程式的 LanguageId/VendorId。 如果模組可能包含混合的語言，這是 Guid.Empty/Guid.Empty。 這幾乎一律為 PDB 型模組的 Guid.Empty/Guid.Empty。 動態語言通常用來避免網路來回行程，以探索每個符號的語言。
- Connection
- DkmTransportConnection
[In，Optional]對於從遠端載入符號的模組，會使用連接屬性來判斷 Connection 的來源。 否則，這會是 NULL。
- SymbolsConnection
- DkmWorkerProcessConnection
[In，Optional]如果為非 Null，這會指定處理此 DkmModule 符號的背景工作進程連線。 如果在 IDE 進程中載入符號，或是在遠端調試程式中載入符號，則為 null， (DkmModule.Connection 為非 Null) 。
- FilePath
- String
[In，Optional]如果指定，這會包含符號檔的完整路徑，可備份 DkmModule (例如：c：\myproj\bin\Debug\myproj.pdb) 。
- DataItem
- DkmDataItem
[In，Optional]要加入至新 DkmModule 實例的數據物件。 在呼叫端不需要加入數據項的情況下，傳遞 'null'。
傳回
[Out]這個方法呼叫的結果。
適用於
Create(DkmModuleId, String, DkmCompilerId, DkmTransportConnection, DkmWorkerProcessConnection, String, DkmModuleSymbolFlags, DkmDataItem)
建立新的 DkmModule 物件，代表一或多個載入模組的符號， (模組實例) 。 這些物件是由符號提供者所建立。 建立 DkmModule 物件之後，符號提供者應該呼叫 DkmModuleInstance.SetModule，以將 DkmModuleInstance 和 DkmModule 建立關聯。
這個方法會傳送 ModuleCreate 事件。
此 API 是在 Visual Studio 17 Update 2 (DkmApiVersion.VS17Update2) 引進。
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.DkmModulePublic 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參數
- Id
- DkmModuleId
[In]用來唯一識別特定 DkmModule 實例的 Guid 配對。
- Name
- String
[In]模組的名稱。
- CompilerId
- DkmCompilerId
[In]產生本課程模組中所有程式代碼之編譯程式的 LanguageId/VendorId。 如果模組可能包含混合的語言，這是 Guid.Empty/Guid.Empty。 這幾乎一律為 PDB 型模組的 Guid.Empty/Guid.Empty。 動態語言通常用來避免網路來回行程，以探索每個符號的語言。
- Connection
- DkmTransportConnection
[In，Optional]對於從遠端載入符號的模組，會使用連接屬性來判斷 Connection 的來源。 否則，這會是 NULL。
- SymbolsConnection
- DkmWorkerProcessConnection
[In，Optional]如果為非 Null，這會指定處理此 DkmModule 符號的背景工作進程連線。 如果在 IDE 進程中載入符號，或是在遠端調試程式中載入符號，則為 null， (DkmModule.Connection 為非 Null) 。
- FilePath
- String
[In，Optional]如果指定，這會包含符號檔的完整路徑，可備份 DkmModule (例如：c：\myproj\bin\Debug\myproj.pdb) 。
- Flags
- DkmModuleSymbolFlags
[In]旗標，指出這個 DkmModule 物件的特性。
- DataItem
- DkmDataItem
[In，Optional]要加入至新 DkmModule 實例的數據物件。 在呼叫端不需要加入數據項的情況下，傳遞 'null'。
傳回
[Out]這個方法呼叫的結果。