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.
Cuidado
Code Access Security is not supported or honored by the runtime.
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 : IDisposable
public ref class SecurityContext sealed
public sealed class SecurityContext : IDisposable
[System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public sealed class SecurityContext : IDisposable
public sealed class SecurityContext
type SecurityContext = class
interface IDisposable
[<System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type SecurityContext = class
interface IDisposable
type SecurityContext = class
Public NotInheritable Class SecurityContext
Implements IDisposable
Public NotInheritable Class SecurityContext
- Herança
-
SecurityContext
- Atributos
- Implementações
Comentários
Observação
Esse tipo é marcado como obsoleto começando no .NET 6.
Um SecurityContext objeto captura todas as informações relacionadas à segurança de um thread lógico, incluindo as informações contidas no objeto e CompressedStack nos WindowsIdentity objetos. Essa configuração permite que a identidade Windows e os elementos de segurança na pilha sejam propagados automaticamente quando ele SecurityContext for copiado e transferido entre threads assíncronos.
Observação
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 como true
(<alwaysFlowImpersonationPolicy enabled="true"/>
). Definir o alwaysFlowImpersonationPolicy
elemento para true
especificar 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 os ExecutionContext fluxos ou migrações.
Importante
Esse tipo implementa a interface IDisposable. Quando você terminar de usar o tipo, deverá descartá-lo direta ou indiretamente. 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
(em Visual Basic). Saiba mais na seção "Como usar um objeto que implementa IDisposable" no tópico da interface IDisposable.
Métodos
Capture() |
Captura o contexto de segurança para o thread atual. |
CreateCopy() |
Cria uma cópia do contexto de segurança atual. |
Dispose() |
Libera todos os recursos usados pela instância atual da classe SecurityContext. |
Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
GetHashCode() |
Serve como a função de hash padrão. (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 porção de identidade de Windows do contexto de segurança atual foi suprimido. |
MemberwiseClone() |
Cria uma cópia superficial do Object atual. (Herdado de Object) |
RestoreFlow() |
Restaura o fluxo do contexto de segurança entre 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 entre threads assíncronos. |
SuppressFlowWindowsIdentity() |
Suprime o fluxo da porção de identidade de Windows do contexto de segurança atual entre threads assíncronos. |
ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object) |