DkmScriptInstructionSymbol Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- 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) |