DkmClrValue Classe

Referência

Definição

Namespace:: Microsoft.VisualStudio.Debugger.Evaluation.ClrCompilation

Assembly:: Microsoft.VisualStudio.Debugger.Engine.dll

Pacote:: Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

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.

Um valor resultante de uma consulta de inspeção CLR. Esses valores são usados por um Formatador de Resultados para gerar DkmEvaluationResults.

Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

public ref class DkmClrValue : Microsoft::VisualStudio::Debugger::DkmDataContainer, IDisposable

[System.Runtime.InteropServices.Guid("8186570c-2529-edb5-ef0b-4e485f902e89")]
public class DkmClrValue : Microsoft.VisualStudio.Debugger.DkmDataContainer, IDisposable

[<System.Runtime.InteropServices.Guid("8186570c-2529-edb5-ef0b-4e485f902e89")>]
type DkmClrValue = class
    inherit DkmDataContainer
    interface IDisposable

Public Class DkmClrValue
Inherits DkmDataContainer
Implements IDisposable

Herança: MarshalByRefObject

DkmDataContainer
DkmClrValue

Herança: Object

DkmDataContainer
DkmClrValue

Atributos: GuidAttribute

Implementações: IDisposable

Propriedades

Access	O nível de controle de acesso (público, privado etc.) do resultado da avaliação. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Address	[Opcional] Se o resultado for um endereço (ou seja, o sinalizador de endereço está definido em Sinalizadores), especificará o local do valor de suporte. Isso é usado quando o resultado da avaliação é usado como a entrada para a janela de memória ou a janela de desmontagem. Se for um endereço de instrução, ele deverá ter o endereço CPUInstruction definido. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Alias	[Opcional] O alias desse valor. Se o objeto não tiver sido atribuído a um alias, esse valor será nulo. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
ArrayDimensions	[Opcional] As dimensões da matriz. Esse valor só será válido se esse DkmClrValue for um valor de matriz. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
ArrayLowerBounds	[Opcional] Os limites inferiores da matriz. Esse valor só será válido se esse DkmClrValue for um valor de matriz. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Category	A categoria (por exemplo: Dados, Método etc.) desse resultado de avaliação. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
EvalFlags	Sinalizadores que descrevem o resultado da avaliação que criou esse DkmClrValue. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
HostObjectValue	[Opcional] O valor desse nó se dkmClrValue for um valor que pode ser representado no processo do depurador. Se dkmClrValue for de um tipo complexo, esse valor será nulo. Observação para uso em código nativo quando o valor subjacente é uma cadeia de caracteres: se você estiver consumindo esse campo em código nativo, a estrutura VARIANT poderá ser BSTR ou um IUnknown que deve ser consultado para IDkmManagedStringRef. Se você estiver criando esse campo em código nativo, use uma VARIANT de um BSTR. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
InspectionSession	A InspectionSession permite que os vários componentes que examinam dados no processo de destino armazenem dados privados com o mesmo tempo de vida. As sessões de inspeção são fechadas quando o usuário tenta continuar o processo. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
IsNull	True se o valor for nulo (ou se não houver nenhum valor). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
IsUnloaded	Retornará true se um evento 'descarregado' tiver sido gerado para este objeto (exemplo: DkmThread::Unload for chamado) ou se o objeto tiver sido fechado. Observe que o cuidado deve ser usado ao verificar esse status, pois, sem sincronização, o status retornado pode não ser mais preciso após a leitura. (Herdado de DkmDataContainer)
Language	O idioma que está sendo usado. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
NativeComPointer	Um ponteiro de interface para o objeto COM nativo se esse valor for um RCW. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
StackFrame	O quadro de pilha usado como o quadro de inspeção da expressão interpretada. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
StorageType	O tipo de armazenamento (por exemplo: estático) do resultado da avaliação. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Type	[Opcional] O tipo de runtime desse nó. System.String, por exemplo. Esse valor é nulo quando o valor é inválido E o tipo não pode ser determinado. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
TypeModifierFlags	Sinalizadores modificador de tipo (ex: const) do resultado da avaliação. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
UniqueId	Guid que identifica exclusivamente esse resultado interpretado. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
ValueFlags	Sinalizadores que descrevem esse valor. Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

Métodos

Close()	Fecha o valor clr para liberar recursos associados a ele. Esse método deve ser invocado pelo objeto que solicitou a consulta de avaliação (por exemplo: chamada DkmCompiledClrInspectionQuery.Execute). Os objetos DkmClrValue são fechados automaticamente quando o objeto DkmInspectionSession associado é fechado. Restrição de local: a API deve ser chamada de um componente monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Create(DkmInspectionSession, DkmLanguage, DkmClrType, DkmEvaluationResultCategory, DkmEvaluationResultAccessType, DkmEvaluationResultStorageType, DkmEvaluationResultTypeModifierFlags, Boolean, Object, DkmStackWalkFrame, DkmEvaluationResultFlags, DkmClrValueFlags, UInt64, DkmDataAddress, String, ReadOnlyCollection<Int32>, ReadOnlyCollection<Int32>, DkmDataItem)	Create uma nova instância de objeto DkmClrValue. Restrição de local: a API deve ser chamada de um componente monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
Dereference(DkmInspectionContext)	Desreferenciar esse valor de ponteiro para obter o valor subjacente. Esse método só poderá ser usado se o DkmClrValue representar um valor Pointer. Restrição de local: a API deve ser chamada de um componente monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
EvaluateDebuggerDisplayString(DkmWorkList, DkmInspectionContext, DkmClrType, String, DkmCompletionRoutine<DkmEvaluateDebuggerDisplayStringAsyncResult>)	Obtém a cadeia de caracteres a ser exibida na interface do usuário do depurador para um valor CLR, considerando uma cadeia de caracteres de atributo DebuggerDisplay. Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. 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 monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
EvaluateToString(DkmInspectionContext)	Execute a substituição ToString em um objeto representado pelo DkmClrValue fornecido. Se o valor for do tipo objeto ou não substituir ToString, esse método retornará nulo. Esse método requer que a avaliação da função seja habilitada. Se a avaliação da função estiver desabilitada pelo usuário ou por qualquer outro motivo, esse método retornará nulo. Esse método também retornará nulo se a avaliação da função falhar por qualquer motivo. Restrição de local: a API deve ser chamada de um componente monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetArrayElement(Int32[], DkmInspectionContext)	Obter um elemento de matriz. Esse método só poderá ser usado se o DkmClrValue representar um valor de matriz. Restrição de local: a API deve ser chamada de um componente monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetDataItem<T>()	Obtém a instância de 'T' que foi adicionada a essa instância de contêiner. Se esse contêiner não contiver um 'T', essa função retornará nulo. (Herdado de DkmDataContainer)
GetEditableValueString(DkmInspectionContext, DkmClrCustomTypeInfo)	Obtenha a cadeia de caracteres de valor editável a ser exibida na interface do usuário para o DkmClrValue fornecido. Restrição de local: a API deve ser chamada de um componente monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetMemberValue(String, Int32, String, DkmInspectionContext)	Obtém o valor de um campo ou propriedade como um DkmClrValue. Restrição de local: a API deve ser chamada de um componente monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetResult(DkmWorkList, DkmClrType, DkmClrCustomTypeInfo, DkmInspectionContext, ReadOnlyCollection<String>, String, String, DkmCompletionRoutine<DkmEvaluationAsyncResult>)	Formate um DkmClrValue e retorne um DkmEvaluationResult. Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. 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 monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetUnderlyingString(DkmInspectionContext)	Obtenha a representação de cadeia de caracteres subjacente do valor. Restrição de local: a API deve ser chamada de um componente monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
GetValueString(DkmClrCustomTypeInfo, DkmInspectionContext, ReadOnlyCollection<String>)	Obtenha a cadeia de caracteres de valor a ser exibida na interface do usuário para o DkmClrValue fornecido. Restrição de local: a API deve ser chamada de um componente monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 15 RTM (DkmApiVersion.VS15RTM).
GetValueString(DkmInspectionContext, ReadOnlyCollection<String>)	Obtenha a cadeia de caracteres de valor a ser exibida na interface do usuário para o DkmClrValue fornecido. Restrição de local: a API deve ser chamada de um componente monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
HasUnderlyingString(DkmInspectionContext)	Determina se esse valor tem uma representação de cadeia de caracteres subjacente. Se esse método retornar true, o usuário poderá usar visualizadores de cadeia de caracteres para exibir esse valor no depurador. GetUnderlyingString deve retornar a representação de cadeia de caracteres subjacente. Restrição de local: a API deve ser chamada de um componente Monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
InstantiateDynamicViewProxy(DkmInspectionContext)	Instancie a classe proxy a ser usada para iterar os membros dinâmicos de um valor IDynamicMetaObjectProvider. Restrição de local: a API deve ser chamada de um componente Monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
InstantiateProxyType(DkmInspectionContext, DkmClrType)	Instancie uma classe proxy para um DkmClrValue com um atributo DebuggerTypeProxy associado. Restrição de local: a API deve ser chamada de um componente Monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
InstantiateResultsViewProxy(DkmInspectionContext, DkmClrType)	Instancie a classe proxy a ser usada para iterar um valor IEnumerable. Restrição de local: a API deve ser chamada de um componente Monitor (nível < de componente 100.000). Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
RemoveDataItem<T>()	Remova a instância de 'T' desse contêiner. Geralmente, é desnecessário chamar esse método, pois um contêiner de dados será esvaziado automaticamente quando o objeto for fechado. (Herdado de DkmDataContainer)
SetDataItem<T>(DkmDataCreationDisposition, T)	Coloque um novo item no contêiner de dados. (Herdado de DkmDataContainer)

Implantações explícitas de interface

IDisposable.Dispose()

A ser adicionado.

Aplica-se a

Compartilhar via