Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo GroupPrincipal.GetMembers (Boolean)

 

Data di pubblicazione: novembre 2016

Restituisce una raccolta di oggetti entità contenuti nel gruppo. Quando il flag ricorsivo è impostato su true, questo metodo esegue la ricerca ricorsiva il gruppo corrente e restituisce tutti i membri del gruppo annidati.

Spazio dei nomi:   System.DirectoryServices.AccountManagement
Assembly:  System.DirectoryServices.AccountManagement (in System.DirectoryServices.AccountManagement.dll)

public PrincipalSearchResult<Principal> GetMembers(
	bool recursive
)

Parametri

recursive
Type: System.Boolean

Valore booleano che specifica se il gruppo viene eseguita una ricerca ricorsiva.

Valore restituito

Type: System.DirectoryServices.AccountManagement.PrincipalSearchResult<Principal>

Oggetto T:System.DirectoryServices.AccountManagement.PrincipalSearchResult'1 oggetto che contiene gli oggetti principali che sono membri del gruppo o una raccolta vuota se il gruppo non dispone di membri.

L'insieme di entità restituito non contiene oggetti di gruppo quando il flag ricorsivo è impostato su true; solo i nodi foglia vengono restituiti. Ad esempio, quando un gruppo che contiene un oggetto computer e un oggetto gruppo (con solo entità utente) viene eseguita una ricerca ricorsiva, la raccolta restituita contiene l'oggetto computer e gli oggetti utente principal nel gruppo nidificato. Poiché l'oggetto gruppo non è un nodo foglia, anche quando è vuoto non viene restituito nella ricerca ricorsiva. Quando il flag ricorsivo è false, la raccolta restituita può contenere oggetti di gruppo.

I membri vengono restituiti senza considerare il contesto. Ad esempio, se un contesto di dominio Active Directory in base al "CN = SpecialUsers, DC = Fabrikam, DC = com", il PrincipalFindResult includerà i membri del gruppo che si trovano in "CN = NormalUsers, DC = Fabrikam, DC = com", inoltre, anche se si trovano in un ambito che non fa parte del contesto che viene eseguita la ricerca. La raccolta di entità restituita può contenere anche membri che si trovano in un archivio diverso da quello del gruppo.

Il codice seguente consente di connettersi al dominio LDAP "fabrikam.com" con il nome utente impostato su "administrator" e la password impostata su "SecretPwd123" nel PrincipalContext costruttore.

Viene eseguita una ricerca per trovare il gruppo con il nome "Domain Admins" nel contenitore specificato nel PrincipalContext costruttore "DC = fabrikam, DC = com." Se il gruppo viene trovato, tutte le entità che sono membri di questo gruppo, che include membri ricorsivi, vengono quindi enumerate

PrincipalContext ctx = new PrincipalContext(ContextType.Domain,                                                                    
                                            "fabrikam.com", 
                                            "DC=fabrikam,DC=com", 
                                            "administrator", 
                                            "SecretPwd123");

GroupPrincipal grp = GroupPrincipal.FindByIdentity(ctx, 
                                                   IdentityType.Name, 
                                                   "Domain Admins");

if (grp != null)
{
    foreach (Principal p in grp.GetMembers(true))
    {
         Console.WriteLine(p.Name);
    }
    grp.Dispose();
}

ctx.Dispose(); 

.NET Framework
Disponibile da 3.5
Torna all'inizio
Mostra: