SecurityContext 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.
Encapsula e propaga todos os dados relacionados à segurança para contextos de execução transferidos entre threads. Essa classe não pode ser herdada.
public ref class SecurityContext sealed
public ref class SecurityContext sealed : IDisposable
public sealed class SecurityContext
public sealed class SecurityContext : IDisposable
type SecurityContext = class
type SecurityContext = class
interface IDisposable
Public NotInheritable Class SecurityContext
Public NotInheritable Class SecurityContext
Implements IDisposable
- Herança
-
SecurityContext
- Implementações
Comentários
Caution
O CAS (Code Access Security) foi preterido em todas as versões do .NET Framework e do .NET. As versões recentes do .NET não honram as anotações CAS e geram erros se as APIs relacionadas ao CAS forem usadas. Os desenvolvedores devem buscar meios alternativos para realizar tarefas de segurança.
Note
Esse tipo é marcado como obsoleto a partir do .NET 6.
Um SecurityContext objeto captura todas as informações relacionadas à segurança de um thread lógico, incluindo as informações contidas nos objetos WindowsIdentity e CompressedStack. Essa configuração permite que a identidade do Windows e os elementos de segurança na pilha sejam propagados automaticamente quando o SecurityContext é copiado e transferido através de threads assíncronas.
Note
O CLR (Common Language Runtime) está ciente das operações de representação executadas usando apenas o código gerenciado, não a representação executada fora do código gerenciado, como por meio da invocação de plataforma para código não gerenciado ou por meio de chamadas diretas para funções Win32. Somente objetos gerenciados WindowsIdentity podem fluir entre pontos assíncronos, a menos que o alwaysFlowImpersonationPolicy elemento tenha sido definido true como (<alwaysFlowImpersonationPolicy enabled="true"/>). Definir o elemento alwaysFlowImpersonationPolicy como true especifica que a identidade Windows sempre flui entre pontos assíncronos, independentemente de como a representação foi executada. Para obter mais informações sobre como fluir representação não gerenciada em pontos assíncronos, consulte <o elemento alwaysFlowImpersonationPolicy>.
Faz SecurityContext parte do maior ExecutionContext e flui ou migra quando o ExecutionContext fluxo ou migra.
Importante
Esse tipo implementa a IDisposable interface. Quando terminar de usar esse tipo ou objeto, você deverá descartá-lo de forma direta ou indireta. Para descartar o tipo diretamente, chame o método Dispose dele em um bloco try/catch. Para descartá-lo indiretamente, use um constructo de linguagem como using (em C#) ou Using (no Visual Basic). Para obter mais informações, consulte a seção "Usando um objeto que implementa idisposable" no tópico da IDisposable interface.
Métodos
| Nome | Description |
|---|---|
| Capture() |
Captura o contexto de segurança do thread atual. |
| CreateCopy() |
Cria uma cópia do contexto de segurança atual. |
| Dispose() |
Libera todos os recursos usados pela instância atual da SecurityContext classe. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como a função hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| IsFlowSuppressed() |
Determina se o fluxo do contexto de segurança foi suprimido. |
| IsWindowsIdentityFlowSuppressed() |
Determina se o fluxo da parte de identidade Windows do contexto de segurança atual foi suprimido. |
| MemberwiseClone() |
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| RestoreFlow() |
Restaura o fluxo do contexto de segurança em threads assíncronos. |
| Run(SecurityContext, ContextCallback, Object) |
Executa o método especificado no contexto de segurança especificado no thread atual. |
| SuppressFlow() |
Suprime o fluxo do contexto de segurança em threads assíncronos. |
| SuppressFlowWindowsIdentity() |
Suprime o fluxo da parte de identidade Windows do contexto de segurança atual em threads assíncronos. |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |