DkmClrAppDomain Classe

Definição

DkmClrAppDomain representa um domínio de aplicativo CLR dentro de um processo que está sendo depurado.

public ref class DkmClrAppDomain : Microsoft::VisualStudio::Debugger::DkmDataContainer, IDisposable
[System.Runtime.InteropServices.Guid("337360db-44af-e459-1323-f16ddacf8b79")]
public class DkmClrAppDomain : Microsoft.VisualStudio.Debugger.DkmDataContainer, IDisposable
[<System.Runtime.InteropServices.Guid("337360db-44af-e459-1323-f16ddacf8b79")>]
type DkmClrAppDomain = class
    inherit DkmDataContainer
    interface IDisposable
Public Class DkmClrAppDomain
Inherits DkmDataContainer
Implements IDisposable
Herança
Atributos
Implementações

Propriedades

Id

ID do domínio do aplicativo CLR subjacente. Durante a execução, isso identifica exclusivamente o domínio do aplicativo em um determinado DkmRuntimeInstance.

IsUnloaded

Retornará true se um evento ' Unloaded ' tiver sido gerado para este objeto (exemplo: DkmThread:: Unload é chamado) ou se o objeto foi fechado. Observe que o cuidado deve ser usado ao verificar esse status como, sem sincronização, o status retornado pode não ser mais preciso na instrução após sua leitura.

(Herdado de DkmDataContainer)
Name

Nome do AppDomain.

Process

DkmProcess representa um processo de destino que está sendo depurado. O depurador debugs processa, portanto, essa é a unidade básica de depuração. Um DkmProcess pode representar um processo do sistema ou um processo virtual, como minidespejos.

RuntimeInstance

Representa uma instância CLR em execução em um processo de destino.

UniqueId

O GUID que identifica exclusivamente este objeto de domínio de aplicativo.

Métodos

Close()

Fecha uma instância do objeto DkmClrAppDomain. Isso liberará todos os recursos associados a esse objeto em todos os componentes. Isso inclui recursos no computador ou limites de Marshalling gerenciado/nativo.

Os objetos DkmClrAppDomain são fechados automaticamente quando seu objeto DkmClrRuntimeInstance associado é fechado.

Esse método só pode ser chamado pelo componente que criou o objeto.

Create(Int32, DkmClrRuntimeInstance, String, DkmDataItem)

Esse método é chamado pelo monitor de depuração gerenciada para criar um objeto DkmClrAppDomain. Ele é chamado no thread de evento em resposta ao processo de destino que cria um AppDomain. O chamador é responsável por fechar o objeto criado depois que eles são concluídos.

FindAllClrModuleInstances(Guid)

Localiza todos os elementos DkmClrModuleInstance [] dentro deste DkmClrAppDomain. Se nenhum elemento com a chave de entrada fornecida estiver presente, FindAllClrModuleInstances falhará.

FindClrModuleInstance(Guid)

Encontre um elemento DkmClrModuleInstance dentro deste DkmClrAppDomain. Se nenhum elemento com a chave de entrada fornecida estiver presente, FindClrModuleInstance falhará.

GetClrModuleInstances()

GetClrModuleInstances enumera os elementos DkmClrModuleInstance desse objeto DkmClrAppDomain.

GetCorObject()

Fornece acesso direto ao objeto ICorDebugAppDomain, que avaliadores de expressão ou outros componentes podem usar para inspecionar o domínio de aplicativo.

A interface retornada só pode ser usada para inspecionar o processo de destino e nunca deve ser usada para controlar a execução (sem depuração, sem pontos de interrupção, sem continuação, etc). Isso não é suportado e resultará em um comportamento indefinido.

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

GetDataItem<T>()

Obtém a instância de ' T' que foi adicionada a esta instância de contêiner. Se esse contêiner não contiver um ' T', essa função retornará NULL.

(Herdado de DkmDataContainer)
GetManagedRuntimeModule()

Obtenha a instância do módulo de tempo de execução gerenciado. (mscorlib.dll).

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

Essa API foi introduzida no Visual Studio 12 RTM (DkmApiVersion. VS12RTM).

GetMetaDataBytes(String, Guid)

Usado internamente para dar suporte a DkmClrAppDomain. GetMetaDataBytesPtr. Por motivos de desempenho, use GetMetaDataBytesPtr em vez desse método.

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 14 RTM (DkmApiVersion. VS14RTM).

GetMetaDataBytesPtr(String, UInt32)

Obtenha um ponteiro para os bytes de metadados brutos do módulo de manifesto do assembly solicitado que não foi carregado no processo de depuração. Observação: esse valor de ponteiro se tornará inválido se/quando o módulo real for carregado no processo de depuração ou se o domínio do aplicativo for descarregado.

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

GetProperty(ICorDebugValue, String)

Avalia uma propriedade no determinado ICorDebugValue. O tipo do valor deve ser carregado pelo DkmClrAppDomain que este $Name $ está sendo chamado.

Restrição de local: deve estar no lado remoto porque estamos passando um ICorDebugHandleValue.

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

RaiseCreatedEvent()

Gerar um evento AppDomainCreated. Os componentes que implementam a interface do coletor de eventos receberão a notificação de eventos. O controle retornará assim que todos os componentes forem notificados.

Esse método só pode ser chamado pelo componente que criou o objeto.

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

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

RemoveDataItem<T>()

Remova a instância de ' T' deste contêiner. Normalmente, é desnecessário chamar esse método, pois um contêiner de dados será automaticamente esvaziado quando o objeto for fechado.

(Herdado de DkmDataContainer)
ResolveMvidByAssemblyName(String)

Resolva um assembly por nome e retorne o MVID de seu módulo de manifesto.

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 14 RTM (DkmApiVersion. VS14RTM).

SetDataItem<T>(DkmDataCreationDisposition, T)

Coloque um novo item no contêiner de dados.

(Herdado de DkmDataContainer)
Unload()

Marque o objeto Unload como descarregado e notifique os componentes que implementam a interface do coletor de eventos. O controle retornará assim que todos os componentes forem notificados.

Esse método só pode ser chamado pelo componente que criou o objeto.

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

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

Implantações explícitas de interface

IDisposable.Dispose()

A ser adicionado.

Aplica-se a