Udostępnij za pośrednictwem


PrincipalCollection.Add Metoda

Definicja

Dodaje określonego podmiotu zabezpieczeń na końcu kolekcji.

Przeciążenia

Add(ComputerPrincipal)

Dodaje określony ComputerPrincipal obiekt na końcu kolekcji.

Add(GroupPrincipal)

Dodaje określony GroupPrincipal obiekt na końcu kolekcji.

Add(Principal)

Dodaje określony Principal obiekt na końcu kolekcji.

Add(UserPrincipal)

Dodaje określony UserPrincipal obiekt na końcu kolekcji.

Add(PrincipalContext, IdentityType, String)

Principal Wyszukuje obiekt zgodny z parametrami i dodaje go na końcu kolekcji.

Uwagi

Podobnie jak w przypadku Remove funkcji i Contains, istnieją cztery przeciążenia tej funkcji, ale wszystkie robią to samo. Dodatkowe przeciążenia są implementowane tylko w celu zwiększenia użyteczności, dzięki czemu deweloperzy korzystający z funkcji IntelliSense widzą przeciążenia, które przyjmują UserPrincipalobiekt , GroupPrincipallub ComputerPrincipal . Wywołanie dowolnego przeciążenia użytkownika, grupy lub komputera jest dokładnie równoważne wywołaniu Principal przeciążenia.

Add(ComputerPrincipal)

Źródło:
PrincipalCollection.cs
Źródło:
PrincipalCollection.cs
Źródło:
PrincipalCollection.cs

Dodaje określony ComputerPrincipal obiekt na końcu kolekcji.

public:
 void Add(System::DirectoryServices::AccountManagement::ComputerPrincipal ^ computer);
public void Add (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.ComputerPrincipal computer);
member this.Add : System.DirectoryServices.AccountManagement.ComputerPrincipal -> unit
[<System.Security.SecurityCritical>]
member this.Add : System.DirectoryServices.AccountManagement.ComputerPrincipal -> unit
Public Sub Add (computer As ComputerPrincipal)

Parametry

Atrybuty

Uwagi

Ta funkcja może zgłaszać następujące wyjątki:

Wyjątek Opis
PrincipalExistsException computer już istnieje w kolekcji.

Dotyczy

Add(GroupPrincipal)

Źródło:
PrincipalCollection.cs
Źródło:
PrincipalCollection.cs
Źródło:
PrincipalCollection.cs

Dodaje określony GroupPrincipal obiekt na końcu kolekcji.

public:
 void Add(System::DirectoryServices::AccountManagement::GroupPrincipal ^ group);
public void Add (System.DirectoryServices.AccountManagement.GroupPrincipal group);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.GroupPrincipal group);
member this.Add : System.DirectoryServices.AccountManagement.GroupPrincipal -> unit
[<System.Security.SecurityCritical>]
member this.Add : System.DirectoryServices.AccountManagement.GroupPrincipal -> unit
Public Sub Add (group As GroupPrincipal)

Parametry

Atrybuty

Uwagi

Ta funkcja może zgłaszać następujące wyjątki:

Wyjątek Opis
PrincipalExistsException group już istnieje w kolekcji.

Dotyczy

Add(Principal)

Źródło:
PrincipalCollection.cs
Źródło:
PrincipalCollection.cs
Źródło:
PrincipalCollection.cs

Dodaje określony Principal obiekt na końcu kolekcji.

public:
 virtual void Add(System::DirectoryServices::AccountManagement::Principal ^ principal);
public void Add (System.DirectoryServices.AccountManagement.Principal principal);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.Principal principal);
abstract member Add : System.DirectoryServices.AccountManagement.Principal -> unit
override this.Add : System.DirectoryServices.AccountManagement.Principal -> unit
[<System.Security.SecurityCritical>]
abstract member Add : System.DirectoryServices.AccountManagement.Principal -> unit
override this.Add : System.DirectoryServices.AccountManagement.Principal -> unit
Public Sub Add (principal As Principal)

Parametry

principal
Principal

Obiekt Principal.

Implementuje

Atrybuty

Uwagi

Ta funkcja może zgłaszać następujące wyjątki:

Wyjątek Opis
PrincipalExistsException principal już istnieje w kolekcji.

Dotyczy

Add(UserPrincipal)

Źródło:
PrincipalCollection.cs
Źródło:
PrincipalCollection.cs
Źródło:
PrincipalCollection.cs

Dodaje określony UserPrincipal obiekt na końcu kolekcji.

public:
 void Add(System::DirectoryServices::AccountManagement::UserPrincipal ^ user);
public void Add (System.DirectoryServices.AccountManagement.UserPrincipal user);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.UserPrincipal user);
member this.Add : System.DirectoryServices.AccountManagement.UserPrincipal -> unit
[<System.Security.SecurityCritical>]
member this.Add : System.DirectoryServices.AccountManagement.UserPrincipal -> unit
Public Sub Add (user As UserPrincipal)

Parametry

Atrybuty

Uwagi

Ta funkcja może zgłaszać następujące wyjątki:

Wyjątek Opis
PrincipalExistsException user już istnieje w kolekcji.

Dotyczy

Add(PrincipalContext, IdentityType, String)

Źródło:
PrincipalCollection.cs
Źródło:
PrincipalCollection.cs
Źródło:
PrincipalCollection.cs

Principal Wyszukuje obiekt zgodny z parametrami i dodaje go na końcu kolekcji.

public:
 void Add(System::DirectoryServices::AccountManagement::PrincipalContext ^ context, System::DirectoryServices::AccountManagement::IdentityType identityType, System::String ^ identityValue);
public void Add (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);
[System.Security.SecurityCritical]
public void Add (System.DirectoryServices.AccountManagement.PrincipalContext context, System.DirectoryServices.AccountManagement.IdentityType identityType, string identityValue);
member this.Add : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> unit
[<System.Security.SecurityCritical>]
member this.Add : System.DirectoryServices.AccountManagement.PrincipalContext * System.DirectoryServices.AccountManagement.IdentityType * string -> unit
Public Sub Add (context As PrincipalContext, identityType As IdentityType, identityValue As String)

Parametry

context
PrincipalContext

Obiekt PrincipalContext podmiotu zabezpieczeń, który ma zostać dodany do kolekcji.

identityType
IdentityType

Obiekt IdentityType , który określa format identityValue.

identityValue
String

Ciąg identyfikujący podmiot zabezpieczeń w formacie określonym przez identityType.

Atrybuty

Uwagi

Ta funkcja może zgłaszać następujące wyjątki:

Wyjątek Opis
PrincipalExistsException Podmiot zabezpieczeń pasujący do tych parametrów już istnieje w kolekcji.
NoMatchingPrincipalException Nie znaleziono podmiotu zabezpieczeń pasującego do określonych parametrów.
MultipleMatchesException Więcej niż jeden podmiot zabezpieczeń jest zgodny z określonymi parametrami.
ArgumentException identityType jest pustym ciągiem

Dotyczy