DkmClrAppDomain 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.
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. |