GenericIdentity Класс

Определение

Представляет универсального пользователя.Represents a generic user.

public ref class GenericIdentity : System::Security::Claims::ClaimsIdentity
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class GenericIdentity : System.Security.Claims.ClaimsIdentity
type GenericIdentity = class
    inherit ClaimsIdentity
Public Class GenericIdentity
Inherits ClaimsIdentity
Наследование
GenericIdentity
Производный
Атрибуты

Примеры

В следующем примере показано использование членов класса GenericIdentity.The following example shows the use of members of the GenericIdentity class.

using namespace System;
using namespace System::Security::Principal;
void ShowIdentityPreferences( GenericIdentity^ genericIdentity );
GenericIdentity^ GetGenericIdentity();

[STAThread]
int main()
{
   // Create a GenericIdentity object with no authentication type 
   // specified.
   GenericIdentity^ defaultIdentity = gcnew GenericIdentity( "DefaultUser" );

   // Retrieve a GenericIdentity created from current WindowsIdentity
   // values.
   GenericIdentity^ currentIdentity = GetGenericIdentity();
   ShowIdentityPreferences( gcnew GenericIdentity( "" ) );
   ShowIdentityPreferences( defaultIdentity );
   ShowIdentityPreferences( currentIdentity );
   Console::WriteLine( "The sample completed successfully; "
   "press Enter to continue." );
   Console::ReadLine();
}

// Print identity preferences to the console window.
void ShowIdentityPreferences( GenericIdentity^ genericIdentity )
{
   // Retrieve the name of the generic identity object.
   String^ identityName = genericIdentity->Name;

   // Retrieve the authentication type of the generic identity object.
   String^ identityAuthenticationType = genericIdentity->AuthenticationType;

   Console::WriteLine( "Name: {0}", identityName );
   Console::WriteLine( "Type: {0}", identityAuthenticationType );

   // Verify that the user's identity has been authenticated
   // (was created with a valid name).
   if ( genericIdentity->IsAuthenticated )
   {
      Console::WriteLine( "The user's identity has been authenticated." );
   }
   else
   {
      Console::WriteLine( "The user's identity has not been "
      "authenticated." );
   }

   Console::WriteLine( "~~~~~~~~~~~~~~~~~~~~~~~~~" );
}


// Create generic identity based on values from the current
// WindowsIdentity.
GenericIdentity^ GetGenericIdentity()
{
   // Get values from the current WindowsIdentity.
   WindowsIdentity^ windowsIdentity = WindowsIdentity::GetCurrent();

   // Construct a GenericIdentity object based on the current Windows
   // identity name and authentication type.
   String^ authenticationType = windowsIdentity->AuthenticationType;
   String^ userName = windowsIdentity->Name;
   GenericIdentity^ authenticatedGenericIdentity = gcnew GenericIdentity( userName,authenticationType );

   return authenticatedGenericIdentity;
}
using System;
using System.Security.Principal;

class GenericIdentityMembers
{
    [STAThread]
    static void Main(string[] args)
    {
        // Create a GenericIdentity object with no authentication type 
        // specified.
        GenericIdentity defaultIdentity = new GenericIdentity("DefaultUser");

        // Retrieve a GenericIdentity created from current WindowsIdentity
        // values.
        GenericIdentity currentIdentity = GetGenericIdentity();

        ShowIdentityPreferences(new GenericIdentity(""));
        ShowIdentityPreferences(defaultIdentity);
        ShowIdentityPreferences(currentIdentity);

        Console.WriteLine("The sample completed successfully; " +
            "press Enter to continue.");
        Console.ReadLine();
    }

    // Print identity preferences to the console window.
    private static void ShowIdentityPreferences(
        GenericIdentity genericIdentity)
    {
        // Retrieve the name of the generic identity object.
        string identityName = genericIdentity.Name;

        // Retrieve the authentication type of the generic identity object.
        string identityAuthenticationType = 
            genericIdentity.AuthenticationType;

        Console.WriteLine("Name: " + identityName);
        Console.WriteLine("Type: " + identityAuthenticationType);
        
        // Verify that the user's identity has been authenticated
        // (was created with a valid name).
        if (genericIdentity.IsAuthenticated)
        {
            Console.WriteLine("The user's identity has been authenticated.");
        }
        else
        {
            Console.WriteLine("The user's identity has not been " + 
                "authenticated.");
        }
        Console.WriteLine("~~~~~~~~~~~~~~~~~~~~~~~~~");
    }

    // Create generic identity based on values from the current
    // WindowsIdentity.
    private static GenericIdentity GetGenericIdentity()
    {
        // Get values from the current WindowsIdentity.
        WindowsIdentity windowsIdentity = WindowsIdentity.GetCurrent();

        // Construct a GenericIdentity object based on the current Windows
        // identity name and authentication type.
        string authenticationType = windowsIdentity.AuthenticationType;
        string userName = windowsIdentity.Name;
        GenericIdentity authenticatedGenericIdentity =
            new GenericIdentity(userName, authenticationType);

        return authenticatedGenericIdentity;
    }
}

Imports System.Security.Principal

Public Class Form1
    Inherits System.Windows.Forms.Form

    ' Event handler for Run button.
    Private Sub Button1_Click( _
        ByVal sender As System.Object, _
        ByVal e As System.EventArgs) Handles Button1.Click

        tbxOutput.Cursor = Cursors.WaitCursor
        tbxOutput.Text = ""

        ' Create a GenericIdentity object with no authentication type 
        ' specified.
        Dim defaultIdentity As New GenericIdentity("DefaultUser")

        ' Retrieve a GenericIdentity created from current WindowsIdentity
        ' values.
        Dim currentIdentity As GenericIdentity = GetGenericIdentity()

        ShowIdentityPreferences(New GenericIdentity(""))
        ShowIdentityPreferences(defaultIdentity)
        ShowIdentityPreferences(currentIdentity)

        ' Align interface and conclude application.
        tbxOutput.AppendText(vbCrLf + "This sample completed " + _
            "successfully; press Exit to continue.")

        tbxOutput.Cursor = Cursors.Default
    End Sub

    ' Print identity preferences to the console window.
    Private Sub ShowIdentityPreferences( _
        ByVal genericIdentity As GenericIdentity)

        ' Retrieve the name of the generic identity object.
        Dim identityName As String = genericIdentity.Name

        ' Retrieve the authentication type of the generic identity object.
        Dim identityAuthenticationType As String
        identityAuthenticationType = genericIdentity.AuthenticationType()

        tbxOutput.AppendText(vbCrLf + "Name: " + identityName)
        tbxOutput.AppendText(vbCrLf + "Type: " + identityAuthenticationType)

        tbxOutput.AppendText(vbCrLf)
        
        ' Verify that the user's identity has been authenticated
        ' (was created with a valid name).
        If (genericIdentity.IsAuthenticated) Then
            tbxOutput.AppendText("The user's identity has been " + _
                "authenticated.")
        Else
            tbxOutput.AppendText("The user's identity has not been " + _
                "authenticated.")
        End If

        tbxOutput.AppendText(vbCrLf + "~~~~~~~~~~~~~~~~~~~~~~~~~")
    End Sub

    ' Create generic identity based on values from the current
    ' WindowsIdentity.
    Private Function GetGenericIdentity()
        ' Get values from the current WindowsIdentity.
        Dim windowsIdentity As WindowsIdentity = windowsIdentity.GetCurrent()

        ' Construct a GenericIdentity object based on the current Windows
        ' identity name and authentication type.
        Dim authenticationType As String = windowsIdentity.AuthenticationType
        Dim userName As String = windowsIdentity.Name
        Dim authenticatedGenericIdentity As _
            New GenericIdentity(userName, authenticationType)

        Return authenticatedGenericIdentity
    End Function

    ' Event handler for Exit button.
    Private Sub Button2_Click( _
        ByVal sender As System.Object, _
        ByVal e As System.EventArgs) Handles Button2.Click

        Application.Exit()
    End Sub
#Region " Windows Form Designer generated code "

    Public Sub New()
        MyBase.New()

        'This call is required by the Windows Form Designer.
        InitializeComponent()

        'Add any initialization after the InitializeComponent() call

    End Sub

    'Form overrides dispose to clean up the component list.
    Protected Overloads Overrides Sub Dispose(ByVal disposing As Boolean)
        If disposing Then
            If Not (components Is Nothing) Then
                components.Dispose()
            End If
        End If
        MyBase.Dispose(disposing)
    End Sub

    'Required by the Windows Form Designer
    Private components As System.ComponentModel.IContainer

    'NOTE: The following procedure is required by the Windows Form Designer
    'It can be modified using the Windows Form Designer.  
    'Do not modify it using the code editor.
    Friend WithEvents Panel2 As System.Windows.Forms.Panel
    Friend WithEvents Panel1 As System.Windows.Forms.Panel
    Friend WithEvents Button1 As System.Windows.Forms.Button
    Friend WithEvents Button2 As System.Windows.Forms.Button
    Friend WithEvents tbxOutput As System.Windows.Forms.RichTextBox
    <System.Diagnostics.DebuggerStepThrough()> _
    Private Sub InitializeComponent()
        Me.Panel2 = New System.Windows.Forms.Panel
        Me.Button1 = New System.Windows.Forms.Button
        Me.Button2 = New System.Windows.Forms.Button
        Me.Panel1 = New System.Windows.Forms.Panel
        Me.tbxOutput = New System.Windows.Forms.RichTextBox
        Me.Panel2.SuspendLayout()
        Me.Panel1.SuspendLayout()
        Me.SuspendLayout()
        '
        'Panel2
        '
        Me.Panel2.Controls.Add(Me.Button1)
        Me.Panel2.Controls.Add(Me.Button2)
        Me.Panel2.Dock = System.Windows.Forms.DockStyle.Bottom
        Me.Panel2.DockPadding.All = 20
        Me.Panel2.Location = New System.Drawing.Point(0, 320)
        Me.Panel2.Name = "Panel2"
        Me.Panel2.Size = New System.Drawing.Size(616, 64)
        Me.Panel2.TabIndex = 1
        '
        'Button1
        '
        Me.Button1.Dock = System.Windows.Forms.DockStyle.Right
        Me.Button1.Font = New System.Drawing.Font( _
            "Microsoft Sans Serif", _
            9.0!, _
            System.Drawing.FontStyle.Regular, _
            System.Drawing.GraphicsUnit.Point, _
            CType(0, Byte))
        Me.Button1.Location = New System.Drawing.Point(446, 20)
        Me.Button1.Name = "Button1"
        Me.Button1.Size = New System.Drawing.Size(75, 24)
        Me.Button1.TabIndex = 2
        Me.Button1.Text = "&Run"
        '
        'Button2
        '
        Me.Button2.Dock = System.Windows.Forms.DockStyle.Right
        Me.Button2.Font = New System.Drawing.Font( _
            "Microsoft Sans Serif", _
            9.0!, _
            System.Drawing.FontStyle.Regular, _
            System.Drawing.GraphicsUnit.Point, _
            CType(0, Byte))
        Me.Button2.Location = New System.Drawing.Point(521, 20)
        Me.Button2.Name = "Button2"
        Me.Button2.Size = New System.Drawing.Size(75, 24)
        Me.Button2.TabIndex = 3
        Me.Button2.Text = "E&xit"
        '
        'Panel1
        '
        Me.Panel1.Controls.Add(Me.tbxOutput)
        Me.Panel1.Dock = System.Windows.Forms.DockStyle.Fill
        Me.Panel1.DockPadding.All = 20
        Me.Panel1.Location = New System.Drawing.Point(0, 0)
        Me.Panel1.Name = "Panel1"
        Me.Panel1.Size = New System.Drawing.Size(616, 320)
        Me.Panel1.TabIndex = 2
        '
        'tbxOutput
        '
        Me.tbxOutput.AccessibleDescription = _
            "Displays output from application."
        Me.tbxOutput.AccessibleName = "Output textbox."
        Me.tbxOutput.Dock = System.Windows.Forms.DockStyle.Fill
        Me.tbxOutput.Location = New System.Drawing.Point(20, 20)
        Me.tbxOutput.Name = "tbxOutput"
        Me.tbxOutput.Size = New System.Drawing.Size(576, 280)
        Me.tbxOutput.TabIndex = 1
        Me.tbxOutput.Text = "Click the Run button to run the application."
        '
        'Form1
        '
        Me.AutoScaleBaseSize = New System.Drawing.Size(6, 15)
        Me.ClientSize = New System.Drawing.Size(616, 384)
        Me.Controls.Add(Me.Panel1)
        Me.Controls.Add(Me.Panel2)
        Me.Name = "Form1"
        Me.Text = "GenericIdentity"
        Me.Panel2.ResumeLayout(False)
        Me.Panel1.ResumeLayout(False)
        Me.ResumeLayout(False)

    End Sub

#End Region
End Class

Комментарии

Объект Identity представляет пользователя, от имени которого работает код.An identity object represents the user on whose behalf the code is running.

Конструкторы

GenericIdentity(GenericIdentity)

Инициализирует новый экземпляр класса GenericIdentity, используя указанный объект GenericIdentity.Initializes a new instance of the GenericIdentity class by using the specified GenericIdentity object.

GenericIdentity(String)

Инициализирует новый экземпляр класса GenericIdentity, представляющий пользователя с указанным именем.Initializes a new instance of the GenericIdentity class representing the user with the specified name.

GenericIdentity(String, String)

Инициализирует новый экземпляр класса GenericIdentity, представляющий пользователя с указанными именем и типом проверки подлинности.Initializes a new instance of the GenericIdentity class representing the user with the specified name and authentication type.

Поля

DefaultIssuer

Издатель по умолчанию; "ЛОКАЛЬНАЯ СИСТЕМА".The default issuer; "LOCAL AUTHORITY".

(Унаследовано от ClaimsIdentity)
DefaultNameClaimType

Тип утверждения имени по умолчанию; Name.The default name claim type; Name.

(Унаследовано от ClaimsIdentity)
DefaultRoleClaimType

Тип утверждения роли по умолчанию; Role.The default role claim type; Role.

(Унаследовано от ClaimsIdentity)

Свойства

Actor

Получает или задает удостоверение вызывающей стороны, которой были предоставлены права делегирования.Gets or sets the identity of the calling party that was granted delegation rights.

(Унаследовано от ClaimsIdentity)
AuthenticationType

Получает тип аутентификации, используемой для идентификации пользователя.Gets the type of authentication used to identify the user.

BootstrapContext

Получает или задает токен, который использовался для создания данного удостоверения на основе требований.Gets or sets the token that was used to create this claims identity.

(Унаследовано от ClaimsIdentity)
Claims

Получает все утверждения для пользователя, представленного этим общим идентификатором.Gets all claims for the user represented by this generic identity.

CustomSerializationData

Содержит дополнительные данные, предоставленные производным типом.Contains any additional data provided by a derived type. Обычно устанавливается при вызове WriteTo(BinaryWriter, Byte[]).Typically set when calling WriteTo(BinaryWriter, Byte[]).

(Унаследовано от ClaimsIdentity)
IsAuthenticated

Возвращает значение, позволяющее определить, прошел ли пользователь проверку подлинности.Gets a value indicating whether the user has been authenticated.

Label

Получает или задает метку для данного удостоверения на основе требований.Gets or sets the label for this claims identity.

(Унаследовано от ClaimsIdentity)
Name

Получает имя пользователя.Gets the user's name.

NameClaimType

Получает тип требования, используемый для определения того, какие требования предоставляют значение для свойства Name данного удостоверения на основе требований.Gets the claim type that is used to determine which claims provide the value for the Name property of this claims identity.

(Унаследовано от ClaimsIdentity)
RoleClaimType

Получает тип требования, который будет интерпретироваться как роль .NET Framework среди требований в данном удостоверении на основе требований.Gets the claim type that will be interpreted as a .NET Framework role among the claims in this claims identity.

(Унаследовано от ClaimsIdentity)

Методы

AddClaim(Claim)

Добавляет одно требование к этому идентификатору требований.Adds a single claim to this claims identity.

(Унаследовано от ClaimsIdentity)
AddClaims(IEnumerable<Claim>)

Добавляет список требований к этому идентификатору требований.Adds a list of claims to this claims identity.

(Унаследовано от ClaimsIdentity)
Clone()

Создает новый объект, являющийся копией текущего экземпляра.Creates a new object that is a copy of the current instance.

CreateClaim(BinaryReader)

Предоставляет точку расширяемости для производных типов с целью создания пользовательского Claim.Provides an extensibility point for derived types to create a custom Claim.

(Унаследовано от ClaimsIdentity)
Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
FindAll(Predicate<Claim>)

Извлекает все утверждения, сопоставленные указанным предикатом.Retrieves all of the claims that are matched by the specified predicate.

(Унаследовано от ClaimsIdentity)
FindAll(String)

Извлекает все утверждения, которые имеют указанный тип утверждения.Retrieves all of the claims that have the specified claim type.

(Унаследовано от ClaimsIdentity)
FindFirst(Predicate<Claim>)

Извлекает первое утверждение, которое соответствует указанному предикату.Retrieves the first claim that is matched by the specified predicate.

(Унаследовано от ClaimsIdentity)
FindFirst(String)

Извлекает первое утверждение с заданным типом утверждения.Retrieves the first claim with the specified claim type.

(Унаследовано от ClaimsIdentity)
GetHashCode()

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetObjectData(SerializationInfo, StreamingContext)

Заполняет SerializationInfo данными, необходимыми для сериализации текущего объекта ClaimsIdentity.Populates the SerializationInfo with data needed to serialize the current ClaimsIdentity object.

(Унаследовано от ClaimsIdentity)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
HasClaim(Predicate<Claim>)

Определяет, имеет ли этот идентификатор утверждения утверждение, что соответствует заданному предикату.Determines whether this claims identity has a claim that is matched by the specified predicate.

(Унаследовано от ClaimsIdentity)
HasClaim(String, String)

Определяет, имеет ли этот идентификатор утверждения утверждение с заданным типом и значением утверждения.Determines whether this claims identity has a claim with the specified claim type and value.

(Унаследовано от ClaimsIdentity)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
RemoveClaim(Claim)

Пытается удалить утверждение на основе идентификатора утверждений.Attempts to remove a claim from the claims identity.

(Унаследовано от ClaimsIdentity)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
TryRemoveClaim(Claim)

Пытается удалить утверждение на основе идентификатора утверждений.Attempts to remove a claim from the claims identity.

(Унаследовано от ClaimsIdentity)
WriteTo(BinaryWriter)

Выполняет сериализацию с помощью BinaryWriter.Serializes using a BinaryWriter.

(Унаследовано от ClaimsIdentity)
WriteTo(BinaryWriter, Byte[])

Выполняет сериализацию с помощью BinaryWriter.Serializes using a BinaryWriter.

(Унаследовано от ClaimsIdentity)

Применяется к