AppDomain.SetPrincipalPolicy(PrincipalPolicy) 方法

定義

命名空間:

System

組件:

System.Runtime.dll

來源:

AppDomain.cs

如果執行緒在這個應用程式定義域執行時嘗試繫結至主體，則指定主體和識別 (Identity) 物件應該如何附加至執行緒。

public:
 void SetPrincipalPolicy(System::Security::Principal::PrincipalPolicy policy);

public void SetPrincipalPolicy (System.Security.Principal.PrincipalPolicy policy);

member this.SetPrincipalPolicy : System.Security.Principal.PrincipalPolicy -> unit

Public Sub SetPrincipalPolicy (policy As PrincipalPolicy)

參數

policy

PrincipalPolicy

其中一個 PrincipalPolicy 值，指定要附加至執行緒之主體物件的類型。

例外狀況

AppDomainUnloadedException

嘗試對卸載的應用程式定義域執行作業。

範例

下列範例顯示使用 SetPrincipalPolicy 方法變更應用程式域主體原則之 執行緒的效果。 它也會顯示使用 SetThreadPrincipal 方法來變更可用於附加至應用程式域中線程的主體的效果。

using namespace System;
using namespace System::Security::Principal;
using namespace System::Threading;
ref class ADPrincipal
{
public:
   static void PrintPrincipalInformation()
   {
      IPrincipal^ curPrincipal = Thread::CurrentPrincipal;
      if ( curPrincipal != nullptr )
      {
         Console::WriteLine( "Type: {0}", curPrincipal->GetType()->Name );
         Console::WriteLine( "Name: {0}", curPrincipal->Identity->Name );
         Console::WriteLine( "Authenticated: {0}", curPrincipal->Identity->IsAuthenticated );
         Console::WriteLine();
      }
   }

};

int main()
{
   
   // Create a new thread with a generic principal.
   Thread^ t = gcnew Thread( gcnew ThreadStart( ADPrincipal::PrintPrincipalInformation ) );
   t->Start();
   t->Join();
   
   // Set the principal policy to WindowsPrincipal.
   AppDomain^ currentDomain = AppDomain::CurrentDomain;
   currentDomain->SetPrincipalPolicy( PrincipalPolicy::WindowsPrincipal );
   
   // The new thread will have a Windows principal representing the
   // current user.
   t = gcnew Thread( gcnew ThreadStart( ADPrincipal::PrintPrincipalInformation ) );
   t->Start();
   t->Join();
   
   // Create a principal to use for new threads.
   IIdentity^ identity = gcnew GenericIdentity( "NewUser" );
   IPrincipal^ principal = gcnew GenericPrincipal( identity,nullptr );
   currentDomain->SetThreadPrincipal( principal );
   
   // Create a new thread with the principal created above.
   t = gcnew Thread( gcnew ThreadStart( ADPrincipal::PrintPrincipalInformation ) );
   t->Start();
   t->Join();
   
   // Wait for user input before terminating.
   Console::ReadLine();
}

using System;
using System.Security.Principal;
using System.Threading;

class ADPrincipal
{
    static void Main(string[] args)
    {
        // Create a new thread with a generic principal.
        Thread t = new Thread(new ThreadStart(PrintPrincipalInformation));
        t.Start();
        t.Join();

        // Set the principal policy to WindowsPrincipal.
        AppDomain currentDomain = AppDomain.CurrentDomain;
        currentDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal);
            
        // The new thread will have a Windows principal representing the
        // current user.
        t = new Thread(new ThreadStart(PrintPrincipalInformation));
        t.Start();
        t.Join();

        // Create a principal to use for new threads.
        IIdentity identity = new GenericIdentity("NewUser");
        IPrincipal principal = new GenericPrincipal(identity, null);
        currentDomain.SetThreadPrincipal(principal);
            
        // Create a new thread with the principal created above.
        t = new Thread(new ThreadStart(PrintPrincipalInformation));
        t.Start();
        t.Join();
        
        // Wait for user input before terminating.
        Console.ReadLine();
    }

    static void PrintPrincipalInformation()
    {
        IPrincipal curPrincipal = Thread.CurrentPrincipal;
        if(curPrincipal != null)
        {
            Console.WriteLine("Type: " + curPrincipal.GetType().Name);
            Console.WriteLine("Name: " + curPrincipal.Identity.Name);
            Console.WriteLine("Authenticated: " +
                curPrincipal.Identity.IsAuthenticated);
            Console.WriteLine();
        }
    }
}

open System
open System.Security.Principal
open System.Threading

let printPrincipalInformation () =
    let curPrincipal = Thread.CurrentPrincipal
    if curPrincipal <> null then
        printfn $"Type: {curPrincipal.GetType().Name}"
        printfn $"Name: {curPrincipal.Identity.Name}"
        printfn $"Authenticated: {curPrincipal.Identity.IsAuthenticated}\n"

[<EntryPoint>]
let main _ =
    // Create a new thread with a generic principal.
    let t = Thread(ThreadStart printPrincipalInformation)
    t.Start()
    t.Join()

    // Set the principal policy to WindowsPrincipal.
    let currentDomain = AppDomain.CurrentDomain
    currentDomain.SetPrincipalPolicy PrincipalPolicy.WindowsPrincipal
        
    // The new thread will have a Windows principal representing the
    // current user.
    let t = Thread(ThreadStart printPrincipalInformation)
    t.Start()
    t.Join()

    // Create a principal to use for new threads.
    let identity = GenericIdentity "NewUser"
    let principal = GenericPrincipal(identity, null)
    currentDomain.SetThreadPrincipal principal
        
    // Create a new thread with the principal created above.
    let t = Thread(ThreadStart printPrincipalInformation)
    t.Start()
    t.Join()

    // Wait for user input before terminating.
    Console.ReadLine() |> ignore
    0

Imports System.Security.Principal
Imports System.Threading

Class ADPrincipal
    Overloads Shared Sub Main(ByVal args() As String)
        ' Create a new thread with a generic principal.
        Dim t As New Thread(New ThreadStart(AddressOf PrintPrincipalInformation))
        t.Start()
        t.Join()

        ' Set the principal policy to WindowsPrincipal.
        Dim currentDomain As AppDomain = AppDomain.CurrentDomain
        currentDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal)

        ' The new thread will have a Windows principal representing the
        ' current user.
        t = New Thread(New ThreadStart(AddressOf PrintPrincipalInformation))
        t.Start()
        t.Join()

        ' Create a principal to use for new threads.
        Dim identity = New GenericIdentity("NewUser")
        Dim principal = New GenericPrincipal(identity, Nothing)
        currentDomain.SetThreadPrincipal(principal)

        ' Create a new thread with the principal created above.
        t = New Thread(New ThreadStart(AddressOf PrintPrincipalInformation))
        t.Start()
        t.Join()

        ' Wait for user input before terminating.
        Console.ReadLine()
    End Sub


    Shared Sub PrintPrincipalInformation()
        Dim curPrincipal As IPrincipal = Thread.CurrentPrincipal
        If Not (curPrincipal Is Nothing) Then
            Console.WriteLine("Type: " & CType(curPrincipal, Object).GetType().Name)
            Console.WriteLine("Name: " & curPrincipal.Identity.Name)
            Console.WriteLine("Authenticated: " & curPrincipal.Identity.IsAuthenticated)
            Console.WriteLine()

        End If
    End Sub
End Class

備註

只有在您使用 Thread.CurrentPrincipal 屬性之前設定此值才會生效。 例如，如果您將 設定 Thread.CurrentPrincipal 為指定的主體 (，則泛型主體) ，然後使用 SetPrincipalPolicy 方法將 設定 PrincipalPolicyWindowsPrincipal 為 ，則目前的主體會維持泛型主體。