DkmScriptInstructionSymbol Classe

Definição

DkmScriptInstructionSymbol é usado para representar uma instrução executável em um ambiente de tempo de execução baseado em script, como o mecanismo JavaScript da Microsoft.

public ref class DkmScriptInstructionSymbol : Microsoft::VisualStudio::Debugger::Symbols::DkmInstructionSymbol
[Windows::Foundation::Metadata::WebHostHidden]
public ref class DkmScriptInstructionSymbol : Microsoft::VisualStudio::Debugger::Symbols::DkmInstructionSymbol
[Windows::Foundation::Metadata::WebHostHidden]
class DkmScriptInstructionSymbol : Microsoft::VisualStudio::Debugger::Symbols::DkmInstructionSymbol
[System.Runtime.InteropServices.Guid("aebaa0af-6437-2ecf-aaf1-86c58eba9447")]
public class DkmScriptInstructionSymbol : Microsoft.VisualStudio.Debugger.Symbols.DkmInstructionSymbol
[<System.Runtime.InteropServices.Guid("aebaa0af-6437-2ecf-aaf1-86c58eba9447")>]
type DkmScriptInstructionSymbol = class
    inherit DkmInstructionSymbol
Public Class DkmScriptInstructionSymbol
Inherits DkmInstructionSymbol
Herança
DkmScriptInstructionSymbol
Atributos

Propriedades

AdditionalData

Adicional Dados específicos de tempo de execução adicionais associados a um endereço. Esses dados não serão usados durante a comparação de endereços.

Document

Documento que contém esta instrução.

Module

A classe DkmModule representa um pacote de códigos (ex: dll ou exe) que é ou uma vez carregado em um ou mais processos. A classe DkmModule é o objeto central para as APIs de símbolo e é 1:1 com a notação do manipulador de símbolos do que é carregado. Se um pacote de códigos for carregado em três processos diferentes (ou no mesmo processo, mas com três endereços base diferentes ou três domínios de aplicativo diferentes), mas o manipulador de símbolos considerar que todos eles são idênticos, haverá apenas um objeto de módulo.

(Herdado de DkmInstructionSymbol)
Revision

Indica o número de revisão que inseriu a instrução representada por esse objeto. Normalmente, isso será zero para documentos não dinâmicos.

RuntimeType

A ID de tempo de execução identifica o ambiente de execução para um trecho de código específico. As IDs de tempo de execução são usadas pelo Dispatcher para decidir para qual monitor enviar. Observe que a ordenação dos GUIDs de ID de tempo de execução é um pouco significativa, pois isso determina qual tempo de execução Obtém a primeira captura durante a arbitragem. Portanto, se um quiser declarar uma nova instância de tempo de execução criada no CLR, a ID de tempo de execução deverá ser menor que DkmRuntimeId. CLR.

(Herdado de DkmInstructionSymbol)
StartIndex

Indica o índice de caractere inicial desta instrução, em relação ao início da revisão que inseriu esta instrução.

StatementLength

Comprimento da instrução (em caracteres).

TagValue

DkmInstructionSymbol é uma classe base abstrata. Essa enumeração indica a qual classe derivada esse objeto é uma instância do.

(Herdado de DkmInstructionSymbol)

Métodos

Bind(DkmModuleInstance)

Associa um símbolo de instrução a uma instância de módulo específica. Um símbolo de instrução é conectado a um DkmModule em vez de a um DkmModuleInstance, portanto, ele não está associado a um processo específico, domínio de aplicativo ou endereço base de módulo.

(Herdado de DkmInstructionSymbol)
Create(DkmModule, Guid, DkmScriptDocument, Int32, Int32, Int32, ReadOnlyCollection<Byte>)

Crie uma nova instância do objeto DkmScriptInstructionSymbol.

GetAlternateSourcePosition(DkmSourcePositionFlags)

Retorna uma posição de arquivo de origem alternativa (ex: example.cs, linha 12) para este símbolo de instrução. Isso é usado atualmente em cenários de mapa de origem para retornar o local de origem (não mapeado) original. Essa API será chamada pela interface do usuário do depurador nos casos em que o local de origem principal não puder ser encontrado.

Restrição de local: a API deve ser chamada de um componente IDE (nível de componente > 100.000).

Essa API foi introduzida no Visual Studio 12 atualização 3 (DkmApiVersion. VS12Update3).

(Herdado de DkmInstructionSymbol)
GetBasicInfo(DkmWorkList, DkmModuleInstance, DkmBasicSymbolInfoRequestFlags, DkmCompletionRoutine<DkmGetBasicSymbolInfoAsyncResult>)

Computa de forma assíncrona informações de símbolo básicas para um determinado DkmInstructionSymbol.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará assim que o item de trabalho tiver sido anexado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: a API deve ser chamada de um componente IDE (nível de componente > 100.000).

Essa API foi introduzida no Visual Studio 16 RTM (DkmApiVersion. VS16RTMPreview).

(Herdado de DkmInstructionSymbol)
GetCompilerId(DkmInspectionSession)

Retorna a ID do compilador (LanguageID/VendorID) de um determinado símbolo.

Para o leitor do Microsoft PDB, se o PDB foi criado por um compilador que usou ISymUnmanagedWriter, o leitor de PDB poderá determinar o DkmCompilerId correto do par LanguageID/VendorID passado de ISymUnmanagedWriter. DefineDocument.

Se o PDB foi criado por um compilador que não usou ISymUnmanagedWriter, o leitor de PDB pode conseguir obter o DkmCompilerId dos registros S_COMPILE * PDB. Para que isso funcione, o compilador deve primeiro emitir o registro S_COMPILE * para cada compiland. O compilador precisa ter a certeza de preencher corretamente o valor de enumeração de idioma e a cadeia de caracteres do compilador. O compilador deve garantir que a cadeia de caracteres do compilador seja suficientemente específica para ser usada para selecionar um avaliador de expressão; é recomendável incluir um nome de empresa. Depois de emitir o par de enumeração/nome, a configuração para o avaliador de expressão deve registrar esse par com o depurador. Para fazer isso, o avaliador de expressão deve definir essa chave do registro: compiladores%VSRegistryRoot%\Debugger\CodeView % CodeViewLanguageCode%:% CompilerName% e definir o VendorID/LanguageID.

(Herdado de DkmInstructionSymbol)
GetCompilerId(DkmWorkList, DkmInspectionSession, DkmCompletionRoutine<DkmGetCompilerIdAsyncResult>)

Retorna a ID do compilador (LanguageID/VendorID) de um determinado símbolo.

Para o leitor do Microsoft PDB, se o PDB foi criado por um compilador que usou ISymUnmanagedWriter, o leitor de PDB poderá determinar o DkmCompilerId correto do par LanguageID/VendorID passado de ISymUnmanagedWriter. DefineDocument.

Se o PDB foi criado por um compilador que não usou ISymUnmanagedWriter, o leitor de PDB pode conseguir obter o DkmCompilerId dos registros S_COMPILE * PDB. Para que isso funcione, o compilador deve primeiro emitir o registro S_COMPILE * para cada compiland. O compilador precisa ter a certeza de preencher corretamente o valor de enumeração de idioma e a cadeia de caracteres do compilador. O compilador deve garantir que a cadeia de caracteres do compilador seja suficientemente específica para ser usada para selecionar um avaliador de expressão; é recomendável incluir um nome de empresa. Depois de emitir o par de enumeração/nome, a configuração para o avaliador de expressão deve registrar esse par com o depurador. Para fazer isso, o avaliador de expressão deve definir essa chave do registro: compiladores%VSRegistryRoot%\Debugger\CodeView % CodeViewLanguageCode%:% CompilerName% e definir o VendorID/LanguageID.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará assim que o item de trabalho tiver sido anexado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: a API deve ser chamada de um componente IDE (nível de componente > 100.000).

Essa API foi introduzida no Visual Studio 16 RTM (DkmApiVersion. VS16RTMPreview).

(Herdado de DkmInstructionSymbol)
GetCurrentStatementRange()

Esse método retorna o intervalo de deslocamento de IL que contém o deslocamento de IL atual conforme especificado no endereço de instrução.

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

(Herdado de DkmInstructionSymbol)
GetDisassemblyLabel(DkmInspectionSession)

Retorne o nome do símbolo como ele deve aparecer na janela de desmontagem. Para o código do Microsoft C++, isso se baseia no nome do símbolo público.

Restrição de local: a API deve ser chamada de um componente IDE (nível de componente > 100.000).

(Herdado de DkmInstructionSymbol)
GetEmbeddedDocument()

Retorna o documento inserido que contém este símbolo. Retorna S_FALSE se o documento inserido não existir.

Restrição de local: a API deve ser chamada de um componente IDE (nível de componente > 100.000).

Essa API foi introduzida no Visual Studio 15 atualização 5 (DkmApiVersion. VS15Update5).

(Herdado de DkmInstructionSymbol)
GetGPUInstructionMetadataCallback(DkmInstructionAddress, DkmInstructionSymbol)

Esse método retorna informações de endereço para o monitor de depuração de GPU.

(Herdado de DkmInstructionSymbol)
GetInlineFramesCount(DkmBasicSymbolInfoRequestFlags)

Retorna o número de quadros embutidos no símbolo de instrução fornecido.

Restrição de local: a API deve ser chamada de um componente IDE (nível de componente > 100.000).

Essa API foi introduzida no Visual Studio 16 RTM (DkmApiVersion. VS16RTMPreview).

(Herdado de DkmInstructionSymbol)
GetInlineFramesCount(DkmWorkList, DkmBasicSymbolInfoRequestFlags, DkmCompletionRoutine<DkmGetInlineFramesCountAsyncResult>)

Retorna o número de quadros embutidos no símbolo de instrução fornecido.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará assim que o item de trabalho tiver sido anexado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: a API deve ser chamada de um componente IDE (nível de componente > 100.000).

Essa API foi introduzida no Visual Studio 16 RTM (DkmApiVersion. VS16RTMPreview).

(Herdado de DkmInstructionSymbol)
GetInlineSourcePosition(DkmStackWalkFrame, Boolean)

Retorna a posição do arquivo de origem (ex: example.cs, linha 12) desse símbolo de instrução no número de quadro embutido especificado. Se esse símbolo de instrução não estiver associado a um arquivo de origem, nulo será retornado (S_FALSE código de retorno em nativo).

Restrição de local: a API deve ser chamada de um componente IDE (nível de componente > 100.000).

Essa API foi introduzida no Visual Studio 15 RTM (DkmApiVersion. VS15RTM).

(Herdado de DkmInstructionSymbol)
GetInlineSourcePosition(DkmWorkList, DkmStackWalkFrame, DkmCompletionRoutine<DkmGetInlineSourcePositionAsyncResult>)

Retorna a posição do arquivo de origem (ex: example.cs, linha 12) desse símbolo de instrução no número de quadro embutido especificado. Se esse símbolo de instrução não estiver associado a um arquivo de origem, nulo será retornado (S_FALSE código de retorno em nativo).

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará assim que o item de trabalho tiver sido anexado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: a API deve ser chamada de um componente IDE (nível de componente > 100.000).

Essa API foi introduzida no Visual Studio 15 RTM (DkmApiVersion. VS15RTM).

(Herdado de DkmInstructionSymbol)
GetNextSteppingAction(DkmScriptInstructionSymbol, Boolean)

Chame novamente implementado pelo provedor de símbolos de script para informar ao monitor de depuração de script o que fazer em seguida ao fazer a depuração.

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

GetNoSourceRanges()

Consulta o provedor de símbolos para determinar os intervalos de instruções que não correspondem a nenhuma instrução de origem do usuário e são usados pelo monitor de depuração de base para sempre percorrer durante a etapa.

(Herdado de DkmInstructionSymbol)
GetSourcePosition(DkmSourcePositionFlags, DkmInspectionSession, Boolean)

Retorna a posição do arquivo de origem (ex: example.cs, linha 12) deste símbolo de instrução. Se esse símbolo de instrução não estiver associado a um arquivo de origem, nulo será retornado (S_FALSE código de retorno em nativo).

Restrição de local: a API deve ser chamada de um componente IDE (nível de componente > 100.000).

(Herdado de DkmInstructionSymbol)
GetSourcePosition(DkmWorkList, DkmSourcePositionFlags, DkmInspectionSession, DkmCompletionRoutine<DkmGetSourcePositionAsyncResult>)

Retorna a posição do arquivo de origem (ex: example.cs, linha 12) deste símbolo de instrução. Se esse símbolo de instrução não estiver associado a um arquivo de origem, nulo será retornado (S_FALSE código de retorno em nativo).

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará assim que o item de trabalho tiver sido anexado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: a API deve ser chamada de um componente IDE (nível de componente > 100.000).

(Herdado de DkmInstructionSymbol)
GetSourcePositionCallback(DkmSourcePositionFlags, DkmInspectionSession, Boolean)

Retorna a posição do arquivo de origem (ex: example.cs, linha 12) deste símbolo de instrução. Se esse símbolo de instrução não estiver associado a um arquivo de origem, nulo será retornado (S_FALSE código de retorno em nativo).

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

(Herdado de DkmInstructionSymbol)
GetSourcePositionCallback(DkmWorkList, DkmSourcePositionFlags, DkmInspectionSession, DkmCompletionRoutine<DkmGetSourcePositionCallbackAsyncResult>)

Retorna a posição do arquivo de origem (ex: example.cs, linha 12) deste símbolo de instrução. Se esse símbolo de instrução não estiver associado a um arquivo de origem, nulo será retornado (S_FALSE código de retorno em nativo).

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará assim que o item de trabalho tiver sido anexado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

(Herdado de DkmInstructionSymbol)
GetSteppingRanges(DkmSteppingRangeBoundary, Boolean)

Consulta o provedor de símbolos para determinar os intervalos de instruções que o monitor de depuração base deve percorrer para implementar uma etapa.

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

(Herdado de DkmInstructionSymbol)
GetUserCodeSourcePositionCallback(DkmInspectionSession)

Retorna a posição do arquivo de origem (ex: example.cs, linha 12) deste símbolo de instrução. Se esse símbolo de instrução não estiver associado a um arquivo de origem ou não estiver no código do usuário, NULL será retornado (E_INSTRUCTION_NO_SOURCE código de retorno).

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

(Herdado de DkmInstructionSymbol)
GetUserCodeSourcePositionCallback(DkmWorkList, DkmInspectionSession, DkmCompletionRoutine<DkmGetUserCodeSourcePositionCallbackAsyncResult>)

Retorna a posição do arquivo de origem (ex: example.cs, linha 12) deste símbolo de instrução. Se esse símbolo de instrução não estiver associado a um arquivo de origem ou não estiver no código do usuário, NULL será retornado (E_INSTRUCTION_NO_SOURCE código de retorno).

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará assim que o item de trabalho tiver sido anexado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

(Herdado de DkmInstructionSymbol)
HasEmbeddedDocument()

Testa se o símbolo fornecido tem um documento inserido. Os documentos inseridos são quando um arquivo de origem (ex: main.cs) é inserido dentro do arquivo de símbolo (ex: example. pdb).

Restrição de local: a API deve ser chamada de um componente IDE (nível de componente > 100.000).

Essa API foi introduzida no Visual Studio 15 atualização 8 (DkmApiVersion. VS15Update8).

(Herdado de DkmInstructionSymbol)
HasLineInfo()

Consulta o provedor de símbolos para determinar se há informações de linha. Usado pelo monitor de depuração para decidir se o local pode ser considerado código de usuário.

Restrição de local: para símbolos comuns, pode ser chamada de qualquer componente. Para símbolos dinâmicos, só pode ser chamado no lado do servidor.

(Herdado de DkmInstructionSymbol)
HasLineInfo(DkmWorkList, DkmCompletionRoutine<DkmHasLineInfoAsyncResult>)

Consulta o provedor de símbolos para determinar se há informações de linha. Usado pelo monitor de depuração para decidir se o local pode ser considerado código de usuário.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará assim que o item de trabalho tiver sido anexado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: para símbolos comuns, pode ser chamada de qualquer componente. Para símbolos dinâmicos, só pode ser chamado no lado do servidor.

(Herdado de DkmInstructionSymbol)
IsHiddenCode(DkmWorkList, DkmInspectionSession, DkmInstructionAddress, DkmCompletionRoutine<DkmIsHiddenCodeAsyncResult>)

Retorna se este símbolo de instrução está em código oculto. Por exemplo, em código gerenciado, o número de linha 0xfeefee marca uma linha de origem como oculta.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará assim que o item de trabalho tiver sido anexado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: a API deve ser chamada de um componente IDE (nível de componente > 100.000).

(Herdado de DkmInstructionSymbol)

Aplica-se a