GenericIdentity Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет универсального пользователя.
public ref class GenericIdentity : System::Security::Claims::ClaimsIdentity
public ref class GenericIdentity : System::Security::Principal::IIdentity
public class GenericIdentity : System.Security.Claims.ClaimsIdentity
[System.Serializable]
public class GenericIdentity : System.Security.Principal.IIdentity
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class GenericIdentity : System.Security.Principal.IIdentity
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class GenericIdentity : System.Security.Claims.ClaimsIdentity
type GenericIdentity = class
inherit ClaimsIdentity
[<System.Serializable>]
type GenericIdentity = class
interface IIdentity
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type GenericIdentity = class
interface IIdentity
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type GenericIdentity = class
inherit ClaimsIdentity
Public Class GenericIdentity
Inherits ClaimsIdentity
Public Class GenericIdentity
Implements IIdentity
- Наследование
- Наследование
-
GenericIdentity
- Производный
- Атрибуты
- Реализации
Примеры
В следующем примере показано использование элементов GenericIdentity класса.
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
Комментарии
Объект удостоверения представляет пользователя, от имени которого выполняется код.
Конструкторы
| Имя | Описание |
|---|---|
| GenericIdentity(GenericIdentity) |
Инициализирует новый экземпляр класса с помощью указанного GenericIdentityGenericIdentity объекта. |
| GenericIdentity(String, String) |
Инициализирует новый экземпляр GenericIdentity класса, представляющий пользователя с указанным именем и типом проверки подлинности. |
| GenericIdentity(String) |
Инициализирует новый экземпляр GenericIdentity класса, представляющий пользователя с указанным именем. |
Поля
| Имя | Описание |
|---|---|
| DefaultIssuer |
Издатель по умолчанию; "LOCAL AUTHORITY". (Унаследовано от ClaimsIdentity) |
| DefaultNameClaimType |
Тип утверждения имени по умолчанию; Name. (Унаследовано от ClaimsIdentity) |
| DefaultRoleClaimType |
Тип утверждения роли по умолчанию; Role. (Унаследовано от ClaimsIdentity) |
Свойства
| Имя | Описание |
|---|---|
| Actor |
Получает или задает удостоверение вызывающей стороны, которая была предоставлена права делегирования. (Унаследовано от ClaimsIdentity) |
| AuthenticationType |
Возвращает тип проверки подлинности, используемый для идентификации пользователя. |
| BootstrapContext |
Возвращает или задает маркер, используемый для создания этого удостоверения утверждений. (Унаследовано от ClaimsIdentity) |
| Claims |
Возвращает все утверждения для пользователя, представленного этим универсальным удостоверением. |
| CustomSerializationData |
Содержит дополнительные данные, предоставляемые производным типом. Обычно устанавливается при вызове WriteTo(BinaryWriter, Byte[]). (Унаследовано от ClaimsIdentity) |
| IsAuthenticated |
Возвращает значение, указывающее, прошел ли пользователь проверку подлинности. |
| Label |
Возвращает или задает метку для этого удостоверения утверждений. (Унаследовано от ClaimsIdentity) |
| Name |
Возвращает имя пользователя. |
| NameClaimType |
Возвращает тип утверждения, используемый для определения того, какие утверждения предоставляют значение для Name свойства этого удостоверения утверждений. (Унаследовано от ClaimsIdentity) |
| RoleClaimType |
Возвращает тип утверждения, который будет интерпретирован как роль .NET среди утверждений в этом идентификаторе утверждений. (Унаследовано от ClaimsIdentity) |
Методы
| Имя | Описание |
|---|---|
| AddClaim(Claim) |
Добавляет одно утверждение к этому удостоверению утверждений. (Унаследовано от ClaimsIdentity) |
| AddClaims(IEnumerable<Claim>) |
Добавляет список утверждений в это удостоверение утверждений. (Унаследовано от ClaimsIdentity) |
| Clone() |
Создает новый объект, который является копией текущего экземпляра. |
| CreateClaim(BinaryReader) |
Предоставляет точку расширяемости для производных типов для создания пользовательского Claim. (Унаследовано от ClaimsIdentity) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| FindAll(Predicate<Claim>) |
Извлекает все утверждения, которые соответствуют указанному предикату. (Унаследовано от ClaimsIdentity) |
| FindAll(String) |
Извлекает все утверждения, имеющие указанный тип утверждения. (Унаследовано от ClaimsIdentity) |
| FindFirst(Predicate<Claim>) |
Извлекает первое утверждение, соответствующее указанному предикату. (Унаследовано от ClaimsIdentity) |
| FindFirst(String) |
Извлекает первое утверждение с указанным типом утверждения. (Унаследовано от ClaimsIdentity) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Заполняет данные, необходимые SerializationInfo для сериализации текущего ClaimsIdentity объекта. (Унаследовано от ClaimsIdentity) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| HasClaim(Predicate<Claim>) |
Определяет, имеет ли это удостоверение утверждений утверждение, соответствующее указанному предикату. (Унаследовано от ClaimsIdentity) |
| HasClaim(String, String) |
Определяет, имеет ли это удостоверение утверждения с указанным типом и значением утверждения. (Унаследовано от ClaimsIdentity) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| RemoveClaim(Claim) |
Пытается удалить утверждение из удостоверения утверждений. (Унаследовано от ClaimsIdentity) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| TryRemoveClaim(Claim) |
Пытается удалить утверждение из удостоверения утверждений. (Унаследовано от ClaimsIdentity) |
| WriteTo(BinaryWriter, Byte[]) |
Сериализуется с помощью .BinaryWriter (Унаследовано от ClaimsIdentity) |
| WriteTo(BinaryWriter) |
Сериализуется с помощью .BinaryWriter (Унаследовано от ClaimsIdentity) |