HttpListenerContext.User 屬性

定義

取得用來取得用戶端識別、驗證資訊和安全性角色之物件,由這個 HttpListenerContext 物件表示用戶端的要求。

C#
public System.Security.Principal.IPrincipal? User { get; }
C#
public System.Security.Principal.IPrincipal User { get; }

屬性值

描述用戶端的 IPrincipal 物件,如果提供這個 HttpListenerHttpListenerContext 不需要驗證,則為 null

範例

下列程式代碼範例示範如何存取用戶端的身分識別和驗證資訊,並在回應中將其傳回至用戶端。

C#
public static string ClientInformation(HttpListenerContext context)
{
    System.Security.Principal.IPrincipal user = context.User;
    System.Security.Principal.IIdentity id = user.Identity;
    if (id == null)
    {
        return "Client authentication is not enabled for this Web server.";
    }

    string display;
    if (id.IsAuthenticated)
    {
        display = String.Format("{0} was authenticated using {1}", id.Name,
            id.AuthenticationType);
    }
    else
    {
       display = String.Format("{0} was not authenticated", id.Name);
    }
    return display;
}

備註

HttpListener表示它需要使用 屬性或藉由使用 AuthenticationSchemeSelectorDelegate 屬性指定AuthenticationSchemeSelector委派來進行驗證AuthenticationSchemes

若要判斷用戶端的登入名稱和驗證資訊,請檢查 IPrincipal.Identity 此屬性所傳回之 物件中的 屬性。

適用於

產品 版本
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1